mcpField
T
ton-manage-wallets

ton-manage-wallets

github.com/ton-org其他10113 次安装25 周前更新
代码仓库

关于 ton-manage-wallets

ton-manage-wallets 用于管理本地 TON 钱包注册表和 Agentic 钱包操作,支持选择钱包、导入、验证及轮换操作员密钥。

主要功能

  1. 01列出并选择已登记钱包
  2. 02设置或移除当前钱包
  3. 03验证并导入 Agentic 钱包
  4. 04按所有者查找钱包
  5. 05轮换操作员密钥

适用场景

  1. 01切换操作所用的钱包
  2. 02将现有 Agentic 钱包加入注册表
  3. 03查看与某所有者关联的钱包
  4. 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_walletwalletSelector—
remove_walletwalletSelector—
Agent 钱包管理
工具必填可选
agentic_validate_walletaddressnetwork、ownerAddress、collectionAddress
agentic_list_wallets_by_ownerownerAddressnetwork
agentic_import_walletaddressname
agentic_rotate_operator_keywalletSelector—
agentic_complete_rotate_operator_keyrotationId—

工作流

切换活动钱包
  1. 调用 list_wallets 查看所有已存储的钱包
  2. 使用 walletSelector(id、名称或地址)调用 set_active_wallet
  3. 调用 get_current_wallet 确认
导入现有 Agent 钱包
  1. 调用 agentic_validate_wallet 验证钱包地址和合约
  2. 调用 agentic_import_wallet 将其添加到注册表
  3. 如果 Agent 需要签署交易,但没有可用的操作员密钥,则调用 agentic_rotate_operator_key;用户通过仪表板在链上应用密钥更改后,再调用 agentic_complete_rotate_operator_key
轮换操作员密钥
  1. 调用 agentic_rotate_operator_key——生成新的密钥对,并返回供用户在链上应用更改的仪表板 URL
  2. 如果有本地浏览器或 shell 工具可用,请自行打开仪表板 URL;只有在无法自动打开或打开失败时,才发送原始链接
  3. 只要求用户在其钱包中批准链上密钥更改;不要要求用户重新粘贴 URL 或输入固定的确认短语
  4. 使用 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