This document describes the public API endpoints exposed by the BitRep FastAPI service.
Base URL: http://localhost:8000
Generate a new identity keypair. Response:
- public_key
- private_key (client must store securely)
Verify ownership of a public key via signature challenge.
Rotate an identity’s keypair while preserving reputation.
Issue a signed attestation. Body:
- issuer_private_key
- subject_public_key
- weight
Validate an attestation’s signature and structure.
List attestations issued about a given identity.
Recompute global reputation scores. Returns:
- raw scores
- score bands
- graph diagnostics
Retrieve reputation for a specific identity.
Inspect trust graph structure (sanitized).
Create a new proposal.
Retrieve proposal metadata.
Submit a signed vote.
Retrieve final tally.
Service health check.
Return protocol and implementation version.
This API provides full access to identity, attestation, reputation, and governance functionality. All write operations require valid signatures; all read operations are public.