Everything you need to run trustless bounties.

Introduction

What is BountyFlow?

BountyFlow is an on-chain bounty platform. Someone posts a quest — a concrete on-chain action like a set of swaps, a hold period, or a staking position — and locks the reward in escrow. A hunter completes the action from their own wallet. The chain confirms it, and the reward releases automatically. No screenshots, no forms, no moderator approval.

Every other bounty board stops at "submit your proof and wait." BountyFlow removes the wait and the human in the loop: the on-chain record is the proof, and a verifier reads it directly through an indexer.

Motivation

Why BountyFlow exists

Quest and bounty platforms — Hivemind, BountyPool, BountyCraft and the rest — all share the same gap: someone has to manually verify that the work was done. That means uploading a screenshot, filling a form, and waiting for a reviewer to approve it. It is slow, gameable, and entirely trust-dependent: the hunter hopes they get paid, the poster hopes the hunter was honest.

For on-chain actions, that manual step is unnecessary. A swap, a hold, a stake — they all leave a permanent, public record. BountyFlow reads that record and settles against it. The result is the one thing the others can't offer: trustless verification.

Fundamentals

Core concepts

Four primitives make up the whole system. Understand these and the rest follows.

End to end

The quest lifecycle

From posting to payout, every quest follows the same five stages.

1. Create & fundCreator defines the action, deadline, and reward, then funds the escrow. The quest is now live and discoverable.
2. AcceptA hunter connects a wallet and accepts the quest. The wallet address is bound to the quest as the address that will be checked.
3. PerformThe hunter completes the on-chain action on the protocols they already use — Jupiter, a token, an LP pool.
4. VerifyThe verifier reads the wallet's activity through an indexer and evaluates the conditions continuously.
5. SettleConditions met → the escrow contract releases the reward automatically. The quest closes.

Bounty Types

What you can post

BountyFlow ships with three verifiable quest families. Each maps to a class of on-chain action the verifier knows how to read deterministically.

Bounty Types · Swap

Swap quests

Reward hunters for routing volume through a DEX. The verifier counts qualifying swaps from the bound wallet within the time window. Partial fills count toward the target.

Example

"Make 10 swaps on Jupiter in a week → 0.5 SOL." The hunter routes any 10 swaps through Jupiter within 7 days of accepting. On the 10th confirmed swap, the escrow releases 0.5 SOL.

Configuration

{
  "type": "swap",
  "venue": "jupiter",
  "count": 10,
  "window": "7d",
  "minNotionalUsd": 5,   // ignore dust swaps
  "reward": { "asset": "SOL", "amount": 0.5 }
}

Bounty Types · Hold

Hold quests

Reward conviction. The hunter must keep a minimum balance of a token in the bound wallet for a continuous duration. The verifier watches the balance — sell below the threshold and the quest resets or fails, depending on the rule.

Example

"Hold this token for 30 days → 0.2 SOL." Keep the token in your wallet for 30 continuous days. The indexer tracks the balance, not a moderator. After the 30th day with the balance intact, 0.2 SOL releases.

Bounty Types · Stake / LP

Stake / LP quests

Reward providing liquidity or staking. The hunter enters a position and stays in through a defined on-chain event — most commonly the pool's first rebalance after entry. The verifier detects the position and the event.

Example

"Stake in this pool → 0.1 SOL after first rebalance." Provide liquidity and remain staked through the pool's next rebalance. Once that rebalance event is observed on-chain with the position still active, the payout releases.

Mechanics

Trustless verification

Verification is the heart of BountyFlow. Instead of trusting a submission, the verifier subscribes to the bound wallet's activity through an indexer and evaluates the quest's conditions against the raw on-chain history.

• Deterministic — given the same chain state, every evaluation returns the same result. No discretion, no disputes.
• Continuous — conditions are re-checked as new blocks land, so time-based quests (holds, durations) resolve exactly when they should.
• Sybil-aware — quests bind to the accepting wallet; spreading activity across wallets doesn't satisfy a single quest.
• Auditable — anyone can replay the same indexer reads and arrive at the same settle decision.

What the verifier reads

Mechanics

Settlement & payouts

When the verifier marks a quest's conditions as satisfied, it submits the settle instruction to the escrow contract. The contract verifies the proof and transfers the reward to the hunter's wallet in the same transaction.

1. Conditions metThe verifier flips the quest to SETTLEABLE the instant the on-chain criteria are satisfied.
2. Settle instructionThe escrow program checks the verifier's attestation against the quest rules stored at creation.
3. ReleaseIf valid, the reward transfers to the hunter. The quest moves to SETTLED and is closed.

Mechanics

Fees

BountyFlow charges a small protocol fee on settled rewards. Posting and accepting are free; you only ever pay network gas plus the protocol fee on a successful settle. Expired, unmet quests are refunded in full minus network gas.

Mechanics

Security & trust model

The escrow contract is the only component that moves funds, and it only releases against rules fixed at creation time. The verifier can attest that conditions are met, but it cannot change a quest's terms or redirect a payout.

• Funds are escrowed, not custodied — rewards sit in a program-owned account, released only by the settle path.
• Rules are immutable post-funding — a creator can't move the goalposts after a hunter accepts.
• Connect-only auth — you sign to prove wallet ownership; BountyFlow never asks for private keys or token approvals beyond what a quest needs.
• Replayable settlement — every settle decision can be independently reproduced from public chain data.

Guides

For hunters

Earning a bounty takes three actions and zero paperwork.

1. Connect your walletOpen the app and connect. You're signing to prove ownership — nothing is moved.
2. Pick a quest and acceptBrowse live quests, read the conditions and reward, and accept. Your wallet becomes the bound address.
3. Do the action and get paidComplete the swap, hold, or stake from your wallet. When the chain confirms, the reward lands automatically.

Browse live example bounties →

Guides

For creators

Posting a bounty means defining a checkable action and funding the prize.

1. Define the actionChoose a type — swap, hold, or stake — and set the parameters (count, duration, venue, thresholds).
2. Set the reward and deadlinePick the payout amount and the window in which hunters can complete it.
3. Fund the escrowLock the reward in the contract. The quest goes live and discoverable the moment it's funded.
4. Let it settle itselfNo reviewing submissions. Met quests pay out automatically; expired ones refund you.

Guides

API & webhooks

Read quest state and subscribe to settlement events programmatically. The public read API requires no auth; webhooks let your backend react the moment a quest settles.

Fetch a quest

# Read a quest's live status
curl https://api.bountyflow.xyz/v1/quests/QUEST_ID

Subscribe to settlements

{
  "event": "quest.settled",
  "questId": "q_8f2a…",
  "wallet": "7xKX…9fQ",
  "reward": { "asset": "SOL", "amount": 0.5 },
  "txSignature": "3Vn…"
}

Reference

Frequently asked questions

Reference

Glossary