关于 ton-manage-wallets
ton-manage-wallets 用于管理本地 TON 钱包注册表和 Agentic 钱包操作,支持选择钱包、导入、验证及轮换操作员密钥。
主要功能
- 01列出并选择已登记钱包
- 02设置或移除当前钱包
- 03验证并导入 Agentic 钱包
- 04按所有者查找钱包
- 05轮换操作员密钥
适用场景
- 01切换操作所用的钱包
- 02将现有 Agentic 钱包加入注册表
- 03查看与某所有者关联的钱包
- 04轮换 Agentic 钱包的操作员密钥
MCP 相关
它提供用于本地钱包注册表和 Agentic 钱包管理的 MCP 工具,包括验证、导入和轮换操作员密钥。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ton-org/ skills --skill ton-manage-wallets安装后在 Claude Code 中输入/ton-manage-wallets确认已加载。
详细介绍
TON 钱包管理
管理本地钱包注册表,并执行高级 Agent 钱包操作,包括导入和密钥轮换。
MCP 工具
钱包注册表
| 工具 | 必填 | 可选 |
|---|---|---|
list_wallets | — | — |
get_current_wallet | — | — |
set_active_wallet | walletSelector | — |
remove_wallet | walletSelector | — |
Agent 钱包管理
| 工具 | 必填 | 可选 |
|---|---|---|
agentic_validate_wallet | address | network、ownerAddress、collectionAddress |
agentic_list_wallets_by_owner | ownerAddress | network |
agentic_import_wallet | address | name |
agentic_rotate_operator_key | walletSelector | — |
agentic_complete_rotate_operator_key | rotationId | — |
工作流
切换活动钱包
- 调用
list_wallets查看所有已存储的钱包 - 使用
walletSelector(id、名称或地址)调用set_active_wallet - 调用
get_current_wallet确认
导入现有 Agent 钱包
- 调用
agentic_validate_wallet验证钱包地址和合约 - 调用
agentic_import_wallet将其添加到注册表 - 如果 Agent 需要签署交易,但没有可用的操作员密钥,则调用
agentic_rotate_operator_key;用户通过仪表板在链上应用密钥更改后,再调用agentic_complete_rotate_operator_key
轮换操作员密钥
- 调用
agentic_rotate_operator_key——生成新的密钥对,并返回供用户在链上应用更改的仪表板 URL - 如果有本地浏览器或 shell 工具可用,请自行打开仪表板 URL;只有在无法自动打开或打开失败时,才发送原始链接
- 只要求用户在其钱包中批准链上密钥更改;不要要求用户重新粘贴 URL 或输入固定的确认短语
- 使用
rotationId调用agentic_complete_rotate_operator_key;如果链上状态尚未更新,请稍等片刻后重试,不要要求用户额外输入
说明
walletSelector接受钱包 id、名称或地址- 对于一次性查询,请将
walletSelector直接传给钱包范围的工具,而不要更改活动钱包 - 尽可能使用可用的 shell/浏览器工具为用户打开仪表板 URL
- 对于确认和少量选项,优先使用宿主客户端提供的结构化确认/选择界面;否则使用简短的自然语言是/否提示,绝不要要求用户输入精确的指定词语
- 注册表数据存储在
~/.config/ton/config.json(或TON_CONFIG_PATH)中 - 读取工具可用于已导入但尚无
operator_private_key的 Agent 钱包;写入工具则需要该密钥 - 管理工具的响应绝不会泄露私钥、助记词或 API 密钥
- 如需创建全新的 Agent 钱包,请改用
ton-create-wallet技能
评论
支持 Markdown