Setup

Step-by-step installation and configuration of NullGraph

This guide walks you through building, deploying, and running NullGraph locally.

Installation

Build and Deploy

Run the Frontend

Configuration

Environment Variables

The frontend accepts optional environment variables. Create app/.env if you need custom configuration:

# Optional: Custom RPC endpoint
VITE_RPC_URL=https://api.devnet.solana.com

# Optional: Custom program ID (if you deployed your own)
VITE_PROGRAM_ID=2u3DXQq9A6UgMryeVSWCNdYLy3Fjh391R5hcfWYkCgZK

Update IDL After Program Changes

If you modify the Anchor program, rebuild and sync the IDL to the frontend:

# Rebuild the program
anchor build

# Copy IDL and types to frontend
cp target/idl/nullgraph.json app/src/lib/nullgraph.json
cp target/types/nullgraph.ts app/src/lib/nullgraph_types.ts

Testing

Run Anchor Tests

Test the program using the Anchor test suite:

# Run against local validator (auto-starts/stops)
anchor test

# Run against existing devnet deployment
anchor test --skip-local-validator --provider.cluster devnet

The test suite (tests/nullgraph.ts) covers:

• Protocol initialization
• NKA submission and counter increment
• Bounty creation with BIO escrow
• Bounty submissions and approvals
• Fee calculation and distribution
• Error cases (invalid status, duplicate init, etc.)

Architecture Overview

NullGraph runs entirely on Solana with no backend server:

React Frontend (Vite)
       |
       v
  Wallet Adapter
       |
       v
 Solana Devnet RPC
       |
       v
NullGraph Program (Anchor)
  - ProtocolState PDA
  - NullResult PDAs (NKAs)
  - NullBounty PDAs
  - BountySubmission PDAs
  - Vault Token Accounts

Key Components:

• Program ID: 2u3DXQq9A6UgMryeVSWCNdYLy3Fjh391R5hcfWYkCgZK
• BIO Token Mint: GkjGV1ZF5BsMs6oAvk8jZiuXM8KwuygFCHLBpqR5Q14j
• RPC Endpoint: https://api.devnet.solana.com
• Network: Solana Devnet

Troubleshooting

Build Errors

Error: anchor: command not found

Solution: Ensure Anchor CLI is installed and in your PATH:

anchor --version

Error: failed to get recent blockhash: FetchError

Solution: Check your internet connection and verify Solana CLI config:

solana config get

Deployment Errors

Error: Insufficient SOL balance

Solution: Airdrop devnet SOL:

solana airdrop 2 --url devnet

Error: Transaction simulation failed

Solution: The program may already be deployed. Check the program account:

solana program show 2u3DXQq9A6UgMryeVSWCNdYLy3Fjh391R5hcfWYkCgZK --url devnet

Frontend Errors

Error: Failed to connect to wallet

Solution: Ensure Phantom is installed, unlocked, and set to Devnet.

Error: Program account does not exist

Solution: Deploy the program or use the existing devnet deployment.

Next Steps

Now that NullGraph is running, proceed to the Quickstart Guide to submit your first NKA and create a bounty.