Overview
A trade reaches Spire Protocol already matched. Price discovery happened somewhere else and we do not touch it. What we take over is everything between the match and final settlement.
Lifecycle of an obligation
- Fill. A venue posts a matched fill, signed, referencing both participants and the asset. Nothing has moved yet.
- Novation. The trade is torn up and re-signed against Spire Protocol. The buyer owes Spire Protocol, and Spire Protocol owes the seller. Two obligations replace one trade.
- Limit check. Each obligation is checked against the participant's position limit, which is a function of the collateral they have staked.
- Netting. Inside the settlement window, obligations in the same asset collapse against each other.
- Settlement. At the close of the window the net difference settles on chain. What netted out never becomes a transaction.
- Default, if it happens. The obligation does not disappear. It is covered by the waterfall, in order, and the counterparty on the other side is paid.
Steps 1 to 3 take one call. Steps 4 and 5 happen on the window clock without the venue doing anything. See Quickstart.
The same lifecycle in one line
defaulted branches off novated and netted. Nothing else is reachable, and no state is ever revisited. Field-level detail is in Data model.
Where the writes happen
This is the part that decides whether a clearing layer is worth having.
| Event | Chain writes |
|---|---|
| A fill is novated | none |
| A thousand fills are novated | none |
| A window closes | one per member per asset, against the net |
| A member defaults | one, plus the auction if it gets that far |
A venue doing ten thousand fills an hour in one asset for one member writes to the chain twelve times, once per five minute window, and each write carries only the difference.
What the venue keeps and what it hands over
| Stays with the venue | Moves to Spire Protocol |
|---|---|
| Price discovery, matching, the order book | Counterparty risk |
| The user relationship | Collateral management |
| Fee policy on its own side | Netting and settlement timing |
| Listing decisions | Default handling |
What this is not
- Not a venue. We do not quote, match or route.
- Not a custodian of the venue's users.
- Not a lending market. Collateral secures obligations, it is not lent out.
- Not a bridge. The clearing layer is native to Robinhood Chain and does not run a second deployment on another chain.
Reading order
If you are deciding whether this is useful, read Novation and then Netting. Those two carry the argument.
If you are deciding whether it is safe, read Collateral, Default waterfall and Parameters. The third one is where the claims turn into numbers.
If you are integrating, go to Quickstart and keep API reference and Errors open beside it.
If you want to check the claims yourself rather than read about them, go straight to Contracts. Every number on this site is a view call away.
If you are already live and somebody is on call, Operations is the page that should be open at three in the morning.
SPIRE PROTOCOL