Executive Summary
A bridge firewall that caps drawdown "per corridor" only means something if the USD value behind that cap is trustworthy. JIL Sovereign's federation bridge enforces three independent, USD-denominated caps — a rolling 24-hour drawdown, a cumulative total exposure, and a hard-stop ceiling — for every (source cell, destination cell, asset) corridor, computed under a database row lock so concurrent settlements cannot race past a limit.
The USD value behind every check comes from a priority-ordered pricing layer: a statically configured override price (for assets, including the native token, that a third-party oracle may not cover) wins unconditionally when present; otherwise a cached market-price oracle feed is consulted, and its output is discarded — treated as no price at all — when the upstream feed marks its own data as stale. An asset the system cannot confidently price is not settled at a guessed value; it is refused.
Problem Statement
Bridge risk controls are only as good as the price feed behind them. A firewall that silently settles at a stale, zero, or last-known price during an oracle outage is not a firewall at all — it is a false sense of security that fails exactly when markets are most volatile and staleness is most likely to matter.
Why Existing Solutions Are Insufficient
- No pricing layer at all: caps enforced in native token units only, blind to the actual dollar risk being moved through a corridor during a price swing.
- Single-feed dependence: one oracle, no override for illiquid or platform-native assets the oracle simply does not track.
- Fail-open on oracle downtime: settlement proceeds anyway using a stale or default price when the feed is unavailable, exactly when risk controls matter most.
- Price-at-intake, never revisited: a price captured once at request time with no distinction between a fresh quote and a minutes-old stale one.
Technical Architecture
| Priority | Source | Behavior |
|---|---|---|
| 1 | Static override book | Operator-configured per-asset USD price; wins unconditionally when set, for assets an oracle may not cover |
| 2 | Market-price oracle | Cached market feed keyed by asset; a response flagged stale by the upstream feed is discarded, not used |
Three Independently Enforced Corridor Caps
| Cap | Basis |
|---|---|
| Rolling 24-hour drawdown | Sum of settled USD value on the corridor within the trailing 24 hours |
| Cumulative total exposure | Running total USD ever settled on the corridor |
| Hard-stop ceiling | Absolute USD ceiling the corridor may never exceed |
All three checks run against the corridor's row, locked for update, before a settlement is permitted to proceed — concurrent settlement requests on the same corridor cannot each independently observe capacity and jointly exceed the limit.
Fail-Closed Pricing
The pricing function returns no value — not zero, not a stale last-known figure — when neither a static override nor a fresh oracle price is available for the asset. Downstream, an unpriced transfer is treated the same as a transfer that failed a drawdown check: it does not settle.
Cell Quarantine
A cell whose behavior or standing is under review can be moved to a suspended status independent of any single corridor's caps, removing it from further settlement eligibility across every corridor it participates in until the operator restores it.
Prior Art Differentiation
| System | Cap Denomination | Stale-Price Behavior | Price Sources |
|---|---|---|---|
| Typical wrapper bridges | Native token units | N/A — no USD conversion | None |
| Single-oracle rate-limited bridges | Token units or single-feed USD | Fails open (uses last value) | 1 |
| JIL Sovereign | USD, normalized per corridor | Fails closed (denies as unpriced) | 2, priority-ordered |