@aztec/foundation 0.74.0 → 0.75.0-commit.c03ba01a2a4122e43e90d5133ba017e54b90e9d2

package/dest/wasm/wasm_module.d.ts

@@ -1,136 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { Buffer } from 'buffer';
-import { type LogFn } from '../log/index.js';
-/**
- * The base shape of a WASM module providing low level memory and synchronous call access.
- * Note that the Aztec codebase used to support asyncify but has fully moved away,
- * using web workers if needed.
- */
-export interface IWasmModule {
-    /**
-     * Low level call function, returns result as number.
-     * @param name - The function name.
-     * @param args - The function args.
-     * @returns The value as an integer (could be pointer).
-     */
-    call(name: string, ...args: any): number;
-    /**
-     * Get a slice of memory between two addresses.
-     * @param start - The start address.
-     * @param end - The end address.
-     * @returns A Uint8Array view of memory.
-     */
-    getMemorySlice(start: number, end: number): Uint8Array;
-    /**
-     * Write data into the heap.
-     * @param offset - The address to write data at.
-     * @param arr - The data to write.
-     */
-    writeMemory(offset: number, arr: Uint8Array): void;
-}
-/**
- * WasmModule:
- *  Helper over a webassembly module.
- *  Assumes a few quirks.
- *  1) the module expects wasi_snapshot_preview1 with the methods from getEmptyWasiSdk
- *  2) of which the webassembly
- *  we instantiate only uses random_get (update this if more WASI sdk methods are needed).
- */
-export declare class WasmModule implements IWasmModule {
-    private module;
-    private importFn;
-    private memory;
-    private heap;
-    private instance?;
-    private mutexQ;
-    private debug;
-    /**
-     * Create a wasm module. Should be followed by await init();.
-     * @param module - The module as a WebAssembly.Module or a Buffer.
-     * @param importFn - Imports expected by the WASM.
-     * @param loggerName - Optional, for debug logging.
-     */
-    constructor(module: WebAssembly.Module | Buffer, importFn: (module: WasmModule) => any, loggerName?: string);
-    /**
-     * Return the wasm source.
-     * @returns The source.
-     */
-    getModule(): WebAssembly.Module | Buffer;
-    /**
-     * Initialize this wasm module.
-     * @param wasmImportEnv - Linked to a module called "env". Functions implementations referenced from e.g. C++.
-     * @param initial - 30 pages by default. 30*2**16 \> 1mb stack size plus other overheads.
-     * @param initMethod - Defaults to calling '_initialize'.
-     * @param maximum - 8192 maximum by default. 512mb.
-     */
-    init(initial?: number, maximum?: number, initMethod?: string | null): Promise<void>;
-    /**
-     * The methods or objects exported by the WASM module.
-     * @returns An indexable object.
-     */
-    exports(): any;
-    /**
-     * Get the current logger.
-     * @returns Logging function.
-     */
-    getLogger(): LogFn;
-    /**
-     * Add a logger.
-     * @param logger - Function to call when logging.
-     */
-    addLogger(logger: LogFn): void;
-    /**
-     * Calls into the WebAssembly.
-     * @param name - The method name.
-     * @param args - The arguments to the method.
-     * @returns The numeric method result.
-     */
-    call(name: string, ...args: any): number;
-    /**
-     * Get the memory used by the WASM module.
-     * @returns A WebAssembly memory object.
-     */
-    getRawMemory(): WebAssembly.Memory;
-    /**
-     * Get the memory used by the WASM module, as a byte array.
-     * @returns A Uint8Array view of the WASM module memory.
-     */
-    getMemory(): Uint8Array;
-    /**
-     * The memory size in bytes.
-     * @returns Number of bytes.
-     */
-    memSize(): number;
-    /**
-     * Get a slice of memory between two addresses.
-     * @param start - The start address.
-     * @param end - The end address.
-     * @returns A Uint8Array view of memory.
-     */
-    getMemorySlice(start: number, end: number): Uint8Array;
-    /**
-     * Write data into the heap.
-     * @param offset - The address to write data at.
-     * @param arr - The data to write.
-     */
-    writeMemory(offset: number, arr: Uint8Array): void;
-    /**
-     * Read WASM memory as a JS string.
-     * @param addr - The memory address.
-     * @returns A JS string.
-     */
-    getMemoryAsString(addr: number): string;
-    /**
-     * When calling the wasm, sometimes a caller will require exclusive access over a series of calls.
-     * E.g. When a result is written to address 0, one cannot have another caller writing to the same address via
-     * writeMemory before the result is read via sliceMemory.
-     * Acquire() gets a single token from a fifo. The caller must call release() to add the token back.
-     */
-    acquire(): Promise<void>;
-    /**
-     * Release the mutex, letting another promise call acquire().
-     */
-    release(): void;
-}
-//# sourceMappingURL=wasm_module.d.ts.map

package/dest/wasm/wasm_module.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasm_module.d.ts","sourceRoot":"","sources":["../../src/wasm/wasm_module.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,KAAK,KAAK,EAAyB,MAAM,iBAAiB,CAAC;AAIpE;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,MAAM,CAAC;IAEzC;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;IAEvD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;CACpD;AAED;;;;;;;GAOG;AACH,qBAAa,UAAW,YAAW,WAAW;IAc1C,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAdlB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,CAAuB;IACxC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,KAAK,CAAQ;IAErB;;;;;OAKG;gBAEO,MAAM,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,EACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,GAAG,EAC7C,UAAU,SAAS;IAMrB;;;OAGG;IACI,SAAS,IAAI,WAAW,CAAC,MAAM,GAAG,MAAM;IAG/C;;;;;;OAMG;IACU,IAAI,CAAC,OAAO,SAAK,EAAE,OAAO,SAAO,EAAE,UAAU,GAAE,MAAM,GAAG,IAAoB;IA6CzF;;;OAGG;IACI,OAAO,IAAI,GAAG;IAOrB;;;OAGG;IACI,SAAS;IAIhB;;;OAGG;IACI,SAAS,CAAC,MAAM,EAAE,KAAK;IAQ9B;;;;;OAKG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,MAAM;IAa/C;;;OAGG;IACI,YAAY,IAAI,WAAW,CAAC,MAAM;IAGzC;;;OAGG;IACI,SAAS,IAAI,UAAU;IAQ9B;;;OAGG;IACI,OAAO,IAAI,MAAM;IAIxB;;;;;OAKG;IACI,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU;IAI7D;;;;OAIG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU;IAOlD;;;;OAIG;IACI,iBAAiB,CAAC,IAAI,EAAE,MAAM;IAUrC;;;;;OAKG;IACU,OAAO;IAIpB;;OAEG;IACI,OAAO;CAMf"}

package/dest/worker/browser/index.d.ts

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

package/dest/worker/browser/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/worker/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dest/worker/browser/start_web_module.d.ts

@@ -1,7 +0,0 @@
-import { type WasmModule } from '../../wasm/index.js';
-/**
- * Start the transport server corresponding to this module.
- * @param module - The WasmModule to host.
- */
-export declare function startWebModule(module: WasmModule): void;
-//# sourceMappingURL=start_web_module.d.ts.map

package/dest/worker/browser/start_web_module.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"start_web_module.d.ts","sourceRoot":"","sources":["../../../src/worker/browser/start_web_module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,QAgBhD"}

package/dest/worker/browser/web_data_store.d.ts

@@ -1,24 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { type DataStore } from '../data_store.js';
-/**
- * Cache for data used by wasm module.
- * Stores in a LevelUp database.
- */
-export declare class WebDataStore implements DataStore {
-    private db;
-    constructor();
-    /**
-     * Lookup a key.
-     * @param key - Key to lookup.
-     * @returns The buffer.
-     */
-    get(key: string): Promise<Buffer | undefined>;
-    /**
-     * Alter a key.
-     * @param key - Key to alter.
-     * @param value - Buffer to store.
-     */
-    set(key: string, value: Buffer): Promise<void>;
-}
-//# sourceMappingURL=web_data_store.d.ts.map

package/dest/worker/browser/web_data_store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"web_data_store.d.ts","sourceRoot":"","sources":["../../../src/worker/browser/web_data_store.ts"],"names":[],"mappings":";;AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,EAAE,CAAU;;IAUpB;;;;OAIG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAInD;;;;OAIG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrD"}

package/dest/worker/browser/web_worker.d.ts

@@ -1,10 +0,0 @@
-import { type WasmWorker } from '../wasm_worker.js';
-/**
- * Instantiate a web worker.
- * @param url - The URL.
- * @param initialMem - Initial memory pages.
- * @param maxMem - Maximum memory pages.
- * @returns The worker.
- */
-export declare function createWebWorker(url: string, initialMem?: number, maxMem?: number): Promise<WasmWorker>;
-//# sourceMappingURL=web_worker.d.ts.map

package/dest/worker/browser/web_worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"web_worker.d.ts","sourceRoot":"","sources":["../../../src/worker/browser/web_worker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAa5G"}

package/dest/worker/data_store.d.ts

@@ -1,21 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/**
- * Simple read/write interface for wasm modules.
- */
-export interface DataStore {
-    /**
-     * Get a value from our DB.
-     * @param key - The key to look up.
-     * @returns The value.
-     */
-    get(key: string): Promise<Buffer | undefined>;
-    /**
-     * Set a value in our DB.
-     * @param key - The key to update.
-     * @param value - The value to set.
-     * @returns Nothing.
-     */
-    set(key: string, value: Buffer): Promise<void>;
-}
-//# sourceMappingURL=data_store.d.ts.map

package/dest/worker/data_store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"data_store.d.ts","sourceRoot":"","sources":["../../src/worker/data_store.ts"],"names":[],"mappings":";;AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD"}

package/dest/worker/index.d.ts

@@ -1,3 +0,0 @@
-export { WorkerPool } from './worker_pool.js';
-export { WasmWorker } from './wasm_worker.js';
-//# sourceMappingURL=index.d.ts.map

package/dest/worker/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dest/worker/node/index.d.ts

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

package/dest/worker/node/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/worker/node/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dest/worker/node/node_data_store.d.ts

@@ -1,13 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { type DataStore } from '../data_store.js';
-/**
- * Cache for data used by wasm module.
- */
-export declare class NodeDataStore implements DataStore {
-    private db;
-    constructor(path?: string);
-    get(key: string): Promise<Buffer | undefined>;
-    set(key: string, value: Buffer): Promise<void>;
-}
-//# sourceMappingURL=node_data_store.d.ts.map

package/dest/worker/node/node_data_store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node_data_store.d.ts","sourceRoot":"","sources":["../../../src/worker/node/node_data_store.ts"],"names":[],"mappings":";;AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,EAAE,CAAU;gBAGR,IAAI,CAAC,EAAE,MAAM;IAMnB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrD"}

package/dest/worker/node/node_worker.d.ts

@@ -1,6 +0,0 @@
-import { type WasmWorker } from '../wasm_worker.js';
-/**
- * Creates a node worker.
- */
-export declare function createNodeWorker(filepath: string, initialMem?: number, maxMem?: number): Promise<WasmWorker>;
-//# sourceMappingURL=node_worker.d.ts.map

package/dest/worker/node/node_worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node_worker.d.ts","sourceRoot":"","sources":["../../../src/worker/node/node_worker.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAalH"}

package/dest/worker/node/start_node_module.d.ts

@@ -1,7 +0,0 @@
-import { type WasmModule } from '../../wasm/wasm_module.js';
-/**
- * Start the transport server corresponding to this module.
- * @param module - The WasmModule to host.
- */
-export declare function startNodeModule(module: WasmModule): void;
-//# sourceMappingURL=start_node_module.d.ts.map

package/dest/worker/node/start_node_module.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"start_node_module.d.ts","sourceRoot":"","sources":["../../../src/worker/node/start_node_module.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAM5D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,QAgBjD"}

package/dest/worker/wasm_worker.d.ts

@@ -1,9 +0,0 @@
-import { type Proxify } from '../transport/index.js';
-import { type WasmModule } from '../wasm/wasm_module.js';
-/**
- * Represents either a WASM web worker, or node.js worker.
- */
-export type WasmWorker = Proxify<WasmModule> & {
-    destroyWorker(): void;
-};
-//# sourceMappingURL=wasm_worker.d.ts.map

package/dest/worker/wasm_worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wasm_worker.d.ts","sourceRoot":"","sources":["../../src/worker/wasm_worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG;IAAE,aAAa,IAAI,IAAI,CAAA;CAAE,CAAC"}

package/dest/worker/worker_pool.d.ts

@@ -1,40 +0,0 @@
-import { type WasmWorker } from './wasm_worker.js';
-/**
- * Type of a worker factory.
- * Used to customize WorkerPool worker construction.
- */
-export type CreateWorker = (name: string, minMem: number, maxMem: number) => WasmWorker;
-/**
- * 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 declare class WorkerPool {
-    /**
-     * The maximum number of memory pages to be used by the webassembly.
-     */
-    static MAX_PAGES: number;
-    /**
-     * The workers in the pool.
-     */
-    private workers;
-    /**
-     * Create an instance and initialize the workers.
-     * @param createWorker - Worker factory.
-     * @param poolSize - Pool size.
-     * @returns An initialized WorkerPool.
-     */
-    static new(createWorker: CreateWorker, poolSize: number): Promise<WorkerPool>;
-    /**
-     * Initialize the workers.
-     * @param createWorker - Worker factory().
-     * @param poolSize - Pool size.
-     * @param maxMem - Max memory pages.
-     */
-    init(createWorker: CreateWorker, poolSize: number, maxMem?: number): Promise<void>;
-    /**
-     * Tell all workers in the pool to stop processing.
-     */
-    destroy(): Promise<void>;
-}
-//# sourceMappingURL=worker_pool.d.ts.map

package/dest/worker/worker_pool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker_pool.d.ts","sourceRoot":"","sources":["../../src/worker/worker_pool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,UAAU,CAAC;AACxF;;;;GAIG;AACH,qBAAa,UAAU;IAYrB;;OAEG;IACH,OAAc,SAAS,SAAQ;IAC/B;;OAEG;IACH,OAAO,CAAC,OAAO,CAAoB;IAEnC;;;;;OAKG;WACU,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM;IAM7D;;;;;OAKG;IACU,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAuB;IAY7F;;OAEG;IACU,OAAO;CAGrB"}

package/src/blob/blob.ts

@@ -1,311 +0,0 @@
-// Importing directly from 'c-kzg' does not work, ignoring import/no-named-as-default-member err:
-import cKzg from 'c-kzg';
-import type { Blob as BlobBuffer } from 'c-kzg';
-
-import { poseidon2Hash, sha256 } from '../crypto/index.js';
-import { Fr } from '../fields/index.js';
-import { BufferReader, serializeToBuffer } from '../serialize/index.js';
-import { deserializeEncodedBlobToFields, extractBlobFieldsFromBuffer } from './encoding.js';
-import { BlobDeserializationError } from './errors.js';
-import { type BlobJson } from './interface.js';
-
-/* eslint-disable import/no-named-as-default-member */
-const { BYTES_PER_BLOB, FIELD_ELEMENTS_PER_BLOB, blobToKzgCommitment, computeKzgProof, verifyKzgProof } = cKzg;
-
-// The prefix to the EVM blobHash, defined here: https://eips.ethereum.org/EIPS/eip-4844#specification
-export const VERSIONED_HASH_VERSION_KZG = 0x01;
-
-/**
- * A class to create, manage, and prove EVM blobs.
- */
-export class Blob {
-  constructor(
-    /** The blob to be broadcast on L1 in bytes form. */
-    public readonly data: BlobBuffer,
-    /** The hash of all tx effects inside the blob. Used in generating the challenge z and proving that we have included all required effects. */
-    public readonly fieldsHash: Fr,
-    /** Challenge point z (= H(H(tx_effects), kzgCommmitment). Used such that p(z) = y. */
-    public readonly challengeZ: Fr,
-    /** Evaluation y = p(z), where p() is the blob polynomial. BLS12 field element, rep. as BigNum in nr, bigint in ts. */
-    public readonly evaluationY: Buffer,
-    /** Commitment to the blob C. Used in compressed BLS12 point format (48 bytes). */
-    public readonly commitment: Buffer,
-    /** KZG opening proof for y = p(z). The commitment to quotient polynomial Q, used in compressed BLS12 point format (48 bytes). */
-    public readonly proof: Buffer,
-  ) {}
-
-  /**
-   * The encoded version of the blob will determine the end of the blob based on the transaction encoding.
-   * This is required when the fieldsHash of a blob will contain trailing zeros.
-   *
-   * See `./encoding.ts` for more details.
-   *
-   * This method is used to create a Blob from a buffer.
-   * @param blob - The buffer to create the Blob from.
-   * @param multiBlobFieldsHash - The fields hash to use for the Blob.
-   * @returns A Blob created from the buffer.
-   *
-   * @throws If unable to deserialize the blob.
-   */
-  static fromEncodedBlobBuffer(blob: BlobBuffer, multiBlobFieldsHash?: Fr): Promise<Blob> {
-    try {
-      const fields: Fr[] = deserializeEncodedBlobToFields(blob);
-      return Blob.fromFields(fields, multiBlobFieldsHash);
-    } catch (err) {
-      throw new BlobDeserializationError(
-        `Failed to create Blob from encoded blob buffer, this blob was likely not created by us`,
-      );
-    }
-  }
-
-  /**
-   * Create a Blob from an array of fields.
-   *
-   * @param fields - The array of fields to create the Blob from.
-   * @param multiBlobFieldsHash - The fields hash to use for the Blob.
-   * @returns A Blob created from the array of fields.
-   */
-  static async fromFields(fields: Fr[], multiBlobFieldsHash?: Fr): Promise<Blob> {
-    if (fields.length > FIELD_ELEMENTS_PER_BLOB) {
-      throw new Error(
-        `Attempted to overfill blob with ${fields.length} elements. The maximum is ${FIELD_ELEMENTS_PER_BLOB}`,
-      );
-    }
-
-    const data = Buffer.concat([serializeToBuffer(fields)], BYTES_PER_BLOB);
-
-    // This matches the output of SpongeBlob.squeeze() in the blob circuit
-    const fieldsHash = multiBlobFieldsHash ? multiBlobFieldsHash : await poseidon2Hash(fields);
-    const commitment = Buffer.from(blobToKzgCommitment(data));
-    const challengeZ = await poseidon2Hash([fieldsHash, ...commitmentToFields(commitment)]);
-    const res = computeKzgProof(data, challengeZ.toBuffer());
-    if (!verifyKzgProof(commitment, challengeZ.toBuffer(), res[1], res[0])) {
-      throw new Error(`KZG proof did not verify.`);
-    }
-    const proof = Buffer.from(res[0]);
-    const evaluationY = Buffer.from(res[1]);
-
-    return new Blob(data, fieldsHash, challengeZ, evaluationY, commitment, proof);
-  }
-
-  /**
-   * Create a Blob from a JSON object.
-   *
-   * Blobs will be in this form when requested from the blob sink, or from
-   * the beacon chain via `getBlobSidecars`
-   * https://ethereum.github.io/beacon-APIs/?urls.primaryName=dev#/Beacon/getBlobSidecars
-   *
-   * @dev WARNING: by default json deals with encoded buffers
-   *
-   * @param json - The JSON object to create the Blob from.
-   * @returns A Blob created from the JSON object.
-   */
-  static async fromJson(json: BlobJson): Promise<Blob> {
-    const blobBuffer = Buffer.from(json.blob.slice(2), 'hex');
-
-    const blob = await Blob.fromEncodedBlobBuffer(blobBuffer);
-
-    if (blob.commitment.toString('hex') !== json.kzg_commitment.slice(2)) {
-      throw new Error('KZG commitment does not match');
-    }
-
-    // We do not check the proof, as it will be different if the challenge is shared
-    // across multiple blobs
-
-    return blob;
-  }
-
-  /**
-   * Get the JSON representation of the blob.
-   *
-   * @dev WARNING: by default json deals with encoded buffers
-   * @param index - optional - The index of the blob in the block.
-   * @returns The JSON representation of the blob.
-   */
-  toJson(index?: number): BlobJson {
-    return {
-      blob: `0x${Buffer.from(this.data).toString('hex')}`,
-      index,
-      // eslint-disable-next-line camelcase
-      kzg_commitment: `0x${this.commitment.toString('hex')}`,
-      // eslint-disable-next-line camelcase
-      kzg_proof: `0x${this.proof.toString('hex')}`,
-    };
-  }
-
-  /**
-   * Get the fields from the blob.
-   *
-   * @dev WARNING: this method does not take into account trailing zeros
-   *
-   * @returns The fields from the blob.
-   */
-  toFields(): Fr[] {
-    return extractBlobFieldsFromBuffer(this.data);
-  }
-
-  /**
-   * Get the encoded fields from the blob.
-   *
-   * @dev This method takes into account trailing zeros
-   *
-   * @returns The encoded fields from the blob.
-   *
-   * @throws If unable to deserialize the blob.
-   */
-  toEncodedFields(): Fr[] {
-    try {
-      return deserializeEncodedBlobToFields(this.data);
-    } catch (err) {
-      throw new BlobDeserializationError(
-        `Failed to deserialize encoded blob fields, this blob was likely not created by us`,
-      );
-    }
-  }
-
-  /**
-   * Get the commitment fields from the blob.
-   *
-   * The 48-byte commitment is encoded into two field elements:
-   * +------------------+------------------+
-   * | Field Element 1  | Field Element 2  |
-   * | [bytes 0-31]     | [bytes 32-47]   |
-   * +------------------+------------------+
-   * |     32 bytes     |     16 bytes    |
-   * +------------------+------------------+
-   * @returns The commitment fields from the blob.
-   */
-  commitmentToFields(): [Fr, Fr] {
-    return commitmentToFields(this.commitment);
-  }
-
-  // Returns ethereum's versioned blob hash, following kzg_to_versioned_hash: https://eips.ethereum.org/EIPS/eip-4844#helpers
-  getEthVersionedBlobHash(): Buffer {
-    const hash = sha256(this.commitment);
-    hash[0] = VERSIONED_HASH_VERSION_KZG;
-    return hash;
-  }
-
-  static getEthVersionedBlobHash(commitment: Buffer): Buffer {
-    const hash = sha256(commitment);
-    hash[0] = VERSIONED_HASH_VERSION_KZG;
-    return hash;
-  }
-
-  /**
-   * Get the buffer representation of the ENTIRE blob.
-   *
-   * @dev WARNING: this buffer contains all metadata aswell as the data itself
-   *
-   * @returns The buffer representation of the blob.
-   */
-  toBuffer(): Buffer {
-    return Buffer.from(
-      serializeToBuffer(
-        this.data.length,
-        this.data,
-        this.fieldsHash,
-        this.challengeZ,
-        this.evaluationY.length,
-        this.evaluationY,
-        this.commitment.length,
-        this.commitment,
-        this.proof.length,
-        this.proof,
-      ),
-    );
-  }
-
-  /**
-   * Create a Blob from a buffer.
-   *
-   * @dev WARNING: this method contains all metadata aswell as the data itself
-   *
-   * @param buf - The buffer to create the Blob from.
-   * @returns A Blob created from the buffer.
-   */
-  static fromBuffer(buf: Buffer | BufferReader): Blob {
-    const reader = BufferReader.asReader(buf);
-    return new Blob(
-      reader.readUint8Array(),
-      reader.readObject(Fr),
-      reader.readObject(Fr),
-      reader.readBuffer(),
-      reader.readBuffer(),
-      reader.readBuffer(),
-    );
-  }
-
-  /**
-   * Get the size of the blob in bytes
-   */
-  getSize() {
-    return this.data.length;
-  }
-
-  /**
-   * Returns a proof of opening of the blob to verify on L1 using the point evaluation precompile:
-   *
-   * input[:32]     - versioned_hash
-   * input[32:64]   - z
-   * input[64:96]   - y
-   * input[96:144]  - commitment C
-   * input[144:192] - proof (a commitment to the quotient polynomial q(X))
-   *
-   * See https://eips.ethereum.org/EIPS/eip-4844#point-evaluation-precompile
-   */
-  getEthBlobEvaluationInputs(): `0x${string}` {
-    const buf = Buffer.concat([
-      this.getEthVersionedBlobHash(),
-      this.challengeZ.toBuffer(),
-      this.evaluationY,
-      this.commitment,
-      this.proof,
-    ]);
-    return `0x${buf.toString('hex')}`;
-  }
-
-  static getEthBlobEvaluationInputs(blobs: Blob[]): `0x${string}` {
-    let buf = Buffer.alloc(0);
-    blobs.forEach(blob => {
-      buf = Buffer.concat([
-        buf,
-        blob.getEthVersionedBlobHash(),
-        blob.challengeZ.toBuffer(),
-        blob.evaluationY,
-        blob.commitment,
-        blob.proof,
-      ]);
-    });
-    // For multiple blobs, we prefix the number of blobs:
-    const lenBuf = Buffer.alloc(1);
-    lenBuf.writeUint8(blobs.length);
-    buf = Buffer.concat([lenBuf, buf]);
-    return `0x${buf.toString('hex')}`;
-  }
-
-  static getViemKzgInstance() {
-    return {
-      blobToKzgCommitment: cKzg.blobToKzgCommitment,
-      computeBlobKzgProof: cKzg.computeBlobKzgProof,
-    };
-  }
-
-  // Returns as many blobs as we require to broadcast the given fields
-  // Assumes we share the fields hash between all blobs
-  static async getBlobs(fields: Fr[]): Promise<Blob[]> {
-    const numBlobs = Math.max(Math.ceil(fields.length / FIELD_ELEMENTS_PER_BLOB), 1);
-    const multiBlobFieldsHash = await poseidon2Hash(fields);
-    const res = [];
-    for (let i = 0; i < numBlobs; i++) {
-      const end = fields.length < (i + 1) * FIELD_ELEMENTS_PER_BLOB ? fields.length : (i + 1) * FIELD_ELEMENTS_PER_BLOB;
-      res.push(await Blob.fromFields(fields.slice(i * FIELD_ELEMENTS_PER_BLOB, end), multiBlobFieldsHash));
-    }
-    return res;
-  }
-}
-
-// 48 bytes encoded in fields as [Fr, Fr] = [0->31, 31->48]
-function commitmentToFields(commitment: Buffer): [Fr, Fr] {
-  return [new Fr(commitment.subarray(0, 31)), new Fr(commitment.subarray(31, 48))];
-}