@crunchdao/cli

CrunchDAO Protocol CLI

A command-line interface for the Crunch Protocol, allowing for Coordinator Management, Crunch Management and Staking Operations.

Installation

npm install -g @crunchdao/cli

Quick Start

# Configure your environment
crunch config set network devnet
crunch config set wallet ~/.config/solana/devnet.json

# Check your setup
crunch config show

# Register as a coordinator
crunch coordinator register "MyCoordinator"

Command Structure

The CLI is organized by functional domains rather than user roles:

• crunch coordinator - Coordinator-specific operations
• crunch cruncher - Participant/cruncher operations
• crunch staking - All staking-related operations
• crunch crunch - Crunch competition management and participation
• crunch config - Global configuration management

Global Options

All commands support these global options:

• -n, --network <network> - Solana network (mainnet-beta|testnet|devnet|localhost)
• -w, --wallet <path> - Path to wallet keypair file
• -u, --url <url> - Custom RPC URL (overrides network)
• -o, --output <format> - Output format (json|table|yaml)
• -v, --verbose - Enable verbose logging
• -q, --quiet - Suppress non-error output
• --dry-run - Show what would be executed without running
• --timeout <seconds> - Command timeout in seconds

Examples

Staking Operations

# Deposit tokens for staking
crunch staking deposit 1000

# Delegate to a coordinator
crunch staking delegate 7x8yF...3k9L 500

# Check positions and rewards
crunch staking positions
crunch staking rewards

# Claim rewards
crunch staking claim

Model Management

# Add a model to a competition
crunch cruncher model add "DataSci2024" "bot1" "submission123" "resource456" "gpu" "start"

# List models in a competition
crunch cruncher model list "DataSci2024"

# Update model
crunch cruncher model update "DataSci2024" "bot1" '{"state": "stop"}'

Configuration

The CLI uses a global configuration file stored at ~/.crunch/config.json:

# Set default network
crunch config set network devnet

# Set default wallet
crunch config set wallet ~/.config/solana/devnet.json

# View current configuration
crunch config show

# Validate configuration
crunch config validate

Contributing

Please see the main repository's contributing guidelines.

License

MIT