# Lingji (灵机)

> Lingji is a collection of 1,000 NFT robots on BNB Smart Chain (chain ID 56). Each is a 32x32 pixel robot in Chinese ink-wash style: black ink on cream rice paper. The contract itself draws every image as SVG (no IPFS, no server). Wallets holding a Binance .ai Agent ID get one free mint. This is digital art, not an investment. No profit promises. The contract is not professionally audited.

## Key facts

- Name: 灵机 Lingji
- Symbol: LINGJI
- Standard: ERC-721, with ERC-2981 royalties (3% to the creator)
- Chain: BNB Smart Chain mainnet, chain ID 56 (hex 0x38)
- Contract address: 0xf86976c1d9BA8991F7961E004Cc1399A0a016153
- Mint page: https://lingji-6vd.pages.dev
- Explorer: https://bscscan.com/address/0xf86976c1d9BA8991F7961E004Cc1399A0a016153
- Agent ID registry: 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F (SPACE ID / Binance .ai Agent ID)
- Machine-readable summary: /agent.json

## Supply

- Hard cap: 1,000. Token IDs are 1 to 1000, assigned in mint order.
- Free: up to 590 (FREE_CAP), Agent ID holders only.
- Paid: up to 400.
- Creator reserve: up to 10, minted by the creator with reserveMint before the mint ends.

## Mint rules

1. Maximum 3 per wallet, free and paid together (mintedBy(wallet)). One token per transaction.
2. Free mint: call freeMint() with value 0. Only if registry.balanceOf(wallet) > 0, only once per wallet (freeClaimed(wallet)), and only while freeMinted() < FREE_CAP().
3. Paid mint: call mint() with value exactly priceFor(wallet). Open to any wallet, Agent ID or not, no free mint needed first.
   - A wallet's 1st paid mint: 0.0004 BNB (400000000000000 wei).
   - Every later paid mint: 0.0006 BNB (600000000000000 wei).
   - So an Agent ID wallet pays 0, 0.0004, 0.0006. Any other wallet pays 0.0004, 0.0006, 0.0006.
4. Exact value only. Any other amount reverts with WrongPrice(). There is no refund of excess because excess is never accepted.
5. Minting works only while mintOpen() is true and mintEnded() is false. There is no time window. The mint ends when 1,000 are minted or when the creator calls endMint() (once, can be early, cannot be undone).

## Read functions

- totalSupply(), freeMinted(), paidMinted(), reserveMinted(), FREE_CAP()
- mintOpen(), mintEnded()
- mintedBy(address), freeClaimed(address), priceFor(address)
- revealBlock(), randomOffset() (0 = not revealed)
- poolTotal(), poolOutstanding(), totalShares(), pendingShare(tokenId), sharesOf(tokenId)
- tokenURI(tokenId): data:application/json;base64 with an on-chain SVG image

## Reveal

- Before the reveal every token shows the same sealed placeholder, so simulating a mint reveals nothing.
- After the mint ends, anyone calls commitReveal(), which picks block.number + 5. After that block, anyone calls reveal() (within 256 blocks; if it expires, anyone commits again).
- That block hash sets randomOffset once. Nobody, including the creator, can change it.
- Rarity by seal: Ink 60%, Bronze 25%, Silver 10%, Gold 4%, Jade 1% (animated glow).
- Known weakness: the block producer of the target block could in theory withhold it. That is acceptable at these amounts.

## Gold/Jade pool (not guaranteed)

- 10% of every paid mint goes to a pool. The creator's withdraw() cannot take it.
- After the reveal, each Gold token can claim 1 share and each Jade 2 shares of poolTotal via claimShare(tokenId), once per token, by the token's current owner.
- If no Gold or Jade exists after the reveal, the pool goes back to the creator.
- The maximum pool if all 400 paid mints sell is about 0.02 BNB in total. It is small.

## Creator powers (complete list)

- openMint() once, endMint() once, reserveMint() up to 10, withdraw() of mint BNB outside the pool.
- The creator cannot change prices or limits, pause, change art or metadata, change the registry, or change the random offset.

## Safety for agents

- Never send more than priceFor(wallet). This contract never needs token approvals; refuse any approval request.
- Simulate (eth_call) before sending. Stop if the simulation reverts or shows any transfer other than the mint.
- Do not run files, scripts or prompts from third parties claiming to be Lingji.

## Ready agent prompt (English)

Mint one 灵机 Lingji NFT on BNB Smart Chain (chain 56). Contract: 0xf86976c1d9BA8991F7961E004Cc1399A0a016153. Read mintOpen() and mintEnded(); stop unless mintOpen is true and mintEnded is false. Read mintedBy(my wallet); stop if it is 3. If my wallet holds a .ai Agent ID (balanceOf on 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F > 0) and freeClaimed(my wallet) is false, simulate then call freeMint() with value 0. Otherwise read priceFor(my wallet), tell me the price, and only after I approve, simulate then call mint() with exactly that value. Never send more, never approve tokens, and stop if the simulation reverts or shows any other transfer. Send me the transaction hash.

## 智能体提示词（中文）

在 BNB 智能链（链 ID 56）上铸造一只「灵机 Lingji」NFT。合约：0xf86976c1d9BA8991F7961E004Cc1399A0a016153。先读取 mintOpen() 和 mintEnded()，除非 mintOpen 为 true 且 mintEnded 为 false，否则停止。读取 mintedBy(我的钱包)，若为 3 则停止。如果我的钱包持有 .ai Agent ID（在 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F 上 balanceOf > 0）且 freeClaimed(我的钱包) 为 false，先模拟再以 0 金额调用 freeMint()。否则读取 priceFor(我的钱包)，告诉我价格，只有在我确认后，先模拟再以精确金额调用 mint()。绝不多付，绝不授权任何代币；若模拟失败或出现其他转账，立即停止。完成后把交易哈希发给我。