Crunch Protocol CLI Skill

crunch-cli

Prerequisites

• Node.js 18+ with

  npm

• Solana wallet keypair (for on-chain operations)

Package Installation

@crunchdao/crunch-cli

• Only install

  @crunchdao/crunch-cli

  from the official npm registry
• No custom registry URLs — no

  --registry

  overrides
• Ask the user before installing if not already present

Credentials

Solana Wallet Keypair (required for on-chain operations)

• What it is: A JSON file containing a Solana private key, used to sign transactions
• How it's configured: Set via

  crunch-cli config set wallet /path/to/wallet.json

  or

  -w

  flag per command
• Stored in: User-managed file on disk; path referenced in

  ~/.crunch/config.json

• Never create or generate wallet keypairs unless the user explicitly asks and understands the security implications
• Never read or display the contents of wallet keypair files
• Never commit wallet files to git — always verify

  .gitignore

  covers them
• Ask the user for the wallet path — never assume or search for keypair files

Profile Config (

~/.crunch/config.json

)

• Stores network, wallet path, and RPC URL per profile
• Managed via

  crunch-cli config

  commands — no need to edit manually
• Never modify or delete existing profiles unless explicitly asked

Setup

npm install -g @crunchdao/crunch-cli
crunch-cli --version

Profiles

~/.crunch/config.json

crunch-cli config show                    # Show current config
crunch-cli config active                  # Show resolved active values
crunch-cli config list-profiles           # List available profiles
crunch-cli config save-profile <name>     # Save current config as profile
crunch-cli config use <profile>           # Switch profile
crunch-cli config set <key> <value>       # Set config value

-n, --network

mainnet-beta

devnet

localhost

-u, --url

-w, --wallet

-o, --output

json

table

yaml

Direct Phrase Mapping

get/show crunch <name>

crunch-cli crunch get "<name>"

list crunches

crunch-cli crunch list

get/show coordinator [address]

crunch-cli coordinator get [address]

list coordinators

crunch-cli coordinator list

get config

crunch-cli coordinator get-config

checkpoint for <name>

crunch-cli crunch checkpoint-get-current "<name>"

create checkpoint <name>

crunch-cli crunch checkpoint-create "<name>" prizes.json

deposit reward <name> <amount>

crunch-cli crunch deposit-reward "<name>" <amount>

drain <name>

crunch-cli crunch drain "<name>"

create/register cruncher

crunch-cli cruncher create

register for <name>

crunch-cli cruncher register "<name>"

claim rewards <name>

crunch-cli cruncher claim "<name>"

show staking positions

crunch-cli staking positions

stake/deposit <amount>

crunch-cli staking deposit <amount>

delegate to <coordinator>

crunch-cli staking delegate "<coordinator>" <amount>

show staking rewards

crunch-cli staking rewards

claim staking rewards

crunch-cli staking claim

undelegate from <coordinator>

crunch-cli staking undelegate "<coordinator>" <amount>

withdraw stake <amount>

crunch-cli staking withdraw <amount>

init workspace <name>

crunch-cli init-workspace "<name>"

list scenarios/simulations

crunch-cli model list

run simulation <scenario>

crunch-cli model run "<scenario>"

register coordinator <name>

crunch-cli coordinator register "<name>"

create crunch <name>

crunch-cli crunch create "<name>" <amount> [maxModels]

start/end crunch <name>

crunch-cli crunch start/end "<name>"

Execution Pattern

1. Parse — Identify action, target, name/identifier, parameters
2. Resolve profile — If mentioned, switch profile or use flags
3. Map — Use phrase mapping table
4. Execute — Run command
5. Format — Output for requested medium (Slack/Telegram/Discord/plain)

Output Formatting

• Slack:

  *bold*

  ,

  •

  bullets,

  ━

  separators
• Telegram:

  <b>bold</b>

  , emoji prefixes
• Discord:

  ## headers

  ,

  **bold**

• Plain: Simple key: value pairs

Error Handling

• Wrong network? Add

  -n mainnet-beta

  or

  -n devnet

• Missing wallet? Add

  -w /path/to/wallet.json

• Not found? List available with

  crunch-cli crunch list

Coordinator Node Setup

crunch-cli init-workspace my-challenge

Reference