For the complete documentation index, see llms.txt. This page is also available as Markdown.

Secondary Sales

The secondary-sales skill lets an AI agent buy listed domains on Doma's marketplace, accept offers, create listings or offers, and cancel orders. All flows are powered by Seaport NFT primitives.

At a glance

Manifest URL

https://doma.xyz/.well-known/skills/secondary-sales/SKILL.md

Backing CLI

@doma-protocol/cli (doma marketplace …)

Wallet modes

agent (Privy) and private-key

Trigger phrases

buy domain, purchase domain, secondary sale, make offer, Doma, Seaport

What it does

The skill encodes a complete buy / sell workflow:

  1. Asks the user which network (mainnet / testnet).

  2. Verifies prerequisites (CLI installed, wallet configured, sufficient funds + gas).

  3. Fetches the active listing for the requested domain.

  4. Surfaces price, currency, and expiry to the user for explicit confirmation.

  5. Executes via doma marketplace buy (or accept, cancel, offer, listing).

  6. Verifies ownership transfer and reports back.

Prerequisites

  • Node.js ≥ 20

  • @doma-protocol/cli installed (npm install -g @doma-protocol/cli)

  • A configured wallet (see Wallet Modes)

  • Sufficient balance in the listing's currency, plus gas

Wallet mode notes

agent

private-key

marketplace buy

marketplace accept

marketplace cancel --type on-chain

marketplace offer (gasless)

❌ today

marketplace listing (gasless)

❌ today

marketplace cancel (default off-chain)

❌ today

The gasless paths use eth_signTypedData_v4 and don't yet work in agent mode. See Agentic Wallet → Known limitation.

Example prompt

After installing the skill (see Discover & Use Skills):

"Buy <your-domain>.fyi on Doma using the listing currency."

The agent walks through:

  1. Network selection.

  2. Listing fetch (doma marketplace get <your-domain>.fyi --format json).

  3. Confirmation: "List price is 5.00 USDTEST (Doma testnet stablecoin), expires <date>. Buy now?"

  4. Execution (doma marketplace buy <your-domain>.fyi --yes --format json).

  5. Ownership verification (doma domain <your-domain>.fyi).

Supported scenarios

Scenario
Subcommand
Agent mode

Fill an active listing

marketplace buy

Accept an offer made on your domain

marketplace accept

Cancel a listing on-chain

marketplace cancel --type on-chain

Create a listing (gasless)

marketplace listing

❌ today

Make an offer on a domain (gasless)

marketplace offer

❌ today

Cancel a listing or offer off-chain

marketplace cancel

❌ today

Cross-references

Last updated