Integrations

Operate the proof worker

Configure the source watcher, process one transaction, expose sanitized status, and understand durable stages.

v0.1 · testnet

Commands

Command	Use it for
pnpm worker:config	Validate configuration without printing private keys.
pnpm worker:process -- 0x…	Process one source transaction.
pnpm worker:watch-once	Scan one bounded source range.
pnpm worker:watch	Run the durable polling watcher.
pnpm worker:status	Serve sanitized read-only GET status.
pnpm worker:watch:embedded	Run the explicit loopback intake gate alongside the live watcher.

Required configuration

Variable	Role
SOURCE_CHAIN_RPC_URL	Source-chain JSON-RPC endpoint.
CREDITCOIN_RPC_URL	Creditcoin CC3 JSON-RPC endpoint.
PROOF_BUILDER_URL	Attestcoin proof-builder endpoint.
SOURCE_CHAIN_KEY	Source network key used by USC proofs.
CREDITCOIN_WALLET_PRIVATE_KEY	Worker transaction-fee key; server-only.
WORKER_START_BLOCK	Operator-selected first block for watcher scans.
WORKER_DATABASE_PATH	Durable SQLite path for worker state.

Durable stages

DETECTED
  -> WAITING_FOR_ATTESTATION
  -> PROOF_REQUESTED
  -> PROOF_READY
  -> CREDITCOIN_SUBMITTED
  -> VERIFIED

Network and proof-builder failures remain retryable. Failed source receipts, malformed proofs, wrong emitters, and receipt mismatches become terminal failures. A broadcast transaction hash is persisted before waiting for mining so restarts can confirm instead of rebroadcasting.

Status API

curl -s http://127.0.0.1:8787/v1/orders | jq '.orders[] | {orderId,eventType,stage,proofStatus}'

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