Local development

Official documentation for ProofRails — the open evidence and translation layer for onchain payments.

Backend

cp .env.example .env

Recommended local settings:

API_KEYS=dev-admin-CHANGE_ME
DATABASE_URL=sqlite:///./local.db
AUTO_CREATE_DB=true
X402_MOCK_PAYMENTS=true
RATE_LIMIT_ENABLED=false

Run:

uvicorn app.main:app --reload --port 8000

npm run dev --workspace web-alt

Default local app:

http://localhost:3000

If running from WSL and viewing from Windows, use the WSL IP address instead of 127.0.0.1 when needed.