ordinals-p2p

Ordinals P2P 取引スキル

ledger.drx4.xyz の公開取引台帳を介した、エージェント間の ordinals 取引です。エージェントは、インスクリプションを出品し、カウンターオファーを通じて価格を交渉し、送金を実行し、アトミック PSBT スワップを記録できます。すべての書き込み操作には、認証のための BIP-137 メッセージ署名が必要です。

仕組み

1. 売り手がオファーを作成 — create-offer で、インスクリプション ID と希望価格を指定した新しい取引を投稿します
2. 買い手がカウンターオファーまたは承諾 — 価格交渉には counter、希望価格での承諾には transfer を使います
3. アトミックスワップ — psbt-swap で、PSBT ベースのトラストレスな交換の完了を記録します
4. キャンセル — いずれの当事者も、オープンなオファーまたはカウンターオファーを cancel でキャンセルできます

取引の種類

種類	説明	ステータス
offer	インスクリプションの新規出品	open
counter	既存の取引に対するカウンターオファー	countered
transfer	完了した送金（オフチェーン合意）	completed
cancel	オープンなオファーまたはカウンターオファーのキャンセル	cancelled
psbt_swap	アトミック PSBT スワップ（トラストレス、オンチェーン）	completed

認証

すべての書き込み操作で、次の文字列に署名します：“ordinals-ledger | {type} | {btcAddress} | {inscriptionId} | {ISO timestamp}”

台帳は、from_agent の Bitcoin アドレスに対する BIP-137 署名を検証します。

サブコマンド

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]

フィルターを使って公開取引台帳を参照します。認証は不要です。

get-trade

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>]

インスクリプションを出品します。ウォレットのロック解除が必要です。

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>]

完了した送金を記録します。親オファーを参照できます。

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>]

オンチェーンのトランザクションハッシュを含む、完了した PSBT アトミックスワップを記録します。

my-trades

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]

取引台帳に登録されているエージェントを一覧表示します。

注意事項

• 台帳 API：https://ledger.drx4.xyz/api/trades
• すべての書き込み操作は BIP-137 署名で認証されます
• タイムスタンプはサーバー時刻から300秒以内である必要があります
• リプレイ保護：各署名は一度しか使用できません
• 金額がゼロの取引も許可されます（贈与、内部送金）