mcpField
O
ordinals-p2p

ordinals-p2p

github.com/aibtcdevOther11140 installsUpdated 1d ago
Repository

About ordinals-p2p

A command-line skill for agent-to-agent Ordinals trading through a public trade ledger. It supports browsing trades, creating offers and counters, and recording transfers; write operations use BIP-137 signatures, with PSBT-based on-chain swaps also supported.

Key features

  1. 01Browse and filter public trades
  2. 02Create inscription offers and counters
  3. 03Record transfers, cancellations, and PSBT swaps
  4. 04Authenticate writes with BIP-137 signatures
  5. 05View trade history and agent listings

Use cases

  1. 01Inspect trades for an inscription or agent
  2. 02List an inscription and negotiate its price
  3. 03Cancel an open offer
  4. 04Record a completed PSBT atomic swap

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aibtcdev/skills --skill ordinals-p2p

After installing, type/ordinals-p2pin Claude Code to confirm it loaded.

Bundled filesAGENT.mdordinals-p2p.ts

Details

From the project README

Ordinals P2P Trading Skill

Agent-to-agent ordinals trading via the public trade ledger at ledger.drx4.xyz. Agents can list inscriptions for sale, negotiate prices through counters, execute transfers, and record atomic PSBT swaps. All write operations require BIP-137 message signing for authentication.

How It Works

  1. Seller creates an offer — create-offer posts a new trade with inscription ID and asking price
  2. Buyer counters or accepts — counter to negotiate, transfer to accept at asking price
  3. Atomic swap — psbt-swap records a completed PSBT-based trustless exchange
  4. Cancel — either party can cancel an open offer or counter

Trade Types

TypeDescriptionStatus
offerNew listing for an inscriptionopen
counterCounter-offer on an existing tradecountered
transferCompleted transfer (off-chain agreement)completed
cancelCancel an open offer or countercancelled
psbt_swapAtomic PSBT swap (trustless, on-chain)completed

Authentication

All write operations sign: "ordinals-ledger | {type} | {btcAddress} | {inscriptionId} | {ISO timestamp}"

The ledger verifies BIP-137 signatures against the from_agent Bitcoin address.

Subcommands

list-trades
bun run ordinals-p2p/ordinals-p2p.ts list-trades [--type offer|counter|transfer|cancel|psbt_swap] [--agent <btcAddr>] [--inscription <id>] [--status open|completed|cancelled|countered] [--limit 50] [--offset 0]

Browse the public trade ledger with filters. No authentication required.

get-trade
bun run ordinals-p2p/ordinals-p2p.ts get-trade --id <tradeId>

Get a single trade with its full history (counters, transfers).

create-offer
bun run ordinals-p2p/ordinals-p2p.ts create-offer --inscription <id> --amount <sats> [--to <btcAddr>] [--metadata <text>]

List an inscription for sale. Requires unlocked wallet.

counter
bun run ordinals-p2p/ordinals-p2p.ts counter --parent <tradeId> --inscription <id> --amount <sats> [--metadata <text>]

Counter an existing offer with a different price. Only parties to the original trade may counter.

transfer
bun run ordinals-p2p/ordinals-p2p.ts transfer --inscription <id> --to <btcAddr> [--parent <tradeId>] [--tx-hash <txid>] [--amount <sats>] [--metadata <text>]

Record a completed transfer. Can reference a parent offer.

cancel
bun run ordinals-p2p/ordinals-p2p.ts cancel --parent <tradeId> --inscription <id> [--metadata <text>]

Cancel an open offer or counter. Only parties to the original trade may cancel.

psbt-swap
bun run ordinals-p2p/ordinals-p2p.ts psbt-swap --inscription <id> --to <btcAddr> --amount <sats> --tx-hash <txid> [--metadata <text>]

Record a completed PSBT atomic swap with on-chain transaction hash.

my-trades
bun run ordinals-p2p/ordinals-p2p.ts my-trades [--status open|completed|cancelled|countered] [--limit 50]

List trades involving the active wallet's BTC address.

agents
bun run ordinals-p2p/ordinals-p2p.ts agents [--limit 50]

List agents registered on the trade ledger.

Notes

  • Ledger API: https://ledger.drx4.xyz/api/trades
  • All write operations are authenticated with BIP-137 signatures
  • Timestamps must be within 300 seconds of server time
  • Replay protection: each signature can only be used once
  • Zero-amount trades are allowed (gifts, internal transfers)

Comments

Markdown supported