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.

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.