# RARE CLI command map

This map reflects the current Commander command tree exposed by `src/index.ts` and `src/commands/**`.

Global behavior:
- `--json` is accepted globally.
- Liquid Edition deploy defaults to preview output; pass `--yes` to submit the transaction. `--preview` remains an explicit read-only mode.
- Quoted swap commands print the quote and prompt `[y/N]` before submitting unless `--yes` is passed. `--quote-only` exits after printing the quote.
- Commands that can perform extra or surprising state changes, such as approvals or raw swap execution, use an interactive `[y/N]` confirmation when supported; `--yes` skips that confirmation.
- `--split <addr=ratio>` is repeatable up to 5 times. Ratios must sum to 100.
- This map reflects Commander-level required options. Command action handlers may still require conditionally dependent inputs before execution.

rare configure [--chain <chain>] [--chain-id <id>] [--private-key <key>] [--private-key-ref <ref>] [--rpc-url <url>] [--uniswap-api-key <key>] [--uniswap-api-key-ref <ref>] [--default-chain <chain>] [--show]
rare configure delete [--yes]
rare mcp serve [--allow-writes]

rare status --contract <address> [--token-id <id>] [--chain <chain>] [--chain-id <id>]
rare wallet generate [--chain <chain>] [--chain-id <id>] [--save]
rare wallet address [--chain <chain>] [--chain-id <id>]
rare currencies [--chain <chain>] [--chain-id <id>]

rare search nfts [--chain <chain>] [--chain-id <id>] [--query <text>] [--owner <address>] [--mine] [--has-auction] [--auction-state <state>] [--auction-creator <address>] [--auction-bidder <address>] [--has-listing] [--listing-type <type>] [--has-offer] [--offer-buyer <address>] [--per-page <n>] [--page <n>]
rare search collections [--chain <chain>] [--chain-id <id>] [--query <text>] [--per-page <n>] [--page <n>]
rare search events [--collection-id <id>] [--contract <address>] [--token-id <id>] [--event-type <type>] [--sort-by <field>] [--per-page <n>] [--page <n>] [--chain <chain>] [--chain-id <id>]
rare user get <address>
rare nft get --contract <address> --token-id <id> [--chain <chain>] [--chain-id <id>]

rare import erc721 --contract <address> [--chain <chain>] [--chain-id <id>]

rare ipfs pin-file --file <path> [--filename <name>] [--uri-only]
rare ipfs pin-json [--data <json>] [--stdin] [--filename <name>] [--uri-only]

rare collection get <id> [--chain <chain>] [--chain-id <id>]
rare collection list --account <address> [--chain <chain>] [--chain-id <id>] [--per-page <n>] [--page <n>]
rare collection deploy erc721 <name> <symbol> [--max-tokens <number>] [--chain <chain>] [--chain-id <id>]
rare collection deploy lazy-erc721 <name> <symbol> --max-tokens <number> [--contract-type <type>] [--chain <chain>] [--chain-id <id>]
rare collection deploy lazy-batch-mint <name> <symbol> [--max-tokens <number>] [--chain <chain>] [--chain-id <id>]
rare collection mint --contract <address> [--token-uri <uri>] [--name <name>] [--description <description>] [--image <path>] [--video <path>] [--tag <tag>] [--attribute <attr>] [--to <address>] [--royalty-receiver <address>] [--chain <chain>] [--chain-id <id>]
rare collection mint-batch --contract <address> --base-uri <uri> --amount <number> [--chain <chain>] [--chain-id <id>]
rare collection prepare-lazy-mint --contract <address> --base-uri <uri> --amount <number> [--minter <address>] [--chain <chain>] [--chain-id <id>]
rare collection creator --contract <address> --token-id <id> [--chain <chain>] [--chain-id <id>]
rare collection metadata status --contract <address> [--chain <chain>] [--chain-id <id>]
rare collection metadata update-base-uri --contract <address> --base-uri <uri> [--chain <chain>] [--chain-id <id>]
rare collection metadata update-token-uri --contract <address> --token-id <id> --token-uri <uri> [--chain <chain>] [--chain-id <id>]
rare collection metadata lock-base-uri --contract <address> [--chain <chain>] [--chain-id <id>]

rare collection royalty status --contract <address> --token-id <id> [--price <raw>] [--chain <chain>] [--chain-id <id>]
rare collection royalty set-default-receiver --contract <address> --receiver <address> [--chain <chain>] [--chain-id <id>]
rare collection royalty set-default-percentage --contract <address> --percentage <number> [--chain <chain>] [--chain-id <id>]
rare collection royalty set-token-receiver --contract <address> --token-id <id> --receiver <address> [--chain <chain>] [--chain-id <id>]

rare liquid-edition deploy multicurve <name> <symbol> [--curves-file <path>] [--curve-preset <preset>] [--write-curves-file <path>] [--initial-rare-liquidity <amount>] [--total-supply <amount>] [--preview] [--yes] [--token-uri <uri>] [--description <description>] [--image <path>] [--video <path>] [--tag <tag>] [--attribute <attr>] [--chain <chain>] [--chain-id <id>]
rare liquid-edition status --contract <address> [--chain <chain>] [--chain-id <id>]
rare liquid-edition token-uri --contract <address> [--chain <chain>] [--chain-id <id>]
rare liquid-edition set-render-contract --contract <address> --render-contract <address> [--chain <chain>] [--chain-id <id>]

rare bridge quote --amount <amount> --destination-chain <chain> [--recipient <address>] [--chain <chain>] [--chain-id <id>]
rare bridge send --amount <amount> --destination-chain <chain> [--recipient <address>] [--chain <chain>] [--chain-id <id>] [--yes]

rare listing list --account <address> [--chain <chain>] [--chain-id <id>] [--per-page <n>] [--page <n>]
rare listing create --contract <address> --token-id <id> --price <amount> [--currency <currency>] [--target <address>] [--split <addr=ratio>] [--yes] [--chain <chain>] [--chain-id <id>]
rare listing buy --contract <address> --token-id <id> --price <amount> [--currency <currency>] [--yes] [--chain <chain>] [--chain-id <id>]
rare listing cancel --contract <address> --token-id <id> [--target <address>] [--chain <chain>] [--chain-id <id>]
rare listing status --contract <address> --token-id <id> [--target <address>] [--chain <chain>] [--chain-id <id>]

rare listing release configure --contract <address> --price <amount> --max-mints <number> [--currency <currency>] [--start-time <time>] [--split <addr=ratio>] [--chain <chain>] [--chain-id <id>]
rare listing release mint --contract <address> [--quantity <number>] [--currency <currency>] [--price <amount>] [--proof <file>] [--recipient <address>] [--yes] [--chain <chain>] [--chain-id <id>]
rare listing release status --contract <address> [--account <address>] [--chain <chain>] [--chain-id <id>]
rare listing release allowlist build --input <file> [--format <format>] [--output <file>]
rare listing release allowlist proof --input <file> --account <address> [--output <file>]
rare listing release allowlist set --contract <address> --end-time <time> [--input <file>] [--root <bytes32>] [--chain <chain>] [--chain-id <id>]
rare listing release allowlist clear --contract <address> [--chain <chain>] [--chain-id <id>]
rare listing release limits set-mint --contract <address> --limit <number> [--chain <chain>] [--chain-id <id>]
rare listing release limits set-tx --contract <address> --limit <number> [--chain <chain>] [--chain-id <id>]

rare listing batch list --account <address> [--chain <chain>] [--chain-id <id>] [--per-page <n>] [--page <n>]
rare listing batch create --input <path> [--format <format>] [--currency <currency>] [--price <amount>] [--split <addr=ratio>] [--yes] [--chain <chain>] [--chain-id <id>]
rare listing batch buy [--proof <path>] [--root <hex>] [--contract <address>] [--token-id <id>] --creator <address> --currency <currency> --price <amount> [--yes] [--chain <chain>] [--chain-id <id>]
rare listing batch cancel [--input <path>] [--root <hex>] [--contract <address>] [--token-id <id>] [--chain <chain>] [--chain-id <id>]
rare listing batch set-allowlist [--input <path>] [--root <hex>] [--contract <address>] [--token-id <id>] [--allowlist-root <hex>] [--end-time <unix>] [--chain <chain>] [--chain-id <id>]
rare listing batch status [--root <hexOrPath>] --creator <address> [--contract <address>] [--token-id <id>] [--proof <path>] [--chain <chain>] [--chain-id <id>]

rare offer list --account <address> --side <maker|taker> [--chain <chain>] [--chain-id <id>] [--per-page <n>] [--page <n>]
rare offer create --contract <address> --token-id <id> --price <amount> [--currency <currency>] [--chain <chain>] [--chain-id <id>] [--yes]
rare offer accept --contract <address> --token-id <id> --price <amount> [--currency <currency>] [--split <addr=ratio>] [--chain <chain>] [--chain-id <id>] [--yes]
rare offer cancel --contract <address> --token-id <id> [--currency <currency>] [--chain <chain>] [--chain-id <id>]
rare offer status --contract <address> --token-id <id> [--currency <currency>] [--chain <chain>] [--chain-id <id>]

rare offer batch create [--root <bytes32>] [--input <path>] [--format <format>] [--chain-id <id>] --price <amount> [--currency <currency>] --end-time <time> [--chain <chain>] [--yes]
rare offer batch accept --creator <address> [--proof <path>] [--root <bytes32>] --contract <address> --token-id <id> [--split <addr=ratio>] [--yes] [--chain <chain>] [--chain-id <id>]
rare offer batch revoke [--root <bytes32>] [--input <path>] [--format <format>] [--chain-id <id>] [--chain <chain>]
rare offer batch status --creator <address> [--root <bytes32>] [--input <path>] [--format <format>] [--chain-id <id>] [--chain <chain>]

rare auction list --account <address> --side <maker|taker> [--chain <chain>] [--chain-id <id>] [--per-page <n>] [--page <n>]
rare auction create --contract <address> --token-id <id> --price <amount> --end-time <time> [--type <type>] [--start-time <seconds>] [--currency <currency>] [--split <addr=ratio>] [--chain <chain>] [--chain-id <id>] [--yes]
rare auction bid --contract <address> --token-id <id> --price <amount> [--currency <currency>] [--chain <chain>] [--chain-id <id>] [--yes]
rare auction settle --contract <address> --token-id <id> [--chain <chain>] [--chain-id <id>]
rare auction cancel --contract <address> --token-id <id> [--chain <chain>] [--chain-id <id>]
rare auction status --contract <address> --token-id <id> [--chain <chain>] [--chain-id <id>]

rare auction batch create [--root <bytes32>] [--input <path>] [--format <format>] [--chain-id <id>] --price <amount> [--currency <currency>] --end-time <time> [--split <addr=ratio>] [--yes] [--chain <chain>]
rare auction batch bid --creator <address> [--proof <path>] [--root <bytes32>] --contract <address> --token-id <id> --price <amount> [--currency <currency>] [--yes] [--chain <chain>] [--chain-id <id>]
rare auction batch settle --contract <address> --token-id <id> [--chain <chain>] [--chain-id <id>]
rare auction batch cancel [--root <bytes32>] [--input <path>] [--format <format>] [--chain-id <id>] [--chain <chain>]
rare auction batch status --contract <address> --token-id <id> [--creator <address>] [--root <bytes32>] [--input <path>] [--proof <path>] [--format <format>] [--chain-id <id>] [--chain <chain>]

rare swap buy-token --token <address> --amount-in <amount> [--route <auto|local|uniswap|raw>] [--slippage-bps <bps>] [--min-amount-out <amount>] [--commands <hex>] [--inputs-file <path>] [--quote-only] [--yes] [--recipient <address>] [--deadline <seconds>] [--chain <chain>] [--chain-id <id>]
rare swap sell-token --token <address> --amount-in <amount> [--route <auto|local|uniswap|raw>] [--slippage-bps <bps>] [--min-amount-out <amount>] [--commands <hex>] [--inputs-file <path>] [--quote-only] [--yes] [--recipient <address>] [--deadline <seconds>] [--chain <chain>] [--chain-id <id>]
rare swap buy-rare --amount-in <amount> [--slippage-bps <bps>] [--min-amount-out <amount>] [--quote-only] [--yes] [--recipient <address>] [--deadline <seconds>] [--chain <chain>] [--chain-id <id>]
rare swap tokens --token-in <address> --amount-in <amount> --token-out <address> --min-amount-out <amount> --commands <hex> --inputs-file <path> [--recipient <address>] [--deadline <seconds>] [--yes] [--chain <chain>] [--chain-id <id>]

rare utils tree build --input <path> [--format <format>] [--chain <chain>] [--chain-id <id>] [--output <path>]
rare utils tree proof --input <path> --contract <address> --token-id <id> [--format <format>] [--chain <chain>] [--chain-id <id>] [--output <path>]
rare utils tree verify --input <path> --contract <address> --token-id <id> [--proof <path>] [--root <bytes32>] [--format <format>] [--chain <chain>] [--chain-id <id>]
rare utils merkle proof --input <path> --contract <address> --token-id <id> [--buyer <address>] [--output <path>]