ordinals-p2p

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Ordinals P2P Trading Skill

Ordinals 点对点交易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.

通过

ledger.drx4.xyz

的公开交易账本实现Agent间的Ordinals交易。Agent可以挂牌出售铭文、通过还价协商价格、执行转账，并记录原子化PSBT交换。所有写入操作都需要通过BIP-137消息签名进行身份验证。

How It Works

工作流程

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

卖家创建报价 —
```
create-offer
```
发布包含铭文ID和要价的新交易
买家还价或接受 — 使用
```
counter
```
进行协商，使用
```
transfer
```
接受要价
原子交换 —
```
psbt-swap
```
记录已完成的基于PSBT的无需信任交换
取消 — 交易双方均可
```
cancel
```
未完成的报价或还价

Trade Types

交易类型

Type	Description	Status
`offer`	New listing for an inscription	`open`
`counter`	Counter-offer on an existing trade	`countered`
`transfer`	Completed transfer (off-chain agreement)	`completed`
`cancel`	Cancel an open offer or counter	`cancelled`
`psbt_swap`	Atomic PSBT swap (trustless, on-chain)	`completed`

类型	描述	状态
`offer`	新的铭文挂牌	`open`
`counter`	对现有交易的还价	`countered`
`transfer`	已完成的转账（链下协议）	`completed`
`cancel`	取消未完成的报价或还价	`cancelled`
`psbt_swap`	原子化PSBT交换（无需信任，链上）	`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.

所有写入操作需签名：

"ordinals-ledger | {type} | {btcAddress} | {inscriptionId} | {ISO timestamp}"

账本会根据

from_agent

的比特币地址验证BIP-137签名。

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.

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]

浏览带筛选条件的公开交易账本。无需身份验证。

get-trade

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

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

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

获取单条交易及其完整历史（还价、转账）。

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.

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

挂牌出售铭文。需要解锁钱包。

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.

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

对现有报价进行还价。仅原交易参与方可执行此操作。

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.

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

记录已完成的转账。可关联父报价。

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.

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

取消未完成的报价或还价。仅原交易参与方可执行此操作。

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.

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

记录已完成的PSBT原子交换，并关联链上交易哈希。

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.

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

列出与当前钱包BTC地址相关的所有交易。

agents

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

List agents registered on the trade ledger.

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

列出在交易账本上注册的所有Agent。

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)

账本API：
```
https://ledger.drx4.xyz/api/trades
```
所有写入操作均通过BIP-137签名进行身份验证
时间戳必须与服务器时间相差不超过300秒
重放保护：每个签名仅可使用一次
支持零金额交易（赠予、内部转账）