mcpField
T
ton-create-wallet

ton-create-wallet

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

关于 ton-create-wallet

ton-create-wallet 用于在 TON 上部署链上 Agentic 钱包，通过生成操作员密钥、仪表板审批以及回调或地址完成设置流程。

主要功能

  1. 01生成操作员密钥和设置草稿
  2. 02提供部署用仪表板链接
  3. 03跟踪待处理的钱包设置
  4. 04完成或取消设置
  5. 05支持回调或地址完成流程

适用场景

  1. 01在 TON 上部署新的 Agentic 钱包
  2. 02跟踪待处理的钱包部署
  3. 03仪表板审批后完成设置
  4. 04在一次性 CLI 使用中通过钱包地址完成设置

MCP 相关

它通过 MCP 工具启动、查看、完成或取消 Agentic 钱包设置。长期运行的 stdio 或 HTTP MCP 会话可使用回调完成流程。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ton-org/skills --skill ton-create-wallet

安装后在 Claude Code 中输入/ton-create-wallet确认已加载。

详细介绍

创建 TON Agentic Wallet

在 TON 上部署链上 Agentic Wallet。Agent 会生成操作员密钥；当本地浏览器/命令行工具可用时，会打开控制面板；仅在长期运行的 stdio/HTTP MCP 服务会话中使用基于回调的完成流程。

MCP 工具

工具描述
agentic_start_root_wallet_setup生成操作员密钥，创建待处理的设置，并返回控制面板 URL
agentic_list_pending_root_wallet_setups列出待处理的设置草稿及其回调状态
agentic_get_root_wallet_setup根据 setupId 读取一项待处理的设置
agentic_complete_root_wallet_setup通过回调或手动提供钱包地址完成引导流程
agentic_cancel_root_wallet_setup取消一项待处理的设置
工具参数
工具必填可选
agentic_start_root_wallet_setup—network、name、source、collectionAddress、tonDeposit
agentic_get_root_wallet_setupsetupId—
agentic_complete_root_wallet_setupsetupIdwalletAddress、ownerAddress
agentic_cancel_root_wallet_setupsetupId—

工作流

  1. 调用 agentic_start_root_wallet_setup——这会生成一对操作员密钥，并返回 setupId、dashboardUrl 和 callbackUrl
  2. 如果环境提供本地浏览器或命令行工具，请使用平台打开器（open、xdg-open、start）或浏览器自动化自行打开 dashboardUrl；仅当无法自动打开或打开失败时，才将链接发给用户
  3. 只需告知用户从其主要 TON 钱包批准钱包部署；不要让他们重新输入 URL 或复制中间数据
  4. 在长期运行的 stdio/HTTP MCP 服务会话中，轮询 agentic_get_root_wallet_setup 或 agentic_list_pending_root_wallet_setups；当回调流程可用时，等待 status: "callback_received"，然后调用 agentic_complete_root_wallet_setup 并传入 setupId；
  5. 在原始的一次性 CLI 用法中，跳过回调轮询；用户部署钱包后，向其索取 walletAddress，然后调用 agentic_complete_root_wallet_setup 并传入 walletAddress
  6. 使用 get_current_wallet 或 list_wallets 确认钱包已激活（参见 ton-manage-wallets 技能）

工作原理

  • Agent 持有操作员私钥——它可以自主签署交易
  • 用户持有所有者密钥——他们可以随时提取资金或撤销访问权限
  • 该钱包是链上智能合约（基于 NFT），不是托管服务
  • 控制面板位于 agents.ton.org

环境变量

变量描述
NETWORKmainnet（默认）或 testnet
AGENTIC_CALLBACK_BASE_URL用于引导回调的公开 URL（HTTP 模式下自动设置）
AGENTIC_CALLBACK_PORT回调服务的端口

注意事项

  • 基于回调的完成流程适用于长期运行的 stdio/HTTP MCP 服务会话；原始 CLI 应使用手动提供 walletAddress 的方式完成
  • 如果当前环境支持自动打开控制面板，请直接自动打开，而不是让用户手动打开 URL
  • 在原始 CLI 模式下，由于回调服务无法持续运行足够长的时间来完成流程，请在部署后向用户索取钱包地址
  • 创建钱包后，请先为钱包充值 TON，再使用转账或兑换技能

评论

支持 Markdown