OperateRunbooks
LI.FI Solver Operations
Operate the LI.FI quote-publish, order-poll, fill, and finalise loop.
Scope
Use this when running or diagnosing the LI.FI Intents solver path.
Readiness
pnpm --filter @steerprotocol/collateral-rail-quote-server lifi:readiness -- --strictThis should be non-mutating. Use it before live loop work.
Bounded Live Iteration
pnpm --filter @steerprotocol/collateral-rail-quote-server lifi:serve -- --live --onceUse --once before unattended mode. It gives one report covering quote refresh,
order polling, fill handling, and finalise planning.
Continuous Operation
pnpm --filter @steerprotocol/collateral-rail-quote-server lifi:serveContinuous operation should require:
- active API key.
- registered solver identity.
- route inventory.
- trust components.
- durable replay storage.
- RPC and signer config.
- explicit finalise submission config when finalise should be live.
Failure Triage
| Failure | First response |
|---|---|
| no uploaded quote | inspect route inventory and M1 capacity preview |
| identity missing | run registration flow and verify active API key |
| selected order rejected | inspect chain/token/exclusiveFor/trust-component validation |
| fill replay conflict | inspect PGlite replay store and pending fill status |
| finalise not submitted | confirm delivered/proven status and submit flag |
Rollback
Stop unattended fill submission first. Keep quote publishing disabled if stale
inventory could mislead order selection. Resume with --once after the fix.