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.

LUMINA’s public surfaces show only numbers you can verify on-chain. This page explains what is live, the refresh cadence, and what is intentionally not shown yet.

​
Live (instant on-chain)

Served by the aggregator GET /api/v1/live-stats (cached ~30s server-side) and rendered with ISR (~60s) on the home Hero.
StatSource (verifiable)Refresh
$LUMINA priceBondVault.priceOracle().getLuminaPrice()~30–60s
Bond reserveLUMINA.balanceOf(bondVault)~30–60s
Capacity usedBondVault.totalCommittedUSD / availableCapacityUSD()~30–60s
Total supplyLUMINA.totalSupply() (fixed 100M)~30–60s
Chain / blockRPC eth_blockNumber (/health)~30s
Premiums (per product)GET /products/{id}/quoteISR 1h
API / sequencer statusGET /healthon view
Per-user data (your policies, bonds, marketplace listings) is fetched live client-side in the /app (operate) section.

​
Historical (not shown until the indexer is live)

Cumulative/aggregate figures require event indexing (the Ponder indexer, currently parked). Until it is revived they are omitted, not faked:
  • Total $LUMINA burned (cumulative)
  • Active ClaimBonds count / bonds outstanding
  • Policy volume (24h)
  • Burn rate (30d)
The endpoints exist (/api/v1/stats/*) but are disabled until the indexer runs.

​
Verify it yourself (30 seconds)

# Aggregated live stats (every field names its on-chain source)
curl https://lumina-api-production-ac85.up.railway.app/api/v1/live-stats

# Or read directly from the chain
cast call <bondVault> "priceOracle()(address)" --rpc-url https://mainnet.base.org
cast call <oracle>    "getLuminaPrice()(uint256)" --rpc-url https://mainnet.base.org   # 18-dec USD
cast call <lumina>    "balanceOf(address)(uint256)" <bondVault> --rpc-url https://mainnet.base.org
cast call <lumina>    "totalSupply()(uint256)" --rpc-url https://mainnet.base.org       # 100M * 1e18
Resolve <bondVault>, <lumina> from GET /health (contracts map) so you are never reading a stale address.

​
Degradation

If the API/RPC is unreachable, the aggregator serves the last good snapshot flagged stale: true, and the Hero shows a grey “LAST KNOWN” indicator instead of the green “LIVE” dot — never a fabricated value.