> ## 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.

# 5-minute quickstart

> Sandbox-first call (no wallet, no key) → SDK install → mint API key → buy a real policy.

This page walks the lowest-friction path first: a real call against the live
sandbox, no wallet or key required. Then the full SDK path with onboarding for
real policies.

## 1. Sandbox first (zero wallet, zero key)

The fastest sanity check is a `POST /sandbox/try` — the relayer pays gas and
pulls the USDC premium from a sandbox wallet, capped at \$100 per IP, 10
attempts/hour. Useful for first-call demos and CI smoke tests.

```bash theme={null}
curl https://lumina-api-production-ac85.up.railway.app/sandbox/info
# returns { enabled, sandboxWallet, defaultProductName: "FLASHBTC1H-001",
#           coverageCapUsdc: "100000000", rateLimit: { perIp: 10, windowSeconds: 3600 } }

curl -X POST https://lumina-api-production-ac85.up.railway.app/sandbox/try \
  -H "Content-Type: application/json" \
  -d '{ "productName": "FLASHBTC1H-001", "coverageAmount": "100000000" }'
```

Or via the SDK (zero-arg auto-uses the default product):

```ts theme={null}
import { LuminaClient } from '@lumina-org/sdk'
const lumina = new LuminaClient({ apiKey: '' })   // sandbox endpoints are public
const info  = await lumina.sandbox.info()
const result = await lumina.sandbox.try()
console.log(result.policyId, result.txHash)
```

That's a real on-chain policy. Move on when you want your own buyer wallet.

## 2. Install the SDK

```bash theme={null}
npm install @lumina-org/sdk@^0.6.0 ethers
```

`@^0.6.0` is the V5.4 minimum. Older versions still expose the retired
FLASHBTC4H / MICRODEPEG / RATESHOCK names; 0.6.0 throws `Unknown product`
on those, which is what you want.

## 3. Mint an API key (self-service)

Sign one message with your wallet — the API verifies and returns a fresh
`lk_…` key. Caps: 3 active keys per wallet, 10 onboard attempts per hour per
IP, ±5 minute timestamp window.

```ts theme={null}
import { Wallet } from 'ethers'
import { LuminaClient } from '@lumina-org/sdk'

const wallet = new Wallet(process.env.PRIVATE_KEY!)
const lumina = new LuminaClient({ apiKey: '' })  // empty for onboard

const { apiKey } = await lumina.agent.onboard(wallet, { label: 'my-bot' })
console.log('Save this NOW (shown only once):', apiKey)
```

The signed message is `Lumina onboarding for {address} at {timestamp}`. The SDK
builds it for you.

Need test USDC? See [Get test USDC](/agents/get-test-usdc) for a one-call
faucet that drops 10,000 mUSDC + 0.05 ETH (gas) into the wallet you pass.

## 4. Verify connectivity

```ts theme={null}
const lumina = new LuminaClient({ apiKey: process.env.LUMINA_API_KEY! })
const health = await lumina.health()
console.log('chainId:', health.chain.chainId)              // 8453
console.log('contracts:', Object.keys(health.contracts))   // coverRouter, …
```

## 5. Buy a \$1,000 policy

```ts theme={null}
const policy = await lumina.policies.purchase({
  productName: 'FLASHBTC24-001',                // V5.4 — Flash BTC 24h, premium $52.60 / $1k
  buyer: '0xYourWalletAddress',                 // wallet that pays USDC premium
  coverageAmount: '1000000000',                 // $1,000 in 6-dec USDC
})

console.log('policyId:', policy.policyId, 'tx:', policy.txHash)
```

The relayer paid the gas, your buyer wallet paid the \$52.60 USDC premium, and
you got back a `policyId` you can reference for triggers and bonds.

The SDK 0.6.0 resolves both the `productId` keccak hash and the per-shield
`asset` literal (BTC or ETH) from `productName`. The six V5.4 products are
listed at [Products and assets](/agents/products-and-assets).

<Card title="Next: Browse strategies →" icon="arrow-right" href="/agents/strategies" />