V5.4 LIVE on Base mainnet (chainId 8453) since 2026-05-28. Currently in BOOTSTRAP state —
CoverRouter paused until the LBP seeds the LUMINA/USDC Uniswap V3 pool. See /concepts/lifecycle for the end-to-end flow (policy → trigger → bond → wait / sell decision) and /contracts/deployed for the live addresses.- Programmatic. Buy a policy in one HTTP call. No KYC, no docs to sign, no broker.
- Relayer-paid. Agents don’t pay gas — only the USDC premium.
- Fair payouts. Triggers come from on-chain Chainlink reads (MIN of 3 confirmations) and pay out as ERC-1155 ClaimBonds the agent can hold, redeem for $LUMINA at 730 days, or sell on the secondary marketplace.
- Adapter pattern. Each shield is fronted by a
FlashShieldAdapterUUPS proxy so the protocol can evolve the slim-shield surface without breaking the legacyPolicyManagerV2ABI. - Live. Base mainnet (chainId 8453) since 2026-05-28. A separate Base Sepolia sandbox powers
/sandbox/*for wallet-less exploration.
@^0.6.0 · GitHub · OpenAPI · Swagger · Status
5-minute quickstart
Sandbox-first: a real call in two minutes, no wallet needed.
For AI agents
The integration patterns most agents use.
SDK reference
@lumina-org/sdk@^0.6.0 — the official TypeScript client.API reference
Every endpoint, with request / response schemas.
The six V5.4 products at a glance
Deductible 20% (payout = 80% × coverage). Margin 2.00x. Premium is always USDC;
the bond settles in $LUMINA at the market price on the day of redemption.
Why agents
Most DeFi protocols are designed for humans clicking wallets. Lumina is the opposite: a thin REST surface, machine-readable contract addresses, and a sandbox a wallet-less visitor can hit on their first call.Live status
.env.