ox 1.1.2 → 1.2.0

package/src/core/_test/Transaction.test.ts

@@ -158,7 +158,11 @@ describe('fromRpc', () => {
         })
         .then(Transaction.fromRpc)
 
-      expect(transaction).toMatchInlineSnapshot(`
+      const { blockTimestamp: _, ...transaction_ } = {
+        blockTimestamp: undefined,
+        ...transaction,
+      }
+      expect(transaction_).toMatchInlineSnapshot(`
         {
           "blockHash": "0x8299a290ae51a8958965987e2caf178a09b8ecde01b737b5f9a8badbacb407cb",
           "blockNumber": 1110749n,
@@ -411,7 +415,12 @@ describe('fromRpc', () => {
           ],
         })
         .then(Transaction.fromRpc)
-      expect(transaction).toMatchInlineSnapshot(`
+
+      const { blockTimestamp: _, ...transaction_ } = {
+        blockTimestamp: undefined,
+        ...transaction,
+      }
+      expect(transaction_).toMatchInlineSnapshot(`
         {
           "accessList": [],
           "blockHash": "0xc350d807505fb835650f0013632c5515592987ba169bbc6626d9fc54d91f0f0b",

package/src/node/Hash.ts

@@ -12,9 +12,9 @@ export * from '../core/Hash.js'
  * which installs every implementation this entrypoint provides. Reach for this
  * to install or hold the `Hash` slot on its own.
  *
- * Node's `sha3-256` is not Ethereum Keccak256, so this engine deliberately
- * omits `keccak256`. Any earlier override remains installed; otherwise Ox uses
- * its default implementation.
+ * Node does not provide BLAKE3, and its `sha3-256` is not Ethereum Keccak256, so
+ * this engine deliberately omits `blake3` and `keccak256`. Any earlier override
+ * remains installed; otherwise Ox uses its default implementation.
  *
  * @example
  * ```ts twoslash

package/src/node/_test/Hash.test-d.ts

@@ -27,6 +27,7 @@ test('the result is the raw slot, so `Engine.install` accepts it', () => {
 })
 
 test('the Node namespace exposes the public Hash API', () => {
+  expectTypeOf(NodeHash.blake3).toEqualTypeOf(CoreHash.blake3)
   expectTypeOf(NodeHash.sha256).toEqualTypeOf(CoreHash.sha256)
   expectTypeOf<typeof NodeHash>().not.toHaveProperty('create')
 })

package/src/trusted-setups/Paths.ts

@@ -1,3 +1,4 @@
 import { path } from './internal/paths.js'
 
+/** File-system path to the Ethereum mainnet trusted setup. */
 export const mainnet = path('mainnet')

package/src/trusted-setups/README.md

@@ -0,0 +1,39 @@
+# Trusted setup maintenance
+
+Ox bundles the finalized Ethereum KZG ceremony output. This setup is not a
+rolling network parameter, so a new `c-kzg-4844` release does not normally
+change its points.
+
+The committed `mainnet.source.json` records the reviewed `c-kzg-4844` release
+tag, source path, source SHA-256, and generated JSON SHA-256.
+
+## Refresh from c-kzg
+
+1. Review the latest official
+   [`c-kzg-4844` release](https://github.com/ethereum/c-kzg-4844/releases/latest)
+   and its `src/trusted_setup.txt` changes. Do not update from a moving branch.
+2. Pass the selected release tag explicitly:
+
+   ```bash
+   pnpm trusted-setups:update v2.1.8
+   ```
+
+   The command downloads that tagged file, requires 4,096 G1 Lagrange points,
+   4,096 G1 monomial points, and 65 G2 monomial points, then regenerates the
+   canonical JSON, source metadata, and packed TypeScript artifact.
+
+3. Inspect the setup and metadata diff. Treat any point change as
+   security-sensitive. An implementation-only `c-kzg-4844` release should
+   change only the recorded tag when the source bytes are identical.
+4. Verify the generated artifacts and KZG conformance:
+
+   ```bash
+   pnpm trusted-setups:check
+   SKIP_GLOBAL_SETUP=1 pnpm test --project core --bail=1 \
+     src/trusted-setups src/wasm/_test/Kzg.test.ts
+   pnpm check:types
+   ```
+
+`mainnet.json` remains available for file-based consumers through
+`Paths.mainnet`. `mainnet.ts` is the independently tree-shakeable packed
+artifact behind `Setups.mainnet`.

package/src/trusted-setups/Setups.ts

@@ -0,0 +1,46 @@
+import * as Base64 from '../core/Base64.js'
+import type * as Bytes from '../core/Bytes.js'
+import {
+  g1Lagrange,
+  g1Monomial,
+  g2Monomial,
+} from './internal/setups/mainnet.js'
+
+/**
+ * Trusted setup points for EIP-4844 and EIP-7594 KZG operations.
+ */
+export type TrustedSetup = {
+  /** G1 points in Lagrange form. */
+  readonly g1_lagrange: Bytes.Bytes
+  /** G1 points in monomial form. */
+  readonly g1_monomial: Bytes.Bytes
+  /** G2 points in monomial form. */
+  readonly g2_monomial: Bytes.Bytes
+}
+
+/**
+ * Ethereum mainnet trusted setup for EIP-4844 and EIP-7594.
+ *
+ * The setup stores packed points and is safe to reuse across `Kzg.create`
+ * calls. `Kzg.create` copies every field before asynchronous initialization.
+ *
+ * Treat the exported byte arrays as read-only.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Setups } from 'ox/trusted-setups'
+ * import { Kzg } from 'ox/wasm'
+ *
+ * const kzg = await Kzg.create({
+ *   trustedSetup: Setups.mainnet
+ * })
+ *
+ * kzg.dispose()
+ * ```
+ */
+export const mainnet: TrustedSetup = /* @__PURE__ */ Object.freeze({
+  g1_lagrange: /* @__PURE__ */ Base64.toBytes(g1Lagrange),
+  g1_monomial: /* @__PURE__ */ Base64.toBytes(g1Monomial),
+  g2_monomial: /* @__PURE__ */ Base64.toBytes(g2Monomial),
+})

package/src/trusted-setups/_test/Paths.test.ts

@@ -1,3 +1,4 @@
+import { readFileSync } from 'node:fs'
 import { expect, test } from 'vp/test'
 import * as Module from '../Paths.js'
 
@@ -8,3 +9,18 @@ test('exports', () => {
     ]
   `)
 })
+
+test('mainnet resolves to the packaged trusted setup', () => {
+  const setup = JSON.parse(readFileSync(Module.mainnet, 'utf8'))
+  expect({
+    g1Lagrange: setup.g1_lagrange.length,
+    g1Monomial: setup.g1_monomial.length,
+    g2Monomial: setup.g2_monomial.length,
+  }).toMatchInlineSnapshot(`
+    {
+      "g1Lagrange": 4096,
+      "g1Monomial": 4096,
+      "g2Monomial": 65,
+    }
+  `)
+})

package/src/trusted-setups/_test/Setups.test-d.ts

@@ -0,0 +1,7 @@
+import { expectTypeOf, test } from 'vp/test'
+import type * as WasmKzg from '../../wasm/Kzg.js'
+import * as Setups from '../Setups.js'
+
+test('mainnet satisfies the WASM KZG trusted setup', () => {
+  expectTypeOf(Setups.mainnet).toMatchTypeOf<WasmKzg.TrustedSetup>()
+})

package/src/trusted-setups/_test/Setups.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, test } from 'vp/test'
+import * as Hex from '../../core/Hex.js'
+import * as Setups from '../Setups.js'
+
+describe('mainnet', () => {
+  test('exports the canonical PeerDAS setup as packed points', () => {
+    expect({
+      g1Lagrange: {
+        bytes: Setups.mainnet.g1_lagrange.length,
+        first: Hex.fromBytes(Setups.mainnet.g1_lagrange.slice(0, 48)),
+        last: Hex.fromBytes(Setups.mainnet.g1_lagrange.slice(-48)),
+      },
+      g1Monomial: {
+        bytes: Setups.mainnet.g1_monomial.length,
+        first: Hex.fromBytes(Setups.mainnet.g1_monomial.slice(0, 48)),
+        last: Hex.fromBytes(Setups.mainnet.g1_monomial.slice(-48)),
+      },
+      g2Monomial: {
+        bytes: Setups.mainnet.g2_monomial.length,
+        first: Hex.fromBytes(Setups.mainnet.g2_monomial.slice(0, 96)),
+        last: Hex.fromBytes(Setups.mainnet.g2_monomial.slice(-96)),
+      },
+    }).toMatchInlineSnapshot(`
+      {
+        "g1Lagrange": {
+          "bytes": 196608,
+          "first": "0xa0413c0dcafec6dbc9f47d66785cf1e8c981044f7d13cfe3e4fcbb71b5408dfde6312493cb3c1d30516cb3ca88c03654",
+          "last": "0x825a6f586726c68d45f00ad0f5a4436523317939a47713f78fd4fe81cd74236fdac1b04ecd97c2d0267d6f4981d7beb1",
+        },
+        "g1Monomial": {
+          "bytes": 196608,
+          "first": "0x97f1d3a73197d7942695638c4fa9ac0fc3688c4f9774b905a14e3a3f171bac586c55e83ff97a1aeffb3af00adb22c6bb",
+          "last": "0xb0bfaf56a5aa59b48960aa7c1617e832e65c823523fb2a5cd44ba606800501cf873e8db1d0dda64065285743dc40786e",
+        },
+        "g2Monomial": {
+          "bytes": 6240,
+          "first": "0x93e02b6052719f607dacd3a088274f65596bd0d09920b61ab5da61bbdc7f5049334cf11213945d57e5ac7d055d042b7e024aa2b2f08f0a91260805272dc51051c6e47ad4fa403b02b4510b647ae3d1770bac0326a805bbefd48056c8c121bdb8",
+          "last": "0x92dcc5a1c8c3e1b28b1524e3dd6dbecd63017c9201da9dbe077f1b82adc08c50169f56fc7b5a3b28ec6b89254de3e2fd12838a761053437883c3e01ba616670cea843754548ef84bcc397de2369adcca2ab54cd73c55dc68d87aec3fc2fe4f10",
+        },
+      }
+    `)
+  })
+})

package/src/trusted-setups/_test/index.test.ts

@@ -5,6 +5,7 @@ test('exports', () => {
   expect(Object.keys(Module)).toMatchInlineSnapshot(`
     [
       "Paths",
+      "Setups",
     ]
   `)
 })

package/src/trusted-setups/index.ts

@@ -1 +1,22 @@
+/**
+ * File-system paths for trusted setup files bundled with Ox.
+ */
 export * as Paths from './Paths.js'
+
+/**
+ * Trusted setup data bundled with Ox.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Setups } from 'ox/trusted-setups'
+ * import { Kzg } from 'ox/wasm'
+ *
+ * const kzg = await Kzg.create({
+ *   trustedSetup: Setups.mainnet
+ * })
+ *
+ * kzg.dispose()
+ * ```
+ */
+export * as Setups from './Setups.js'

package/src/trusted-setups/internal/paths.ts

@@ -10,5 +10,8 @@ export function path(name: string) {
     import.meta.url,
   )
   const __dirname = dirname(__filename)
-  return resolve(__dirname, `./setups/${name}.json`)
+  return resolve(
+    __dirname,
+    `../../../src/trusted-setups/internal/setups/${name}.json`,
+  )
 }

package/src/trusted-setups/internal/setups/mainnet.source.json

@@ -0,0 +1,7 @@
+{
+  "path": "src/trusted_setup.txt",
+  "repository": "https://github.com/ethereum/c-kzg-4844",
+  "setupSha256": "c4732d98dd1452318e1f1943e240fa4c202a8973a44c24e68c937f86b00f9cb2",
+  "sourceSha256": "d39b9f2d047cc9dca2de58f264b6a09448ccd34db967881a6713eacacf0f26b7",
+  "tag": "v2.1.8"
+}