@aztec/blob-lib 0.0.1-fake-c83136db25 → 0.0.1-fake-ceab37513c

package/dest/blob.d.ts

@@ -1,58 +1,54 @@
-import { FIELDS_PER_BLOB } from '@aztec/constants';
-import { BLS12Fr, Fr } from '@aztec/foundation/fields';
+import { Fr } from '@aztec/foundation/fields';
 import { BufferReader } from '@aztec/foundation/serialize';
+import cKzg from 'c-kzg';
+import type { Blob as BlobBuffer } from 'c-kzg';
 import type { BlobJson } from './interface.js';
-export { FIELDS_PER_BLOB };
+export declare const VERSIONED_HASH_VERSION_KZG = 1;
+/** Versioned blob hash for an empty blob */
+export declare const EMPTY_BLOB_VERSIONED_HASH: Buffer<ArrayBuffer>;
 /**
  * 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 data to be broadcast on L1 in bytes form.
-     */
-    readonly data: Uint8Array;
-    /**
-     * Commitment to the blob data. Used in compressed BLS12 point format (48 bytes).
-     */
+    /** The blob to be broadcast on L1 in bytes form. */
+    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. */
+    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). */
     readonly commitment: Buffer;
     constructor(
-    /**
-     * The data to be broadcast on L1 in bytes form.
-     */
-    data: Uint8Array, 
-    /**
-     * Commitment to the blob data. Used in compressed BLS12 point format (48 bytes).
-     */
+    /** The blob to be broadcast on L1 in bytes form. */
+    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. */
+    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: Buffer);
     /**
-     * Create a Blob from a buffer.
-     * @param data - The buffer of the Blob.
+     * 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 data does not match the expected length (BYTES_PER_BLOB).
+     * @throws If unable to deserialize the blob.
      */
-    static fromBlobBuffer(data: Uint8Array): Blob;
+    static fromEncodedBlobBuffer(blob: BlobBuffer, multiBlobFieldsHash?: Fr): Promise<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[]): Blob;
-    /**
-     * Get the fields from the blob data.
-     *
-     * @dev WARNING: this method returns all fields
-     *
-     * @returns The fields from the blob.
-     */
-    toFields(): Fr[];
+    static fromFields(fields: Fr[], multiBlobFieldsHash?: Fr): Promise<Blob>;
     /**
      * Create a Blob from a JSON object.
      *
@@ -60,41 +56,78 @@ 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): Blob;
+    static fromJson(json: BlobJson): Promise<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;
     /**
-     * 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).
+     * 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.
      */
-    computeChallengeZ(blobFieldsHash: Fr): Promise<Fr>;
+    commitmentToFields(): [Fr, Fr];
+    getEthVersionedBlobHash(): Buffer;
+    static getEthVersionedBlobHash(commitment: Buffer): Buffer;
     /**
      * 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.
-     * @param verifyProof - Whether to verify the 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.
      *
-     * @returns
-     *  y: BLS12Fr -  Evaluation y = p(z), where p() is the blob polynomial. BLS12 field element, rep. as BigNum in nr, bigint in ts.
+     * @returns -
+     *  y: Buffer -  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, verifyProof?: boolean): {
-        y: BLS12Fr;
+    evaluate(challengeZ?: Fr): {
+        y: Buffer<ArrayBuffer>;
         proof: Buffer<ArrayBuffer>;
     };
     /**
      * Get the buffer representation of the ENTIRE blob.
      *
-     * @dev WARNING: this buffer contains all metadata as well as the data itself.
+     * @dev WARNING: this buffer contains all metadata aswell as the data itself
      *
      * @returns The buffer representation of the blob.
      */
@@ -102,7 +135,7 @@ export declare class Blob {
     /**
      * Create a Blob from a buffer.
      *
-     * @dev WARNING: this method contains all metadata as well as the data itself.
+     * @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.
@@ -112,10 +145,23 @@ 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[]];
+        blobToKzgCommitment: typeof cKzg.blobToKzgCommitment;
+        computeBlobKzgProof: typeof cKzg.computeBlobKzgProof;
+        computeCellsAndKzgProofs: typeof cKzg.computeCellsAndKzgProofs;
     };
+    /**
+     * @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":"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"}
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../src/blob.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAG9E,OAAO,IAAI,MAAM,OAAO,CAAC;AACzB,OAAO,KAAK,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,OAAO,CAAC;AAIhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C,eAAO,MAAM,0BAA0B,IAAO,CAAC;AAE/C,4CAA4C;AAC5C,eAAO,MAAM,yBAAyB,qBAGrC,CAAC;AAEF;;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;IAiB9E;;;;;;;;;;;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;;;;;IAQzB;;;;OAIG;WACU,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;CAU7D"}

package/dest/blob.js

@@ -1,69 +1,68 @@
-import { FIELDS_PER_BLOB } from '@aztec/constants';
-import { BLS12Fr, Fr } from '@aztec/foundation/fields';
+import { poseidon2Hash, sha256 } from '@aztec/foundation/crypto';
+import { Fr } from '@aztec/foundation/fields';
 import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
-import { computeBlobCommitment, computeChallengeZ, computeEthVersionedBlobHash } from './hash.js';
-import { BYTES_PER_BLOB, BYTES_PER_COMMITMENT, kzg } from './kzg_context.js';
-export { FIELDS_PER_BLOB };
+// Importing directly from 'c-kzg' does not work:
+import cKzg from 'c-kzg';
+import { deserializeEncodedBlobToFields, extractBlobFieldsFromBuffer } from './encoding.js';
+import { BlobDeserializationError } from './errors.js';
+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;
+/** Versioned blob hash for an empty blob */ export const EMPTY_BLOB_VERSIONED_HASH = Buffer.from(`010657f37554c781402a22917dee2f75def7ab966d7b770905398eba3c444014`, 'hex');
 /**
  * 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 data to be broadcast on L1 in bytes form.
-     */ data, /**
-     * Commitment to the blob data. Used in compressed BLS12 point format (48 bytes).
-     */ 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){
         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}.`);
-        }
     }
     /**
-   * Create a Blob from a buffer.
-   * @param data - The buffer of the Blob.
+   * 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 data does not match the expected length (BYTES_PER_BLOB).
-   */ static fromBlobBuffer(data) {
-        const commitment = computeBlobCommitment(data);
-        return new Blob(data, commitment);
+   * @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`);
+        }
     }
     /**
    * 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) {
-        if (fields.length > FIELDS_PER_BLOB) {
-            throw new Error(`Attempted to overfill blob with ${fields.length} fields. The maximum is ${FIELDS_PER_BLOB}.`);
+   */ static async fromFields(fields, multiBlobFieldsHash) {
+        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);
-        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);
+        // 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)
+        ]);
+        return new Blob(data, fieldsHash, challengeZ, commitment);
     }
     /**
    * Create a Blob from a JSON object.
@@ -72,19 +71,24 @@ export { FIELDS_PER_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) {
+   */ static async fromJson(json) {
         const blobBuffer = Buffer.from(json.blob.slice(2), 'hex');
-        const blob = Blob.fromBlobBuffer(blobBuffer);
+        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) {
@@ -95,31 +99,84 @@ export { FIELDS_PER_BLOB };
             kzg_commitment: `0x${this.commitment.toString('hex')}`
         };
     }
-    getEthVersionedBlobHash() {
-        return computeEthVersionedBlobHash(this.commitment);
+    /**
+   * 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);
     }
     /**
-   * 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);
+   * 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;
+    }
+    static getEthVersionedBlobHash(commitment) {
+        const hash = sha256(commitment);
+        hash[0] = VERSIONED_HASH_VERSION_KZG;
+        return hash;
     }
     /**
    * 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.
-   * @param verifyProof - Whether to verify the 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.
    *
-   * @returns
-   *  y: BLS12Fr -  Evaluation y = p(z), where p() is the blob polynomial. BLS12 field element, rep. as BigNum in nr, bigint in ts.
+   * @returns -
+   *  y: Buffer -  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, verifyProof = false) {
-        const res = kzg.computeKzgProof(this.data, challengeZ.toBuffer());
-        if (verifyProof && !kzg.verifyKzgProof(this.commitment, challengeZ.toBuffer(), res[1], res[0])) {
+   */ evaluate(challengeZ) {
+        const z = challengeZ || this.challengeZ;
+        const res = computeKzgProof(this.data, z.toBuffer());
+        if (!verifyKzgProof(this.commitment, z.toBuffer(), res[1], res[0])) {
             throw new Error(`KZG proof did not verify.`);
         }
         const proof = Buffer.from(res[0]);
-        const y = BLS12Fr.fromBuffer(Buffer.from(res[1]));
+        const y = Buffer.from(res[1]);
         return {
             y,
             proof
@@ -128,39 +185,76 @@ export { FIELDS_PER_BLOB };
     /**
    * Get the buffer representation of the ENTIRE blob.
    *
-   * @dev WARNING: this buffer contains all metadata as well as the data itself.
+   * @dev WARNING: this buffer contains all metadata aswell as the data itself
    *
    * @returns The buffer representation of the blob.
    */ toBuffer() {
-        return Buffer.from(serializeToBuffer(this.data.length, this.data, this.commitment.length, this.commitment));
+        return Buffer.from(serializeToBuffer(this.data.length, this.data, this.fieldsHash, this.challengeZ, this.commitment.length, this.commitment));
     }
     /**
    * Create a Blob from a buffer.
    *
-   * @dev WARNING: this method contains all metadata as well as the data itself.
+   * @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) {
         const reader = BufferReader.asReader(buf);
-        return new Blob(reader.readUint8Array(), reader.readBuffer());
+        return new Blob(reader.readUint8Array(), reader.readObject(Fr), reader.readObject(Fr), 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),
-            computeBlobKzgProof: kzg.computeBlobKzgProof.bind(kzg),
-            computeCellsAndKzgProofs: (b)=>{
-                const result = kzg.computeCellsAndKzgProofs(b);
-                return [
-                    result.cells,
-                    result.proofs
-                ];
-            }
+            blobToKzgCommitment: cKzg.blobToKzgCommitment,
+            computeBlobKzgProof: cKzg.computeBlobKzgProof,
+            computeCellsAndKzgProofs: cKzg.computeCellsAndKzgProofs
         };
     }
+    /**
+   * @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 / 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) {
+    return [
+        new Fr(commitment.subarray(0, 31)),
+        new Fr(commitment.subarray(31, 48))
+    ];
 }