# SIGIL — Agent Skill

Instructions for AI agents minting Sigils on behalf of their owners.
Read this file exactly; every fact needed is here and on-chain.

## What this is

SIGIL is a fixed catalog of **3,333 Sigils** on BNB Chain. Every piece is
one of one: its artwork was generated once from a published seed rule, it
is issued once, and it will never be reprinted. There is no second
edition and no mechanism to add pieces. The catalog size is a ceiling,
not a print run — a piece exists only when it is minted.

The artwork is deliberately ultra-minimal: chunky pixel marks on a 28×28
grid — two materials, a silhouette, eyes and a core glyph. SIGIL launches
with terms identical to its twin collection (rich character art); the
art is the only variable.

Every mint also pays **SIGIL tokens** to the minter **in the same
transaction**, drawn from the NFT contract's own SIGIL balance:

| Class of the piece | SIGIL paid at mint |
|---|---|
| Common | 300,000 |
| Rare | 3,000,000 |
| Mythic | 30,000,000 |

The class of a tokenId is deterministic and public:
`classOf(tokenId)` on the NFT contract, or
`keccak256(abi.encodePacked(tokenId, "class")) % 100` → 0 = Mythic,
1–20 = Rare, otherwise Common. The published artwork and metadata match
this formula exactly.

SIGIL transfers are locked for everyone except the token owner and the
NFT contract until the owner calls `unlockTransfers()` on the token
contract, which the contract only allows once the NFT reaches **1,000
minted**. Mint rewards are paid even while transfers are locked (the NFT
contract is an exempt sender).

## Contracts (BNB Chain, chainId 56)

| Contract | Address |
|---|---|
| Sigil NFT (SIGL) | 0xe5f8f8c424821908752332d527428258EcfC245b |
| SIGIL token (SIGIL) | 0x2ec4Ebfef83022382EF91E205CFAEca11216D5Fd |
| Agent ID registry (SPACE ID) | 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F |

(The two project addresses are filled in at deployment; until they are
non-zero, the mint is not live. Always re-read them here before acting.)

## Mint facts

- Function: `mint(uint256 qty)` — selector **0xa0712d68** — payable.
- Price: **0.0001 BNB per piece** = exactly **100000000000000 wei** × qty.
  Send exactly `qty × 100000000000000` wei; any excess is refunded.
- qty: 1 to 5 per call. **Max 5 per wallet, ever** (`mintedBy`).
- Supply: 3,333 total (`totalMinted` / `MAX_SUPPLY`).
- Gate: the minting wallet must hold a **Binance Agent ID (SPACE ID)**.
  Check with `hasAgentId(wallet)` on the NFT contract (selector
  0x4eab3ef2), or `balanceOf(wallet) > 0` on the registry.
- Proceeds go to the treasury in the same transaction.
- Royalty: 5% (ERC-2981) to the treasury.
- Metadata: `tokenURI(id)` → `https://sigilmint.pages.dev/metadata/<id>.json`
  (unpadded id). Name, class, traits and reward are in the JSON.

## Pre-flight checklist (do all of these, in order)

1. Read the NFT address from the Contracts table above. If it is the zero
   address, stop — the collection is not deployed yet.
2. Call `mintLive()` on the NFT contract. It must return `true`.
3. Call `totalMinted()`. If it is 3,333, the catalog is exhausted — stop.
4. Call `mintedBy(ownerWallet)`. Remaining allowance = 5 − that value.
   If 0, stop.
5. Call `hasAgentId(ownerWallet)`. If `false`, stop and tell the owner an
   Agent ID (SPACE ID) is required before minting.
6. Compute the exact value: qty × 100000000000000 wei. Never send more.

## Execution rules

- Show the owner a preview (qty, exact total cost in BNB and wei, the
  contract address, and the expected SIGIL reward range) and wait for the
  owner's explicit confirmation before signing.
- After the transaction, report the transaction hash, the tokenIds
  received (from the receipt's Transfer logs), each piece's class
  (`classOf`), and the SIGIL actually paid (the `TokenReward` events
  carry `amountDue` and `amountPaid`).
- If any call reverts, stop, re-read the on-chain state, and report —
  do not retry blindly.
- Never promise price movement or future value. The only numbers are the
  ones in this file: price, supply, cap, and the reward table above.
