This document links all official TruthBounty repositories and clarifies their responsibilities.
TruthBounty is not a monorepo. Each repository is independently versioned, but all must conform to the canonical protocol defined in this repository.
Repository: truthbounty-api truthbounty-api
Purpose:
- Off-chain claim lifecycle management
- Verification aggregation
- Reputation scoring
- Evidence handling (IPFS)
- Blockchain event indexing
- Identity verification (Worldcoin ID)
Key Responsibilities:
- Compute reputation & confidence scores
- Enforce protocol rules off-chain
- Act as the source of truth for frontend data
- Submit finalized states to smart contracts
Repository: truthbounty-contracts truthbounty-contracts
Purpose:
- On-chain staking & slashing
- Reward distribution
- Reputation anchoring
- Dispute windows
- Economic enforcement
Key Responsibilities:
- Enforce economic guarantees
- Prevent dishonest participation
- Anchor critical protocol state
- Remain minimal, auditable, and gas-efficient
Repository: truthbounty-frontend truthbounty-frontend
Purpose:
- User interface for claims, verification, and reputation
- Wallet & identity flows
- Evidence review
- Reward claiming
Key Responsibilities:
- Reflect backend + contract state accurately
- Prevent invalid user actions
- Provide transparent UX for verification outcomes
All repositories MUST reference:
- This repository’s
README.mdREAD.md docs/protocol-spec.mddocs/architecture.md
If a PR conflicts with these documents, it must be revised or rejected.