Skip to main content

​
MyTonCtrl wallet commands

Wallet mode provides convenience utilities for generating, activating, importing, exporting, and moving funds between TON wallets managed by MyTonCtrl. The commands below explain required arguments, accepted shortcuts (such as all/alld amounts), and safety prompts.

​
Operational notes

  • MyTonCtrl stores wallets under /var/ton-work/wallets. Back up .pk files securely before deleting or migrating wallets.
  • Generated wallet names follow the wallet_### pattern. Use wl to find the correct name before funding or exporting.
  • Bookmark support depends on entries configured via other modules (for example, utility commands that register shortcuts).
  • Transfers rely on the validator console and may require the wallet to be active with sufficient rent balance (>0.1 TON).

​
Wallet lifecycle

​
nw

Purpose: Create a new local wallet definition and show its deployment address. Syntax 
nw [<workchain-id> <wallet-name> [<version> <subwallet>]]
Behavior
  • With no arguments, autogenerates a name (wallet_XXX), uses workchain 0, selects version v1, and derives subwallet 698983191 + workchain.
  • When arguments are provided, you must supply the workchain and name; optional version (v1, v2, v3) and subwallet override defaults.
  • Writes .addr/.pk files under the wallets directory and prints a table with the new wallet address (state-init form).
Examples 
nw
nw 0 treasury v3 1001

​
aw

Purpose: Deploy one wallet or all wallets that have unsigned deployment BoCs. Syntax 
aw [<wallet-name>|all]
Behavior
  • Without arguments, treats the request as all and scans every wallet for pending deployment BoCs, sending them if the target address still has a positive balance.
  • With a wallet name, activates that specific wallet using the stored deployment message.
Examples 
aw
aw wallet_005

​
wl

Purpose: List every wallet known to MyTonCtrl along with its on-chain status. Syntax 
wl
Behavior
  • Prints Name, Status, Balance, Version, Workchain, and Address (current or init address if inactive).
  • Useful for auditing balances before elections or sweeping idle funds.

​
dw

Purpose: Delete a wallet’s local files after operator confirmation. Syntax 
dw <wallet-name>
Behavior
  • Prompts Are you sure you want to delete this wallet (yes/no): and only proceeds on yes.
  • Removes the .addr, .pk, and cached query files for <wallet-name> but does not touch on-chain accounts.
Example 
dw treasury

​
Importing, exporting, and metadata

​
iw

Purpose: Import an existing wallet by address and secret key. Syntax 
iw <wallet-addr> <wallet-secret-key-base64>
Behavior
  • Writes the provided address bytes and base64-encoded private key into a new local wallet (name auto-generated).
  • Prints the assigned wallet name for subsequent commands.
Example 
iw EQDk...cQ KJ4Q...

​
ew

Purpose: Export a wallet’s address and secret key. Syntax 
ew <wallet-name>
Behavior
  • Reads the .pk file, base64-encodes it, and prints the address/key pair along with the wallet name.
  • Useful for backups or migration to hardware wallets.
Example 
ew treasury

​
swv

Purpose: Update the recorded wallet version (v1/v2/v3) for an imported wallet. Syntax 
swv <wallet-addr> <wallet-version>
Behavior
  • Updates metadata so MyTonCtrl selects the correct Fift script when sending transactions.
  • Supply the wallet address exactly as stored (base64 or workchain:hex) and the version string.
Example 
swv EQC0...FQ v3

​
Fund transfers

​
mg

Purpose: Send Toncoin from a local wallet to a destination address or bookmark. Syntax 
mg <wallet-name> <account-addr|bookmark> <amount> [additional-flags...]
Behavior
  • <amount> accepts numeric TON values or the shortcuts all (sends balance minus fees) and alld (sends entire balance, including fees).
  • Automatically checks the source balance, destination bounceability, and wallet version. Add -n to force non-bounceable mode or other validator-console flags as needed.
  • Submits the signed transfer via the validator console; prints MoveCoins - OK on success.
Examples 
mg treasury EQDv...Qw 1500
mg treasury bookmark_main all -n

​
mgtp

Purpose: Relay a payment through two temporary proxy wallets before reaching the destination. Syntax 
mgtp <wallet-name> <account-addr|bookmark> <amount>
Behavior
  • Creates two temporary wallets, hops the transfer through them (wallet -> proxy1 -> proxy2 -> destination) and cleans up afterwards.
  • Ensures the final leg includes -n (non-bounceable) to safely reach inactive recipients.
  • Handy when the destination cannot accept a direct bounceable transfer.
Example 
mgtp treasury EQC6...rA alld
⌘I