Back to Details

ton-manage-wallets

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

TON Wallet Management

TON钱包管理

Manage the local wallet registry and perform advanced agentic wallet operations including import and key rotation.

管理本地钱包注册表，并执行包括导入和密钥轮换在内的高级Agentic钱包操作。

MCP Tools

MCP工具

Wallet Registry

钱包注册表

Tool	Required	Optional
`list_wallets`	—	—
`get_current_wallet`	—	—
`set_active_wallet`	`walletSelector`	—
`remove_wallet`	`walletSelector`	—

工具	必填项	可选项
`list_wallets`	—	—
`get_current_wallet`	—	—
`set_active_wallet`	`walletSelector`	—
`remove_wallet`	`walletSelector`	—

Agentic Wallet Management

Agentic钱包管理

Tool	Required	Optional
`agentic_validate_wallet`	`address`	`network` , `ownerAddress` , `collectionAddress`
`agentic_list_wallets_by_owner`	`ownerAddress`	`network`
`agentic_import_wallet`	`address`	`name`
`agentic_rotate_operator_key`	`walletSelector`	—
`agentic_complete_rotate_operator_key`	`rotationId`	—

工具	必填项	可选项
`agentic_validate_wallet`	`address`	`network` , `ownerAddress` , `collectionAddress`
`agentic_list_wallets_by_owner`	`ownerAddress`	`network`
`agentic_import_wallet`	`address`	`name`
`agentic_rotate_operator_key`	`walletSelector`	—
`agentic_complete_rotate_operator_key`	`rotationId`	—

Workflows

工作流

Switch Active Wallet

切换活跃钱包

Call
```
list_wallets
```
to see all stored wallets
Call
```
set_active_wallet
```
with a
```
walletSelector
```
(id, name, or address)
Confirm with
```
get_current_wallet
```

调用
```
list_wallets
```
查看所有已存储的钱包
使用
```
walletSelector
```
（钱包ID、名称或地址）调用
```
set_active_wallet
```
调用
```
get_current_wallet
```
确认切换结果

Import Existing Agentic Wallet

导入现有Agentic钱包

Call
```
agentic_validate_wallet
```
to verify the wallet address and contract
Call
```
agentic_import_wallet
```
to add it to the registry
If the agent needs to sign transactions and no operator key is available, call
```
agentic_rotate_operator_key
```
and then
```
agentic_complete_rotate_operator_key
```
after the user applies the key change on-chain via the dashboard

调用
```
agentic_validate_wallet
```
验证钱包地址和合约
调用
```
agentic_import_wallet
```
将其添加到注册表
如果Agent需要签署交易但没有可用的操作密钥，调用
```
agentic_rotate_operator_key
```
，然后在用户通过仪表盘完成链上密钥变更后，调用
```
agentic_complete_rotate_operator_key
```

Rotate Operator Key

轮换操作密钥

Call
```
agentic_rotate_operator_key
```
— generates a new key pair and returns a dashboard URL for the user to apply the change on-chain
If local browser or shell tools are available, open the dashboard URL yourself; only send the raw link when automatic opening is unavailable or fails
Ask the user only to approve the on-chain key change in their wallet; do not require them to re-paste the URL or type a fixed confirmation phrase
Call
```
agentic_complete_rotate_operator_key
```
with the
```
rotationId
```
; if the chain state has not updated yet, wait briefly and retry instead of forcing extra user input

调用
```
agentic_rotate_operator_key
```
——生成新的密钥对并返回仪表盘URL，供用户完成链上变更
如果有可用的本地浏览器或Shell工具，自动打开仪表盘URL；仅在自动打开不可用或失败时发送原始链接
仅要求用户在钱包中批准链上密钥变更；无需让用户重新粘贴URL或输入固定确认短语
使用
```
rotationId
```
调用
```
agentic_complete_rotate_operator_key
```
；如果链上状态尚未更新，稍作等待后重试，而非强制用户进行额外输入

Notes

注意事项

```
walletSelector
```
accepts wallet id, name, or address
For one-off queries, pass
```
walletSelector
```
directly to wallet-scoped tools instead of changing the active wallet
Use available shell/browser tools to open dashboard URLs for the user whenever possible
For confirmations and small option sets, prefer the host client's structured confirmation/choice UI when available; otherwise use a short natural-language yes/no prompt and never require an exact magic word

Registry data is stored in

~/.config/ton/config.json

(or

TON_CONFIG_PATH

)

Read tools work with imported agentic wallets that don't yet have an
```
operator_private_key
```
; write tools require it
Management tool responses never expose private keys, mnemonics, or API keys
To create a brand new agentic wallet, use the
```
ton-create-wallet
```
skill instead

```
walletSelector
```
支持钱包ID、名称或地址
对于一次性查询，直接将
```
walletSelector
```
传递给钱包范围的工具，无需切换活跃钱包
尽可能使用可用的Shell/浏览器工具为用户打开仪表盘URL
对于确认操作和小型选项集，优先使用宿主客户端的结构化确认/选择UI（如果可用）；否则使用简短的自然语言是非提示，绝不要要求输入精确的“魔法词汇”
注册表数据存储在
```
~/.config/ton/config.json
```
（或
```
TON_CONFIG_PATH
```
指定路径）
读取类工具可用于尚未设置
```
operator_private_key
```
的已导入Agentic钱包；写入类工具需要该密钥
管理工具的响应绝不会暴露私钥、助记词或API密钥
若要创建全新的Agentic钱包，请使用
```
ton-create-wallet
```
技能