Skip to main content

​
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:
ArgumentDescription
nameName of the cruncher
Example: 
crunch-cli cruncher create "CruncherX"

​
cruncher register

Register for a competition. 
crunch-cli cruncher register <crunchName> <cruncherName>
Arguments:
ArgumentDescription
crunchNameName of the crunch competition
cruncherNameName 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:
ArgumentDescription
walletAddressWallet 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:
ArgumentDescription
crunchNameName of the crunch competition
modelIdUnique model identifier
submissionIdSubmission identifier
resourceIdResource identifier
hardwareTypeHardware type (cpu, gpu, etc.)
desiredStateDesired state (active, inactive)
Options:
OptionDescription
--skip-signatureSkip 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:
ArgumentDescription
crunchNameName of the crunch competition
modelIdModel identifier to update
updateDataUpdate 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:
ArgumentDescription
coordinatorCoordinator address to delegate to
amountAmount 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

CategoryCommandDescription
Crunchercruncher createCreate a Cruncher profile
cruncher registerRegister for a competition
cruncher getGet Cruncher info by wallet
cruncher get-addressGet Cruncher PDA address
cruncher get-claim-recordGet claim record
cruncher get-claimable-checkpointsGet claimable checkpoints
cruncher claimClaim checkpoint rewards
Modelscruncher model addSubmit a new model
cruncher model updateUpdate model results
cruncher model getGet model information
cruncher model get-crunch-modelsGet all models for a competition
Stakingstaking depositDeposit CRNCH tokens
staking withdrawWithdraw CRNCH tokens
staking delegateDelegate tokens to a coordinator
staking undelegateUndelegate tokens
staking positionsShow staking positions
staking availableShow available balance
staking rewardsShow claimable rewards
staking claimClaim staking rewards
staking accountsShow staking accounts
staking positions-accountsShow position accounts

​
Common Workflows

​
Participating in a Competition

1

Create Profile

crunch-cli cruncher create "MyTeamName"
2

Register for Competition

crunch-cli cruncher register "iris_classifier" "MyTeamName"
3

Submit Model

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

Update Model

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

Check Rewards

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

Claim Rewards

crunch-cli cruncher claim "iris_classifier"

​
Staking Workflow

1

Deposit Tokens

crunch-cli staking deposit 1000
2

Delegate to Coordinator

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

Monitor Positions

crunch-cli staking positions
4

Check Rewards

crunch-cli staking rewards
5

Claim Rewards

crunch-cli staking claim