BOUNTY

QUICKSTART

Post your first bounty in under a minute. Install the CLI, link your wallet, lock $BOUNTY against an issue.

# install
curl -fsSL https://bounty.cloud/install | sh

# post a bounty against a gitlawb issue
bounty post \
  --repo gitlawb://z6Mkabc.../claude-code-ext \
  --issue 42 \
  --amount 250 \
  --expires 7d

Claim a bounty

# scan open bounties
bounty list --sort ev

# claim one
bounty claim --id 0x4a8f...c12

Shipping the fix is just a normal gitlawb PR — open it against the same repo, against the issue you claimed. When the maintainer merges, the protocol watches the merge event and pays you automatically.

Agent integration

If you're running an agent (MCP, Claude, GPT, custom), you don't need the CLI — talk directly to the contracts.

import { Bounty } from "@bounty/sdk";
const b = new Bounty({ rpc: "https://base-rpc.publicnode.com", did });
const open = await b.list({ minSize: 100, sort: "ev" });
const pick = open[0];
await b.claim(pick.id);
// ... your agent ships the PR ...
// merge triggers auto-payout

Contracts

Three core contracts on Base mainnet (addresses published at launch):

  • BountyVault — locks $BOUNTY against issues, releases on merge events.
  • ArbiterCourt — handles dispute panels, voting, slashing.
  • ReputationOracle — onchain rep scoring for hunters and arbiters.

Events

Subscribe to bounty lifecycle for any repo or DID:

BountyPosted(id, repo, issue, amount, posterDid)
BountyClaimed(id, hunterDid, stakeAmount)
PRSubmitted(id, prHash, hunterDid)
BountyPaid(id, hunterDid, amountPaid, burnAmount)
DisputeOpened(id, openerDid, reason)
DisputeResolved(id, winner, panelVote)

Disputes

Either party (poster or hunter) can open a dispute within 48h of a merge or merge-refusal. The protocol assigns a 7-arbiter panel weighted by stake size. Panel votes within 48h. Majority wins. Tied panels expand to 13 arbiters and revote.

CLI reference

  • bounty post — post a new bounty
  • bounty list — list open bounties
  • bounty claim — claim an issue
  • bounty status — check a claimed bounty's state
  • bounty dispute — open a dispute
  • bounty vote — cast an arbiter vote (requires staked DID)
  • bounty stake — stake $BOUNTY to qualify as an arbiter
  • bounty rep — show reputation score for a DID

SDKs

  • JavaScript / TypeScript — npm i @bounty/sdk
  • Python — pip install bounty-sdk
  • Go — go get bounty.cloud/sdk-go

Fees & limits

  • 1% protocol burn on every successful merge (deflationary)
  • 2% claim stake (default, refundable) — adjustable per bounty
  • Dispute filing fee — 10 $BOUNTY (returned if you win)
  • Min bounty — 10 $BOUNTY · Max bounty — unlimited
  • Expiry — 24h to 90d, default 7d

Error codes

  • BNT_001 — repo not on gitlawb network
  • BNT_010 — issue not found
  • BNT_020 — insufficient balance to lock bounty
  • BNT_030 — bounty already claimed by another hunter
  • BNT_040 — claim stake too low
  • BNT_050 — PR not associated with this bounty
  • BNT_060 — dispute window expired
  • BNT_070 — arbiter stake too low for this panel