ProofRails

Projects API

A project is the tenant boundary for API keys, receipts, agents and configuration.

Register

POST /v1/projects/register

Registration uses a fresh SIWE nonce, complete EIP-4361 message and wallet signature. It returns the project plus one raw API key. See Authentication and API keys.

List accessible projects

GET /v1/projects
X-API-Key: <project-key>

A project principal sees its own project. A service administrator can see broader scope.

Read configuration

GET /v1/projects/{project_id}/config
X-API-Key: <project-key>

Update configuration

PUT /v1/projects/{project_id}/config
X-API-Key: <project-admin-key>
Content-Type: application/json

Project configuration controls anchoring mode and chain-specific settings. platform mode delegates anchoring to the ProofRails worker. tenant mode requires the project to submit and confirm its own anchor transaction.

Never copy the hosted ProofRails contract addresses into a different deployment without verifying that the deployment is intentionally authorized to use them.