Skip to main content

​
MyTonCtrl utilities commands

Utility commands provide quick inspection and helper tools for accounts, bookmarks, governance artifacts, and validator data. They are available whenever MyTonCtrl runs with utilities module enabled.

​
Account inspection

​
vas

Purpose: View the latest account status, code hash, and recent messages. Syntax 
vas <account-addr|bookmark>
Behavior
  • Resolves bookmarks automatically and fetches the account via lite-client.
  • Prints a status table (address, state, balance, detected contract version), the raw code hash, and the last 10 inbound/outbound messages with relative timestamps.
  • Useful for verifying that deployments succeeded or funds arrived.
Example 
vas EQBf...nw

​
vah

Purpose: Print a paginated message history for an account. Syntax 
vah <account-addr|bookmark> <limit>
Behavior
  • Shows the most recent <limit> messages, marking direction (>>> for outgoing, <<< for incoming), amount, and counterparty addresses in base64.
  • Handy when you need deeper history than the default vas preview.
Example 
vah EQBf...nw 25

​
Bookmark management

​
nb

Purpose: Create a bookmark for frequently used addresses. Syntax 
nb <bookmark-name> <account-addr>
Behavior
  • Validates that <account-addr> is a correct TON address and stores it under <bookmark-name> for future commands (e.g., mg, vas).
Example 
nb treasury EQBf...nw

​
bl

Purpose: List all stored bookmarks. Syntax 
bl
Behavior
  • Prints a table with each bookmark name, address, and any cached metadata (balance or expiration date if available).

​
db

Purpose: Delete a bookmark by name. Syntax 
db <bookmark-name>
Behavior
  • Removes the bookmark from MyTonCtrl storage. Future commands must use the raw address unless you recreate the bookmark.
Example 
db treasury

​
Governance and configuration helpers

​
ol

Purpose: Display open governance offers (configuration proposals). Syntax 
ol [--json] [hash]
Behavior
  • Without flags, prints a table showing hash (trimmed unless you pass the literal hash argument), config ID, votes, win/loss tally, approval percentage, and pass status.
  • --json outputs the raw offer list in JSON format.
Examples 
ol
ol --json
ol hash

​
od

Purpose: Diff a proposal’s configuration against the current config. Syntax 
od <offer-hash>
Behavior
  • Fetches the offer, runs lite-client commands to dump the proposed config, and shows a diff between the current value and the proposal. Requires shell diff utility.
Example 
od xKF+2Cj4wP6w2y...

​
cl

Purpose: List validator complaints for the current or previous round. Syntax 
cl [past] [--json] [adnl]
Behavior
  • With no flags, prints complaint entries with election ID, validator ADNL (trimmed unless adnl is supplied), fine, vote count, approval percent, and pass status (color-coded).
  • past switches to the previous election round; --json dumps raw data.
Examples 
cl
cl past adnl
cl --json

​
Election data

​
el

Purpose: Inspect election entries submitted by validators. Syntax 
el [past] [--json] [adnl] [pubkey] [wallet]
Behavior
  • The default view shows trimmed ADNL/pubkey/wallet values along with stake and max-factor.
  • Add past to see the previous round, --json for raw output, or the literals adnl, pubkey, wallet to disable trimming for those columns.
Examples 
el
el past adnl pubkey
el --json

​
Validator roster

​
vl

Purpose: Print the validator list with optional filters and formats. Syntax 
vl [past] [fast] [--json] [adnl] [pubkey] [wallet] [offline]
Behavior
  • Default view shows index, trimmed ADNL/pubkey/wallet, stake, efficiency, and online status (color-coded).
  • past loads the previous round; fast avoids extra lite-client calls for performance.
  • --json returns raw data. Passing adnl, pubkey, or wallet prevents trimming for those columns. offline filters to entries marked offline.
Examples 
vl
vl fast offline
vl past --json adnl

​
Pool diagnostics

​
get_pool_data

Purpose: Retrieve detailed pool contract data by name or address. Syntax 
get_pool_data <pool-name|pool-addr>
Behavior
  • Accepts either a local pool alias (resolved via stored .addr file) or a base64 contract address.
  • Prints the JSON returned by runmethodfull ... get_pool_data, including stake, elector values, and state flags.
Example 
get_pool_data mypool