zeckit CLI

Command-line tool for managing the ZecKit development environment (Zebra regtest + Faucet).

Installation

From crates.io (Recommended)

cargo install zeckit

From GitHub Releases

Download the latest pre-built binary for your platform from the Releases page.

From Source

git clone https://github.com/intellidean/ZecKit.git
cd ZecKit/cli
cargo build --release

The binary will be at target/release/zeckit (or zeckit.exe on Windows).

Add to PATH

Linux/macOS:

sudo cp target/release/zeckit /usr/local/bin/

Windows (PowerShell as Admin):

copy target\release\zeckit.exe C:\Windows\System32\

Usage

Start Devnet

# Start Zebra + Faucet only
zeckit up

# Start with lightwalletd
zeckit up --backend lwd

# Start with Zaino (experimental)
zeckit up --backend zaino

# Fresh start (remove old data)
zeckit up --fresh

Stop Devnet

# Stop services (keep data)
zeckit down

# Stop and remove volumes
zeckit down --purge

Check Status

zeckit status

Run Tests

zeckit test

Commands

Options

zeckit up

• --backend <BACKEND> - Backend to use: lwd (lightwalletd) or zaino
• --fresh - Remove old data and start fresh

zeckit down

• --purge - Remove volumes (clean slate)

Examples

# Start everything
zeckit up --backend lwd

# Check if running
zeckit status

# Run tests
zeckit test

# Stop and clean up
zeckit down --purge

Development

Build

cargo build

Run

cargo run -- up
cargo run -- status
cargo run -- test
cargo run -- down

Test

cargo test

Troubleshooting

Docker not found

# Install Docker: https://docs.docker.com/get-docker/

Services not starting

# Check Docker is running
docker ps

# View logs
docker compose logs zebra
docker compose logs faucet

Port conflicts

# Stop other services using:
# - 8232 (Zebra RPC)
# - 8080 (Faucet API)
# - 9067 (Backend)

License

MIT OR Apache-2.0