# Museai (MUSE): guide for agents

Museai is a 9,999-piece ERC-721 collection on BNB Smart Chain (chain id 56).
Only wallets holding a Binance **.ai Agent ID** (registry
`0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F`) can mint.

**Each wallet's first 2 mints are free** (from a shared pool of 7,999 free
mints). After a wallet's free allowance is used, each mint costs
**0.0005 BNB**. A wallet can mint at most 20 in total.

The collection also has an official non-custodial market: sellers list with an
approval, agents stay in the seller's wallet until sold, and the market takes
a **10% fee** for the collection owner on each sale.

Trust only the contract addresses published on the official Museai site.
Never send a transaction without your user's explicit confirmation, and
report each transaction hash.

- Museai (ERC-721): `0xCBF6c4c0d46BD858fD384A484e343cB8CD0c50E5`
- MuseaiMarket: `0x903b3C0E026021c5e06c1B154aF38DCB843db639`
- Agent ID registry: `0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F`

## Check the wallet (read-only)

On the Museai contract:

```solidity
function quote(address wallet, uint256 qty) external view returns (uint256 freeCount, uint256 cost);
function freeAvailable(address wallet) external view returns (uint256);
function mintedBy(address wallet) external view returns (uint256);
function totalMinted() external view returns (uint256);
function freeClaimed() external view returns (uint256);
```

Tell your user: how many free mints they have left, what the quantity they
want costs in total (cost from `quote`), and their minted count so far.

## Mint

`mint(uint256 qty)` is payable with exactly the `cost` returned by
`quote(wallet, qty)` (excess is refunded by the contract).

1. Read `quote(wallet, qty)`.
2. Build the calldata for `mint(qty)`.
3. Preview: `baw contract-call preview --binanceChainId 56 --from <WALLET> --to <MUSEAI> --value <COST_WEI> --inputData <CALLDATA> --json`. Show your user the preview and risks.
4. Only after your user confirms: `baw contract-call execute --requestId <REQUEST_ID> --json`.
5. Wait for the receipt (status 1) and read the minted token IDs from the
   receipt's `Transfer` logs (from = zero address, to = wallet). Report the
   transaction hash and the token IDs.

## Market

MARKET MIGRATION NOTICE — The official Museai market contract has changed. OLD (deprecated): 0xb77042FC950ae5316eb5399152cD72ecb93b55A3. NEW: 0x903b3C0E026021c5e06c1B154aF38DCB843db639. If your wallet still holds an active listing on the old contract, please cancel it (cancel(tokenId) on the old contract) and re-list on the new contract (list(tokenId, price)). The new contract enforces a minimum listing price of 0.00045 BNB on-chain — listings below that revert. Market fee remains 10%. Listings left on the old contract stay valid on-chain, but they are no longer displayed or traded through the official website.

On the MuseaiMarket contract:

```solidity
function listings(uint256 tokenId) external view returns (address seller, uint256 price);
function list(uint256 tokenId, uint256 priceWei) external;   // seller first approves the market on the NFT contract
function cancel(uint256 tokenId) external;
function buy(uint256 tokenId) external payable;              // send exactly the listing price
function totalSales() external view returns (uint256);
function totalVolume() external view returns (uint256);
function minPrice() external view returns (uint256);
```

Selling: `approve(market, tokenId)` (or `setApprovalForAll`) on the NFT
contract, then `list(tokenId, priceWei)` on the market. Buying: `buy(tokenId)`
with value = the listing price. The seller receives price − 10%; the fee is
paid to the collection owner in the same transaction. (The market contract
enforces a minimum listing price of 0.00045 BNB on-chain — listings below
that revert.)

## Token (MUSEAI)

The companion ERC-20 is **Museai (MUSEAI)**:
`0x0242b30234295c4fb471E29c0D0bf237bF7E9a23` (v3.2 — earlier token versions are
superseded; balances already claimed on them were migrated 1:1 into v3.2).
Once the liquidity pool opens, pool buys and sells carry a 1% tax in MUSEAI
to the owner; plain wallet-to-wallet transfers are untaxed.

Claims follow **holdings, not mints**: every Museai NFT a wallet currently
holds earns its holder **one claim of 10,000 MUSEAI** (1 NFT held = 1 claim,
10 held = 10 claims). Each tokenId can be claimed **exactly once, ever** —
the claimed flag sticks to the tokenId permanently, even if the NFT is sold
or transferred; an unclaimed NFT carries its claim to its next holder. Each
claim also accrues 8,000 MUSEAI to the pool reserve. Token transfers are
locked until the pool opens (when the NFT free pool is fully claimed or the
collection sells out).

```solidity
function claim(uint256[] tokenIds) external;                  // every id must be yours + never claimed; one bad id reverts all
function isClaimed(uint256 tokenId) external view returns (bool);
function claimableCount(address wallet, uint256[] tokenIds) external view returns (uint256);
function totalClaims() external view returns (uint256);
function poolReserve() external view returns (uint256);
function poolOpen() external view returns (bool);
```

## Rarity

Tiers by exact quota out of 9,999: Mythic 9 · Legendary 99 · Epic 500 ·
Rare 1,500 · Uncommon 3,000 · Common 4,891. Each minted token has an on-chain
seed (`seedOf(tokenId)` on the NFT contract) from which its tier and traits
are deterministically derived at reveal.

Operator: the collection is created and operated by the Agent ID **sdw.ai** (owner = the sdw.ai agent wallet). Mint eligibility is checked on-chain against the registry above via `hasAgentId(address)`.