@oked/verify 0.6.19 → 0.6.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +18 -19
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,13 +1,18 @@
1
1
  # @oked/verify
2
2
 
3
- Verify OKed signed approval receipts offline. For auditors, security reviewers
4
- and anyone who needs to prove what an agent was allowed to do, without
5
- trusting OKed's database.
3
+ [![npm version](https://img.shields.io/npm/v/@oked/verify.svg)](https://www.npmjs.com/package/@oked/verify)
4
+ [![License: Apache-2.0](https://img.shields.io/npm/l/@oked/verify.svg)](./LICENSE)
5
+
6
+ Verify OKed signed approval receipts offline. For auditors and anyone who needs to check what an agent was allowed to do without trusting OKed's database.
7
+
8
+ You can also paste one receipt in the browser at [oked.ai/docs/#verify](https://oked.ai/docs/#verify). That check stays in the browser. Nothing is uploaded.
6
9
 
7
10
  ```bash
8
11
  npx @oked/verify oked-receipts-2026-09-01-to-2026-10-01.zip
9
12
  ```
10
13
 
14
+ Sample of the text report (the counts below are not a real export):
15
+
11
16
  ```
12
17
  412 receipts: 412 valid, 0 invalid
13
18
  decided by: 377 human, 21 rule, 14 system (3 where the approver also ran the agent)
@@ -19,28 +24,23 @@ OK
19
24
 
20
25
  It checks:
21
26
 
22
- - **Every signature** (Ed25519 over the RFC 8785 canonical body) against OKed's
23
- public keys, and that the key was valid when the receipt was issued.
24
- - **The hash chain**: each receipt names the digest of the one before it, so a
25
- deleted receipt shows as a gap in `seq` and an edited one breaks the next link.
26
- - **Signed chain heads** in the bundle (or ones you saved earlier) agree with
27
- the receipts.
28
- - **The exact action**, for one receipt, when you pass the original request
29
- with `--subject`.
27
+ - **Every signature** (Ed25519 over the RFC 8785 canonical body) against OKed's public keys, and that the key was valid when the receipt was issued.
28
+ - **The hash chain**: each receipt names the digest of the one before it, so a deleted receipt shows as a gap in `seq` and an edited one breaks the next link.
29
+ - **Signed chain heads** in the bundle (or ones you saved earlier) agree with the receipts.
30
+ - **The exact action**, for one receipt, when you pass the original request with `--subject`.
31
+
32
+ Inputs: an export bundle from the OKed dashboard (`.zip`), a `.jsonl` file (one receipt per line, such as `~/.oked/receipts.jsonl`), or a `.json` file with one receipt or an array. Keys come from the bundle's `keys.json`, from `--keys <file>`, or from https://api.oked.ai/.well-known/oked-receipt-keys.json.
30
33
 
31
- Inputs: an export bundle from the OKed dashboard (`.zip`), a `.jsonl` file
32
- (one receipt per line, such as `~/.oked/receipts.jsonl`), or a `.json` file
33
- with one receipt or an array. Keys come from the bundle's `keys.json`, from
34
- `--keys <file>`, or from https://api.oked.ai/.well-known/oked-receipt-keys.json.
34
+ The published binary name is `oked-verify` (`npx @oked/verify` runs it). Node.js 18 or newer.
35
35
 
36
36
  | Option | |
37
37
  |---|---|
38
38
  | `--keys <keys.json>` | Verify with these keys |
39
- | `--keys-url <url>` | Fetch keys from this URL (https) |
39
+ | `--keys-url <url>` | Fetch keys from this URL (https, or loopback http) |
40
40
  | `--subject <file>` | The original request (`subject_core` JSON) for one receipt |
41
41
  | `--json` | Print the full report as JSON |
42
42
 
43
- Exit code 0 when everything verifies, 1 otherwise.
43
+ Exit code 0 when everything verifies, 1 otherwise. `--help` prints the usage text. With no file argument it exits 1.
44
44
 
45
45
  As a library:
46
46
 
@@ -51,5 +51,4 @@ const bundle = readBundle("export.zip");
51
51
  const report = verifyBundle(bundle, bundle.keys ?? (await fetchKeys()));
52
52
  ```
53
53
 
54
- What a receipt proves and what it does not:
55
- [docs/receipts.md](https://github.com/oked-ai/oked-sdk/blob/main/docs/receipts.md). Apache-2.0.
54
+ What a receipt proves, and what it does not: [docs/receipts.md](https://github.com/oked-ai/oked-sdk/blob/main/docs/receipts.md). [Apache-2.0](./LICENSE).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oked/verify",
3
- "version": "0.6.19",
3
+ "version": "0.6.21",
4
4
  "description": "Verify OKed signed approval receipts offline: signatures, keys, hash chain, subject",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -47,7 +47,7 @@
47
47
  "access": "public"
48
48
  },
49
49
  "dependencies": {
50
- "@oked/receipt-core": "0.6.19"
50
+ "@oked/receipt-core": "0.6.21"
51
51
  },
52
52
  "devDependencies": {
53
53
  "@types/node": "^22.13.10",