Quickstart Guide

Submit your first Null Knowledge Asset and create a bounty in minutes

This guide walks you through the core workflows of NullGraph: submitting a Null Knowledge Asset (NKA) and creating a bounty.

Prerequisites

Before starting, ensure you have:

• Completed the Setup guide
• Connected Phantom wallet set to Devnet
• NullGraph frontend running at http://localhost:5173
• Some devnet SOL in your wallet for transaction fees

You can get devnet SOL from the Solana Faucet or by running:

solana airdrop 1 --url devnet

Submit Your First NKA

Null Knowledge Assets (NKAs) are on-chain records of negative scientific results. Each NKA is stored as a permanent PDA on Solana.

How It Works

When you submit an NKA, the frontend:

1. Fetches the current nka_counter from ProtocolState
2. Derives the NullResult PDA using seeds: ["null_result", researcher_pubkey, specimen_number]
3. Calls submit_null_result instruction with all metadata
4. Increments the global counter
5. Emits NullResultSubmitted event

Frontend Hook (useSubmitNullResult.ts)

const [protocolStatePDA] = findProtocolStatePDA();
const state = await program.account.protocolState.fetch(protocolStatePDA);
const nextSpecimen = state.nkaCounter.toNumber() + 1;
const [nullResultPDA] = findNullResultPDA(publicKey, nextSpecimen);

const tx = await program.methods
  .submitNullResult(
    hypothesis,
    methodology,
    expectedOutcome,
    actualOutcome,
    pValue,
    sampleSize,
    dataHash
  )
  .accountsPartial({
    researcher: publicKey,
    protocolState: protocolStatePDA,
    nullResult: nullResultPDA,
    systemProgram: SystemProgram.programId,
  })
  .rpc();

Create a Bounty

Bounties allow researchers and BioDAOs to pay for specific null results. When you create a bounty, BIO tokens are escrowed into a vault PDA until the bounty is fulfilled or closed.

How It Works

Frontend Hook (useCreateBounty.ts)

const [protocolStatePDA] = findProtocolStatePDA();
const state = await program.account.protocolState.fetch(protocolStatePDA);
const nextBounty = state.bountyCounter.toNumber() + 1;
const [bountyPDA] = findBountyPDA(publicKey, nextBounty);
const [vaultPDA] = findVaultPDA(bountyPDA);
const creatorBioAta = await getAssociatedTokenAddress(BIO_MINT, publicKey);

const tx = await program.methods
  .createBounty(
    description,
    new BN(rewardAmount),
    new BN(deadline)
  )
  .accountsPartial({
    creator: publicKey,
    protocolState: protocolStatePDA,
    bounty: bountyPDA,
    vault: vaultPDA,
    creatorUsdcAta: creatorBioAta,
    usdcMint: BIO_MINT,
    tokenProgram: TOKEN_PROGRAM_ID,
    associatedTokenProgram: ASSOCIATED_TOKEN_PROGRAM_ID,
    systemProgram: SystemProgram.programId,
  })
  .rpc();

Submit to a Bounty

If you have an NKA that matches a bounty’s requirements, you can submit it for review.

View Your NKAs

All submitted NKAs are browsable on the Dashboard. Click an NKA card to view full details including:

• Specimen number (e.g., NKA-0042)
• Researcher public key
• Full hypothesis, methodology, outcomes
• P-value and sample size
• Data hash (if provided)
• Timestamp and status
• Solana Explorer link

Protocol Fee Structure

When a bounty is fulfilled:

• Researcher payout: 97.5% of reward amount
• Protocol fee: 2.5% (250 basis points)
• Fee recipient: Treasury wallet (set during protocol initialization)

Example for 500 BIO bounty:

• Researcher receives: 487.5 BIO
• Treasury receives: 12.5 BIO

Account Structure

NullGraph uses four main account types, all stored as PDAs:

Account	Seeds	Description
ProtocolState	["protocol_state"]	Singleton with counters, fee rate, treasury
NullResult	["null_result", researcher, specimen_number]	One per NKA
NullBounty	["null_bounty", creator, bounty_number]	One per bounty
BountySubmission	["bounty_submission", bounty, null_result]	Links NKA to bounty
Vault	["bounty_vault", bounty_pda]	Token account holding escrowed BIO

Common Workflows

Researcher Journey

1. Connect wallet (devnet)
2. Submit NKA with negative result data
3. Browse Market for matching bounties
4. Submit NKA to bounty
5. Receive BIO payout upon approval

BioDAO Journey

1. Connect wallet (devnet)
2. Acquire BIO tokens
3. Create bounty describing needed null result
4. BIO tokens escrowed to vault
5. Review submissions from researchers
6. Approve matching submission (triggers payout)
7. Or close bounty (reclaim escrowed BIO)

Next Steps

• Explore Core Concepts to understand NKAs in depth
• Learn about the Bounty Marketplace
• Review API Reference for all program instructions
• Check Frontend Integration for custom integrations

NullGraph is currently deployed to Solana Devnet. All transactions use test tokens and devnet SOL. No real value is at risk.