@aztec/stdlib 0.0.1-commit.4ad48494d → 0.0.1-commit.4eabbdb

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 (180) hide show
  1. package/dest/auth_witness/auth_witness.js +3 -3
  2. package/dest/block/block_data.d.ts +52 -0
  3. package/dest/block/block_data.d.ts.map +1 -0
  4. package/dest/block/block_data.js +12 -0
  5. package/dest/block/index.d.ts +2 -1
  6. package/dest/block/index.d.ts.map +1 -1
  7. package/dest/block/index.js +1 -0
  8. package/dest/block/l2_block_source.d.ts +20 -1
  9. package/dest/block/l2_block_source.d.ts.map +1 -1
  10. package/dest/checkpoint/checkpoint.d.ts +21 -7
  11. package/dest/checkpoint/checkpoint.d.ts.map +1 -1
  12. package/dest/checkpoint/checkpoint.js +24 -13
  13. package/dest/checkpoint/checkpoint_data.d.ts +120 -0
  14. package/dest/checkpoint/checkpoint_data.d.ts.map +1 -0
  15. package/dest/checkpoint/checkpoint_data.js +26 -0
  16. package/dest/checkpoint/index.d.ts +2 -1
  17. package/dest/checkpoint/index.d.ts.map +1 -1
  18. package/dest/checkpoint/index.js +1 -0
  19. package/dest/checkpoint/published_checkpoint.d.ts +17 -2
  20. package/dest/checkpoint/published_checkpoint.d.ts.map +1 -1
  21. package/dest/checkpoint/published_checkpoint.js +1 -2
  22. package/dest/config/sequencer-config.d.ts +2 -2
  23. package/dest/config/sequencer-config.d.ts.map +1 -1
  24. package/dest/config/sequencer-config.js +6 -0
  25. package/dest/contract/contract_address.js +4 -4
  26. package/dest/contract/contract_class_id.d.ts +1 -1
  27. package/dest/contract/contract_class_id.d.ts.map +1 -1
  28. package/dest/contract/contract_class_id.js +5 -4
  29. package/dest/contract/private_function.js +2 -2
  30. package/dest/file-store/local.d.ts +3 -3
  31. package/dest/file-store/local.d.ts.map +1 -1
  32. package/dest/file-store/local.js +13 -4
  33. package/dest/file-store/s3.d.ts +1 -1
  34. package/dest/file-store/s3.d.ts.map +1 -1
  35. package/dest/file-store/s3.js +11 -3
  36. package/dest/hash/hash.js +11 -11
  37. package/dest/hash/map_slot.js +2 -2
  38. package/dest/interfaces/archiver.d.ts +1 -1
  39. package/dest/interfaces/archiver.d.ts.map +1 -1
  40. package/dest/interfaces/archiver.js +5 -0
  41. package/dest/interfaces/aztec-node-admin.d.ts +30 -2
  42. package/dest/interfaces/aztec-node-admin.d.ts.map +1 -1
  43. package/dest/interfaces/aztec-node-admin.js +9 -3
  44. package/dest/interfaces/aztec-node.d.ts +1 -1
  45. package/dest/interfaces/block-builder.d.ts +2 -2
  46. package/dest/interfaces/block-builder.d.ts.map +1 -1
  47. package/dest/interfaces/configs.d.ts +17 -2
  48. package/dest/interfaces/configs.d.ts.map +1 -1
  49. package/dest/interfaces/configs.js +4 -1
  50. package/dest/interfaces/merkle_tree_operations.d.ts +2 -2
  51. package/dest/interfaces/merkle_tree_operations.d.ts.map +1 -1
  52. package/dest/interfaces/proving-job.d.ts +2 -2
  53. package/dest/interfaces/validator.d.ts +2 -2
  54. package/dest/interfaces/validator.d.ts.map +1 -1
  55. package/dest/kernel/hints/index.d.ts +2 -2
  56. package/dest/kernel/hints/index.js +2 -2
  57. package/dest/kernel/hints/key_validation_request_and_separator.d.ts +24 -0
  58. package/dest/kernel/hints/key_validation_request_and_separator.d.ts.map +1 -0
  59. package/dest/kernel/hints/{key_validation_request_and_generator.js → key_validation_request_and_separator.js} +12 -15
  60. package/dest/kernel/hints/{scoped_key_validation_request_and_generator.d.ts → scoped_key_validation_request_and_separator.d.ts} +8 -8
  61. package/dest/kernel/hints/{scoped_key_validation_request_and_generator.d.ts.map → scoped_key_validation_request_and_separator.d.ts.map} +1 -1
  62. package/dest/kernel/hints/{scoped_key_validation_request_and_generator.js → scoped_key_validation_request_and_separator.js} +6 -6
  63. package/dest/kernel/private_circuit_public_inputs.d.ts +9 -9
  64. package/dest/kernel/private_circuit_public_inputs.d.ts.map +1 -1
  65. package/dest/kernel/private_circuit_public_inputs.js +16 -16
  66. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts +3 -3
  67. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts.map +1 -1
  68. package/dest/kernel/private_kernel_circuit_public_inputs.js +4 -4
  69. package/dest/kernel/private_kernel_tail_circuit_private_inputs.d.ts +3 -3
  70. package/dest/kernel/private_kernel_tail_circuit_private_inputs.d.ts.map +1 -1
  71. package/dest/kernel/private_kernel_tail_circuit_private_inputs.js +4 -4
  72. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts +3 -3
  73. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts.map +1 -1
  74. package/dest/kernel/private_kernel_tail_circuit_public_inputs.js +7 -7
  75. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.d.ts +3 -3
  76. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.d.ts.map +1 -1
  77. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.js +7 -7
  78. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.d.ts +3 -3
  79. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.d.ts.map +1 -1
  80. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.js +7 -7
  81. package/dest/kernel/private_validation_requests.d.ts +3 -3
  82. package/dest/kernel/private_validation_requests.js +9 -9
  83. package/dest/keys/derivation.js +8 -8
  84. package/dest/keys/key_types.d.ts +3 -3
  85. package/dest/keys/key_types.d.ts.map +1 -1
  86. package/dest/keys/public_keys.js +2 -2
  87. package/dest/keys/utils.js +5 -5
  88. package/dest/logs/private_log.d.ts +2 -2
  89. package/dest/logs/private_log.d.ts.map +1 -1
  90. package/dest/note/index.d.ts +1 -2
  91. package/dest/note/index.d.ts.map +1 -1
  92. package/dest/note/index.js +0 -1
  93. package/dest/p2p/block_proposal.d.ts +1 -1
  94. package/dest/p2p/block_proposal.d.ts.map +1 -1
  95. package/dest/p2p/block_proposal.js +1 -3
  96. package/dest/p2p/checkpoint_attestation.d.ts +2 -1
  97. package/dest/p2p/checkpoint_attestation.d.ts.map +1 -1
  98. package/dest/p2p/checkpoint_attestation.js +1 -1
  99. package/dest/p2p/checkpoint_proposal.d.ts +10 -5
  100. package/dest/p2p/checkpoint_proposal.d.ts.map +1 -1
  101. package/dest/p2p/checkpoint_proposal.js +20 -15
  102. package/dest/p2p/consensus_payload.d.ts +12 -3
  103. package/dest/p2p/consensus_payload.d.ts.map +1 -1
  104. package/dest/p2p/consensus_payload.js +22 -15
  105. package/dest/rollup/checkpoint_header.d.ts +2 -2
  106. package/dest/rollup/checkpoint_header.js +2 -2
  107. package/dest/tests/factories.js +11 -11
  108. package/dest/tests/mocks.d.ts +4 -1
  109. package/dest/tests/mocks.d.ts.map +1 -1
  110. package/dest/tests/mocks.js +14 -9
  111. package/dest/tx/block_header.js +2 -2
  112. package/dest/tx/global_variables.d.ts +4 -4
  113. package/dest/tx/global_variables.d.ts.map +1 -1
  114. package/dest/tx/profiling.d.ts +4 -4
  115. package/dest/tx/profiling.d.ts.map +1 -1
  116. package/dest/tx/profiling.js +3 -3
  117. package/dest/tx/protocol_contracts.d.ts +1 -1
  118. package/dest/tx/protocol_contracts.d.ts.map +1 -1
  119. package/dest/tx/protocol_contracts.js +2 -2
  120. package/dest/tx/tx_request.js +2 -2
  121. package/dest/tx/validator/error_texts.d.ts +1 -1
  122. package/dest/tx/validator/error_texts.js +1 -1
  123. package/package.json +9 -9
  124. package/src/auth_witness/auth_witness.ts +3 -3
  125. package/src/block/block_data.ts +26 -0
  126. package/src/block/index.ts +1 -0
  127. package/src/block/l2_block_source.ts +22 -0
  128. package/src/checkpoint/checkpoint.ts +32 -14
  129. package/src/checkpoint/checkpoint_data.ts +51 -0
  130. package/src/checkpoint/index.ts +1 -0
  131. package/src/checkpoint/published_checkpoint.ts +3 -1
  132. package/src/config/sequencer-config.ts +11 -1
  133. package/src/contract/contract_address.ts +4 -4
  134. package/src/contract/contract_class_id.ts +5 -4
  135. package/src/contract/private_function.ts +2 -2
  136. package/src/file-store/local.ts +15 -5
  137. package/src/file-store/s3.ts +12 -3
  138. package/src/hash/hash.ts +11 -11
  139. package/src/hash/map_slot.ts +2 -2
  140. package/src/interfaces/archiver.ts +5 -0
  141. package/src/interfaces/aztec-node-admin.ts +23 -0
  142. package/src/interfaces/aztec-node.ts +1 -1
  143. package/src/interfaces/block-builder.ts +1 -0
  144. package/src/interfaces/configs.ts +12 -1
  145. package/src/interfaces/merkle_tree_operations.ts +1 -1
  146. package/src/interfaces/validator.ts +1 -0
  147. package/src/kernel/hints/index.ts +2 -2
  148. package/src/kernel/hints/{key_validation_request_and_generator.ts → key_validation_request_and_separator.ts} +12 -15
  149. package/src/kernel/hints/{scoped_key_validation_request_and_generator.ts → scoped_key_validation_request_and_separator.ts} +10 -10
  150. package/src/kernel/private_circuit_public_inputs.ts +14 -14
  151. package/src/kernel/private_kernel_circuit_public_inputs.ts +2 -2
  152. package/src/kernel/private_kernel_tail_circuit_private_inputs.ts +2 -2
  153. package/src/kernel/private_kernel_tail_circuit_public_inputs.ts +5 -5
  154. package/src/kernel/private_to_public_kernel_circuit_public_inputs.ts +5 -5
  155. package/src/kernel/private_to_rollup_kernel_circuit_public_inputs.ts +5 -5
  156. package/src/kernel/private_validation_requests.ts +8 -8
  157. package/src/keys/derivation.ts +8 -8
  158. package/src/keys/key_types.ts +6 -2
  159. package/src/keys/public_keys.ts +2 -2
  160. package/src/keys/utils.ts +5 -5
  161. package/src/note/index.ts +0 -1
  162. package/src/p2p/block_proposal.ts +0 -2
  163. package/src/p2p/checkpoint_attestation.ts +6 -1
  164. package/src/p2p/checkpoint_proposal.ts +35 -13
  165. package/src/p2p/consensus_payload.ts +25 -12
  166. package/src/rollup/checkpoint_header.ts +2 -2
  167. package/src/tests/factories.ts +12 -12
  168. package/src/tests/mocks.ts +21 -10
  169. package/src/tx/block_header.ts +2 -2
  170. package/src/tx/global_variables.ts +3 -3
  171. package/src/tx/profiling.ts +5 -5
  172. package/src/tx/protocol_contracts.ts +2 -2
  173. package/src/tx/tx_request.ts +2 -2
  174. package/src/tx/validator/error_texts.ts +1 -1
  175. package/dest/kernel/hints/key_validation_request_and_generator.d.ts +0 -30
  176. package/dest/kernel/hints/key_validation_request_and_generator.d.ts.map +0 -1
  177. package/dest/note/notes_filter.d.ts +0 -30
  178. package/dest/note/notes_filter.d.ts.map +0 -1
  179. package/dest/note/notes_filter.js +0 -11
  180. package/src/note/notes_filter.ts +0 -41
@@ -1,4 +1,4 @@
1
- import { GeneratorIndex } from '@aztec/constants';
1
+ import { DomainSeparator } from '@aztec/constants';
2
2
  import { poseidon2HashWithSeparator } from '@aztec/foundation/crypto/poseidon';
3
3
  import { Fr } from '@aztec/foundation/curves/bn254';
4
4
  import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
@@ -61,7 +61,7 @@ export class AuthWitness {
61
61
  * @returns The inner hash for the witness
62
62
  */
63
63
  export const computeInnerAuthWitHash = (args: Fr[]) => {
64
- return poseidon2HashWithSeparator(args, GeneratorIndex.AUTHWIT_INNER);
64
+ return poseidon2HashWithSeparator(args, DomainSeparator.AUTHWIT_INNER);
65
65
  };
66
66
 
67
67
  /**
@@ -77,5 +77,5 @@ export const computeInnerAuthWitHash = (args: Fr[]) => {
77
77
  * @returns The outer hash for the witness
78
78
  */
79
79
  export const computeOuterAuthWitHash = (consumer: AztecAddress, chainId: Fr, version: Fr, innerHash: Fr) => {
80
- return poseidon2HashWithSeparator([consumer.toField(), chainId, version, innerHash], GeneratorIndex.AUTHWIT_OUTER);
80
+ return poseidon2HashWithSeparator([consumer.toField(), chainId, version, innerHash], DomainSeparator.AUTHWIT_OUTER);
81
81
  };
@@ -0,0 +1,26 @@
1
+ import { CheckpointNumberSchema, IndexWithinCheckpointSchema } from '@aztec/foundation/branded-types';
2
+ import type { CheckpointNumber, IndexWithinCheckpoint } from '@aztec/foundation/branded-types';
3
+ import type { Fr } from '@aztec/foundation/curves/bn254';
4
+ import { schemas } from '@aztec/foundation/schemas';
5
+
6
+ import { z } from 'zod';
7
+
8
+ import { AppendOnlyTreeSnapshot } from '../trees/append_only_tree_snapshot.js';
9
+ import { BlockHeader } from '../tx/block_header.js';
10
+
11
+ /** L2Block metadata. Equivalent to L2Block but without block body containing tx data. */
12
+ export type BlockData = {
13
+ header: BlockHeader;
14
+ archive: AppendOnlyTreeSnapshot;
15
+ blockHash: Fr;
16
+ checkpointNumber: CheckpointNumber;
17
+ indexWithinCheckpoint: IndexWithinCheckpoint;
18
+ };
19
+
20
+ export const BlockDataSchema = z.object({
21
+ header: BlockHeader.schema,
22
+ archive: AppendOnlyTreeSnapshot.schema,
23
+ blockHash: schemas.Fr,
24
+ checkpointNumber: CheckpointNumberSchema,
25
+ indexWithinCheckpoint: IndexWithinCheckpointSchema,
26
+ });
@@ -1,3 +1,4 @@
1
+ export * from './block_data.js';
1
2
  export * from './l2_block.js';
2
3
  export * from './l2_block_stream/index.js';
3
4
  export * from './in_block.js';
@@ -13,6 +13,7 @@ import type { TypedEventEmitter } from '@aztec/foundation/types';
13
13
  import { z } from 'zod';
14
14
 
15
15
  import type { Checkpoint } from '../checkpoint/checkpoint.js';
16
+ import type { CheckpointData } from '../checkpoint/checkpoint_data.js';
16
17
  import type { PublishedCheckpoint } from '../checkpoint/published_checkpoint.js';
17
18
  import type { L1RollupConstants } from '../epoch-helpers/index.js';
18
19
  import { CheckpointHeader } from '../rollup/checkpoint_header.js';
@@ -20,6 +21,7 @@ import type { BlockHeader } from '../tx/block_header.js';
20
21
  import type { IndexedTxEffect } from '../tx/indexed_tx_effect.js';
21
22
  import type { TxHash } from '../tx/tx_hash.js';
22
23
  import type { TxReceipt } from '../tx/tx_receipt.js';
24
+ import type { BlockData } from './block_data.js';
23
25
  import type { BlockHash } from './block_hash.js';
24
26
  import type { CheckpointedL2Block } from './checkpointed_l2_block.js';
25
27
  import type { L2Block } from './l2_block.js';
@@ -98,6 +100,12 @@ export interface L2BlockSource {
98
100
  */
99
101
  getCheckpointsForEpoch(epochNumber: EpochNumber): Promise<Checkpoint[]>;
100
102
 
103
+ /**
104
+ * Gets lightweight checkpoint metadata for a given epoch, without fetching full block data.
105
+ * @param epochNumber - Epoch for which we want checkpoint data
106
+ */
107
+ getCheckpointsDataForEpoch(epochNumber: EpochNumber): Promise<CheckpointData[]>;
108
+
101
109
  /**
102
110
  * Gets a block header by its hash.
103
111
  * @param blockHash - The block hash to retrieve.
@@ -112,6 +120,20 @@ export interface L2BlockSource {
112
120
  */
113
121
  getBlockHeaderByArchive(archive: Fr): Promise<BlockHeader | undefined>;
114
122
 
123
+ /**
124
+ * Gets block metadata (without tx data) by block number.
125
+ * @param number - The block number to retrieve.
126
+ * @returns The requested block data (or undefined if not found).
127
+ */
128
+ getBlockData(number: BlockNumber): Promise<BlockData | undefined>;
129
+
130
+ /**
131
+ * Gets block metadata (without tx data) by archive root.
132
+ * @param archive - The archive root to retrieve.
133
+ * @returns The requested block data (or undefined if not found).
134
+ */
135
+ getBlockDataByArchive(archive: Fr): Promise<BlockData | undefined>;
136
+
115
137
  /**
116
138
  * Gets an L2 block by block number.
117
139
  * @param number - The block number to return.
@@ -8,7 +8,7 @@ import {
8
8
  } from '@aztec/foundation/branded-types';
9
9
  import { sum } from '@aztec/foundation/collection';
10
10
  import { Fr } from '@aztec/foundation/curves/bn254';
11
- import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
11
+ import { BufferReader, serializeSignedBigInt, serializeToBuffer } from '@aztec/foundation/serialize';
12
12
  import type { FieldsOf } from '@aztec/foundation/types';
13
13
 
14
14
  import { z } from 'zod';
@@ -17,6 +17,7 @@ import { L2Block } from '../block/l2_block.js';
17
17
  import { MAX_BLOCKS_PER_CHECKPOINT } from '../deserialization/index.js';
18
18
  import { computeCheckpointOutHash } from '../messaging/out_hash.js';
19
19
  import { CheckpointHeader } from '../rollup/checkpoint_header.js';
20
+ import { schemas } from '../schemas/schemas.js';
20
21
  import { AppendOnlyTreeSnapshot } from '../trees/append_only_tree_snapshot.js';
21
22
  import type { CheckpointInfo } from './checkpoint_info.js';
22
23
 
@@ -32,6 +33,8 @@ export class Checkpoint {
32
33
  public blocks: L2Block[],
33
34
  /** Number of the checkpoint. */
34
35
  public number: CheckpointNumber,
36
+ /** Fee asset price modifier in basis points (from oracle). Defaults to 0 (no change). */
37
+ public feeAssetPriceModifier: bigint = 0n,
35
38
  ) {}
36
39
 
37
40
  get slot(): SlotNumber {
@@ -45,8 +48,12 @@ export class Checkpoint {
45
48
  header: CheckpointHeader.schema,
46
49
  blocks: z.array(L2Block.schema),
47
50
  number: CheckpointNumberSchema,
51
+ feeAssetPriceModifier: schemas.BigInt,
48
52
  })
49
- .transform(({ archive, header, blocks, number }) => new Checkpoint(archive, header, blocks, number));
53
+ .transform(
54
+ ({ archive, header, blocks, number, feeAssetPriceModifier }) =>
55
+ new Checkpoint(archive, header, blocks, number, feeAssetPriceModifier),
56
+ );
50
57
  }
51
58
 
52
59
  static from(fields: FieldsOfCheckpoint) {
@@ -54,21 +61,28 @@ export class Checkpoint {
54
61
  }
55
62
 
56
63
  static getFields(fields: FieldsOfCheckpoint) {
57
- return [fields.archive, fields.header, fields.blocks, fields.number] as const;
64
+ return [fields.archive, fields.header, fields.blocks, fields.number, fields.feeAssetPriceModifier] as const;
58
65
  }
59
66
 
60
67
  static fromBuffer(buf: Buffer | BufferReader) {
61
68
  const reader = BufferReader.asReader(buf);
62
- return new Checkpoint(
63
- reader.readObject(AppendOnlyTreeSnapshot),
64
- reader.readObject(CheckpointHeader),
65
- reader.readVector(L2Block, MAX_BLOCKS_PER_CHECKPOINT),
66
- CheckpointNumber(reader.readNumber()),
67
- );
69
+ const archive = reader.readObject(AppendOnlyTreeSnapshot);
70
+ const header = reader.readObject(CheckpointHeader);
71
+ const blocks = reader.readVector(L2Block, MAX_BLOCKS_PER_CHECKPOINT);
72
+ const number = CheckpointNumber(reader.readNumber());
73
+ const feeAssetPriceModifier = reader.readInt256();
74
+ return new Checkpoint(archive, header, blocks, number, feeAssetPriceModifier);
68
75
  }
69
76
 
70
77
  public toBuffer() {
71
- return serializeToBuffer(this.archive, this.header, this.blocks.length, this.blocks, this.number);
78
+ return serializeToBuffer(
79
+ this.archive,
80
+ this.header,
81
+ this.blocks.length,
82
+ this.blocks,
83
+ this.number,
84
+ serializeSignedBigInt(this.feeAssetPriceModifier),
85
+ );
72
86
  }
73
87
 
74
88
  public toBlobFields(): Fr[] {
@@ -80,9 +94,11 @@ export class Checkpoint {
80
94
  return this.header.hash();
81
95
  }
82
96
 
83
- // Returns the out hash computed from all l2-to-l1 messages in this checkpoint.
84
- // Note: This value is different from the out hash in the header, which is the **accumulated** out hash over all
85
- // checkpoints up to and including this one in the epoch.
97
+ /**
98
+ * Returns the out hash computed from all l2-to-l1 messages in this checkpoint.
99
+ * Note: This value is different from the out hash in the header, which is the **accumulated** out hash over all
100
+ * checkpoints up to and including this one in the epoch.
101
+ */
86
102
  public getCheckpointOutHash(): Fr {
87
103
  const msgs = this.blocks.map(block => block.body.txEffects.map(txEffect => txEffect.l2ToL1Msgs));
88
104
  return computeCheckpointOutHash(msgs);
@@ -129,11 +145,13 @@ export class Checkpoint {
129
145
  numBlocks = 1,
130
146
  startBlockNumber = 1,
131
147
  previousArchive,
148
+ feeAssetPriceModifier = 0n,
132
149
  ...options
133
150
  }: {
134
151
  numBlocks?: number;
135
152
  startBlockNumber?: number;
136
153
  previousArchive?: AppendOnlyTreeSnapshot;
154
+ feeAssetPriceModifier?: bigint;
137
155
  } & Partial<Parameters<typeof CheckpointHeader.random>[0]> &
138
156
  Partial<Parameters<typeof L2Block.random>[1]> = {},
139
157
  ) {
@@ -153,6 +171,6 @@ export class Checkpoint {
153
171
  blocks.push(block);
154
172
  }
155
173
 
156
- return new Checkpoint(AppendOnlyTreeSnapshot.random(), header, blocks, checkpointNumber);
174
+ return new Checkpoint(AppendOnlyTreeSnapshot.random(), header, blocks, checkpointNumber, feeAssetPriceModifier);
157
175
  }
158
176
  }
@@ -0,0 +1,51 @@
1
+ import {
2
+ BlockNumber,
3
+ BlockNumberSchema,
4
+ CheckpointNumber,
5
+ CheckpointNumberSchema,
6
+ } from '@aztec/foundation/branded-types';
7
+ import { Fr } from '@aztec/foundation/curves/bn254';
8
+ import { schemas } from '@aztec/foundation/schemas';
9
+
10
+ import { z } from 'zod';
11
+
12
+ import { CommitteeAttestation } from '../block/proposal/committee_attestation.js';
13
+ import { CheckpointHeader } from '../rollup/checkpoint_header.js';
14
+ import { AppendOnlyTreeSnapshot } from '../trees/append_only_tree_snapshot.js';
15
+ import { L1PublishedData } from './published_checkpoint.js';
16
+
17
+ /** Lightweight checkpoint metadata without full block data. */
18
+ export type CheckpointData = {
19
+ checkpointNumber: CheckpointNumber;
20
+ header: CheckpointHeader;
21
+ archive: AppendOnlyTreeSnapshot;
22
+ checkpointOutHash: Fr;
23
+ startBlock: BlockNumber;
24
+ blockCount: number;
25
+ attestations: CommitteeAttestation[];
26
+ l1: L1PublishedData;
27
+ };
28
+
29
+ export const CheckpointDataSchema = z
30
+ .object({
31
+ checkpointNumber: CheckpointNumberSchema,
32
+ header: CheckpointHeader.schema,
33
+ archive: AppendOnlyTreeSnapshot.schema,
34
+ checkpointOutHash: schemas.Fr,
35
+ startBlock: BlockNumberSchema,
36
+ blockCount: schemas.Integer,
37
+ attestations: z.array(CommitteeAttestation.schema),
38
+ l1: L1PublishedData.schema,
39
+ })
40
+ .transform(
41
+ (obj): CheckpointData => ({
42
+ checkpointNumber: obj.checkpointNumber,
43
+ header: obj.header,
44
+ archive: obj.archive,
45
+ checkpointOutHash: obj.checkpointOutHash,
46
+ startBlock: obj.startBlock,
47
+ blockCount: obj.blockCount,
48
+ attestations: obj.attestations,
49
+ l1: obj.l1,
50
+ }),
51
+ );
@@ -1,3 +1,4 @@
1
1
  export * from './checkpoint.js';
2
+ export * from './checkpoint_data.js';
2
3
  export * from './checkpoint_info.js';
3
4
  export * from './published_checkpoint.js';
@@ -55,9 +55,11 @@ export class L1PublishedData {
55
55
 
56
56
  export class PublishedCheckpoint {
57
57
  constructor(
58
+ /** The checkpoint itself. */
58
59
  public checkpoint: Checkpoint,
60
+ /** Info on when this checkpoint was published on L1. */
59
61
  public l1: L1PublishedData,
60
- // The attestations for the last block in the checkpoint.
62
+ /** The attestations for the last block in the checkpoint. */
61
63
  public attestations: CommitteeAttestation[],
62
64
  ) {}
63
65
 
@@ -8,7 +8,9 @@ import type { SequencerConfig } from '../interfaces/configs.js';
8
8
  * (like blockDurationMs needed by both p2p and sequencer-client) are defined here
9
9
  * to avoid duplication.
10
10
  */
11
- export const sharedSequencerConfigMappings: ConfigMappingsType<Pick<SequencerConfig, 'blockDurationMs'>> = {
11
+ export const sharedSequencerConfigMappings: ConfigMappingsType<
12
+ Pick<SequencerConfig, 'blockDurationMs' | 'expectedBlockProposalsPerSlot'>
13
+ > = {
12
14
  blockDurationMs: {
13
15
  env: 'SEQ_BLOCK_DURATION_MS',
14
16
  description:
@@ -16,4 +18,12 @@ export const sharedSequencerConfigMappings: ConfigMappingsType<Pick<SequencerCon
16
18
  'If undefined (default), builds a single block per slot using the full slot duration.',
17
19
  parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
18
20
  },
21
+ expectedBlockProposalsPerSlot: {
22
+ env: 'SEQ_EXPECTED_BLOCK_PROPOSALS_PER_SLOT',
23
+ description:
24
+ 'Expected number of block proposals per slot for P2P peer scoring. ' +
25
+ '0 (default) disables block proposal scoring. Set to a positive value to enable.',
26
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : 0),
27
+ defaultValue: 0,
28
+ },
19
29
  };
@@ -1,4 +1,4 @@
1
- import { GeneratorIndex } from '@aztec/constants';
1
+ import { DomainSeparator } from '@aztec/constants';
2
2
  import { poseidon2HashWithSeparator } from '@aztec/foundation/crypto/poseidon';
3
3
  import { Fr } from '@aztec/foundation/curves/bn254';
4
4
 
@@ -44,7 +44,7 @@ export async function computePartialAddress(
44
44
 
45
45
  return poseidon2HashWithSeparator(
46
46
  [instance.originalContractClassId, saltedInitializationHash],
47
- GeneratorIndex.PARTIAL_ADDRESS,
47
+ DomainSeparator.PARTIAL_ADDRESS,
48
48
  );
49
49
  }
50
50
 
@@ -57,7 +57,7 @@ export function computeSaltedInitializationHash(
57
57
  ): Promise<Fr> {
58
58
  return poseidon2HashWithSeparator(
59
59
  [instance.salt, instance.initializationHash, instance.deployer],
60
- GeneratorIndex.PARTIAL_ADDRESS,
60
+ DomainSeparator.PARTIAL_ADDRESS,
61
61
  );
62
62
  }
63
63
 
@@ -87,5 +87,5 @@ export async function computeInitializationHashFromEncodedArgs(
87
87
  encodedArgs: Fr[],
88
88
  ): Promise<Fr> {
89
89
  const argsHash = await computeVarArgsHash(encodedArgs);
90
- return poseidon2HashWithSeparator([initFn, argsHash], GeneratorIndex.INITIALIZER);
90
+ return poseidon2HashWithSeparator([initFn, argsHash], DomainSeparator.INITIALIZER);
91
91
  }
@@ -1,4 +1,4 @@
1
- import { GeneratorIndex, MAX_PACKED_PUBLIC_BYTECODE_SIZE_IN_FIELDS } from '@aztec/constants';
1
+ import { DomainSeparator, MAX_PACKED_PUBLIC_BYTECODE_SIZE_IN_FIELDS } from '@aztec/constants';
2
2
  import { poseidon2HashWithSeparator } from '@aztec/foundation/crypto/poseidon';
3
3
  import { Fr } from '@aztec/foundation/curves/bn254';
4
4
 
@@ -40,7 +40,7 @@ export async function computeContractClassIdWithPreimage(
40
40
  : await computePublicBytecodeCommitment(contractClass.packedBytecode);
41
41
  const id = await poseidon2HashWithSeparator(
42
42
  [artifactHash, privateFunctionsRoot, publicBytecodeCommitment],
43
- GeneratorIndex.CONTRACT_CLASS_ID,
43
+ DomainSeparator.CONTRACT_CLASS_ID,
44
44
  );
45
45
  return { id, artifactHash, privateFunctionsRoot, publicBytecodeCommitment };
46
46
  }
@@ -60,7 +60,7 @@ export type ContractClassIdPreimage = {
60
60
  };
61
61
 
62
62
  export async function computePublicBytecodeCommitment(packedBytecode: Buffer) {
63
- // Encode the buffer into field elements (chunked into 32 bytes each)
63
+ // Encode the buffer into field elements (chunked into 31 bytes each)
64
64
  // The first element is the length of the bytecode (in bytes)
65
65
  const [bytecodeLengthAsField, ...bytecodeAsFields] = bufferAsFields(
66
66
  packedBytecode,
@@ -72,5 +72,6 @@ export async function computePublicBytecodeCommitment(packedBytecode: Buffer) {
72
72
 
73
73
  // NOTE: hash the bytecode here only up to the actual length of the bytecode.
74
74
  // We do not hash the entire max bytecode length!
75
- return await poseidon2HashWithSeparator(bytecodeAsFields.slice(0, bytecodeLength), GeneratorIndex.PUBLIC_BYTECODE);
75
+ const sep = BigInt(DomainSeparator.PUBLIC_BYTECODE) + (bytecodeLengthAsField.toBigInt() << 32n);
76
+ return await poseidon2HashWithSeparator(bytecodeAsFields.slice(0, bytecodeLength), new Fr(sep).toNumber());
76
77
  }
@@ -1,4 +1,4 @@
1
- import { FUNCTION_TREE_HEIGHT, GeneratorIndex } from '@aztec/constants';
1
+ import { DomainSeparator, FUNCTION_TREE_HEIGHT } from '@aztec/constants';
2
2
  import { poseidon2Hash, poseidon2HashWithSeparator } from '@aztec/foundation/crypto/poseidon';
3
3
  import { Fr } from '@aztec/foundation/curves/bn254';
4
4
  import { type MerkleTree, MerkleTreeCalculator } from '@aztec/foundation/trees';
@@ -31,7 +31,7 @@ function computePrivateFunctionLeaves(fns: PrivateFunction[]): Promise<Buffer[]>
31
31
 
32
32
  /** Returns the leaf for a given private function. */
33
33
  export async function computePrivateFunctionLeaf(fn: PrivateFunction): Promise<Buffer> {
34
- return (await poseidon2HashWithSeparator([fn.selector, fn.vkHash], GeneratorIndex.PRIVATE_FUNCTION_LEAF)).toBuffer();
34
+ return (await poseidon2HashWithSeparator([fn.selector, fn.vkHash], DomainSeparator.PRIVATE_FUNCTION_LEAF)).toBuffer();
35
35
  }
36
36
 
37
37
  async function getPrivateFunctionTreeCalculator(): Promise<MerkleTreeCalculator> {
@@ -1,15 +1,21 @@
1
1
  import { access, mkdir, readFile, writeFile } from 'fs/promises';
2
2
  import { dirname, resolve } from 'path';
3
+ import { promisify } from 'util';
4
+ import { gunzip as gunzipCb, gzip as gzipCb } from 'zlib';
3
5
 
4
- import type { FileStore } from './interface.js';
6
+ import type { FileStore, FileStoreSaveOptions } from './interface.js';
7
+
8
+ const gzip = promisify(gzipCb);
9
+ const gunzip = promisify(gunzipCb);
5
10
 
6
11
  export class LocalFileStore implements FileStore {
7
12
  constructor(private readonly basePath: string) {}
8
13
 
9
- public async save(path: string, data: Buffer): Promise<string> {
14
+ public async save(path: string, data: Buffer, opts?: FileStoreSaveOptions): Promise<string> {
10
15
  const fullPath = this.getFullPath(path);
11
16
  await mkdir(dirname(fullPath), { recursive: true });
12
- await writeFile(fullPath, data);
17
+ const toWrite = opts?.compress ? await gzip(data) : data;
18
+ await writeFile(fullPath, toWrite);
13
19
  return `file://${fullPath}`;
14
20
  }
15
21
 
@@ -18,9 +24,13 @@ export class LocalFileStore implements FileStore {
18
24
  return this.save(destPath, data);
19
25
  }
20
26
 
21
- public read(pathOrUrlStr: string): Promise<Buffer> {
27
+ public async read(pathOrUrlStr: string): Promise<Buffer> {
22
28
  const fullPath = this.getFullPath(pathOrUrlStr);
23
- return readFile(fullPath);
29
+ const data = await readFile(fullPath);
30
+ if (data.length >= 2 && data[0] === 0x1f && data[1] === 0x8b) {
31
+ return await gunzip(data);
32
+ }
33
+ return data;
24
34
  }
25
35
 
26
36
  public async download(pathOrUrlStr: string, destPath: string): Promise<void> {
@@ -13,10 +13,14 @@ import { tmpdir } from 'os';
13
13
  import { basename, dirname, join } from 'path';
14
14
  import { Readable } from 'stream';
15
15
  import { pipeline } from 'stream/promises';
16
- import { createGzip } from 'zlib';
16
+ import { promisify } from 'util';
17
+ import { createGzip, gunzip as gunzipCb, gzip as gzipCb } from 'zlib';
17
18
 
18
19
  import type { FileStore, FileStoreSaveOptions } from './interface.js';
19
20
 
21
+ const gzip = promisify(gzipCb);
22
+ const gunzip = promisify(gunzipCb);
23
+
20
24
  function normalizeBasePath(path: string): string {
21
25
  return path?.replace(/^\/+|\/+$/g, '') ?? '';
22
26
  }
@@ -52,7 +56,7 @@ export class S3FileStore implements FileStore {
52
56
  const key = this.getFullPath(path);
53
57
  const shouldCompress = !!opts.compress;
54
58
 
55
- const body = shouldCompress ? (await import('zlib')).gzipSync(data) : data;
59
+ const body = shouldCompress ? await gzip(data) : data;
56
60
  const contentLength = body.length;
57
61
  const contentType = this.detectContentType(key, shouldCompress);
58
62
  const put = new PutObjectCommand({
@@ -60,6 +64,7 @@ export class S3FileStore implements FileStore {
60
64
  Key: key,
61
65
  Body: body,
62
66
  ContentType: contentType,
67
+ ContentEncoding: shouldCompress ? 'gzip' : undefined,
63
68
  CacheControl: opts.metadata?.['Cache-control'],
64
69
  Metadata: this.extractUserMetadata(opts.metadata),
65
70
  ContentLength: contentLength,
@@ -134,7 +139,11 @@ export class S3FileStore implements FileStore {
134
139
  for await (const chunk of stream) {
135
140
  chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
136
141
  }
137
- return Buffer.concat(chunks);
142
+ const buffer = Buffer.concat(chunks);
143
+ if (out.ContentEncoding === 'gzip') {
144
+ return await gunzip(buffer);
145
+ }
146
+ return buffer;
138
147
  }
139
148
 
140
149
  public async download(pathOrUrlStr: string, destPath: string): Promise<void> {
package/src/hash/hash.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { GeneratorIndex, NULL_MSG_SENDER_CONTRACT_ADDRESS } from '@aztec/constants';
1
+ import { DomainSeparator, NULL_MSG_SENDER_CONTRACT_ADDRESS } from '@aztec/constants';
2
2
  import { poseidon2Hash, poseidon2HashWithSeparator } from '@aztec/foundation/crypto/poseidon';
3
3
  import { sha256ToField } from '@aztec/foundation/crypto/sha256';
4
4
  import { Fr } from '@aztec/foundation/curves/bn254';
@@ -23,7 +23,7 @@ export async function hashVK(keyAsFields: Fr[]): Promise<Fr> {
23
23
  * @returns A note hash nonce.
24
24
  */
25
25
  export function computeNoteHashNonce(nullifierZero: Fr, noteHashIndex: number): Promise<Fr> {
26
- return poseidon2HashWithSeparator([nullifierZero, noteHashIndex], GeneratorIndex.NOTE_HASH_NONCE);
26
+ return poseidon2HashWithSeparator([nullifierZero, noteHashIndex], DomainSeparator.NOTE_HASH_NONCE);
27
27
  }
28
28
 
29
29
  /**
@@ -34,7 +34,7 @@ export function computeNoteHashNonce(nullifierZero: Fr, noteHashIndex: number):
34
34
  * @returns A siloed note hash.
35
35
  */
36
36
  export function siloNoteHash(contract: AztecAddress, noteHash: Fr): Promise<Fr> {
37
- return poseidon2HashWithSeparator([contract, noteHash], GeneratorIndex.SILOED_NOTE_HASH);
37
+ return poseidon2HashWithSeparator([contract, noteHash], DomainSeparator.SILOED_NOTE_HASH);
38
38
  }
39
39
 
40
40
  /**
@@ -44,7 +44,7 @@ export function siloNoteHash(contract: AztecAddress, noteHash: Fr): Promise<Fr>
44
44
  * @returns A unique note hash.
45
45
  */
46
46
  export function computeUniqueNoteHash(noteNonce: Fr, siloedNoteHash: Fr): Promise<Fr> {
47
- return poseidon2HashWithSeparator([noteNonce, siloedNoteHash], GeneratorIndex.UNIQUE_NOTE_HASH);
47
+ return poseidon2HashWithSeparator([noteNonce, siloedNoteHash], DomainSeparator.UNIQUE_NOTE_HASH);
48
48
  }
49
49
 
50
50
  /**
@@ -55,7 +55,7 @@ export function computeUniqueNoteHash(noteNonce: Fr, siloedNoteHash: Fr): Promis
55
55
  * @returns A siloed nullifier.
56
56
  */
57
57
  export function siloNullifier(contract: AztecAddress, innerNullifier: Fr): Promise<Fr> {
58
- return poseidon2HashWithSeparator([contract, innerNullifier], GeneratorIndex.SILOED_NULLIFIER);
58
+ return poseidon2HashWithSeparator([contract, innerNullifier], DomainSeparator.SILOED_NULLIFIER);
59
59
  }
60
60
 
61
61
  /**
@@ -70,7 +70,7 @@ export function computeProtocolNullifier(txRequestHash: Fr): Promise<Fr> {
70
70
  }
71
71
 
72
72
  export function computeSiloedPrivateLogFirstField(contract: AztecAddress, field: Fr): Promise<Fr> {
73
- return poseidon2HashWithSeparator([contract, field], GeneratorIndex.PRIVATE_LOG_FIRST_FIELD);
73
+ return poseidon2HashWithSeparator([contract, field], DomainSeparator.PRIVATE_LOG_FIRST_FIELD);
74
74
  }
75
75
 
76
76
  /**
@@ -91,7 +91,7 @@ export function computePublicDataTreeValue(value: Fr): Fr {
91
91
 
92
92
  */
93
93
  export function computePublicDataTreeLeafSlot(contractAddress: AztecAddress, storageSlot: Fr): Promise<Fr> {
94
- return poseidon2HashWithSeparator([contractAddress, storageSlot], GeneratorIndex.PUBLIC_LEAF_SLOT);
94
+ return poseidon2HashWithSeparator([contractAddress, storageSlot], DomainSeparator.PUBLIC_LEAF_SLOT);
95
95
  }
96
96
 
97
97
  /**
@@ -105,7 +105,7 @@ export function computeVarArgsHash(args: Fr[]): Promise<Fr> {
105
105
  return Promise.resolve(Fr.ZERO);
106
106
  }
107
107
 
108
- return poseidon2HashWithSeparator(args, GeneratorIndex.FUNCTION_ARGS);
108
+ return poseidon2HashWithSeparator(args, DomainSeparator.FUNCTION_ARGS);
109
109
  }
110
110
 
111
111
  /**
@@ -114,7 +114,7 @@ export function computeVarArgsHash(args: Fr[]): Promise<Fr> {
114
114
  * @returns Hash of the calldata.
115
115
  */
116
116
  export function computeCalldataHash(calldata: Fr[]): Promise<Fr> {
117
- return poseidon2HashWithSeparator(calldata, GeneratorIndex.PUBLIC_CALLDATA);
117
+ return poseidon2HashWithSeparator(calldata, DomainSeparator.PUBLIC_CALLDATA);
118
118
  }
119
119
 
120
120
  /**
@@ -124,13 +124,13 @@ export function computeCalldataHash(calldata: Fr[]): Promise<Fr> {
124
124
  * @returns The hash
125
125
  */
126
126
  export function computeSecretHash(secret: Fr): Promise<Fr> {
127
- return poseidon2HashWithSeparator([secret], GeneratorIndex.SECRET_HASH);
127
+ return poseidon2HashWithSeparator([secret], DomainSeparator.SECRET_HASH);
128
128
  }
129
129
 
130
130
  export async function computeL1ToL2MessageNullifier(contract: AztecAddress, messageHash: Fr, secret: Fr) {
131
131
  const innerMessageNullifier = await poseidon2HashWithSeparator(
132
132
  [messageHash, secret],
133
- GeneratorIndex.MESSAGE_NULLIFIER,
133
+ DomainSeparator.MESSAGE_NULLIFIER,
134
134
  );
135
135
  return siloNullifier(contract, innerMessageNullifier);
136
136
  }
@@ -1,4 +1,4 @@
1
- import { GeneratorIndex } from '@aztec/constants';
1
+ import { DomainSeparator } from '@aztec/constants';
2
2
  import { poseidon2HashWithSeparator } from '@aztec/foundation/crypto/poseidon';
3
3
  import type { Fr } from '@aztec/foundation/curves/bn254';
4
4
 
@@ -15,5 +15,5 @@ export function deriveStorageSlotInMap(
15
15
  toField: () => Fr;
16
16
  },
17
17
  ): Promise<Fr> {
18
- return poseidon2HashWithSeparator([mapSlot, key.toField()], GeneratorIndex.PUBLIC_STORAGE_MAP_SLOT);
18
+ return poseidon2HashWithSeparator([mapSlot, key.toField()], DomainSeparator.PUBLIC_STORAGE_MAP_SLOT);
19
19
  }
@@ -4,12 +4,14 @@ import type { ApiSchemaFor } from '@aztec/foundation/schemas';
4
4
 
5
5
  import { z } from 'zod';
6
6
 
7
+ import { BlockDataSchema } from '../block/block_data.js';
7
8
  import { BlockHash } from '../block/block_hash.js';
8
9
  import { CheckpointedL2Block } from '../block/checkpointed_l2_block.js';
9
10
  import { L2Block } from '../block/l2_block.js';
10
11
  import { type L2BlockSource, L2TipsSchema } from '../block/l2_block_source.js';
11
12
  import { ValidateCheckpointResultSchema } from '../block/validate_block_result.js';
12
13
  import { Checkpoint } from '../checkpoint/checkpoint.js';
14
+ import { CheckpointDataSchema } from '../checkpoint/checkpoint_data.js';
13
15
  import { PublishedCheckpoint } from '../checkpoint/published_checkpoint.js';
14
16
  import {
15
17
  ContractClassPublicSchema,
@@ -104,6 +106,8 @@ export const ArchiverApiSchema: ApiSchemaFor<ArchiverApi> = {
104
106
  getCheckpointedBlockByArchive: z.function().args(schemas.Fr).returns(CheckpointedL2Block.schema.optional()),
105
107
  getBlockHeaderByHash: z.function().args(BlockHash.schema).returns(BlockHeader.schema.optional()),
106
108
  getBlockHeaderByArchive: z.function().args(schemas.Fr).returns(BlockHeader.schema.optional()),
109
+ getBlockData: z.function().args(BlockNumberSchema).returns(BlockDataSchema.optional()),
110
+ getBlockDataByArchive: z.function().args(schemas.Fr).returns(BlockDataSchema.optional()),
107
111
  getL2Block: z.function().args(BlockNumberSchema).returns(L2Block.schema.optional()),
108
112
  getL2BlockByHash: z.function().args(BlockHash.schema).returns(L2Block.schema.optional()),
109
113
  getL2BlockByArchive: z.function().args(schemas.Fr).returns(L2Block.schema.optional()),
@@ -112,6 +116,7 @@ export const ArchiverApiSchema: ApiSchemaFor<ArchiverApi> = {
112
116
  getL2SlotNumber: z.function().args().returns(schemas.SlotNumber.optional()),
113
117
  getL2EpochNumber: z.function().args().returns(EpochNumberSchema.optional()),
114
118
  getCheckpointsForEpoch: z.function().args(EpochNumberSchema).returns(z.array(Checkpoint.schema)),
119
+ getCheckpointsDataForEpoch: z.function().args(EpochNumberSchema).returns(z.array(CheckpointDataSchema)),
115
120
  getCheckpointedBlocksForEpoch: z.function().args(EpochNumberSchema).returns(z.array(CheckpointedL2Block.schema)),
116
121
  getBlocksForSlot: z.function().args(schemas.SlotNumber).returns(z.array(L2Block.schema)),
117
122
  getCheckpointedBlockHeadersForEpoch: z.function().args(EpochNumberSchema).returns(z.array(BlockHeader.schema)),