Cruncher & Staking Commands

Cruncher Commands

Cruncher commands handle participant operations — creating a profile, registering for competitions, managing models, and claiming rewards.

crunch-cli cruncher <command> [options] [arguments]

`cruncher create`

Create a new Cruncher profile.

crunch-cli cruncher create <name>

Arguments:

Argument	Description
`name`	Name of the cruncher

Example:

crunch-cli cruncher create "CruncherX"

`cruncher register`

crunch-cli cruncher register <crunchName> <cruncherName>

Arguments:

Argument	Description
`crunchName`	Name of the crunch competition
`cruncherName`	Name of the cruncher to register

Example:

crunch-cli cruncher register "iris_classifier" "CruncherX"

`cruncher get`

Get Cruncher information by wallet address.

crunch-cli cruncher get [walletAddress]

Arguments:

Argument	Description
`walletAddress`	Wallet address (optional, defaults to current wallet)

Examples:

# Get your own Cruncher info
crunch-cli cruncher get

# Get info for a specific wallet
crunch-cli cruncher get 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

`cruncher get-address`

Get cruncher PDA address from a wallet address.

crunch-cli cruncher get-address <walletAddress>

`cruncher get-claim-record`

Get the claim record for a cruncher in a competition.

crunch-cli cruncher get-claim-record <crunchName> <cruncherWalletAddress>

Example:

crunch-cli cruncher get-claim-record "iris_classifier" 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

Shows the claim record address and cruncher index for the specified competition.

`cruncher get-claimable-checkpoints`

Get claimable checkpoints for the current wallet.

crunch-cli cruncher get-claimable-checkpoints <crunchName>

Example:

crunch-cli cruncher get-claimable-checkpoints "iris_classifier"

Lists all available checkpoints with amounts that can be claimed.

`cruncher claim`

Claim available checkpoint rewards from a competition.

crunch-cli cruncher claim <crunchName>

Example:

crunch-cli cruncher claim "iris_classifier"

Model Commands

Model commands are subcommands of cruncher for managing model submissions within competitions.

crunch-cli cruncher model <command> [options] [arguments]

`cruncher model add`

Submit a new model to a competition.

crunch-cli cruncher model add <crunchName> <modelId> <submissionId> <resourceId> <hardwareType> <desiredState> [--skip-signature]

Arguments:

Argument	Description
`crunchName`	Name of the crunch competition
`modelId`	Unique model identifier
`submissionId`	Submission identifier
`resourceId`	Resource identifier
`hardwareType`	Hardware type (`cpu`, `gpu`, etc.)
`desiredState`	Desired state (`active`, `inactive`)

Options:

Option	Description
`--skip-signature`	Skip model signing

Example:

crunch-cli cruncher model add "iris_classifier" "model_123" "sub_456" "res_789" "gpu" "active"

`cruncher model update`

Update an existing model’s results or metadata.

crunch-cli cruncher model update <crunchName> <modelId> <updateData> [--skip-signature]

Arguments:

Argument	Description
`crunchName`	Name of the crunch competition
`modelId`	Model identifier to update
`updateData`	Update data as JSON string

Example:

crunch-cli cruncher model update "iris_classifier" "model_123" '{"desiredState": "inactive"}'

The updateData JSON can include any of: submissionId, resourceId, hardwareType, desiredState.

`cruncher model get`

Get detailed information about a specific model.

crunch-cli cruncher model get <modelId>

Example:

crunch-cli cruncher model get "model_123"

`cruncher model get-crunch-models`

Get all models submitted to a competition.

crunch-cli cruncher model get-crunch-models <crunchName>

Example:

crunch-cli cruncher model get-crunch-models "iris_classifier"

Staking Commands

Staking commands manage token deposits, delegation, and rewards.

crunch-cli staking <command> [options] [arguments]

`staking deposit`

Deposit CRNCH tokens to stake.

crunch-cli staking deposit <amount>

Example:

crunch-cli staking deposit 1000

`staking withdraw`

Withdraw CRNCH tokens from stake.

crunch-cli staking withdraw <amount>

Example:

crunch-cli staking withdraw 500

`staking delegate`

Delegate tokens to a coordinator.

crunch-cli staking delegate <coordinator> <amount>

Arguments:

Argument	Description
`coordinator`	Coordinator address to delegate to
`amount`	Amount of tokens to delegate

Example:

crunch-cli staking delegate 7x8yF...3k9L 500

`staking undelegate`

Undelegate tokens from a coordinator.

crunch-cli staking undelegate <coordinator> <amount>

Example:

crunch-cli staking undelegate 7x8yF...3k9L 500

`staking positions`

Show your current staking positions.

crunch-cli staking positions

`staking available`

Show available balance for staking.

crunch-cli staking available

`staking rewards`

Show claimable staking rewards.

crunch-cli staking rewards

`staking claim`

Claim pending staking rewards.

crunch-cli staking claim

`staking accounts`

Show staking account addresses.

crunch-cli staking accounts

`staking positions-accounts`

Show position account addresses.

crunch-cli staking positions-accounts

Command Reference Summary

Category	Command	Description
Cruncher	`cruncher create`	Create a Cruncher profile
	`cruncher register`	Register for a competition
	`cruncher get`	Get Cruncher info by wallet
	`cruncher get-address`	Get Cruncher PDA address
	`cruncher get-claim-record`	Get claim record
	`cruncher get-claimable-checkpoints`	Get claimable checkpoints
	`cruncher claim`	Claim checkpoint rewards
Models	`cruncher model add`	Submit a new model
	`cruncher model update`	Update model results
	`cruncher model get`	Get model information
	`cruncher model get-crunch-models`	Get all models for a competition
Staking	`staking deposit`	Deposit CRNCH tokens
	`staking withdraw`	Withdraw CRNCH tokens
	`staking delegate`	Delegate tokens to a coordinator
	`staking undelegate`	Undelegate tokens
	`staking positions`	Show staking positions
	`staking available`	Show available balance
	`staking rewards`	Show claimable rewards
	`staking claim`	Claim staking rewards
	`staking accounts`	Show staking accounts
	`staking positions-accounts`	Show position accounts

Common Workflows

Participating in a Competition

Create Profile

crunch-cli cruncher create "MyTeamName"

crunch-cli cruncher register "iris_classifier" "MyTeamName"

Submit Model

crunch-cli cruncher model add "iris_classifier" "model1" "sub1" "res1" "gpu" "active"

Update Model

crunch-cli cruncher model update "iris_classifier" "model1" '{"desiredState": "active"}'

Check Rewards

crunch-cli cruncher get-claimable-checkpoints "iris_classifier"

Claim Rewards

crunch-cli cruncher claim "iris_classifier"

Staking Workflow

Deposit Tokens

crunch-cli staking deposit 1000

Delegate to Coordinator

crunch-cli staking delegate 7x8yF...3k9L 500

Monitor Positions

crunch-cli staking positions

Check Rewards

crunch-cli staking rewards

Claim Rewards

crunch-cli staking claim

Coordinator & Crunch Commands — Competition management and coordinator operations
Installation & Global Options — Configuration and shared options

Overview

Core Concepts

Getting Started

CLI Reference

Appendix

Cruncher Commands

`cruncher create`

`cruncher register`

`cruncher get`

`cruncher get-address`

`cruncher get-claim-record`

`cruncher get-claimable-checkpoints`

`cruncher claim`

Model Commands

`cruncher model add`

`cruncher model update`

`cruncher model get`

`cruncher model get-crunch-models`

Staking Commands

`staking deposit`

`staking withdraw`

`staking delegate`

`staking undelegate`

`staking positions`

`staking available`

`staking rewards`

`staking claim`

`staking accounts`

`staking positions-accounts`

Command Reference Summary

Common Workflows

Participating in a Competition

Staking Workflow

​Cruncher Commands

​cruncher create

​cruncher register

​cruncher get

​cruncher get-address

​cruncher get-claim-record

​cruncher get-claimable-checkpoints

​cruncher claim

​Model Commands

​cruncher model add

​cruncher model update

​cruncher model get

​cruncher model get-crunch-models

​Staking Commands

​staking deposit

​staking withdraw

​staking delegate

​staking undelegate

​staking positions

​staking available

​staking rewards

​staking claim

​staking accounts

​staking positions-accounts

​Command Reference Summary

​Common Workflows

​Participating in a Competition

​Staking Workflow

​Related

Cruncher Commands

`cruncher create`

`cruncher register`

`cruncher get`

`cruncher get-address`

`cruncher get-claim-record`

`cruncher get-claimable-checkpoints`

`cruncher claim`

Model Commands

`cruncher model add`

`cruncher model update`

`cruncher model get`

`cruncher model get-crunch-models`

Staking Commands

`staking deposit`

`staking withdraw`

`staking delegate`

`staking undelegate`

`staking positions`

`staking available`

`staking rewards`

`staking claim`

`staking accounts`

`staking positions-accounts`

Command Reference Summary

Common Workflows

Participating in a Competition

Staking Workflow

Related