# Lumina Protocol

> Parametric DeFi insurance for AI agents — programmatic policy purchase, ERC-1155 claim bonds, and a relayer-paid agent UX. Live on Base Sepolia (chainId 84532).

## Docs

- [Buy your first policy](https://docs.lumina-org.com/agents/first-policy.md): POST /api/v1/policies, end-to-end, with the relayer paying gas.
- [Monitor your bonds](https://docs.lumina-org.com/agents/monitor-bonds.md): Read positions, check maturity, decide between hold/redeem/sell.
- [Onboarding (mint your API key)](https://docs.lumina-org.com/agents/onboarding.md): Self-service key issuance — sign one message, get a key.
- [For AI agents](https://docs.lumina-org.com/agents/overview.md): The integration patterns most agents use, with worked examples.
- [Strategies](https://docs.lumina-org.com/agents/strategies.md): Patterns we've seen agents use successfully on Lumina.
- [Webhooks](https://docs.lumina-org.com/agents/webhooks.md): Push notifications for policy / bond / marketplace events. HMAC-signed.
- [Create Plant](https://docs.lumina-org.com/api-reference/endpoint/create.md)
- [Delete Plant](https://docs.lumina-org.com/api-reference/endpoint/delete.md)
- [Get Plants](https://docs.lumina-org.com/api-reference/endpoint/get.md)
- [New Plant](https://docs.lumina-org.com/api-reference/endpoint/webhook.md)
- [API Reference](https://docs.lumina-org.com/api-reference/introduction.md): REST endpoints for Lumina Protocol. Source-of-truth OpenAPI 3.0.3 spec at /openapi.json.
- [Claim Bonds](https://docs.lumina-org.com/concepts/claimbonds.md): ERC-1155 receipts that pay out when the condition fires.
- [LUMINA token](https://docs.lumina-org.com/concepts/lumina-token.md): The protocol's native token: governance, fee burn, vesting.
- [How Lumina works](https://docs.lumina-org.com/concepts/overview.md): The four moving parts: Shields, Policies, Triggers, and Claim Bonds.
- [Shields](https://docs.lumina-org.com/concepts/shields.md): The contracts that decide whether a parametric condition fired.
- [Triggers](https://docs.lumina-org.com/concepts/triggers.md): How parametric conditions become on-chain payouts.
- [Architecture](https://docs.lumina-org.com/contracts/architecture.md): How the contracts fit together.
- [Audits](https://docs.lumina-org.com/contracts/audits.md): Internal audit findings and the fix branches that landed them.
- [Deployed contracts](https://docs.lumina-org.com/contracts/deployed.md): Live addresses on Base Sepolia. Always cross-check against /health.
- [Lumina Protocol](https://docs.lumina-org.com/index.md): Parametric DeFi insurance built for AI agents. Programmatic policies, ERC-1155 claim bonds, and a relayer-paid UX so agents never touch gas.
- [5-minute quickstart](https://docs.lumina-org.com/quickstart.md): Install the SDK, mint your first API key, buy a $50 policy.
- [bonds + marketplace](https://docs.lumina-org.com/sdk/bonds.md): lumina.bonds + lumina.marketplace — read positions and browse listings.
- [LuminaClient](https://docs.lumina-org.com/sdk/client.md): The top-level client and its sub-resources.
- [Examples](https://docs.lumina-org.com/sdk/examples.md): Worked snippets you can paste straight into a script.
- [Installation](https://docs.lumina-org.com/sdk/installation.md): Install @lumina-org/sdk and verify connectivity in 30 seconds.
- [policies](https://docs.lumina-org.com/sdk/policies.md): lumina.policies — list, get, purchase.
- [API status](https://docs.lumina-org.com/status.md): Live system health — pulled from /health on every page load.
- [Tokenomics](https://docs.lumina-org.com/tokenomics.md): LUMINA supply, allocation, vesting, fee burn.

## OpenAPI Specs

- [openapi](https://docs.lumina-org.com/api-reference/openapi.json)