Orbinum Wallet CLI

A secure command-line wallet for the Orbinum blockchain with support for shielded transactions using zero-knowledge proofs.

Quick Start

Prerequisites

• Rust 1.75+ and Cargo
• Access to Orbinum RPC node
• (Optional) GPG for binary verification

Installation

Option 1: Download Pre-built Binary (Recommended)

# Download latest release
wget https://github.com/orbinum/wallet-cli/releases/latest/download/orbinum-wallet

# Verify with GPG (see SECURITY.md)
./scripts/verify-wallet.sh orbinum-wallet

chmod +x orbinum-wallet

Option 2: Build from Source

git clone https://github.com/orbinum/wallet-cli.git
cd wallet-cli
cargo build --release
./target/release/orbinum-wallet --version

First Run

# Create new wallet
orbinum-wallet wallet create

# Create spending account
orbinum-wallet account create spending

# Check balance
orbinum-wallet balance

# Sync with blockchain
orbinum-wallet sync

Documentation

• Usage Examples - Detailed command examples and workflows
• Security Guide - Security best practices and GPG verification
• Contributing - Development guidelines

Security Notice

Always verify binaries before use:

# Import official signing key
gpg --import RELEASE_KEY.asc

# Verify signature
gpg --verify orbinum-wallet.asc orbinum-wallet

Official GPG Key Fingerprint: 174E 9AD2 5455 9716 42B9 332D FFF7 BF02 87E3 B152

• 📝 Encrypted Memos - Private transaction messages
• ⚡ Shield/Unshield - Bridge between transparent and shielded pools

Configuration

Config file: ~/.orbinum/wallet/config.toml

[network]
rpc_url = "http://localhost:9944"
chain_id = "orbinum-mainnet"

[wallet]
data_dir = "~/.orbinum/wallet"

Commands

Command	Description
wallet create	Create new encrypted wallet
wallet unlock	Unlock wallet for operations
account create <type>	Create spending/viewing account
account list	List all accounts
balance	Show account balances
sync	Sync with blockchain
transfer	Send shielded transaction
shield	Shield transparent tokens
unshield	Unshield to transparent address

Run orbinum-wallet help <command> for detailed usage.

Development

# Run tests
cargo test

# Run with logging
RUST_LOG=debug cargo run -- balance

# Format code
cargo fmt

# Lint
cargo clippy

Project Structure

src/
├── application/     # CLI commands and DTOs
├── domain/          # Business logic and models
├── infrastructure/  # RPC, storage, crypto implementations
└── presentation/    # CLI interface

Contributing

We welcome contributions! Please read CONTRIBUTING.md for guidelines.

License

Dual-licensed under Apache 2.0 and GPL-3.0. See LICENSE-APACHE2 and LICENSE-GPL3.

Links

• Documentation
• Website
• GitHub
• Security Policy