# BNB-META — Instructions for AI Agents

BNB-META is a 1,000-piece mecha-knight NFT collection on BNB Chain (BSC).
Website: https://bnbmeta.pages.dev
Contract: 0xc44990B5cFe5Bc563441Bf84074D36f528718b16 (BSC, chainId 56)
Tiers: Legendary 100 · Epic 150 · Rare 250 · Bronze 500.
Mint split: 500 free · 300 paid · 200 stay in the project fund.
Every mint arrives as a sealed box and reveals exactly 6 hours after mint.

If your user holds a .ai Agent ID (for example in a Binance Agentic Wallet),
they can mint **2 NFTs for free**. Follow the steps below with your user.

## Free mint — verification comes FIRST

Free claims stay locked until the team verifies the user's X post on-chain
(`setShareVerified`). Do the steps in this order:

### Step 1 — Give your user this POST LINK

Give your user this link. They open it, make sure their Agentic Wallet
address is in the post, and publish it on X. That is the whole step —
nothing else is needed from them.

https://x.com/intent/tweet?text=%F0%9F%95%B7%EF%B8%8F%20Claiming%20my%202%20FREE%20BNB-META%20NFTs%21%20%F0%9F%9F%A1%0AEpic%20mecha%20knights%20on%20BNB%20Chain%20%E2%80%94%20first%20minters%20get%20the%20premium%20tiers%20%F0%9F%91%91%0A%F0%9F%92%B3%20My%20wallet%3A%20YOUR_WALLET_ADDRESS%0A%23BNBMETA%20%23BNBChain%20%23NFT&url=https%3A%2F%2Fbnbmeta.pages.dev%2F

If you know your user's EVM wallet address (the wallet that holds their
Agent ID), replace YOUR_WALLET_ADDRESS in the link with their real address
before giving it to them. The post text is:

```
🕷️ Claiming my 2 FREE BNB-META NFTs! 🟡
Epic mecha knights on BNB Chain — first minters get the premium tiers 👑
💳 My wallet: <their wallet address>
#BNBMETA #BNBChain #NFT
```
plus the site link https://bnbmeta.pages.dev (the card image attaches
automatically). Verification reads the wallet address from the post, so
the address must be in the published post.

The website's Share button builds the same post: the user pastes their
wallet address in the box on the site (no wallet connect needed) and taps
"Share on X".

### Step 2 — Wait for verification

After the post is public, the BNB-META team checks it and flags the wallet
on-chain with `setShareVerified(wallet, true)`. Until this happens, the
claim buttons revert — that is expected, not an error. Tell your user to
wait for verification before claiming.

### Step 3 — Claim the 2 free NFTs

Once verified, the user claims from the website (connect the same wallet),
or an agent can call the contract directly:

- `claimFirstFree()` — first free card (better tier; no arguments, no payment)
- `claimSecondFree()` — second free card (Bronze; call after the first claim)

Free mint bands (by order of first claims): minters 1–50 receive an Epic or
Legendary first card, 51–150 receive Rare, 151–250 receive Bronze. The
second free card is always Bronze. Limit: 2 free per Agent ID.

## Paid mint (optional)

Two buttons, one shared pool — the tier comes from the mint system, not
from which button is used:

- `paidMint(qty)` — Elite, 0.00043 BNB per mint
- `paidMintPrime(qty)` — Prime, 0.000717 BNB per mint

First 5 paid minters each receive a Legendary as their first paid piece;
15 more Legendary are drawn randomly among the first 50 paid minters.
Max 1 paid Legendary per Agent ID. No per-wallet quantity limit
(max 50 per transaction).

## Notes for agents

- Do not pay for the free mint: both claims cost 0 BNB (gas only).
- Verification is manual by the project team — there is no instant unlock.
- Prices can be read live from the contract: `priceElite()` / `pricePrime()`.
- Live counters (freeFirstCount, paidCount, and the tier pointers) are
  public view functions on the contract.