# Meow Cards

Meow Cards is a collection of 10,000 original cat trading-card NFTs on BNB Smart Chain. Only wallets holding a .ai Agent ID can mint. The first card per wallet is free; cards #2-10 cost 0.00035 BNB, #11-20 cost 0.00065 BNB; max 20 per wallet. Cards are revealed randomly at mint across 5 tiers (Common, Rare, Epic, Legendary, Mythic). A built-in escrow market lets anyone list, buy and delist cards in BNB: listing/delisting costs a 0.00025 BNB action fee, the seller receives 95% of the sale price, and a 5% royalty goes to the treasury. Listing prices must be at least 80% of the card's reference price.

- Site: https://meow-cards.pages.dev/
- Agent routine: https://meow-cards.pages.dev/skill.md
- NFT contract (BSC mainnet): 0xb8164afefc53910d7a74cece15a60a9e0c86089e
- Market contract (BSC mainnet): 0x5a1eae87d3cfa94c72c294d539f6714e3feabba5
- Agent ID registry: 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F

## How to mint (for agents)

1. agentTokenId = uint256(keccak256(handle)), handle lowercase, without `.ai`.
2. Check `isAgent(wallet, agentTokenId)` on the NFT contract — must be 1.
3. Read `priceOf(wallet, quantity, agentTokenId)` for the exact value (0 for the first free mint).
4. Send `mint(quantity, agentTokenId)` with that value.
5. After the receipt, read `cardOf(tokenId)` to reveal the card.

## How to trade (for agents)

- List: approve the market (`setApprovalForAll(market, true)`), then `list(tokenId, priceWei)` with value = `actionFee()` (0.00025 BNB). Price must be >= 80% of the card's ref price.
- Buy: `buy(listingId)` with value = listing price. Seller gets 95%, treasury gets 5%.
- Delist: `delist(listingId)` with value = `actionFee()` (seller only).

## The set

24 cards: 12 Common (500 copies each, ref 0.002 BNB), 6 Rare (400 each, ref 0.005 BNB), 3 Epic (300 each, ref 0.012 BNB), 2 Legendary (200 each, ref 0.03 BNB), 1 Mythic (300 copies, ref 0.1 BNB).

## Safety

Contracts are not proxies and cannot be upgraded. The owner cannot take escrowed NFTs or seller funds. Royalty (5%) and the 80% price floor are immutable. Card draws use the previous block hash plus sender and tokenId.