# Audit hash chain

> Test vectors: Audit hash chain. Shown here as it is in conformance/vectors/audit.json.

Protocol `0.1`. Covers: SPEC.md section 13, "Audit".

[Download audit.json](./audit.json): the file itself, as the conformance suite reads it.

## How to use it

An unkeyed and a keyed audit chain to verify; `args` is SHA-256, or HMAC under the key, of `argsCanonical`.

## Formula

```text
hash = b64url(SHA-256(prev + "\n" + canonicalJson(record without hash))), or b64url(HMAC-SHA256(auditKey, same input)) when the hub has an audit key; prev of the first record is ""
args = b64url(SHA-256(canonical JSON of the params without s)), or b64url(HMAC-SHA256(auditKey, same input)) when the hub has an audit key
```

## Notes

All of this is stated in SPEC 13. `argsCanonical` is the canonical JSON both chains digest into `args`.

## Fixed values

| key | value |
|---|---|
| `key` | `-iH_QbYEGjOOgX9OdllDT0Jw245dyudNBRahIpz2O5A` |
| `argsCanonical` | `{"a":"cart.add","args":{"sku":"latte"}}` |

## unkeyed

3 cases.

```json
[
  {
    "seq": 1,
    "ts": 1700000000000,
    "kind": "connect",
    "outcome": "ok",
    "role": "agent",
    "agent": "a1",
    "kid": "default",
    "prev": "",
    "hash": "f18pWevHDj3MXc_3Q93dKZ-80brIbziPQUR_1hQqiEY"
  },
  {
    "seq": 2,
    "ts": 1700000000100,
    "kind": "request",
    "outcome": "accepted",
    "agent": "a1",
    "surface": "s1",
    "method": "act",
    "action": "cart.add",
    "args": "Dqe_mC_mK_ASMJOf26YkpIZwxlJg5BJkdC351lJ4D3w",
    "prev": "f18pWevHDj3MXc_3Q93dKZ-80brIbziPQUR_1hQqiEY",
    "hash": "lXBQcDevQBVS5aNlGIu5dluNlr_LTmOTTi8jNR2dDnM"
  },
  {
    "seq": 3,
    "ts": 1700000000150,
    "kind": "request",
    "outcome": "ok",
    "agent": "a1",
    "surface": "s1",
    "method": "act",
    "action": "cart.add",
    "args": "Dqe_mC_mK_ASMJOf26YkpIZwxlJg5BJkdC351lJ4D3w",
    "ms": 50,
    "ref": 2,
    "prev": "lXBQcDevQBVS5aNlGIu5dluNlr_LTmOTTi8jNR2dDnM",
    "hash": "Tv8mXy0Ydf6l8rpM1FYeZmZxx4ORgQJf68B3IAf6sOM"
  }
]
```

## keyed

3 cases.

```json
[
  {
    "seq": 1,
    "ts": 1700000000000,
    "kind": "connect",
    "outcome": "ok",
    "role": "agent",
    "agent": "a1",
    "kid": "default",
    "prev": "",
    "hash": "J-ocw5eH8LBqrAnJ7pBQvaApGswMsHYjJXLBeR-qR5c"
  },
  {
    "seq": 2,
    "ts": 1700000000100,
    "kind": "request",
    "outcome": "accepted",
    "agent": "a1",
    "surface": "s1",
    "method": "act",
    "action": "cart.add",
    "args": "eVJ1v_Up1aCkC6eSkIoxoklmAopnxpXJ2-3YkOw9vmY",
    "prev": "J-ocw5eH8LBqrAnJ7pBQvaApGswMsHYjJXLBeR-qR5c",
    "hash": "9h5ZGKezqQANXzSOtt9NH5UpiDg57qs9QAsj9akr02M"
  },
  {
    "seq": 3,
    "ts": 1700000000150,
    "kind": "request",
    "outcome": "ok",
    "agent": "a1",
    "surface": "s1",
    "method": "act",
    "action": "cart.add",
    "args": "eVJ1v_Up1aCkC6eSkIoxoklmAopnxpXJ2-3YkOw9vmY",
    "ms": 50,
    "ref": 2,
    "prev": "9h5ZGKezqQANXzSOtt9NH5UpiDg57qs9QAsj9akr02M",
    "hash": "12NVVw2hdTKIhg_G7vb9Ku5dS02WF8AetnwxPgCi6KU"
  }
]
```

Generated by `conformance/tools/make-vectors.mjs` from the formulas in the specification, with `node:crypto` only.
