ton-create-wallet

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Create TON Agentic Wallet

创建TON Agentic钱包

Deploy an on-chain agentic wallet on TON. The agent generates operator keys, opens the dashboard when local browser/shell tools are available, and uses callback-based completion only in long-lived stdio/HTTP MCP server sessions.

部署TON链上Agentic钱包。Agent会生成操作员密钥，若本地浏览器/Shell工具可用则打开仪表板，仅在长期运行的stdio/HTTP MCP服务器会话中使用基于回调的完成方式。

MCP Tools

MCP工具

Tool	Description
`agentic_start_root_wallet_setup`	Generate operator keys, create pending setup, return dashboard URL
`agentic_list_pending_root_wallet_setups`	List pending setup drafts and their callback status
`agentic_get_root_wallet_setup`	Read one pending setup by `setupId`
`agentic_complete_root_wallet_setup`	Finish onboarding from callback or manual wallet address
`agentic_cancel_root_wallet_setup`	Cancel a pending setup

工具	描述
`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`	取消待处理的设置流程

Tool Parameters

工具参数

Tool	Required	Optional
`agentic_start_root_wallet_setup`	—	`network` , `name` , `source` , `collectionAddress` , `tonDeposit`
`agentic_get_root_wallet_setup`	`setupId`	—
`agentic_complete_root_wallet_setup`	`setupId`	`walletAddress` , `ownerAddress`
`agentic_cancel_root_wallet_setup`	`setupId`	—

工具	必填项	可选项
`agentic_start_root_wallet_setup`	—	`network` , `name` , `source` , `collectionAddress` , `tonDeposit`
`agentic_get_root_wallet_setup`	`setupId`	—
`agentic_complete_root_wallet_setup`	`setupId`	`walletAddress` , `ownerAddress`
`agentic_cancel_root_wallet_setup`	`setupId`	—

Workflow

工作流程

Call
```
agentic_start_root_wallet_setup
```
— this generates an operator key pair and returns a
```
setupId
```
,
```
dashboardUrl
```
, and
```
callbackUrl
```
If the environment exposes local browser or shell tools, open
```
dashboardUrl
```
yourself with the platform opener (
```
open
```
,
```
xdg-open
```
,
```
start
```
) or browser automation; only paste the link to the user if automatic opening is unavailable or fails
Tell the user only to approve wallet deployment from their main TON wallet; do not ask them to retype the URL or copy intermediate data

In long-lived stdio/HTTP MCP server sessions, poll

agentic_get_root_wallet_setup

agentic_list_pending_root_wallet_setups

and wait for

status: "callback_received"

when callback flow is available; then call

agentic_complete_root_wallet_setup

with

setupId

;

In raw one-shot CLI usage, skip callback polling and ask for
```
walletAddress
```
after the user deploys the wallet; then call
```
agentic_complete_root_wallet_setup
```
with
```
walletAddress
```

Confirm the wallet is active with

get_current_wallet

list_wallets

(see

ton-manage-wallets

skill)

调用

agentic_start_root_wallet_setup

——这会生成操作员密钥对，并返回

setupId

、

dashboardUrl

和

callbackUrl

若当前环境支持本地浏览器或Shell工具，使用平台启动器（
```
open
```
,
```
xdg-open
```
,
```
start
```
）或浏览器自动化工具自动打开
```
dashboardUrl
```
；若自动打开不可用或失败，再将链接提供给用户
仅告知用户从其主TON钱包中批准钱包部署，不要要求用户重新输入URL或复制中间数据

在长期运行的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
```
，然后使用
```
walletAddress
```
调用
```
agentic_complete_root_wallet_setup
```

使用

get_current_wallet

或

list_wallets

确认钱包已激活（详见

ton-manage-wallets

技能）

How It Works

工作原理

The agent keeps the operator private key — it can sign transactions autonomously
The user keeps the owner key — they can withdraw funds or revoke access at any time
The wallet is an on-chain smart contract (NFT-based), not a custodial service
The dashboard is at
```
agents.ton.org
```

Agent保存操作员私钥——可自主签署交易
用户保存所有者密钥——可随时提取资金或撤销访问权限
钱包是基于NFT的链上智能合约，而非托管服务
仪表板地址为
```
agents.ton.org
```

Environment Variables

环境变量

Variable	Description
`NETWORK`	`mainnet` (default) or `testnet`
`AGENTIC_CALLBACK_BASE_URL`	Public URL for the onboarding callback (auto in HTTP mode)
`AGENTIC_CALLBACK_PORT`	Port for the callback server

变量	描述
`NETWORK`	`mainnet` （默认）或 `testnet`
`AGENTIC_CALLBACK_BASE_URL`	入门流程回调的公共URL（HTTP模式下自动配置）
`AGENTIC_CALLBACK_PORT`	回调服务器的端口

Notes

注意事项

Callback-driven completion is for long-lived stdio/HTTP MCP server sessions; raw CLI should use manual
```
walletAddress
```
completion
If automatic dashboard opening is supported in the current environment, do it instead of asking the user to open the URL manually
In raw CLI mode, ask for the wallet address after deployment because the callback server is not available long enough to complete the flow
After wallet creation, fund the wallet with TON before using transfer or swap skills

基于回调的完成方式适用于长期运行的stdio/HTTP MCP服务器会话；原生CLI应使用手动输入
```
walletAddress
```
的完成方式
若当前环境支持自动打开仪表板，则自动执行该操作，而非让用户手动打开URL
在原生CLI模式下，部署完成后需向用户索要钱包地址，因为回调服务器无法长时间运行以完成整个流程
创建钱包后，需先向钱包充值TON，再使用转账或兑换技能