lithium-cli

CLI miner and operations tool for Litium (LI) on the Bostrom blockchain.

Mines LI tokens by solving UniversalHash proof-of-work challenges and submitting proofs on-chain. Also provides commands for querying contract state, managing staking, referrals, and transfers.

Install

cargo install --git https://github.com/cyberia-to/lithium-cli.git

Or build from source:

git clone https://github.com/cyberia-to/lithium-cli.git
cd lithium-cli
cargo build --release
# binary at target/release/lithium

Quick Start

# Create a wallet
lithium wallet new

# Check mining window status
lithium status

# Start mining (uses all CPU cores, auto difficulty)
lithium mine

# Start mining with specific settings
lithium mine --threads 4 --difficulty 12 --referrer bostrom1...

Commands

Mining

lithium mine [OPTIONS]

Continuous mining loop: generates random challenges, solves them locally using the UniversalHash algorithm, and submits valid proofs to the litium-mine contract.

Wallet

lithium wallet new           # Create new wallet (encrypted keystore)
lithium wallet address       # Show address
lithium wallet import              # Import from mnemonic (prompted securely)
lithium wallet export        # Show mnemonic

Queries

lithium status                          # Mining window status + block height
lithium stats                           # Global mining stats (proofs, miners, rewards)
lithium stats --address bostrom1...     # + per-miner stats
lithium emission                        # Emission rate breakdown
lithium burn-stats                      # Transfer burn accounting
lithium referral --address bostrom1...  # Referral info for address
lithium stake-info --address bostrom1...# Staking info for address

Transactions

lithium claim-referral       # Claim referral rewards
lithium claim-staking        # Claim staking rewards
lithium claim-unbonding      # Claim matured unbonding
lithium transfer --to bostrom1... --amount 1000000

Manual Proof Submission

lithium send --hash <hex> --nonce <n> --timestamp <unix> \
  --challenge <hex> --difficulty <bits>

Global Options

JSON Output

All commands support --json for scripting. Mining emits newline-delimited JSON events:

{"event":"session_start","miner":"bostrom1...","difficulty":12,"threads":8}
{"event":"proof_found","nonce":42,"hash":"00ab...","total_hashes":8192}
{"event":"proof_submitted","tx_hash":"A1B2...","proofs_total":1}

Architecture

Single binary crate with four modules:

• main.rs -- CLI argument parsing and command dispatch
• rpc.rs -- Bostrom LCD client (queries, TX signing, broadcast)
• contract_types.rs -- Serde types for all modular litium contracts
• deployments.rs -- Mainnet contract addresses from embedded TOML

Queries and transactions are routed to the correct modular contract automatically:

Mining uses uhash-prover for the UniversalHash CPU solver and uhash-cli for wallet management.

Contracts

Mainnet addresses are embedded in deployments/bostrom-mainnet.toml and used as CLI defaults.

License

Apache-2.0