> For the complete documentation index, see [llms.txt](https://docs.zus.network/zus-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zus.network/zus-docs/clis/zwalletcli.md).

# Zwallet CLI

**ZwalletCLI** is a command-line interface (CLI) that demonstrates the wallet functionalities of the **Züs Network**. Built using the **Züs GoSDK**, it provides a convenient way to interact with the blockchain, the Bridge protocol, and Züs smart contracts.

### Core Features

#### Creating and Managing Your Wallet

* Create a new wallet or recover one from existing mnemonics.
* View wallet information and check balances.

#### Bridge Protocol (ERC-20 DEX)

* Exchange **ZCN tokens** with ERC-20 tokens using the Bridge protocol.
* Mint and burn tokens on both native ZCN smart contracts and Züs ERC-20 smart contracts.

#### Managing Miners and Sharders

* List available miners and sharders in the network.
* Configure or shut down your nodes.
* Node ownership is required to perform administrative actions.

#### Managing Authorizers

* Register a new authorizer.
* List all registered authorizers.
* Update authorizer configurations.

#### Staking

* Stake tokens on miners or sharders.
* Earn rewards for supporting network security and consensus.

***

### Architecture

ZwalletCLI operates as a thin client that interacts with the Züs Network through configuration and wallet files stored locally.

<figure><img src="/files/MZukwD9rirkZOTiXqxtj" alt=""><figcaption></figcaption></figure>

1. **Local Context**
   * Wallet and configuration files are stored under `~/.zcn/`.
   * Private keys remain local; transactions are signed client-side.
2. **Network Discovery**
   * Uses the **block worker (0dns)** to discover miners and sharders.
   * Optional: a custom `network.yaml` can override default discovery.
3. **Transaction Flow**
   * Transactions are signed locally and submitted to **miners**.
   * **Miners** validate and propose blocks.
   * **Sharders** confirm and finalize transactions on chain.
4. **Smart Contracts in Use**
   * **Wallet & Token SCs**: Manage balances, transfers, and faucet operations.
   * **Miner SC**: Handles staking, node lifecycle, and rewards.
   * **Storage SC**: Manages blobbers and allocation parameters.
   * **Bridge SC**: Enables cross-chain operations with Ethereum/ERC-20 tokens.