@aztec/pxe 0.0.1-commit.d3ec352c → 0.0.1-commit.d58ff9d0

package/src/storage/{address_data_provider/address_data_provider.ts → address_store/address_store.ts}

@@ -3,7 +3,7 @@ import type { AztecAsyncArray, AztecAsyncKVStore, AztecAsyncMap } from '@aztec/k
 import type { AztecAddress } from '@aztec/stdlib/aztec-address';
 import { CompleteAddress } from '@aztec/stdlib/contract';
 
-export class AddressDataProvider {
+export class AddressStore {
   #store: AztecAsyncKVStore;
   #completeAddresses: AztecAsyncArray<Buffer>;
   #completeAddressIndex: AztecAsyncMap<string, number>;
@@ -43,23 +43,23 @@ export class AddressDataProvider {
     });
   }
 
-  async #getCompleteAddress(address: AztecAddress): Promise<CompleteAddress | undefined> {
-    const index = await this.#completeAddressIndex.getAsync(address.toString());
-    if (index === undefined) {
-      return undefined;
-    }
-
-    const value = await this.#completeAddresses.atAsync(index);
-    return value ? await CompleteAddress.fromBuffer(value) : undefined;
-  }
-
   getCompleteAddress(account: AztecAddress): Promise<CompleteAddress | undefined> {
-    return this.#getCompleteAddress(account);
+    return this.#store.transactionAsync(async () => {
+      const index = await this.#completeAddressIndex.getAsync(account.toString());
+      if (index === undefined) {
+        return undefined;
+      }
+
+      const value = await this.#completeAddresses.atAsync(index);
+      return value ? await CompleteAddress.fromBuffer(value) : undefined;
+    });
   }
 
-  async getCompleteAddresses(): Promise<CompleteAddress[]> {
-    return await Promise.all(
-      (await toArray(this.#completeAddresses.valuesAsync())).map(v => CompleteAddress.fromBuffer(v)),
-    );
+  getCompleteAddresses(): Promise<CompleteAddress[]> {
+    return this.#store.transactionAsync(async () => {
+      return await Promise.all(
+        (await toArray(this.#completeAddresses.valuesAsync())).map(v => CompleteAddress.fromBuffer(v)),
+      );
+    });
   }
 }

package/src/storage/address_store/index.ts

@@ -0,0 +1 @@
+export { AddressStore } from './address_store.js';

package/src/storage/allowed_scopes.ts

@@ -0,0 +1,14 @@
+import { AztecAddress } from '@aztec/stdlib/aztec-address';
+
+/**
+ * Asserts that `scope` is one of `allowedScopes`, throwing otherwise.
+ */
+export function assertAllowedScope(scope: AztecAddress, allowedScopes: AztecAddress[]): void {
+  if (!allowedScopes.some((allowed: AztecAddress) => allowed.equals(scope))) {
+    throw new Error(
+      `Scope ${scope.toString()} is not in the allowed scopes list: [${allowedScopes
+        .map((s: AztecAddress) => s.toString())
+        .join(', ')}]. See https://docs.aztec.network/errors/10`,
+    );
+  }
+}

package/src/storage/anchor_block_store/anchor_block_store.ts

@@ -0,0 +1,35 @@
+import type { AztecAsyncKVStore, AztecAsyncSingleton } from '@aztec/kv-store';
+import { BlockHeader } from '@aztec/stdlib/tx';
+
+/**
+ * Holds the block header that PXE's private execution is anchored to. Updated by the BlockSynchronizer as the chain
+ * advances or reorgs.
+ */
+export class AnchorBlockStore {
+  #store: AztecAsyncKVStore;
+  #synchronizedHeader: AztecAsyncSingleton<Buffer>;
+
+  constructor(store: AztecAsyncKVStore) {
+    this.#store = store;
+    this.#synchronizedHeader = this.#store.openSingleton('header');
+  }
+
+  /**
+   * Sets the currently synchronized block header.
+   *
+   * Important: only called from BlockSynchronizer, and since it must run atomically with other stores in a reorg, it
+   * MUST NOT be wrapped in `transactionAsync`: doing so deadlocks when the kv-store backend is IndexedDB (no
+   * support for reentrancy).
+   */
+  async setHeader(header: BlockHeader): Promise<void> {
+    await this.#synchronizedHeader.set(header.toBuffer());
+  }
+
+  async getBlockHeader(): Promise<BlockHeader> {
+    const headerBuffer = await this.#store.transactionAsync(() => this.#synchronizedHeader.getAsync());
+    if (!headerBuffer) {
+      throw new Error(`Trying to get block header with a not-yet-synchronized PXE - this should never happen`);
+    }
+    return BlockHeader.fromBuffer(headerBuffer);
+  }
+}

package/src/storage/anchor_block_store/index.ts

@@ -0,0 +1 @@
+export { AnchorBlockStore } from './anchor_block_store.js';

package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json

@@ -0,0 +1,22 @@
+{
+  "complete_addresses": [
+    {
+      "index": 0,
+      "value": "2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce4413ad6965d11a533a663d07507319f74ac3305325f6f72423c0b24aa1193268bb19e95c05f09cb86d1a6257572f9082ca15d4a02373c4d8c9cee23dc61a4c2a882f9017d51bca6616102d8a1d4dba89e4ce12881a2414576f01d2fec9492814a22a1b054e998835d166711839b515d434b1fbc207ad4fdb5b2b43d6ac6b400871019f5bb255e87523d43da83ebc9fa95169b653d4abef902e011e9eac620fc45b1006a921250e1395ef3cfc24c0e57d8f6745e7660ff70a28150f569bf66b8d5b28f331bfc59268b3f8b708104b95ed3a8065805cac8a0bdb622ce038631584c00000000000000000000000000000000000000000000000000000000000000003"
+    },
+    {
+      "index": 1,
+      "value": "1fc97e4d0bb6609f25973d986a7b4787cdbad4fb98c8823591c67e7cd744ba6317c2df1b7355bb4c4494aa4ec85d15ff8881cea1b34691f0cc558e8aef3f3f4c267e526a2e6e9adf6a026989be005bd50d1aea76d20816b9843bc95557696f9f16c3eb259ba3e3eb27b7fe3abc36e87923990bf5c265cb0d57790eda2a4432f105a5449624125d37f10cd4c68ffd57b0dc0cdaa916cb37840be1db9bf88e3c5f0e81754454e3b12035b13448a9fe3b980bf31a9808cb93e146628fb06fa1b46f1694840b143402ffa76cba23e6a9be64b4db084fa804f61940e2d10cf41d273e2475eeff188767ebed988e7d9997d9ed9fe667ff68df9b7143bc663c242929260000000000000000000000000000000000000000000000000000000000000007"
+    }
+  ],
+  "complete_address_index": [
+    {
+      "key": "utf8:0x1fc97e4d0bb6609f25973d986a7b4787cdbad4fb98c8823591c67e7cd744ba63",
+      "value": "num:1"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44",
+      "value": "num:0"
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json

@@ -0,0 +1,3 @@
+{
+  "header": "000000000000000000000000000000000000000000000000000000000000000200000003000000000000000000000000000000000000000000000000000000000000000500000007000000000000000000000000000000000000000000000000000000000000000b0000000d00000000000000000000000000000000000000000000000000000000000000110000001300000000000000000000000000000000000000000000000000000000000000170000001d000000000000000000000000000000000000000000000000000000000000001f000000000000000000000000000000000000000000000000000000000000002500000000000000000000000000000000000000000000000000000000000000290000002b0000002f0000000000000035000000000000000000000000000000000000003b000000000000000000000000000000000000000000000000000000000000003d00000000000000000000000000000043000000000000000000000000000000470000000000000000000000000000000000000000000000000000000000000049000000000000000000000000000000000000000000000000000000000000004f"
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json

@@ -0,0 +1,16 @@
+{
+  "capsules": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000002:0x0000000000000000000000000000000000000000000000000000000000000003:0x0000000000000000000000000000000000000000000000000000000000000005",
+      "value": "0000000000000000000000000000000000000000000000000000000000000007000000000000000000000000000000000000000000000000000000000000000b"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000002:0x0000000000000000000000000000000000000000000000000000000000000003:0x000000000000000000000000000000000000000000000000000000000000000d",
+      "value": "0000000000000000000000000000000000000000000000000000000000000011"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000002:0x0000000000000000000000000000000000000000000000000000000000000003:0x0000000000000000000000000000000000000000000000000000000000000013",
+      "value": ""
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json

@@ -0,0 +1,28 @@
+{
+  "contract_artifacts": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000002",
+      "value": "7b226e616d65223a22536368656d6146697874757265436f6e7472616374222c22617a74656356657273696f6e223a22736368656d612d666978747572652d76657273696f6e222c2266756e6374696f6e73223a5b7b226e616d65223a22707269766174655f666e222c2266756e6374696f6e54797065223a2270726976617465222c2269734f6e6c7953656c66223a66616c73652c226973537461746963223a66616c73652c226973496e697469616c697a6572223a747275652c22706172616d6574657273223a5b7b226e616d65223a226669727374222c2274797065223a7b226b696e64223a226669656c64227d2c227669736962696c697479223a2270726976617465227d2c7b226e616d65223a227365636f6e64222c2274797065223a7b226b696e64223a22696e7465676572222c227369676e223a22756e7369676e6564222c227769647468223a33327d2c227669736962696c697479223a227075626c6963227d5d2c2272657475726e5479706573223a5b7b226b696e64223a22626f6f6c65616e227d5d2c226572726f725479706573223a7b22736368656d615f746573745f6572726f72223a7b226572726f725f6b696e64223a22737472696e67222c22737472696e67223a22666978656420736368656d612d74657374206572726f72227d7d2c2262797465636f6465223a2241674d4642773d3d222c22646562756753796d626f6c73223a22736368656d612d666978747572652d6465627567227d5d2c226e6f6e44697370617463685075626c696346756e6374696f6e73223a5b7b226e616d65223a227075626c69635f666e222c2266756e6374696f6e54797065223a227075626c6963222c2269734f6e6c7953656c66223a747275652c226973537461746963223a747275652c226973496e697469616c697a6572223a66616c73652c22706172616d6574657273223a5b5d2c2272657475726e5479706573223a5b5d2c226572726f725479706573223a7b7d7d5d2c226f757470757473223a7b2273747275637473223a7b226d795f737472756374223a5b7b226b696e64223a226669656c64227d2c7b226b696e64223a22626f6f6c65616e227d5d7d2c22676c6f62616c73223a7b7d7d2c2273746f726167654c61796f7574223a7b226d795f6669656c64223a7b22736c6f74223a22307830303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303062227d7d2c2266696c654d6170223a7b2231223a7b22736f75726365223a22736368656d61206669787475726520736f75726365222c2270617468223a227372632f736368656d615f666978747572652e6e72222c2266756e6374696f6e5f6c6f636174696f6e73223a5b5d7d7d7d"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000017",
+      "value": "7b226e616d65223a22536368656d6146697874757265436f6e7472616374222c22617a74656356657273696f6e223a22736368656d612d666978747572652d76657273696f6e222c2266756e6374696f6e73223a5b7b226e616d65223a22707269766174655f666e222c2266756e6374696f6e54797065223a2270726976617465222c2269734f6e6c7953656c66223a66616c73652c226973537461746963223a66616c73652c226973496e697469616c697a6572223a747275652c22706172616d6574657273223a5b7b226e616d65223a226669727374222c2274797065223a7b226b696e64223a226669656c64227d2c227669736962696c697479223a2270726976617465227d2c7b226e616d65223a227365636f6e64222c2274797065223a7b226b696e64223a22696e7465676572222c227369676e223a22756e7369676e6564222c227769647468223a33327d2c227669736962696c697479223a227075626c6963227d5d2c2272657475726e5479706573223a5b7b226b696e64223a22626f6f6c65616e227d5d2c226572726f725479706573223a7b22736368656d615f746573745f6572726f72223a7b226572726f725f6b696e64223a22737472696e67222c22737472696e67223a22666978656420736368656d612d74657374206572726f72227d7d2c2262797465636f6465223a2241674d4642773d3d222c22646562756753796d626f6c73223a22736368656d612d666978747572652d6465627567227d5d2c226e6f6e44697370617463685075626c696346756e6374696f6e73223a5b7b226e616d65223a227075626c69635f666e222c2266756e6374696f6e54797065223a227075626c6963222c2269734f6e6c7953656c66223a747275652c226973537461746963223a747275652c226973496e697469616c697a6572223a66616c73652c22706172616d6574657273223a5b5d2c2272657475726e5479706573223a5b5d2c226572726f725479706573223a7b7d7d5d2c226f757470757473223a7b2273747275637473223a7b226d795f737472756374223a5b7b226b696e64223a226669656c64227d2c7b226b696e64223a22626f6f6c65616e227d5d7d2c22676c6f62616c73223a7b7d7d2c2273746f726167654c61796f7574223a7b226d795f6669656c64223a7b22736c6f74223a22307830303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303062227d7d2c2266696c654d6170223a7b2231223a7b22736f75726365223a22736368656d61206669787475726520736f75726365222c2270617468223a227372632f736368656d615f666978747572652e6e72222c2266756e6374696f6e5f6c6f636174696f6e73223a5b5d7d7d7d"
+    }
+  ],
+  "contract_classes": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000002",
+      "value": "010000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000050000000000000000000000000000000000000000000000000000000000000007000000020000000b000000000000000000000000000000000000000000000000000000000000000d000000110000000000000000000000000000000000000000000000000000000000000013"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000017",
+      "value": "010000000000000000000000000000000000000000000000000000000000000017000000000000000000000000000000000000000000000000000000000000001d000000000000000000000000000000000000000000000000000000000000001f000000000000000000000000000000000000000000000000000000000000002500000000"
+    }
+  ],
+  "contracts_instances": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000065",
+      "value": "020000000000000000000000000000000000000000000000000000000000000049000000000000000000000000000000000000000000000000000000000000004f0000000000000000000000000000000000000000000000000000000000000059000000000000000000000000000000000000000000000000000000000000006100000000000000000000000000000000000000000000000000000000000000670000000000000000000000000000000000000000000000000000000000000029000000000000000000000000000000000000000000000000000000000000002f0000000000000000000000000000000000000000000000000000000000000035000000000000000000000000000000000000000000000000000000000000003b000000000000000000000000000000000000000000000000000000000000004300000000000000000000000000000000000000000000000000000000000000470000000000000000000000000000000000000000000000000000000000000049"
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/FactStore.json

@@ -0,0 +1,40 @@
+{
+  "facts": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000aa:0x0000000000000000000000000000000000000000000000000000000000000003:0x00eebee6df09ad503384e049aea9fbf0c0db2f5af46673e550694c6564d973f7:6:0x0000000000000000000000000000000000000000000000000000000000000002",
+      "value": "00000000000000000000000000000000000000000000000000000000000000640000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000aa000000000000000000000000000000000000000000000000000000000000000300000001000000000000000000000000000000000000000000000000000000000000000501000000060000000000000000000000000000000000000000000000000000000000000002"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000bb:0x0000000000000000000000000000000000000000000000000000000000000001:0x00a802572c436574f713d43f1852859f4496d694de0e5b17b89cf983439e6143:none",
+      "value": "00000000000000000000000000000000000000000000000000000000000000640000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000bb000000000000000000000000000000000000000000000000000000000000000100000001000000000000000000000000000000000000000000000000000000000000000900000000000000000000000000000000000000000000000000000000000000000000000000"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000bb:0x0000000000000000000000000000000000000000000000000000000000000002:0x00df3f619804a92fdb4057192dc43dd748ea778adc52bc498ce80524c014b811:5:0x0000000000000000000000000000000000000000000000000000000000000001",
+      "value": "00000000000000000000000000000000000000000000000000000000000000640000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000bb00000000000000000000000000000000000000000000000000000000000000020000000001000000050000000000000000000000000000000000000000000000000000000000000001"
+    }
+  ],
+  "facts_by_collection": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000aa",
+      "value": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000aa:0x0000000000000000000000000000000000000000000000000000000000000003:0x00eebee6df09ad503384e049aea9fbf0c0db2f5af46673e550694c6564d973f7:6:0x0000000000000000000000000000000000000000000000000000000000000002"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000bb",
+      "value": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000bb:0x0000000000000000000000000000000000000000000000000000000000000001:0x00a802572c436574f713d43f1852859f4496d694de0e5b17b89cf983439e6143:none"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000bb",
+      "value": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000bb:0x0000000000000000000000000000000000000000000000000000000000000002:0x00df3f619804a92fdb4057192dc43dd748ea778adc52bc498ce80524c014b811:5:0x0000000000000000000000000000000000000000000000000000000000000001"
+    }
+  ],
+  "facts_by_block": [
+    {
+      "key": "num:5",
+      "value": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000bb:0x0000000000000000000000000000000000000000000000000000000000000002:0x00df3f619804a92fdb4057192dc43dd748ea778adc52bc498ce80524c014b811:5:0x0000000000000000000000000000000000000000000000000000000000000001"
+    },
+    {
+      "key": "num:6",
+      "value": "utf8:0x0000000000000000000000000000000000000000000000000000000000000064:0x0000000000000000000000000000000000000000000000000000000000000001:0x0000000000000000000000000000000000000000000000000000000000000007:0x00000000000000000000000000000000000000000000000000000000000000aa:0x0000000000000000000000000000000000000000000000000000000000000003:0x00eebee6df09ad503384e049aea9fbf0c0db2f5af46673e550694c6564d973f7:6:0x0000000000000000000000000000000000000000000000000000000000000002"
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json

@@ -0,0 +1,52 @@
+{
+  "key_store": [
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-ivpk_m",
+      "value": "19e95c05f09cb86d1a6257572f9082ca15d4a02373c4d8c9cee23dc61a4c2a882f9017d51bca6616102d8a1d4dba89e4ce12881a2414576f01d2fec9492814a2"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-ivpk_m_hash",
+      "value": "1fd17152d394f6a43b527c531590888d610d1bcb9aa71a02498ce820bbf4dc62"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-ivsk_m",
+      "value": "1fb01c42d1aaa2662041b899c77cb19e08192193acc5a94405f1b43c974eba7a"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-nhk_m",
+      "value": "2dd30220767969b10044b1322585bb4c4df4e0c5d9b4d7b3045a879a8e3e91d2"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-npk_m",
+      "value": "214c7a24ddf501afc8734c7379ee502296289eb24cd8cd03cd435e128c06be0000987721e0963b4a5bd81ee862e2740d8849fd90537569064d3d3a4640e858d2"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-npk_m_hash",
+      "value": "13ad6965d11a533a663d07507319f74ac3305325f6f72423c0b24aa1193268bb"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-ovpk_m",
+      "value": "2c19ff0b089b07da436e6f7be6b26cdc17b9cee504a528c071ef6a416299683d0b369479d6e50504702d0b56bb56e4e8e0e77171429896651d0c11621e82ebc3"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-ovpk_m_hash",
+      "value": "2a1b054e998835d166711839b515d434b1fbc207ad4fdb5b2b43d6ac6b400871"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-ovsk_m",
+      "value": "279fe6ef7dd2477b919327b1ebab7497c41b9a7ccfa9d5d52e32698e3b85293b"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-tpk_m",
+      "value": "2fcdd0d194adafd753dc0ed279f5cfb54ddcce1dd581d4631cf343ba9ee6c1ab2858abca6c00da3def156b1f12a6464384e326d5fa724c2fc2ff2b7f3fc8ad5f"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-tpk_m_hash",
+      "value": "019f5bb255e87523d43da83ebc9fa95169b653d4abef902e011e9eac620fc45b"
+    },
+    {
+      "key": "utf8:0x2369ead09116908cedc1642d5e0c714ef288ecbc838e4d434f800a408914ce44-tsk_m",
+      "value": "183cb61099458d1564aa57c90c7091ac623a14092ab314150c9cfbb416810320"
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json

@@ -0,0 +1,40 @@
+{
+  "pxe_l2_tips": [
+    {
+      "key": "utf8:checkpointed",
+      "value": "num:71"
+    },
+    {
+      "key": "utf8:proposed",
+      "value": "num:179"
+    },
+    {
+      "key": "utf8:proven",
+      "value": "num:79"
+    }
+  ],
+  "pxe_l2_tip_checkpoints": [
+    {
+      "key": "utf8:checkpointed",
+      "value": "{\"number\":47,\"hash\":\"0x00e66a45cc6583f772f44bdb5ae6535cf821a59a3d832702a125f0c57f6228ef\"}"
+    },
+    {
+      "key": "utf8:proven",
+      "value": "{\"number\":47,\"hash\":\"0x0000000000000000000000000000000000000000000000000000000000000059\"}"
+    }
+  ],
+  "pxe_l2_block_hashes": [
+    {
+      "key": "num:179",
+      "value": "utf8:0x10547c3c23be9d4208cc6d60355ca61c35bd612ace129984ed97a6cc4ec007f8"
+    },
+    {
+      "key": "num:71",
+      "value": "utf8:0x0000000000000000000000000000000000000000000000000000000000000049"
+    },
+    {
+      "key": "num:79",
+      "value": "utf8:0x0000000000000000000000000000000000000000000000000000000000000053"
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json

@@ -0,0 +1,56 @@
+{
+  "notes": [
+    {
+      "key": "utf8:0x000000000000000000000000000000000000000000000000000000000000002b",
+      "value": "00000003000000000000000000000000000000000000000000000000000000000000000d0000000000000000000000000000000000000000000000000000000000000011000000000000000000000000000000000000000000000000000000000000001300000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000017000000000000000000000000000000000000000000000000000000000000001d000000000000000000000000000000000000000000000000000000000000001f00000000000000000000000000000000000000000000000000000000000000250000000000000000000000000000000000000000000000000000000000000029000000000000000000000000000000000000000000000000000000000000002b000000000000000000000000000000000000000000000000000000000000002f00000035000000000000000000000000000000000000000000000000000000000000003b0000003d00000043000000020000004230783030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303500000042307830303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303037"
+    },
+    {
+      "key": "utf8:0x000000000000000000000000000000000000000000000000000000000000006b",
+      "value": "0000000300000000000000000000000000000000000000000000000000000000000000470000000000000000000000000000000000000000000000000000000000000049000000000000000000000000000000000000000000000000000000000000004f000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000530000000000000000000000000000000000000000000000000000000000000059000000000000000000000000000000000000000000000000000000000000006100000000000000000000000000000000000000000000000000000000000000650000000000000000000000000000000000000000000000000000000000000067000000000000000000000000000000000000000000000000000000000000006b000000000000000000000000000000000000000000000000000000000000006d00000071000000000000000000000000000000000000000000000000000000000000007f00000083000000890000000100000042307830303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303035"
+    },
+    {
+      "key": "utf8:0x00000000000000000000000000000000000000000000000000000000000000b5",
+      "value": "00000003000000000000000000000000000000000000000000000000000000000000008b000000000000000000000000000000000000000000000000000000000000009500000000000000000000000000000000000000000000000000000000000000970000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000009d00000000000000000000000000000000000000000000000000000000000000a300000000000000000000000000000000000000000000000000000000000000a700000000000000000000000000000000000000000000000000000000000000ad00000000000000000000000000000000000000000000000000000000000000b300000000000000000000000000000000000000000000000000000000000000b500000000000000000000000000000000000000000000000000000000000000bf000000c100000000000000000000000000000000000000000000000000000000000000c5000000c7000000d30000000100000042307830303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303035"
+    }
+  ],
+  "note_nullifiers_by_contract": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000002",
+      "value": "utf8:0x000000000000000000000000000000000000000000000000000000000000002b"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000002",
+      "value": "utf8:0x000000000000000000000000000000000000000000000000000000000000006b"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000003",
+      "value": "utf8:0x00000000000000000000000000000000000000000000000000000000000000b5"
+    }
+  ],
+  "note_nullifications_by_nullifier": [
+    {
+      "key": "utf8:0x00000000000000000000000000000000000000000000000000000000000000b5",
+      "value": "num:223"
+    }
+  ],
+  "note_nullifiers_by_block": [
+    {
+      "key": "num:113",
+      "value": "utf8:0x000000000000000000000000000000000000000000000000000000000000006b"
+    },
+    {
+      "key": "num:193",
+      "value": "utf8:0x00000000000000000000000000000000000000000000000000000000000000b5"
+    },
+    {
+      "key": "num:53",
+      "value": "utf8:0x000000000000000000000000000000000000000000000000000000000000002b"
+    }
+  ],
+  "note_nullifications_by_block": [
+    {
+      "key": "num:223",
+      "value": "utf8:0x00000000000000000000000000000000000000000000000000000000000000b5"
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json

@@ -0,0 +1,44 @@
+{
+  "private_event_logs": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000017",
+      "value": "000000000000000000000000000000000000000000000000000000000000001d00000003000000000000000000000000000000000000000000000000000000000000001f0000000000000000000000000000000000000000000000000000000000000025000000000000000000000000000000000000000000000000000000000000002900000011000000000000000000000000000000000000000000000000000000000000002f000000000000000000000000000000000000000000000000000000000000002b000000350000003b000000000000000000000000000000000000000000000000000000000000000200000005000000020000004230783030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030306200000042307830303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303064"
+    },
+    {
+      "key": "utf8:0x000000000000000000000000000000000000000000000000000000000000004f",
+      "value": "000000000000000000000000000000000000000000000000000000000000003d00000003000000000000000000000000000000000000000000000000000000000000004300000000000000000000000000000000000000000000000000000000000000470000000000000000000000000000000000000000000000000000000000000049000000110000000000000000000000000000000000000000000000000000000000000059000000000000000000000000000000000000000000000000000000000000005300000061000000650000000000000000000000000000000000000000000000000000000000000002000000050000000100000042307830303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303062"
+    },
+    {
+      "key": "utf8:0x000000000000000000000000000000000000000000000000000000000000007f",
+      "value": "000000000000000000000000000000000000000000000000000000000000006700000003000000000000000000000000000000000000000000000000000000000000006b000000000000000000000000000000000000000000000000000000000000006d000000000000000000000000000000000000000000000000000000000000007100000013000000000000000000000000000000000000000000000000000000000000008900000000000000000000000000000000000000000000000000000000000000830000008b000000950000000000000000000000000000000000000000000000000000000000000003000000070000000100000042307830303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303030303062"
+    }
+  ],
+  "events_by_contract_selector": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000002_0x00000005",
+      "value": "utf8:0x0000000000000000000000000000000000000000000000000000000000000017"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000002_0x00000005",
+      "value": "utf8:0x000000000000000000000000000000000000000000000000000000000000004f"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000003_0x00000007",
+      "value": "utf8:0x000000000000000000000000000000000000000000000000000000000000007f"
+    }
+  ],
+  "events_by_block_number": [
+    {
+      "key": "num:17",
+      "value": "utf8:0x0000000000000000000000000000000000000000000000000000000000000017"
+    },
+    {
+      "key": "num:17",
+      "value": "utf8:0x000000000000000000000000000000000000000000000000000000000000004f"
+    },
+    {
+      "key": "num:19",
+      "value": "utf8:0x000000000000000000000000000000000000000000000000000000000000007f"
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json

@@ -0,0 +1,26 @@
+{
+  "highest_aged_index": [
+    {
+      "key": "utf8:constrained:0x0000000000000000000000000000000000000000000000000000000000000013:0x0000000000000000000000000000000000000000000000000000000000000017",
+      "value": "num:13"
+    },
+    {
+      "key": "utf8:unconstrained:0x0000000000000000000000000000000000000000000000000000000000000002:0x0000000000000000000000000000000000000000000000000000000000000003",
+      "value": "num:13"
+    }
+  ],
+  "highest_finalized_index": [
+    {
+      "key": "utf8:constrained:0x0000000000000000000000000000000000000000000000000000000000000013:0x0000000000000000000000000000000000000000000000000000000000000017",
+      "value": "num:11"
+    },
+    {
+      "key": "utf8:unconstrained:0x0000000000000000000000000000000000000000000000000000000000000002:0x0000000000000000000000000000000000000000000000000000000000000003",
+      "value": "num:11"
+    },
+    {
+      "key": "utf8:unconstrained:0x0000000000000000000000000000000000000000000000000000000000000005:0x0000000000000000000000000000000000000000000000000000000000000007",
+      "value": "num:17"
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json

@@ -0,0 +1,30 @@
+{
+  "pending_indexes": [
+    {
+      "key": "utf8:constrained:0x0000000000000000000000000000000000000000000000000000000000000013:0x0000000000000000000000000000000000000000000000000000000000000017",
+      "value": "[{\"lowestIndex\":4,\"highestIndex\":7,\"txHash\":\"0x0000000000000000000000000000000000000000000000000000000000000025\"}]"
+    },
+    {
+      "key": "utf8:unconstrained:0x0000000000000000000000000000000000000000000000000000000000000002:0x0000000000000000000000000000000000000000000000000000000000000003",
+      "value": "[{\"lowestIndex\":4,\"highestIndex\":7,\"txHash\":\"0x0000000000000000000000000000000000000000000000000000000000000013\"},{\"lowestIndex\":8,\"highestIndex\":11,\"txHash\":\"0x0000000000000000000000000000000000000000000000000000000000000017\"}]"
+    },
+    {
+      "key": "utf8:unconstrained:0x000000000000000000000000000000000000000000000000000000000000000b:0x000000000000000000000000000000000000000000000000000000000000000d",
+      "value": "[{\"lowestIndex\":1,\"highestIndex\":9,\"txHash\":\"0x000000000000000000000000000000000000000000000000000000000000001d\"}]"
+    }
+  ],
+  "last_finalized_indexes": [
+    {
+      "key": "utf8:constrained:0x0000000000000000000000000000000000000000000000000000000000000013:0x0000000000000000000000000000000000000000000000000000000000000017",
+      "value": "num:3"
+    },
+    {
+      "key": "utf8:unconstrained:0x0000000000000000000000000000000000000000000000000000000000000002:0x0000000000000000000000000000000000000000000000000000000000000003",
+      "value": "num:3"
+    },
+    {
+      "key": "utf8:unconstrained:0x0000000000000000000000000000000000000000000000000000000000000005:0x0000000000000000000000000000000000000000000000000000000000000007",
+      "value": "num:5"
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/TaggingSecretSourcesStore.json

@@ -0,0 +1,30 @@
+{
+  "senders": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000002",
+      "value": "true"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000003",
+      "value": "true"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000005",
+      "value": "true"
+    }
+  ],
+  "recipient_shared_secrets": [
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000007",
+      "value": "{\"kind\":\"arbitrary-secret\",\"secret\":\"0x00000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000003\"}"
+    },
+    {
+      "key": "utf8:0x0000000000000000000000000000000000000000000000000000000000000007",
+      "value": "{\"kind\":\"handshake\",\"secret\":\"0x00000000000000000000000000000000000000000000000000000000000000050000000000000000000000000000000000000000000000000000000000000007\"}"
+    },
+    {
+      "key": "utf8:0x000000000000000000000000000000000000000000000000000000000000000b",
+      "value": "{\"kind\":\"arbitrary-secret\",\"secret\":\"0x000000000000000000000000000000000000000000000000000000000000000d0000000000000000000000000000000000000000000000000000000000000011\"}"
+    }
+  ]
+}

package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json

@@ -0,0 +1,117 @@
+{
+  "schemaVersion": 13,
+  "stores": [
+    {
+      "name": "capsules",
+      "kind": "map"
+    },
+    {
+      "name": "complete_address_index",
+      "kind": "map"
+    },
+    {
+      "name": "complete_addresses",
+      "kind": "array"
+    },
+    {
+      "name": "contract_artifacts",
+      "kind": "map"
+    },
+    {
+      "name": "contract_classes",
+      "kind": "map"
+    },
+    {
+      "name": "contracts_instances",
+      "kind": "map"
+    },
+    {
+      "name": "events_by_block_number",
+      "kind": "multimap"
+    },
+    {
+      "name": "events_by_contract_selector",
+      "kind": "multimap"
+    },
+    {
+      "name": "facts",
+      "kind": "map"
+    },
+    {
+      "name": "facts_by_block",
+      "kind": "multimap"
+    },
+    {
+      "name": "facts_by_collection",
+      "kind": "multimap"
+    },
+    {
+      "name": "header",
+      "kind": "singleton"
+    },
+    {
+      "name": "highest_aged_index",
+      "kind": "map"
+    },
+    {
+      "name": "highest_finalized_index",
+      "kind": "map"
+    },
+    {
+      "name": "key_store",
+      "kind": "map"
+    },
+    {
+      "name": "last_finalized_indexes",
+      "kind": "map"
+    },
+    {
+      "name": "note_nullifications_by_block",
+      "kind": "multimap"
+    },
+    {
+      "name": "note_nullifications_by_nullifier",
+      "kind": "map"
+    },
+    {
+      "name": "note_nullifiers_by_block",
+      "kind": "multimap"
+    },
+    {
+      "name": "note_nullifiers_by_contract",
+      "kind": "multimap"
+    },
+    {
+      "name": "notes",
+      "kind": "map"
+    },
+    {
+      "name": "pending_indexes",
+      "kind": "map"
+    },
+    {
+      "name": "private_event_logs",
+      "kind": "map"
+    },
+    {
+      "name": "pxe_l2_block_hashes",
+      "kind": "map"
+    },
+    {
+      "name": "pxe_l2_tip_checkpoints",
+      "kind": "map"
+    },
+    {
+      "name": "pxe_l2_tips",
+      "kind": "map"
+    },
+    {
+      "name": "recipient_shared_secrets",
+      "kind": "multimap"
+    },
+    {
+      "name": "senders",
+      "kind": "map"
+    }
+  ]
+}