@sanning/proof 0.12.0 → 0.14.0

package/vectors/witness-cache.json

@@ -0,0 +1,1304 @@
+{
+  "rule": "witness-cache",
+  "ruleVersion": 1,
+  "statement": "What a reader does with the witnessed-time cache, the file `witness-cache.json` beside a pack's `bundle.json` (evidence-bundle.md 5.5.6 and 5.6.6, v1.25, A30). The file is not part of the bundle and nobody signs it, so anyone holding the pack can edit it, and every member of it is unverified by construction. It never moves the headline, the pack grade, the bundle verdict or the signature, and a reader before v1.25 lists it as a file outside every pack and reads nothing else differently. Offline, each cached time is printed on the witness line, labelled not checked. With gateways, each is looked up: a block that differs from the cached one is a finding, the witness line reads `differs` and `case` exits 1; a matching block is printed as the public record's answer; a lookup that names no block leaves the cached value labelled not checked and moves nothing. A file that is absent or malformed reads as no cache. A `cache` member inside `bundle.json` is an unknown wrapper field in the signed scope, and is never read as a cache.",
+  "home": "@sanning/proof: ts/vectors/witness-cache.json, written by tools/gen-vectors/gen_witness_cache_table.py with every expectation by hand. The TypeScript kernel implements it in ts/src/witness-cache.ts and ts/src/cli.ts and is held to it by ts/test/witness-cache-vectors.test.ts; the Python kernel implements it in src/sanning_proof/witness_cache.py and src/sanning_proof/cli.py and is held to the SAME file by tests/test_witness_cache_vectors.py.",
+  "howToUse": "For each case, take `pack`, set its top-level `cache` to the case's `wrapperCache` where it has one (and leave the signature as it is), and write it as `<dir>/witness-pack/bundle.json`, with `sideContentHex` beside it as `<dir>/witness-pack/logs/<event_id>.json` and, where the case has `cacheFileHex`, those exact bytes as `<dir>/witness-pack/witness-cache.json`. Run the `case` command over that folder twice. The case's `headline` and `offlineExit`, where it has them, replace the table's. Offline: assert the headline, the exit, and the witness line's state and rendered text are `expect.offline`. Online, with `--gateways` set to `expect.online.gateways`: answer `<gateway>/<anchorId>` with the stamp's witnessed bytes where `bytes` says `witnessed`, and answer each POST to `<gateway>/graphql` whose body is `graphqlQuery` per the case's `graphql` answer for that gateway: `block` is `{\"data\":{\"transaction\":{\"block\":{\"height\":H,\"timestamp\":T}}}}`, `pending` is `{\"data\":{\"transaction\":{\"block\":null}}}`, `stringNumbers` is the block with both numbers written as JSON strings, and `unreachable` is a refused request. Assert the headline is unchanged, the exit, the on-chain verdict, the witness line's state and rendered text, how many time lookups were made, and that one byte lookup was made per gateway, or `byteRequests` where the case gives it.",
+  "cacheFileName": "witness-cache.json",
+  "cacheVersion": "sanning.witness-cache/v1",
+  "anchorId": "witnessCacheFixtureAnchorId0000000000000000",
+  "stampRef": "f74af46cf35175dec5c279c83802c82df30f8b772362f759eeac207106b2cd9c",
+  "stampBytesHex": "7b22696e74657276616c5f656e64223a22323032362d30392d30385431323a31303a30302e3030305a222c22696e74657276616c5f7374617274223a22323032362d30392d30385431323a30303a30302e3030305a222c226c6561665f636f756e74223a312c226d65726b6c655f726f6f74223a2236643835653661663061336331376538343235323064656561343731363635633561346136666639343863616338336562663764383563376662653231613733222c226f72675f726566223a2239393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939222c227374616d705f76657273696f6e223a2273616e6e696e672e7374616d702f7631222c227375627472656573223a7b2231313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131223a7b2266697273745f6c656166223a302c226c6561665f636f756e74223a312c22726f6f74223a2236643835653661663061336331376538343235323064656561343731363635633561346136666639343863616338336562663764383563376662653231613733227d7d7d",
+  "graphqlQuery": "{\"query\":\"query{transaction(id:\\\"witnessCacheFixtureAnchorId0000000000000000\\\"){block{height timestamp}}}\"}",
+  "headline": "verified",
+  "offlineExit": 0,
+  "pack": {
+    "spec_version": "sanning.evidence/v1",
+    "body_type": "sanning.stamp.evidence/v2",
+    "issuer": {
+      "kind": "sanning"
+    },
+    "generated_at": "2026-09-08T12:20:00.000Z",
+    "gateway": null,
+    "verdict": {
+      "status": "verified",
+      "summary": "witness-cache fixture"
+    },
+    "body": {
+      "stamps": [
+        {
+          "stamp_ref": "f74af46cf35175dec5c279c83802c82df30f8b772362f759eeac207106b2cd9c",
+          "stamp_bytes": "7b22696e74657276616c5f656e64223a22323032362d30392d30385431323a31303a30302e3030305a222c22696e74657276616c5f7374617274223a22323032362d30392d30385431323a30303a30302e3030305a222c226c6561665f636f756e74223a312c226d65726b6c655f726f6f74223a2236643835653661663061336331376538343235323064656561343731363635633561346136666639343863616338336562663764383563376662653231613733222c226f72675f726566223a2239393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939393939222c227374616d705f76657273696f6e223a2273616e6e696e672e7374616d702f7631222c227375627472656573223a7b2231313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131313131223a7b2266697273745f6c656166223a302c226c6561665f636f756e74223a312c22726f6f74223a2236643835653661663061336331376538343235323064656561343731363635633561346136666639343863616338336562663764383563376662653231613733227d7d7d",
+          "anchor_ref": {
+            "kind": "arweave",
+            "id": "witnessCacheFixtureAnchorId0000000000000000"
+          }
+        }
+      ],
+      "events": [
+        {
+          "envelope": {
+            "spec_version": "sanning.events/v2",
+            "event_id": "ad022c80-4c65-4fcf-9346-ed285802beba",
+            "payload_hash": "813b6fc58ad1789760f6a7d4ecb85a7de5287e7f2def95b6c65a01257ad68b9b",
+            "signed_at": "2026-09-08T12:00:00Z",
+            "environment": "production",
+            "public_key": "207a067892821e25d770f1fba0c47c11ff4b813e54162ece9eb839e076231ab6",
+            "signature": "1224935b022b2b932b1096d000dd303b0d8a57ba90a9bbbf13df821f7521a81c29d33880be7e2c586495921cd7f7b445f8bd563530bd823467a4887d03108005"
+          },
+          "inclusion": {
+            "stamp_ref": "f74af46cf35175dec5c279c83802c82df30f8b772362f759eeac207106b2cd9c",
+            "leaf_index": 0,
+            "leaf_count": 1,
+            "leaf_hash": "6d85e6af0a3c17e842520deea471665c5a4a6ff948cac83ebf7d85c7fbe21a73",
+            "audit_path": []
+          },
+          "event_bytes": "7b226576656e74223a7b22636f6e74656e745f68617368223a2239386230386337396439313831643034363337316166643139623438393431653633313434316361316530323531646535663238666632636533383533383033227d7d"
+        }
+      ]
+    },
+    "body_hash": "1c9a04502d8efa29d985b89cea5e3fb28438b03bf3ecc15b7a6be468a0eded67",
+    "previous_hash": "GENESIS",
+    "signature_alg": "ed25519",
+    "public_key": "207a067892821e25d770f1fba0c47c11ff4b813e54162ece9eb839e076231ab6",
+    "signature": "3603350967925d8cf101b33972a52d4d664be6894d02be873d6e71b79efd6ebc60e20156af7cd7deb95909bc9de0d470d5851dc14a53304a4a95e5a952b25a0f"
+  },
+  "sideContentHex": {
+    "ad022c80-4c65-4fcf-9346-ed285802beba": "7b2273746570223a227769746e6573732d63616368652066697874757265227d"
+  },
+  "cases": [
+    {
+      "id": "cache-absent",
+      "why": "A pack with no cache reads exactly as it did before the cache existed: the same line offline, the same line with a gateway, and no time is asked for.",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "cache-matches",
+      "why": "Offline, the cached time is printed and labelled not checked, and the line stays not checked. With a gateway, the time the public record returns is printed as the record's, and the line is confirmed by the bytes, as it would be with no cache.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run; the pack dates the witness, not checked: block 1996701 at 2026-09-08T12:10:07Z"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 1,
+          "rendered": "Witness: Confirmed on the public record: the public record dates the witness: block 1996701 at 2026-09-08T12:10:07Z (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "cache-time-wrong",
+      "why": "A cache one hour late. Offline, the reader cannot tell, so it prints the cached value and says it is not checked, never that it is confirmed. With a gateway it is a finding: the line reads differs, the command exits 1, and the headline does not move.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383837333030372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run; the pack dates the witness, not checked: block 1996701 at 2026-09-08T13:10:07Z"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "differs",
+          "onChainVerdict": "failed",
+          "exit": 1,
+          "graphqlRequests": 1,
+          "rendered": "Witness: The public record holds different bytes: a pack dates the witness block 1996701 at 2026-09-08T13:10:07Z, and the public record dates it block 1996701 at 2026-09-08T12:10:07Z (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "cache-height-wrong",
+      "why": "The right time and the wrong block. Both numbers are compared, so this differs too.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730322c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run; the pack dates the witness, not checked: block 1996702 at 2026-09-08T12:10:07Z"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "differs",
+          "onChainVerdict": "failed",
+          "exit": 1,
+          "graphqlRequests": 1,
+          "rendered": "Witness: The public record holds different bytes: a pack dates the witness block 1996702 at 2026-09-08T12:10:07Z, and the public record dates it block 1996701 at 2026-09-08T12:10:07Z (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "cache-wrong-time-lookup-unsettled",
+      "why": "A wrong cache, and a time lookup that does not settle. The bytes still confirm, and the cached value stays labelled not checked: a wrong cache never reads as confirmed, and an unanswered time lookup accuses nobody and moves no exit code.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383837333030372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run; the pack dates the witness, not checked: block 1996701 at 2026-09-08T13:10:07Z"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "unreachable"
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 1,
+          "rendered": "Witness: Confirmed on the public record: the pack dates the witness, not checked: block 1996701 at 2026-09-08T13:10:07Z (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "cache-wrong-witness-pending",
+      "why": "The gateway holds the transaction and has no block for it yet. That names no block, so it settles nothing: the cached value stays not checked.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383837333030372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run; the pack dates the witness, not checked: block 1996701 at 2026-09-08T13:10:07Z"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "pending"
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 1,
+          "rendered": "Witness: Confirmed on the public record: the pack dates the witness, not checked: block 1996701 at 2026-09-08T13:10:07Z (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "cache-wrong-answer-not-a-block",
+      "why": "A gateway answers the time lookup with numbers spelled as strings. That is not an answer this reader reads, so it names no block and settles nothing.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383837333030372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run; the pack dates the witness, not checked: block 1996701 at 2026-09-08T13:10:07Z"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "stringNumbers"
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 1,
+          "rendered": "Witness: Confirmed on the public record: the pack dates the witness, not checked: block 1996701 at 2026-09-08T13:10:07Z (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "cache-one-gateway-differs",
+      "why": "Two gateways, one naming the cached block and one naming another. Worst answer wins, as it does for the bytes: the line reads differs.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run; the pack dates the witness, not checked: block 1996701 at 2026-09-08T12:10:07Z"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example",
+            "http://gw2.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed",
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              },
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869347
+              }
+            ]
+          },
+          "state": "differs",
+          "onChainVerdict": "failed",
+          "exit": 1,
+          "graphqlRequests": 2,
+          "rendered": "Witness: The public record holds different bytes: a pack dates the witness block 1996701 at 2026-09-08T12:10:07Z, and the public record dates it block 1996701 at 2026-09-08T12:09:07Z (answered: http://gw.example, http://gw2.example)"
+        }
+      }
+    },
+    {
+      "id": "cache-nested-to-512",
+      "why": "An entry carrying an unknown member that takes the file to exactly 512 levels, the most the file is read under. The file is not the bundle, so its depth is nothing the bundle's bounds read; the entry reads, and its unknown member is ignored.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c226e6f7465223a5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d2c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run; the pack dates the witness, not checked: block 1996701 at 2026-09-08T12:10:07Z"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 1,
+          "rendered": "Witness: Confirmed on the public record: the public record dates the witness: block 1996701 at 2026-09-08T12:10:07Z (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "wrapper-cache-is-an-unknown-field",
+      "why": "The v1.22 draft's shape: a good cache written as a `cache` member INSIDE bundle.json, after the wrapper was signed, and no file beside it. It is an unknown wrapper field, inside the signed scope exactly as on proof 0.13.0, so the wrapper signature fails and the pack reads failed. It is never read as a cache: nothing is printed for it and no time is asked for. A pack whose wrapper fails names no witness to look up, as on 0.13.0, so no byte lookup is made either.",
+      "wrapperCache": {
+        "cache_version": "sanning.witness-cache/v1",
+        "witnessed": [
+          {
+            "stamp_ref": "f74af46cf35175dec5c279c83802c82df30f8b772362f759eeac207106b2cd9c",
+            "block_height": 1996701,
+            "block_time": 1788869407
+          }
+        ]
+      },
+      "headline": "failed",
+      "offlineExit": 1,
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "not_checked",
+          "onChainVerdict": "undetermined",
+          "exit": 1,
+          "graphqlRequests": 0,
+          "byteRequests": 0,
+          "rendered": "Witness: Not checked: a pack names no witness"
+        }
+      }
+    },
+    {
+      "id": "malformed-file-empty",
+      "why": "A malformed cache file, an empty file. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-file-not-json",
+      "why": "A malformed cache file, bytes that are not JSON. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b6e6f74206a736f6e",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-file-byte-order-mark",
+      "why": "A malformed cache file, the good file after a byte-order mark. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "efbbbf7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-file-not-utf8",
+      "why": "A malformed cache file, the good file with an ill-formed UTF-8 byte in an unknown member. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d2c226e6f7465223a22ff227d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-file-non-finite",
+      "why": "A malformed cache file, the good file with NaN in an unknown member. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d2c226e6f7465223a4e614e7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-file-duplicate-member",
+      "why": "A malformed cache file, witnessed named twice, an empty list first and the good list second. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b5d2c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-file-nested-past-512",
+      "why": "A malformed cache file, the good file with an unknown member nested 513 levels deep. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d2c226e6f7465223a5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5b5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-cache-not-an-object",
+      "why": "A malformed cache file, a string. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "227769746e657373656420323032362d30392d303822",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-cache-is-an-array",
+      "why": "A malformed cache file, an array, not an object. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-version-missing",
+      "why": "A malformed cache file, the v1.22 wrapper shape, no cache_version. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-version-unknown",
+      "why": "A malformed cache file, cache_version sanning.witness-cache/v2. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7632222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-version-not-a-string",
+      "why": "A malformed cache file, cache_version 1. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a312c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-witnessed-missing",
+      "why": "A malformed cache file, an object with no witnessed. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e65737365645f6174223a313738383836393430377d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-witnessed-not-a-list",
+      "why": "A malformed cache file, witnessed is an object. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-entry-not-an-object",
+      "why": "A malformed cache file, an entry that is a number. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b313738383836393430375d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-time-as-a-string",
+      "why": "A malformed cache file, block_time a string. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a22323032362d30392d30385431323a31303a30375a222c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-time-not-whole",
+      "why": "A malformed cache file, block_time 1788869407.5. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372e352c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-time-negative",
+      "why": "A malformed cache file, block_time -1. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a2d312c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-time-past-9999",
+      "why": "A malformed cache file, block_time one second past 9999-12-31T23:59:59Z. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a3235333430323330303830302c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-time-a-boolean",
+      "why": "A malformed cache file, block_time true. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a747275652c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-time-missing",
+      "why": "A malformed cache file, no block_time. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-height-missing",
+      "why": "A malformed cache file, no block_height. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-height-unsafe",
+      "why": "A malformed cache file, block_height 2^53. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a393030373139393235343734303939322c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-ref-uppercase",
+      "why": "A malformed cache file, stamp_ref in uppercase hex. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2246373441463436434633353137354445433543323739433833383032433832444633304638423737323336324637353945454143323037313036423243443943227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-ref-names-no-stamp",
+      "why": "A malformed cache file, stamp_ref of no stamp in the body. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2265656565656565656565656565656565656565656565656565656565656565656565656565656565656565656565656565656565656565656565656565656565227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-ref-named-twice",
+      "why": "A malformed cache file, two entries for the one stamp, the same values in both. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d2c7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    },
+    {
+      "id": "malformed-ref-named-twice-one-malformed",
+      "why": "A malformed cache file, two entries for the one stamp, one of them malformed. It reads as no cache: nothing is printed for it, no time is asked for, and nothing moves.",
+      "cacheFileHex": "7b2263616368655f76657273696f6e223a2273616e6e696e672e7769746e6573732d63616368652f7631222c227769746e6573736564223a5b7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a313738383836393430372c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d2c7b22626c6f636b5f686569676874223a313939363730312c22626c6f636b5f74696d65223a22736f6f6e222c227374616d705f726566223a2266373461663436636633353137356465633563323739633833383032633832646633306638623737323336326637353965656163323037313036623263643963227d5d7d",
+      "expect": {
+        "offline": {
+          "state": "not_checked",
+          "rendered": "Witness: Not checked: no lookup was run"
+        },
+        "online": {
+          "gateways": [
+            "http://gw.example"
+          ],
+          "answers": {
+            "bytes": [
+              "witnessed"
+            ],
+            "graphql": [
+              {
+                "kind": "block",
+                "block_height": 1996701,
+                "block_time": 1788869407
+              }
+            ]
+          },
+          "state": "confirmed",
+          "onChainVerdict": "confirmed",
+          "exit": 0,
+          "graphqlRequests": 0,
+          "rendered": "Witness: Confirmed on the public record (answered: http://gw.example)"
+        }
+      }
+    }
+  ]
+}