@aztec/blob-lib 4.0.0-nightly.20250907 → 4.0.0-nightly.20260108

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. package/dest/batched_blob.d.ts +26 -0
  2. package/dest/batched_blob.d.ts.map +1 -0
  3. package/dest/batched_blob.js +20 -0
  4. package/dest/blob.d.ts +50 -99
  5. package/dest/blob.d.ts.map +1 -1
  6. package/dest/blob.js +78 -169
  7. package/dest/blob_batching.d.ts +41 -123
  8. package/dest/blob_batching.d.ts.map +1 -1
  9. package/dest/blob_batching.js +129 -203
  10. package/dest/blob_utils.d.ts +40 -0
  11. package/dest/blob_utils.d.ts.map +1 -0
  12. package/dest/blob_utils.js +69 -0
  13. package/dest/circuit_types/blob_accumulator.d.ts +23 -0
  14. package/dest/circuit_types/blob_accumulator.d.ts.map +1 -0
  15. package/dest/circuit_types/blob_accumulator.js +62 -0
  16. package/dest/circuit_types/final_blob_accumulator.d.ts +23 -0
  17. package/dest/circuit_types/final_blob_accumulator.d.ts.map +1 -0
  18. package/dest/circuit_types/final_blob_accumulator.js +66 -0
  19. package/dest/circuit_types/final_blob_batching_challenges.d.ts +16 -0
  20. package/dest/circuit_types/final_blob_batching_challenges.d.ts.map +1 -0
  21. package/dest/circuit_types/final_blob_batching_challenges.js +26 -0
  22. package/dest/circuit_types/index.d.ts +4 -0
  23. package/dest/circuit_types/index.d.ts.map +1 -0
  24. package/dest/circuit_types/index.js +4 -0
  25. package/dest/encoding/block_blob_data.d.ts +22 -0
  26. package/dest/encoding/block_blob_data.d.ts.map +1 -0
  27. package/dest/encoding/block_blob_data.js +65 -0
  28. package/dest/encoding/block_end_marker.d.ts +11 -0
  29. package/dest/encoding/block_end_marker.d.ts.map +1 -0
  30. package/dest/encoding/block_end_marker.js +41 -0
  31. package/dest/encoding/block_end_state_field.d.ts +12 -0
  32. package/dest/encoding/block_end_state_field.d.ts.map +1 -0
  33. package/dest/encoding/block_end_state_field.js +39 -0
  34. package/dest/encoding/checkpoint_blob_data.d.ts +15 -0
  35. package/dest/encoding/checkpoint_blob_data.d.ts.map +1 -0
  36. package/dest/encoding/checkpoint_blob_data.js +67 -0
  37. package/dest/encoding/checkpoint_end_marker.d.ts +8 -0
  38. package/dest/encoding/checkpoint_end_marker.d.ts.map +1 -0
  39. package/dest/encoding/checkpoint_end_marker.js +28 -0
  40. package/dest/encoding/fixtures.d.ts +41 -0
  41. package/dest/encoding/fixtures.d.ts.map +1 -0
  42. package/dest/encoding/fixtures.js +140 -0
  43. package/dest/encoding/index.d.ts +10 -0
  44. package/dest/encoding/index.d.ts.map +1 -0
  45. package/dest/encoding/index.js +9 -0
  46. package/dest/encoding/tx_blob_data.d.ts +19 -0
  47. package/dest/encoding/tx_blob_data.d.ts.map +1 -0
  48. package/dest/encoding/tx_blob_data.js +79 -0
  49. package/dest/encoding/tx_start_marker.d.ts +16 -0
  50. package/dest/encoding/tx_start_marker.d.ts.map +1 -0
  51. package/dest/encoding/tx_start_marker.js +77 -0
  52. package/dest/errors.d.ts +1 -1
  53. package/dest/errors.d.ts.map +1 -1
  54. package/dest/hash.d.ts +43 -0
  55. package/dest/hash.d.ts.map +1 -0
  56. package/dest/hash.js +80 -0
  57. package/dest/index.d.ts +7 -4
  58. package/dest/index.d.ts.map +1 -1
  59. package/dest/index.js +6 -16
  60. package/dest/interface.d.ts +1 -2
  61. package/dest/interface.d.ts.map +1 -1
  62. package/dest/kzg_context.d.ts +8 -0
  63. package/dest/kzg_context.d.ts.map +1 -0
  64. package/dest/kzg_context.js +14 -0
  65. package/dest/sponge_blob.d.ts +12 -14
  66. package/dest/sponge_blob.d.ts.map +1 -1
  67. package/dest/sponge_blob.js +26 -30
  68. package/dest/testing.d.ts +10 -23
  69. package/dest/testing.d.ts.map +1 -1
  70. package/dest/testing.js +37 -53
  71. package/dest/types.d.ts +17 -0
  72. package/dest/types.d.ts.map +1 -0
  73. package/dest/types.js +4 -0
  74. package/package.json +10 -7
  75. package/src/batched_blob.ts +26 -0
  76. package/src/blob.ts +81 -195
  77. package/src/blob_batching.ts +168 -231
  78. package/src/blob_utils.ts +82 -0
  79. package/src/circuit_types/blob_accumulator.ts +96 -0
  80. package/src/circuit_types/final_blob_accumulator.ts +76 -0
  81. package/src/circuit_types/final_blob_batching_challenges.ts +30 -0
  82. package/src/circuit_types/index.ts +4 -0
  83. package/src/encoding/block_blob_data.ts +102 -0
  84. package/src/encoding/block_end_marker.ts +55 -0
  85. package/src/encoding/block_end_state_field.ts +59 -0
  86. package/src/encoding/checkpoint_blob_data.ts +95 -0
  87. package/src/encoding/checkpoint_end_marker.ts +40 -0
  88. package/src/encoding/fixtures.ts +210 -0
  89. package/src/encoding/index.ts +9 -0
  90. package/src/encoding/tx_blob_data.ts +116 -0
  91. package/src/encoding/tx_start_marker.ts +97 -0
  92. package/src/hash.ts +89 -0
  93. package/src/index.ts +6 -19
  94. package/src/interface.ts +0 -1
  95. package/src/kzg_context.ts +16 -0
  96. package/src/sponge_blob.ts +28 -31
  97. package/src/testing.ts +48 -59
  98. package/src/types.ts +17 -0
  99. package/dest/blob_batching_public_inputs.d.ts +0 -71
  100. package/dest/blob_batching_public_inputs.d.ts.map +0 -1
  101. package/dest/blob_batching_public_inputs.js +0 -168
  102. package/dest/encoding.d.ts +0 -66
  103. package/dest/encoding.d.ts.map +0 -1
  104. package/dest/encoding.js +0 -113
  105. package/src/blob_batching_public_inputs.ts +0 -252
  106. package/src/encoding.ts +0 -138
package/dest/hash.js ADDED
@@ -0,0 +1,80 @@
1
+ import { poseidon2Hash } from '@aztec/foundation/crypto/poseidon';
2
+ import { sha256, sha256ToField } from '@aztec/foundation/crypto/sha256';
3
+ import { Fr } from '@aztec/foundation/curves/bn254';
4
+ import { BYTES_PER_BLOB, BYTES_PER_COMMITMENT, getKzg } from './kzg_context.js';
5
+ import { SpongeBlob } from './sponge_blob.js';
6
+ const VERSIONED_HASH_VERSION_KZG = 0x01;
7
+ /**
8
+ * Returns ethereum's versioned blob hash, following kzg_to_versioned_hash: https://eips.ethereum.org/EIPS/eip-4844#helpers
9
+ */ export function computeEthVersionedBlobHash(commitment) {
10
+ const hash = sha256(commitment);
11
+ hash[0] = VERSIONED_HASH_VERSION_KZG;
12
+ return hash;
13
+ }
14
+ // TODO(#13430): The blobsHash is confusingly similar to blobCommitmentsHash, calculated from below blobCommitments:
15
+ // - blobsHash := sha256([blobhash_0, ..., blobhash_m]) = a hash of all blob hashes in a block with m+1 blobs inserted into the header, exists so a user can cross check blobs.
16
+ // - blobCommitmentsHash := sha256( ...sha256(sha256(C_0), C_1) ... C_n) = iteratively calculated hash of all blob commitments in an epoch with n+1 blobs (see calculateBlobCommitmentsHash()),
17
+ // exists so we can validate injected commitments to the rollup circuits correspond to the correct real blobs.
18
+ // We may be able to combine these values e.g. blobCommitmentsHash := sha256( ...sha256(sha256(blobshash_0), blobshash_1) ... blobshash_l) for an epoch with l+1 blocks.
19
+ export function computeBlobsHash(evmVersionedBlobHashes) {
20
+ return sha256ToField(evmVersionedBlobHashes);
21
+ }
22
+ /**
23
+ * Computes a non-standard Poseidon2 hash over the provided fields.
24
+ *
25
+ * This function is used to compute:
26
+ * - `blobFieldsHash` of a checkpoint:
27
+ * Verified in the circuit against all fields absorbed into the blob sponge over the entire checkpoint.
28
+ * The exact number of fields is encoded in the checkpoint end marker (the last field).
29
+ * This hash is used when generating the challenge `z` for all blobs in the checkpoint.
30
+ * - `spongeBlobHash` of a block:
31
+ * Computed from the block's tx effects, its end-state, and the blob fields of all prior blocks in the same checkpoint.
32
+ * This hash is included in the block header.
33
+ */ export async function computeBlobFieldsHash(fields) {
34
+ const sponge = SpongeBlob.init();
35
+ await sponge.absorb(fields);
36
+ return sponge.squeeze();
37
+ }
38
+ export function computeBlobCommitment(data) {
39
+ if (data.length !== BYTES_PER_BLOB) {
40
+ throw new Error(`Expected ${BYTES_PER_BLOB} bytes per blob. Got ${data.length}.`);
41
+ }
42
+ return Buffer.from(getKzg().blobToKzgCommitment(data));
43
+ }
44
+ /**
45
+ * Get the commitment fields of the blob, to compute the challenge z.
46
+ *
47
+ * The 48-byte commitment is encoded into two field elements:
48
+ * +-------------------+------------------------+
49
+ * | 31 bytes | 17 bytes |
50
+ * +-------------------+------------------------+
51
+ * | Field Element 1 | Field Element 2 |
52
+ * | [0][bytes 0-30] | [0...0][bytes 31-47] |
53
+ * +-------------------+------------------------+
54
+ *
55
+ * @param commitment - The commitment to convert to fields. Computed from `computeBlobCommitment`.
56
+ * @returns The fields representing the commitment buffer.
57
+ */ export function commitmentToFields(commitment) {
58
+ if (commitment.length !== BYTES_PER_COMMITMENT) {
59
+ throw new Error(`Expected ${BYTES_PER_COMMITMENT} bytes for blob commitment. Got ${commitment.length}.`);
60
+ }
61
+ return [
62
+ new Fr(commitment.subarray(0, 31)),
63
+ new Fr(commitment.subarray(31, BYTES_PER_COMMITMENT))
64
+ ];
65
+ }
66
+ export async function computeChallengeZ(blobFieldsHash, commitment) {
67
+ const commitmentFields = commitmentToFields(commitment);
68
+ return await poseidon2Hash([
69
+ blobFieldsHash,
70
+ commitmentFields[0],
71
+ commitmentFields[1]
72
+ ]);
73
+ }
74
+ /**
75
+ * Hash each u128 limb of the noir bignum struct representing the BLS field, to mimic the hash accumulation in the
76
+ * rollup circuits.
77
+ */ export async function hashNoirBigNumLimbs(field) {
78
+ const num = field.toNoirBigNum();
79
+ return await poseidon2Hash(num.limbs.map(Fr.fromHexString));
80
+ }
package/dest/index.d.ts CHANGED
@@ -1,8 +1,11 @@
1
+ export * from './batched_blob.js';
1
2
  export * from './blob.js';
2
3
  export * from './blob_batching.js';
3
- export * from './encoding.js';
4
+ export * from './blob_utils.js';
5
+ export * from './circuit_types/index.js';
6
+ export * from './encoding/index.js';
7
+ export * from './hash.js';
4
8
  export * from './interface.js';
5
- export * from './errors.js';
6
- export * from './blob_batching_public_inputs.js';
7
9
  export * from './sponge_blob.js';
8
- //# sourceMappingURL=index.d.ts.map
10
+ export * from './kzg_context.js';
11
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLG1CQUFtQixDQUFDO0FBQ2xDLGNBQWMsV0FBVyxDQUFDO0FBQzFCLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxXQUFXLENBQUM7QUFDMUIsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsa0JBQWtCLENBQUMifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
package/dest/index.js CHANGED
@@ -1,20 +1,10 @@
1
- import cKzg from 'c-kzg';
2
- const { loadTrustedSetup } = cKzg;
1
+ export * from './batched_blob.js';
3
2
  export * from './blob.js';
4
3
  export * from './blob_batching.js';
5
- export * from './encoding.js';
4
+ export * from './blob_utils.js';
5
+ export * from './circuit_types/index.js';
6
+ export * from './encoding/index.js';
7
+ export * from './hash.js';
6
8
  export * from './interface.js';
7
- export * from './errors.js';
8
- export * from './blob_batching_public_inputs.js';
9
9
  export * from './sponge_blob.js';
10
- try {
11
- loadTrustedSetup();
12
- } catch (error) {
13
- if (error.message.includes('trusted setup is already loaded')) {
14
- // NB: The c-kzg lib has no way of checking whether the setup is loaded or not,
15
- // and it throws an error if it's already loaded, even though nothing is wrong.
16
- // This is a rudimentary way of ensuring we load the trusted setup if we need it.
17
- } else {
18
- throw new Error(error);
19
- }
20
- }
10
+ export * from './kzg_context.js';
@@ -3,7 +3,6 @@
3
3
  */
4
4
  export interface BlobJson {
5
5
  blob: string;
6
- index: string;
7
6
  kzg_commitment: string;
8
7
  }
9
- //# sourceMappingURL=interface.d.ts.map
8
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW50ZXJmYWNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxXQUFXLFFBQVE7SUFDdkIsSUFBSSxFQUFFLE1BQU0sQ0FBQztJQUNiLGNBQWMsRUFBRSxNQUFNLENBQUM7Q0FDeEIifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB"}
1
+ {"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB"}
@@ -0,0 +1,8 @@
1
+ import { DasContextJs } from '@crate-crypto/node-eth-kzg';
2
+ export * from '@crate-crypto/node-eth-kzg';
3
+ /**
4
+ * Returns the lazily-initialized KZG context.
5
+ * The first call takes ~3 seconds to initialize the precomputation tables.
6
+ */
7
+ export declare function getKzg(): DasContextJs;
8
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoia3pnX2NvbnRleHQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9remdfY29udGV4dC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFFMUQsY0FBYyw0QkFBNEIsQ0FBQztBQUkzQzs7O0dBR0c7QUFDSCx3QkFBZ0IsTUFBTSxJQUFJLFlBQVksQ0FLckMifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kzg_context.d.ts","sourceRoot":"","sources":["../src/kzg_context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,cAAc,4BAA4B,CAAC;AAI3C;;;GAGG;AACH,wBAAgB,MAAM,IAAI,YAAY,CAKrC"}
@@ -0,0 +1,14 @@
1
+ import { DasContextJs } from '@crate-crypto/node-eth-kzg';
2
+ export * from '@crate-crypto/node-eth-kzg';
3
+ let kzgInstance;
4
+ /**
5
+ * Returns the lazily-initialized KZG context.
6
+ * The first call takes ~3 seconds to initialize the precomputation tables.
7
+ */ export function getKzg() {
8
+ if (!kzgInstance) {
9
+ kzgInstance = DasContextJs.create({
10
+ usePrecomp: true
11
+ });
12
+ }
13
+ return kzgInstance;
14
+ }
@@ -1,24 +1,23 @@
1
1
  import { type FieldsOf } from '@aztec/foundation/array';
2
- import { Fr } from '@aztec/foundation/fields';
2
+ import { Fr } from '@aztec/foundation/curves/bn254';
3
3
  import { BufferReader, FieldReader, type Tuple } from '@aztec/foundation/serialize';
4
4
  /**
5
- * A Poseidon2 sponge used to accumulate data that will be added to a blob.
5
+ * A Poseidon2 sponge used to accumulate data that will be added to blobs.
6
6
  * See noir-projects/noir-protocol-circuits/crates/types/src/abis/sponge_blob.nr.
7
7
  */
8
8
  export declare class SpongeBlob {
9
- /** Sponge with absorbed tx effects that will go into a blob. */
10
9
  readonly sponge: Poseidon2Sponge;
11
- /** Number of effects absorbed so far. */
12
- fields: number;
13
- /** Number of effects that will be absorbed. */
14
- readonly expectedFields: number;
10
+ numAbsorbedFields: number;
11
+ static MAX_FIELDS: number;
15
12
  constructor(
16
- /** Sponge with absorbed tx effects that will go into a blob. */
13
+ /** Sponge with absorbed fields that will go into one or more blobs. */
17
14
  sponge: Poseidon2Sponge,
18
15
  /** Number of effects absorbed so far. */
19
- fields: number,
20
- /** Number of effects that will be absorbed. */
21
- expectedFields: number);
16
+ numAbsorbedFields: number);
17
+ /**
18
+ * Initialize the sponge blob to absorb data for a checkpoint.
19
+ */
20
+ static init(): SpongeBlob;
22
21
  static fromBuffer(buffer: Buffer | BufferReader): SpongeBlob;
23
22
  toBuffer(): Buffer<ArrayBufferLike>;
24
23
  static getFields(fields: FieldsOf<SpongeBlob>): (number | Poseidon2Sponge)[];
@@ -28,7 +27,6 @@ export declare class SpongeBlob {
28
27
  absorb(fields: Fr[]): Promise<void>;
29
28
  squeeze(): Promise<Fr>;
30
29
  static empty(): SpongeBlob;
31
- static init(expectedFields: number): SpongeBlob;
32
30
  }
33
31
  export declare class Poseidon2Sponge {
34
32
  cache: Tuple<Fr, 3>;
@@ -42,9 +40,9 @@ export declare class Poseidon2Sponge {
42
40
  toFields(): Fr[];
43
41
  static fromFields(fields: Fr[] | FieldReader): Poseidon2Sponge;
44
42
  static empty(): Poseidon2Sponge;
45
- static init(expectedFields: number): Poseidon2Sponge;
43
+ static init(iv: Fr): Poseidon2Sponge;
46
44
  performDuplex(): Promise<void>;
47
45
  absorb(fields: Fr[]): Promise<void>;
48
46
  squeeze(): Promise<Fr>;
49
47
  }
50
- //# sourceMappingURL=sponge_blob.d.ts.map
48
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3BvbmdlX2Jsb2IuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9zcG9uZ2VfYmxvYi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsS0FBSyxRQUFRLEVBQWEsTUFBTSx5QkFBeUIsQ0FBQztBQUVuRSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEQsT0FBTyxFQUNMLFlBQVksRUFDWixXQUFXLEVBQ1gsS0FBSyxLQUFLLEVBR1gsTUFBTSw2QkFBNkIsQ0FBQztBQUVyQzs7O0dBR0c7QUFDSCxxQkFBYSxVQUFVO2FBS0gsTUFBTSxFQUFFLGVBQWU7SUFFaEMsaUJBQWlCLEVBQUUsTUFBTTtJQU5sQyxNQUFNLENBQUMsVUFBVSxTQUEwQztJQUUzRDtJQUNFLHVFQUF1RTtJQUN2RCxNQUFNLEVBQUUsZUFBZTtJQUN2Qyx5Q0FBeUM7SUFDbEMsaUJBQWlCLEVBQUUsTUFBTSxFQUM5QjtJQUVKOztPQUVHO0lBQ0gsTUFBTSxDQUFDLElBQUksSUFBSSxVQUFVLENBS3hCO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksR0FBRyxVQUFVLENBRzNEO0lBRUQsUUFBUSw0QkFFUDtJQUVELE1BQU0sQ0FBQyxTQUFTLENBQUMsTUFBTSxFQUFFLFFBQVEsQ0FBQyxVQUFVLENBQUMsZ0NBRTVDO0lBRUQsUUFBUSxJQUFJLEVBQUUsRUFBRSxDQUVmO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsRUFBRSxFQUFFLEdBQUcsV0FBVyxHQUFHLFVBQVUsQ0FHeEQ7SUFFRCxLQUFLLGVBRUo7SUFFSyxNQUFNLENBQUMsTUFBTSxFQUFFLEVBQUUsRUFBRSxpQkFReEI7SUFFSyxPQUFPLElBQUksT0FBTyxDQUFDLEVBQUUsQ0FBQyxDQUUzQjtJQUVELE1BQU0sQ0FBQyxLQUFLLElBQUksVUFBVSxDQUV6QjtDQUNGO0FBR0QscUJBQWEsZUFBZTtJQUVqQixLQUFLLEVBQUUsS0FBSyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDbkIsS0FBSyxFQUFFLEtBQUssQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDO0lBQ25CLFNBQVMsRUFBRSxNQUFNO0lBQ2pCLFdBQVcsRUFBRSxPQUFPO0lBSjdCLFlBQ1MsS0FBSyxFQUFFLEtBQUssQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLEVBQ25CLEtBQUssRUFBRSxLQUFLLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxFQUNuQixTQUFTLEVBQUUsTUFBTSxFQUNqQixXQUFXLEVBQUUsT0FBTyxFQUN6QjtJQUVKLE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLEdBQUcsZUFBZSxDQVFoRTtJQUVELFFBQVEsNEJBRVA7SUFFRCxNQUFNLENBQUMsU0FBUyxDQUFDLE1BQU0sRUFBRSxRQUFRLENBQUMsZUFBZSxDQUFDLDBEQUVqRDtJQUVELFFBQVEsSUFBSSxFQUFFLEVBQUUsQ0FFZjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLEVBQUUsRUFBRSxHQUFHLFdBQVcsR0FBRyxlQUFlLENBUTdEO0lBRUQsTUFBTSxDQUFDLEtBQUssSUFBSSxlQUFlLENBTzlCO0lBRUQsTUFBTSxDQUFDLElBQUksQ0FBQyxFQUFFLEVBQUUsRUFBRSxHQUFHLGVBQWUsQ0FJbkM7SUFLSyxhQUFhLGtCQVNsQjtJQUVLLE1BQU0sQ0FBQyxNQUFNLEVBQUUsRUFBRSxFQUFFLGlCQWF4QjtJQUVLLE9BQU8sSUFBSSxPQUFPLENBQUMsRUFBRSxDQUFDLENBTzNCO0NBQ0YifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"sponge_blob.d.ts","sourceRoot":"","sources":["../src/sponge_blob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAa,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,KAAK,EAGX,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,qBAAa,UAAU;IAEnB,gEAAgE;aAChD,MAAM,EAAE,eAAe;IACvC,yCAAyC;IAClC,MAAM,EAAE,MAAM;IACrB,+CAA+C;aAC/B,cAAc,EAAE,MAAM;;IALtC,gEAAgE;IAChD,MAAM,EAAE,eAAe;IACvC,yCAAyC;IAClC,MAAM,EAAE,MAAM;IACrB,+CAA+C;IAC/B,cAAc,EAAE,MAAM;IAGxC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU;IAK5D,QAAQ;IAIR,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC;IAI7C,QAAQ,IAAI,EAAE,EAAE;IAIhB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,GAAG,UAAU;IASzD,KAAK;IAIC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE;IAUnB,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC;IAS5B,MAAM,CAAC,KAAK,IAAI,UAAU;IAI1B,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,UAAU;CAGhD;AAGD,qBAAa,eAAe;IAEjB,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACnB,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,OAAO;gBAHpB,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EACnB,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO;IAG7B,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe;IAUjE,QAAQ;IAIR,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC;IAIlD,QAAQ,IAAI,EAAE,EAAE;IAIhB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,GAAG,eAAe;IAU9D,MAAM,CAAC,KAAK,IAAI,eAAe;IAS/B,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,eAAe;IAU9C,aAAa;IAWb,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE;IAenB,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC;CAQ7B"}
1
+ {"version":3,"file":"sponge_blob.d.ts","sourceRoot":"","sources":["../src/sponge_blob.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAa,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,KAAK,EAGX,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,qBAAa,UAAU;aAKH,MAAM,EAAE,eAAe;IAEhC,iBAAiB,EAAE,MAAM;IANlC,MAAM,CAAC,UAAU,SAA0C;IAE3D;IACE,uEAAuE;IACvD,MAAM,EAAE,eAAe;IACvC,yCAAyC;IAClC,iBAAiB,EAAE,MAAM,EAC9B;IAEJ;;OAEG;IACH,MAAM,CAAC,IAAI,IAAI,UAAU,CAKxB;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,CAG3D;IAED,QAAQ,4BAEP;IAED,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,gCAE5C;IAED,QAAQ,IAAI,EAAE,EAAE,CAEf;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,GAAG,UAAU,CAGxD;IAED,KAAK,eAEJ;IAEK,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,iBAQxB;IAEK,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC,CAE3B;IAED,MAAM,CAAC,KAAK,IAAI,UAAU,CAEzB;CACF;AAGD,qBAAa,eAAe;IAEjB,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACnB,SAAS,EAAE,MAAM;IACjB,WAAW,EAAE,OAAO;IAJ7B,YACS,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EACnB,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO,EACzB;IAEJ,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,eAAe,CAQhE;IAED,QAAQ,4BAEP;IAED,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,0DAEjD;IAED,QAAQ,IAAI,EAAE,EAAE,CAEf;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,GAAG,eAAe,CAQ7D;IAED,MAAM,CAAC,KAAK,IAAI,eAAe,CAO9B;IAED,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,eAAe,CAInC;IAKK,aAAa,kBASlB;IAEK,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,iBAaxB;IAEK,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC,CAO3B;CACF"}
@@ -1,31 +1,38 @@
1
+ import { BLOBS_PER_CHECKPOINT, FIELDS_PER_BLOB, TWO_POW_64 } from '@aztec/constants';
1
2
  import { makeTuple } from '@aztec/foundation/array';
2
- import { poseidon2Permutation } from '@aztec/foundation/crypto';
3
- import { Fr } from '@aztec/foundation/fields';
3
+ import { poseidon2Permutation } from '@aztec/foundation/crypto/poseidon';
4
+ import { Fr } from '@aztec/foundation/curves/bn254';
4
5
  import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } from '@aztec/foundation/serialize';
5
6
  /**
6
- * A Poseidon2 sponge used to accumulate data that will be added to a blob.
7
+ * A Poseidon2 sponge used to accumulate data that will be added to blobs.
7
8
  * See noir-projects/noir-protocol-circuits/crates/types/src/abis/sponge_blob.nr.
8
9
  */ export class SpongeBlob {
9
10
  sponge;
10
- fields;
11
- expectedFields;
12
- constructor(/** Sponge with absorbed tx effects that will go into a blob. */ sponge, /** Number of effects absorbed so far. */ fields, /** Number of effects that will be absorbed. */ expectedFields){
11
+ numAbsorbedFields;
12
+ static MAX_FIELDS = BLOBS_PER_CHECKPOINT * FIELDS_PER_BLOB;
13
+ constructor(/** Sponge with absorbed fields that will go into one or more blobs. */ sponge, /** Number of effects absorbed so far. */ numAbsorbedFields){
13
14
  this.sponge = sponge;
14
- this.fields = fields;
15
- this.expectedFields = expectedFields;
15
+ this.numAbsorbedFields = numAbsorbedFields;
16
+ }
17
+ /**
18
+ * Initialize the sponge blob to absorb data for a checkpoint.
19
+ */ static init() {
20
+ // This must match the implementation in noir-projects/noir-protocol-circuits/types/src/abis/sponge_blob.nr
21
+ const iv = new Fr(BigInt(SpongeBlob.MAX_FIELDS) * TWO_POW_64);
22
+ const sponge = Poseidon2Sponge.init(iv);
23
+ return new SpongeBlob(sponge, 0);
16
24
  }
17
25
  static fromBuffer(buffer) {
18
26
  const reader = BufferReader.asReader(buffer);
19
- return new SpongeBlob(reader.readObject(Poseidon2Sponge), reader.readNumber(), reader.readNumber());
27
+ return new SpongeBlob(reader.readObject(Poseidon2Sponge), reader.readNumber());
20
28
  }
21
29
  toBuffer() {
22
- return serializeToBuffer(this.sponge, this.fields, this.expectedFields);
30
+ return serializeToBuffer(...SpongeBlob.getFields(this));
23
31
  }
24
32
  static getFields(fields) {
25
33
  return [
26
34
  fields.sponge,
27
- fields.fields,
28
- fields.expectedFields
35
+ fields.numAbsorbedFields
29
36
  ];
30
37
  }
31
38
  toFields() {
@@ -33,33 +40,23 @@ import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } from
33
40
  }
34
41
  static fromFields(fields) {
35
42
  const reader = FieldReader.asReader(fields);
36
- return new SpongeBlob(reader.readObject(Poseidon2Sponge), reader.readField().toNumber(), reader.readField().toNumber());
43
+ return new SpongeBlob(reader.readObject(Poseidon2Sponge), reader.readField().toNumber());
37
44
  }
38
45
  clone() {
39
46
  return SpongeBlob.fromBuffer(this.toBuffer());
40
47
  }
41
48
  async absorb(fields) {
42
- if (this.fields + fields.length > this.expectedFields) {
43
- throw new Error(`Attempted to fill spongeblob with ${this.fields + fields.length}, but it has a max of ${this.expectedFields}`);
49
+ if (this.numAbsorbedFields + fields.length > SpongeBlob.MAX_FIELDS) {
50
+ throw new Error(`Attempted to fill spongeBlob with ${this.numAbsorbedFields + fields.length}, but it has a max of ${SpongeBlob.MAX_FIELDS}`);
44
51
  }
45
52
  await this.sponge.absorb(fields);
46
- this.fields += fields.length;
53
+ this.numAbsorbedFields += fields.length;
47
54
  }
48
55
  async squeeze() {
49
- // If the blob sponge is not 'full', we append 1 to match Poseidon2::hash_internal()
50
- // NB: There is currently no use case in which we don't 'fill' a blob sponge, but adding for completeness
51
- if (this.fields != this.expectedFields) {
52
- await this.sponge.absorb([
53
- Fr.ONE
54
- ]);
55
- }
56
- return this.sponge.squeeze();
56
+ return await this.sponge.squeeze();
57
57
  }
58
58
  static empty() {
59
- return new SpongeBlob(Poseidon2Sponge.empty(), 0, 0);
60
- }
61
- static init(expectedFields) {
62
- return new SpongeBlob(Poseidon2Sponge.init(expectedFields), 0, expectedFields);
59
+ return new SpongeBlob(Poseidon2Sponge.empty(), 0);
63
60
  }
64
61
  }
65
62
  // This is just noir's stdlib version of the poseidon2 sponge. We use it for a blob-specific implmentation of the hasher.
@@ -99,8 +96,7 @@ export class Poseidon2Sponge {
99
96
  static empty() {
100
97
  return new Poseidon2Sponge(makeTuple(3, ()=>Fr.ZERO), makeTuple(4, ()=>Fr.ZERO), 0, false);
101
98
  }
102
- static init(expectedFields) {
103
- const iv = new Fr(expectedFields).mul(new Fr(BigInt('18446744073709551616')));
99
+ static init(iv) {
104
100
  const sponge = Poseidon2Sponge.empty();
105
101
  sponge.state[3] = iv;
106
102
  return sponge;
package/dest/testing.d.ts CHANGED
@@ -1,8 +1,9 @@
1
- import { Fr } from '@aztec/foundation/fields';
2
1
  import { Blob } from './blob.js';
3
- import { BatchedBlobAccumulator } from './blob_batching.js';
4
- import { BlockBlobPublicInputs } from './blob_batching_public_inputs.js';
2
+ import { BlobAccumulator } from './circuit_types/blob_accumulator.js';
3
+ import { FinalBlobAccumulator } from './circuit_types/final_blob_accumulator.js';
4
+ import { FinalBlobBatchingChallenges } from './circuit_types/final_blob_batching_challenges.js';
5
5
  import { SpongeBlob } from './sponge_blob.js';
6
+ export * from './encoding/fixtures.js';
6
7
  /**
7
8
  * Makes arbitrary poseidon sponge for blob inputs.
8
9
  * Note: will not verify inside the circuit.
@@ -16,29 +17,15 @@ export declare function makeSpongeBlob(seed?: number): SpongeBlob;
16
17
  * @param seed - The seed to use for generating the blob accumulator.
17
18
  * @returns A blob accumulator instance.
18
19
  */
19
- export declare function makeBatchedBlobAccumulator(seed?: number): BatchedBlobAccumulator;
20
+ export declare function makeBlobAccumulator(seed?: number): BlobAccumulator;
21
+ export declare function makeFinalBlobAccumulator(seed?: number): FinalBlobAccumulator;
22
+ export declare function makeFinalBlobBatchingChallenges(seed?: number): FinalBlobBatchingChallenges;
20
23
  /**
21
- * Makes arbitrary block blob public inputs.
22
- * Note: will not verify inside the circuit.
23
- * @param seed - The seed to use for generating the blob inputs.
24
- * @returns A block blob public inputs instance.
25
- */
26
- export declare function makeBlockBlobPublicInputs(seed?: number): BlockBlobPublicInputs;
27
- /**
28
- * Make an encoded blob with the given length
29
- *
30
- * This will deserialise correctly in the archiver
31
- * @param length
32
- * @returns
33
- */
34
- export declare function makeEncodedBlob(length: number): Promise<Blob>;
35
- /**
36
- * Make an unencoded blob with the given length
24
+ * Make a blob with random fields.
37
25
  *
38
26
  * This will fail deserialisation in the archiver
39
27
  * @param length
40
28
  * @returns
41
29
  */
42
- export declare function makeUnencodedBlob(length: number): Promise<Blob>;
43
- export declare function makeEncodedBlobFields(fields: Fr[]): Promise<Blob>;
44
- //# sourceMappingURL=testing.d.ts.map
30
+ export declare function makeRandomBlob(length: number): Blob;
31
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdGluZy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3Rlc3RpbmcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBSUEsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUNqQyxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFDdEUsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sMkNBQTJDLENBQUM7QUFDakYsT0FBTyxFQUFFLDJCQUEyQixFQUFFLE1BQU0sbURBQW1ELENBQUM7QUFDaEcsT0FBTyxFQUFtQixVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUUvRCxjQUFjLHdCQUF3QixDQUFDO0FBRXZDOzs7OztHQUtHO0FBQ0gsd0JBQWdCLGNBQWMsQ0FBQyxJQUFJLFNBQUksR0FBRyxVQUFVLENBVW5EO0FBMEJEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLElBQUksU0FBSSxHQUFHLGVBQWUsQ0FTN0Q7QUFFRCx3QkFBZ0Isd0JBQXdCLENBQUMsSUFBSSxTQUFJLHdCQU9oRDtBQUVELHdCQUFnQiwrQkFBK0IsQ0FBQyxJQUFJLFNBQUksK0JBRXZEO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsd0JBQWdCLGNBQWMsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLElBQUksQ0FFbkQifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAA+B,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAA+B,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEtG,OAAO,EAAmB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,SAAI,GAAG,UAAU,CAWnD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,SAAI,GAAG,sBAAsB,CAW3E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,SAAI,GAAG,qBAAqB,CAOzE;AAmBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjE"}
1
+ {"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,mDAAmD,CAAC;AAChG,OAAO,EAAmB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE/D,cAAc,wBAAwB,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,SAAI,GAAG,UAAU,CAUnD;AA0BD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,SAAI,GAAG,eAAe,CAS7D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,SAAI,wBAOhD;AAED,wBAAgB,+BAA+B,CAAC,IAAI,SAAI,+BAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnD"}
package/dest/testing.js CHANGED
@@ -1,82 +1,66 @@
1
1
  import { makeTuple } from '@aztec/foundation/array';
2
- import { toBufferBE } from '@aztec/foundation/bigint-buffer';
3
- import { BLS12Fr, BLS12Point, Fr } from '@aztec/foundation/fields';
2
+ import { BLS12Fq, BLS12Fr, BLS12Point, BLSPointNotOnCurveError } from '@aztec/foundation/curves/bls12';
3
+ import { Fr } from '@aztec/foundation/curves/bn254';
4
4
  import { Blob } from './blob.js';
5
- import { BatchedBlobAccumulator, FinalBlobBatchingChallenges } from './blob_batching.js';
6
- import { BlobAccumulatorPublicInputs, BlockBlobPublicInputs } from './blob_batching_public_inputs.js';
7
- import { TX_START_PREFIX, TX_START_PREFIX_BYTES_LENGTH } from './encoding.js';
5
+ import { BlobAccumulator } from './circuit_types/blob_accumulator.js';
6
+ import { FinalBlobAccumulator } from './circuit_types/final_blob_accumulator.js';
7
+ import { FinalBlobBatchingChallenges } from './circuit_types/final_blob_batching_challenges.js';
8
8
  import { Poseidon2Sponge, SpongeBlob } from './sponge_blob.js';
9
+ export * from './encoding/fixtures.js';
9
10
  /**
10
11
  * Makes arbitrary poseidon sponge for blob inputs.
11
12
  * Note: will not verify inside the circuit.
12
13
  * @param seed - The seed to use for generating the sponge.
13
14
  * @returns A sponge blob instance.
14
15
  */ export function makeSpongeBlob(seed = 1) {
15
- return new SpongeBlob(new Poseidon2Sponge(makeTuple(3, (i)=>new Fr(i)), makeTuple(4, (i)=>new Fr(i)), 1, false), seed, seed + 1);
16
+ return new SpongeBlob(new Poseidon2Sponge(makeTuple(3, (i)=>new Fr(i)), makeTuple(4, (i)=>new Fr(i)), 1, false), seed);
17
+ }
18
+ /**
19
+ * Makes an arbitrary but valid BLS12 point. The value is deterministic for a given seed.
20
+ * @param seed - The seed to use for generating the point.
21
+ * @returns A BLS12 point instance.
22
+ */ function makeBLS12Point(seed = 1) {
23
+ let accum = 0;
24
+ while(true){
25
+ try {
26
+ const x = new BLS12Fq(seed + accum);
27
+ const y = BLS12Point.YFromX(x);
28
+ if (y) {
29
+ return new BLS12Point(x, y, false);
30
+ }
31
+ accum++;
32
+ } catch (e) {
33
+ if (!(e instanceof BLSPointNotOnCurveError)) {
34
+ throw e;
35
+ }
36
+ // The point is not on the curve - try again
37
+ }
38
+ }
16
39
  }
17
40
  /**
18
41
  * Makes arbitrary blob public accumulator.
19
42
  * Note: will not verify inside the circuit.
20
43
  * @param seed - The seed to use for generating the blob accumulator.
21
44
  * @returns A blob accumulator instance.
22
- */ export function makeBatchedBlobAccumulator(seed = 1) {
23
- return new BatchedBlobAccumulator(new Fr(seed), new Fr(seed + 1), new BLS12Fr(seed + 2), BLS12Point.random(), BLS12Point.random(), new Fr(seed + 3), new BLS12Fr(seed + 4), new FinalBlobBatchingChallenges(new Fr(seed + 5), new BLS12Fr(seed + 6)));
45
+ */ export function makeBlobAccumulator(seed = 1) {
46
+ return new BlobAccumulator(new Fr(seed), new Fr(seed + 0x10), new BLS12Fr(seed + 0x20), makeBLS12Point(seed + 0x30), new Fr(seed + 0x50), new BLS12Fr(seed + 0x60));
24
47
  }
25
- /**
26
- * Makes arbitrary block blob public inputs.
27
- * Note: will not verify inside the circuit.
28
- * @param seed - The seed to use for generating the blob inputs.
29
- * @returns A block blob public inputs instance.
30
- */ export function makeBlockBlobPublicInputs(seed = 1) {
31
- const startBlobAccumulator = makeBatchedBlobAccumulator(seed);
32
- return new BlockBlobPublicInputs(BlobAccumulatorPublicInputs.fromBatchedBlobAccumulator(startBlobAccumulator), BlobAccumulatorPublicInputs.fromBatchedBlobAccumulator(makeBatchedBlobAccumulator(seed + 1)), startBlobAccumulator.finalBlobChallenges);
48
+ export function makeFinalBlobAccumulator(seed = 1) {
49
+ return new FinalBlobAccumulator(new Fr(seed), new Fr(seed + 0x10), new BLS12Fr(seed + 0x20), makeBLS12Point(seed + 0x30));
33
50
  }
34
- // TODO: copied form stdlib tx effect
35
- function encodeFirstField(length) {
36
- const lengthBuf = Buffer.alloc(2);
37
- lengthBuf.writeUInt16BE(length, 0);
38
- return new Fr(Buffer.concat([
39
- toBufferBE(TX_START_PREFIX, TX_START_PREFIX_BYTES_LENGTH),
40
- Buffer.alloc(1),
41
- lengthBuf,
42
- Buffer.alloc(1),
43
- Buffer.from([
44
- 1
45
- ]),
46
- Buffer.alloc(1),
47
- Buffer.alloc(1)
48
- ]));
51
+ export function makeFinalBlobBatchingChallenges(seed = 1) {
52
+ return new FinalBlobBatchingChallenges(new Fr(seed), new BLS12Fr(seed + 0x10));
49
53
  }
50
54
  /**
51
- * Make an encoded blob with the given length
52
- *
53
- * This will deserialise correctly in the archiver
54
- * @param length
55
- * @returns
56
- */ export function makeEncodedBlob(length) {
57
- return Blob.fromFields([
58
- encodeFirstField(length + 1),
59
- ...Array.from({
60
- length: length
61
- }, ()=>Fr.random())
62
- ]);
63
- }
64
- /**
65
- * Make an unencoded blob with the given length
55
+ * Make a blob with random fields.
66
56
  *
67
57
  * This will fail deserialisation in the archiver
68
58
  * @param length
69
59
  * @returns
70
- */ export function makeUnencodedBlob(length) {
60
+ */ export function makeRandomBlob(length) {
71
61
  return Blob.fromFields([
72
62
  ...Array.from({
73
63
  length: length
74
64
  }, ()=>Fr.random())
75
65
  ]);
76
66
  }
77
- export function makeEncodedBlobFields(fields) {
78
- return Blob.fromFields([
79
- encodeFirstField(fields.length + 1),
80
- ...fields
81
- ]);
82
- }
@@ -0,0 +1,17 @@
1
+ export * from './batched_blob.js';
2
+ export * from './circuit_types/index.js';
3
+ export * from './interface.js';
4
+ export * from './sponge_blob.js';
5
+ /**
6
+ * Type definition for the KZG instance returned by Blob.getViemKzgInstance().
7
+ * Contains the cryptographic functions needed for blob commitment and proof generation.
8
+ */
9
+ export interface BlobKzgInstance {
10
+ /** Function to compute KZG commitment from blob data */
11
+ blobToKzgCommitment(blob: Uint8Array): Uint8Array;
12
+ /** Function to compute KZG proof for blob data */
13
+ computeBlobKzgProof(blob: Uint8Array, commitment: Uint8Array): Uint8Array;
14
+ /** Function to compute both blob data cells and their corresponding KZG proofs for EIP7594 */
15
+ computeCellsAndKzgProofs(blob: Uint8Array): [Uint8Array[], Uint8Array[]];
16
+ }
17
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLG1CQUFtQixDQUFDO0FBQ2xDLGNBQWMsMEJBQTBCLENBQUM7QUFDekMsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLGtCQUFrQixDQUFDO0FBRWpDOzs7R0FHRztBQUNILE1BQU0sV0FBVyxlQUFlO0lBQzlCLHdEQUF3RDtJQUN4RCxtQkFBbUIsQ0FBQyxJQUFJLEVBQUUsVUFBVSxHQUFHLFVBQVUsQ0FBQztJQUNsRCxrREFBa0Q7SUFDbEQsbUJBQW1CLENBQUMsSUFBSSxFQUFFLFVBQVUsRUFBRSxVQUFVLEVBQUUsVUFBVSxHQUFHLFVBQVUsQ0FBQztJQUMxRSw4RkFBOEY7SUFDOUYsd0JBQXdCLENBQUMsSUFBSSxFQUFFLFVBQVUsR0FBRyxDQUFDLFVBQVUsRUFBRSxFQUFFLFVBQVUsRUFBRSxDQUFDLENBQUM7Q0FDMUUifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAEjC;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAClD,kDAAkD;IAClD,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;IAC1E,8FAA8F;IAC9F,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;CAC1E"}
package/dest/types.js ADDED
@@ -0,0 +1,4 @@
1
+ export * from './batched_blob.js';
2
+ export * from './circuit_types/index.js';
3
+ export * from './interface.js';
4
+ export * from './sponge_blob.js';
package/package.json CHANGED
@@ -1,9 +1,11 @@
1
1
  {
2
2
  "name": "@aztec/blob-lib",
3
- "version": "4.0.0-nightly.20250907",
3
+ "version": "4.0.0-nightly.20260108",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": "./dest/index.js",
7
+ "./encoding": "./dest/encoding/index.js",
8
+ "./types": "./dest/types.js",
7
9
  "./testing": "./dest/testing.js"
8
10
  },
9
11
  "typedocOptions": {
@@ -14,10 +16,10 @@
14
16
  "tsconfig": "./tsconfig.json"
15
17
  },
16
18
  "scripts": {
17
- "build": "yarn clean && tsc -b",
18
- "build:dev": "tsc -b --watch",
19
+ "build": "yarn clean && ../scripts/tsc.sh",
20
+ "build:dev": "../scripts/tsc.sh --watch",
19
21
  "clean": "rm -rf ./dest .tsbuildinfo",
20
- "start:dev": "tsc-watch -p tsconfig.json --onSuccess 'yarn start'",
22
+ "start:dev": "concurrently -k \"tsgo -b -w\" \"nodemon --watch dest --exec yarn start\"",
21
23
  "start": "node ./dest/index.js",
22
24
  "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}"
23
25
  },
@@ -25,15 +27,16 @@
25
27
  "../package.common.json"
26
28
  ],
27
29
  "dependencies": {
28
- "@aztec/constants": "4.0.0-nightly.20250907",
29
- "@aztec/foundation": "4.0.0-nightly.20250907",
30
- "c-kzg": "4.0.0-alpha.1",
30
+ "@aztec/constants": "4.0.0-nightly.20260108",
31
+ "@aztec/foundation": "4.0.0-nightly.20260108",
32
+ "@crate-crypto/node-eth-kzg": "^0.10.0",
31
33
  "tslib": "^2.4.0"
32
34
  },
33
35
  "devDependencies": {
34
36
  "@jest/globals": "^30.0.0",
35
37
  "@types/jest": "^30.0.0",
36
38
  "@types/node": "^22.15.17",
39
+ "@typescript/native-preview": "7.0.0-dev.20251126.1",
37
40
  "get-port": "^7.1.0",
38
41
  "jest": "^30.0.0",
39
42
  "ts-node": "^10.9.1",
@@ -0,0 +1,26 @@
1
+ import { BLS12Fr, BLS12Point } from '@aztec/foundation/curves/bls12';
2
+ import { Fr } from '@aztec/foundation/curves/bn254';
3
+
4
+ import { FinalBlobAccumulator } from './circuit_types/index.js';
5
+
6
+ /**
7
+ * A class to represent the result from accumulating blobs in an epoch using BatchedBlobAccumulator.
8
+ */
9
+ export class BatchedBlob {
10
+ constructor(
11
+ /** Hash of Cs (to link to L1 blob hashes). */
12
+ public readonly blobCommitmentsHash: Fr,
13
+ /** Challenge point z such that p_i(z) = y_i. */
14
+ public readonly z: Fr,
15
+ /** Evaluation y, linear combination of all evaluations y_i = p_i(z) with gamma. */
16
+ public readonly y: BLS12Fr,
17
+ /** Commitment C, linear combination of all commitments C_i = [p_i] with gamma. */
18
+ public readonly commitment: BLS12Point,
19
+ /** KZG opening 'proof' Q (commitment to the quotient poly.), linear combination of all blob kzg 'proofs' Q_i with gamma. */
20
+ public readonly q: BLS12Point,
21
+ ) {}
22
+
23
+ toFinalBlobAccumulator() {
24
+ return new FinalBlobAccumulator(this.blobCommitmentsHash, this.z, this.y, this.commitment);
25
+ }
26
+ }