# Utilities (https://docs-kyrm16yq7-ton-core-docs.vercel.app/llms/ecosystem/nodes/cpp/mytonctrl/utilities/content.md)



## Account inspection [#account-inspection]

### `vas` [#vas]

**Purpose:** View the latest account status, code hash, and recent messages.

**Syntax**

```mytonctrl
vas <account-addr|bookmark>
```

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

```mytonctrl
vas EQBf...nw
```

### `vah` [#vah]

**Purpose:** Print a paginated message history for an account.

**Syntax**

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

```mytonctrl
vah EQBf...nw 25
```

## Bookmark management [#bookmark-management]

### `nb` [#nb]

**Purpose:** Create a bookmark for frequently used addresses.

**Syntax**

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

```mytonctrl
nb treasury EQBf...nw
```

### `bl` [#bl]

**Purpose:** List all stored bookmarks.

**Syntax**

```mytonctrl
bl
```

**Behavior**

* Prints a table with each bookmark name, address, and any cached metadata (balance or expiration date if available).

### `db` [#db]

**Purpose:** Delete a bookmark by name.

**Syntax**

```mytonctrl
db <bookmark-name>
```

**Behavior**

* Removes the bookmark from MyTonCtrl storage. Future commands must use the raw address unless you recreate the bookmark.

**Example**

```mytonctrl
db treasury
```

## Governance and configuration helpers [#governance-and-configuration-helpers]

### `ol` [#ol]

**Purpose:** Display open governance offers (configuration proposals).

**Syntax**

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

```mytonctrl
ol
ol --json
ol hash
```

### `od` [#od]

**Purpose:** Diff a proposal’s configuration against the current config.

**Syntax**

```mytonctrl
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. The `diff` utility must be available in the command shell to run this command.

**Example**

```mytonctrl
od xKF+2Cj4wP6w2y...
```

### `cl` [#cl]

**Purpose:** List validator complaints for the current or previous round.

**Syntax**

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

```mytonctrl
cl
cl past adnl
cl --json
```

## Election data [#election-data]

### `el` [#el]

**Purpose:** Inspect election entries submitted by validators.

**Syntax**

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

```mytonctrl
el
el past adnl pubkey
el --json
```

## Validator roster [#validator-roster]

### `vl` [#vl]

**Purpose:** Print the validator list with optional filters and formats.

**Syntax**

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

```mytonctrl
vl
vl fast offline
vl past --json adnl
```

## Pool diagnostics [#pool-diagnostics]

### `get_pool_data` [#get_pool_data]

**Purpose:** Retrieve detailed pool contract data by name or address.

**Syntax**

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

```mytonctrl
get_pool_data mypool
```