@valve-tech/trueblocks-sdk 0.0.1 → 0.10.1

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/CHANGELOG.md +72 -4
  2. package/package.json +20 -2
package/CHANGELOG.md CHANGED
@@ -6,8 +6,76 @@ this file.
6
6
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
7
7
  and this project adheres to [Semantic Versioning](https://semver.org/).
8
8
 
9
- ## [Unreleased]
9
+ ## [0.10.1] — 2026-05-08
10
10
 
11
- Experimental package, not yet published. Vertical-slice prototype:
12
- codegen pipeline + client core + `/status` and `/blocks` verbs with
13
- 100/100/100/100 coverage on what's implemented.
11
+ **First successful npm publish at the v0.10.x line.** v0.10.0's
12
+ publish errored at npm's provenance validation because this
13
+ `package.json` was missing the `repository` field — `--provenance`
14
+ requires it to match the GitHub repo URL in the OIDC attestation.
15
+ v0.10.1 adds the missing fields and republishes the whole line in
16
+ sync.
17
+
18
+ ### Added
19
+ - `package.json`: `repository`, `homepage`, `bugs`, and `keywords`
20
+ fields (matching the shape every other published `@valve-tech/*`
21
+ package already had).
22
+
23
+ ### Notes
24
+ - Package contents are otherwise identical to what v0.10.0 would
25
+ have published.
26
+
27
+ ## [0.10.0] — 2026-05-08
28
+
29
+ *Did not publish — the OIDC `Publish @valve-tech/trueblocks-sdk`
30
+ step errored at npm's provenance validation (missing `repository`
31
+ field in `package.json`). Superseded by v0.10.1.*
32
+
33
+ **Intended-for-publish content:** first OIDC-driven publish for
34
+ this package, jumping from the 0.0.1 name-claim. Joins the
35
+ synchronized release line at v0.10.x.
36
+
37
+ ### Added
38
+ - Typed TypeScript HTTP client over the chifra daemon's REST API.
39
+ All 18 OpenAPI endpoints exposed via `createTrueblocksClient(...)`:
40
+ `blocks`, `transactions`, `receipts`, `logs`, `traces`, `when`,
41
+ `state`, `tokens`, `list`, `export`, `monitors`, `names`, `abis`,
42
+ `slurp`, `chunks`, `init`, `config`, `status`.
43
+ - 36 narrowed variant accessors on the seven polymorphic endpoints
44
+ whose response is a wide union (4+ types):
45
+ - `client.blocks.{hashes, uncles, traces, uniq, logs, withdrawals, count}`
46
+ - `client.transactions.{traces, uniq, logs}`
47
+ - `client.traces.count`
48
+ - `client.slurp.{appearances, count}`
49
+ - `client.state.call`
50
+ - `client.export.{appearances, receipts, logs, approvals, traces, neighbors, statements, transfers, assets, balances, withdrawals, count, approvalsLogs}`
51
+ - `client.chunks.{manifest, index, blooms, pins, addresses, appearances, stats, count, check}`
52
+ - Conditional `VerbFn<P>` typing — endpoints with required query
53
+ parameters (e.g. `/blocks` requires `blocks: string[]`) reject
54
+ no-arg calls at the type level.
55
+ - Codegen pipeline: `scripts/codegen.mjs` pulls the upstream OpenAPI
56
+ spec from `TrueBlocks/trueblocks-core` at pinned SHA
57
+ `3205a003af599adf2229408f74afbe6952391883`. `src/generated.ts` is
58
+ fetched on first build (`--if-missing` chained into build, test,
59
+ typecheck), gitignored, and refreshed via `yarn codegen`.
60
+ - Browser/mobile-safe runtime — `globalThis.fetch` only, no Node
61
+ imports.
62
+ - 100% coverage on the hand-written surface (client, errors, verbs,
63
+ variants).
64
+
65
+ ### Notes
66
+ - Licensed MIT, in line with the rest of `@valve-tech/*`. Upstream
67
+ `trueblocks-core` is GPL-3.0-or-later; this package is a
68
+ clean-room TypeScript reimplementation against the public OpenAPI
69
+ spec — no GPL code is incorporated. The clean-room rule (don't
70
+ read the GPL Go SDK source) is preserved in `AGENTS.md` and is
71
+ load-bearing under MIT.
72
+ - `state.send()` is **not** exposed: the upstream OpenAPI at the
73
+ pinned SHA describes only `call?: boolean` as a boolean flag on
74
+ the `/state` endpoint, not `send`. The variant will be added when
75
+ the spec gains the flag and codegen picks it up.
76
+
77
+ ## [0.0.1] — 2026-05-08
78
+
79
+ Manual name-claim publish. Establishes the npm record so a
80
+ trusted-publisher binding can be created at npmjs.com; not intended
81
+ for consumption.
package/package.json CHANGED
@@ -1,8 +1,26 @@
1
1
  {
2
2
  "name": "@valve-tech/trueblocks-sdk",
3
- "version": "0.0.1",
3
+ "version": "0.10.1",
4
4
  "description": "Typed TypeScript HTTP client to a running TrueBlocks chifra daemon. Wraps chifra's REST surface (the same one served by `chifra daemon`) with TS types generated from the upstream OpenAPI spec; no Go runtime, no shelling-out.",
5
5
  "license": "MIT",
6
+ "homepage": "https://github.com/valve-tech/evm-toolkit/tree/main/packages/trueblocks-sdk#readme",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/valve-tech/evm-toolkit.git",
10
+ "directory": "packages/trueblocks-sdk"
11
+ },
12
+ "bugs": {
13
+ "url": "https://github.com/valve-tech/evm-toolkit/issues"
14
+ },
15
+ "keywords": [
16
+ "trueblocks",
17
+ "chifra",
18
+ "ethereum",
19
+ "evm",
20
+ "indexer",
21
+ "openapi",
22
+ "sdk"
23
+ ],
6
24
  "type": "module",
7
25
  "main": "dist/index.js",
8
26
  "types": "dist/index.d.ts",
@@ -31,4 +49,4 @@
31
49
  "devDependencies": {
32
50
  "openapi-typescript": "^7.4.0"
33
51
  }
34
- }
52
+ }