Documentationtestnet

Start here

Run LoomCredit locally

Install the repository, start the web console and read-only worker feed, then run the honest local and live evidence paths.

v0.1 · testnet

Requirements

  • Node.js 22 or newer
  • Corepack with pnpm 11
  • Foundry for Solidity verification
  • Python 3 with Playwright only if you want browser smoke tests

Install and run the web console

bash
corepack pnpm install
corepack pnpm dev

Open http://localhost:3000. The public pages are safe to run without credentials. The demo lab is always labeled LOCAL_FIXTURE_ONLY.

Start the read-only evidence feed

bash
corepack pnpm worker:status

The worker status API listens on 127.0.0.1:8787 by default. Configure LIVE_EVIDENCE_API_URL for the web server so /api/live-evidence can proxy the feed without exposing worker credentials to the browser.

Run an intentional live intake

bash
corepack pnpm worker:watch:embedded

The normal dev command stays read-only. The embedded worker command is an explicit testnet mutation gate: an authenticated operator can submit a source transaction through /review, and the worker will perform the real receipt, USC proof, and CC3 registration path. It never treats typed terms as evidence and it does not submit a quote or move capital.

Run the local policy lab

bash
corepack pnpm demo:happy
corepack pnpm demo:unsafe-agent

The safe fixture should be approved. The unsafe fixture should be rejected because its 80% advance exceeds the 40% deterministic cap. Neither command calls a model or submits a transaction.

Verify the installation

bash
corepack pnpm typecheck
corepack pnpm test
corepack pnpm lint
corepack pnpm build
corepack pnpm test:contracts

Documentation is generated from the current repository contract. For the recorded testnet evidence, inspect the live proof console.