@aztec/stdlib 0.82.2 → 0.82.3

package/dest/avm/avm_proving_request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avm_proving_request.d.ts","sourceRoot":"","sources":["../../src/avm/avm_proving_request.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGlC,CAAC"}
+{"version":3,"file":"avm_proving_request.d.ts","sourceRoot":"","sources":["../../src/avm/avm_proving_request.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGlC,CAAC"}

package/dest/block/l2_block_downloader/l2_block_stream.d.ts

@@ -9,6 +9,7 @@ export declare class L2BlockStream {
     private opts;
     private readonly runningPromise;
     private isSyncing;
+    private hasStarted;
     constructor(l2BlockSource: Pick<L2BlockSource, 'getPublishedBlocks' | 'getBlockHeader' | 'getL2Tips'>, localData: L2BlockStreamLocalDataProvider, handler: L2BlockStreamEventHandler, log?: import("@aztec/foundation/log").Logger, opts?: {
         proven?: boolean;
         pollIntervalMS?: number;

package/dest/block/l2_block_downloader/l2_block_stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"l2_block_stream.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_downloader/l2_block_stream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,uHAAuH;AACvH,qBAAa,aAAa;IAKtB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,IAAI;IARd,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,SAAS,CAAS;gBAGhB,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,oBAAoB,GAAG,gBAAgB,GAAG,WAAW,CAAC,EACzF,SAAS,EAAE,8BAA8B,EACzC,OAAO,EAAE,yBAAyB,EACzB,GAAG,yCAAqC,EACjD,IAAI,GAAE;QACZ,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACnB;IAKD,KAAK;IAKC,IAAI;IAIV,SAAS;IAIH,IAAI;cAMD,IAAI;IA+DpB;;;;OAIG;YACW,qBAAqB;YAoBrB,SAAS;CASxB;AAED,8FAA8F;AAC9F,MAAM,WAAW,8BAA8B;IAC7C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5D,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,qCAAqC;IACrC,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}
+{"version":3,"file":"l2_block_stream.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_downloader/l2_block_stream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,uHAAuH;AACvH,qBAAa,aAAa;IAMtB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,IAAI;IATd,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAGjB,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,oBAAoB,GAAG,gBAAgB,GAAG,WAAW,CAAC,EACzF,SAAS,EAAE,8BAA8B,EACzC,OAAO,EAAE,yBAAyB,EACzB,GAAG,yCAAqC,EACjD,IAAI,GAAE;QACZ,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACnB;IAKD,KAAK;IAKC,IAAI;IAIV,SAAS;IAIH,IAAI;cAMD,IAAI;IAoEpB;;;;OAIG;YACW,qBAAqB;YAoBrB,SAAS;CASxB;AAED,8FAA8F;AAC9F,MAAM,WAAW,8BAA8B;IAC7C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5D,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,qCAAqC;IACrC,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dest/block/l2_block_downloader/l2_block_stream.js

@@ -9,6 +9,7 @@ import { RunningPromise } from '@aztec/foundation/running-promise';
     opts;
     runningPromise;
     isSyncing;
+    hasStarted;
     constructor(l2BlockSource, localData, handler, log = createLogger('types:block_stream'), opts = {}){
         this.l2BlockSource = l2BlockSource;
         this.localData = localData;
@@ -16,6 +17,7 @@ import { RunningPromise } from '@aztec/foundation/running-promise';
         this.log = log;
         this.opts = opts;
         this.isSyncing = false;
+        this.hasStarted = false;
         this.runningPromise = new RunningPromise(()=>this.work(), log, this.opts.pollIntervalMS ?? 1000);
     }
     start() {
@@ -70,7 +72,11 @@ import { RunningPromise } from '@aztec/foundation/running-promise';
             // If we are just starting, use the starting block number from the options.
             if (latestBlockNumber === 0 && this.opts.startingBlock !== undefined) {
                 latestBlockNumber = Math.max(this.opts.startingBlock - 1, 0);
+            }
+            // Only log this entry once (for sanity)
+            if (!this.hasStarted) {
                 this.log.verbose(`Starting sync from block number ${latestBlockNumber}`);
+                this.hasStarted = true;
             }
             // Request new blocks from the source.
             while(latestBlockNumber < sourceTips.latest.number){

package/dest/database-version/version_manager.d.ts

@@ -48,6 +48,7 @@ export declare class DatabaseVersion {
     static empty(): DatabaseVersion;
 }
 export type DatabaseVersionManagerFs = Pick<typeof fs, 'readFile' | 'writeFile' | 'rm' | 'mkdir'>;
+export declare const DATABASE_VERSION_FILE_NAME = "db_version";
 /**
  * A manager for handling database versioning and migrations.
  * This class will check the version of data in a directory and either
@@ -75,6 +76,7 @@ export declare class DatabaseVersionManager<T> {
      * @param options - Configuration options
      */
     constructor(schemaVersion: number, rollupAddress: EthAddress, dataDirectory: string, onOpen: (dataDir: string) => Promise<T>, onUpgrade?: ((dataDir: string, currentVersion: number, latestVersion: number) => Promise<void>) | undefined, fileSystem?: DatabaseVersionManagerFs, log?: import("@aztec/foundation/log").Logger);
+    static writeVersion(version: DatabaseVersion, dataDir: string, fileSystem?: DatabaseVersionManagerFs): Promise<void>;
     /**
      * Checks the stored version against the current version and handles the outcome
      * by either resetting the data directory or calling an upgrade function
@@ -87,11 +89,11 @@ export declare class DatabaseVersionManager<T> {
     /**
      * Writes the current version to the version file
      */
-    private writeVersion;
+    writeVersion(dir?: string): Promise<void>;
     /**
      * Resets the data directory by deleting it and recreating it
      */
-    private resetDataDirectory;
+    resetDataDirectory(): Promise<void>;
     /**
      * Get the data directory path
      */

package/dest/database-version/version_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version_manager.d.ts","sourceRoot":"","sources":["../../src/database-version/version_manager.ts"],"names":[],"mappings":";;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAI3D,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,qBAAa,eAAe;aACE,aAAa,EAAE,MAAM;aAAkB,aAAa,EAAE,UAAU;gBAAhE,aAAa,EAAE,MAAM,EAAkB,aAAa,EAAE,UAAU;IAErF,QAAQ,IAAI,MAAM;WAIX,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAQtD;;OAEG;IACI,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAa1D;;OAEG;IACI,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IAI9C;;OAEG;IACH,MAAM,KAAK,MAAM;;;;;;;;;;;;OAOhB;IAED,uCAAuC;IAChC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;IAI1B,QAAQ,IAAI,MAAM;IAIzB;;OAEG;IACH,MAAM,CAAC,KAAK;CAGb;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC;AAElG;;;;GAIG;AACH,qBAAa,sBAAsB,CAAC,CAAC;IAqBjC,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS,CAAC;IAClB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,GAAG;IAxBb,gBAAuB,YAAY,gBAAgB;IAEnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IAEjD;;;;;;;;;;;OAWG;gBAED,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,UAAU,EACjB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,SAAS,CAAC,aAAY,MAAM,kBAAkB,MAAM,iBAAiB,MAAM,KAAK,QAAQ,IAAI,CAAC,aAAA,EAC7F,UAAU,GAAE,wBAA6B,EACzC,GAAG,yCAA6C;IAU1D;;;;;;;OAOG;IACU,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAmD1C;;OAEG;YACW,YAAY;IAO1B;;OAEG;YACW,kBAAkB;IAUhC;;OAEG;IACI,gBAAgB,IAAI,MAAM;IAIjC;;OAEG;IACI,gBAAgB,IAAI,MAAM;CAGlC"}
+{"version":3,"file":"version_manager.d.ts","sourceRoot":"","sources":["../../src/database-version/version_manager.ts"],"names":[],"mappings":";;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAI3D,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,qBAAa,eAAe;aACE,aAAa,EAAE,MAAM;aAAkB,aAAa,EAAE,UAAU;gBAAhE,aAAa,EAAE,MAAM,EAAkB,aAAa,EAAE,UAAU;IAErF,QAAQ,IAAI,MAAM;WAIX,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAQtD;;OAEG;IACI,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAa1D;;OAEG;IACI,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IAI9C;;OAEG;IACH,MAAM,KAAK,MAAM;;;;;;;;;;;;OAOhB;IAED,uCAAuC;IAChC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;IAI1B,QAAQ,IAAI,MAAM;IAIzB;;OAEG;IACH,MAAM,CAAC,KAAK;CAGb;AAED,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC;AAElG,eAAO,MAAM,0BAA0B,eAAe,CAAC;AAEvD;;;;GAIG;AACH,qBAAa,sBAAsB,CAAC,CAAC;IAqBjC,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS,CAAC;IAClB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,GAAG;IAxBb,gBAAuB,YAAY,gBAA8B;IAEjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IAEjD;;;;;;;;;;;OAWG;gBAED,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,UAAU,EACjB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,SAAS,CAAC,aAAY,MAAM,kBAAkB,MAAM,iBAAiB,MAAM,KAAK,QAAQ,IAAI,CAAC,aAAA,EAC7F,UAAU,GAAE,wBAA6B,EACzC,GAAG,yCAA6C;WAU7C,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,wBAA6B;IAK9G;;;;;;;OAOG;IACU,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAmD1C;;OAEG;IACI,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;IACU,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUhD;;OAEG;IACI,gBAAgB,IAAI,MAAM;IAIjC;;OAEG;IACI,gBAAgB,IAAI,MAAM;CAGlC"}

package/dest/database-version/version_manager.js

@@ -65,6 +65,7 @@ import { z } from 'zod';
         return new DatabaseVersion(0, EthAddress.ZERO);
     }
 }
+export const DATABASE_VERSION_FILE_NAME = 'db_version';
 /**
  * A manager for handling database versioning and migrations.
  * This class will check the version of data in a directory and either
@@ -75,7 +76,7 @@ import { z } from 'zod';
     onUpgrade;
     fileSystem;
     log;
-    static VERSION_FILE = 'db_version';
+    static VERSION_FILE = DATABASE_VERSION_FILE_NAME;
     versionFile;
     currentVersion;
     /**
@@ -101,6 +102,12 @@ import { z } from 'zod';
         this.versionFile = join(this.dataDirectory, DatabaseVersionManager.VERSION_FILE);
         this.currentVersion = new DatabaseVersion(schemaVersion, rollupAddress);
     }
+    static async writeVersion(version, dataDir, fileSystem = fs) {
+        await fileSystem.mkdir(dataDir, {
+            recursive: true
+        });
+        return fileSystem.writeFile(join(dataDir, DatabaseVersionManager.VERSION_FILE), version.toBuffer());
+    }
     /**
    * Checks the stored version against the current version and handles the outcome
    * by either resetting the data directory or calling an upgrade function
@@ -139,7 +146,9 @@ import { z } from 'zod';
                 needsReset = true;
             }
         } else {
-            this.log.warn('Rollup address changed, resetting data directory');
+            this.log.warn('Rollup address changed, resetting data directory', {
+                versionFile: this.versionFile
+            });
             needsReset = true;
         }
         // Handle reset if needed
@@ -155,13 +164,8 @@ import { z } from 'zod';
     }
     /**
    * Writes the current version to the version file
-   */ async writeVersion() {
-        // Ensure the directory exists
-        await this.fileSystem.mkdir(this.dataDirectory, {
-            recursive: true
-        });
-        // Write the version file
-        await this.fileSystem.writeFile(this.versionFile, this.currentVersion.toBuffer());
+   */ writeVersion(dir) {
+        return DatabaseVersionManager.writeVersion(this.currentVersion, dir ?? this.dataDirectory, this.fileSystem);
     }
     /**
    * Resets the data directory by deleting it and recreating it

package/dest/epoch-helpers/index.d.ts

@@ -26,6 +26,8 @@ export declare const L1RollupConstantsSchema: z.ZodObject<{
     epochDuration: number;
     ethereumSlotDuration: number;
 }>;
+/** Returns the timestamp for a given L2 slot. */
+export declare function getTimestampForSlot(slot: bigint, constants: Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration'>): bigint;
 /** Returns the slot number for a given timestamp. */
 export declare function getSlotAtTimestamp(ts: bigint, constants: Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration'>): bigint;
 /** Returns the epoch number for a given timestamp. */

package/dest/epoch-helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/epoch-helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,iBAMpC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EAME,CAAC;AAEvC,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,CAAC,UAElH;AAED,sDAAsD;AACtD,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,CAAC,UAGvF;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,UAE/F;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,YAG5G;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,sBAAsB,CAAC,YAUhH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/epoch-helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,iBAMpC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EAME,CAAC;AAEvC,iDAAiD;AACjD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,CAAC,UAGrE;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,CAAC,UAElH;AAED,sDAAsD;AACtD,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,CAAC,UAGvF;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,UAE/F;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,YAG5G;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,sBAAsB,CAAC,YAUhH"}

package/dest/epoch-helpers/index.js

@@ -14,6 +14,9 @@ export const L1RollupConstantsSchema = z.object({
     epochDuration: z.number(),
     ethereumSlotDuration: z.number()
 });
+/** Returns the timestamp for a given L2 slot. */ export function getTimestampForSlot(slot, constants) {
+    return constants.l1GenesisTime + slot * BigInt(constants.slotDuration);
+}
 /** Returns the slot number for a given timestamp. */ export function getSlotAtTimestamp(ts, constants) {
     return ts < constants.l1GenesisTime ? 0n : (ts - constants.l1GenesisTime) / BigInt(constants.slotDuration);
 }

package/dest/file-store/factory.d.ts

@@ -0,0 +1,7 @@
+import { type Logger } from '@aztec/foundation/log';
+import type { FileStore, ReadOnlyFileStore } from './interface.js';
+export declare function createFileStore(config: string, logger?: Logger): Promise<FileStore>;
+export declare function createFileStore(config: undefined, logger?: Logger): Promise<undefined>;
+export declare function createReadOnlyFileStore(config: string, logger?: Logger): Promise<ReadOnlyFileStore>;
+export declare function createReadOnlyFileStore(config: undefined, logger?: Logger): Promise<undefined>;
+//# sourceMappingURL=factory.d.ts.map

package/dest/file-store/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/file-store/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAIlE,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AASnE,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAC3F,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAgC9F,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAC3G,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dest/file-store/factory.js

@@ -0,0 +1,46 @@
+import { createLogger } from '@aztec/foundation/log';
+import { GoogleCloudFileStore } from './gcs.js';
+import { HttpFileStore } from './http.js';
+import { LocalFileStore } from './local.js';
+const supportedExamples = [
+    `gs://bucket-name/path/to/store`,
+    `file:///absolute/local/path/to/store`,
+    `https://host/path`
+];
+export async function createFileStore(config, logger = createLogger('stdlib:file-store')) {
+    if (config === undefined) {
+        return undefined;
+    } else if (config.startsWith('file://')) {
+        const url = new URL(config);
+        if (url.host) {
+            throw new Error(`File store URL only supports local paths (got host ${url.host} from ${config})`);
+        }
+        const path = url.pathname;
+        logger.info(`Creating local file file store at ${path}`);
+        return new LocalFileStore(path);
+    } else if (config.startsWith('gs://')) {
+        try {
+            const url = new URL(config);
+            const bucket = url.host;
+            const path = url.pathname.replace(/^\/+/, '');
+            logger.info(`Creating google cloud file store at ${bucket} ${path}`);
+            const store = new GoogleCloudFileStore(bucket, path);
+            await store.checkCredentials();
+            return store;
+        } catch (err) {
+            throw new Error(`Invalid google cloud store definition: '${config}'.`);
+        }
+    } else {
+        throw new Error(`Unknown file store config: '${config}'. Supported values are ${supportedExamples.join(', ')}.`);
+    }
+}
+export async function createReadOnlyFileStore(config, logger = createLogger('stdlib:file-store')) {
+    if (config === undefined) {
+        return undefined;
+    } else if (config.startsWith('http://') || config.startsWith('https://')) {
+        logger.info(`Creating read-only HTTP file store at ${config}`);
+        return new HttpFileStore(config, logger);
+    } else {
+        return await createFileStore(config, logger);
+    }
+}

package/dest/file-store/gcs.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { type Logger } from '@aztec/foundation/log';
+import type { FileStore, FileStoreSaveOptions } from './interface.js';
+export declare class GoogleCloudFileStore implements FileStore {
+    private readonly bucketName;
+    private readonly basePath;
+    private readonly log;
+    private readonly storage;
+    constructor(bucketName: string, basePath: string, log?: Logger);
+    checkCredentials(): Promise<void>;
+    save(path: string, data: Buffer, opts?: FileStoreSaveOptions): Promise<string>;
+    upload(destPath: string, srcPath: string, opts?: FileStoreSaveOptions): Promise<string>;
+    private handleUploadedFile;
+    read(pathOrUrlStr: string): Promise<Buffer>;
+    download(pathOrUrlStr: string, destPath: string): Promise<void>;
+    exists(pathOrUrlStr: string): Promise<boolean>;
+    private getFileObject;
+    private getBucketAndFullPath;
+    private getFullPath;
+}
+//# sourceMappingURL=gcs.d.ts.map

package/dest/file-store/gcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.d.ts","sourceRoot":"","sources":["../../src/file-store/gcs.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAKlE,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,qBAAa,oBAAqB,YAAW,SAAS;IAIlD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAGf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAA8C;IAKzD,gBAAgB;IAIhB,IAAI,CACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,oBAAuE,GAC5E,OAAO,CAAC,MAAM,CAAC;IAYL,MAAM,CACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,oBAAsE,GAC3E,OAAO,CAAC,MAAM,CAAC;YAiBJ,kBAAkB;IAmBnB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3C,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/D,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAQ7C,aAAa;IAU3B,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,WAAW;CAGpB"}

package/dest/file-store/gcs.js

@@ -0,0 +1,115 @@
+import { createLogger } from '@aztec/foundation/log';
+import { Storage } from '@google-cloud/storage';
+import { join } from 'path';
+export class GoogleCloudFileStore {
+    bucketName;
+    basePath;
+    log;
+    storage;
+    constructor(bucketName, basePath, log = createLogger('stdlib:gcs-file-store')){
+        this.bucketName = bucketName;
+        this.basePath = basePath;
+        this.log = log;
+        this.storage = new Storage();
+    }
+    async checkCredentials() {
+        await this.storage.getServiceAccount();
+    }
+    async save(path, data, opts = {
+        public: false,
+        metadata: {},
+        compress: false
+    }) {
+        const fullPath = this.getFullPath(path);
+        try {
+            const bucket = this.storage.bucket(this.bucketName);
+            const file = bucket.file(fullPath);
+            await file.save(data, {
+                metadata: opts.metadata,
+                gzip: opts.compress
+            });
+            return this.handleUploadedFile(file, opts);
+        } catch (err) {
+            throw new Error(`Error saving file to google cloud storage at ${fullPath}: ${err.message ?? err}`);
+        }
+    }
+    async upload(destPath, srcPath, opts = {
+        compress: true,
+        public: false,
+        metadata: {}
+    }) {
+        const fullPath = this.getFullPath(destPath);
+        try {
+            const bucket = this.storage.bucket(this.bucketName);
+            const file = bucket.file(fullPath);
+            const uploadOpts = {
+                destination: file,
+                gzip: opts.compress,
+                metadata: opts.metadata
+            };
+            await bucket.upload(srcPath, uploadOpts);
+            return this.handleUploadedFile(file, opts);
+        } catch (err) {
+            throw new Error(`Error saving file to google cloud storage at ${fullPath}: ${err.message ?? err}`);
+        }
+    }
+    async handleUploadedFile(file, opts) {
+        if (opts.public) {
+            try {
+                if (!await file.isPublic()) {
+                    await file.makePublic();
+                }
+            } catch (err) {
+                this.log.warn(`Error making file ${file.name} public: ${err.message ?? err}. This is expected if we handle public access at the bucket level.`);
+            }
+            return file.publicUrl().replaceAll('%2F', '/');
+        } else {
+            return file.cloudStorageURI.toString();
+        }
+    }
+    async read(pathOrUrlStr) {
+        const file = await this.getFileObject(pathOrUrlStr);
+        const contents = await file.download();
+        return contents[0];
+    }
+    async download(pathOrUrlStr, destPath) {
+        const file = await this.getFileObject(pathOrUrlStr);
+        await file.download({
+            destination: destPath
+        });
+    }
+    async exists(pathOrUrlStr) {
+        const { bucketName, fullPath } = this.getBucketAndFullPath(pathOrUrlStr);
+        const bucket = this.storage.bucket(bucketName);
+        const file = bucket.file(fullPath);
+        const [exists] = await file.exists();
+        return exists;
+    }
+    async getFileObject(pathOrUrlStr) {
+        const { bucketName, fullPath } = this.getBucketAndFullPath(pathOrUrlStr);
+        const bucket = this.storage.bucket(bucketName);
+        const file = bucket.file(fullPath);
+        if (!await file.exists()) {
+            throw new Error(`File at ${fullPath} in gcs bucket ${bucketName} does not exist`);
+        }
+        return file;
+    }
+    getBucketAndFullPath(pathOrUrlStr) {
+        if (URL.canParse(pathOrUrlStr)) {
+            const url = new URL(pathOrUrlStr);
+            // Note that we accept reading from anywhere, not just our bucket
+            return {
+                fullPath: url.pathname.replace(/^\/+/, ''),
+                bucketName: url.host
+            };
+        } else {
+            return {
+                fullPath: this.getFullPath(pathOrUrlStr),
+                bucketName: this.bucketName
+            };
+        }
+    }
+    getFullPath(path) {
+        return this.basePath && this.basePath.length > 0 ? join(this.basePath, path) : path;
+    }
+}

package/dest/file-store/http.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { type Logger } from '@aztec/foundation/log';
+import type { ReadOnlyFileStore } from './interface.js';
+export declare class HttpFileStore implements ReadOnlyFileStore {
+    private readonly baseUrl;
+    private readonly log;
+    private readonly fetch;
+    constructor(baseUrl: string, log?: Logger);
+    read(pathOrUrl: string): Promise<Buffer>;
+    download(pathOrUrl: string, destPath: string): Promise<void>;
+    exists(pathOrUrl: string): Promise<boolean>;
+    private getUrl;
+}
+//# sourceMappingURL=http.d.ts.map

package/dest/file-store/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/file-store/http.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AASlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,qBAAa,aAAc,YAAW,iBAAiB;IAGzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFlE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAER,OAAO,EAAE,MAAM,EAAmB,GAAG,GAAE,MAA+C;IAYtG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxD,OAAO,CAAC,MAAM;CAGf"}

package/dest/file-store/http.js

@@ -0,0 +1,53 @@
+import { createLogger } from '@aztec/foundation/log';
+import { makeBackoff, retry } from '@aztec/foundation/retry';
+import { createWriteStream } from 'fs';
+import { mkdir } from 'fs/promises';
+import { dirname } from 'path';
+import { Readable } from 'stream';
+import { finished } from 'stream/promises';
+export class HttpFileStore {
+    baseUrl;
+    log;
+    fetch;
+    constructor(baseUrl, log = createLogger('stdlib:http-file-store')){
+        this.baseUrl = baseUrl;
+        this.log = log;
+        this.fetch = async (...args)=>{
+            return await retry(()=>fetch(...args), `Fetching ${args[0]}`, makeBackoff([
+                1,
+                1,
+                3
+            ]), this.log, /*failSilently=*/ true);
+        };
+    }
+    async read(pathOrUrl) {
+        const url = this.getUrl(pathOrUrl);
+        const response = await this.fetch(url);
+        if (response.ok) {
+            return Buffer.from(await response.arrayBuffer());
+        } else {
+            throw new Error(`Error fetching file from ${url}: ${response.statusText}`);
+        }
+    }
+    async download(pathOrUrl, destPath) {
+        const url = this.getUrl(pathOrUrl);
+        const response = await this.fetch(url);
+        if (response.ok) {
+            await mkdir(dirname(destPath), {
+                recursive: true
+            });
+            // Typescript complains about Readable.fromWeb, hence the cast
+            await finished(Readable.fromWeb(response.body).pipe(createWriteStream(destPath)));
+        } else {
+            throw new Error(`Error fetching file from ${url}: ${response.statusText}`);
+        }
+    }
+    async exists(pathOrUrl) {
+        const url = this.getUrl(pathOrUrl);
+        const response = await this.fetch(url);
+        return response.ok;
+    }
+    getUrl(path) {
+        return URL.canParse(path) ? path : `${this.baseUrl.replace(/\/$/, '')}/${path}`;
+    }
+}

package/dest/file-store/index.d.ts

@@ -0,0 +1,3 @@
+export * from './interface.js';
+export * from './factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dest/file-store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file-store/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dest/file-store/index.js

@@ -0,0 +1,2 @@
+export * from './interface.js';
+export * from './factory.js';

package/dest/file-store/interface.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+/** Simple read-only file store. */
+export interface ReadOnlyFileStore {
+    /** Reads a file given a path, or an URI as returned by calling `save`. Returns file contents. */
+    read(pathOrUrl: string): Promise<Buffer>;
+    /** Downloads a file given a path, or an URI as returned by calling `save`. Saves file to local path. */
+    download(pathOrUrlStr: string, destPath: string): Promise<void>;
+    /** Returns whether a file at the given path or URI exists. */
+    exists(pathOrUrl: string): Promise<boolean>;
+}
+export type FileStoreSaveOptions = {
+    public?: boolean;
+    metadata?: Record<string, string>;
+    compress?: boolean;
+};
+/** Simple file store. */
+export interface FileStore extends ReadOnlyFileStore {
+    /** Saves contents to the given path. Returns an URI that can be used later to `read` the file. */
+    save(path: string, data: Buffer, opts?: FileStoreSaveOptions): Promise<string>;
+    /** Uploads contents from a local file. Returns an URI that can be used later to `read` the file. */
+    upload(destPath: string, srcPath: string, opts?: FileStoreSaveOptions): Promise<string>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dest/file-store/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/file-store/interface.ts"],"names":[],"mappings":";;AAAA,mCAAmC;AACnC,MAAM,WAAW,iBAAiB;IAChC,iGAAiG;IACjG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,wGAAwG;IACxG,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,8DAA8D;IAC9D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/G,yBAAyB;AACzB,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,kGAAkG;IAClG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,oGAAoG;IACpG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzF"}

package/dest/file-store/interface.js

@@ -0,0 +1 @@
+/** Simple read-only file store. */ /** Simple file store. */ export { };

package/dest/file-store/local.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import type { FileStore } from './interface.js';
+export declare class LocalFileStore implements FileStore {
+    private readonly basePath;
+    constructor(basePath: string);
+    save(path: string, data: Buffer): Promise<string>;
+    upload(destPath: string, srcPath: string, _opts: {
+        compress: boolean;
+    }): Promise<string>;
+    read(pathOrUrlStr: string): Promise<Buffer>;
+    download(pathOrUrlStr: string, destPath: string): Promise<void>;
+    exists(pathOrUrlStr: string): Promise<boolean>;
+    private getFullPath;
+}
+//# sourceMappingURL=local.d.ts.map

package/dest/file-store/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/file-store/local.ts"],"names":[],"mappings":";;AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,qBAAa,cAAe,YAAW,SAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEhC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOjD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9F,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOrD,OAAO,CAAC,WAAW;CAOpB"}

package/dest/file-store/local.js

@@ -0,0 +1,40 @@
+import { access, mkdir, readFile, writeFile } from 'fs/promises';
+import { dirname, resolve } from 'path';
+export class LocalFileStore {
+    basePath;
+    constructor(basePath){
+        this.basePath = basePath;
+    }
+    async save(path, data) {
+        const fullPath = this.getFullPath(path);
+        await mkdir(dirname(fullPath), {
+            recursive: true
+        });
+        await writeFile(fullPath, data);
+        return `file://${fullPath}`;
+    }
+    async upload(destPath, srcPath, _opts) {
+        const data = await readFile(srcPath);
+        return this.save(destPath, data);
+    }
+    read(pathOrUrlStr) {
+        const fullPath = this.getFullPath(pathOrUrlStr);
+        return readFile(fullPath);
+    }
+    async download(pathOrUrlStr, destPath) {
+        const data = await this.read(pathOrUrlStr);
+        const fullPath = this.getFullPath(destPath);
+        await writeFile(fullPath, data);
+    }
+    exists(pathOrUrlStr) {
+        const fullPath = this.getFullPath(pathOrUrlStr);
+        return access(fullPath).then(()=>true).catch(()=>false);
+    }
+    getFullPath(pathOrUrl) {
+        if (URL.canParse(pathOrUrl)) {
+            return new URL(pathOrUrl).pathname;
+        } else {
+            return resolve(this.basePath, pathOrUrl);
+        }
+    }
+}

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

@@ -12,8 +12,16 @@ export interface AztecNodeAdmin {
      * @param config - Updated configuration to be merged with the current one.
      */
     setConfig(config: Partial<SequencerConfig & ProverConfig>): Promise<void>;
-    /** Forces the next block to be built bypassing all time and pending checks. Useful for testing. */
+    /**
+     * Forces the next block to be built bypassing all time and pending checks.
+     * Useful for testing.
+     */
     flushTxs(): Promise<void>;
+    /**
+     * Pauses syncing, creates a backup of archiver and world-state databases, and uploads them. Returns immediately.
+     * @param location - The location to upload the snapshot to.
+     */
+    startSnapshotUpload(location: string): Promise<void>;
 }
 export declare const AztecNodeAdminApiSchema: ApiSchemaFor<AztecNodeAdmin>;
 export declare function createAztecNodeAdminClient(url: string, versions?: Partial<ComponentsVersions>, fetch?: typeof defaultFetch): AztecNodeAdmin;

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

@@ -1 +1 @@
-{"version":3,"file":"aztec-node-admin.d.ts","sourceRoot":"","sources":["../../src/interfaces/aztec-node-admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAI1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,KAAK,kBAAkB,EAAgC,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,KAAK,eAAe,EAAyB,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,oBAAoB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E,mGAAmG;IACnG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAAC,cAAc,CAGhE,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,OAAO,CAAC,kBAAkB,CAAM,EAC1C,KAAK,sBAAe,GACnB,cAAc,CAMhB"}
+{"version":3,"file":"aztec-node-admin.d.ts","sourceRoot":"","sources":["../../src/interfaces/aztec-node-admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAI1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,KAAK,kBAAkB,EAAgC,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,KAAK,eAAe,EAAyB,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,oBAAoB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAAC,cAAc,CAIhE,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,OAAO,CAAC,kBAAkB,CAAM,EAC1C,KAAK,sBAAe,GACnB,cAAc,CAMhB"}

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

@@ -5,7 +5,8 @@ import { SequencerConfigSchema } from './configs.js';
 import { ProverConfigSchema } from './prover-client.js';
 export const AztecNodeAdminApiSchema = {
     setConfig: z.function().args(SequencerConfigSchema.merge(ProverConfigSchema).partial()).returns(z.void()),
-    flushTxs: z.function().returns(z.void())
+    flushTxs: z.function().returns(z.void()),
+    startSnapshotUpload: z.function().args(z.string()).returns(z.void())
 };
 export function createAztecNodeAdminClient(url, versions = {}, fetch = defaultFetch) {
     return createSafeJsonRpcClient(url, AztecNodeAdminApiSchema, {

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

@@ -19,6 +19,7 @@ import { NullifierMembershipWitness } from '../trees/nullifier_membership_witnes
 import { PublicDataWitness } from '../trees/public_data_witness.js';
 import { BlockHeader, PublicSimulationOutput, Tx, TxHash, TxReceipt, type TxValidationResult } from '../tx/index.js';
 import { TxEffect } from '../tx/tx_effect.js';
+import type { ValidatorsStats } from '../validators/types.js';
 import { type ComponentsVersions } from '../versioning/index.js';
 import { type GetContractClassLogsResponse, type GetPublicLogsResponse } from './get_logs_response.js';
 import type { ProverCoordination } from './prover-coordination.js';
@@ -280,6 +281,8 @@ export interface AztecNode extends ProverCoordination, Pick<L2BlockSource, 'getB
      * @returns The current committed block header.
      */
     getBlockHeader(blockNumber?: L2BlockNumber): Promise<BlockHeader | undefined>;
+    /** Returns stats for validators if enabled. */
+    getValidatorsStats(): Promise<ValidatorsStats>;
     /**
      * Simulates the public part of a transaction with the current state.
      * This currently just checks that the transaction execution succeeds.