xrpl-dev

XRPL 開発スキル

このスキルの用途

ユーザーから次の依頼があった場合に、このスキルを使用します。

• XRPL dApp の開発（任意の言語／フレームワーク）
• 新しい XRPL プロジェクトのスキャフォールディング
• フロントエンドのウォレット接続（Crossmark、Xaman、GemWallet）
• アカウントの作成、資金の補充、管理
• トランザクションの構築、署名、送信
• トークン操作（TrustLines、発行通貨、MPT）
• NFT 操作（XLS-20 NFTokens）
• DEX との連携（オファー、オーダーブック、パス探索）
• AMM（自動マーケットメーカー）操作
• クロスチェーン相互運用（Axelar ブリッジ、XRPL EVM サイドチェーン）
• ペイメントチャネル、エスクロー、チェック
• XRPL トランザクションと統合のセキュリティレビュー

デフォルトの技術スタックの選択（推奨）

1. スキャフォールディング：create-xrp

   • 新しいプロジェクトでは、npx create-xrp my-app から始めます。
   • Next.js（React）または Nuxt（Vue）を使用した Turborepo モノレポをスキャフォールディングします。
   • 事前設定済み：xrpl-connect によるウォレット接続、ネットワーク切り替え、Tailwind CSS、トランザクション UI。
   • スマートコントラクトのサポートは実験段階のため、デフォルトでは使用しません。

2. クライアント SDK：まず xrpl.js（JavaScript/TypeScript）

   • 新しい JS/TS クライアントコードでは、すべて xrpl を使用します。
   • Python プロジェクトでは、xrpl-py を使用します。
   • Java/Kotlin では、xrpl4j を使用します。

3. フロントエンド：まず xrpl-connect

   • ウォレット接続と署名 UX には、すべて xrpl-connect を使用します。
   • フレームワークに依存しない Web コンポーネント（<xrpl-wallet-connector>）で、React、Vue、Next.js、Nuxt、バニラ JS で動作します。
   • Xaman、Crossmark、GemWallet、WalletConnect、Ledger 用のアダプターが組み込まれています。
   • イベント駆動型の WalletManager が、接続状態、セッションの永続化、自動再接続を処理します。

4. ネットワーク：開発には testnet

   • 常に testnet（wss://s.altnet.rippletest.net:51233）をデフォルトにします。
   • 実験的な機能や Amendment 機能には devnet を使用します。
   • 開発コードに mainnet のエンドポイントをハードコードしないでください。

5. トランザクション署名：ローカルまたはウォレットに委任

   • バックエンド／スクリプトでは、ローカルで署名し、秘密情報をネットワーク経由で送信しないでください。
   • フロントエンドでは、署名を接続済みウォレットに委任します。
   • 本番環境のバックエンドでは、カストディアル署名サービスまたはハードウェアウォレットを優先します。

6. アカウント管理：リザーブを考慮

   • 操作の前に、リザーブ要件を必ず確認してユーザーに伝えます。
   • 基本リザーブ（現在は 10 XRP）＋オーナーリザーブ（所有オブジェクトごとに 2 XRP）。
   • 操作によってリザーブがロックされる場合は、ユーザーに警告します。

7. エラー処理：明示的に行う

   • 送信時の tesSUCCESS だけでなく、必ず validated 状態を確認します。
   • tec* コード（請求されたが失敗）と tef*／tem* コードを区別して処理します。
   • terQUEUED と tefPAST_SEQ に対する再試行ロジックを実装します。

作業手順（タスクの実行方法）

1. タスクのレイヤーを分類する

• スキャフォールディング — 新しいプロジェクトのセットアップ
• フロントエンド／ウォレットレイヤー — ウォレット接続、署名 UX、状態の表示
• クライアント／スクリプトレイヤー — トランザクションの構築や送信、レジャー状態の照会
• トークン／資産レイヤー — TrustLines、発行通貨、NFT、MPT
• DEX／AMM レイヤー — オファー、オーダーブック、AMM プール、パス探索
• 相互運用レイヤー — Axelar ブリッジ、EVM サイドチェーン
• セキュリティレビュー — 横断的な懸念事項

2. 適切な構成要素を選ぶ

• 新しいプロジェクト：npx create-xrp でスキャフォールディング（Next.js または Nuxt）
• フロントエンド：xrpl-connect（WalletManager ＋ Web コンポーネント）＋状態照会用の xrpl
• JS/TS バックエンド／スクリプト：xrpl パッケージ
• Python プロジェクト：xrpl-py
• クロスチェーン：XRPL Payment のメモを介した Axelar GMP

3. XRPL 固有の正確性を保って実装する

次の点を必ず明示します。

• ネットワーク（mainnet／testnet／devnet）と WebSocket エンドポイント
• アカウントリザーブ（基本リザーブ＋オーナーリザーブ）とその影響
• トランザクション手数料（自動入力または明示指定、手数料の引き上げ）
• シーケンス番号（自動入力または明示指定、複数トランザクションのワークフロー用）
• LastLedgerSequence（信頼性の高い送信のため、必ず設定）
• トランザクションの種類ごとのフラグとフィールド要件
• トラストラインの上限と発行者との関係
• NFT の譲渡手数料とブローカーの仕組み

4. テストの追加

• トランザクションの構築とシリアライズを単体テストします。
• テストネットで統合テストを実施します（資金の調達にはファウセットを使用します）。
• フロントエンド：モックプロバイダーを使って、ウォレット接続と署名のフローをテストします。

5. 成果物に関する期待事項

変更を実装したら、以下を提示してください。

• 変更したファイルと差分の正確な一覧
• インストール／ビルド／テスト用のコマンド
• 署名、手数料、リザーブ、または資産の送金に関わる内容についての簡潔な「リスクに関する注記」セクション

コンテンツソース

このスキルには、以下のベストプラクティスが反映されています。

• XRPL の公式ドキュメント — プロトコル仕様、トランザクション種別、API の詳細に関する権威あるリファレンスです。
• 基礎コースの教材：xrpl-training-2026-january。

必要に応じて参照する詳細情報

• クライアント SDK のパターン（xrpl.js）：client-sdk.md
• フロントエンドとウォレットの統合：frontend.md
• トークンと TrustLines：tokens.md
• NFT（XLS-20）：nfts.md
• DEX と AMM：dex-amm.md
• 決済、エスクロー、チャネル：payments.md
• クロスチェーンの相互運用性：interoperability.md
• セキュリティチェックリスト：security.md
• リソースと参考資料：resources.md
• XRP Ledger 向けのフレームワークに依存しないウォレット接続ツールキット：xrpl-connect