xrpl-payments

XRPL Payments

XRP Ledger は、高速かつ信頼性の高い価値移転を実現するために設計されています。機関投資家向けの決済を信頼できるものにしている特性は、AI エージェントにも適しています。3～5 秒で確定する決定論的なファイナリティ、予測可能な手数料、曖昧な保留状態がないことです。トランザクションは確定（tesSUCCESS）するか、期限切れになるかのどちらかです。リトライループは必要ありません。

XRPL Payments スキルは、XRP Ledger での決済操作に関するドメイン知識レイヤーです。XRPL の決済パターンに関する正確で最新の知識を Claude に提供するため、XRP の送金、RLUSD、異なる通貨間の決済、エスクローなど、あらゆる決済タスクに適したトランザクションオブジェクトを構築できます。

このスキルは、XRP の送金、RLUSD、異なる通貨間の決済、エスクローなど、あらゆる決済タスクに適したトランザクションオブジェクトを構築し、署名と送信のために XRPL Agent Wallet スキルに渡します。エージェントによる決済ワークフローを完結させるには、両方のスキルが必要です。

このスキルで扱う内容

分野	対応内容
アカウントへの資金供給	フォーセットからの資金供給、残高の確認、リザーブ要件
XRP 決済	直接送金、宛先タグ、部分決済
RLUSD 決済	トラストラインの設定、RLUSD の送金、Testnet と Mainnet の発行者アドレス
IOU トークン決済	汎用トラストライン・トークンの送金
異なる通貨間の決済	組み込み DEX による単一トランザクションでの通貨換算
エスクロー	時間ベースおよび条件付きのエスクローの作成、完了、キャンセル
エージェント向けのベストプラクティス	エージェントの帰属を示す SourceTag、オンチェーンの監査証跡としての Memos、WebSocket による監視
エラー処理	トランザクション結果コード（tec*、tef*、tem*、ter*）、リザーブ要件、送信前のシミュレーション
セキュリティ	鍵管理のパターン、支出制限、リザーブへの留意

---

連携するスキル

スキル	役割
XRPL Agent Wallet	必須 — ウォレットの作成と鍵の読み込みを行い、このスキルが構築するすべてのトランザクションに署名して送信します

Payments スキルは、拡大を続ける XRPL ドメインスキル群の一つです。すべてのドメインスキルは、共通の Wallet スキルと組み合わせて使用します。全スキルの一覧は AI Toolingをご覧ください。

まずウォレットが必要ですか？ ユーザーがまだ XRPL ウォレットを持っていない場合は、XRPL Agent Wallet スキルを読み込んでください。ウォレットの生成、シードの .env への安全な書き込みを行い、チャットにシードを表示することはありません。ウォレットの準備ができたら、ここに戻ってください。

デフォルトの動作とスタックに関する決定事項

• 言語： Python（xrpl-py）と TypeScript/JavaScript（xrpl.js）のどちらも第一級の選択肢です。開発者のプロジェクトですでに使われている言語を使用してください。既存のコードベースがない場合は、確認してください。リファレンスのコード例では両方を扱っています。
• トランザクションの送信： すべて XRPL Agent Wallet スキルが処理します。このスキルはトランザクションオブジェクトを構築しますが、submit_and_wait や submitAndWait を直接呼び出しません。
• 金額の処理： 常に xrpl.utils の xrp_to_drops() / drops_to_xrp() を使用してください。台帳に生の XRP 浮動小数点数を渡さないでください。
• ネットワーク： デフォルトは Testnet（https://s.altnet.rippletest.net:51234）です。Mainnet への切り替えは URL を 1 行変更するだけです。
• エージェントのタグ付け： SourceTag を使うと、オンチェーンの取引量を追跡でき、エージェントによるアクティビティと人間が開始したトランザクションを区別できます。支払い構築コードでは設定しないでください。 XRPL Agent Wallet スキルは、SourceTag が設定されていないトランザクションに対し、署名セレモニー中に SourceTag = 20260530 を適用します。これにより、すべてのドメインスキルで一貫してタグ付けされます。意図的なカスタムタグを使う場合、またはオプトアウトするために 0 を指定する場合に限り、明示的に設定してください。Wallet スキルはすでに設定されている値をそのまま使用します。20260530 のみでフィルタリングしても、加盟店が指定したタグを持つ x402 の支払いは対象にならない点に注意してください。
• 送信前のシミュレーション： 新しい支払いフローでは、スキルが生のトランザクションオブジェクトに対して simulate を呼び出してから、Wallet スキルに渡します。これにより、手数料を使ったり署名セレモニーを開始したりせずに、不正な形式のトランザクション、トラストラインの不足、リザーブのエラーを検出できます。

操作手順

1. 支払いの種類を特定する — XRP、RLUSD、IOU、またはクロスカレンシーのいずれかを確認します。payments.md を参照してください。
2. 前提条件を確認する — トラストラインは設定済みですか？送金先にはリザーブがありますか？手数料を含めた十分な残高がありますか？
3. 構築する — トランザクションオブジェクトを構築します。エージェントが開始するすべてのトランザクションに Memos を設定してください。Fee、Sequence、LastLedgerSequence は設定しないでください。Wallet スキルの自動入力ステップで、稼働中のノードからこれらの値が設定されます。
4. シミュレーションする — Wallet スキルに渡す前に、生の（自動入力前の）トランザクションに対して simulate を呼び出します。これにより、台帳に作用したり署名セレモニーを開始したりせずに、不正な形式のトランザクション、トラストラインの不足、リザーブのエラーを検出できます。payments.md のシミュレーションパターンを参照してください。
5. Wallet スキルに渡す — トランザクションオブジェクトを XRPL Agent Wallet スキルに渡します。Wallet スキルが値を自動入力し、人間にプレビューを表示して確認を得たうえで、ローカルで署名し、submitAndWait で送信します。このスキルから submit_and_wait や submitAndWait を呼び出さないでください。
6. エラーを明示的に処理する — tec* コードは手数料が請求されたことを示します。tef*/tem* は手数料が請求されなかったことを示します。payments.md のエラー表を参照してください。

このスキルが行わないこと

• ウォレットの作成やキーの処理。 ウォレットの生成、シードの保存、キーの読み込み、およびすべてのキー管理は XRPL Agent Wallet スキルの担当です。
• トランザクションへの署名や送信。 それらは Wallet スキルの担当です。
• 独自の判断による、支払い以外のトランザクションの構築。 このスキルは開発者とユーザーの指示に応答します。指示がないのにトランザクションを提案することはありません。
• Mainnet の RLUSD 発行者アドレスが最新であることの保証。 Testnet の発行者（rQhWct2fv4Vc4KRjRgMrxa8xPN9Zx9iLKV）は確認済みです。本番環境で使用する前に、Mainnet の発行者（rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De）をRLUSD official Documentation で確認してください。

リファレンスファイル

トランザクションパターンとエッジケースの詳細が必要な場合は、以下を参照してください。

• payments.md — XRP、RLUSD、IOU、クロスカレンシー、エスクロー、ペイメントチャネル、エージェントによるパターン、エラーコード、リザーブ