@aztec/foundation 0.76.4 → 0.77.0-testnet-ignition.21

package/dest/worker/worker_pool.js

@@ -4,59 +4,48 @@ const log = createLogger('foundation:worker_pool');
  * Allocates a pool of WasmWorker's.
  * Worker 0 is allocated MAX_PAGES memory pages. This is because worker 0 will need to hold the proving key
  * (i.e. Has state), whereas the others are pure compute (they hold a little crs state).
- */
-export class WorkerPool {
-    constructor() {
-        /**
-         * The workers in the pool.
-         */
-        this.workers = [];
-    }
+ */ export class WorkerPool {
+    // TODO(AD): Revisit what this means in aztec 3 context
+    // --
+    // Introduction of low mem prover work (polynomial cache) may actually increase mem usage when the backing store isn't
+    // enabled. We were seeing intermittent failings related to memory in production for some users when limiting to
+    // 6660 (416MB). It would be nice to understand why this is (the non determinism and/or the increased mem usage).
+    // For now, increasing mem usage to 512MB. This maybe preferable to backing out the low mem work, but
+    // ironically may break the chance of us using it in mobile.
+    // We *could* enable the low memory backing store, but this needs a little bit of work to actually
+    // read/write from indexeddb, performance testing, and actual further memory load testing.
+    // At this point it's hard to know what our memory savings would be relative to just fully reverting the LMP.
+    // public static MAX_PAGES = 6660;
+    /**
+   * The maximum number of memory pages to be used by the webassembly.
+   */ static MAX_PAGES = 8192;
     /**
-     * Create an instance and initialize the workers.
-     * @param createWorker - Worker factory.
-     * @param poolSize - Pool size.
-     * @returns An initialized WorkerPool.
-     */
-    static async new(createWorker, poolSize) {
+   * The workers in the pool.
+   */ workers = [];
+    /**
+   * Create an instance and initialize the workers.
+   * @param createWorker - Worker factory.
+   * @param poolSize - Pool size.
+   * @returns An initialized WorkerPool.
+   */ static async new(createWorker, poolSize) {
         const pool = new WorkerPool();
         await pool.init(createWorker, poolSize);
         return pool;
     }
     /**
-     * Initialize the workers.
-     * @param createWorker - Worker factory().
-     * @param poolSize - Pool size.
-     * @param maxMem - Max memory pages.
-     */
-    async init(createWorker, poolSize, maxMem = WorkerPool.MAX_PAGES) {
+   * Initialize the workers.
+   * @param createWorker - Worker factory().
+   * @param poolSize - Pool size.
+   * @param maxMem - Max memory pages.
+   */ async init(createWorker, poolSize, maxMem = WorkerPool.MAX_PAGES) {
         log.debug(`creating ${poolSize} workers...`);
         const start = new Date().getTime();
-        this.workers = await Promise.all(Array(poolSize)
-            .fill(0)
-            .map((_, i) => createWorker(`${i}`, i === 0 ? Math.min(WorkerPool.MAX_PAGES, maxMem) : 768, maxMem)));
+        this.workers = await Promise.all(Array(poolSize).fill(0).map((_, i)=>createWorker(`${i}`, i === 0 ? Math.min(WorkerPool.MAX_PAGES, maxMem) : 768, maxMem)));
         log.debug(`created workers: ${new Date().getTime() - start}ms`);
     }
     /**
-     * Tell all workers in the pool to stop processing.
-     */
-    async destroy() {
-        await Promise.all(this.workers.map(w => w.destroyWorker()));
+   * Tell all workers in the pool to stop processing.
+   */ async destroy() {
+        await Promise.all(this.workers.map((w)=>w.destroyWorker()));
     }
 }
-// TODO(AD): Revisit what this means in aztec 3 context
-// --
-// Introduction of low mem prover work (polynomial cache) may actually increase mem usage when the backing store isn't
-// enabled. We were seeing intermittent failings related to memory in production for some users when limiting to
-// 6660 (416MB). It would be nice to understand why this is (the non determinism and/or the increased mem usage).
-// For now, increasing mem usage to 512MB. This maybe preferable to backing out the low mem work, but
-// ironically may break the chance of us using it in mobile.
-// We *could* enable the low memory backing store, but this needs a little bit of work to actually
-// read/write from indexeddb, performance testing, and actual further memory load testing.
-// At this point it's hard to know what our memory savings would be relative to just fully reverting the LMP.
-// public static MAX_PAGES = 6660;
-/**
- * The maximum number of memory pages to be used by the webassembly.
- */
-WorkerPool.MAX_PAGES = 8192;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid29ya2VyX3Bvb2wuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvd29ya2VyL3dvcmtlcl9wb29sLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUcvQyxNQUFNLEdBQUcsR0FBRyxZQUFZLENBQUMsd0JBQXdCLENBQUMsQ0FBQztBQU9uRDs7OztHQUlHO0FBQ0gsTUFBTSxPQUFPLFVBQVU7SUFBdkI7UUFnQkU7O1dBRUc7UUFDSyxZQUFPLEdBQWlCLEVBQUUsQ0FBQztJQXNDckMsQ0FBQztJQXBDQzs7Ozs7T0FLRztJQUNILE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLFlBQTBCLEVBQUUsUUFBZ0I7UUFDM0QsTUFBTSxJQUFJLEdBQUcsSUFBSSxVQUFVLEVBQUUsQ0FBQztRQUM5QixNQUFNLElBQUksQ0FBQyxJQUFJLENBQUMsWUFBWSxFQUFFLFFBQVEsQ0FBQyxDQUFDO1FBQ3hDLE9BQU8sSUFBSSxDQUFDO0lBQ2QsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ0ksS0FBSyxDQUFDLElBQUksQ0FBQyxZQUEwQixFQUFFLFFBQWdCLEVBQUUsTUFBTSxHQUFHLFVBQVUsQ0FBQyxTQUFTO1FBQzNGLEdBQUcsQ0FBQyxLQUFLLENBQUMsWUFBWSxRQUFRLGFBQWEsQ0FBQyxDQUFDO1FBQzdDLE1BQU0sS0FBSyxHQUFHLElBQUksSUFBSSxFQUFFLENBQUMsT0FBTyxFQUFFLENBQUM7UUFDbkMsSUFBSSxDQUFDLE9BQU8sR0FBRyxNQUFNLE9BQU8sQ0FBQyxHQUFHLENBQzlCLEtBQUssQ0FBQyxRQUFRLENBQUM7YUFDWixJQUFJLENBQUMsQ0FBQyxDQUFDO2FBQ1AsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUMsWUFBWSxDQUFDLEdBQUcsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsU0FBUyxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FDdkcsQ0FBQztRQUVGLEdBQUcsQ0FBQyxLQUFLLENBQUMsb0JBQW9CLElBQUksSUFBSSxFQUFFLENBQUMsT0FBTyxFQUFFLEdBQUcsS0FBSyxJQUFJLENBQUMsQ0FBQztJQUNsRSxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsT0FBTztRQUNsQixNQUFNLE9BQU8sQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsYUFBYSxFQUFFLENBQUMsQ0FBQyxDQUFDO0lBQzlELENBQUM7O0FBdkRELHVEQUF1RDtBQUN2RCxLQUFLO0FBQ0wsc0hBQXNIO0FBQ3RILGdIQUFnSDtBQUNoSCxpSEFBaUg7QUFDakgscUdBQXFHO0FBQ3JHLDREQUE0RDtBQUM1RCxrR0FBa0c7QUFDbEcsMEZBQTBGO0FBQzFGLDZHQUE2RztBQUM3RyxrQ0FBa0M7QUFDbEM7O0dBRUc7QUFDVyxvQkFBUyxHQUFHLElBQUksQUFBUCxDQUFRIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aztec/foundation",
-  "version": "0.76.4",
+  "version": "0.77.0-testnet-ignition.21",
   "type": "module",
   "main": "./dest/index.js",
   "types": "./dest/index.d.ts",
@@ -11,7 +11,6 @@
     "./abi": "./dest/abi/index.js",
     "./async-map": "./dest/async-map/index.js",
     "./async-pool": "./dest/async-pool/index.js",
-    "./aztec-address": "./dest/aztec-address/index.js",
     "./collection": "./dest/collection/index.js",
     "./config": "./dest/config/index.js",
     "./crypto": "./dest/crypto/index.js",
@@ -62,7 +61,7 @@
     "generate": "true",
     "formatting": "run -T prettier --check ./src && run -T eslint ./src",
     "formatting:fix": "run -T eslint --fix ./src && run -T prettier -w ./src",
-    "test": "HARDWARE_CONCURRENCY=${HARDWARE_CONCURRENCY:-16} RAYON_NUM_THREADS=${RAYON_NUM_THREADS:-4} NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}"
+    "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}"
   },
   "inherits": [
     "../package.common.json"
@@ -95,7 +94,7 @@
     "reporters": [
       "default"
     ],
-    "testTimeout": 30000,
+    "testTimeout": 120000,
     "setupFilesAfterEnv": [
       "../../foundation/src/jest/setup.mjs"
     ],
@@ -104,7 +103,7 @@
     ]
   },
   "dependencies": {
-    "@aztec/bb.js": "0.76.4",
+    "@aztec/bb.js": "0.77.0-testnet-ignition.21",
     "@koa/cors": "^5.0.0",
     "@noble/curves": "^1.2.0",
     "bn.js": "^5.2.1",
@@ -132,6 +131,7 @@
   },
   "devDependencies": {
     "@jest/globals": "^29.5.0",
+    "@libp2p/interface": "1.3.1",
     "@types/bn.js": "^5.1.3",
     "@types/debug": "^4.1.7",
     "@types/detect-node": "^2.0.0",

package/src/array/array.ts

@@ -1,4 +1,4 @@
-import { type Tuple } from '../serialize/index.js';
+import type { Tuple } from '../serialize/index.js';
 
 export type { FieldsOf } from '../types/index.js';
 

package/src/buffer/buffer32.ts

@@ -1,5 +1,5 @@
 import { randomBytes } from '@aztec/foundation/crypto';
-import { type Fr } from '@aztec/foundation/fields';
+import type { Fr } from '@aztec/foundation/fields';
 import { BufferReader, deserializeBigInt, serializeBigInt } from '@aztec/foundation/serialize';
 
 import { bufferToHex } from '../string/index.js';

package/src/collection/array.ts

@@ -1,4 +1,4 @@
-import { type Tuple } from '../serialize/types.js';
+import type { Tuple } from '../serialize/types.js';
 
 /**
  * Pads an array to the target length by appending an element to its end. Throws if target length exceeds the input array length. Does not modify the input array.

package/src/config/env_var.ts

@@ -26,6 +26,8 @@ export type EnvVar =
   | 'BOT_MAX_PENDING_TXS'
   | 'BOT_NO_START'
   | 'BOT_NO_WAIT_FOR_TRANSFERS'
+  | 'BOT_L1_MNEMONIC'
+  | 'BOT_L1_PRIVATE_KEY'
   | 'BOT_PRIVATE_KEY'
   | 'BOT_PRIVATE_TRANSFERS_PER_TX'
   | 'BOT_PUBLIC_TRANSFERS_PER_TX'
@@ -42,12 +44,11 @@ export type EnvVar =
   | 'DATA_DIRECTORY'
   | 'DATA_STORE_MAP_SIZE_KB'
   | 'DEBUG'
-  | 'DEBUG_P2P_DISABLE_MESSAGE_VALIDATION'
   | 'DEBUG_P2P_DISABLE_COLOCATION_PENALTY'
   | 'DEPLOY_AZTEC_CONTRACTS_SALT'
   | 'DEPLOY_AZTEC_CONTRACTS'
   | 'ENFORCE_FEES'
-  | 'ETHEREUM_HOST'
+  | 'ETHEREUM_HOSTS'
   | 'FEE_JUICE_CONTRACT_ADDRESS'
   | 'FEE_JUICE_PORTAL_CONTRACT_ADDRESS'
   | 'FEE_RECIPIENT'
@@ -71,11 +72,9 @@ export type EnvVar =
   | 'NO_PXE'
   | 'COIN_ISSUER_CONTRACT_ADDRESS'
   | 'USE_GCLOUD_LOGGING'
-  | 'USE_GCLOUD_METRICS'
   | 'OTEL_EXPORTER_OTLP_METRICS_ENDPOINT'
   | 'OTEL_EXPORTER_OTLP_TRACES_ENDPOINT'
   | 'OTEL_EXPORTER_OTLP_LOGS_ENDPOINT'
-  | 'OTEL_SERVICE_NAME'
   | 'OTEL_COLLECT_INTERVAL_MS'
   | 'OTEL_EXCLUDE_METRICS'
   | 'OTEL_EXPORT_TIMEOUT_MS'
@@ -83,6 +82,7 @@ export type EnvVar =
   | 'P2P_BLOCK_CHECK_INTERVAL_MS'
   | 'P2P_BLOCK_REQUEST_BATCH_SIZE'
   | 'P2P_BOOTSTRAP_NODE_ENR_VERSION_CHECK'
+  | 'P2P_BOOTSTRAP_NODES_AS_FULL_PEERS'
   | 'P2P_ENABLED'
   | 'P2P_GOSSIPSUB_D'
   | 'P2P_GOSSIPSUB_DHI'
@@ -113,7 +113,6 @@ export type EnvVar =
   | 'P2P_ARCHIVED_TX_LIMIT'
   | 'PEER_ID_PRIVATE_KEY'
   | 'PROOF_VERIFIER_L1_START_BLOCK'
-  | 'PROOF_VERIFIER_POLL_INTERVAL_MS'
   | 'PROVER_AGENT_ENABLED'
   | 'PROVER_AGENT_CONCURRENCY'
   | 'PROVER_AGENT_COUNT'
@@ -126,6 +125,7 @@ export type EnvVar =
   | 'PROVER_BROKER_JOB_MAX_RETRIES'
   | 'PROVER_BROKER_BATCH_INTERVAL_MS'
   | 'PROVER_BROKER_BATCH_SIZE'
+  | 'PROVER_BROKER_MAX_EPOCHS_TO_KEEP_RESULTS_FOR'
   | 'PROVER_COORDINATION_NODE_URL'
   | 'PROVER_DISABLED'
   | 'PROVER_FAILED_PROOF_STORE'
@@ -142,7 +142,9 @@ export type EnvVar =
   | 'PROVER_PUBLISHER_PRIVATE_KEY'
   | 'PROVER_REAL_PROOFS'
   | 'PROVER_REQUIRED_CONFIRMATIONS'
+  | 'PROVER_TEST_DELAY_FACTOR'
   | 'PROVER_TEST_DELAY_MS'
+  | 'PROVER_TEST_DELAY_TYPE'
   | 'PXE_L2_STARTING_BLOCK'
   | 'PXE_PROVER_ENABLED'
   | 'PROVER_TARGET_ESCROW_AMOUNT'

package/src/config/index.ts

@@ -1,4 +1,4 @@
-import { type EnvVar } from './env_var.js';
+import type { EnvVar } from './env_var.js';
 
 export { type EnvVar } from './env_var.js';
 

package/src/crypto/aes128/index.ts

@@ -0,0 +1,59 @@
+import { BarretenbergSync, RawBuffer } from '@aztec/bb.js';
+
+import { Buffer } from 'buffer';
+
+/**
+ * AES-128-CBC encryption/decryption.
+ */
+export class Aes128 {
+  /**
+   * Encrypt a buffer using AES-128-CBC.
+   * @param data - Data to encrypt.
+   * @param iv - AES initialization vector.
+   * @param key - Key to encrypt with.
+   * @returns Encrypted data.
+   */
+  public async encryptBufferCBC(data: Uint8Array, iv: Uint8Array, key: Uint8Array) {
+    const rawLength = data.length;
+    const numPaddingBytes = 16 - (rawLength % 16);
+    const paddingBuffer = Buffer.alloc(numPaddingBytes);
+    // input num bytes needs to be a multiple of 16 and at least 1 byte
+    // node uses PKCS#7-Padding scheme, where padding byte value = the number of padding bytes
+    paddingBuffer.fill(numPaddingBytes);
+    const input = Buffer.concat([data, paddingBuffer]);
+
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    return Buffer.from(
+      api.aesEncryptBufferCbc(new RawBuffer(input), new RawBuffer(iv), new RawBuffer(key), input.length),
+    );
+  }
+
+  /**
+   * Decrypt a buffer using AES-128-CBC.
+   * We keep the padding in the returned buffer.
+   * @param data - Data to decrypt.
+   * @param iv - AES initialization vector.
+   * @param key - Key to decrypt with.
+   * @returns Decrypted data.
+   */
+  public async decryptBufferCBCKeepPadding(data: Uint8Array, iv: Uint8Array, key: Uint8Array): Promise<Buffer> {
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    const paddedBuffer = Buffer.from(
+      api.aesDecryptBufferCbc(new RawBuffer(data), new RawBuffer(iv), new RawBuffer(key), data.length),
+    );
+    return paddedBuffer;
+  }
+
+  /**
+   * Decrypt a buffer using AES-128-CBC.
+   * @param data - Data to decrypt.
+   * @param iv - AES initialization vector.
+   * @param key - Key to decrypt with.
+   * @returns Decrypted data.
+   */
+  public async decryptBufferCBC(data: Uint8Array, iv: Uint8Array, key: Uint8Array) {
+    const paddedBuffer = await this.decryptBufferCBCKeepPadding(data, iv, key);
+    const paddingToRemove = paddedBuffer[paddedBuffer.length - 1];
+    return paddedBuffer.subarray(0, paddedBuffer.length - paddingToRemove);
+  }
+}

package/src/crypto/ecdsa/index.ts

@@ -0,0 +1,70 @@
+import { BarretenbergSync } from '@aztec/bb.js';
+import { numToInt32BE } from '@aztec/foundation/serialize';
+
+import { concatenateUint8Arrays } from '../serialize.js';
+import { EcdsaSignature } from './signature.js';
+
+export * from './signature.js';
+
+/**
+ * ECDSA signature construction and helper operations.
+ * TODO: Replace with codegen api on bb.js.
+ */
+export class Ecdsa {
+  /**
+   * Computes a secp256k1 public key from a private key.
+   * @param privateKey - Secp256k1 private key.
+   * @returns A secp256k1 public key.
+   */
+  public async computePublicKey(privateKey: Buffer): Promise<Buffer> {
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    const [result] = api.getWasm().callWasmExport('ecdsa__compute_public_key', [privateKey], [64]);
+    return Buffer.from(result);
+  }
+
+  /**
+   * Constructs an ECDSA signature given a msg and a private key.
+   * @param msg - Message over which the signature is constructed.
+   * @param privateKey - The secp256k1 private key of the signer.
+   * @returns An ECDSA signature of the form (r, s, v).
+   */
+  public async constructSignature(msg: Uint8Array, privateKey: Buffer) {
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    const messageArray = concatenateUint8Arrays([numToInt32BE(msg.length), msg]);
+    const [r, s, v] = api
+      .getWasm()
+      .callWasmExport('ecdsa__construct_signature_', [messageArray, privateKey], [32, 32, 1]);
+    return new EcdsaSignature(Buffer.from(r), Buffer.from(s), Buffer.from(v));
+  }
+
+  /**
+   * Recovers a secp256k1 public key from an ECDSA signature (similar to ecrecover).
+   * @param msg - Message over which the signature was constructed.
+   * @param sig - The ECDSA signature.
+   * @returns The secp256k1 public key of the signer.
+   */
+  public async recoverPublicKey(msg: Uint8Array, sig: EcdsaSignature): Promise<Buffer> {
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    const messageArray = concatenateUint8Arrays([numToInt32BE(msg.length), msg]);
+    const [result] = api
+      .getWasm()
+      .callWasmExport('ecdsa__recover_public_key_from_signature_', [messageArray, sig.r, sig.s, sig.v], [64]);
+    return Buffer.from(result);
+  }
+
+  /**
+   * Verifies and ECDSA signature given a secp256k1 public key.
+   * @param msg - Message over which the signature was constructed.
+   * @param pubKey - The secp256k1 public key of the signer.
+   * @param sig - The ECDSA signature.
+   * @returns True or false.
+   */
+  public async verifySignature(msg: Uint8Array, pubKey: Buffer, sig: EcdsaSignature) {
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    const messageArray = concatenateUint8Arrays([numToInt32BE(msg.length), msg]);
+    const [result] = api
+      .getWasm()
+      .callWasmExport('ecdsa__verify_signature_', [messageArray, pubKey, sig.r, sig.s, sig.v], [1]);
+    return result[0] === 1;
+  }
+}

package/src/crypto/ecdsa/signature.ts

@@ -0,0 +1,100 @@
+import { toBufferBE } from '@aztec/foundation/bigint-buffer';
+import { randomBytes } from '@aztec/foundation/crypto';
+import { Fr } from '@aztec/foundation/fields';
+import { mapTuple } from '@aztec/foundation/serialize';
+
+import type { Signature } from '../signature/index.js';
+
+/**
+ * ECDSA signature used for transactions.
+ * @see cpp/barretenberg/cpp/src/barretenberg/crypto/ecdsa/ecdsa.hpp
+ */
+export class EcdsaSignature implements Signature {
+  constructor(
+    /**
+     * The r byte-array (32 bytes) in an ECDSA signature.
+     */
+    public r: Buffer,
+    /**
+     * The s byte-array (32 bytes) in an ECDSA signature.
+     */
+    public s: Buffer,
+    /**
+     * The recovery id (1 byte) in an ECDSA signature.
+     */
+    public v: Buffer,
+  ) {
+    if (r.length != 32) {
+      throw new Error(`Invalid length of 'r' in ECDSA signature. Expected 32, got ${s.length}`);
+    }
+    if (s.length != 32) {
+      throw new Error(`Invalid length of 's' in ECDSA signature. Expected 32, got ${r.length}`);
+    }
+    if (v.length != 1) {
+      throw new Error(`Invalid length of 'v' in ECDSA signature. Expected 1, got ${v.length}`);
+    }
+  }
+
+  /**
+   * Converts an ECDSA signature to a buffer.
+   * @returns A buffer.
+   */
+  toBuffer() {
+    return Buffer.concat([this.r, this.s, this.v]);
+  }
+
+  /**
+   * Deserializes the signature from a buffer.
+   * @param buffer - The buffer from which to deserialize the signature.
+   * @returns The ECDSA signature
+   */
+  public static fromBuffer(buffer: Buffer) {
+    return new EcdsaSignature(buffer.subarray(0, 32), buffer.subarray(32, 64), buffer.subarray(64, 65));
+  }
+
+  /**
+   * Creates a new instance from bigint r and s values.
+   * @param r - r.
+   * @param s - s.
+   * @param v - v.
+   * @returns The resulting signature.
+   */
+  public static fromBigInts(r: bigint, s: bigint, v: number) {
+    return new EcdsaSignature(toBufferBE(r, 32), toBufferBE(s, 32), Buffer.from([v]));
+  }
+
+  /**
+   * Generate a random ECDSA signature for testing.
+   * @returns A randomly generated ECDSA signature (not a valid one).
+   */
+  public static random() {
+    return new EcdsaSignature(randomBytes(32), randomBytes(32), Buffer.from([27]));
+  }
+
+  /**
+   * Convert an ECDSA signature to a buffer.
+   * @returns A 65-character string of the form 0x<r><s><v>.
+   */
+  toString() {
+    return `0x${this.toBuffer().toString('hex')}`;
+  }
+
+  /**
+   * Converts the signature to an array of fields.
+   * @param includeV - Determines whether the 'v' term is included
+   * @returns The signature components as an array of fields
+   */
+  toFields(includeV = false): Fr[] {
+    const sig = this.toBuffer();
+
+    const buf1 = Buffer.alloc(32);
+    const buf2 = Buffer.alloc(32);
+    const buf3 = Buffer.alloc(32);
+
+    sig.copy(buf1, 1, 0, 31);
+    sig.copy(buf2, 1, 31, 62);
+    sig.copy(buf3, 1, 62, includeV ? 65 : 64);
+
+    return mapTuple([buf1, buf2, buf3], Fr.fromBuffer);
+  }
+}

package/src/crypto/grumpkin/index.ts

@@ -0,0 +1,97 @@
+import { BarretenbergSync } from '@aztec/bb.js';
+import { Fr, type GrumpkinScalar, Point } from '@aztec/foundation/fields';
+
+/**
+ * Grumpkin elliptic curve operations.
+ */
+export class Grumpkin {
+  // prettier-ignore
+  static generator = Point.fromBuffer(Buffer.from([
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xcf, 0x13, 0x5e, 0x75, 0x06, 0xa4, 0x5d, 0x63,
+    0x2d, 0x27, 0x0d, 0x45, 0xf1, 0x18, 0x12, 0x94, 0x83, 0x3f, 0xc4, 0x8d, 0x82, 0x3f, 0x27, 0x2c,
+  ]));
+
+  /**
+   * Point generator
+   * @returns The generator for the curve.
+   */
+  public generator(): Point {
+    return Grumpkin.generator;
+  }
+
+  /**
+   * Multiplies a point by a scalar (adds the point `scalar` amount of times).
+   * @param point - Point to multiply.
+   * @param scalar - Scalar to multiply by.
+   * @returns Result of the multiplication.
+   */
+  public async mul(point: Point, scalar: GrumpkinScalar): Promise<Point> {
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    const [result] = api.getWasm().callWasmExport('ecc_grumpkin__mul', [point.toBuffer(), scalar.toBuffer()], [64]);
+    return Point.fromBuffer(Buffer.from(result));
+  }
+
+  /**
+   * Add two points.
+   * @param a - Point a in the addition
+   * @param b - Point b to add to a
+   * @returns Result of the addition.
+   */
+  public async add(a: Point, b: Point): Promise<Point> {
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    const [result] = api.getWasm().callWasmExport('ecc_grumpkin__add', [a.toBuffer(), b.toBuffer()], [64]);
+    return Point.fromBuffer(Buffer.from(result));
+  }
+
+  /**
+   * Multiplies a set of points by a scalar.
+   * @param points - Points to multiply.
+   * @param scalar - Scalar to multiply by.
+   * @returns Points multiplied by the scalar.
+   */
+  public async batchMul(points: Point[], scalar: GrumpkinScalar) {
+    const concatenatedPoints: Buffer = Buffer.concat(points.map(point => point.toBuffer()));
+
+    const pointsByteLength = points.length * Point.SIZE_IN_BYTES;
+
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    const [result] = api
+      .getWasm()
+      .callWasmExport(
+        'ecc_grumpkin__batch_mul',
+        [concatenatedPoints, scalar.toBuffer(), points.length],
+        [pointsByteLength],
+      );
+
+    const parsedResult: Point[] = [];
+    for (let i = 0; i < pointsByteLength; i += 64) {
+      parsedResult.push(Point.fromBuffer(Buffer.from(result.subarray(i, i + 64))));
+    }
+    return parsedResult;
+  }
+
+  /**
+   * Gets a random field element.
+   * @returns Random field element.
+   */
+  public async getRandomFr(): Promise<Fr> {
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    const [result] = api.getWasm().callWasmExport('ecc_grumpkin__get_random_scalar_mod_circuit_modulus', [], [32]);
+    return Fr.fromBuffer(Buffer.from(result));
+  }
+
+  /**
+   * Converts a 512 bits long buffer to a field.
+   * @param uint512Buf - The buffer to convert.
+   * @returns Buffer representation of the field element.
+   */
+  public async reduce512BufferToFr(uint512Buf: Buffer): Promise<Fr> {
+    const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
+    const [result] = api
+      .getWasm()
+      .callWasmExport('ecc_grumpkin__reduce512_buffer_mod_circuit_modulus', [uint512Buf], [32]);
+    return Fr.fromBuffer(Buffer.from(result));
+  }
+}

package/src/crypto/index.ts

@@ -6,3 +6,9 @@ export * from './pedersen/index.js';
 export * from './poseidon/index.js';
 export * from './secp256k1-signer/index.js';
 export * from './keys/index.js';
+export * from './aes128/index.js';
+export * from './grumpkin/index.js';
+export * from './ecdsa/index.js';
+export * from './secp256k1/index.js';
+export * from './schnorr/index.js';
+export * from './signature/index.js';

package/src/crypto/keys/index.ts

@@ -3,7 +3,7 @@ import { BarretenbergSync, RawBuffer } from '@aztec/bb.js';
 import { Fr } from '../../fields/fields.js';
 
 export async function vkAsFieldsMegaHonk(input: Buffer): Promise<Fr[]> {
-  const api = await BarretenbergSync.initSingleton();
+  const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
   const result = api.acirVkAsFieldsMegaHonk(new RawBuffer(input));
 
   return result.map(bbFr => Fr.fromBuffer(Buffer.from(bbFr.toBuffer()))); // TODO(#4189): remove this conversion

package/src/crypto/pedersen/pedersen.wasm.ts

@@ -12,7 +12,7 @@ export async function pedersenCommit(input: Buffer[], offset = 0) {
     throw new Error('All Pedersen Commit input buffers must be <= 32 bytes.');
   }
   input = input.map(i => (i.length < 32 ? Buffer.concat([Buffer.alloc(32 - i.length, 0), i]) : i));
-  const api = await BarretenbergSync.initSingleton();
+  const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
   const point = api.pedersenCommit(
     input.map(i => new FrBarretenberg(i)),
     offset,
@@ -30,7 +30,7 @@ export async function pedersenCommit(input: Buffer[], offset = 0) {
  */
 export async function pedersenHash(input: Fieldable[], index = 0): Promise<Fr> {
   const inputFields = serializeToFields(input);
-  const api = await BarretenbergSync.initSingleton();
+  const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
   const hash = api.pedersenHash(
     inputFields.map(i => new FrBarretenberg(i.toBuffer())), // TODO(#4189): remove this stupid conversion
     index,
@@ -42,7 +42,7 @@ export async function pedersenHash(input: Fieldable[], index = 0): Promise<Fr> {
  * Create a pedersen hash from an arbitrary length buffer.
  */
 export async function pedersenHashBuffer(input: Buffer, index = 0) {
-  const api = await BarretenbergSync.initSingleton();
+  const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
   const result = api.pedersenHashBuffer(input, index);
   return Buffer.from(result.toBuffer());
 }

package/src/crypto/poseidon/index.ts

@@ -10,7 +10,7 @@ import { type Fieldable, serializeToFields } from '../../serialize/serialize.js'
  */
 export async function poseidon2Hash(input: Fieldable[]): Promise<Fr> {
   const inputFields = serializeToFields(input);
-  const api = await BarretenbergSync.initSingleton();
+  const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
   const hash = api.poseidon2Hash(
     inputFields.map(i => new FrBarretenberg(i.toBuffer())), // TODO(#4189): remove this stupid conversion
   );
@@ -26,7 +26,7 @@ export async function poseidon2Hash(input: Fieldable[]): Promise<Fr> {
 export async function poseidon2HashWithSeparator(input: Fieldable[], separator: number): Promise<Fr> {
   const inputFields = serializeToFields(input);
   inputFields.unshift(new Fr(separator));
-  const api = await BarretenbergSync.initSingleton();
+  const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
 
   const hash = api.poseidon2Hash(
     inputFields.map(i => new FrBarretenberg(i.toBuffer())), // TODO(#4189): remove this stupid conversion
@@ -36,7 +36,7 @@ export async function poseidon2HashWithSeparator(input: Fieldable[], separator:
 
 export async function poseidon2HashAccumulate(input: Fieldable[]): Promise<Fr> {
   const inputFields = serializeToFields(input);
-  const api = await BarretenbergSync.initSingleton();
+  const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
   const result = api.poseidon2HashAccumulate(inputFields.map(i => new FrBarretenberg(i.toBuffer())));
   return Fr.fromBuffer(Buffer.from(result.toBuffer()));
 }
@@ -50,7 +50,7 @@ export async function poseidon2Permutation(input: Fieldable[]): Promise<Fr[]> {
   const inputFields = serializeToFields(input);
   // We'd like this assertion but it's not possible to use it in the browser.
   // assert(input.length === 4, 'Input state must be of size 4');
-  const api = await BarretenbergSync.initSingleton();
+  const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
   const res = api.poseidon2Permutation(inputFields.map(i => new FrBarretenberg(i.toBuffer())));
   // We'd like this assertion but it's not possible to use it in the browser.
   // assert(res.length === 4, 'Output state must be of size 4');
@@ -68,7 +68,7 @@ export async function poseidon2HashBytes(input: Buffer): Promise<Fr> {
     inputFields.push(Fr.fromBuffer(fieldBytes));
   }
 
-  const api = await BarretenbergSync.initSingleton();
+  const api = await BarretenbergSync.initSingleton(process.env.BB_WASM_PATH);
   const res = api.poseidon2Hash(
     inputFields.map(i => new FrBarretenberg(i.toBuffer())), // TODO(#4189): remove this stupid conversion
   );