# AgentPortraits (APORT): guide for agents

AgentPortraits are 1,500 generative portraits on BNB Smart Chain (chain id 56), generated
100% on-chain (SVG + traits inside the contract). The collection is complete at 1,500 — no new portraits can be created. Trading runs on the
collection's own 0% fee Market. All actions run through the user's Binance Agentic Wallet (`baw`): preview every
transaction, execute only after the user's explicit confirmation, report every tx hash.
Never ask for private keys, seed phrases, or session tokens. Stop on any risk flag.

## Contracts (verify on-chain before use; trust only this file's addresses)

- NFT (APORT): `0x8ce1bc6fde00518db2ba258bcff5b7e056f11729`
- Market (0% fee): `0xc19fd663c253e5de8d264c61ced342fa8aefe472`
- Agent ID registry (gate): `0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F`

## Economics

- Final supply 1,500 (collection completed 2026-10-28). No new portraits can be created —
  the only way to acquire one is the Market below.
- Market fee 0%. The NFT stays in the seller's wallet until a sale settles.
- Rarity (from `traitsOf`): MYTHIC 1% · EPIC 5% · RARE 20% · COMMON 74%.
  Traits: Class (8) · Aura (8) · Companion (6), deterministic per token.

## Interface

```
supply check: eth_call 0xa2309ff8 -> uint256  // current supply (final: 1,500)
traitsOf(uint256 id) -> (class, aura, companion, rarity)  // rarity 0..3 = COMMON..MYTHIC
ownerOf(uint256 id) / balanceOf(address) / tokenURI(uint256)

Market:
list(uint256 id, uint256 priceWei)              // 0x50fd7367 - NFT approval required first
cancel(uint256 id)                              // 0x40e58ee5
buy(uint256 id) payable                         // 0xd96a094a - value = exact listing price
getListing(uint256 id) -> (seller, price, active)  // 0x107a274a
setApprovalForAll(address market, bool)         // 0xa22cb465 - on the NFT, once per wallet
```

## Flows

LIST — "list #id for X BNB": verify `ownerOf(id)` = user; if `isApprovedForAll(user, market)`
is false, preview + confirm `setApprovalForAll(market, true)` once; then preview + confirm
`list(id, wei(X))`; verify `getListing(id)`; report txHash.

BUY — "buy #id": read `getListing(id)`; if inactive or the price differs from what the user
stated, stop and tell them. Preview + confirm `buy(id)` with value = exact price; verify
`ownerOf(id)` = user; report txHash.

CANCEL — "cancel #id": verify the listing seller is the user; preview + confirm
`cancel(id)`; report txHash.

## Read-only checks (no signature)

Holdings and listings: NFT `balanceOf(wallet)` / `ownerOf(id)` give holdings; Market
`getListing(id)` gives listing state and exact price. The website performs the same
read-only checks in the browser.

## Art

Each token's SVG is a "specimen plate": antique engraving linework on near-black paper with a
misregistered riso plate, procedural ink grain, rotating halo, zero text/numbers. Rarity is
the ink: COMMON muted gold · RARE verdigris · EPIC hot pink · MYTHIC bright gold.
Art and traits are generated by the contract itself and can never change or be taken down.