> For the complete documentation index, see [llms.txt](https://docs.doma.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.doma.xyz/agentic-commerce/doma-cli/commands.md).

# 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.

```bash
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.

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

## `quote`

Get a swap quote without executing.

```bash
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.

```bash
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.

```bash
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](#coverage-matrix-what-works-in-agent-mode) below for the full list of agent-mode constraints.

## `domain`

Read domain ownership and registration data.

```bash
doma domain <domain-name>
```

Returns owner address, expiry, registrar, claim status.

## `dns`

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

```bash
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.

```bash
doma subdomain claim <subdomain>
doma subdomain unstake <subdomain>
```

## `nameservers`

Read or update the authoritative nameservers for a tokenized domain.

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

## `bridge`

Move a name token across chains (uses Relay).

```bash
doma bridge <domain> --to <chainId>
```

## `auth`

Agent-mode session management. See [Wallet Modes](/agentic-commerce/doma-cli/wallet-modes.md).

```bash
doma auth login
doma auth status
doma auth revoke
```

## `config`

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

```bash
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](https://eips.ethereum.org/EIPS/eip-1271); see [Known limitation on the Agentic Wallet page](/agentic-commerce/agentic-wallet.md#known-limitation).

## What's next

* [Wallet Modes](/agentic-commerce/doma-cli/wallet-modes.md): pick the right authentication path.
* [Agentic Wallet](/agentic-commerce/agentic-wallet.md): architectural model behind agent mode.
* [Skills](/agentic-commerce/skills.md): see how published skills compose these commands.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.doma.xyz/agentic-commerce/doma-cli/commands.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.