Bona Fide Install

AI made pull requests free to open. Reviewing them still costs you hours.

Don't turn off pull requests. Ask for good faith.

# .github/bona-fide.yml
maintainer: 0xYourWallet   # signs verdicts; never paid
amount: 1                  # USDC
forfeit: 50%               # never more
timeout: 7 days

Contributors and AI agents you don't know yet back their PR with a small refundable Deposit. Good work gets it all back. Bona Fide takes nothing, and nobody profits from a rejection.

Built on

Certificate of good faith

This pull request came from someone the repo didn't know yet, who backed it with a refundable Deposit. Witnessed as follows.

Fix race in cache invalidation

acme/parser · @first-time-contributor · first PR here

  • Deposit held
  • Claude: good faith
  • Checks green
  • Merged by Maintainer

Deposit returned in full · recorded on Arc

Pull request

#482

Bona Fide

An example certificate, for illustration: the PR, the repo and the numbers on it are made up.

How it works

How a PR earns its certificate.

  1. Someone new opens a PR

    The Bona Fide check asks for a Deposit, 1 USDC by default. People you already trust are never asked.

  2. They sign once

    No gas, no second step. The check turns green in seconds.

  3. Claude reads it

    A short note for the Maintainer: looks like good work, or a drafted bad-faith verdict to review.

  4. The Maintainer decides

    Merge it, and the Deposit goes straight back. The certificate is stamped.

The one rule

Nobody can profit from a rejection.

Not the Maintainer, not the bot, not us. An immutable escrow on Arc holds every Deposit and can pay only two places: back to the Contributor, or to open-source maintainers through Protocol Guild. No owner, no upgrade, no pause.

Collaborators, vouched Contributors, past contributors and allowed bots never pay. Maintainers can waive any item with a label.

  1. §1 Merged, approved or accepted 100% back
  2. §2 Nobody decides within 7 days by default. Anyone can send it back. 100% back
  3. §3 Bad faith, signed by the Maintainer's own wallet. The rest funds open-source maintainers (Protocol Guild). 50%+ back
  4. §4 What Bona Fide keeps, whatever happens. The Maintainer gets nothing either. 0%

The agent

Claude can say no. It can never pay or punish.

Claude reads every PR and issue that holds a Deposit and makes real calls: what looks like good work, what looks like bad faith, which Record Exemptions to hold back, and whether a merged PR really resolves the issue a Bounty was posted on. Money moves only on witnesses outside the model.

Claude's calls

  • Triagedlooks like good work
  • Verdict draftedreasons for the Maintainer
  • Exemption heldrecord looks gamed
  • Bounty helddoesn't resolve the issue
  • Bounty clearedthe PR resolves its issue

A Bounty is USDC a Maintainer posts on an issue, from the repo's Bounty wallet. Once the PR that closes it is merged with checks green and Claude clears it, the Keeper pays within the wallet's limits. Above them, the Maintainer signs.

Witnesses · the only things that move money

  • Merged on GitHub
  • Checks green
  • 7-day Timeout
  • Maintainer's signature
  • Within the Bounty wallet's limits

What each decision log entry records

Item
the PR or issue, and when
Read
what Claude was given to read
Claude
its suggestion, with its reasons
Checked
the witnesses: merged, checks green, the Timeout
Done
what Bona Fide did, and its transaction

Every call, on the record.

Each repo's page shows what Claude read, what it decided, what was checked and the transaction.

See a repo's decision log

Your own agent can be the Contributor: with the MCP server it reads a repo's terms and signs its own Deposit, under a limit you set.

Add the MCP server

Arc

On the record, on Arc.

Your browser reads these numbers from Arc itself, through Arc's public RPC and block explorer. No Bona Fide server in between.

Deposits: PRs and issues backed
—
Refunded in full
—
Forfeited
—
USDC waiting in the forfeit router for Protocol Guild
—

For AI agents

Repos that turn agents away can let yours in.

Add the MCP server. Your agent reads a repo's terms and signs its own Deposit, under a limit you set: 5 USDC by default. The server never holds keys.

Read the agent guide
claude mcp add bona-fide \
  -e ESCROW_ADDRESS=0xe2fe798427CFb43134FC37F6EE054c2da818fAc9 \
  -e RPC_URL=https://rpc.mainnet.arc.io \
  -e APP_URL=https://bofi.live \
  -e MAX_DEPOSIT_USDC=5 \
  -- node /path/to/bona-fide/agent/src/main.ts

Questions

Is this crypto?

It uses USDC, a digital dollar, on Arc. There's no token and nothing to trade or farm.

What does it cost?

Nothing. Good-faith work gets the whole Deposit back, and Bona Fide takes no fee, not even from a Forfeit.

Who gets the money from a Forfeit?

Never Bona Fide, and never the Maintainer. At least half goes back to the Contributor, and the rest funds open-source maintainers through Protocol Guild. The escrow can't pay anyone else.

What if a Maintainer is malicious?

They can forfeit at most half, only with their own wallet's signature, only before the Timeout, and never to themselves.

Does an AI judge my PR?

Claude writes a note for the Maintainer. It can hold things back; it can never forfeit, refund or pay on its own. A person signs every Forfeit.

How do I get USDC?

You need USDC on Arc and nothing else: on Arc, gas is paid in USDC too. Agents use a Circle agent wallet through the MCP server.

What happens at the Timeout?

The Deposit goes back in full. Bona Fide sends it, and anyone else can too.

Keep the door open.

  1. Install the App on a repo.
  2. Commit .github/bona-fide.yml with your wallet.
  3. Sign once. Deposits start 1 hour later.
# .github/bona-fide.yml
maintainer: 0xYourWallet   # signs verdicts; never paid
amount: 1                  # USDC
forfeit: 50%               # never more
timeout: 7 days