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钱包。代理会生成操作员密钥，若本地浏览器/ 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
```

代理保存操作员私钥——它可以自主签署交易
用户保存所有者密钥——他们可以随时提取资金或撤销访问权限
钱包是基于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