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

# Claiming Bounties

> Learn how to submit your existing NKAs to open bounties and receive BIO token payouts when approved

Once you've [submitted a Null Knowledge Asset (NKA)](/guides/submitting-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.

<Note>
  You must own the NKA to submit it to a bounty. Only the wallet address that created the NKA can claim bounties with it.
</Note>

## Before You Start

Make sure you have:

* ✅ [Set up your Phantom wallet](/guides/wallet-setup) on Solana devnet
* ✅ [Submitted at least one NKA](/guides/submitting-nka)
* ✅ Connected your wallet to NullGraph
* ✅ A small amount of SOL for transaction fees (\~0.00001 SOL)

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

<Tip>
  The protocol fee is 2.5% by default. For a 10 BIO bounty, you'd receive 9.75 BIO upon approval.
</Tip>

## Finding Matching Bounties

<Steps>
  ### Navigate to the Market

  1. Open NullGraph at `https://nullgraph.vercel.app`
  2. Click **Market** in the navigation bar
  3. Browse the bounty cards displayed in a grid

  ### Identify Suitable Bounties

  Each bounty card shows:

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

  Look for bounties where:

  * Status is **Open** (green indicator)
  * Description matches your NKA's hypothesis or methodology
  * Deadline hasn't passed (though this is informational)

  ### Review Bounty Details

  1. Click on a bounty card to open the detail page
  2. Read the full description carefully
  3. Check the reward amount and deadline
  4. Review any existing submissions (if status is Matched)

  <Note>
    Currently, only the first submission changes a bounty to Matched status. Check if a bounty already has a pending submission before claiming.
  </Note>
</Steps>

## Submitting Your NKA to a Bounty

<Steps>
  ### Open the Submission Modal

  On the bounty detail page:

  1. Ensure the bounty status is **Open**
  2. Click the **Submit NKA** button
  3. A modal will appear with a list of your NKAs

  ### Select Your NKA

  The modal displays all NKAs you own with:

  * **Specimen Number**: e.g., `NKA-0042`
  * **Hypothesis**: First few words of your hypothesis
  * **Created Date**: When you submitted it

  Select the NKA that best matches the bounty requirements.

  <Tip>
    If you don't see any NKAs in the list, you need to [submit an NKA](/guides/submitting-nka) first.
  </Tip>

  ### Confirm Submission

  1. Click **Submit to Bounty** in the modal
  2. Phantom wallet will prompt you to approve the transaction
  3. 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
  4. Click **Approve** in Phantom
  5. Wait for confirmation (1-2 seconds on devnet)

  <Warning>
    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.
  </Warning>
</Steps>

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

<Tip>
  There's no penalty for having a submission closed. Your NKA remains valid and can be submitted to other bounties.
</Tip>

## 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](/guides/wallet-setup) 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

<CardGroup cols={2}>
  <Card title="Submit More NKAs" icon="flask" href="/guides/submitting-nka">
    Create more NKAs to claim more bounties
  </Card>

  <Card title="Browse Market" icon="magnifying-glass" href="/market">
    Find more open bounties
  </Card>
</CardGroup>