> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ton.org/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.ton.org/feedback

```json
{
  "path": "/ecosystem/nodes/cpp/mytonctrl/utilities",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Utilities

> Utility commands provide quick inspection and helper tools for accounts, bookmarks, governance artifacts, and validator data.

## Account inspection

### `vas`

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

**Syntax**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
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 theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
vas EQBf...nw
```

### `vah`

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

**Syntax**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
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 theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
vah EQBf...nw 25
```

## Bookmark management

### `nb`

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

**Syntax**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
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 theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
nb treasury EQBf...nw
```

### `bl`

**Purpose:** List all stored bookmarks.

**Syntax**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
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**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
db <bookmark-name>
```

**Behavior**

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

**Example**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
db treasury
```

## Governance and configuration helpers

### `ol`

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

**Syntax**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
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 theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
ol
ol --json
ol hash
```

### `od`

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

**Syntax**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
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 theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
od xKF+2Cj4wP6w2y...
```

### `cl`

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

**Syntax**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
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 theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
cl
cl past adnl
cl --json
```

## Election data

### `el`

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

**Syntax**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
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 theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
el
el past adnl pubkey
el --json
```

## Validator roster

### `vl`

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

**Syntax**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
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 theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
vl
vl fast offline
vl past --json adnl
```

## Pool diagnostics

### `get_pool_data`

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

**Syntax**

```mytonctrl theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
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 theme={"theme":{"light":"github-light-default","dark":"dark-plus"},"languages":{"custom":["/resources/grammars/tolk.tmLanguage.json","/resources/grammars/tlb.tmLanguage.json","/resources/grammars/fift.tmLanguage.json","/resources/grammars/tasm.tmLanguage.json","/resources/grammars/func.tmLanguage.json"]}}
get_pool_data mypool
```