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

# Wallet Setup Guide

> Set up your Phantom wallet on Solana devnet to start submitting NKAs, creating bounties, and earning BIO tokens

NullGraph runs on **Solana devnet**, a test network where you can experiment without using real money. To interact with the platform, you'll need a browser wallet configured for devnet and some test tokens.

<Note>
  This guide uses **Phantom**, the most popular Solana wallet. NullGraph supports any Solana-compatible wallet, but Phantom offers the best user experience.
</Note>

## What You'll Need

* A desktop or laptop computer (Phantom is available on Chrome, Firefox, Brave, Edge)
* 5 minutes of setup time
* No prior crypto experience required

## Install Phantom Wallet

<Steps>
  ### Download the Extension

  1. Open your browser (Chrome, Firefox, Brave, or Edge)
  2. Go to [phantom.app](https://phantom.app)
  3. Click **Download** and select your browser
  4. Follow the browser's prompts to add the extension
  5. Pin the extension to your toolbar for easy access

  ### Create a New Wallet

  When you first open Phantom:

  1. Click **Create New Wallet**
  2. Choose a strong password (you'll use this to unlock the wallet)
  3. Phantom will display your **Secret Recovery Phrase**—a list of 12 words

  <Warning>
    **Write down your recovery phrase on paper** and store it securely. Never share it with anyone. This phrase is the only way to recover your wallet if you lose access.
  </Warning>

  4. Confirm your recovery phrase by selecting words in the correct order
  5. Click **Finish**

  Your wallet is now created!

  ### Locate Your Wallet Address

  Your wallet address is a unique public identifier (like an email address for crypto):

  1. Open Phantom by clicking the extension icon
  2. Your wallet address appears at the top (e.g., `7XaBC...def9`)
  3. Click the address to copy it to your clipboard

  <Tip>
    You can share your wallet address publicly—it's safe. Others can use it to send you tokens. Your secret recovery phrase, however, must remain private.
  </Tip>
</Steps>

## Switch to Devnet

By default, Phantom connects to Solana **mainnet** (the real network). NullGraph uses **devnet** (a test network).

<Steps>
  ### Enable Developer Mode

  1. Open Phantom
  2. Click the **☰ menu** icon (top left)
  3. Select **Settings**
  4. Scroll down to **Developer Settings**
  5. Toggle **Developer Mode** to ON

  ### Switch Network

  1. Return to the main Phantom screen
  2. At the bottom, you'll see a network selector (default: **Mainnet**)
  3. Click it and select **Devnet**
  4. The network indicator at the bottom should now show **Devnet** (usually in orange)

  <Note>
    You need to stay on Devnet while using NullGraph. If transactions fail, check that you haven't accidentally switched back to Mainnet.
  </Note>
</Steps>

## Get Devnet SOL

**SOL** is Solana's native cryptocurrency, used to pay transaction fees. On devnet, SOL has no real-world value—you can get it for free.

<Steps>
  ### Use Solana's Public Faucet

  **Option 1: Web Faucet (Easiest)**

  1. Go to [faucet.solana.com](https://faucet.solana.com)
  2. Paste your Phantom wallet address
  3. Click **Confirm Airdrop**
  4. Wait 10-15 seconds
  5. Check your Phantom wallet—you should see **1-5 SOL**

  **Option 2: Discord Faucet (Backup)**

  1. Join the [Solana Discord](https://discord.gg/solana)
  2. Go to the `#faucet` channel
  3. Type: `/airdrop <your-wallet-address>`
  4. The bot will send you devnet SOL

  <Tip>
    You can request more devnet SOL anytime. If you run low, just return to the faucet.
  </Tip>

  ### Verify Your Balance

  Open Phantom and confirm you have at least **0.5 SOL**. This is enough for hundreds of transactions on NullGraph.
</Steps>

## Get Devnet BIO Tokens

BIO tokens are used for bounty rewards on NullGraph. On devnet, these are test tokens.

<Warning>
  Devnet BIO tokens are project-specific test tokens. You'll need to mint them yourself or receive them from the NullGraph team. Check the project's Discord or documentation for the BIO token mint address and distribution method.
</Warning>

<Steps>
  ### Option 1: Use a Test Token Faucet (if available)

  If NullGraph has deployed a token faucet:

  1. Visit the faucet URL (check NullGraph docs or Discord)
  2. Connect your Phantom wallet
  3. Click **Claim BIO Tokens**
  4. Approve the transaction in Phantom

  ### Option 2: Mint Tokens via CLI (Advanced)

  If you have the Solana CLI installed:

  ```bash theme={null}
  # Install Solana CLI (if not already installed)
  sh -c "$(curl -sSfL https://release.solana.com/stable/install)"

  # Configure for devnet
  solana config set --url devnet

  # Airdrop SOL to your wallet
  solana airdrop 2 <your-wallet-address>

  # Mint BIO tokens using the project's mint authority (requires init script)
  npx ts-node scripts/mint-bio-tokens.ts <your-wallet-address> 1000
  ```

  <Note>
    Token minting requires the mint authority's private key. Contact the NullGraph team for test BIO tokens if you're not running your own deployment.
  </Note>

  ### Verify BIO Balance

  1. Open Phantom
  2. Scroll down in your wallet
  3. You should see **BIO** listed as a token with your balance
  4. If it doesn't appear, manually add it:
     * Click **Manage Token List**
     * Click **Add Token**
     * Paste the BIO token mint address (from NullGraph docs)
     * Click **Add**
</Steps>

## Connect to NullGraph

<Steps>
  ### Visit the App

  1. Go to [nullgraph.vercel.app](https://nullgraph.vercel.app)
  2. You'll see the NullGraph landing page

  ### Connect Your Wallet

  1. Click **Connect Wallet** in the top right corner
  2. A modal will appear with wallet options
  3. Select **Phantom**
  4. Phantom will prompt: "Do you want to connect to this site?"
  5. Click **Connect**
  6. Grant permissions when prompted

  <Tip>
    NullGraph uses the Solana Wallet Adapter, which auto-connects on future visits. You won't need to connect manually every time.
  </Tip>

  ### Verify Connection

  Once connected:

  * Your wallet address appears in the top right (truncated, e.g., `7XaB...ef9`)
  * The "Connect Wallet" button becomes a wallet button with your balance
  * You can now interact with NullGraph
</Steps>

## Understanding Transaction Costs

Every interaction with NullGraph requires a small transaction fee in SOL:

| Action           | Cost (Approx.)                              | What You Pay For                           |
| ---------------- | ------------------------------------------- | ------------------------------------------ |
| Submit NKA       | 0.00001 SOL + 0.01 SOL rent                 | Transaction + account storage              |
| Create Bounty    | 0.00001 SOL + 0.01 SOL rent + reward amount | Transaction + vault storage + escrowed BIO |
| Submit to Bounty | 0.00001 SOL + 0.002 SOL rent                | Transaction + submission record            |
| Approve/Close    | 0.00001 SOL                                 | Transaction only                           |

**Rent**: Solana charges rent for data storage. If you close an account later, you get this SOL back.

**Total for 10 transactions**: \~0.15 SOL (plenty of buffer with 1-5 SOL from the faucet)

<Note>
  BIO tokens are only required for creating bounties (you escrow the reward amount). Submitting NKAs and claiming bounties doesn't require BIO—you **earn** BIO by claiming bounties.
</Note>

## Security Best Practices

**Protect Your Recovery Phrase**

* Never type it into a website or app
* Don't store it in email, cloud storage, or screenshots
* Don't share it with anyone—not even "support" teams

**Verify Connections**

* Always check the URL before connecting: `nullgraph.vercel.app`
* Phantom shows which site is requesting connection
* Disconnect from sites you don't recognize (Settings → Trusted Apps)

**Review Transactions**

* Phantom shows transaction details before you approve
* Check the program address matches NullGraph's program ID
* Don't approve transactions you don't understand

**Use Devnet for Testing**

* Devnet tokens have no real value
* Perfect for learning without financial risk
* Experiment freely!

<Warning>
  If you move to mainnet later, your devnet wallet address stays the same, but your balances are separate. Never send real SOL or tokens to a devnet address.
</Warning>

## Troubleshooting

**"Insufficient SOL for transaction fee" error**

You've run out of devnet SOL. Return to the [Solana faucet](https://faucet.solana.com) and request more.

**"Transaction rejected" or "User rejected the request"**

You clicked "Reject" in Phantom. Try the action again and click "Approve."

**BIO tokens don't appear in Phantom**

Manually add the token:

1. Open Phantom
2. Click **Manage Token List** → **Add Token**
3. Paste the BIO mint address
4. Click **Add**

**Phantom shows "Mainnet" at the bottom**

You're on the wrong network. Click the network selector and switch to **Devnet**.

**"Program error" or "Invalid account data" when submitting**

The NullGraph program might not be initialized. Contact the team or check the deployment status.

**Wallet won't connect to NullGraph**

Try these steps:

1. Refresh the NullGraph page
2. Disconnect Phantom (Settings → Trusted Apps → NullGraph → Remove)
3. Reconnect using the **Connect Wallet** button
4. Clear browser cache and try again

## Next Steps

Now that your wallet is set up:

<CardGroup cols={2}>
  <Card title="Submit Your First NKA" icon="flask" href="/guides/submitting-nka">
    Turn your null results into on-chain assets
  </Card>

  <Card title="Explore the Dashboard" icon="chart-mixed" href="/dashboard">
    Browse existing NKAs and protocol stats
  </Card>

  <Card title="Create a Bounty" icon="bullseye" href="/guides/creating-bounties">
    Post a bounty for the null result you need
  </Card>

  <Card title="Claim Bounties" icon="coins" href="/guides/claiming-bounties">
    Submit your NKAs to earn BIO tokens
  </Card>
</CardGroup>

## Common Questions

**Do I need a Phantom wallet specifically?**

No. NullGraph works with any Solana wallet (Solflare, Backpack, etc.). Phantom is recommended for beginners.

**Can I use a mobile wallet?**

Phantom has a mobile app, but NullGraph is optimized for desktop browsers. Mobile support may vary.

**Is devnet safe to use?**

Yes. Devnet is a separate test blockchain. No real money is involved. Your mainnet funds are not at risk.

**Can I switch between devnet and mainnet?**

Yes, but don't use NullGraph on mainnet unless you're interacting with a mainnet deployment. The program ID is different.

**What if I lose my recovery phrase?**

You lose access to your wallet permanently. There's no "forgot password" option in crypto. Always back up your recovery phrase.

**How do I get more devnet SOL?**

Use the [Solana faucet](https://faucet.solana.com) as many times as needed. It's free and unlimited.

**Can I send devnet tokens to someone else?**

Yes, but they also need to be on devnet. Devnet and mainnet are separate networks—tokens can't cross over.
