@aztec/blob-lib 3.0.0-nightly.20251025 → 3.0.0-nightly.20251030-2

package/dest/blob.d.ts

@@ -1,50 +1,58 @@
-import { Fr } from '@aztec/foundation/fields';
+import { FIELDS_PER_BLOB } from '@aztec/constants';
+import { BLS12Fr, Fr } from '@aztec/foundation/fields';
 import { BufferReader } from '@aztec/foundation/serialize';
 import type { BlobJson } from './interface.js';
-export declare const VERSIONED_HASH_VERSION_KZG = 1;
+export { FIELDS_PER_BLOB };
 /**
  * A class to create, manage, and prove EVM blobs.
+ *
+ * @dev Note: All methods in this class do not check the encoding of the given data. It's the responsibility of other
+ * components to ensure that the blob data (which might spread across multiple blobs) was created following the protocol
+ * and is correctly encoded.
  */
 export declare class Blob {
-    /** The blob to be broadcast on L1 in bytes form. */
+    /**
+     * The data to be broadcast on L1 in bytes form.
+     */
     readonly data: Uint8Array;
-    /** The hash of all tx effects inside the blob. Used in generating the challenge z and proving that we have included all required effects. */
-    readonly fieldsHash: Fr;
-    /** Challenge point z (= H(H(tx_effects), kzgCommmitment). Used such that p(z) = y for a single blob, used as z_i in batching (see ./blob_batching.ts). */
-    readonly challengeZ: Fr;
-    /** Commitment to the blob C. Used in compressed BLS12 point format (48 bytes). */
+    /**
+     * Commitment to the blob data. Used in compressed BLS12 point format (48 bytes).
+     */
     readonly commitment: Buffer;
     constructor(
-    /** The blob to be broadcast on L1 in bytes form. */
+    /**
+     * The data to be broadcast on L1 in bytes form.
+     */
     data: Uint8Array, 
-    /** The hash of all tx effects inside the blob. Used in generating the challenge z and proving that we have included all required effects. */
-    fieldsHash: Fr, 
-    /** Challenge point z (= H(H(tx_effects), kzgCommmitment). Used such that p(z) = y for a single blob, used as z_i in batching (see ./blob_batching.ts). */
-    challengeZ: Fr, 
-    /** Commitment to the blob C. Used in compressed BLS12 point format (48 bytes). */
+    /**
+     * Commitment to the blob data. Used in compressed BLS12 point format (48 bytes).
+     */
     commitment: 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.
+     * Create a Blob from a buffer.
+     * @param data - The buffer of the Blob.
      * @returns A Blob created from the buffer.
      *
-     * @throws If unable to deserialize the blob.
+     * @throws If data does not match the expected length (BYTES_PER_BLOB).
      */
-    static fromEncodedBlobBuffer(blob: Uint8Array, multiBlobFieldsHash?: Fr): Promise<Blob>;
+    static fromBlobBuffer(data: Uint8Array): Blob;
     /**
      * Create a Blob from an array of fields.
      *
+     * @dev This method pads 0s to the data, extending it to the size of a full blob.
+     *
      * @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 fromFields(fields: Fr[], multiBlobFieldsHash?: Fr): Promise<Blob>;
+    static fromFields(fields: Fr[]): Blob;
+    /**
+     * Get the fields from the blob data.
+     *
+     * @dev WARNING: this method returns all fields
+     *
+     * @returns The fields from the blob.
+     */
+    toFields(): Fr[];
     /**
      * Create a Blob from a JSON object.
      *
@@ -52,78 +60,41 @@ export declare class Blob {
      * 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 fromJson(json: BlobJson): Promise<Blob>;
+    static fromJson(json: BlobJson): 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;
+    getEthVersionedBlobHash(): Buffer;
     /**
-     * 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[];
-    /**
-     * 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[];
-    /**
-     * Get the encoded fields from multiple blobs.
-     *
-     * @dev This method takes into account trailing zeros
-     *
-     * @returns The encoded fields from the blobs.
-     */
-    static toEncodedFields(blobs: Blob[]): Fr[];
-    /**
-     * 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.
+     * Challenge point z (= H(H(tx_effects), kzgCommitment)).
+     * Used such that p(z) = y for a single blob, used as z_i in batching (see ./blob_batching.ts).
      */
-    commitmentToFields(): [Fr, Fr];
-    getEthVersionedBlobHash(): Buffer;
-    static getEthVersionedBlobHash(commitment: Buffer): Buffer;
+    computeChallengeZ(blobFieldsHash: Fr): Promise<Fr>;
     /**
      * Evaluate the blob at a given challenge and return the evaluation and KZG proof.
      *
-     * @param challengeZ - The challenge z at which to evaluate the blob. If not given, assume we want to evaluate at the individual blob's z.
+     * @param challengeZ - The challenge z at which to evaluate the blob.
+     * @param verifyProof - Whether to verify the KZG proof.
      *
-     * @returns -
-     *  y: Buffer -  Evaluation y = p(z), where p() is the blob polynomial. BLS12 field element, rep. as BigNum in nr, bigint in ts
+     * @returns
+     *  y: BLS12Fr -  Evaluation y = p(z), where p() is the blob polynomial. BLS12 field element, rep. as BigNum in nr, bigint in ts.
      *  proof: Buffer - KZG opening proof for y = p(z). The commitment to quotient polynomial Q, used in compressed BLS12 point format (48 bytes).
      */
-    evaluate(challengeZ?: Fr): {
-        y: Buffer<ArrayBuffer>;
+    evaluate(challengeZ: Fr, verifyProof?: boolean): {
+        y: BLS12Fr;
         proof: Buffer<ArrayBuffer>;
     };
     /**
      * Get the buffer representation of the ENTIRE blob.
      *
-     * @dev WARNING: this buffer contains all metadata aswell as the data itself
+     * @dev WARNING: this buffer contains all metadata as well as the data itself.
      *
      * @returns The buffer representation of the blob.
      */
@@ -131,7 +102,7 @@ export declare class Blob {
     /**
      * Create a Blob from a buffer.
      *
-     * @dev WARNING: this method contains all metadata aswell as the data itself
+     * @dev WARNING: this method contains all metadata as well as the data itself.
      *
      * @param buf - The buffer to create the Blob from.
      * @returns A Blob created from the buffer.
@@ -141,23 +112,10 @@ export declare class Blob {
      * Get the size of the blob in bytes
      */
     getSize(): number;
-    /**
-     * @param blobs - The blobs to emit
-     * @returns The blobs' compressed commitments in hex prefixed by the number of blobs
-     * @dev Used for proposing blocks to validate injected blob commitments match real broadcast blobs:
-     * One byte for the number blobs + 48 bytes per blob commitment
-     */
-    static getPrefixedEthBlobCommitments(blobs: Blob[]): `0x${string}`;
     static getViemKzgInstance(): {
         blobToKzgCommitment: (blob: Uint8Array) => Uint8Array;
         computeBlobKzgProof: (blob: Uint8Array, commitment: Uint8Array) => Uint8Array;
         computeCellsAndKzgProofs: (b: Uint8Array) => [Uint8Array[], Uint8Array[]];
     };
-    /**
-     * @param fields - Fields to broadcast in the blob(s)
-     * @returns As many blobs as we require to broadcast the given fields for a block
-     * @dev Assumes we share the fields hash between all blobs which can only be done for ONE BLOCK because the hash is calculated in block root.
-     */
-    static getBlobsPerBlock(fields: Fr[]): Promise<Blob[]>;
 }
 //# sourceMappingURL=blob.d.ts.map

package/dest/blob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAI9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,eAAO,MAAM,0BAA0B,IAAO,CAAC;AAE/C;;GAEG;AACH,qBAAa,IAAI;IAEb,oDAAoD;aACpC,IAAI,EAAE,UAAU;IAChC,6IAA6I;aAC7H,UAAU,EAAE,EAAE;IAC9B,0JAA0J;aAC1I,UAAU,EAAE,EAAE;IAC9B,kFAAkF;aAClE,UAAU,EAAE,MAAM;;IAPlC,oDAAoD;IACpC,IAAI,EAAE,UAAU;IAChC,6IAA6I;IAC7H,UAAU,EAAE,EAAE;IAC9B,0JAA0J;IAC1I,UAAU,EAAE,EAAE;IAC9B,kFAAkF;IAClE,UAAU,EAAE,MAAM;IAGpC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,UAAU,EAAE,mBAAmB,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvF;;;;;;OAMG;WACU,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,mBAAmB,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe9E;;;;;;;;;;;OAWG;WACU,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAepD;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAS/B;;;;;;OAMG;IACH,QAAQ,IAAI,EAAE,EAAE;IAIhB;;;;;;;;OAQG;IACH,eAAe,IAAI,EAAE,EAAE;IAUvB;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAU3C;;;;;;;;;;;OAWG;IACH,kBAAkB,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC;IAK9B,uBAAuB,IAAI,MAAM;IAMjC,MAAM,CAAC,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAM1D;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE;;;;IAWxB;;;;;;OAMG;IACH,QAAQ,IAAI,MAAM;IAalB;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKnD;;OAEG;IACH,OAAO;IAIP;;;;;OAKG;IACH,MAAM,CAAC,6BAA6B,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,MAAM,EAAE;IAYlE,MAAM,CAAC,kBAAkB;;;sCAIS,UAAU,KAAG,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC;;IAO3E;;;;OAIG;WACU,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;CAU7D"}
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAG9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B;;;;;;GAMG;AACH,qBAAa,IAAI;IAEb;;OAEG;aACa,IAAI,EAAE,UAAU;IAChC;;OAEG;aACa,UAAU,EAAE,MAAM;;IAPlC;;OAEG;IACa,IAAI,EAAE,UAAU;IAChC;;OAEG;IACa,UAAU,EAAE,MAAM;IAUpC;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAK7C;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI;IAUrC;;;;;;OAMG;IACH,QAAQ,IAAI,EAAE,EAAE;IAMhB;;;;;;;;;OASG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAWrC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAS/B,uBAAuB,IAAI,MAAM;IAIjC;;;OAGG;IACG,iBAAiB,CAAC,cAAc,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;IAIxD;;;;;;;;;OASG;IACH,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE,WAAW,UAAQ;;;;IAW5C;;;;;;OAMG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKnD;;OAEG;IACH,OAAO;IAIP,MAAM,CAAC,kBAAkB;;;sCAIS,UAAU,KAAG,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC;;CAM5E"}

package/dest/blob.js

@@ -1,66 +1,69 @@
 import { FIELDS_PER_BLOB } from '@aztec/constants';
-import { poseidon2Hash, sha256 } from '@aztec/foundation/crypto';
-import { Fr } from '@aztec/foundation/fields';
+import { BLS12Fr, Fr } from '@aztec/foundation/fields';
 import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
-import { deserializeEncodedBlobToFields, extractBlobFieldsFromBuffer } from './deserialize.js';
-import { BlobDeserializationError } from './errors.js';
-import { BYTES_PER_BLOB, kzg } from './kzg_context.js';
-// The prefix to the EVM blobHash, defined here: https://eips.ethereum.org/EIPS/eip-4844#specification
-export const VERSIONED_HASH_VERSION_KZG = 0x01;
+import { computeBlobCommitment, computeChallengeZ, computeEthVersionedBlobHash } from './hash.js';
+import { BYTES_PER_BLOB, BYTES_PER_COMMITMENT, kzg } from './kzg_context.js';
+export { FIELDS_PER_BLOB };
 /**
  * A class to create, manage, and prove EVM blobs.
+ *
+ * @dev Note: All methods in this class do not check the encoding of the given data. It's the responsibility of other
+ * components to ensure that the blob data (which might spread across multiple blobs) was created following the protocol
+ * and is correctly encoded.
  */ export class Blob {
     data;
-    fieldsHash;
-    challengeZ;
     commitment;
-    constructor(/** The blob to be broadcast on L1 in bytes form. */ data, /** The hash of all tx effects inside the blob. Used in generating the challenge z and proving that we have included all required effects. */ fieldsHash, /** Challenge point z (= H(H(tx_effects), kzgCommmitment). Used such that p(z) = y for a single blob, used as z_i in batching (see ./blob_batching.ts). */ challengeZ, /** Commitment to the blob C. Used in compressed BLS12 point format (48 bytes). */ commitment){
+    constructor(/**
+     * The data to be broadcast on L1 in bytes form.
+     */ data, /**
+     * Commitment to the blob data. Used in compressed BLS12 point format (48 bytes).
+     */ commitment){
         this.data = data;
-        this.fieldsHash = fieldsHash;
-        this.challengeZ = challengeZ;
         this.commitment = commitment;
+        if (data.length !== BYTES_PER_BLOB) {
+            throw new Error(`Blob data must be ${BYTES_PER_BLOB} bytes. Got ${data.length}.`);
+        }
+        if (commitment.length !== BYTES_PER_COMMITMENT) {
+            throw new Error(`Blob commitment must be ${BYTES_PER_COMMITMENT} bytes. Got ${commitment.length}.`);
+        }
     }
     /**
-   * 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.
+   * Create a Blob from a buffer.
+   * @param data - The buffer of the Blob.
    * @returns A Blob created from the buffer.
    *
-   * @throws If unable to deserialize the blob.
-   */ static fromEncodedBlobBuffer(blob, multiBlobFieldsHash) {
-        try {
-            const fields = deserializeEncodedBlobToFields(blob);
-            return Blob.fromFields(fields, multiBlobFieldsHash);
-        } catch  {
-            throw new BlobDeserializationError(`Failed to create Blob from encoded blob buffer, this blob was likely not created by us`);
-        }
+   * @throws If data does not match the expected length (BYTES_PER_BLOB).
+   */ static fromBlobBuffer(data) {
+        const commitment = computeBlobCommitment(data);
+        return new Blob(data, commitment);
     }
     /**
    * Create a Blob from an array of fields.
    *
+   * @dev This method pads 0s to the data, extending it to the size of a full blob.
+   *
    * @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, multiBlobFieldsHash) {
+   */ static fromFields(fields) {
         if (fields.length > FIELDS_PER_BLOB) {
-            throw new Error(`Attempted to overfill blob with ${fields.length} elements. The maximum is ${FIELDS_PER_BLOB}`);
+            throw new Error(`Attempted to overfill blob with ${fields.length} fields. The maximum is ${FIELDS_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(kzg.blobToKzgCommitment(data));
-        const challengeZ = await poseidon2Hash([
-            fieldsHash,
-            ...commitmentToFields(commitment)
-        ]);
-        return new Blob(data, fieldsHash, challengeZ, commitment);
+        const commitment = computeBlobCommitment(data);
+        return new Blob(data, commitment);
+    }
+    /**
+   * Get the fields from the blob data.
+   *
+   * @dev WARNING: this method returns all fields
+   *
+   * @returns The fields from the blob.
+   */ toFields() {
+        const reader = BufferReader.asReader(this.data);
+        const numTotalFields = this.data.length / Fr.SIZE_IN_BYTES;
+        return reader.readArray(numTotalFields, Fr);
     }
     /**
    * Create a Blob from a JSON object.
@@ -69,24 +72,19 @@ export const VERSIONED_HASH_VERSION_KZG = 0x01;
    * 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) {
+   */ static fromJson(json) {
         const blobBuffer = Buffer.from(json.blob.slice(2), 'hex');
-        const blob = await Blob.fromEncodedBlobBuffer(blobBuffer);
+        const blob = Blob.fromBlobBuffer(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) {
@@ -97,84 +95,31 @@ export const VERSIONED_HASH_VERSION_KZG = 0x01;
             kzg_commitment: `0x${this.commitment.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() {
-        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() {
-        try {
-            return deserializeEncodedBlobToFields(this.data);
-        } catch  {
-            throw new BlobDeserializationError(`Failed to deserialize encoded blob fields, this blob was likely not created by us`);
-        }
-    }
-    /**
-   * Get the encoded fields from multiple blobs.
-   *
-   * @dev This method takes into account trailing zeros
-   *
-   * @returns The encoded fields from the blobs.
-   */ static toEncodedFields(blobs) {
-        try {
-            return deserializeEncodedBlobToFields(Buffer.concat(blobs.map((b)=>b.data)));
-        } catch  {
-            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() {
-        return commitmentToFields(this.commitment);
-    }
-    // Returns ethereum's versioned blob hash, following kzg_to_versioned_hash: https://eips.ethereum.org/EIPS/eip-4844#helpers
     getEthVersionedBlobHash() {
-        const hash = sha256(this.commitment);
-        hash[0] = VERSIONED_HASH_VERSION_KZG;
-        return hash;
+        return computeEthVersionedBlobHash(this.commitment);
     }
-    static getEthVersionedBlobHash(commitment) {
-        const hash = sha256(commitment);
-        hash[0] = VERSIONED_HASH_VERSION_KZG;
-        return hash;
+    /**
+   * Challenge point z (= H(H(tx_effects), kzgCommitment)).
+   * Used such that p(z) = y for a single blob, used as z_i in batching (see ./blob_batching.ts).
+   */ async computeChallengeZ(blobFieldsHash) {
+        return await computeChallengeZ(blobFieldsHash, this.commitment);
     }
     /**
    * Evaluate the blob at a given challenge and return the evaluation and KZG proof.
    *
-   * @param challengeZ - The challenge z at which to evaluate the blob. If not given, assume we want to evaluate at the individual blob's z.
+   * @param challengeZ - The challenge z at which to evaluate the blob.
+   * @param verifyProof - Whether to verify the KZG proof.
    *
-   * @returns -
-   *  y: Buffer -  Evaluation y = p(z), where p() is the blob polynomial. BLS12 field element, rep. as BigNum in nr, bigint in ts
+   * @returns
+   *  y: BLS12Fr -  Evaluation y = p(z), where p() is the blob polynomial. BLS12 field element, rep. as BigNum in nr, bigint in ts.
    *  proof: Buffer - KZG opening proof for y = p(z). The commitment to quotient polynomial Q, used in compressed BLS12 point format (48 bytes).
-   */ evaluate(challengeZ) {
-        const z = challengeZ || this.challengeZ;
-        const res = kzg.computeKzgProof(this.data, z.toBuffer());
-        if (!kzg.verifyKzgProof(this.commitment, z.toBuffer(), res[1], res[0])) {
+   */ evaluate(challengeZ, verifyProof = false) {
+        const res = kzg.computeKzgProof(this.data, challengeZ.toBuffer());
+        if (verifyProof && !kzg.verifyKzgProof(this.commitment, challengeZ.toBuffer(), res[1], res[0])) {
             throw new Error(`KZG proof did not verify.`);
         }
         const proof = Buffer.from(res[0]);
-        const y = Buffer.from(res[1]);
+        const y = BLS12Fr.fromBuffer(Buffer.from(res[1]));
         return {
             y,
             proof
@@ -183,50 +128,28 @@ export const VERSIONED_HASH_VERSION_KZG = 0x01;
     /**
    * Get the buffer representation of the ENTIRE blob.
    *
-   * @dev WARNING: this buffer contains all metadata aswell as the data itself
+   * @dev WARNING: this buffer contains all metadata as well as the data itself.
    *
    * @returns The buffer representation of the blob.
    */ toBuffer() {
-        return Buffer.from(serializeToBuffer(this.data.length, this.data, this.fieldsHash, this.challengeZ, this.commitment.length, this.commitment));
+        return Buffer.from(serializeToBuffer(this.data.length, this.data, this.commitment.length, this.commitment));
     }
     /**
    * Create a Blob from a buffer.
    *
-   * @dev WARNING: this method contains all metadata aswell as the data itself
+   * @dev WARNING: this method contains all metadata as well as the data itself.
    *
    * @param buf - The buffer to create the Blob from.
    * @returns A Blob created from the buffer.
    */ static fromBuffer(buf) {
         const reader = BufferReader.asReader(buf);
-        return new Blob(reader.readUint8Array(), reader.readObject(Fr), reader.readObject(Fr), reader.readBuffer());
+        return new Blob(reader.readUint8Array(), reader.readBuffer());
     }
     /**
    * Get the size of the blob in bytes
    */ getSize() {
         return this.data.length;
     }
-    /**
-   * @param blobs - The blobs to emit
-   * @returns The blobs' compressed commitments in hex prefixed by the number of blobs
-   * @dev Used for proposing blocks to validate injected blob commitments match real broadcast blobs:
-   * One byte for the number blobs + 48 bytes per blob commitment
-   */ static getPrefixedEthBlobCommitments(blobs) {
-        let buf = Buffer.alloc(0);
-        blobs.forEach((blob)=>{
-            buf = Buffer.concat([
-                buf,
-                blob.commitment
-            ]);
-        });
-        // 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: kzg.blobToKzgCommitment.bind(kzg),
@@ -240,25 +163,4 @@ export const VERSIONED_HASH_VERSION_KZG = 0x01;
             }
         };
     }
-    /**
-   * @param fields - Fields to broadcast in the blob(s)
-   * @returns As many blobs as we require to broadcast the given fields for a block
-   * @dev Assumes we share the fields hash between all blobs which can only be done for ONE BLOCK because the hash is calculated in block root.
-   */ static async getBlobsPerBlock(fields) {
-        const numBlobs = Math.max(Math.ceil(fields.length / FIELDS_PER_BLOB), 1);
-        const multiBlobFieldsHash = await poseidon2Hash(fields);
-        const res = [];
-        for(let i = 0; i < numBlobs; i++){
-            const end = fields.length < (i + 1) * FIELDS_PER_BLOB ? fields.length : (i + 1) * FIELDS_PER_BLOB;
-            res.push(await Blob.fromFields(fields.slice(i * FIELDS_PER_BLOB, end), multiBlobFieldsHash));
-        }
-        return res;
-    }
-}
-// 48 bytes encoded in fields as [Fr, Fr] = [0->31, 31->48]
-function commitmentToFields(commitment) {
-    return [
-        new Fr(commitment.subarray(0, 31)),
-        new Fr(commitment.subarray(31, 48))
-    ];
 }

package/dest/blob_batching.d.ts

@@ -1,6 +1,6 @@
 import { BLS12Fr, BLS12Point, Fr } from '@aztec/foundation/fields';
-import { BufferReader } from '@aztec/foundation/serialize';
 import { Blob } from './blob.js';
+import { BlobAccumulator, FinalBlobAccumulator, FinalBlobBatchingChallenges } from './circuit_types/index.js';
 /**
  * A class to create, manage, and prove batched EVM blobs.
  */
@@ -33,13 +33,13 @@ export declare class BatchedBlob {
      *
      * @returns A batched blob.
      */
-    static batch(blobs: Blob[]): Promise<BatchedBlob>;
+    static batch(blobs: Blob[][]): Promise<BatchedBlob>;
     /**
      * Returns an empty BatchedBlobAccumulator with precomputed challenges from all blobs in the epoch.
      * @dev MUST input all blobs to be broadcast. Does not work in multiple calls because z and gamma are calculated
      *      beforehand from ALL blobs.
      */
-    static newAccumulator(blobs: Blob[]): Promise<BatchedBlobAccumulator>;
+    static newAccumulator(blobs: Blob[][]): Promise<BatchedBlobAccumulator>;
     /**
      * Gets the final challenges based on all blobs and their elements to perform a multi opening proof.
      * Used in BatchedBlobAccumulator as 'finalZ' and finalGamma':
@@ -48,11 +48,13 @@ export declare class BatchedBlob {
      *    - used such that p_i(z) = y_i = Blob.evaluationY for all n blob polynomials p_i().
      *  - gamma = H(H(...H(H(y_0, y_1) y_2)..y_n), z)
      *    - used such that y = sum_i { gamma^i * y_i }, and C = sum_i { gamma^i * C_i }, for all blob evaluations y_i (see above) and commitments C_i.
+     *
+     * @param blobs - The blobs to precompute the challenges for. Each sub-array is the blobs for an L1 block.
      * @returns Challenges z and gamma.
      */
-    static precomputeBatchedBlobChallenges(blobs: Blob[]): Promise<FinalBlobBatchingChallenges>;
+    static precomputeBatchedBlobChallenges(blobs: Blob[][]): Promise<FinalBlobBatchingChallenges>;
+    verify(): boolean;
     getEthVersionedBlobHash(): Buffer;
-    static getEthVersionedBlobHash(commitment: Buffer): Buffer;
     /**
      * Returns a proof of opening of the blobs to verify on L1 using the point evaluation precompile:
      *
@@ -65,30 +67,7 @@ export declare class BatchedBlob {
      * See https://eips.ethereum.org/EIPS/eip-4844#point-evaluation-precompile
      */
     getEthBlobEvaluationInputs(): `0x${string}`;
-}
-/**
- * Final values z and gamma are injected into each block root circuit. We ensure they are correct by:
- * - Checking equality in each block merge circuit and propagating up
- * - Checking final z_acc == z in root circuit
- * - Checking final gamma_acc == gamma in root circuit
- *
- *  - z = H(...H(H(z_0, z_1) z_2)..z_n)
- *    - where z_i = H(H(fields of blob_i), C_i),
- *    - used such that p_i(z) = y_i = Blob.evaluationY for all n blob polynomials p_i().
- *  - gamma = H(H(...H(H(y_0, y_1) y_2)..y_n), z)
- *    - used such that y = sum_i { gamma^i * y_i }, and C = sum_i { gamma^i * C_i }
- *      for all blob evaluations y_i (see above) and commitments C_i.
- *
- * Iteratively calculated by BlobAccumulator.accumulate() in nr. See also precomputeBatchedBlobChallenges() above.
- */
-export declare class FinalBlobBatchingChallenges {
-    readonly z: Fr;
-    readonly gamma: BLS12Fr;
-    constructor(z: Fr, gamma: BLS12Fr);
-    equals(other: FinalBlobBatchingChallenges): boolean;
-    static empty(): FinalBlobBatchingChallenges;
-    static fromBuffer(buffer: Buffer | BufferReader): FinalBlobBatchingChallenges;
-    toBuffer(): Buffer<ArrayBufferLike>;
+    toFinalBlobAccumulator(): FinalBlobAccumulator;
 }
 /**
  * See noir-projects/noir-protocol-circuits/crates/blob/src/abis/blob_accumulator.nr
@@ -135,21 +114,6 @@ export declare class BatchedBlobAccumulator {
     gammaPow: BLS12Fr, 
     /** Final challenge values used in evaluation. Optimistically input and checked in the final acc. */
     finalBlobChallenges: FinalBlobBatchingChallenges);
-    /**
-     * Init the first accumulation state of the epoch.
-     * We assume the input blob has not been evaluated at z.
-     *
-     * First state of the accumulator:
-     * - v_acc := sha256(C_0)
-     * - z_acc := z_0
-     * - y_acc := gamma^0 * y_0 = y_0
-     * - c_acc := gamma^0 * c_0 = c_0
-     * - gamma_acc := poseidon2(y_0.limbs)
-     * - gamma^(i + 1) = gamma^1 = gamma // denoted gamma_pow_acc
-     *
-     * @returns An initial blob accumulator.
-     */
-    static initialize(blob: Blob, finalBlobChallenges: FinalBlobBatchingChallenges): Promise<BatchedBlobAccumulator>;
     /**
      * Create the empty accumulation state of the epoch.
      * @returns An empty blob accumulator with challenges.
@@ -160,10 +124,11 @@ export declare class BatchedBlobAccumulator {
      * We assume the input blob has not been evaluated at z.
      * @returns An updated blob accumulator.
      */
-    accumulate(blob: Blob): Promise<BatchedBlobAccumulator>;
+    private accumulate;
     /**
      * Given blobs, accumulate all state.
      * We assume the input blobs have not been evaluated at z.
+     * @param blobs - The blobs to accumulate. They should be in the same L1 block.
      * @returns An updated blob accumulator.
      */
     accumulateBlobs(blobs: Blob[]): Promise<BatchedBlobAccumulator>;
@@ -178,10 +143,13 @@ export declare class BatchedBlobAccumulator {
      * - c := c_acc (final commitment to be checked on L1)
      * - gamma := poseidon2(gamma_acc, z) (challenge for linear combination of y and C, above)
      *
+     * @param verifyProof - Whether to verify the KZG proof.
      * @returns A batched blob.
      */
-    finalize(): Promise<BatchedBlob>;
+    finalize(verifyProof?: boolean): Promise<BatchedBlob>;
     isEmptyState(): boolean;
     clone(): BatchedBlobAccumulator;
+    toBlobAccumulator(): BlobAccumulator;
+    toFinalBlobAccumulator(): FinalBlobAccumulator;
 }
 //# sourceMappingURL=blob_batching.d.ts.map