Docs
Plumb is a self-hostable stack for verifiable AI inference, a content-addressed model hub, pgvector-backed memory, and a smart-contract-callable pipe oracle. Everything ships as a pnpm monorepo you can clone and run on a single VPS.
Where to go next
- Quickstart — 5-minute Python onboard: SIWE login, mint test credits, run a completion, verify the receipt.
- Python SDK — full client reference:
chat,receipts,memsync,hub,pipe,verify_receipt. - API reference — every HTTP route on the gateway with auth, request/response shape, and status codes.
- Contracts — deployed Base Sepolia addresses for
PLMB,Settlement,HubRegistry,PipeOracle,PipeConsumer+ ABI downloads.
Concepts
- Session — SIWE-issued Bearer token. Replaces passwords; tied to your wallet address.
- Credits — denominated in PLMB (1 PLMB = 1,000,000 micro-PLMB). Top up via
Settlement.deposit()or the console. - Receipt — an ed25519-signed record of one completion. Verifiable locally; settled on-chain in batches.
- Checkpoint — a Merkle root over a batch of receipts, written to
Settlement.checkpointReceipts()on Base. - Hub model — a content-addressed (keccak256) upload. Registering it on-chain via
HubRegistrypins the uploader as recipient. - Pipe job — an on-chain
PipeOracle.request(modelHash, inputHash, callback)→ off-chain worker fulfills and calls back.
Phase and version
Plumb is on public preview. Contracts are on Base Sepolia (chainId 84532). Mainnet-ready contract audits and the TEE-backed receipt mode are roadmap.