Trust & safety
Receipts & transparency
Signed, hash-chained journals and a public Merkle log anyone can verify.
Kept is designed so that you don't have to trust Kept. Every event on every promise is a signed receipt, and the receipts are chained so that changing or removing one is detectable.
Journal entries
Each entry is canonical JSON (sorted keys, no whitespace):
{ "v": 1, "stream": "<contract id>", "seq": 7, "at": 1793806545132,
"actor": "paypal", "type": "paypal.captured", "data": { "...": "..." },
"prevHash": "<hash of entry 6>" }hash = sha256(canonical JSON)prevHashlinks to the previous entry of the same promise (the first links to 64 zeros)sigis an Ed25519 signature over the hash, with the key named bykeyId
The public keys are at https://befitting-mosquito-713.convex.site/.well-known/kept-keys.json.
Verify a chain
import { verifyChain } from "@kept/core";
const keys = await fetch("https://befitting-mosquito-713.convex.site/.well-known/kept-keys.json").then((r) => r.json());
const publicKeys = Object.fromEntries(keys.keys.map((k) => [k.keyId, k.publicKey]));
const result = verifyChain(entries, publicKeys);
// { ok: true, checked: 23 } or { ok: false, failedAt, reason }verifyChain recomputes every hash, follows every link from the first entry, and checks every signature. The contract page's Verify in browser button does exactly this.
The transparency log
Entries from all promises are batched into checkpoints, an RFC 6962 Merkle tree over entry hashes. Each checkpoint is signed and links to the previous checkpoint, so the whole log is append-only.
| Endpoint | Returns |
|---|---|
GET /v1/transparency/checkpoints | Recent checkpoints with their roots, signatures and validity |
GET /v1/transparency/proof/{entryHash} | An inclusion proof for one entry against a signed checkpoint |
import { verifyInclusion } from "@kept/core";
verifyInclusion(entryHash, leafIndex, treeSize, proof, checkpointRoot); // trueProof packs
GET /v1/contracts/{id}/proof returns everything needed to audit a promise offline: the terms, their hashes, the verification report and the full signed journal (format kept-proof-pack/v1). Drop one on /verify, or run:
npx @kept/mcp verify-proof proof-pack.json