@aztec/blob-lib 5.2.0-nightly.20260726 → 5.2.0-nightly.20260728

package/dest/kzg_context.d.ts

@@ -1,10 +1,14 @@
+import type { Logger } from '@aztec/foundation/log';
 import type { DasContextJs } from '@crate-crypto/node-eth-kzg';
 export type { DasContextJs } from '@crate-crypto/node-eth-kzg';
 export declare function getBytesPerBlob(): number;
 export declare function getBytesPerCommitment(): number;
 /**
- * Returns the lazily-initialized KZG context.
- * The first call takes ~3 seconds to initialize the precomputation tables.
+ * Returns the lazily-initialized KZG context. The first call synchronously builds the
+ * precomputation tables (~2s locally, blocking the event loop; longer under constrained CPU), so
+ * callers on a latency-sensitive path should warm it ahead of time. Pass a logger to record how
+ * long that first build took.
+ * @param logger - Optional logger; when provided, the initial table build is timed and logged.
  */
-export declare function getKzg(): DasContextJs;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoia3pnX2NvbnRleHQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9remdfY29udGV4dC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQU0vRCxZQUFZLEVBQUUsWUFBWSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFlL0Qsd0JBQWdCLGVBQWUsSUFBSSxNQUFNLENBRXhDO0FBRUQsd0JBQWdCLHFCQUFxQixJQUFJLE1BQU0sQ0FFOUM7QUFJRDs7O0dBR0c7QUFDSCx3QkFBZ0IsTUFBTSxJQUFJLFlBQVksQ0FLckMifQ==
+export declare function getKzg(logger?: Logger): DasContextJs;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoia3pnX2NvbnRleHQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9remdfY29udGV4dC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUdwRCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQU0vRCxZQUFZLEVBQUUsWUFBWSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFlL0Qsd0JBQWdCLGVBQWUsSUFBSSxNQUFNLENBRXhDO0FBRUQsd0JBQWdCLHFCQUFxQixJQUFJLE1BQU0sQ0FFOUM7QUFJRDs7Ozs7O0dBTUc7QUFDSCx3QkFBZ0IsTUFBTSxDQUFDLE1BQU0sQ0FBQyxFQUFFLE1BQU0sR0FBRyxZQUFZLENBT3BEIn0=

package/dest/kzg_context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kzg_context.d.ts","sourceRoot":"","sources":["../src/kzg_context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAM/D,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAe/D,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAID;;;GAGG;AACH,wBAAgB,MAAM,IAAI,YAAY,CAKrC"}
+{"version":3,"file":"kzg_context.d.ts","sourceRoot":"","sources":["../src/kzg_context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAM/D,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAe/D,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAID;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAOpD"}

package/dest/kzg_context.js

@@ -1,3 +1,4 @@
+import { elapsedSync } from '@aztec/foundation/timer';
 import { createRequire } from 'module';
 let nativeModule;
 /** Lazily loads the @crate-crypto/node-eth-kzg native module. */ function loadNativeModule() {
@@ -17,12 +18,19 @@ export function getBytesPerCommitment() {
 }
 let kzgInstance;
 /**
- * Returns the lazily-initialized KZG context.
- * The first call takes ~3 seconds to initialize the precomputation tables.
- */ export function getKzg() {
+ * Returns the lazily-initialized KZG context. The first call synchronously builds the
+ * precomputation tables (~2s locally, blocking the event loop; longer under constrained CPU), so
+ * callers on a latency-sensitive path should warm it ahead of time. Pass a logger to record how
+ * long that first build took.
+ * @param logger - Optional logger; when provided, the initial table build is timed and logged.
+ */ export function getKzg(logger) {
     if (!kzgInstance) {
-        kzgInstance = loadNativeModule().DasContextJs.create({
-            usePrecomp: true
+        const [durationMs, instance] = elapsedSync(()=>loadNativeModule().DasContextJs.create({
+                usePrecomp: true
+            }));
+        kzgInstance = instance;
+        logger?.verbose(`Loaded KZG trusted setup`, {
+            durationMs
         });
     }
     return kzgInstance;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aztec/blob-lib",
-  "version": "5.2.0-nightly.20260726",
+  "version": "5.2.0-nightly.20260728",
   "type": "module",
   "exports": {
     ".": "./dest/index.js",
@@ -27,8 +27,8 @@
     "../package.common.json"
   ],
   "dependencies": {
-    "@aztec/constants": "5.2.0-nightly.20260726",
-    "@aztec/foundation": "5.2.0-nightly.20260726",
+    "@aztec/constants": "5.2.0-nightly.20260728",
+    "@aztec/foundation": "5.2.0-nightly.20260728",
     "@crate-crypto/node-eth-kzg": "^0.10.0",
     "tslib": "^2.4.0"
   },

package/src/kzg_context.ts

@@ -1,3 +1,6 @@
+import type { Logger } from '@aztec/foundation/log';
+import { elapsedSync } from '@aztec/foundation/timer';
+
 import type { DasContextJs } from '@crate-crypto/node-eth-kzg';
 import { createRequire } from 'module';
 
@@ -30,12 +33,17 @@ export function getBytesPerCommitment(): number {
 let kzgInstance: DasContextJs | undefined;
 
 /**
- * Returns the lazily-initialized KZG context.
- * The first call takes ~3 seconds to initialize the precomputation tables.
+ * Returns the lazily-initialized KZG context. The first call synchronously builds the
+ * precomputation tables (~2s locally, blocking the event loop; longer under constrained CPU), so
+ * callers on a latency-sensitive path should warm it ahead of time. Pass a logger to record how
+ * long that first build took.
+ * @param logger - Optional logger; when provided, the initial table build is timed and logged.
  */
-export function getKzg(): DasContextJs {
+export function getKzg(logger?: Logger): DasContextJs {
   if (!kzgInstance) {
-    kzgInstance = loadNativeModule().DasContextJs.create({ usePrecomp: true });
+    const [durationMs, instance] = elapsedSync(() => loadNativeModule().DasContextJs.create({ usePrecomp: true }));
+    kzgInstance = instance;
+    logger?.verbose(`Loaded KZG trusted setup`, { durationMs });
   }
   return kzgInstance;
 }