> ## Documentation Index
> Fetch the complete documentation index at: https://protocol.crunchdao.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet & CLI Setup

> Create a Solana wallet, register as a Coordinator, and prepare for deployment.

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**

## Start the Coordinator Platform (recommended)

Clone and run the webapp in **platform mode**:

```bash theme={null}
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:

```bash theme={null}
# 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](https://phantom.com/download) installed in your browser
* **CLI workflow (optional):** **Solana CLI installed** for keypair management. Installation:
  [solana.com/docs/intro/installation](https://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](https://solana.com/learn)

## Step 1: Set up your wallet

<Tabs>
  <Tab title="Platform (recommended)">
    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`.
  </Tab>

  <Tab title="CLI">
    Generate a local keypair that will act as your Coordinator wallet:

    ```bash theme={null}
    solana-keygen new --outfile ~/.config/solana/coordinator-keypair.json
    ```

    Store your keypair securely and create a backup in a safe location.
  </Tab>
</Tabs>

<Warning>
  Keep your private key secure and never share it. For mainnet, we strongly recommend using a
  [Squads Multisig](https://squads.xyz/squads-multisig) for operational security and shared control.
  See [Mainnet deployment](/getting-started/mainnet-deployment) for details.
</Warning>

## 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](https://faucet.solana.com/)
* **On mainnet** — acquire SOL from a cryptocurrency exchange

For CLI workflow, you can use:

```bash theme={null}
# 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
```

<Note>
  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.
</Note>

## Step 3: Register as a Coordinator

<Tabs>
  <Tab title="Platform (recommended)">
    The Coordinator Platform provides a guided registration flow:

    1. Open your platform instance at **[http://localhost:3000](http://localhost:3000)**
    2. Connect your Solana wallet
    3. Follow the **Get Started** onboarding flow to register as a Coordinator
    4. Complete the application and wait for Foundation approval

    The platform handles wallet connection, registration, certificate enrollment, and publication
    workflows in a single guided experience.
  </Tab>

  <Tab title="CLI">
    Install and configure the CLI, then register:

    ```bash theme={null}
    # Install the Crunch Protocol CLI
    npm install -g @crunchdao/cli

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

    # Register with your organization name
    crunch-cli coordinator register "Your Organization Name"

    # Verify your configuration
    crunch-cli config show
    ```
  </Tab>
</Tabs>

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

## 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:

<Tabs>
  <Tab title="Platform">
    Your approval status is displayed on the Coordinator Platform dashboard.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    crunch-cli coordinator get
    ```
  </Tab>
</Tabs>

## Verification checklist

Confirm your setup is ready:

<Tabs>
  <Tab title="Platform">
    * 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
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    # Solana CLI is working
    solana --version

    # Wallet has funds
    solana balance

    # CLI is installed
    crunch-cli --version

    # Configuration is correct
    crunch-cli config show
    ```
  </Tab>
</Tabs>

<Card title="Next: Deploy to testnet" icon="arrow-right" href="/getting-started/testnet-deployment">
  Deploy your Crunch to the Solana testnet for end-to-end testing.
</Card>

## Troubleshooting

<AccordionGroup>
  <Accordion title="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).
  </Accordion>

  <Accordion title="Network connection failed">
    Verify your network configuration with `crunch-cli config show`. Check your internet connection.
    Try switching to a different Solana RPC endpoint.
  </Accordion>

  <Accordion title="Coordinator not found">
    Verify you're using the correct wallet address. Ensure you've completed registration. Check
    you're on the correct network.
  </Accordion>
</AccordionGroup>

## 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](/cli/coordinator-and-crunch-commands) for detailed command documentation
* [Community Forum](https://forum.crunchdao.com/) for discussions
* [Discord](https://discord.gg/veAtzsYn3M) for real-time support