@aztec/world-state 0.0.0-test.1 → 0.0.1-commit.017a351

package/dest/index.d.ts

@@ -2,4 +2,4 @@ export * from './synchronizer/index.js';
 export * from './world-state-db/index.js';
 export * from './synchronizer/config.js';
 export * from './native/index.js';
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsMkJBQTJCLENBQUM7QUFDMUMsY0FBYywwQkFBMEIsQ0FBQztBQUN6QyxjQUFjLG1CQUFtQixDQUFDIn0=

package/dest/instrumentation/instrumentation.d.ts

@@ -1,22 +1,24 @@
+import { type Logger } from '@aztec/foundation/log';
 import { type TelemetryClient } from '@aztec/telemetry-client';
 import { WorldStateMessageType, type WorldStateStatusFull } from '../native/message.js';
 export declare class WorldStateInstrumentation {
     readonly telemetry: TelemetryClient;
     private log;
     private dbMapSize;
+    private dbPhysicalSize;
     private treeSize;
-    private unfinalisedHeight;
-    private finalisedHeight;
+    private unfinalizedHeight;
+    private finalizedHeight;
     private oldestBlock;
     private dbNumItems;
     private dbUsedSize;
     private requestHistogram;
     private criticalErrors;
-    constructor(telemetry: TelemetryClient, log?: import("@aztec/foundation/log").Logger);
+    constructor(telemetry: TelemetryClient, log?: Logger);
     private updateTreeStats;
     private updateTreeDBStats;
     updateWorldStateMetrics(worldStateStatus: WorldStateStatusFull): void;
     recordRoundTrip(timeUs: number, request: WorldStateMessageType): void;
     incCriticalErrors(errorType: 'synch_pending_block' | 'finalize_block' | 'prune_pending_block' | 'prune_historical_block'): void;
 }
-//# sourceMappingURL=instrumentation.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5zdHJ1bWVudGF0aW9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5zdHJ1bWVudGF0aW9uL2luc3RydW1lbnRhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQWdCLE1BQU0sdUJBQXVCLENBQUM7QUFFbEUsT0FBTyxFQUtMLEtBQUssZUFBZSxFQUdyQixNQUFNLHlCQUF5QixDQUFDO0FBRWpDLE9BQU8sRUFJTCxxQkFBcUIsRUFDckIsS0FBSyxvQkFBb0IsRUFDMUIsTUFBTSxzQkFBc0IsQ0FBQztBQWE5QixxQkFBYSx5QkFBeUI7YUFhbEIsU0FBUyxFQUFFLGVBQWU7SUFDMUMsT0FBTyxDQUFDLEdBQUc7SUFiYixPQUFPLENBQUMsU0FBUyxDQUFRO0lBQ3pCLE9BQU8sQ0FBQyxjQUFjLENBQVE7SUFDOUIsT0FBTyxDQUFDLFFBQVEsQ0FBUTtJQUN4QixPQUFPLENBQUMsaUJBQWlCLENBQVE7SUFDakMsT0FBTyxDQUFDLGVBQWUsQ0FBUTtJQUMvQixPQUFPLENBQUMsV0FBVyxDQUFRO0lBQzNCLE9BQU8sQ0FBQyxVQUFVLENBQVE7SUFDMUIsT0FBTyxDQUFDLFVBQVUsQ0FBUTtJQUMxQixPQUFPLENBQUMsZ0JBQWdCLENBQVk7SUFDcEMsT0FBTyxDQUFDLGNBQWMsQ0FBZ0I7SUFFdEMsWUFDa0IsU0FBUyxFQUFFLGVBQWUsRUFDbEMsR0FBRyxHQUFFLE1BQW9ELEVBNkJsRTtJQUVELE9BQU8sQ0FBQyxlQUFlO0lBMkJ2QixPQUFPLENBQUMsaUJBQWlCO0lBV2xCLHVCQUF1QixDQUFDLGdCQUFnQixFQUFFLG9CQUFvQixRQThCcEU7SUFFTSxlQUFlLENBQUMsTUFBTSxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUscUJBQXFCLFFBTXBFO0lBRU0saUJBQWlCLENBQ3RCLFNBQVMsRUFBRSxxQkFBcUIsR0FBRyxnQkFBZ0IsR0FBRyxxQkFBcUIsR0FBRyx3QkFBd0IsUUFLdkc7Q0FDRiJ9

package/dest/instrumentation/instrumentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/instrumentation/instrumentation.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,eAAe,EAGrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAIL,qBAAqB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAa9B,qBAAa,yBAAyB;aAWR,SAAS,EAAE,eAAe;IAAE,OAAO,CAAC,GAAG;IAVnE,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,cAAc,CAAgB;gBAEV,SAAS,EAAE,eAAe,EAAU,GAAG,yCAA8C;IAiDjH,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,iBAAiB;IAWlB,uBAAuB,CAAC,gBAAgB,EAAE,oBAAoB;IAgC9D,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB;IAQ9D,iBAAiB,CACtB,SAAS,EAAE,qBAAqB,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,wBAAwB;CAMzG"}
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/instrumentation/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAElE,OAAO,EAKL,KAAK,eAAe,EAGrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAIL,qBAAqB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAa9B,qBAAa,yBAAyB;aAalB,SAAS,EAAE,eAAe;IAC1C,OAAO,CAAC,GAAG;IAbb,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,cAAc,CAAgB;IAEtC,YACkB,SAAS,EAAE,eAAe,EAClC,GAAG,GAAE,MAAoD,EA6BlE;IAED,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,iBAAiB;IAWlB,uBAAuB,CAAC,gBAAgB,EAAE,oBAAoB,QA8BpE;IAEM,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,QAMpE;IAEM,iBAAiB,CACtB,SAAS,EAAE,qBAAqB,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,wBAAwB,QAKvG;CACF"}

package/dest/instrumentation/instrumentation.js

@@ -1,6 +1,6 @@
 import { createLogger } from '@aztec/foundation/log';
 import { MerkleTreeId } from '@aztec/stdlib/trees';
-import { Attributes, Metrics, ValueType } from '@aztec/telemetry-client';
+import { Attributes, Metrics, createUpDownCounterWithDefault } from '@aztec/telemetry-client';
 import { WorldStateMessageType } from '../native/message.js';
 const durationTrackDenylist = new Set([
     WorldStateMessageType.GET_INITIAL_STATE_REFERENCE,
@@ -13,9 +13,10 @@ export class WorldStateInstrumentation {
     telemetry;
     log;
     dbMapSize;
+    dbPhysicalSize;
     treeSize;
-    unfinalisedHeight;
-    finalisedHeight;
+    unfinalizedHeight;
+    finalizedHeight;
     oldestBlock;
     dbNumItems;
     dbUsedSize;
@@ -25,55 +26,38 @@ export class WorldStateInstrumentation {
         this.telemetry = telemetry;
         this.log = log;
         const meter = telemetry.getMeter('World State');
-        this.dbMapSize = meter.createGauge(Metrics.WORLD_STATE_DB_MAP_SIZE, {
-            description: `The current configured map size for each merkle tree`,
-            valueType: ValueType.INT
-        });
-        this.treeSize = meter.createGauge(Metrics.WORLD_STATE_TREE_SIZE, {
-            description: `The current number of leaves in each merkle tree`,
-            valueType: ValueType.INT
-        });
-        this.unfinalisedHeight = meter.createGauge(Metrics.WORLD_STATE_UNFINALISED_HEIGHT, {
-            description: `The unfinalised block height of each merkle tree`,
-            valueType: ValueType.INT
-        });
-        this.finalisedHeight = meter.createGauge(Metrics.WORLD_STATE_FINALISED_HEIGHT, {
-            description: `The finalised block height of each merkle tree`,
-            valueType: ValueType.INT
-        });
-        this.oldestBlock = meter.createGauge(Metrics.WORLD_STATE_OLDEST_BLOCK, {
-            description: `The oldest historical block of each merkle tree`,
-            valueType: ValueType.INT
-        });
-        this.dbUsedSize = meter.createGauge(Metrics.WORLD_STATE_DB_USED_SIZE, {
-            description: `The current used database size for each db of each merkle tree`,
-            valueType: ValueType.INT
-        });
-        this.dbNumItems = meter.createGauge(Metrics.WORLD_STATE_DB_NUM_ITEMS, {
-            description: `The current number of items in each database of each merkle tree`,
-            valueType: ValueType.INT
-        });
-        this.requestHistogram = meter.createHistogram(Metrics.WORLD_STATE_REQUEST_TIME, {
-            description: 'The round trip time of world state requests',
-            unit: 'us',
-            valueType: ValueType.INT
-        });
-        this.criticalErrors = meter.createUpDownCounter(Metrics.WORLD_STATE_CRITICAL_ERROR_COUNT, {
-            description: 'The number of critical errors in the world state',
-            valueType: ValueType.INT
+        this.dbMapSize = meter.createGauge(Metrics.WORLD_STATE_DB_MAP_SIZE);
+        this.dbPhysicalSize = meter.createGauge(Metrics.WORLD_STATE_DB_PHYSICAL_SIZE);
+        this.treeSize = meter.createGauge(Metrics.WORLD_STATE_TREE_SIZE);
+        this.unfinalizedHeight = meter.createGauge(Metrics.WORLD_STATE_UNFINALIZED_HEIGHT);
+        this.finalizedHeight = meter.createGauge(Metrics.WORLD_STATE_FINALIZED_HEIGHT);
+        this.oldestBlock = meter.createGauge(Metrics.WORLD_STATE_OLDEST_BLOCK);
+        this.dbUsedSize = meter.createGauge(Metrics.WORLD_STATE_DB_USED_SIZE);
+        this.dbNumItems = meter.createGauge(Metrics.WORLD_STATE_DB_NUM_ITEMS);
+        this.requestHistogram = meter.createHistogram(Metrics.WORLD_STATE_REQUEST_TIME);
+        this.criticalErrors = createUpDownCounterWithDefault(meter, Metrics.WORLD_STATE_CRITICAL_ERROR_COUNT, {
+            [Attributes.ERROR_TYPE]: [
+                'synch_pending_block',
+                'finalize_block',
+                'prune_pending_block',
+                'prune_historical_block'
+            ]
         });
     }
     updateTreeStats(treeDbStats, treeMeta, tree) {
         this.dbMapSize.record(Number(treeDbStats.mapSize), {
             [Attributes.MERKLE_TREE_NAME]: MerkleTreeId[tree]
         });
+        this.dbPhysicalSize.record(Number(treeDbStats.physicalFileSize), {
+            [Attributes.MERKLE_TREE_NAME]: MerkleTreeId[tree]
+        });
         this.treeSize.record(Number(treeMeta.size), {
             [Attributes.MERKLE_TREE_NAME]: MerkleTreeId[tree]
         });
-        this.unfinalisedHeight.record(Number(treeMeta.unfinalisedBlockHeight), {
+        this.unfinalizedHeight.record(Number(treeMeta.unfinalizedBlockHeight), {
             [Attributes.MERKLE_TREE_NAME]: MerkleTreeId[tree]
         });
-        this.finalisedHeight.record(Number(treeMeta.finalisedBlockHeight), {
+        this.finalizedHeight.record(Number(treeMeta.finalizedBlockHeight), {
             [Attributes.MERKLE_TREE_NAME]: MerkleTreeId[tree]
         });
         this.oldestBlock.record(Number(treeMeta.oldestHistoricBlock), {

package/dest/native/bench_metrics.d.ts

@@ -0,0 +1,23 @@
+import { MerkleTreeId } from '@aztec/stdlib/trees';
+export declare enum InsertionType {
+    BATCH = 0,
+    SEQUENTIAL = 1
+}
+export declare enum DataRetrievalType {
+    SIBLING_PATH = 0,
+    LEAF_PREIMAGE = 1,
+    LEAF_VALUE = 2,
+    LEAF_INDICES = 3,
+    LOW_LEAF = 4
+}
+export declare class NativeBenchMetics {
+    private blockSyncMetrics;
+    private insertionMetrics;
+    private dataRetrievalMetrics;
+    toPrettyString(): string;
+    addBlockSyncMetric(numTxs: number, numLeaves: number, value: number): void;
+    addInsertionMetric(treeId: MerkleTreeId, insertionType: InsertionType, numLeaves: number, value: number): void;
+    addDataRetrievalMetric(retrievalType: DataRetrievalType, value: number): void;
+    toGithubActionBenchmarkJSON(indent?: number): string;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmVuY2hfbWV0cmljcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL25hdGl2ZS9iZW5jaF9tZXRyaWNzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQVFuRCxvQkFBWSxhQUFhO0lBQ3ZCLEtBQUssSUFBQTtJQUNMLFVBQVUsSUFBQTtDQUNYO0FBU0Qsb0JBQVksaUJBQWlCO0lBQzNCLFlBQVksSUFBQTtJQUNaLGFBQWEsSUFBQTtJQUNiLFVBQVUsSUFBQTtJQUNWLFlBQVksSUFBQTtJQUNaLFFBQVEsSUFBQTtDQUNUO0FBT0QscUJBQWEsaUJBQWlCO0lBQzVCLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBMEI7SUFDbEQsT0FBTyxDQUFDLGdCQUFnQixDQUEwQjtJQUNsRCxPQUFPLENBQUMsb0JBQW9CLENBQThCO0lBRW5ELGNBQWMsV0FlcEI7SUFFTSxrQkFBa0IsQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxNQUFNLEVBQUUsS0FBSyxFQUFFLE1BQU0sUUFFekU7SUFDTSxrQkFBa0IsQ0FBQyxNQUFNLEVBQUUsWUFBWSxFQUFFLGFBQWEsRUFBRSxhQUFhLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxLQUFLLEVBQUUsTUFBTSxRQUU3RztJQUNNLHNCQUFzQixDQUFDLGFBQWEsRUFBRSxpQkFBaUIsRUFBRSxLQUFLLEVBQUUsTUFBTSxRQUU1RTtJQUVNLDJCQUEyQixDQUFDLE1BQU0sU0FBSSxVQXdCNUM7Q0FDRiJ9

package/dest/native/bench_metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bench_metrics.d.ts","sourceRoot":"","sources":["../../src/native/bench_metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQnD,oBAAY,aAAa;IACvB,KAAK,IAAA;IACL,UAAU,IAAA;CACX;AASD,oBAAY,iBAAiB;IAC3B,YAAY,IAAA;IACZ,aAAa,IAAA;IACb,UAAU,IAAA;IACV,YAAY,IAAA;IACZ,QAAQ,IAAA;CACT;AAOD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,oBAAoB,CAA8B;IAEnD,cAAc,WAepB;IAEM,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAEzE;IACM,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAE7G;IACM,sBAAsB,CAAC,aAAa,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,QAE5E;IAEM,2BAA2B,CAAC,MAAM,SAAI,UAwB5C;CACF"}

package/dest/native/bench_metrics.js

@@ -0,0 +1,81 @@
+import { MerkleTreeId } from '@aztec/stdlib/trees';
+export var InsertionType = /*#__PURE__*/ function(InsertionType) {
+    InsertionType[InsertionType["BATCH"] = 0] = "BATCH";
+    InsertionType[InsertionType["SEQUENTIAL"] = 1] = "SEQUENTIAL";
+    return InsertionType;
+}({});
+export var DataRetrievalType = /*#__PURE__*/ function(DataRetrievalType) {
+    DataRetrievalType[DataRetrievalType["SIBLING_PATH"] = 0] = "SIBLING_PATH";
+    DataRetrievalType[DataRetrievalType["LEAF_PREIMAGE"] = 1] = "LEAF_PREIMAGE";
+    DataRetrievalType[DataRetrievalType["LEAF_VALUE"] = 2] = "LEAF_VALUE";
+    DataRetrievalType[DataRetrievalType["LEAF_INDICES"] = 3] = "LEAF_INDICES";
+    DataRetrievalType[DataRetrievalType["LOW_LEAF"] = 4] = "LOW_LEAF";
+    return DataRetrievalType;
+}({});
+export class NativeBenchMetics {
+    blockSyncMetrics = [];
+    insertionMetrics = [];
+    dataRetrievalMetrics = [];
+    toPrettyString() {
+        let pretty = '';
+        pretty += `Block sync metrics:\n`;
+        for (const metric of this.blockSyncMetrics){
+            pretty += `  ${metric.numTxs} txs, ${metric.numLeaves} leaves: ${metric.value} ms\n`;
+        }
+        pretty += `Insertion metrics:\n`;
+        for (const metric of this.insertionMetrics){
+            pretty += `  ${MerkleTreeId[metric.treeType]}: ${InsertionType[metric.insertionType]} (${metric.numLeaves} leaves): ${metric.value} ms\n`;
+        }
+        pretty += `Data retrieval metrics:\n`;
+        for (const metric of this.dataRetrievalMetrics){
+            pretty += `  ${DataRetrievalType[metric.retrievalType]}: ${metric.value} us\n`;
+        }
+        return pretty;
+    }
+    addBlockSyncMetric(numTxs, numLeaves, value) {
+        this.blockSyncMetrics.push({
+            numTxs,
+            numLeaves,
+            value
+        });
+    }
+    addInsertionMetric(treeId, insertionType, numLeaves, value) {
+        this.insertionMetrics.push({
+            treeType: treeId,
+            insertionType,
+            numLeaves,
+            value
+        });
+    }
+    addDataRetrievalMetric(retrievalType, value) {
+        this.dataRetrievalMetrics.push({
+            retrievalType,
+            value: value
+        });
+    }
+    toGithubActionBenchmarkJSON(indent = 2) {
+        const data = [];
+        for (const blockSync of this.blockSyncMetrics){
+            data.push({
+                name: `Block Sync/${blockSync.numTxs} txs/${blockSync.numLeaves} leaves per tx`,
+                value: blockSync.value,
+                unit: 'ms'
+            });
+        }
+        for (const insertion of this.insertionMetrics){
+            data.push({
+                name: `Tree Insertion/${MerkleTreeId[insertion.treeType]}/${InsertionType[insertion.insertionType]}/${insertion.numLeaves} leaves`,
+                value: insertion.value,
+                unit: 'ms'
+            });
+        }
+        for (const retrieval of this.dataRetrievalMetrics){
+            data.push({
+                name: `Data Retrieval/${DataRetrievalType[retrieval.retrievalType]}`,
+                value: retrieval.value,
+                unit: 'us'
+            });
+        }
+        return JSON.stringify(data, null, indent);
+    }
+}

package/dest/native/fork_checkpoint.d.ts

@@ -1,10 +1,16 @@
 import type { MerkleTreeCheckpointOperations } from '@aztec/stdlib/interfaces/server';
 export declare class ForkCheckpoint {
     private readonly fork;
+    readonly depth: number;
     private completed;
     private constructor();
     static new(fork: MerkleTreeCheckpointOperations): Promise<ForkCheckpoint>;
     commit(): Promise<void>;
     revert(): Promise<void>;
+    /**
+     * Reverts this checkpoint and any nested checkpoints created on top of it,
+     * leaving the checkpoint depth at the level it was before this checkpoint was created.
+     */
+    revertToCheckpoint(): Promise<void>;
 }
-//# sourceMappingURL=fork_checkpoint.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZm9ya19jaGVja3BvaW50LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbmF0aXZlL2ZvcmtfY2hlY2twb2ludC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSw4QkFBOEIsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBRXRGLHFCQUFhLGNBQWM7SUFJdkIsT0FBTyxDQUFDLFFBQVEsQ0FBQyxJQUFJO2FBQ0wsS0FBSyxFQUFFLE1BQU07SUFKL0IsT0FBTyxDQUFDLFNBQVMsQ0FBUztJQUUxQixPQUFPLGVBR0g7SUFFSixPQUFhLEdBQUcsQ0FBQyxJQUFJLEVBQUUsOEJBQThCLEdBQUcsT0FBTyxDQUFDLGNBQWMsQ0FBQyxDQUc5RTtJQUVLLE1BQU0sSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBTzVCO0lBRUssTUFBTSxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FPNUI7SUFFRDs7O09BR0c7SUFDRyxrQkFBa0IsSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBT3hDO0NBQ0YifQ==

package/dest/native/fork_checkpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fork_checkpoint.d.ts","sourceRoot":"","sources":["../../src/native/fork_checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAEtF,qBAAa,cAAc;IAGL,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFzC,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO;WAEM,GAAG,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,cAAc,CAAC;IAKzE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IASvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ9B"}
+{"version":3,"file":"fork_checkpoint.d.ts","sourceRoot":"","sources":["../../src/native/fork_checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAEtF,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,IAAI;aACL,KAAK,EAAE,MAAM;IAJ/B,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,eAGH;IAEJ,OAAa,GAAG,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,cAAc,CAAC,CAG9E;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAO5B;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAO5B;IAED;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOxC;CACF"}

package/dest/native/fork_checkpoint.js

@@ -1,13 +1,15 @@
 export class ForkCheckpoint {
     fork;
+    depth;
     completed;
-    constructor(fork){
+    constructor(fork, depth){
         this.fork = fork;
+        this.depth = depth;
         this.completed = false;
     }
     static async new(fork) {
-        await fork.createCheckpoint();
-        return new ForkCheckpoint(fork);
+        const depth = await fork.createCheckpoint();
+        return new ForkCheckpoint(fork, depth);
     }
     async commit() {
         if (this.completed) {
@@ -23,4 +25,14 @@ export class ForkCheckpoint {
         await this.fork.revertCheckpoint();
         this.completed = true;
     }
+    /**
+   * Reverts this checkpoint and any nested checkpoints created on top of it,
+   * leaving the checkpoint depth at the level it was before this checkpoint was created.
+   */ async revertToCheckpoint() {
+        if (this.completed) {
+            return;
+        }
+        await this.fork.revertAllCheckpointsTo(this.depth - 1);
+        this.completed = true;
+    }
 }

package/dest/native/index.d.ts

@@ -1,3 +1,3 @@
 export * from './native_world_state.js';
 export * from './fork_checkpoint.js';
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9uYXRpdmUvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyx5QkFBeUIsQ0FBQztBQUN4QyxjQUFjLHNCQUFzQixDQUFDIn0=

package/dest/native/ipc_world_state_instance.d.ts

@@ -0,0 +1,45 @@
+import { type Logger, type LoggerBindings } from '@aztec/foundation/log';
+import type { GenesisData } from '@aztec/stdlib/world-state';
+import { WsdbService } from '@aztec/wsdb';
+import type { WorldStateInstrumentation } from '../instrumentation/instrumentation.js';
+import type { WorldStateTreeMapSizes } from '../synchronizer/factory.js';
+import { WorldStateMessageType, type WorldStateRequest, type WorldStateRequestCategories, type WorldStateResponse } from './message.js';
+import type { NativeWorldStateInstance } from './native_world_state_instance.js';
+/**
+ * IPC-backed world state instance.
+ * Uses WsdbService (spawns aztec-wsdb binary) and the generated AsyncApi
+ * to communicate via the NamedUnion IPC protocol.
+ */
+export declare class IpcWorldState implements NativeWorldStateInstance {
+    private readonly wsdb;
+    private readonly instrumentation;
+    private readonly log;
+    private open;
+    private queues;
+    private api;
+    /** Tracks checkpoint depth per fork (WSDB IPC doesn't return depth in response). */
+    private checkpointDepths;
+    constructor(wsdb: WsdbService, instrumentation: WorldStateInstrumentation, bindings?: LoggerBindings, log?: Logger);
+    /**
+     * Spawn an `aztec-wsdb` subprocess and return an IPC-backed world state wrapping it.
+     * Encapsulates wsdb binary discovery, service construction, and readiness wait.
+     */
+    static spawn(dataDir: string, wsTreeMapSizes: WorldStateTreeMapSizes, genesis: GenesisData, instrumentation: WorldStateInstrumentation, bindings?: LoggerBindings): Promise<IpcWorldState>;
+    /** Returns the socket path of the underlying wsdb server. */
+    getSocketPath(): string;
+    call<T extends WorldStateMessageType>(messageType: T, body: WorldStateRequest[T] & WorldStateRequestCategories, responseHandler?: (response: WorldStateResponse[T]) => WorldStateResponse[T], errorHandler?: (_: string) => void): Promise<WorldStateResponse[T]>;
+    close(): Promise<void>;
+    private _sendMessage;
+    private dispatch;
+}
+/**
+ * Helper to create WsdbOptions from standard world state config.
+ * Returns the options needed to construct a wsdb service command line.
+ */
+export declare function getWsdbOptions(dataDir: string, wsTreeMapSizes: WorldStateTreeMapSizes): {
+    treeHeights: Record<number, number>;
+    treePrefill: Record<number, number>;
+    mapSizes: Record<number, number>;
+    initialHeaderGeneratorPoint: number;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaXBjX3dvcmxkX3N0YXRlX2luc3RhbmNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbmF0aXZlL2lwY193b3JsZF9zdGF0ZV9pbnN0YW5jZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFVQSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQUUsS0FBSyxjQUFjLEVBQWdCLE1BQU0sdUJBQXVCLENBQUM7QUFFdkYsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFzQixNQUFNLDJCQUEyQixDQUFDO0FBQ2pGLE9BQU8sRUFBWSxXQUFXLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFlcEQsT0FBTyxLQUFLLEVBQUUseUJBQXlCLEVBQUUsTUFBTSx1Q0FBdUMsQ0FBQztBQUN2RixPQUFPLEtBQUssRUFBRSxzQkFBc0IsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ3pFLE9BQU8sRUFNTCxxQkFBcUIsRUFFckIsS0FBSyxpQkFBaUIsRUFDdEIsS0FBSywyQkFBMkIsRUFDaEMsS0FBSyxrQkFBa0IsRUFNeEIsTUFBTSxjQUFjLENBQUM7QUFDdEIsT0FBTyxLQUFLLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQXFSakY7Ozs7R0FJRztBQUNILHFCQUFhLGFBQWMsWUFBVyx3QkFBd0I7SUFRMUQsT0FBTyxDQUFDLFFBQVEsQ0FBQyxJQUFJO0lBQ3JCLE9BQU8sQ0FBQyxRQUFRLENBQUMsZUFBZTtJQUVoQyxPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUc7SUFWdEIsT0FBTyxDQUFDLElBQUksQ0FBUTtJQUNwQixPQUFPLENBQUMsTUFBTSxDQUF5QztJQUN2RCxPQUFPLENBQUMsR0FBRyxDQUFXO0lBQ3RCLG9GQUFvRjtJQUNwRixPQUFPLENBQUMsZ0JBQWdCLENBQTZCO0lBRXJELFlBQ21CLElBQUksRUFBRSxXQUFXLEVBQ2pCLGVBQWUsRUFBRSx5QkFBeUIsRUFDM0QsUUFBUSxDQUFDLEVBQUUsY0FBYyxFQUNSLEdBQUcsR0FBRSxNQUEyRCxFQUtsRjtJQUVEOzs7T0FHRztJQUNILE9BQWEsS0FBSyxDQUNoQixPQUFPLEVBQUUsTUFBTSxFQUNmLGNBQWMsRUFBRSxzQkFBc0IsRUFDdEMsT0FBTyxFQUFFLFdBQVcsRUFDcEIsZUFBZSxFQUFFLHlCQUF5QixFQUMxQyxRQUFRLENBQUMsRUFBRSxjQUFjLEdBQ3hCLE9BQU8sQ0FBQyxhQUFhLENBQUMsQ0FReEI7SUFFRCw2REFBNkQ7SUFDN0QsYUFBYSxJQUFJLE1BQU0sQ0FFdEI7SUFFSyxJQUFJLENBQUMsQ0FBQyxTQUFTLHFCQUFxQixFQUN4QyxXQUFXLEVBQUUsQ0FBQyxFQUNkLElBQUksRUFBRSxpQkFBaUIsQ0FBQyxDQUFDLENBQUMsR0FBRywyQkFBMkIsRUFDeEQsZUFBZSw2REFBdUUsRUFDdEYsWUFBWSxzQkFBb0IsR0FDL0IsT0FBTyxDQUFDLGtCQUFrQixDQUFDLENBQUMsQ0FBQyxDQUFDLENBNkNoQztJQUVLLEtBQUssSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBVTNCO1lBRWEsWUFBWTtZQWlCWixRQUFRO0NBcVh2QjtBQUVEOzs7R0FHRztBQUNILHdCQUFnQixjQUFjLENBQzVCLE9BQU8sRUFBRSxNQUFNLEVBQ2YsY0FBYyxFQUFFLHNCQUFzQixHQUNyQztJQUNELFdBQVcsRUFBRSxNQUFNLENBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ3BDLFdBQVcsRUFBRSxNQUFNLENBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ3BDLFFBQVEsRUFBRSxNQUFNLENBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ2pDLDJCQUEyQixFQUFFLE1BQU0sQ0FBQztDQUNyQyxDQXNCQSJ9

package/dest/native/ipc_world_state_instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc_world_state_instance.d.ts","sourceRoot":"","sources":["../../src/native/ipc_world_state_instance.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAgB,MAAM,uBAAuB,CAAC;AAEvF,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAY,WAAW,EAAE,MAAM,aAAa,CAAC;AAepD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAML,qBAAqB,EAErB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EAMxB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAqRjF;;;;GAIG;AACH,qBAAa,aAAc,YAAW,wBAAwB;IAQ1D,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAVtB,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,GAAG,CAAW;IACtB,oFAAoF;IACpF,OAAO,CAAC,gBAAgB,CAA6B;IAErD,YACmB,IAAI,EAAE,WAAW,EACjB,eAAe,EAAE,yBAAyB,EAC3D,QAAQ,CAAC,EAAE,cAAc,EACR,GAAG,GAAE,MAA2D,EAKlF;IAED;;;OAGG;IACH,OAAa,KAAK,CAChB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,sBAAsB,EACtC,OAAO,EAAE,WAAW,EACpB,eAAe,EAAE,yBAAyB,EAC1C,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,aAAa,CAAC,CAQxB;IAED,6DAA6D;IAC7D,aAAa,IAAI,MAAM,CAEtB;IAEK,IAAI,CAAC,CAAC,SAAS,qBAAqB,EACxC,WAAW,EAAE,CAAC,EACd,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,2BAA2B,EACxD,eAAe,6DAAuE,EACtF,YAAY,sBAAoB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CA6ChC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3B;YAEa,YAAY;YAiBZ,QAAQ;CAqXvB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,sBAAsB,GACrC;IACD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2BAA2B,EAAE,MAAM,CAAC;CACrC,CAsBA"}