blackbox · Evidence Mode

A record of what your agent did, and proof no one edited it.

blackbox writes every action an agent takes to a hash-chained log. Alter, insert, or drop a single record and the chain breaks at exactly that point. Below is that log, live and running the real hash chain. Tamper with it yourself.

The log, live

Change a value. Then verify.

Click any cost or name to alter a record, then press Verify chain. Nothing flags the change on its own. verify() is what catches it, breaks at that exact record, and dims everything after.

blackbox · agent.jsonl
VERIFIED chain intact · 0 records
click a value to tamper, then verify

Real SHA-256, computed in your browser. The same algorithm as the npm package.

The pair

Two layers. Enforce, then prove.

Purse

Enforcement

Keeps the payment credential in a broker the agent cannot reach. Decides what an agent is allowed to do, and refuses the rest in real time.

See Purse

blackbox

Evidence

Records what the agent actually did, and hash-chains it so the log survives anyone trying to rewrite history after the fact.

You are here

Enforcement decides. Evidence proves. An agent you can control but not audit is still a liability. An audit you cannot trust is just a story.

Under the hood

Why a plain log is not enough.

Every record links the last

Each record carries the hash of the one before it. The chain is only valid if every link holds. Break one and everything downstream is unverified.

verify() names the break

Recompute each record from its own contents and check it against the stored hash. An edit, an insert, a deletion, a reorder, each fails a check and returns the exact record where.

Silent failures leave a trace

It records every attempt with outcome, latency and cost, not only the errors. The ok-but-wrong result and the slow cost creep are written down instead of vanishing.

Zero dependencies

Node crypto and nothing else. It wraps an action or takes a record, and drops into whatever an agent already runs. Memory or a JSONL file, or your own store.

Run it yourself

One import. A record you can check.

npm i @olurabian/blackbox Read the repo View on npm →