> ## Documentation Index
> Fetch the complete documentation index at: https://companyname-a7d5b98e-cex-integration-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet

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

```mytonctrl theme={null}
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**

```mytonctrl theme={null}
nw
nw 0 treasury v3 1001
```

### `aw`

**Purpose:** Deploy one wallet or all wallets that have unsigned deployment BoCs.

**Syntax**

```mytonctrl theme={null}
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**

```mytonctrl theme={null}
aw
aw wallet_005
```

### `wl`

**Purpose:** List every wallet known to MyTonCtrl along with its on-chain status.

**Syntax**

```mytonctrl theme={null}
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**

```mytonctrl theme={null}
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**

```mytonctrl theme={null}
dw treasury
```

## Importing, exporting, and metadata

### `iw`

**Purpose:** Import an existing wallet by address and secret key.

**Syntax**

```mytonctrl theme={null}
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**

```mytonctrl theme={null}
iw EQDk...cQ KJ4Q...
```

### `ew`

**Purpose:** Export a wallet’s address and secret key.

**Syntax**

```mytonctrl theme={null}
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**

```mytonctrl theme={null}
ew treasury
```

### `swv`

**Purpose:** Update the recorded wallet version (v1/v2/v3) for an imported wallet.

**Syntax**

```mytonctrl theme={null}
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**

```mytonctrl theme={null}
swv EQC0...FQ v3
```

## Fund transfers

### `mg`

**Purpose:** Send Toncoin from a local wallet to a destination address or bookmark.

**Syntax**

```mytonctrl theme={null}
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**

```mytonctrl theme={null}
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**

```mytonctrl theme={null}
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**

```mytonctrl theme={null}
mgtp treasury EQC6...rA alld
```