@aztec/blob-lib 0.0.0-test.0 → 0.0.1-commit.21caa21

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 (107) hide show
  1. package/dest/batched_blob.d.ts +25 -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 +53 -100
  5. package/dest/blob.d.ts.map +1 -1
  6. package/dest/blob.js +83 -183
  7. package/dest/blob_batching.d.ts +105 -0
  8. package/dest/blob_batching.d.ts.map +1 -0
  9. package/dest/blob_batching.js +223 -0
  10. package/dest/blob_utils.d.ts +39 -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 +22 -0
  14. package/dest/circuit_types/blob_accumulator.d.ts.map +1 -0
  15. package/dest/circuit_types/blob_accumulator.js +61 -0
  16. package/dest/circuit_types/final_blob_accumulator.d.ts +22 -0
  17. package/dest/circuit_types/final_blob_accumulator.d.ts.map +1 -0
  18. package/dest/circuit_types/final_blob_accumulator.js +63 -0
  19. package/dest/circuit_types/final_blob_batching_challenges.d.ts +15 -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 +25 -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 +10 -0
  29. package/dest/encoding/block_end_marker.d.ts.map +1 -0
  30. package/dest/encoding/block_end_marker.js +40 -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 +139 -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 +42 -0
  55. package/dest/hash.d.ts.map +1 -0
  56. package/dest/hash.js +79 -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 +2 -3
  61. package/dest/interface.d.ts.map +1 -1
  62. package/dest/kzg_context.d.ts +4 -0
  63. package/dest/kzg_context.d.ts.map +1 -0
  64. package/dest/kzg_context.js +5 -0
  65. package/dest/sponge_blob.d.ts +13 -17
  66. package/dest/sponge_blob.d.ts.map +1 -1
  67. package/dest/sponge_blob.js +24 -28
  68. package/dest/testing.d.ts +13 -25
  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 +20 -15
  75. package/src/batched_blob.ts +25 -0
  76. package/src/blob.ts +82 -221
  77. package/src/blob_batching.ts +293 -0
  78. package/src/blob_utils.ts +81 -0
  79. package/src/circuit_types/blob_accumulator.ts +95 -0
  80. package/src/circuit_types/final_blob_accumulator.ts +75 -0
  81. package/src/circuit_types/final_blob_batching_challenges.ts +29 -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 +54 -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 +209 -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 +87 -0
  93. package/src/index.ts +6 -20
  94. package/src/interface.ts +1 -4
  95. package/src/kzg_context.ts +5 -0
  96. package/src/sponge_blob.ts +26 -29
  97. package/src/testing.ts +48 -50
  98. package/src/trusted_setup_bit_reversed.json +4100 -0
  99. package/src/types.ts +17 -0
  100. package/dest/blob_public_inputs.d.ts +0 -50
  101. package/dest/blob_public_inputs.d.ts.map +0 -1
  102. package/dest/blob_public_inputs.js +0 -146
  103. package/dest/encoding.d.ts +0 -66
  104. package/dest/encoding.d.ts.map +0 -1
  105. package/dest/encoding.js +0 -113
  106. package/src/blob_public_inputs.ts +0 -157
  107. package/src/encoding.ts +0 -138
@@ -0,0 +1,79 @@
1
+ import { chunk } from '@aztec/foundation/collection';
2
+ import { Fr } from '@aztec/foundation/fields';
3
+ import { FieldReader } from '@aztec/foundation/serialize';
4
+ import { BlobDeserializationError } from '../errors.js';
5
+ import { decodeTxStartMarker, encodeTxStartMarker } from './tx_start_marker.js';
6
+ export function encodeTxBlobData(txBlobData) {
7
+ return [
8
+ encodeTxStartMarker(txBlobData.txStartMarker),
9
+ txBlobData.txHash,
10
+ txBlobData.transactionFee,
11
+ ...txBlobData.noteHashes,
12
+ ...txBlobData.nullifiers,
13
+ ...txBlobData.l2ToL1Msgs,
14
+ ...txBlobData.publicDataWrites.flat(),
15
+ ...txBlobData.privateLogs.map((log)=>[
16
+ new Fr(log.length),
17
+ ...log
18
+ ]).flat(),
19
+ ...txBlobData.publicLogs,
20
+ ...txBlobData.contractClassLog
21
+ ];
22
+ }
23
+ export function decodeTxBlobData(fields) {
24
+ const reader = FieldReader.asReader(fields);
25
+ if (reader.isFinished()) {
26
+ throw new BlobDeserializationError(`Incorrect encoding of blob fields: not enough fields for tx blob data.`);
27
+ }
28
+ const txStartMarker = decodeTxStartMarker(reader.readField());
29
+ const checkRemainingFields = (requiredFields, type)=>{
30
+ if (requiredFields > reader.remainingFields()) {
31
+ throw new BlobDeserializationError(`Incorrect encoding of blob fields: not enough fields for ${type}. Expected ${requiredFields} fields, only ${reader.remainingFields()} remaining.`);
32
+ }
33
+ };
34
+ const numTxEffectFields = txStartMarker.numBlobFields - 1; // -1 because we already read the tx start marker.
35
+ checkRemainingFields(numTxEffectFields, 'tx effect');
36
+ const txHash = reader.readField();
37
+ const transactionFee = reader.readField();
38
+ checkRemainingFields(txStartMarker.numNoteHashes, 'note hashes');
39
+ const noteHashes = reader.readFieldArray(txStartMarker.numNoteHashes);
40
+ checkRemainingFields(txStartMarker.numNullifiers, 'nullifiers');
41
+ const nullifiers = reader.readFieldArray(txStartMarker.numNullifiers);
42
+ checkRemainingFields(txStartMarker.numL2ToL1Msgs, 'l2-to-l1 messages');
43
+ const l2ToL1Msgs = reader.readFieldArray(txStartMarker.numL2ToL1Msgs);
44
+ checkRemainingFields(txStartMarker.numPublicDataWrites * 2, 'public data writes'); // *2 for leaf slot and value
45
+ const publicDataWrites = chunk(reader.readFieldArray(txStartMarker.numPublicDataWrites * 2), 2);
46
+ const privateLogs = Array.from({
47
+ length: txStartMarker.numPrivateLogs
48
+ }, ()=>{
49
+ const length = reader.readU32();
50
+ checkRemainingFields(length, 'private log');
51
+ return reader.readFieldArray(length);
52
+ });
53
+ checkRemainingFields(txStartMarker.publicLogsLength, 'public logs');
54
+ const publicLogs = reader.readFieldArray(txStartMarker.publicLogsLength);
55
+ const contractClassLogBlobDataLength = txStartMarker.contractClassLogLength > 0 ? txStartMarker.contractClassLogLength + 1 : 0; // If the log exists, +1 for the contract address
56
+ checkRemainingFields(contractClassLogBlobDataLength, 'contract class logs');
57
+ const contractClassLog = reader.readFieldArray(contractClassLogBlobDataLength);
58
+ return {
59
+ txStartMarker,
60
+ txHash,
61
+ transactionFee,
62
+ noteHashes,
63
+ nullifiers,
64
+ l2ToL1Msgs,
65
+ publicDataWrites,
66
+ privateLogs,
67
+ publicLogs,
68
+ contractClassLog
69
+ };
70
+ }
71
+ export function getNumTxBlobFields(txStartMarker) {
72
+ return 1 + // tx start marker
73
+ 1 + // tx hash
74
+ 1 + // transaction fee
75
+ txStartMarker.numNoteHashes + txStartMarker.numNullifiers + txStartMarker.numL2ToL1Msgs + txStartMarker.numPublicDataWrites * 2 + // *2 for leaf slot and value per public data write
76
+ txStartMarker.numPrivateLogs + // +1 length field for each private log
77
+ txStartMarker.privateLogsLength + txStartMarker.publicLogsLength + txStartMarker.contractClassLogLength + (txStartMarker.contractClassLogLength > 0 ? 1 : 0 // +1 for contract address of the contract class log
78
+ );
79
+ }
@@ -0,0 +1,16 @@
1
+ import { Fr } from '@aztec/foundation/fields';
2
+ export interface TxStartMarker {
3
+ numBlobFields: number;
4
+ revertCode: number;
5
+ numNoteHashes: number;
6
+ numNullifiers: number;
7
+ numL2ToL1Msgs: number;
8
+ numPublicDataWrites: number;
9
+ numPrivateLogs: number;
10
+ privateLogsLength: number;
11
+ publicLogsLength: number;
12
+ contractClassLogLength: number;
13
+ }
14
+ export declare function encodeTxStartMarker(txStartMarker: TxStartMarker): Fr;
15
+ export declare function decodeTxStartMarker(field: Fr): TxStartMarker;
16
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfc3RhcnRfbWFya2VyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZW5jb2RpbmcvdHhfc3RhcnRfbWFya2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQWlCOUMsTUFBTSxXQUFXLGFBQWE7SUFDNUIsYUFBYSxFQUFFLE1BQU0sQ0FBQztJQUN0QixVQUFVLEVBQUUsTUFBTSxDQUFDO0lBQ25CLGFBQWEsRUFBRSxNQUFNLENBQUM7SUFDdEIsYUFBYSxFQUFFLE1BQU0sQ0FBQztJQUN0QixhQUFhLEVBQUUsTUFBTSxDQUFDO0lBQ3RCLG1CQUFtQixFQUFFLE1BQU0sQ0FBQztJQUM1QixjQUFjLEVBQUUsTUFBTSxDQUFDO0lBQ3ZCLGlCQUFpQixFQUFFLE1BQU0sQ0FBQztJQUMxQixnQkFBZ0IsRUFBRSxNQUFNLENBQUM7SUFDekIsc0JBQXNCLEVBQUUsTUFBTSxDQUFDO0NBQ2hDO0FBRUQsd0JBQWdCLG1CQUFtQixDQUFDLGFBQWEsRUFBRSxhQUFhLEdBQUcsRUFBRSxDQXVCcEU7QUFFRCx3QkFBZ0IsbUJBQW1CLENBQUMsS0FBSyxFQUFFLEVBQUUsR0FBRyxhQUFhLENBd0M1RCJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tx_start_marker.d.ts","sourceRoot":"","sources":["../../src/encoding/tx_start_marker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAiB9C,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,aAAa,GAAG,EAAE,CAuBpE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,EAAE,GAAG,aAAa,CAwC5D"}
@@ -0,0 +1,77 @@
1
+ import { TX_START_PREFIX } from '@aztec/constants';
2
+ import { Fr } from '@aztec/foundation/fields';
3
+ import { BlobDeserializationError } from '../errors.js';
4
+ // Must match the implementation in `noir-protocol-circuits/crates/types/src/blob_data/tx_blob_data.nr`.
5
+ const NUM_BLOB_FIELDS_BIT_SIZE = 32n;
6
+ const REVERT_CODE_BIT_SIZE = 8n;
7
+ const NUM_NOTE_HASH_BIT_SIZE = 16n;
8
+ const NUM_NULLIFIER_BIT_SIZE = 16n;
9
+ const NUM_L2_TO_L1_MSG_BIT_SIZE = 16n;
10
+ const NUM_PUBLIC_DATA_WRITE_BIT_SIZE = 16n;
11
+ const NUM_PRIVATE_LOG_BIT_SIZE = 16n;
12
+ const PRIVATE_LOGS_LENGTH_BIT_SIZE = 16n;
13
+ const PUBLIC_LOGS_LENGTH_BIT_SIZE = 32n;
14
+ const CONTRACT_CLASS_LOG_LENGTH_BIT_SIZE = 16n;
15
+ export function encodeTxStartMarker(txStartMarker) {
16
+ let value = TX_START_PREFIX;
17
+ value <<= NUM_NOTE_HASH_BIT_SIZE;
18
+ value += BigInt(txStartMarker.numNoteHashes);
19
+ value <<= NUM_NULLIFIER_BIT_SIZE;
20
+ value += BigInt(txStartMarker.numNullifiers);
21
+ value <<= NUM_L2_TO_L1_MSG_BIT_SIZE;
22
+ value += BigInt(txStartMarker.numL2ToL1Msgs);
23
+ value <<= NUM_PUBLIC_DATA_WRITE_BIT_SIZE;
24
+ value += BigInt(txStartMarker.numPublicDataWrites);
25
+ value <<= NUM_PRIVATE_LOG_BIT_SIZE;
26
+ value += BigInt(txStartMarker.numPrivateLogs);
27
+ value <<= PRIVATE_LOGS_LENGTH_BIT_SIZE;
28
+ value += BigInt(txStartMarker.privateLogsLength);
29
+ value <<= PUBLIC_LOGS_LENGTH_BIT_SIZE;
30
+ value += BigInt(txStartMarker.publicLogsLength);
31
+ value <<= CONTRACT_CLASS_LOG_LENGTH_BIT_SIZE;
32
+ value += BigInt(txStartMarker.contractClassLogLength);
33
+ value <<= REVERT_CODE_BIT_SIZE;
34
+ value += BigInt(txStartMarker.revertCode);
35
+ value <<= NUM_BLOB_FIELDS_BIT_SIZE;
36
+ value += BigInt(txStartMarker.numBlobFields);
37
+ return new Fr(value);
38
+ }
39
+ export function decodeTxStartMarker(field) {
40
+ let value = field.toBigInt();
41
+ const numBlobFields = Number(value & 2n ** NUM_BLOB_FIELDS_BIT_SIZE - 1n);
42
+ value >>= NUM_BLOB_FIELDS_BIT_SIZE;
43
+ const revertCode = Number(value & 2n ** REVERT_CODE_BIT_SIZE - 1n);
44
+ value >>= REVERT_CODE_BIT_SIZE;
45
+ const contractClassLogLength = Number(value & 2n ** CONTRACT_CLASS_LOG_LENGTH_BIT_SIZE - 1n);
46
+ value >>= CONTRACT_CLASS_LOG_LENGTH_BIT_SIZE;
47
+ const publicLogsLength = Number(value & 2n ** PUBLIC_LOGS_LENGTH_BIT_SIZE - 1n);
48
+ value >>= PUBLIC_LOGS_LENGTH_BIT_SIZE;
49
+ const privateLogsLength = Number(value & 2n ** PRIVATE_LOGS_LENGTH_BIT_SIZE - 1n);
50
+ value >>= PRIVATE_LOGS_LENGTH_BIT_SIZE;
51
+ const numPrivateLogs = Number(value & 2n ** NUM_PRIVATE_LOG_BIT_SIZE - 1n);
52
+ value >>= NUM_PRIVATE_LOG_BIT_SIZE;
53
+ const numPublicDataWrites = Number(value & 2n ** NUM_PUBLIC_DATA_WRITE_BIT_SIZE - 1n);
54
+ value >>= NUM_PUBLIC_DATA_WRITE_BIT_SIZE;
55
+ const numL2ToL1Msgs = Number(value & 2n ** NUM_L2_TO_L1_MSG_BIT_SIZE - 1n);
56
+ value >>= NUM_L2_TO_L1_MSG_BIT_SIZE;
57
+ const numNullifiers = Number(value & 2n ** NUM_NULLIFIER_BIT_SIZE - 1n);
58
+ value >>= NUM_NULLIFIER_BIT_SIZE;
59
+ const numNoteHashes = Number(value & 2n ** NUM_NOTE_HASH_BIT_SIZE - 1n);
60
+ value >>= NUM_NOTE_HASH_BIT_SIZE;
61
+ const prefix = value;
62
+ if (prefix !== TX_START_PREFIX) {
63
+ throw new BlobDeserializationError(`Incorrect encoding of blob fields: invalid tx start marker.`);
64
+ }
65
+ return {
66
+ numBlobFields,
67
+ revertCode,
68
+ numNoteHashes,
69
+ numNullifiers,
70
+ numL2ToL1Msgs,
71
+ numPublicDataWrites,
72
+ numPrivateLogs,
73
+ privateLogsLength,
74
+ publicLogsLength,
75
+ contractClassLogLength
76
+ };
77
+ }
package/dest/errors.d.ts CHANGED
@@ -1,4 +1,4 @@
1
1
  export declare class BlobDeserializationError extends Error {
2
2
  constructor(message: string);
3
3
  }
4
- //# sourceMappingURL=errors.d.ts.map
4
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLHFCQUFhLHdCQUF5QixTQUFRLEtBQUs7SUFDakQsWUFBWSxPQUFPLEVBQUUsTUFBTSxFQUcxQjtDQUNGIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}
package/dest/hash.d.ts ADDED
@@ -0,0 +1,42 @@
1
+ import { BLS12Fr, Fr } from '@aztec/foundation/fields';
2
+ /**
3
+ * Returns ethereum's versioned blob hash, following kzg_to_versioned_hash: https://eips.ethereum.org/EIPS/eip-4844#helpers
4
+ */
5
+ export declare function computeEthVersionedBlobHash(commitment: Buffer): Buffer;
6
+ export declare function computeBlobsHash(evmVersionedBlobHashes: Buffer[]): Fr;
7
+ /**
8
+ * Computes a non-standard Poseidon2 hash over the provided fields.
9
+ *
10
+ * This function is used to compute:
11
+ * - `blobFieldsHash` of a checkpoint:
12
+ * Verified in the circuit against all fields absorbed into the blob sponge over the entire checkpoint.
13
+ * The exact number of fields is encoded in the checkpoint end marker (the last field).
14
+ * This hash is used when generating the challenge `z` for all blobs in the checkpoint.
15
+ * - `spongeBlobHash` of a block:
16
+ * Computed from the block's tx effects, its end-state, and the blob fields of all prior blocks in the same checkpoint.
17
+ * This hash is included in the block header.
18
+ */
19
+ export declare function computeBlobFieldsHash(fields: Fr[]): Promise<Fr>;
20
+ export declare function computeBlobCommitment(data: Uint8Array): Buffer;
21
+ /**
22
+ * Get the commitment fields of the blob, to compute the challenge z.
23
+ *
24
+ * The 48-byte commitment is encoded into two field elements:
25
+ * +-------------------+------------------------+
26
+ * | 31 bytes | 17 bytes |
27
+ * +-------------------+------------------------+
28
+ * | Field Element 1 | Field Element 2 |
29
+ * | [0][bytes 0-30] | [0...0][bytes 31-47] |
30
+ * +-------------------+------------------------+
31
+ *
32
+ * @param commitment - The commitment to convert to fields. Computed from `computeBlobCommitment`.
33
+ * @returns The fields representing the commitment buffer.
34
+ */
35
+ export declare function commitmentToFields(commitment: Buffer): [Fr, Fr];
36
+ export declare function computeChallengeZ(blobFieldsHash: Fr, commitment: Buffer): Promise<Fr>;
37
+ /**
38
+ * Hash each u128 limb of the noir bignum struct representing the BLS field, to mimic the hash accumulation in the
39
+ * rollup circuits.
40
+ */
41
+ export declare function hashNoirBigNumLimbs(field: BLS12Fr): Promise<Fr>;
42
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGFzaC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2hhc2gudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQU92RDs7R0FFRztBQUNILHdCQUFnQiwyQkFBMkIsQ0FBQyxVQUFVLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FJdEU7QUFPRCx3QkFBZ0IsZ0JBQWdCLENBQUMsc0JBQXNCLEVBQUUsTUFBTSxFQUFFLEdBQUcsRUFBRSxDQUVyRTtBQUVEOzs7Ozs7Ozs7OztHQVdHO0FBQ0gsd0JBQXNCLHFCQUFxQixDQUFDLE1BQU0sRUFBRSxFQUFFLEVBQUUsR0FBRyxPQUFPLENBQUMsRUFBRSxDQUFDLENBSXJFO0FBRUQsd0JBQWdCLHFCQUFxQixDQUFDLElBQUksRUFBRSxVQUFVLEdBQUcsTUFBTSxDQU05RDtBQUVEOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCx3QkFBZ0Isa0JBQWtCLENBQUMsVUFBVSxFQUFFLE1BQU0sR0FBRyxDQUFDLEVBQUUsRUFBRSxFQUFFLENBQUMsQ0FNL0Q7QUFFRCx3QkFBc0IsaUJBQWlCLENBQUMsY0FBYyxFQUFFLEVBQUUsRUFBRSxVQUFVLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxFQUFFLENBQUMsQ0FHM0Y7QUFFRDs7O0dBR0c7QUFDSCx3QkFBc0IsbUJBQW1CLENBQUMsS0FBSyxFQUFFLE9BQU8sR0FBRyxPQUFPLENBQUMsRUFBRSxDQUFDLENBR3JFIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAOvD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAItE;AAOD,wBAAgB,gBAAgB,CAAC,sBAAsB,EAAE,MAAM,EAAE,GAAG,EAAE,CAErE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAIrE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAM9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAM/D;AAED,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,CAG3F;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAGrE"}
package/dest/hash.js ADDED
@@ -0,0 +1,79 @@
1
+ import { poseidon2Hash, sha256, sha256ToField } from '@aztec/foundation/crypto';
2
+ import { Fr } from '@aztec/foundation/fields';
3
+ import { BYTES_PER_BLOB, BYTES_PER_COMMITMENT, kzg } from './kzg_context.js';
4
+ import { SpongeBlob } from './sponge_blob.js';
5
+ const VERSIONED_HASH_VERSION_KZG = 0x01;
6
+ /**
7
+ * Returns ethereum's versioned blob hash, following kzg_to_versioned_hash: https://eips.ethereum.org/EIPS/eip-4844#helpers
8
+ */ export function computeEthVersionedBlobHash(commitment) {
9
+ const hash = sha256(commitment);
10
+ hash[0] = VERSIONED_HASH_VERSION_KZG;
11
+ return hash;
12
+ }
13
+ // TODO(#13430): The blobsHash is confusingly similar to blobCommitmentsHash, calculated from below blobCommitments:
14
+ // - 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.
15
+ // - 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()),
16
+ // exists so we can validate injected commitments to the rollup circuits correspond to the correct real blobs.
17
+ // 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.
18
+ export function computeBlobsHash(evmVersionedBlobHashes) {
19
+ return sha256ToField(evmVersionedBlobHashes);
20
+ }
21
+ /**
22
+ * Computes a non-standard Poseidon2 hash over the provided fields.
23
+ *
24
+ * This function is used to compute:
25
+ * - `blobFieldsHash` of a checkpoint:
26
+ * Verified in the circuit against all fields absorbed into the blob sponge over the entire checkpoint.
27
+ * The exact number of fields is encoded in the checkpoint end marker (the last field).
28
+ * This hash is used when generating the challenge `z` for all blobs in the checkpoint.
29
+ * - `spongeBlobHash` of a block:
30
+ * Computed from the block's tx effects, its end-state, and the blob fields of all prior blocks in the same checkpoint.
31
+ * This hash is included in the block header.
32
+ */ export async function computeBlobFieldsHash(fields) {
33
+ const sponge = SpongeBlob.init();
34
+ await sponge.absorb(fields);
35
+ return sponge.squeeze();
36
+ }
37
+ export function computeBlobCommitment(data) {
38
+ if (data.length !== BYTES_PER_BLOB) {
39
+ throw new Error(`Expected ${BYTES_PER_BLOB} bytes per blob. Got ${data.length}.`);
40
+ }
41
+ return Buffer.from(kzg.blobToKzgCommitment(data));
42
+ }
43
+ /**
44
+ * Get the commitment fields of the blob, to compute the challenge z.
45
+ *
46
+ * The 48-byte commitment is encoded into two field elements:
47
+ * +-------------------+------------------------+
48
+ * | 31 bytes | 17 bytes |
49
+ * +-------------------+------------------------+
50
+ * | Field Element 1 | Field Element 2 |
51
+ * | [0][bytes 0-30] | [0...0][bytes 31-47] |
52
+ * +-------------------+------------------------+
53
+ *
54
+ * @param commitment - The commitment to convert to fields. Computed from `computeBlobCommitment`.
55
+ * @returns The fields representing the commitment buffer.
56
+ */ export function commitmentToFields(commitment) {
57
+ if (commitment.length !== BYTES_PER_COMMITMENT) {
58
+ throw new Error(`Expected ${BYTES_PER_COMMITMENT} bytes for blob commitment. Got ${commitment.length}.`);
59
+ }
60
+ return [
61
+ new Fr(commitment.subarray(0, 31)),
62
+ new Fr(commitment.subarray(31, BYTES_PER_COMMITMENT))
63
+ ];
64
+ }
65
+ export async function computeChallengeZ(blobFieldsHash, commitment) {
66
+ const commitmentFields = commitmentToFields(commitment);
67
+ return await poseidon2Hash([
68
+ blobFieldsHash,
69
+ commitmentFields[0],
70
+ commitmentFields[1]
71
+ ]);
72
+ }
73
+ /**
74
+ * Hash each u128 limb of the noir bignum struct representing the BLS field, to mimic the hash accumulation in the
75
+ * rollup circuits.
76
+ */ export async function hashNoirBigNumLimbs(field) {
77
+ const num = field.toNoirBigNum();
78
+ return await poseidon2Hash(num.limbs.map(Fr.fromHexString));
79
+ }
package/dest/index.d.ts CHANGED
@@ -1,7 +1,10 @@
1
+ export * from './batched_blob.js';
1
2
  export * from './blob.js';
2
- export * from './encoding.js';
3
+ export * from './blob_batching.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';
3
8
  export * from './interface.js';
4
- export * from './errors.js';
5
- export * from './blob_public_inputs.js';
6
9
  export * from './sponge_blob.js';
7
- //# sourceMappingURL=index.d.ts.map
10
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLG1CQUFtQixDQUFDO0FBQ2xDLGNBQWMsV0FBVyxDQUFDO0FBQzFCLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxXQUFXLENBQUM7QUFDMUIsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLGtCQUFrQixDQUFDIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,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"}
package/dest/index.js CHANGED
@@ -1,19 +1,9 @@
1
- import cKzg from 'c-kzg';
2
- /* eslint-disable import/no-named-as-default-member */ const { loadTrustedSetup } = cKzg;
1
+ export * from './batched_blob.js';
3
2
  export * from './blob.js';
4
- export * from './encoding.js';
3
+ export * from './blob_batching.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';
5
8
  export * from './interface.js';
6
- export * from './errors.js';
7
- export * from './blob_public_inputs.js';
8
9
  export * from './sponge_blob.js';
9
- try {
10
- loadTrustedSetup();
11
- } catch (error) {
12
- if (error.message.includes('trusted setup is already loaded')) {
13
- // NB: The c-kzg lib has no way of checking whether the setup is loaded or not,
14
- // and it throws an error if it's already loaded, even though nothing is wrong.
15
- // This is a rudimentary way of ensuring we load the trusted setup if we need it.
16
- } else {
17
- throw new Error(error);
18
- }
19
- }
@@ -3,8 +3,7 @@
3
3
  */
4
4
  export interface BlobJson {
5
5
  blob: string;
6
- index?: number;
6
+ index: string;
7
7
  kzg_commitment: string;
8
- kzg_proof: string;
9
8
  }
10
- //# sourceMappingURL=interface.d.ts.map
9
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW50ZXJmYWNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxXQUFXLFFBQVE7SUFDdkIsSUFBSSxFQUFFLE1BQU0sQ0FBQztJQUNiLEtBQUssRUFBRSxNQUFNLENBQUM7SUFDZCxjQUFjLEVBQUUsTUFBTSxDQUFDO0NBQ3hCIn0=
@@ -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,CAAC,EAAE,MAAM,CAAC;IAEf,cAAc,EAAE,MAAM,CAAC;IAEvB,SAAS,EAAE,MAAM,CAAC;CACnB"}
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"}
@@ -0,0 +1,4 @@
1
+ import { DasContextJs } from '@crate-crypto/node-eth-kzg';
2
+ export * from '@crate-crypto/node-eth-kzg';
3
+ export declare const kzg: DasContextJs;
4
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoia3pnX2NvbnRleHQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9remdfY29udGV4dC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFFMUQsY0FBYyw0QkFBNEIsQ0FBQztBQUUzQyxlQUFPLE1BQU0sR0FBRyxjQUE0QyxDQUFDIn0=
@@ -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;AAE3C,eAAO,MAAM,GAAG,cAA4C,CAAC"}
@@ -0,0 +1,5 @@
1
+ import { DasContextJs } from '@crate-crypto/node-eth-kzg';
2
+ export * from '@crate-crypto/node-eth-kzg';
3
+ export const kzg = DasContextJs.create({
4
+ usePrecomp: true
5
+ });
@@ -1,28 +1,25 @@
1
- /// <reference types="node" resolution-mode="require"/>
2
- /// <reference types="node" resolution-mode="require"/>
3
1
  import { type FieldsOf } from '@aztec/foundation/array';
4
2
  import { Fr } from '@aztec/foundation/fields';
5
3
  import { BufferReader, FieldReader, type Tuple } from '@aztec/foundation/serialize';
6
4
  /**
7
- * 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.
8
6
  * See noir-projects/noir-protocol-circuits/crates/types/src/abis/sponge_blob.nr.
9
7
  */
10
8
  export declare class SpongeBlob {
11
- /** Sponge with absorbed tx effects that will go into a blob. */
12
9
  readonly sponge: Poseidon2Sponge;
13
- /** Number of effects absorbed so far. */
14
- fields: number;
15
- /** Number of effects that will be absorbed. */
16
- readonly expectedFields: number;
10
+ numAbsorbedFields: number;
11
+ static MAX_FIELDS: number;
17
12
  constructor(
18
- /** Sponge with absorbed tx effects that will go into a blob. */
13
+ /** Sponge with absorbed fields that will go into one or more blobs. */
19
14
  sponge: Poseidon2Sponge,
20
15
  /** Number of effects absorbed so far. */
21
- fields: number,
22
- /** Number of effects that will be absorbed. */
23
- expectedFields: number);
16
+ numAbsorbedFields: number);
17
+ /**
18
+ * Initialize the sponge blob to absorb data for a checkpoint.
19
+ */
20
+ static init(): SpongeBlob;
24
21
  static fromBuffer(buffer: Buffer | BufferReader): SpongeBlob;
25
- toBuffer(): Buffer;
22
+ toBuffer(): Buffer<ArrayBufferLike>;
26
23
  static getFields(fields: FieldsOf<SpongeBlob>): (number | Poseidon2Sponge)[];
27
24
  toFields(): Fr[];
28
25
  static fromFields(fields: Fr[] | FieldReader): SpongeBlob;
@@ -30,7 +27,6 @@ export declare class SpongeBlob {
30
27
  absorb(fields: Fr[]): Promise<void>;
31
28
  squeeze(): Promise<Fr>;
32
29
  static empty(): SpongeBlob;
33
- static init(expectedFields: number): SpongeBlob;
34
30
  }
35
31
  export declare class Poseidon2Sponge {
36
32
  cache: Tuple<Fr, 3>;
@@ -39,14 +35,14 @@ export declare class Poseidon2Sponge {
39
35
  squeezeMode: boolean;
40
36
  constructor(cache: Tuple<Fr, 3>, state: Tuple<Fr, 4>, cacheSize: number, squeezeMode: boolean);
41
37
  static fromBuffer(buffer: Buffer | BufferReader): Poseidon2Sponge;
42
- toBuffer(): Buffer;
38
+ toBuffer(): Buffer<ArrayBufferLike>;
43
39
  static getFields(fields: FieldsOf<Poseidon2Sponge>): (number | boolean | [Fr, Fr, Fr] | [Fr, Fr, Fr, Fr])[];
44
40
  toFields(): Fr[];
45
41
  static fromFields(fields: Fr[] | FieldReader): Poseidon2Sponge;
46
42
  static empty(): Poseidon2Sponge;
47
- static init(expectedFields: number): Poseidon2Sponge;
43
+ static init(iv: Fr): Poseidon2Sponge;
48
44
  performDuplex(): Promise<void>;
49
45
  absorb(fields: Fr[]): Promise<void>;
50
46
  squeeze(): Promise<Fr>;
51
47
  }
52
- //# sourceMappingURL=sponge_blob.d.ts.map
48
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3BvbmdlX2Jsb2IuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9zcG9uZ2VfYmxvYi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsS0FBSyxRQUFRLEVBQWEsTUFBTSx5QkFBeUIsQ0FBQztBQUVuRSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDOUMsT0FBTyxFQUNMLFlBQVksRUFDWixXQUFXLEVBQ1gsS0FBSyxLQUFLLEVBR1gsTUFBTSw2QkFBNkIsQ0FBQztBQUVyQzs7O0dBR0c7QUFDSCxxQkFBYSxVQUFVO2FBS0gsTUFBTSxFQUFFLGVBQWU7SUFFaEMsaUJBQWlCLEVBQUUsTUFBTTtJQU5sQyxNQUFNLENBQUMsVUFBVSxTQUEwQztJQUUzRDtJQUNFLHVFQUF1RTtJQUN2RCxNQUFNLEVBQUUsZUFBZTtJQUN2Qyx5Q0FBeUM7SUFDbEMsaUJBQWlCLEVBQUUsTUFBTSxFQUM5QjtJQUVKOztPQUVHO0lBQ0gsTUFBTSxDQUFDLElBQUksSUFBSSxVQUFVLENBS3hCO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksR0FBRyxVQUFVLENBRzNEO0lBRUQsUUFBUSw0QkFFUDtJQUVELE1BQU0sQ0FBQyxTQUFTLENBQUMsTUFBTSxFQUFFLFFBQVEsQ0FBQyxVQUFVLENBQUMsZ0NBRTVDO0lBRUQsUUFBUSxJQUFJLEVBQUUsRUFBRSxDQUVmO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsRUFBRSxFQUFFLEdBQUcsV0FBVyxHQUFHLFVBQVUsQ0FHeEQ7SUFFRCxLQUFLLGVBRUo7SUFFSyxNQUFNLENBQUMsTUFBTSxFQUFFLEVBQUUsRUFBRSxpQkFReEI7SUFFSyxPQUFPLElBQUksT0FBTyxDQUFDLEVBQUUsQ0FBQyxDQUUzQjtJQUVELE1BQU0sQ0FBQyxLQUFLLElBQUksVUFBVSxDQUV6QjtDQUNGO0FBR0QscUJBQWEsZUFBZTtJQUVqQixLQUFLLEVBQUUsS0FBSyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDbkIsS0FBSyxFQUFFLEtBQUssQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDO0lBQ25CLFNBQVMsRUFBRSxNQUFNO0lBQ2pCLFdBQVcsRUFBRSxPQUFPO0lBSjdCLFlBQ1MsS0FBSyxFQUFFLEtBQUssQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLEVBQ25CLEtBQUssRUFBRSxLQUFLLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxFQUNuQixTQUFTLEVBQUUsTUFBTSxFQUNqQixXQUFXLEVBQUUsT0FBTyxFQUN6QjtJQUVKLE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLEdBQUcsZUFBZSxDQVFoRTtJQUVELFFBQVEsNEJBRVA7SUFFRCxNQUFNLENBQUMsU0FBUyxDQUFDLE1BQU0sRUFBRSxRQUFRLENBQUMsZUFBZSxDQUFDLDBEQUVqRDtJQUVELFFBQVEsSUFBSSxFQUFFLEVBQUUsQ0FFZjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLEVBQUUsRUFBRSxHQUFHLFdBQVcsR0FBRyxlQUFlLENBUTdEO0lBRUQsTUFBTSxDQUFDLEtBQUssSUFBSSxlQUFlLENBTzlCO0lBRUQsTUFBTSxDQUFDLElBQUksQ0FBQyxFQUFFLEVBQUUsRUFBRSxHQUFHLGVBQWUsQ0FJbkM7SUFLSyxhQUFhLGtCQVNsQjtJQUVLLE1BQU0sQ0FBQyxNQUFNLEVBQUUsRUFBRSxFQUFFLGlCQWF4QjtJQUVLLE9BQU8sSUFBSSxPQUFPLENBQUMsRUFBRSxDQUFDLENBTzNCO0NBQ0YifQ==
@@ -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,0BAA0B,CAAC;AAC9C,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
3
  import { poseidon2Permutation } from '@aztec/foundation/crypto';
3
4
  import { Fr } from '@aztec/foundation/fields';
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,7 +1,9 @@
1
- import { Fr } from '@aztec/foundation/fields';
2
1
  import { Blob } from './blob.js';
3
- import { BlobPublicInputs, BlockBlobPublicInputs } from './blob_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';
4
5
  import { SpongeBlob } from './sponge_blob.js';
6
+ export * from './encoding/fixtures.js';
5
7
  /**
6
8
  * Makes arbitrary poseidon sponge for blob inputs.
7
9
  * Note: will not verify inside the circuit.
@@ -10,34 +12,20 @@ import { SpongeBlob } from './sponge_blob.js';
10
12
  */
11
13
  export declare function makeSpongeBlob(seed?: number): SpongeBlob;
12
14
  /**
13
- * Makes arbitrary blob public inputs.
15
+ * Makes arbitrary blob public accumulator.
14
16
  * Note: will not verify inside the circuit.
15
- * @param seed - The seed to use for generating the blob inputs.
16
- * @returns A blob public inputs instance.
17
+ * @param seed - The seed to use for generating the blob accumulator.
18
+ * @returns A blob accumulator instance.
17
19
  */
18
- export declare function makeBlobPublicInputs(seed?: number): BlobPublicInputs;
20
+ export declare function makeBlobAccumulator(seed?: number): BlobAccumulator;
21
+ export declare function makeFinalBlobAccumulator(seed?: number): FinalBlobAccumulator;
22
+ export declare function makeFinalBlobBatchingChallenges(seed?: number): FinalBlobBatchingChallenges;
19
23
  /**
20
- * Makes arbitrary block blob public inputs.
21
- * Note: will not verify inside the circuit.
22
- * @param seed - The seed to use for generating the blob inputs.
23
- * @returns A block blob public inputs instance.
24
- */
25
- export declare function makeBlockBlobPublicInputs(seed?: number): BlockBlobPublicInputs;
26
- /**
27
- * Make an encoded blob with the given length
28
- *
29
- * This will deserialise correctly in the archiver
30
- * @param length
31
- * @returns
32
- */
33
- export declare function makeEncodedBlob(length: number): Promise<Blob>;
34
- /**
35
- * Make an unencoded blob with the given length
24
+ * Make a blob with random fields.
36
25
  *
37
26
  * This will fail deserialisation in the archiver
38
27
  * @param length
39
28
  * @returns
40
29
  */
41
- export declare function makeUnencodedBlob(length: number): Promise<Blob>;
42
- export declare function makeEncodedBlobFields(fields: Fr[]): Promise<Blob>;
43
- //# sourceMappingURL=testing.d.ts.map
30
+ export declare function makeRandomBlob(length: number): Blob;
31
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdGluZy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3Rlc3RpbmcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUNqQyxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFDdEUsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sMkNBQTJDLENBQUM7QUFDakYsT0FBTyxFQUFFLDJCQUEyQixFQUFFLE1BQU0sbURBQW1ELENBQUM7QUFDaEcsT0FBTyxFQUFtQixVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUUvRCxjQUFjLHdCQUF3QixDQUFDO0FBRXZDOzs7OztHQUtHO0FBQ0gsd0JBQWdCLGNBQWMsQ0FBQyxJQUFJLFNBQUksR0FBRyxVQUFVLENBVW5EO0FBMEJEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLElBQUksU0FBSSxHQUFHLGVBQWUsQ0FTN0Q7QUFFRCx3QkFBZ0Isd0JBQXdCLENBQUMsSUFBSSxTQUFJLHdCQU9oRDtBQUVELHdCQUFnQiwrQkFBK0IsQ0FBQyxJQUFJLFNBQUksK0JBRXZEO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsd0JBQWdCLGNBQWMsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLElBQUksQ0FFbkQifQ==