# Kairos (KAI) — llms.txt

Kairos is a 1,111-supply ERC-721 NFT mint on BNB Smart Chain (chain 56).
Name: Kairos. Symbol: KAI. Contract: 0x4808C11743e3F652139F2aa80e349bAa63C9CfD8
— LIVE ON MAINNET (deployed 2026-11-03, block 131470872, verified on
BscScan and Sourcify). Do not send BNB to any address claiming to be Kairos.

## Status (live — read the contract, do not trust these numbers)
- Total supply 1,111. Free supply 333 — SOLD OUT. Paid supply 778, open now.
- Counts as of 2026-11-08 ~05:11 GMT: 335/1,111 minted, free sold out, 2 paid.
- The free window (first 24h after deploy) closed; unclaimed free slots
  expired and did NOT become paid. Paid mints are the only way in now.
- On-chain tokenURI is set by the owner (setBaseURI) once the site URL is
  final. Metadata files are served from this site under /metadata/.

## Rules
- Total supply 1,111. Free supply 333, paid supply 778.
- Free: 1 per wallet, random moment, first 24 hours after deploy only.
  After 24h the free window closes forever; unclaimed free slots expire
  and do NOT become paid.
- Paid: open from deploy, alongside free. Max 9 paid per wallet, max 10
  total per wallet, max 5 paid per transaction.
- Agent ID is REQUIRED for every mint, free or paid. Registry (BSC
  mainnet, real): 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F
  (balanceOf(wallet) > 0 means it holds an Agent ID).
- Paid price by paid count per wallet (BNB, ~$700/BNB): 1st 0.00005
  ($0.035), 2nd 0.0001 ($0.07), 3rd 0.0002 ($0.14), 4th-9th 0.0003 each
  ($0.21). Full wallet (1 free + 9 paid) = 0.00215 BNB ($1.505).
  Max paid revenue (honest): $129.89 if all 778 paid sold at max depth;
  realistic paid revenue is $1-3 if buyers mostly take 1-2 paid each
  (30-50 paid spans $1.05-$8.19 by depth).
- Moments (7, fixed token-id blocks): 1 Dawn 1-159 (gold first light),
  2 Noon 160-318 (white burning sun), 3 Dusk 319-477 (purple horizon),
  4 Midnight 478-636 (star black), 5 Eclipse 637-795 (black sun),
  6 Hourglass 796-953 (sand frozen mid-fall), 7 Eternity 954-1111
  (no face, just stars). Free per moment: 48 Dawn-Noon-Dusk-Midnight-
  Eclipse, 47 Hourglass, 46 Eternity. Paid per moment: 111 Dawn-Hourglass,
  112 Eternity. A moment can sell out on paid — intended.
- Free mint picks a RANDOM moment. Paid mint CHOOSES the moment.
- Every paid mint = one raffle entry. Capped pot funded only from paid
  revenue actually received. No value promised.
- Royalties 5% ERC-2981, set once to the deployer (initialOwner) wallet
  and staying with that wallet even if ownership is later transferred.
  Contract is NOT audited by a third party. No floor price, returns, APY,
  dated token or airdrop, game, or merch is promised.

## Contract functions
- freeMint() — non-payable. 1 free per wallet, random moment, 24h window.
  The window is CLOSED — do not call freeMint() now.
- mint(uint8 variant, uint256 qty) — payable. variant 1..7, qty 1..5,
  value EXACTLY priceFor(msg.sender, qty).
- Views: totalSupply(), freeMintedCount(), freeRemaining(), paidRemaining(),
  freeOpen(), paidOpen(), freeMinted(address), paidMintedBy(address),
  mintedCount(address), variantOf(uint256), priceFor(address, uint256),
  priceAtPaidIndex(uint256), freeWindowEnds(), deployTime(),
  variantFreeRemaining(uint8), variantPaidRemaining(uint8),
  variantForTokenId(uint256).
- Owner: withdraw() and setBaseURI(string) only. Owner cannot change
  supply (1,111), free supply (333), prices, max per wallet, max per tx,
  moment rules, the 24-hour free window, or the registry; cannot mint extra,
  pause, freeze, burn, or take holders' Kairos.

## GAS WARNING — read this before minting
freeMint picks its moment from the block timestamp, so the gas estimate
can be a few gas TOO LOW: the estimate and the real transaction can pick
different moments and cost slightly different gas. ALWAYS send freeMint
and mint with gasLimit = estimate + 30,000. Without the extra gas the
transaction can fail with out-of-gas even though the estimate looked
fine. Paid mints are deterministic and exact, but the margin is harmless.

## Mint steps (agent)
1. Read-only checks first: totalSupply, freeMintedCount, freeRemaining,
   paidRemaining, freeOpen, paidOpen, freeMinted(wallet),
   mintedCount(wallet), paidMintedBy(wallet), priceFor(wallet, qty),
   variantFreeRemaining(v) / variantPaidRemaining(v), registry
   balanceOf(wallet) > 0.
2. Free: do NOT call freeMint() — the window is closed and free is sold out.
3. Paid: mint(variant, qty), qty 1..5, value exactly priceFor(wallet, qty),
   only if mintedCount + qty <= 10, paidMintedBy + qty <= 9,
   totalSupply + qty <= 1111.
4. Preview the call, show the parsed transaction and exact value, wait
   for the user's explicit confirmation before executing. Never attach
   BNB beyond the exact paid amount.
5. After minting, verify on-chain (totalSupply up, ownerOf of the new
   token is the wallet) and show the tx hash with a BscScan link.

## Art / metadata
- 7 moment images on IPFS (Pinata):
  Dawn bafybeigcqpqgcvvmtd4s7fzl6t7m2mz5yyaou6l3j32wyi7doxovs4tkl4
  Noon bafybeia7moe54xpxfr7majwkdrh3d7q3fltaleyij4nnzj2spgqnzrpmxq
  Dusk bafybeiaeq7q6ck4ga74udswfil2msqwxcxisg6xha4r7njlqsm34owxsvm
  Midnight bafybeifryq2njtq5fbjafotv75vear5edo3xspsqhysca4yrxnuvw3axi4
  Eclipse bafybeifqfzzhbzsg2zxeq2hdulnuhykoc7bupr4m7ytw2vscs2af3nxsc4
  Hourglass bafybeidmqaeqxwintu437aopzqkwy6zvadrxv6t2beyet7qc5ksjnyatti
  Eternity bafybeihskpnmtdkpqhbe4taa6gnz7exbrhakatiehb6pz2aavcr6xy6xc4
- Metadata: 1,111 extensionless files (1..1111) under /metadata/ on the
  site. No .json duplicates. tokenURI returns baseURI + tokenId (baseURI
  is set by the owner once the site URL is final).