ton-manage-wallets

Original：🇺🇸 English

Translated

Use this skill when managing multiple TON wallets, importing agentic wallets, or rotating operator keys. It switches between wallets, lists all wallets in the registry, imports existing wallets, and rotates operator keys. Also use when the user mentions wallet management, switching accounts, or key rotation on TON.

9installs

Sourceton-org/skills

Added on2026-05-11

NPX Install

npx skill4agent add ton-org/skills ton-manage-wallets

SKILL.md Content

View Translation Comparison →

TON Wallet Management

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

MCP Tools

Wallet Registry

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

Agentic Wallet Management

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`	—

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
```

Import Existing Agentic Wallet

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

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

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