Commands

Per-command reference. All commands accept --quiet --format json for clean machine-readable output (no color, no spinner, no narration on stdout). Errors still go to stderr.

Global flags

Flag	Purpose
--testnet	Run against Doma Testnet (chain 97476) instead of mainnet (97477).
-q, --quiet	Suppress decorative output (spinners, banners).
-f, --format <fmt>	Output format: pretty (default), json, csv.
-y, --yes	Skip confirmation prompts (use with care in agent contexts).

token

Fetch detailed token information.

doma token <token-name>

Returns: price, 24h change, volume, trading venue (Launchpad / UniswapV3 / BoughtOut), fees, liquidity, status (FRACTIONALIZED, GRADUATION_SUCCESSFUL, GRADUATION_FAILED, BOUGHT_OUT), fillPercent, graduatedAt.

balance

Show wallet balances. Defaults to ETH + USDC if no specific token.

doma balance              # ETH + USDC
doma balance USDC         # specific token
doma balance <token-name> # named token

quote

Get a swap quote without executing.

doma quote <tokenIn> <tokenOut> <amount>

Returns the route the CLI will use (Launchpad bonding curve, Uniswap V3, or multi-step), the expected amount-out, price impact, slippage, and gas estimate.

swap

Execute a token swap. Auto-routes via Launchpad bonding curve, Uniswap V3, or a multi-step path.

doma swap <tokenIn> <tokenOut> <amount>

Option	Default	Notes
-s, --slippage <bps>	50 (= 0.5%)	Slippage tolerance in basis points.
-y, --yes	off	Skip the confirmation prompt.

marketplace

Subcommands for the Seaport-based domain marketplace.

doma marketplace get <domain>          # active listing for a domain
doma marketplace buy <domain>          # fill a listing (fulfillOrder)
doma marketplace listing <domain> ...  # create an offchain listing
doma marketplace offer <domain> ...    # create an offchain offer
doma marketplace accept <orderId>      # accept an offer
doma marketplace cancel <orderId>      # cancel a listing or offer

doma marketplace get is read-only and works in either wallet mode without authentication. The other subcommands require a configured wallet.

The cancel subcommand has a --type flag (on-chain vs off-chain); off-chain is the default and is faster but uses eth_signTypedData_v4. In agent mode, only --type on-chain is supported today. See the coverage matrix below for the full list of agent-mode constraints.

domain

Read domain ownership and registration data.

doma domain <domain-name>

Returns owner address, expiry, registrar, claim status.

dns

Manage DNS records on the Doma chain (sponsored gas).

doma dns list <domain>
doma dns set <domain> <type> <name> <value> [--ttl 3600]
doma dns delete <domain> <type> <name>

subdomain

Claim or release a staked subdomain on the Doma chain.

doma subdomain claim <subdomain>
doma subdomain unstake <subdomain>

nameservers

Read or update the authoritative nameservers for a tokenized domain.

doma nameservers get <domain>
doma nameservers set <domain> <ns1> <ns2> ...

bridge

Move a name token across chains (uses Relay).

doma bridge <domain> --to <chainId>

auth

Agent-mode session management. See Wallet Modes.

doma auth login
doma auth status
doma auth revoke

config

Read and write ~/.doma/config.json.

doma config get <key>
doma config set <key> <value>
doma config list

Coverage matrix: what works in agent mode

Command	Underlying RPC method	Agent mode	Notes
marketplace buy	eth_sendTransaction (Seaport.fulfillOrder)	✅
marketplace accept	eth_sendTransaction	✅	Same path as buy.
marketplace cancel --type on-chain	eth_sendTransaction	✅
swap (Launchpad)	eth_sendTransaction × 2	✅
swap (Uniswap V3)	eth_sendTransaction × 3	✅
swap (multi-step)	eth_sendTransaction × 4–5	✅
bridge (Relay)	eth_sendTransaction × N	✅
dns set / dns delete	eth_sendTransaction (sponsored)	✅
subdomain claim / unstake	eth_sendTransaction (sponsored)	✅
nameservers set	eth_sendTransaction (sponsored)	✅
marketplace offer (gasless)	eth_signTypedData_v4	❌	Off-chain signature limitation, see below.
marketplace listing (gasless)	eth_signTypedData_v4	❌	Same.
marketplace cancel (default off-chain)	eth_signTypedData_v4	❌	Same.

10 of the 13 listed operations work in agent mode today.

The 3 gasless paths use eth_signTypedData_v4. The agent's authorization key (not the wallet's underlying key) would sign. Off-chain protocols like Seaport reject this because the signing address ≠ the wallet address. The fix is a smart-wallet migration with ERC-1271; see Known limitation on the Agentic Wallet page.

What's next

• Wallet Modes: pick the right authentication path.

• Agentic Wallet: architectural model behind agent mode.

• Skills: see how published skills compose these commands.