Skip to main content
Once you’ve submitted a Null Knowledge Asset (NKA), you can browse the bounty marketplace and submit your NKA to any matching bounty. If the bounty creator approves your submission, you’ll receive an automatic BIO token payout.
You must own the NKA to submit it to a bounty. Only the wallet address that created the NKA can claim bounties with it.

Before You Start

Make sure you have:

How Bounty Claims Work

  1. Browse: Find an open bounty that matches your NKA
  2. Submit: Link your NKA to the bounty via an on-chain transaction
  3. Wait: The bounty creator reviews your NKA
  4. Get Paid: If approved, you receive (reward × 0.975) BIO tokens automatically
  5. Move On: If rejected or closed, your NKA remains available for other bounties
The protocol fee is 2.5% by default. For a 10 BIO bounty, you’d receive 9.75 BIO upon approval.

Finding Matching Bounties

2
  • Open NullGraph at https://nullgraph.vercel.app
  • Click Market in the navigation bar
  • Browse the bounty cards displayed in a grid
  • 3
    Identify Suitable Bounties
    4
    Each bounty card shows:
    5
  • Bounty Number: e.g., NB-0003
  • Description: What null result the creator is looking for
  • Reward: BIO token amount
  • Deadline: When the bounty expires
  • Status: Open, Matched, Fulfilled, or Closed
  • 6
    Look for bounties where:
    7
  • Status is Open (green indicator)
  • Description matches your NKA’s hypothesis or methodology
  • Deadline hasn’t passed (though this is informational)
  • 8
    Review Bounty Details
    9
  • Click on a bounty card to open the detail page
  • Read the full description carefully
  • Check the reward amount and deadline
  • Review any existing submissions (if status is Matched)
  • 10
    Currently, only the first submission changes a bounty to Matched status. Check if a bounty already has a pending submission before claiming.

    Submitting Your NKA to a Bounty

    1
    Open the Submission Modal
    2
    On the bounty detail page:
    3
  • Ensure the bounty status is Open
  • Click the Submit NKA button
  • A modal will appear with a list of your NKAs
  • 4
    Select Your NKA
    5
    The modal displays all NKAs you own with:
    6
  • Specimen Number: e.g., NKA-0042
  • Hypothesis: First few words of your hypothesis
  • Created Date: When you submitted it
  • 7
    Select the NKA that best matches the bounty requirements.
    8
    If you don’t see any NKAs in the list, you need to submit an NKA first.
    9
    Confirm Submission
    10
  • Click Submit to Bounty in the modal
  • Phantom wallet will prompt you to approve the transaction
  • Review the transaction details:
    • Program: NullGraph Anchor Program
    • Accounts: BountySubmission PDA, NullResult PDA, NullBounty PDA
    • Cost: ~0.00001 SOL transaction fee + ~0.002 SOL rent
  • Click Approve in Phantom
  • Wait for confirmation (1-2 seconds on devnet)
  • 11
    Once you submit, your NKA is locked to this bounty until the creator approves or closes it. You cannot submit the same NKA to multiple bounties simultaneously.

    After Submission

    Once your transaction confirms:
    1. A BountySubmission PDA is created linking your NKA to the bounty
    2. The bounty status changes to Matched
    3. Your submission appears on the bounty detail page
    4. The bounty creator receives a notification to review
    5. You wait for the creator to approve or close the bounty
    Submission Status
    • Pending (0): Waiting for creator review (initial status)
    • Approved (1): Creator approved, payout sent
    • Rejected (2): Creator closed without approving (future feature)

    What Happens Next?

    Scenario 1: Your Submission Gets Approved ✅

    When the bounty creator approves your submission:
    1. The NullGraph program calculates:
      • Your Payout: reward_amount × (1 - 0.025) = 97.5% of reward
      • Protocol Fee: reward_amount × 0.025 = 2.5% of reward
    2. Both transfers execute automatically via CPI (Cross-Program Invocation):
      • Your payout goes to your associated BIO token account
      • The fee goes to the protocol treasury
    3. The vault account closes (balance goes to zero)
    4. The bounty status becomes Fulfilled
    5. Your BountySubmission status becomes Approved
    6. You can check your wallet—the BIO tokens are now yours!
    Timeline: Instant. Once the creator clicks “Approve”, the payout happens in the same transaction (1-2 seconds).

    Scenario 2: The Bounty Gets Closed ❌

    If the creator closes the bounty without approving:
    1. The full reward amount returns to the creator’s wallet
    2. The bounty status becomes Closed
    3. Your BountySubmission PDA remains on-chain but is no longer active
    4. Your NKA is freed up—you can submit it to other bounties
    5. You don’t receive any payment
    Why might this happen?
    • Your NKA didn’t match the requirements closely enough
    • The creator found a better submission
    • The deadline passed without a suitable match
    • The creator changed their mind
    There’s no penalty for having a submission closed. Your NKA remains valid and can be submitted to other bounties.

    Understanding the Payout

    Example Calculation Bounty reward: 10 BIO
    • Protocol fee (2.5%): 10 × 0.025 = 0.25 BIO → Treasury
    • Your payout (97.5%): 10 × 0.975 = 9.75 BIO → Your Wallet
    On-Chain Process
    Bounty Vault (10 BIO)
    
      ├─→ Your Wallet (9.75 BIO)
      └─→ Treasury (0.25 BIO)
    
    The transfer uses SPL Token Interface transfer_checked, which validates:
    • Token mint address matches BIO
    • Decimal precision is correct (6 decimals)
    • Vault has sufficient balance
    • Signer seeds are correct (vault PDA authority)

    Viewing Your Claims

    Check Your Submission Status
    1. Navigate to the bounty detail page
    2. Find your submission in the list
    3. Status indicators:
      • 🟡 Pending: Awaiting review
      • 🟢 Approved: Payout sent
      • 🔴 Rejected/Closed: Not approved
    Check Your BIO Balance
    1. Open Phantom wallet
    2. Switch to Solana devnet
    3. Look for BIO token in your token list
    4. Balance should reflect your payout
    Verify on Solana Explorer
    1. Copy your wallet address from Phantom
    2. Go to https://explorer.solana.com/?cluster=devnet
    3. Paste your address and search
    4. View your token accounts and transaction history
    5. Look for the transfer_checked transaction from the vault

    Common Questions

    Can I submit one NKA to multiple bounties? No. Once you submit an NKA to a bounty, it’s locked until the bounty is fulfilled or closed. This prevents double-claiming. What if my submission isn’t approved? Your NKA remains on-chain and can be submitted to other bounties. There’s no penalty for unsuccessful claims. How long does it take to get paid? Payout is instant—it happens in the same transaction when the creator clicks “Approve” (1-2 seconds on devnet). Can I cancel a submission after submitting? No. Once submitted, only the bounty creator can approve or close the bounty. You cannot withdraw your submission. What if the creator never reviews my submission? If the bounty remains in Matched status indefinitely, your NKA stays locked to that bounty. Future versions may include timeout mechanisms. Can I submit someone else’s NKA to a bounty? No. The program checks that the NKA’s researcher field matches the transaction signer (your wallet). Only the NKA owner can submit it. What happens to the BountySubmission PDA after approval? It remains on-chain as a permanent record of the claim. The status updates to Approved, but the account isn’t closed. How do I know which NKAs I own? Your NKAs are PDAs derived from your wallet address. The dashboard filters NKAs by the connected wallet, showing only yours.

    Maximizing Your Bounty Claims

    Match Requirements Carefully
    • Read the full bounty description before submitting
    • Ensure your hypothesis, methodology, and outcomes align
    • Check if p-values or sample sizes are expected
    Submit High-Quality NKAs
    • Complete all fields thoroughly during submission
    • Include data hashes when possible
    • Use clear, specific language in your outcomes
    Act Quickly
    • Browse the Market page regularly for new bounties
    • Submit to Open bounties before others do
    • Set up notifications (future feature)
    Diversify Your NKAs
    • Submit NKAs across different domains and methodologies
    • The more variety you have, the more bounties you can match

    Troubleshooting

    “Bounty is not Open” Error The bounty status changed to Matched, Fulfilled, or Closed before you submitted. Check the bounty status on the detail page. “Invalid Researcher” Error You’re trying to submit an NKA you don’t own. Make sure you’re connected with the wallet that created the NKA. “Insufficient SOL” Error You don’t have enough SOL for the transaction fee. Get devnet SOL from a faucet. Phantom Doesn’t Show BIO Tokens The BIO token might not be auto-detected. Manually add the token using the BIO mint address: [check constants.ts for actual address].

    Next Steps

    Submit More NKAs

    Create more NKAs to claim more bounties

    Browse Market

    Find more open bounties

    Build docs developers (and LLMs) love