Livepeer Open Clearinghouse

A non-custodial-by-design payment clearinghouse for Livepeer applications.

Livepeer Open Clearinghouse authenticates app developers, manages their wei-denominated credit balance, and mints signed Livepeer payment tickets on their behalf. App developers integrate with one HTTP API and never touch a signing key.

Status

Pre-alpha. Scaffolding in progress.

How to run it locally

Livepeer Open Clearinghouse runs as a Docker Compose stack with four services:

• livepeer-open-clearinghouse-gateway — this repo (Python / FastAPI)
• db — Postgres 16
• payment-daemon — pre-built image from livepeer-network-modules
• service-registry-daemon — pre-built image from livepeer-network-modules

cp .env.example .env
make dev

The first time, you'll also need to generate a dev keystore for the payment-daemon:

./scripts/dev-keystore.sh

The portal is at http://localhost:8000/portal/, the admin console at http://localhost:8000/admin/, and the OpenAPI docs at http://localhost:8000/docs.

How it fits together

app dev → livepeer-open-clearinghouse-gateway → service-registry-daemon (discovery)
                            → payment-daemon (mint tickets)
                            → postgres (users, credit, usage)

See ARCHITECTURE.md for the domain layout and AGENTS.md for how to navigate the codebase.

Documentation

Where	What
AGENTS.md	Repo map and working principles
ARCHITECTURE.md	Domain + layer architecture
docs/DESIGN.md	Load-bearing design decisions
docs/PRODUCT_SENSE.md	Product mission and scope
docs/SECURITY.md	Key custody, secrets, auth model
docs/	Full documentation tree

License

MIT. See LICENSE.