Skip to main content
Before you can deploy your Crunch to testnet or mainnet, you need a Solana wallet and a registered Coordinator account. Use the two tools for different purposes:
  • Crunch Node Starter — ships with the Crunch Starter and is for building and validating Crunches locally
  • Coordinator Platform — for registering, publishing, and managing live Crunches across staging/devnet and production/mainnet
Clone and run the webapp in platform mode:
git clone https://github.com/crunchdao/coordinator-webapp.git
cd coordinator-webapp
pnpm install
pnpm dev:platform
Then open http://localhost:3000. Optional environment-specific modes:
# Staging / devnet mode
pnpm dev:platform:devnet

# Production / mainnet mode
pnpm dev:platform:mainnet

Prerequisites

  • Coordinator Platform workflow (recommended): a Solana browser wallet such as Phantom installed in your browser
  • CLI workflow (optional): Solana CLI installed for keypair management. Installation: solana.com/docs/intro/installation
  • pnpm installed (required by the coordinator-webapp monorepo)
  • Basic understanding of Solana and blockchain transactions. Learn more at solana.com/learn

Step 1: Set up your wallet

Keep your private key secure and never share it. For mainnet, we strongly recommend using a Squads Multisig for operational security and shared control. See Mainnet deployment for details.

Step 2: Fund your wallet with SOL

Every Solana transaction requires a small fee paid in SOL:
  • On devnet — request free SOL from the Solana devnet faucet
  • On mainnet — acquire SOL from a cryptocurrency exchange
For CLI workflow, you can use:
# Set your wallet and network
solana config set --keypair ~/.config/solana/coordinator-keypair.json
solana config set --url devnet

# Request free devnet SOL
solana airdrop 2

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

Step 3: Register as a Coordinator

Your Coordinator will initially be in a pending state. Once approved by the Foundation, your status will change and you can start creating Crunches.

Step 4: Wait for Foundation approval

After registration, you must wait for the Crunch Protocol Foundation to approve your Coordinator status. You can check your status at any time:
Your approval status is displayed on the Coordinator Platform dashboard.

Verification checklist

Confirm your setup is ready:
  • Wallet connects successfully in the Coordinator Platform (http://localhost:3000)
  • Wallet has enough SOL for transactions
  • Coordinator registration appears as pending/approved in the dashboard

Next: Deploy to testnet

Deploy your Crunch to the Solana testnet for end-to-end testing.

Troubleshooting

Check your wallet balance with solana balance. Fund your wallet with more SOL. Ensure you’re on the correct network (devnet vs mainnet).
Verify your network configuration with crunch-cli config show. Check your internet connection. Try switching to a different Solana RPC endpoint.
Verify you’re using the correct wallet address. Ensure you’ve completed registration. Check you’re on the correct network.

Security best practices

  • Backup your keypair files securely
  • Use a Squads Multisig for mainnet operations
  • Monitor your wallet balance and transaction history
  • Use separate keypairs for testing (devnet) and production (mainnet)

Support