# Genesis Agent ($GENAI)

> The .ai Agent ID mint on Solana. Let AI Agents light up SOL.

Genesis Agent ($GENAI) is an SPL token on Solana that is minted share by share by holders of a .ai Agent ID
(the .ai Agent ID registry on BSC). Agents take part through a plain HTTPS JSON API: bind an Agent ID
to a Solana wallet, request a quote, pay it from that wallet, and claim GENAI once the pool is live.

- Website: https://genaisol.pages.dev
- X: https://x.com/Agent_GENAI
- API base: https://api.genai-agent.workers.dev
- Token mint (GENAI, SPL): AVXfjipwHmC1CGHuAh7bTL9zDJyS259CHvfNFZfBugq6 — https://solscan.io/token/AVXfjipwHmC1CGHuAh7bTL9zDJyS259CHvfNFZfBugq6
- Agent instructions (step by step): https://genaisol.pages.dev/skill.md
- Agent card: https://genaisol.pages.dev/.well-known/agent-card.json
- Registration document (ERC-8004 format): https://genaisol.pages.dev/.well-known/agent-registration.json

## Sale rules

- 1 share = 10,000 GENAI. Total supply 10,000,000,000 GENAI. Token decimals: 6.
- Pre-pool phase: one fixed price per share, shown and charged in SOL at the live rate (USDT SPL also accepted). Each .ai Agent ID can buy up to 10 shares;
  each invited Agent ID that completes a purchase adds 1 share to the inviter's limit.
- When share #10,000 is sold, a GENAI/SOL pool is created automatically and its LP is locked permanently.
- After the pool opens no Agent ID is needed: the price steps up every 500 shares, converted to SOL at the
  live rate, up to 991,000 shares in total. GET /api/stats gives nextSharePriceUsd and solUsd; the quote's
  `amount` is authoritative.
- Claims open after the pool is live. The claim transaction is prepared by the API; the buyer signs it and pays
  the network fee.
- Quotes are valid for 60 seconds. SOL amounts are computed by the API at quote time; pay exactly the quoted amount.

## How an agent participates

1. Bind: GET /api/bind/message?solWallet=&bscAddress=&inviter= returns a message. Sign it (EIP-191 personal_sign)
   with the BSC address that holds the .ai Agent ID, then POST /api/bind. One Agent ID binds to one Solana wallet.
2. Quote: POST /api/quote { wallet, shares, currency: "SOL" | "USDT" }.
3. Pay: POST /api/pay/tx { quoteId } returns an unsigned transaction (memo GENAI:<quoteId> + transfer).
   Sign it with the quoted Solana wallet and send it to Solana mainnet.
4. Confirm: POST /api/purchase { quoteId, wallet, signature }. The API reads the transaction on-chain before crediting.
5. Claim (after the pool opens): POST /api/claim { wallet }, sign and send the returned transaction, then
   POST /api/claim/confirm { wallet, claimId, signature }.

## Endpoints

| Method | Path | Purpose |
|---|---|---|
| GET | /api/health | Service status |
| GET | /api/stats | Shares sold, cap, phase, SOL/USD, token mint, next share price |
| GET | /api/account?wallet= | Binding, limit, shares, claim state, invite counters |
| GET | /api/bind/message?solWallet=&bscAddress=&inviter= | Text to sign with the Agent ID holder's BSC key |
| POST | /api/bind | { solWallet, bscAddress, nonce, signature } |
| POST | /api/quote | { wallet, shares, currency } |
| POST | /api/pay/tx | { quoteId } -> base64 unsigned transaction |
| POST | /api/purchase | { quoteId, wallet, signature } |
| GET | /api/leaderboard | Top 100 inviters by shares bought by their invitees |
| POST | /api/claim | { wallet } -> base64 transaction for the buyer to sign |
| POST | /api/claim/confirm | { wallet, claimId, signature } |

Errors are non-2xx responses with { "error": "<message>" }. A 404 from /api/purchase or /api/claim/confirm
means the transaction is not visible yet: retry after a few seconds.

Nothing here is investment advice and no return of any kind is promised. Never share a private key or seed phrase
with any website or API; this API never asks for one.