xrpl-dev

XRPL 开发 Skill

此 Skill 的用途

用户提出以下需求时，请使用此 Skill：

• XRPL dApp 开发（任意语言／框架）
• 搭建新的 XRPL 项目
• 前端钱包连接（Crossmark、Xaman、GemWallet）
• 账户创建、注资和管理
• 交易构建、签名和提交
• 代币操作（TrustLines、已发行货币、MPT）
• NFT 操作（XLS-20 NFTokens）
• DEX 交互（挂单、订单簿、路径查找）
• AMM（自动做市商）操作
• 跨链互操作（Axelar bridge、XRPL EVM 侧链）
• 支付通道、托管和支票
• XRPL 交易和集成的安全审查

默认技术栈决策（有主见的选择）

1. 项目搭建：create-xrp

   • 对于新项目，请从 npx create-xrp my-app 开始。
   • 使用 Turborepo 单体仓库搭建项目，并采用 Next.js（React）或 Nuxt（Vue）。
   • 预先配置：xrpl-connect 钱包连接、网络切换、Tailwind CSS、交易 UI。
   • 智能合约支持仍处于实验阶段，默认跳过。

2. 客户端 SDK：优先使用 xrpl.js（JavaScript/TypeScript）

   • 所有新的 JS/TS 客户端代码均使用 xrpl。
   • Python 项目使用 xrpl-py。
   • Java/Kotlin 使用 xrpl4j。

3. 前端：优先使用 xrpl-connect

   • 所有钱包连接和签名体验均使用 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）。
   • 实验性／修正案功能使用 devnet。
   • 开发代码中绝不硬编码 mainnet 端点。

5. 交易签名：本地签名或委托钱包签名

   • 对于后端／脚本：在本地签名，绝不通过网络发送机密信息。
   • 对于前端：将签名委托给已连接的钱包。
   • 对于生产环境后端：优先使用托管签名服务或硬件钱包。

6. 账户管理：考虑储备金

   • 操作前始终检查并告知储备金要求。
   • 基础储备金（当前为 10 XRP）+ 所有者储备金（每个持有对象 2 XRP）。
   • 操作会锁定储备金时，请提醒用户。

7. 错误处理：明确处理

   • 始终检查 validated 状态，而不只是提交时的 tesSUCCESS。
   • 对 tec* 代码（已认领但失败）和 tef*／tem* 代码采用不同处理方式。
   • 为 terQUEUED 和 tefPAST_SEQ 实现重试逻辑。

操作流程（如何执行任务）

1. 确定任务所属层

• 项目搭建 — 新项目设置
• 前端／钱包层 — 钱包连接、签名体验、状态展示
• 客户端／脚本层 — 构建或发送交易、查询账本状态
• 代币／资产层 — TrustLines、已发行货币、NFT、MPT
• DEX／AMM 层 — 挂单、订单簿、AMM 池、路径查找
• 互操作层 — Axelar bridge、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
• 代币与 TrustLine：tokens.md
• NFT（XLS-20）：nfts.md
• DEX 与 AMM：dex-amm.md
• 支付、托管与通道：payments.md
• 跨链互操作性：interoperability.md
• 安全检查清单：security.md
• 资源与参考资料：resources.md
• 适用于 XRP Ledger、与框架无关的钱包连接工具包 xrpl-connect