Specification · 02
Inventory intent lifecycle
From vault authorization to settled batch, including every failure exit.
An inventory intent is the asset change a vault authorizes: a signed amount, an asset identity, a price limit and an expiry. It is an instruction, not a market order.
Stages
- Authorize. The vault mandate emits a signed inventory delta with bounds and an expiry window.
- Match. The planner searches for compatible opposite deltas on the same asset identity.
- Route residual. Only the unmatched balance is prepared as an external order.
- Settle. Settlement checks re-verify every constraint, then internal transfers and the external leg either all succeed or the batch reverts.
- Deploy liquidity. Post-settlement balances are used to establish the intended liquidity positions.
Failure exits
- Stale price feed: candidate blocked, repricing required.
- Expired intent: removed from the batch before planning completes.
- Wrong asset identity: rejected, since two similar tickers are not the same token.
- Price-limit failure: the batch reverts rather than settling outside a mandate.
- Failed external execution: the whole batch reverts, so no partial settlement remains.