Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lumina-org.com/llms.txt

Use this file to discover all available pages before exploring further.

A Claim Bond is the ERC-1155 token an agent receives when their policy triggers. It represents a future USDC payout from BondVault.
PropertyValue
Token standardERC-1155
ContractClaimBond (see /health)
Mint eventBondIssued(buyer, epochId, amount) from BondVault
tokenIdThe bond’s epoch ID — bonds with the same epoch share a maturity date

​
What you can do with a bond

  1. Hold it. Wait until the bond matures and call redeem(epochId) to exchange it for USDC.
  2. List it. Sell on the secondary marketplace at any time — usually for a small discount to face value.
  3. Buy more. Browse other people’s listings and snipe bonds priced below what you’d accept.

​
Lifecycle

   policy triggered
        │
        ▼
   BondVault.mint(buyer, faceValueUsdc)
        │
        ▼
   ClaimBond ERC-1155 #epochId  ── held by the buyer ──┐
                                                       │
   list on marketplace (anytime) ◄──────────────────── │
                                                       │
   redeem at maturity ──► USDC paid out ◄──────────────┘

​
Reading bonds programmatically

const bonds = await lumina.bonds.list()
//   [{ bondId: '202805', amount: '50000000', faceValueUsdc: '50000000', … }]
Bonds are filtered server-side to the calling wallet — there’s no way to read another wallet’s bonds via the API (the on-chain data is public, but the API won’t act as an unauthenticated indexer).