How we keep it honest
The Vicem Ledger
In plain words: everything a Vicem does is written down and signed, so no one can quietly change it later. The rest of this page is the exact format, for anyone who wants to check.
Everything a Vicem does (a message it took, a call it answered, an action it was allowed to take) is written to its owner’s Ledger as a signed record. Records form a hash chain per owner, so no one, Vicem included, can change, reorder or remove one without the change showing. This page explains the format exactly enough to check it yourself.
Verify in your browser
Paste a receipt, a Ledger entry (from Check this record under Why? in the app, or your data download) or a daily checkpoint, open it as a file, or load today’s real checkpoint. The check runs here, with WebCrypto, against the keys built into this page. Nothing you paste or open leaves your browser.
Public keys
Records are signed with Ed25519. Every key that ever signed stays published, with the time it was valid, at vicem.ai/.well-known/vicem-ledger-keys.json (SPKI and JWK). A record signed by an unlisted key, or dated outside its key’s window, is not valid. A key marked receipts: false was retired with a fixed footprint; its records only verify as part of the whole chain.
One record
A record is shaped like a W3C Verifiable Credential. Its proof is Vicem’s own suite, not a standard Data Integrity suite. To verify one:
- payloadHash = SHA-256 (hex) of the RFC 8785 (JCS) canonical JSON of
credentialSubject.payload. - entryHash = SHA-256 (hex) of the JCS of the header
{v: 1, id, ownerId, seq, kind, payloadHash, prevHash, interactionId, createdAt}, whereidandownerIddrop theurn:vicem:ledger:andurn:vicem:owner:prefixes andcreatedAtisvalidFrom. - The signature
proof.proofValue(base64) is Ed25519 over the UTF-8 bytes of the entryHash hex string, by the key named inproof.verificationMethod. - Chain:
prevHashof record 1 is SHA-256 ofgenesis:<ownerId>; every later record’sprevHashis the previous record’s entryHash.
A caller receipt is two records, the message and the receipt that confirms it, plus the hash inputs, in one JSON object. Its page has a button to copy it.
Daily checkpoints
Once a day (UTC) Vicem commits to every owner’s chain head as of 00:00 UTC: one Merkle root, signed with the Ledger key and written to a public, versioned storage bucket with a ten-year retention policy. The service that writes checkpoints can create them but cannot overwrite or delete them. The retention policy is not locked yet, so a project administrator could still remove it.
- Leaf = SHA-256(
0x00‖ JCS({ownerId, seq, entryHash})) for each owner’s last record, sorted by ownerId. Only the leaf hashes are published, so a checkpoint names no one. - rootHash is the RFC 6962 (Certificate Transparency) Merkle tree hash of the leaves.
- checkpointHash = SHA-256 (hex) of the JCS of
{v, type, date, asOf, signedAt, treeSize, rootHash, leaves}; the proof is Ed25519 over its UTF-8 bytes.
Every checkpoint is public, served straight from Google Cloud Storage at https://storage.googleapis.com/vicem-ai-ledger-checkpoints/checkpoints/v1/<YYYY-MM-DD>.json. The index lists every day published so far, and the verifier above can load today’s.
An owner gets any single signed record from Why?, then Verify yourself, in the app. To check their chain against a checkpoint they use Settings, then Download your data: each Ledger entry in the file carries its entryHash and, unless it was forgotten, the signed record to paste above. Take the last entry recorded before 00:00 UTC that day, hash {ownerId, seq, entryHash} into a leaf as in step 1, and find it in leaves.
How the numbers on the home page are counted
The home page shows three running totals across every Vicem: calls answered, scam or spam calls screened and calls made on request. They are counted from these records, never typed in by hand, and they name no one. Test calls (the checks Vicem runs on its own lines, and an owner calling their own Vicem) and Vicem’s own accounts are left out.
- Calls answered: records of kind
call.startedwith directioninbound. - Scam or spam calls screened: inbound calls Vicem ended as spam or a scam without ringing its owner. A call the owner later marked as not spam (a
call.screen_restoredrecord) is taken off again. - Calls made on request: records of kind
errand.completedwith statusdonewhose call got what it set out to, in full or in part. A call that was refused, reached voicemail or got a no is not counted.
Once a day, with the checkpoint, the totals as of 00:00 UTC are signed with the Ledger key and written to the same bucket at https://storage.googleapis.com/vicem-ai-ledger-checkpoints/counts/v1/<YYYY-MM-DD>.json: {v: 1, type: "VicemProofCounts", date, asOf, signedAt, counts}, then countsHash = SHA-256 (hex) of the JCS of those fields and an Ed25519 proof over its UTF-8 bytes, as for a checkpoint. The site checks the signature before it shows a number, rounds down, and shows nothing below 1,000 or for totals more than a few days old.
How the speed is measured
The speed is the typical time (half of the calls were faster, half slower) from the moment Vicem answers a call to the first sound the caller hears, over calls from real callers in the last 30 days. Vicem’s own test calls are left out: the checks it runs on its own lines pick up faster than a real call, so counting them would make the number look better than what callers hear. It is rounded up to the next tenth of a second, and it is not shown when there were fewer than 20 real calls or when it is over 2 seconds. The languages are the ones real callers spoke in the last 30 days, counted the same way.
Test vectors
Signed with a test-only key (kid vector-test-1). Its private seed is public so you can re-derive every value: SHA-256 of the string vicem-ledger-test-vector-1, which is
87ea2c49a02dc97bebb130bb3d7e452bacf02e6237b6f8796963e403a5f505f6
Public key (SPKI, base64):
MCowBQYDK2VwAyEAAWLSK2DZTeIYVhXAOspPsLcOcVo8M7uurmLhu/9opA4=
Entry
{
"@context": [
"https://www.w3.org/ns/credentials/v2"
],
"type": [
"VerifiableCredential",
"VicemLedgerRecord"
],
"id": "urn:vicem:ledger:led_0example0000000000000000",
"issuer": "urn:vicem:ledger",
"validFrom": "2026-10-06T12:00:00.000Z",
"credentialSubject": {
"id": "urn:vicem:owner:own_0example0000000000000000",
"kind": "message.taken",
"seq": 1,
"interactionId": null,
"payload": {
"from": "+15555550100",
"text": "Please call me back about the invoice.",
"urgent": false
},
"payloadHash": "ff4c3f20a5bbaa45c941af7e1f52b4c9ab7c2cbad0938170c6fe786c2868f5cd"
},
"proof": {
"type": "DataIntegrityProof",
"cryptosuite": "vicem-ledger-ed25519-jcs-sha256-v1",
"verificationMethod": "urn:vicem:ledger-key:vector-test-1",
"proofValue": "iDuljY0mVPkXvIL/bbkhSlVQ1i75gB7eMDI4rA/IgkI0160gSSeEVlKxoCxM6H+zPwFroeY6sn7H6WNhN+/ECA==",
"entryHash": "618714fc4370f653f1fd1ce499d2846864c8decbad066f384aabcae37eec1cb4",
"prevHash": "d5faa3d5b94a9be2265bbf58dcecfde36709c8cd54472ff3c175c48d5d65e16c"
}
}Intermediate values:
{
"payloadHash": "ff4c3f20a5bbaa45c941af7e1f52b4c9ab7c2cbad0938170c6fe786c2868f5cd",
"prevHash": "d5faa3d5b94a9be2265bbf58dcecfde36709c8cd54472ff3c175c48d5d65e16c",
"entryHash": "618714fc4370f653f1fd1ce499d2846864c8decbad066f384aabcae37eec1cb4"
}Checkpoint
Over these chain heads:
[
{
"ownerId": "own_0example0000000000000000",
"seq": 1,
"entryHash": "618714fc4370f653f1fd1ce499d2846864c8decbad066f384aabcae37eec1cb4"
},
{
"ownerId": "own_1example0000000000000000",
"seq": 7,
"entryHash": "3393f875b91c53381ae26e03bd0db08800bc258b52f281d1f8a68ca829b09c76"
}
]{
"v": 1,
"type": "VicemLedgerCheckpoint",
"date": "2026-10-07",
"asOf": "2026-10-07T00:00:00.000Z",
"signedAt": "2026-10-07T00:05:00.000Z",
"treeSize": 2,
"rootHash": "6f20d805c6bca3cbc4a668da55c0d3c0ed3d88240d60bf22aa99faa457cf0b20",
"leaves": [
"0b457aaa9c866e5e1cc8149135bbb2fcd83898a47fb4d2d49f216bca01a0f922",
"304a2bb9da86a05df98d38827176c3e387bbf2a4ba59a03cdd12045f965454cc"
],
"checkpointHash": "1d205415bd5607a2df4070131eabda1e4873b863bd5e2a2e89c10d9e89d00342",
"proof": {
"kid": "vector-test-1",
"alg": "Ed25519",
"proofValue": "l2yEBp37pH2UzQYtvAKAxoDZ128PYHxelj28v+YLmtTEkzHNEFd5SVLhI6tJihQB6MnZIofCC7Fzgh9j8nqzAA=="
}
}