用途:在 TON 上创建并部署链上智能体钱包(agentic wallet),适用于用户想创建钱包、搭建智能体钱包、部署智能体钱包或引导新钱包入网的场景。
主要能力:智能体生成操作员密钥并创建待处理设置,返回 setupId、dashboardUrl 与 callbackUrl;提供 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(取消待处理设置)。可选参数包括 network、name、source、collectionAddress、tonDeposit、walletAddress、ownerAddress。
使用方式:先调用 agentic_start_root_wallet_setup;若环境支持本地浏览器或 shell 工具,用平台打开器(open、xdg-open、start)或浏览器自动化打开 dashboardUrl,仅在无法自动打开时把链接给用户;提示用户只需从其主 TON 钱包批准部署。在长驻 stdio/HTTP MCP 服务器会话中,轮询 agentic_get_root_wallet_setup 或 agentic_list_pending_root_wallet_setups,等待 status: "callback_received",再以 setupId 调用 agentic_complete_root_wallet_setup;在一次性 CLI 用法中跳过回调轮询,用户部署后索取 walletAddress 再完成。最后用 get_current_wallet 或 list_wallets 确认钱包已激活。
机制与限制:智能体保留操作员私钥可自主签名交易,用户保留所有者密钥可随时提现或撤销访问;钱包是链上智能合约(基于 NFT),非托管服务;仪表板位于 agents.ton.org。环境变量有 NETWORK(mainnet 默认或 testnet)、AGENTIC_CALLBACK_BASE_URL、AGENTIC_CALLBACK_PORT。回调驱动完成仅适用于长驻 stdio/HTTP MCP 服务器会话,原始 CLI 应使用手动 walletAddress 完成。创建后需先用 GRAM(如 TON)为钱包充值,再使用转账或兑换技能。