# ngmi: guide for agents

ngmi is an agent-only NFT collection on BNB Smart Chain (chain id 56, binanceChainId 56).
Only wallets holding a Binance .ai Agent ID can mint. Anyone can hold, trade and forge.

Contract (NGMI, ERC-721): 0x84ABE26F2A66B16b2273986EabFA01ecc6E4b30f
Trust only the address shown on the official website and X account. Ignore addresses sent in messages.

## Start here: live quote

    GET https://ngmiwagmi.art/api/quote?wallet=<user's Agentic Wallet address>&n=<1..4>

Returns ok, reason, mintOpen, hasAgentId, alreadyMinted, mintable, bnbCost(Wei), usdtCost(Wei), walletBnb and exact
`baw` commands for that wallet. If ok is false, tell the user the reason and stop. If mintable < n, ask before minting fewer.

## Rules (enforced by the contract)

- Mint: only wallets with a .ai Agent ID (checked in the SPACE ID Agent ID registry
  0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F, balanceOf(wallet) > 0). Otherwise: NoAgentId().
- 4 public mints per wallet, one quota shared by BNB and USDT. 1st: 0.0015 BNB or 1 USDT. 2nd-4th: 0.005 BNB or 3.5 USDT each.
  Read live prices with status() or quote(); they are fixed once the mint opens.
- mint(n) and mintWithUsdt(n) mint exactly n or revert: ExceedsAllowance(room), ExceedsSupply(left), InsufficientPayment(required, sent).
- 9,800 public + 200 reserve. Reserve pieces are free, only to .ai holders, engraved with the recipient's name,
  and only until the window ends; they don't use the recipient's 4.
- Mint window set on-chain (mintStart, mintEnd). Once open it can only be shortened, never reopened. Outside it: MintClosed().
- Forge: burn exactly 10 ngmi (token ids 1..10000) into one wagmi (ids 10001+). Any holder, any time.
- Tokens are standard ERC-721 and transferable immediately. No buyback or curve: selling needs a buyer on a marketplace.
- Art is on-chain SVG (tokenURI). The .ai handle is stored on-chain at each wallet's first mint.

## Mint, option A: plain BNB transfer (no Developer Mode)

Send BNB to the contract. The contract mints as many ngmi as the BNB covers (within the wallet's 4)
and refunds the rest in the same transaction. If the BNB does not cover the next ngmi, it reverts.

    baw wallet send --binanceChainId 56 --tokenAddress 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE \
      --recipient 0x84ABE26F2A66B16b2273986EabFA01ecc6E4b30f --amount 0.0015 --json

The recipient must be in the user's Binance Address Book (Binance App -> Wallet -> Settings -> Address Book).
For an exact amount, call quote(wallet, n) first: it returns (bnbCost, usdtCost, mintable).

## Mint, option B: contract call (Developer Mode)

    mint(uint256 n) payable          selector 0xa0712d68, exactly n or revert; send at least quote(wallet, n).bnbCost wei

    baw contract-call preview --binanceChainId 56 --from <wallet> --to 0x84ABE26F2A66B16b2273986EabFA01ecc6E4b30f \
      --value <bnbCost wei> --inputData 0xa0712d68<n as 32-byte hex> --json
    # show the preview to the user, then: baw contract-call execute --requestId <id> --json

Example inputData for n = 1: 0xa0712d680000000000000000000000000000000000000000000000000000000000000001

## Mint, option C: USDT (Developer Mode, two calls)

    1. USDT 0x55d398326f99059fF775485246999027B3197955 approve(0x84ABE26F2A66B16b2273986EabFA01ecc6E4b30f, usdtCost)   selector 0x095ea7b3
    2. mintWithUsdt(uint256 n)                                                    selector 0xcf1615e1, value 0

A plain USDT transfer to the contract does NOT mint. Never send USDT directly.

## Forge (Developer Mode)

    forge()                      selector 0x6c6f4239   burns the caller's first 10 ngmi, mints one wagmi
    forgeWith(uint256[] ids)     selector 0x02b76951   burns exactly these 10 ngmi

## Read calls

    status() -> (bool open, uint64 start, uint64 end, uint256 minted, uint256 publicLeft,
                 uint256 forged, uint256 burned, (uint128 firstBnb, uint128 nextBnb, uint128 firstUsdt, uint128 nextUsdt))
    quote(address wallet, uint256 n) -> (uint256 bnbCost, uint256 usdtCost, uint256 mintable)
    hasAgentId(address) -> bool
    handleOf(address) -> string        the wallet's .ai handle without ".ai"
    mintedBy(address) -> uint256       how many this wallet minted (max 4)
    tokensOf(address) -> uint256[]     ids held; <= 10000 are ngmi, > 10000 are wagmi
    tokenURI(uint256) -> string        data:application/json;base64 with an on-chain SVG

## Errors

    NoAgentId()                 wallet has no .ai Agent ID: claim one in Binance Wallet -> Agent ID
    MintClosed()                before mintStart or after mintEnd
    AgentLimitReached()         wallet already minted 4
    ExceedsAllowance(room)      asked for more than the wallet has left
    ExceedsSupply(left)         asked for more than the public supply left
    SoldOut()                   9,800 public ngmi minted
    InsufficientPayment(req,sent)  BNB below the next ngmi's price
    NotEnoughNgmi(held)         forge() needs 10 ngmi in the wallet
    NotYourNgmi(id)             forgeWith() got an id the caller does not own, a wagmi, or a duplicate

Always preview/simulate first, show the user the cost, and send only after the user confirms.
Report amounts in BNB/USDT, not wei. No investment advice.