SuperAPI AI 工具集

xrpl-agent-wallet

智能体与模型

查看项目

更新于 10-16 03:22

技能介绍

XRPL Agent Wallet 是 XRP Ledger(XRPL)的钱包层技能,用于让智能体代表用户加载、签名或提交交易。它解决的核心问题是:XRPL 目前还没有专为自主智能体设计的钱包产品,因此该技能通过一套严格的操作纪律,在开发者私钥与潜在风险之间建立保护。

用途方面,该技能承担两类任务。第一,首次设置:当用户请求创建或生成 XRPL 钱包时,技能会生成钱包、将 .env 加入 .gitignore、把种子直接写入 .env,并只向用户展示地址,不展示种子。第二,交易签名与提交:当用户已有钱包并需要交易时,技能按照真实钱包的方式完成签名和提交,确保私钥不离开安全位置,人类能看到自己授权的交易内容,并遵循可靠的提交规范。

主要能力包括:生成 XRPL 钱包并安全保存种子;加载钱包(支持环境变量模式和外部签名器模式);自动填充交易字段;生成结构化交易预览供人类确认;本地签名交易;使用 submitAndWait 提交并等待验证结果;持久化交易哈希以便崩溃后对账;默认连接测试网;对交易备注进行不可信输入处理;支持在严格条件下启用自动签名覆盖。

使用方式上,技能定义了明确的签名仪式,共六步:接收交易对象、加载钱包、自动填充、向人类预览、签名、提交并等待。每一步都有具体规则,例如交易对象由其他技能或开发者提供,技能不构造也不修改其语义字段;自动填充使用 client.autofill(tx) 填充 Fee、Sequence 和 LastLedgerSequence;预览必须展示完整地址、将 drops 转换为 XRP、解码已知标志和备注、对异常费用进行提示、对承载资产的字段单独展示;签名前必须获得人类明确确认,除非存在有效的自动签名覆盖;提交后根据 TransactionResult 解释结果,tesSUCCESS 表示完成,tec* 表示已进入验证账本但未达成目的,tef*/tel*/tem* 表示未进入账本,ter* 表示可重试。

适用场景包括:开发者在开发环境中通过环境变量加载钱包并签名交易;生产环境中通过 HSM/KMS 等外部签名器完成签名;智能体在测试网上进行交易测试;批量任务或夜间运行场景下,在严格限定范围内启用自动签名。

限制方面,该技能有若干不可协商的规则:永不读取、回显或持久化私钥或种子;默认每次签名都需要人类确认;预览前必须自动填充;始终使用 submitAndWait 而非单独 submit;提交前持久化交易哈希;默认连接测试网;将收到的交易备注视为不可信输入;仅在本地签名,绝不将未签名交易和种子发送到远程 rippled 的签名 API。自动签名覆盖是唯一有明确覆盖机制的规则,但激活条件严格:必须来自人类直接指令、必须明确说明范围、必须经人类确认后才生效,且范围必须包含交易类型过滤、网络过滤和过期条件。