Skip to main content

​
Prerequisites

Before you begin, ensure you have:

​
Setup Process

​
Step 1: Create a Solana Key Pair

First, you’ll need to generate a Solana key pair, which will act as your Coordinator wallet. 

# Create a new key pair
solana-keygen new --outfile ~/.config/solana/coordinator-keypair.json
You must store your keypair securely and create a backup in a safe location. Keep your public key accessible, as you may need it for future steps.
Important: Keep your private key secure and never share it!For running a Coordinator node on mainnet, we strongly recommend using a Squads Multisig. It provides proper operational security and shared control.We offer full support and guidance for setting this up. Coordinator Security

​
Step 2: Fund Your Key Pair with SOL

Every transaction on the Solana blockchain requires a small fee, paid in SOL. To perform any actions as a Coordinator, your wallet must have a sufficient balance of SOL (Solana tokens) to cover these network transaction fees. The method for acquiring SOL depends on the network you are using:
  • On mainnet, acquire SOL from a cryptocurrency exchange and send it to your wallet’s public address.
  • On devnet (for testing purposes), you can request 5 free SOL per day from the Solana devnet faucet.
# Set your wallet as the default
solana config set --keypair ~/.config/solana/coordinator-keypair.json

# For devnet testing, make sure your config is set to devnet
solana config set --url devnet

# Request free SOL from the faucet
solana airdrop 2  # Or use https://faucet.solana.com/ to get free devnet SOL

# Check your current balance
solana balance
Recommended: Keep at least 0.1 SOL in your Coordinator wallet for transaction fees. We highly recommend starting on devnet and testing the setup before moving to mainnet.

​
Step 3: Install and Configure Coordinator CLI

Install the Coordinator CLI tool and configure it to use your new key pair. If you already have the Coordinator CLI installed, you can skip this step but make sure you are on the latest published version. 
# Install the Coordinator CLI
npm install -g @crunchdao/coordinator-cli

# Configure the CLI to use your keypair
crunch-coordinator config set wallet ~/.config/solana/coordinator-keypair.json

# Set your network (devnet for testing, mainnet for production)
crunch-coordinator config set network devnet

# Verify your configuration
crunch-coordinator config show

​
Step 4: Register as a Coordinator

Use the CLI to register your wallet as a Coordinator with the protocol. 
# Register with your Coordinator name
crunch-coordinator register "Your Organization Name"
Note: Your Coordinator will initially be in pending state. Once approved by the Foundation, the state will change.

​
Step 5: Wait for Foundation Approval

After registration, you must wait for the Crunch Protocol Foundation to approve your Coordinator status.

​
Verification Steps

​
Check Your Setup

Verify each step of your setup: 
# 1. Verify Solana CLI is working
solana --version

# 2. Check your wallet balance
solana balance

# 3. Verify Coordinator CLI installation
crunch-coordinator --version

# 4. Check your Coordinator configuration
crunch-coordinator config show

# 5. Verify your Coordinator status
crunch-coordinator get $(solana-keygen pubkey ~/.config/solana/coordinator-keypair.json)

​
🎉 Congratulations!

You’ve successfully completed the Coordinator setup process! You now have:
  • ✅ A configured Solana wallet for Coordinator operations
  • ✅ Coordinator CLI tools installed and configured
  • ✅ Foundation registration submitted and pending approval
  • ✅ All prerequisites in place for launching your first Crunch

​
What’s Next?

Once your Coordinator status is approved by the Crunch Protocol Foundation, you’ll be ready to create and launch your first Crunch!
Remember: You’ll need Foundation approval before you can create Crunches. Check your approval status periodically using the verification commands above.

Crunch Setup

Learn how to create, configure, and launch your first Crunch tournament

​
Troubleshooting

​
Common Issues

“Insufficient SOL for transaction”
  • Check your wallet balance: solana balance
  • Fund your wallet with more SOL
  • Ensure you’re on the correct network
“Network connection failed”
  • Verify your network configuration: crunch-coordinator config show
  • Check your internet connection
  • Try switching Solana RPC endpoint
“Coordinator not found”
  • Verify you’re using the correct wallet address
  • Ensure you’ve completed the registration step
  • Check you’re on the correct network (devnet vs mainnet)

​
Configuration Issues

If you encounter configuration problems: 
# Reset your configuration
crunch-coordinator config set network devnet
crunch-coordinator config set wallet ~/.config/solana/coordinator-keypair.json

# Verify settings
crunch-coordinator config show

# Test connection
crunch-coordinator get-config

# Ensure you are using the latest version of the CLI
npm install -g @crunchdao/coordinator-cli

​
Security Best Practices

  • Backup your keypair files securely
  • Use hardware wallets for mainnet Coordinator operations
  • Monitor your wallet balance and transaction history
  • Keep your CLI tools updated to the latest versions
  • Use separate keypairs for testing (devnet) and production (mainnet)

​
Support

If you need help: