Skip to main content

Account inspection

vas

Purpose: View the latest account status, code hash, and recent messages. Syntax
Behavior
  • Resolves bookmarks automatically and fetches the account via the 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

vah

Purpose: Print a paginated message history for an account. Syntax
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

Bookmark management

nb

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

bl

Purpose: List all stored bookmarks. Syntax
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
Behavior
  • Removes the bookmark from MyTonCtrl storage. Future commands must use the raw address unless you recreate the bookmark.
Example

Governance and configuration helpers

ol

Purpose: Display open governance offers (configuration proposals). Syntax
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

od

Purpose: Diff a proposal’s configuration against the current config. Syntax
Behavior
  • Fetches the offer, runs lite-client commands to dump the proposed config, and shows a diff between the current value and the proposal. The diff utility must be available in the command shell to run this command.
Example

cl

Purpose: List validator complaints for the current or previous round. Syntax
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

Election data

el

Purpose: Inspect election entries submitted by validators. Syntax
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

Validator roster

vl

Purpose: Print the validator list with optional filters and formats. Syntax
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

Pool diagnostics

get_pool_data

Purpose: Retrieve detailed pool contract data by name or address. Syntax
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