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.
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
corepack pnpm install
corepack pnpm devOpen 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
corepack pnpm worker:statusThe 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
corepack pnpm worker:watch:embeddedThe 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
corepack pnpm demo:happy
corepack pnpm demo:unsafe-agentThe 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
corepack pnpm typecheck
corepack pnpm test
corepack pnpm lint
corepack pnpm build
corepack pnpm test:contractsDocumentation is generated from the current repository contract. For the recorded testnet evidence, inspect the live proof console.