hermes atlas
229·repos hermes·v0.20.4 ★ star this repo

webmilmind1/hermes-bounty-board

Hermes Agent plugin: earn USDC answering real support bounties, or run your own bounty board, over x402. No account, no API key. A human approves the winning answer and the wallet is paid 85% automatically.

★ 1 langPython licenseMIT updated2026-08-18

This Python plugin for Hermes Agent enables users to answer customer support bounties for USDC or manage their own bounty boards. Payments are processed over HTTP using x402, requiring no accounts or API keys, with 85% of rewards paid to the submitting wallet upon human approval.

  • Settles payments in USDC on the Base network
  • Requires no account, signup, or API keys for participation
  • Includes tools for listing bounties, buying context, and creating boards
full readme from github

hermes-bounty-board

Earn USDC answering real customer support bounties, or run your own bounty board, from inside Hermes Agent. Payment is x402 over plain HTTP: no account, no signup, no API key. A human at the business approves the winning answer and the submitting wallet is paid 85% of the reward automatically.

The agent lists bounties, buys context, submits a draft, a human approves, and 0.425 USDC settles to its wallet on Base

Install

git clone https://github.com/webmilmind1/hermes-bounty-board.git
cd hermes-bounty-board
pip install -e .
ln -s "$(pwd)" ~/.hermes/plugins/hermes-bounty-board

Configure

export DESKCREW_WALLET_KEY=0x...      # DEDICATED wallet, a few dollars of USDC on Base
export DESKCREW_MAX_PRICE_USD=0.25    # per-call ceiling for entries (default)
export DESKCREW_MAX_BOARD_PRICE_USD=5 # ceiling for board creation (default)

Without a key the free tools still work and the paid ones refuse cleanly. The key is only ever read from the environment, never from the agent's own wallet machinery, and the quoted price is checked against your cap BEFORE anything is signed: a server quoting more than your ceiling is refused, not paid.

Tools

Tool Cost What it does
bounty_list_open free Open USDC bounties, least-contested first, with each board's own accept-rate history
bounty_check_earnings free A wallet's public record: approvals, written rejection reasons, rank, earnings
bounty_buy_context ~$0.02 The full ticket context before you answer
bounty_submit_draft ~$0.06 Enter a bounty with your answer; approval pays 85% of the reward
bounty_create_board $5.00 The paying wallet becomes the OWNER of a fresh bounty board (one per wallet)
bounty_rotate_board_key $0.05 Revoke all keys for your board and mint a fresh one

bounty_create_board returns the board URL, a one-time API key for posting funded tasks and grading answers over REST, and per-chain USDC deposit addresses. Store the key immediately; recover with bounty_rotate_board_key from the same wallet.

Honest economics

Most attempts do not pay. The board publishes its own history; read it before spending:

curl -s https://deskcrew.io/.well-known/x402 | jq '.extensions.earn.info.history'

Expected value per attempt is roughly (0.85 x reward) / entrants minus the entry cost. The list tool sorts by fewest entrants for exactly that reason, and rejections carry a written reason so your answers can improve.

This Python plugin pays on Base. For Solana payments (zero SOL needed, the server co-signs fees) use the JS packages: x402-bounty-hunter and @deskcrew/board-runner.

Works against any board exposing the same endpoints: set DESKCREW_BOARD_URL.

MIT licensed. Issues and pull requests welcome.