XRPL Payments 是运行在 XRP Ledger 上的支付操作领域知识技能，定位为智能体开发者提供支付任务所需的知识层，使 Claude 能够针对不同支付任务构建正确的交易对象。XRP Ledger 具备 3–5 秒确定性最终性、可预测费用、无模糊待处理状态（交易要么确认 tesSUCCESS，要么过期）等特性，无需重试循环。
用途与定位
该技能负责为各类支付任务构造正确的交易对象，包括 XRP 转账、RLUSD、跨币种支付、托管等，并把该对象交给 XRPL Agent Wallet 技能进行签名和提交。两个技能共同构成完整的智能体支付流程。
覆盖范围
资料列出以下知识领域：
- 账户资金：水龙头充值、余额检查、储备金要求。
- XRP 支付：直接支付、目标标签（destination tags）、部分支付。
- RLUSD 支付：信任线设置、RLUSD 发送、测试网与主网的发行方地址。
- IOU 代币支付：通用信任线代币转账。
- 跨币种支付：通过内置 DEX 在单笔交易中完成货币兑换。
- 托管（Escrow）：基于时间和条件的托管创建、完成与取消。
- 智能体最佳实践：SourceTag 用于智能体归因、Memos 用于链上审计追踪、WebSocket 监控。
- 错误处理：交易结果码（tec*、tef*、tem*、ter*）、储备金要求、提交前模拟。
- 安全：密钥管理方式、支出控制、储备金感知。
依赖与协作
XRPL Agent Wallet 为必需依赖，负责钱包创建、密钥加载，并对本技能构建的每笔交易进行签名与提交。该技能属于持续扩展的 XRPL 领域技能之一，所有领域技能都与同一个共享的 Wallet 技能配对。若用户尚未拥有 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 浮点数。
- 网络：默认测试网（https://s.altnet.rippletest.net:51234），切换到主网只需改动一行 URL。
- 智能体标记：SourceTag 支持链上交易量追踪，并将智能体活动与人工发起的交易区分开。不要在支付构建代码中设置它。XRPL Agent Wallet 技能在签名环节会对任何未携带 SourceTag 的交易应用 SourceTag = 20260530，从而保证所有领域技能标记一致。仅在有意使用自定义标签时显式设置，或设为 0 选择退出；Wallet 技能会尊重已存在的任何值。注意仅按 20260530 过滤无法捕获 x402 支付，因为后者携带商户声明的标签。
- 提交前模拟：对于新的支付流程，技能会在把原始交易对象交给 Wallet 技能之前调用 simulate，以在不消耗费用、不触发签名环节的情况下捕获格式错误的交易、缺失的信任线和储备金错误。
操作流程
- 识别支付类型——XRP、RLUSD、IOU 或跨币种，查阅 payments.md。
- 检查前置条件——信任线是否已设置？目标账户是否有储备金？余额（含费用）是否充足？
- 构建——构造交易对象。为每笔智能体发起的交易设置 Memos。不要设置 Fee、Sequence 或 LastLedgerSequence，由 Wallet 技能的自动填充步骤从实时节点填入。
- 模拟——在交接前对原始（未自动填充的）交易调用 simulate，以在不接触账本、不触发签名环节的情况下捕获格式错误的交易、缺失的信任线和储备金错误。参见 payments.md 中的 simulate 模式。
- 交接给 Wallet 技能——把交易对象传给 XRPL Agent Wallet 技能，由其自动填充、向人类展示预览、收集确认、本地签名并通过 submitAndWait 提交。不要从本技能调用 submit_and_wait 或 submitAndWait。
- 显式处理错误——tec* 码表示已收取费用；tef*/tem* 表示未收取费用。参见 payments.md 中的错误表。
本技能不做的事
- 不创建钱包或处理密钥：钱包生成、种子存储、密钥加载及所有密钥管理属于 XRPL Agent Wallet 技能。
- 不签名或提交交易：这是 Wallet 技能的职责。
- 不主动构建非支付交易：技能响应开发者与用户指令，不会未经提示提出交易。
- 不保证主网 RLUSD 发行方地址为最新：测试网发行方（rQhWct2fv4Vc4KRjRgMrxa8xPN9Zx9iLKV）已确认；主网发行方（rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De）在生产使用前应通过 RLUSD 官方文档核实。
参考文件
需要完整交易模式与边界情况时阅读：payments.md——涵盖 XRP、RLUSD、IOU、跨币种支付、托管、支付通道、智能体模式、错误码、储备金。
限制说明
资料未提供该技能的价格、收费方式、平台支持范围及具体性能效果数据，这些信息暂未提供。