- 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
Start the Coordinator Platform (recommended)
Clone and run the webapp in platform mode:http://localhost:3000.
Optional environment-specific modes:
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
- Platform (recommended)
- CLI
Install and set up a Solana browser wallet (for example, Phantom), then use that wallet to
connect to the Coordinator Platform at
http://localhost:3000.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
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
- Platform (recommended)
- CLI
The Coordinator Platform provides a guided registration flow:
- Open your platform instance at http://localhost:3000
- Connect your Solana wallet
- Follow the Get Started onboarding flow to register as a Coordinator
- Complete the application and wait for Foundation approval
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:- Platform
- CLI
Your approval status is displayed on the Coordinator Platform dashboard.
Verification checklist
Confirm your setup is ready:- Platform
- CLI
- 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
Insufficient SOL for transaction
Insufficient SOL for transaction
Check your wallet balance with
solana balance. Fund your wallet with more SOL. Ensure you’re
on the correct network (devnet vs mainnet).Network connection failed
Network connection failed
Verify your network configuration with
crunch-cli config show. Check your internet connection.
Try switching to a different Solana RPC endpoint.Coordinator not found
Coordinator not found
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
- CLI reference for detailed command documentation
- Community Forum for discussions
- Discord for real-time support