@aztec/stdlib 5.0.0-nightly.20260625 → 5.0.0-nightly.20260627

package/dest/interfaces/aztec-node-debug.d.ts

@@ -28,6 +28,24 @@ export interface AztecNodeDebug {
      * @throws If no automine sequencer is running (only the automine sequencer supports synthetic proving).
      */
     prove(upToCheckpoint?: CheckpointNumber): Promise<CheckpointNumber>;
+    /**
+     * Warps L1 time forward to at least `targetTimestamp` and builds an empty L2 checkpoint at the next slot boundary,
+     * advancing the L2 timestamp to at least the target. The warp is serialized with block building, so it never
+     * interleaves with an in-flight build. A no-op when `targetTimestamp` is already at or behind the current L1 time.
+     *
+     * @param targetTimestamp - Target L1 timestamp, in seconds.
+     * @throws If no automine sequencer is running (only the automine sequencer supports time warps).
+     */
+    warpL2TimeAtLeastTo(targetTimestamp: number): Promise<void>;
+    /**
+     * Warps L1 time forward by at least `duration` seconds from the current L1 time and builds an empty L2 checkpoint
+     * at the next slot boundary. The warp is serialized with block building, so it never interleaves with an in-flight
+     * build.
+     *
+     * @param duration - Number of seconds to advance; must be positive.
+     * @throws If no automine sequencer is running, or if `duration` is not positive.
+     */
+    warpL2TimeAtLeastBy(duration: number): Promise<void>;
     /**
      * Registers public function signatures so the node can resolve selectors to names in public-execution stack
      * traces. The mapping lives only in unpersisted node memory, is not gossiped, and is exposed here (rather than on
@@ -38,4 +56,4 @@ export interface AztecNodeDebug {
 }
 export declare const AztecNodeDebugApiSchema: ApiSchemaFor<AztecNodeDebug>;
 export declare function createAztecNodeDebugClient(url: string, versions?: Partial<ComponentsVersions>, fetch?: typeof defaultFetch, apiKey?: string): AztecNodeDebug;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXp0ZWMtbm9kZS1kZWJ1Zy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ludGVyZmFjZXMvYXp0ZWMtbm9kZS1kZWJ1Zy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxnQkFBZ0IsRUFBMEIsTUFBTSxpQ0FBaUMsQ0FBQztBQUNoRyxPQUFPLEVBQTJCLFlBQVksRUFBRSxNQUFNLG1DQUFtQyxDQUFDO0FBSTFGLE9BQU8sRUFBRSxLQUFLLFlBQVksRUFBWSxNQUFNLHVCQUF1QixDQUFDO0FBQ3BFLE9BQU8sRUFBRSxLQUFLLGtCQUFrQixFQUFnQyxNQUFNLHdCQUF3QixDQUFDO0FBSy9GOztHQUVHO0FBQ0gsTUFBTSxXQUFXLGNBQWM7SUFDN0I7Ozs7Ozs7O09BUUc7SUFDSCxTQUFTLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRTNCOzs7Ozs7Ozs7O09BVUc7SUFDSCxLQUFLLENBQUMsY0FBYyxDQUFDLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBQUM7SUFFcEU7Ozs7O09BS0c7SUFDSCxrQ0FBa0MsQ0FBQyxrQkFBa0IsRUFBRSxNQUFNLEVBQUUsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7Q0FDakY7QUFFRCxlQUFPLE1BQU0sdUJBQXVCLEVBQUUsWUFBWSxDQUFDLGNBQWMsQ0FPaEUsQ0FBQztBQUVGLHdCQUFnQiwwQkFBMEIsQ0FDeEMsR0FBRyxFQUFFLE1BQU0sRUFDWCxRQUFRLEdBQUUsT0FBTyxDQUFDLGtCQUFrQixDQUFNLEVBQzFDLEtBQUssc0JBQWUsRUFDcEIsTUFBTSxDQUFDLEVBQUUsTUFBTSxHQUNkLGNBQWMsQ0FPaEIifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXp0ZWMtbm9kZS1kZWJ1Zy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ludGVyZmFjZXMvYXp0ZWMtbm9kZS1kZWJ1Zy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxnQkFBZ0IsRUFBMEIsTUFBTSxpQ0FBaUMsQ0FBQztBQUNoRyxPQUFPLEVBQTJCLFlBQVksRUFBRSxNQUFNLG1DQUFtQyxDQUFDO0FBSTFGLE9BQU8sRUFBRSxLQUFLLFlBQVksRUFBWSxNQUFNLHVCQUF1QixDQUFDO0FBQ3BFLE9BQU8sRUFBRSxLQUFLLGtCQUFrQixFQUFnQyxNQUFNLHdCQUF3QixDQUFDO0FBSy9GOztHQUVHO0FBQ0gsTUFBTSxXQUFXLGNBQWM7SUFDN0I7Ozs7Ozs7O09BUUc7SUFDSCxTQUFTLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRTNCOzs7Ozs7Ozs7O09BVUc7SUFDSCxLQUFLLENBQUMsY0FBYyxDQUFDLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBQUM7SUFFcEU7Ozs7Ozs7T0FPRztJQUNILG1CQUFtQixDQUFDLGVBQWUsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRTVEOzs7Ozs7O09BT0c7SUFDSCxtQkFBbUIsQ0FBQyxRQUFRLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVyRDs7Ozs7T0FLRztJQUNILGtDQUFrQyxDQUFDLGtCQUFrQixFQUFFLE1BQU0sRUFBRSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztDQUNqRjtBQUVELGVBQU8sTUFBTSx1QkFBdUIsRUFBRSxZQUFZLENBQUMsY0FBYyxDQVNoRSxDQUFDO0FBRUYsd0JBQWdCLDBCQUEwQixDQUN4QyxHQUFHLEVBQUUsTUFBTSxFQUNYLFFBQVEsR0FBRSxPQUFPLENBQUMsa0JBQWtCLENBQU0sRUFDMUMsS0FBSyxzQkFBZSxFQUNwQixNQUFNLENBQUMsRUFBRSxNQUFNLEdBQ2QsY0FBYyxDQU9oQiJ9

package/dest/interfaces/aztec-node-debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aztec-node-debug.d.ts","sourceRoot":"","sources":["../../src/interfaces/aztec-node-debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAA0B,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAA2B,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAI1F,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,KAAK,kBAAkB,EAAgC,MAAM,wBAAwB,CAAC;AAK/F;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;OAQG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,cAAc,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEpE;;;;;OAKG;IACH,kCAAkC,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF;AAED,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAAC,cAAc,CAOhE,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,OAAO,CAAC,kBAAkB,CAAM,EAC1C,KAAK,sBAAe,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,cAAc,CAOhB"}
+{"version":3,"file":"aztec-node-debug.d.ts","sourceRoot":"","sources":["../../src/interfaces/aztec-node-debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAA0B,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAA2B,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAI1F,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,KAAK,kBAAkB,EAAgC,MAAM,wBAAwB,CAAC;AAK/F;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;OAQG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,cAAc,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEpE;;;;;;;OAOG;IACH,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;;;OAOG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;;;OAKG;IACH,kCAAkC,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF;AAED,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAAC,cAAc,CAShE,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,OAAO,CAAC,kBAAkB,CAAM,EAC1C,KAAK,sBAAe,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,cAAc,CAOhB"}

package/dest/interfaces/aztec-node-debug.js

@@ -16,6 +16,18 @@ export const AztecNodeDebugApiSchema = {
         ]),
         output: CheckpointNumberSchema
     }),
+    warpL2TimeAtLeastTo: z.function({
+        input: z.tuple([
+            z.number()
+        ]),
+        output: z.void()
+    }),
+    warpL2TimeAtLeastBy: z.function({
+        input: z.tuple([
+            z.number()
+        ]),
+        output: z.void()
+    }),
     registerContractFunctionSignatures: z.function({
         input: z.tuple([
             z.array(z.string().max(MAX_SIGNATURE_LEN)).max(MAX_SIGNATURES_PER_REGISTER_CALL)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aztec/stdlib",
-  "version": "5.0.0-nightly.20260625",
+  "version": "5.0.0-nightly.20260627",
   "type": "module",
   "inherits": [
     "../package.common.json",
@@ -92,13 +92,13 @@
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.892.0",
-    "@aztec/bb.js": "5.0.0-nightly.20260625",
-    "@aztec/blob-lib": "5.0.0-nightly.20260625",
-    "@aztec/constants": "5.0.0-nightly.20260625",
-    "@aztec/ethereum": "5.0.0-nightly.20260625",
-    "@aztec/foundation": "5.0.0-nightly.20260625",
-    "@aztec/l1-artifacts": "5.0.0-nightly.20260625",
-    "@aztec/noir-noirc_abi": "5.0.0-nightly.20260625",
+    "@aztec/bb.js": "5.0.0-nightly.20260627",
+    "@aztec/blob-lib": "5.0.0-nightly.20260627",
+    "@aztec/constants": "5.0.0-nightly.20260627",
+    "@aztec/ethereum": "5.0.0-nightly.20260627",
+    "@aztec/foundation": "5.0.0-nightly.20260627",
+    "@aztec/l1-artifacts": "5.0.0-nightly.20260627",
+    "@aztec/noir-noirc_abi": "5.0.0-nightly.20260627",
     "@google-cloud/storage": "^7.15.0",
     "axios": "^1.15.1",
     "json-stringify-deterministic": "1.0.12",

package/src/interfaces/aztec-node-debug.ts

@@ -37,6 +37,26 @@ export interface AztecNodeDebug {
    */
   prove(upToCheckpoint?: CheckpointNumber): Promise<CheckpointNumber>;
 
+  /**
+   * Warps L1 time forward to at least `targetTimestamp` and builds an empty L2 checkpoint at the next slot boundary,
+   * advancing the L2 timestamp to at least the target. The warp is serialized with block building, so it never
+   * interleaves with an in-flight build. A no-op when `targetTimestamp` is already at or behind the current L1 time.
+   *
+   * @param targetTimestamp - Target L1 timestamp, in seconds.
+   * @throws If no automine sequencer is running (only the automine sequencer supports time warps).
+   */
+  warpL2TimeAtLeastTo(targetTimestamp: number): Promise<void>;
+
+  /**
+   * Warps L1 time forward by at least `duration` seconds from the current L1 time and builds an empty L2 checkpoint
+   * at the next slot boundary. The warp is serialized with block building, so it never interleaves with an in-flight
+   * build.
+   *
+   * @param duration - Number of seconds to advance; must be positive.
+   * @throws If no automine sequencer is running, or if `duration` is not positive.
+   */
+  warpL2TimeAtLeastBy(duration: number): Promise<void>;
+
   /**
    * Registers public function signatures so the node can resolve selectors to names in public-execution stack
    * traces. The mapping lives only in unpersisted node memory, is not gossiped, and is exposed here (rather than on
@@ -49,6 +69,8 @@ export interface AztecNodeDebug {
 export const AztecNodeDebugApiSchema: ApiSchemaFor<AztecNodeDebug> = {
   mineBlock: z.function({ input: z.tuple([]), output: z.void() }),
   prove: z.function({ input: z.tuple([optional(CheckpointNumberSchema)]), output: CheckpointNumberSchema }),
+  warpL2TimeAtLeastTo: z.function({ input: z.tuple([z.number()]), output: z.void() }),
+  warpL2TimeAtLeastBy: z.function({ input: z.tuple([z.number()]), output: z.void() }),
   registerContractFunctionSignatures: z.function({
     input: z.tuple([z.array(z.string().max(MAX_SIGNATURE_LEN)).max(MAX_SIGNATURES_PER_REGISTER_CALL)]),
     output: z.void(),