@aztec/foundation 0.0.1-commit.8afd444 → 0.0.1-commit.8cb2d04d8

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 (218) hide show
  1. package/dest/array/sorted_array.d.ts +6 -1
  2. package/dest/array/sorted_array.d.ts.map +1 -1
  3. package/dest/array/sorted_array.js +18 -15
  4. package/dest/branded-types/buffer32_hash.d.ts +24 -0
  5. package/dest/branded-types/buffer32_hash.d.ts.map +1 -0
  6. package/dest/branded-types/buffer32_hash.js +19 -0
  7. package/dest/branded-types/checkpoint_number.d.ts +4 -1
  8. package/dest/branded-types/checkpoint_number.d.ts.map +1 -1
  9. package/dest/branded-types/checkpoint_number.js +3 -0
  10. package/dest/branded-types/index.d.ts +2 -1
  11. package/dest/branded-types/index.d.ts.map +1 -1
  12. package/dest/branded-types/index.js +1 -0
  13. package/dest/branded-types/slot.d.ts +4 -1
  14. package/dest/branded-types/slot.d.ts.map +1 -1
  15. package/dest/branded-types/slot.js +3 -0
  16. package/dest/buffer/buffer16.d.ts +3 -1
  17. package/dest/buffer/buffer16.d.ts.map +1 -1
  18. package/dest/buffer/buffer32.d.ts +28 -61
  19. package/dest/buffer/buffer32.d.ts.map +1 -1
  20. package/dest/buffer/buffer32.js +26 -60
  21. package/dest/buffer/index.d.ts +2 -1
  22. package/dest/buffer/index.d.ts.map +1 -1
  23. package/dest/buffer/index.js +1 -0
  24. package/dest/buffer/utils.d.ts +3 -0
  25. package/dest/buffer/utils.d.ts.map +1 -0
  26. package/dest/buffer/utils.js +7 -0
  27. package/dest/collection/array.d.ts +3 -1
  28. package/dest/collection/array.d.ts.map +1 -1
  29. package/dest/collection/array.js +15 -0
  30. package/dest/collection/index.d.ts +2 -1
  31. package/dest/collection/index.d.ts.map +1 -1
  32. package/dest/collection/index.js +1 -0
  33. package/dest/collection/lru_set.d.ts +35 -0
  34. package/dest/collection/lru_set.d.ts.map +1 -0
  35. package/dest/collection/lru_set.js +95 -0
  36. package/dest/config/env_var.d.ts +2 -2
  37. package/dest/config/env_var.d.ts.map +1 -1
  38. package/dest/config/index.d.ts +48 -30
  39. package/dest/config/index.d.ts.map +1 -1
  40. package/dest/config/index.js +35 -29
  41. package/dest/config/network_config.d.ts +19 -1
  42. package/dest/config/network_config.d.ts.map +1 -1
  43. package/dest/config/network_config.js +4 -1
  44. package/dest/config/network_name.d.ts +2 -2
  45. package/dest/config/network_name.d.ts.map +1 -1
  46. package/dest/config/network_name.js +2 -0
  47. package/dest/crypto/aes128/index.d.ts +2 -1
  48. package/dest/crypto/aes128/index.d.ts.map +1 -1
  49. package/dest/crypto/aes128/index.js +11 -2
  50. package/dest/crypto/bls/bn254_keystore.d.ts +1 -10
  51. package/dest/crypto/bls/bn254_keystore.d.ts.map +1 -1
  52. package/dest/crypto/bls/bn254_keystore.js +0 -17
  53. package/dest/crypto/poseidon/index.d.ts +1 -1
  54. package/dest/crypto/poseidon/index.d.ts.map +1 -1
  55. package/dest/crypto/poseidon/index.js +40 -33
  56. package/dest/crypto/secp256k1-signer/utils.d.ts +12 -1
  57. package/dest/crypto/secp256k1-signer/utils.d.ts.map +1 -1
  58. package/dest/crypto/secp256k1-signer/utils.js +26 -0
  59. package/dest/curves/bls12/field.d.ts +1 -1
  60. package/dest/curves/bls12/field.d.ts.map +1 -1
  61. package/dest/curves/bls12/field.js +0 -5
  62. package/dest/curves/bn254/field.d.ts +18 -16
  63. package/dest/curves/bn254/field.d.ts.map +1 -1
  64. package/dest/curves/bn254/field.js +23 -15
  65. package/dest/curves/grumpkin/point.d.ts +4 -4
  66. package/dest/curves/grumpkin/point.d.ts.map +1 -1
  67. package/dest/curves/grumpkin/point.js +7 -4
  68. package/dest/eth-address/index.d.ts +1 -1
  69. package/dest/eth-address/index.d.ts.map +1 -1
  70. package/dest/eth-address/index.js +0 -3
  71. package/dest/eth-signature/eth_signature.d.ts +2 -1
  72. package/dest/eth-signature/eth_signature.d.ts.map +1 -1
  73. package/dest/eth-signature/eth_signature.js +7 -2
  74. package/dest/fifo/fifo_frame_reader.d.ts +41 -0
  75. package/dest/fifo/fifo_frame_reader.d.ts.map +1 -0
  76. package/dest/fifo/fifo_frame_reader.js +74 -0
  77. package/dest/fifo/index.d.ts +2 -0
  78. package/dest/fifo/index.d.ts.map +1 -0
  79. package/dest/fifo/index.js +1 -0
  80. package/dest/jest/setup.js +24 -0
  81. package/dest/json-rpc/client/fetch.d.ts +1 -1
  82. package/dest/json-rpc/client/fetch.d.ts.map +1 -1
  83. package/dest/json-rpc/client/fetch.js +4 -3
  84. package/dest/json-rpc/client/safe_json_rpc_client.d.ts +2 -1
  85. package/dest/json-rpc/client/safe_json_rpc_client.d.ts.map +1 -1
  86. package/dest/json-rpc/client/safe_json_rpc_client.js +1 -1
  87. package/dest/json-rpc/client/undici.d.ts +1 -1
  88. package/dest/json-rpc/client/undici.d.ts.map +1 -1
  89. package/dest/json-rpc/client/undici.js +5 -3
  90. package/dest/json-rpc/server/api_key_auth.d.ts +19 -0
  91. package/dest/json-rpc/server/api_key_auth.d.ts.map +1 -0
  92. package/dest/json-rpc/server/api_key_auth.js +57 -0
  93. package/dest/json-rpc/server/index.d.ts +2 -1
  94. package/dest/json-rpc/server/index.d.ts.map +1 -1
  95. package/dest/json-rpc/server/index.js +1 -0
  96. package/dest/log/bigint-utils.d.ts +5 -0
  97. package/dest/log/bigint-utils.d.ts.map +1 -0
  98. package/dest/log/bigint-utils.js +21 -0
  99. package/dest/log/gcloud-logger-config.d.ts +1 -1
  100. package/dest/log/gcloud-logger-config.d.ts.map +1 -1
  101. package/dest/log/gcloud-logger-config.js +3 -0
  102. package/dest/log/log-filters.d.ts +17 -4
  103. package/dest/log/log-filters.d.ts.map +1 -1
  104. package/dest/log/log-filters.js +26 -12
  105. package/dest/log/pino-logger.d.ts +1 -1
  106. package/dest/log/pino-logger.d.ts.map +1 -1
  107. package/dest/log/pino-logger.js +23 -4
  108. package/dest/queue/base_memory_queue.d.ts +2 -2
  109. package/dest/queue/base_memory_queue.d.ts.map +1 -1
  110. package/dest/queue/batch_queue.d.ts +1 -1
  111. package/dest/queue/batch_queue.d.ts.map +1 -1
  112. package/dest/queue/batch_queue.js +1 -0
  113. package/dest/retry/index.d.ts +12 -1
  114. package/dest/retry/index.d.ts.map +1 -1
  115. package/dest/retry/index.js +21 -0
  116. package/dest/schemas/api.d.ts +2 -2
  117. package/dest/schemas/api.d.ts.map +1 -1
  118. package/dest/serialize/buffer_reader.d.ts +8 -1
  119. package/dest/serialize/buffer_reader.d.ts.map +1 -1
  120. package/dest/serialize/buffer_reader.js +13 -0
  121. package/dest/serialize/serialize.d.ts +19 -1
  122. package/dest/serialize/serialize.d.ts.map +1 -1
  123. package/dest/serialize/serialize.js +31 -0
  124. package/dest/sleep/index.d.ts +2 -1
  125. package/dest/sleep/index.d.ts.map +1 -1
  126. package/dest/sleep/index.js +10 -1
  127. package/dest/string/index.js +1 -1
  128. package/dest/timer/date.d.ts +25 -1
  129. package/dest/timer/date.d.ts.map +1 -1
  130. package/dest/timer/date.js +33 -0
  131. package/dest/transport/dispatch/create_dispatch_proxy.d.ts +11 -2
  132. package/dest/transport/dispatch/create_dispatch_proxy.d.ts.map +1 -1
  133. package/dest/transport/index.d.ts +1 -2
  134. package/dest/transport/index.d.ts.map +1 -1
  135. package/dest/transport/index.js +0 -1
  136. package/dest/transport/transport_client.js +2 -2
  137. package/dest/trees/balanced_merkle_tree_root.d.ts +2 -3
  138. package/dest/trees/balanced_merkle_tree_root.d.ts.map +1 -1
  139. package/dest/trees/balanced_merkle_tree_root.js +2 -3
  140. package/dest/trees/hasher.d.ts +3 -2
  141. package/dest/trees/hasher.d.ts.map +1 -1
  142. package/dest/trees/hasher.js +5 -5
  143. package/dest/trees/indexed_merkle_tree_calculator.d.ts +1 -1
  144. package/dest/trees/indexed_merkle_tree_calculator.d.ts.map +1 -1
  145. package/dest/trees/indexed_merkle_tree_calculator.js +5 -1
  146. package/dest/trees/merkle_tree_calculator.d.ts +4 -2
  147. package/dest/trees/merkle_tree_calculator.d.ts.map +1 -1
  148. package/dest/trees/merkle_tree_calculator.js +1 -5
  149. package/dest/trees/sibling_path.d.ts +2 -2
  150. package/dest/trees/sibling_path.d.ts.map +1 -1
  151. package/dest/trees/sibling_path.js +1 -5
  152. package/dest/trees/unbalanced_merkle_tree_root.d.ts +2 -3
  153. package/dest/trees/unbalanced_merkle_tree_root.d.ts.map +1 -1
  154. package/dest/trees/unbalanced_merkle_tree_root.js +2 -3
  155. package/package.json +23 -2
  156. package/src/array/sorted_array.ts +22 -17
  157. package/src/branded-types/buffer32_hash.ts +42 -0
  158. package/src/branded-types/checkpoint_number.ts +5 -0
  159. package/src/branded-types/index.ts +1 -0
  160. package/src/branded-types/slot.ts +5 -0
  161. package/src/buffer/buffer16.ts +3 -0
  162. package/src/buffer/buffer32.ts +36 -65
  163. package/src/buffer/index.ts +1 -0
  164. package/src/buffer/utils.ts +8 -0
  165. package/src/collection/array.ts +14 -0
  166. package/src/collection/index.ts +1 -0
  167. package/src/collection/lru_set.ts +115 -0
  168. package/src/config/env_var.ts +50 -14
  169. package/src/config/index.ts +110 -83
  170. package/src/config/network_config.ts +3 -0
  171. package/src/config/network_name.ts +4 -1
  172. package/src/crypto/aes128/index.ts +11 -2
  173. package/src/crypto/bls/bn254_keystore.ts +0 -23
  174. package/src/crypto/poseidon/index.ts +42 -34
  175. package/src/crypto/secp256k1-signer/utils.ts +32 -0
  176. package/src/curves/bls12/field.ts +0 -7
  177. package/src/curves/bn254/field.ts +31 -33
  178. package/src/curves/grumpkin/point.ts +6 -3
  179. package/src/eth-address/index.ts +0 -4
  180. package/src/eth-signature/eth_signature.ts +7 -1
  181. package/src/fifo/fifo_frame_reader.ts +98 -0
  182. package/src/fifo/index.ts +1 -0
  183. package/src/jest/setup.mjs +27 -0
  184. package/src/json-rpc/client/fetch.ts +4 -3
  185. package/src/json-rpc/client/safe_json_rpc_client.ts +2 -0
  186. package/src/json-rpc/client/undici.ts +5 -3
  187. package/src/json-rpc/server/api_key_auth.ts +63 -0
  188. package/src/json-rpc/server/index.ts +1 -0
  189. package/src/log/bigint-utils.ts +25 -0
  190. package/src/log/gcloud-logger-config.ts +5 -0
  191. package/src/log/log-filters.ts +29 -11
  192. package/src/log/pino-logger.ts +25 -4
  193. package/src/queue/base_memory_queue.ts +1 -1
  194. package/src/queue/batch_queue.ts +1 -0
  195. package/src/retry/index.ts +30 -0
  196. package/src/schemas/api.ts +4 -1
  197. package/src/serialize/buffer_reader.ts +15 -0
  198. package/src/serialize/serialize.ts +32 -0
  199. package/src/sleep/index.ts +10 -1
  200. package/src/string/index.ts +1 -1
  201. package/src/timer/date.ts +48 -0
  202. package/src/transport/dispatch/create_dispatch_proxy.ts +11 -1
  203. package/src/transport/index.ts +0 -1
  204. package/src/transport/transport_client.ts +2 -2
  205. package/src/trees/balanced_merkle_tree_root.ts +2 -5
  206. package/src/trees/hasher.ts +6 -3
  207. package/src/trees/indexed_merkle_tree_calculator.ts +5 -1
  208. package/src/trees/merkle_tree_calculator.ts +4 -10
  209. package/src/trees/sibling_path.ts +1 -2
  210. package/src/trees/unbalanced_merkle_tree_root.ts +2 -5
  211. package/dest/crypto/serialize.d.ts +0 -51
  212. package/dest/crypto/serialize.d.ts.map +0 -1
  213. package/dest/crypto/serialize.js +0 -68
  214. package/dest/transport/dispatch/create_dispatch_fn.d.ts +0 -25
  215. package/dest/transport/dispatch/create_dispatch_fn.d.ts.map +0 -1
  216. package/dest/transport/dispatch/create_dispatch_fn.js +0 -17
  217. package/src/crypto/serialize.ts +0 -85
  218. package/src/transport/dispatch/create_dispatch_fn.ts +0 -35
@@ -0,0 +1,42 @@
1
+ import type { BaseBuffer32 } from '../buffer/buffer32.js';
2
+ import { Buffer32 } from '../buffer/buffer32.js';
3
+ import type { Branded } from './types.js';
4
+
5
+ /** A branded Buffer32 representing a block proposal hash, used for p2p deduplication. */
6
+ export type BlockProposalHash = Branded<BaseBuffer32, 'BlockProposalHash'>;
7
+
8
+ /** Creates a BlockProposalHash from a BaseBuffer32. */
9
+ export function BlockProposalHash(buf: BaseBuffer32): BlockProposalHash {
10
+ return buf as BlockProposalHash;
11
+ }
12
+
13
+ /** Creates a BlockProposalHash from a raw Buffer. */
14
+ BlockProposalHash.fromBuffer = function (buf: Buffer): BlockProposalHash {
15
+ return new Buffer32(buf) as unknown as BlockProposalHash;
16
+ };
17
+
18
+ /** A branded Buffer32 representing a checkpoint proposal hash, used for p2p deduplication. */
19
+ export type CheckpointProposalHash = Branded<BaseBuffer32, 'CheckpointProposalHash'>;
20
+
21
+ /** Creates a CheckpointProposalHash from a BaseBuffer32. */
22
+ export function CheckpointProposalHash(buf: BaseBuffer32): CheckpointProposalHash {
23
+ return buf as CheckpointProposalHash;
24
+ }
25
+
26
+ /** Creates a CheckpointProposalHash from a raw Buffer. */
27
+ CheckpointProposalHash.fromBuffer = function (buf: Buffer): CheckpointProposalHash {
28
+ return new Buffer32(buf) as unknown as CheckpointProposalHash;
29
+ };
30
+
31
+ /** A branded Buffer32 representing a checkpoint attestation hash, used for p2p deduplication. */
32
+ export type CheckpointAttestationHash = Branded<BaseBuffer32, 'CheckpointAttestationHash'>;
33
+
34
+ /** Creates a CheckpointAttestationHash from a BaseBuffer32. */
35
+ export function CheckpointAttestationHash(buf: BaseBuffer32): CheckpointAttestationHash {
36
+ return buf as CheckpointAttestationHash;
37
+ }
38
+
39
+ /** Creates a CheckpointAttestationHash from a raw Buffer. */
40
+ CheckpointAttestationHash.fromBuffer = function (buf: Buffer): CheckpointAttestationHash {
41
+ return new Buffer32(buf) as unknown as CheckpointAttestationHash;
42
+ };
@@ -85,6 +85,11 @@ CheckpointNumber.isValid = function (value: unknown): value is CheckpointNumber
85
85
  return typeof value === 'number' && Number.isInteger(value) && value >= 0;
86
86
  };
87
87
 
88
+ /** Increments a CheckpointNumber by a given value. */
89
+ CheckpointNumber.add = function (n: CheckpointNumber, increment: number): CheckpointNumber {
90
+ return CheckpointNumber(n + increment);
91
+ };
92
+
88
93
  /** The zero checkpoint value. */
89
94
  CheckpointNumber.ZERO = CheckpointNumber(0);
90
95
 
@@ -1,4 +1,5 @@
1
1
  export { BlockNumber, BlockNumberSchema, BlockNumberPositiveSchema } from './block_number.js';
2
+ export { BlockProposalHash, CheckpointAttestationHash, CheckpointProposalHash } from './buffer32_hash.js';
2
3
  export { CheckpointNumber, CheckpointNumberSchema, CheckpointNumberPositiveSchema } from './checkpoint_number.js';
3
4
  export { EpochNumber, EpochNumberSchema } from './epoch.js';
4
5
  export { IndexWithinCheckpoint, IndexWithinCheckpointSchema } from './index_within_checkpoint.js';
@@ -73,6 +73,11 @@ SlotNumber.isValid = function (value: unknown): value is SlotNumber {
73
73
  return typeof value === 'number' && Number.isInteger(value) && value >= 0;
74
74
  };
75
75
 
76
+ /** Increments a SlotNumber by a given value. */
77
+ SlotNumber.add = function (sn: SlotNumber, increment: number): SlotNumber {
78
+ return SlotNumber(sn + increment);
79
+ };
80
+
76
81
  /**
77
82
  * The zero slot value.
78
83
  */
@@ -10,6 +10,9 @@ import { bufferToHex } from '../string/index.js';
10
10
  * A class representing a 16 byte Buffer.
11
11
  */
12
12
  export class Buffer16 {
13
+ /** Branding for nominal typing. */
14
+ declare private readonly _branding: 'Buffer16';
15
+
13
16
  /**
14
17
  * The size of the hash in bytes.
15
18
  */
@@ -7,69 +7,39 @@ import { inspect } from 'util';
7
7
  import { bufferToHex } from '../string/index.js';
8
8
 
9
9
  /**
10
- * A class representing a 32 byte Buffer.
10
+ * Abstract unbranded base class for 32-byte buffers.
11
+ * Extend this instead of Buffer32 when defining a branded subtype
12
+ * to avoid inheriting Buffer32's `_branding`.
11
13
  */
12
- export class Buffer32 {
13
- /**
14
- * The size of the hash in bytes.
15
- */
14
+ export abstract class BaseBuffer32 {
15
+ /** The size of the buffer in bytes. */
16
16
  public static SIZE = 32;
17
17
 
18
- /**
19
- * Buffer32 with value zero.
20
- */
21
- public static ZERO = new Buffer32(Buffer.alloc(Buffer32.SIZE));
22
-
23
18
  constructor(
24
- /**
25
- * The buffer containing the hash.
26
- */
19
+ /** The buffer containing the data. */
27
20
  public buffer: Buffer,
28
21
  ) {
29
- if (buffer.length !== Buffer32.SIZE) {
30
- throw new Error(`Expected buffer to have length ${Buffer32.SIZE} but was ${buffer.length}`);
22
+ if (buffer.length !== BaseBuffer32.SIZE) {
23
+ throw new Error(`Expected buffer to have length ${BaseBuffer32.SIZE} but was ${buffer.length}`);
31
24
  }
32
25
  }
33
26
 
34
- /**
35
- * Returns the raw buffer of the hash.
36
- * @returns The buffer containing the hash.
37
- */
27
+ /** Returns the raw buffer. */
38
28
  public toBuffer() {
39
29
  return this.buffer;
40
30
  }
41
31
 
42
- /**
43
- * Creates a Buffer32 from a buffer.
44
- * @param buffer - The buffer to create from.
45
- * @returns A new Buffer32 object.
46
- */
47
- public static fromBuffer(buffer: Buffer | BufferReader) {
48
- const reader = BufferReader.asReader(buffer);
49
- return new Buffer32(reader.readBytes(Buffer32.SIZE));
50
- }
51
-
52
- /**
53
- * Checks if this hash and another hash are equal.
54
- * @param hash - A hash to compare with.
55
- * @returns True if the hashes are equal, false otherwise.
56
- */
57
- public equals(hash: Buffer32): boolean {
32
+ /** Checks if this and another buffer are equal. */
33
+ public equals(hash: BaseBuffer32): boolean {
58
34
  return this.buffer.equals(hash.buffer);
59
35
  }
60
36
 
61
- /**
62
- * Returns true if this hash is zero.
63
- * @returns True if this hash is zero.
64
- */
37
+ /** Returns true if all bytes are zero. */
65
38
  public isZero(): boolean {
66
39
  return this.buffer.equals(Buffer.alloc(32, 0));
67
40
  }
68
41
 
69
- /**
70
- * Convert this hash to a hex string.
71
- * @returns The hex string.
72
- */
42
+ /** Convert to a hex string. */
73
43
  public toString() {
74
44
  return bufferToHex(this.buffer);
75
45
  }
@@ -82,16 +52,27 @@ export class Buffer32 {
82
52
  return this.toString();
83
53
  }
84
54
 
85
- /**
86
- * Convert this hash to a big int.
87
- * @returns The big int.
88
- */
55
+ /** Convert to a big int. */
89
56
  public toBigInt() {
90
- return deserializeBigInt(this.buffer, 0, Buffer32.SIZE).elem;
57
+ return deserializeBigInt(this.buffer, 0, BaseBuffer32.SIZE).elem;
91
58
  }
92
- /**
93
- * Creates a Buffer32 from a bigint.
94
- */
59
+ }
60
+
61
+ /** A branded 32-byte buffer. */
62
+ export class Buffer32 extends BaseBuffer32 {
63
+ /** Branding for nominal typing. */
64
+ declare private readonly _branding: 'Buffer32';
65
+
66
+ /** Buffer32 with value zero. */
67
+ public static ZERO = new Buffer32(Buffer.alloc(Buffer32.SIZE));
68
+
69
+ /** Creates a Buffer32 from a buffer. */
70
+ public static fromBuffer(buffer: Buffer | BufferReader) {
71
+ const reader = BufferReader.asReader(buffer);
72
+ return new Buffer32(reader.readBytes(Buffer32.SIZE));
73
+ }
74
+
75
+ /** Creates a Buffer32 from a bigint. */
95
76
  public static fromBigInt(hash: bigint) {
96
77
  return new Buffer32(serializeBigInt(hash, Buffer32.SIZE));
97
78
  }
@@ -101,8 +82,7 @@ export class Buffer32 {
101
82
  }
102
83
 
103
84
  /**
104
- * Converts this hash from a buffer of 28 bytes.
105
- * Verifies the input is 28 bytes.
85
+ * Converts from a buffer of 28 bytes.
106
86
  * @param buffer - The 28 byte buffer to construct from.
107
87
  * @returns A Buffer32 created from the input buffer with 4 bytes 0 padding at the front.
108
88
  */
@@ -114,9 +94,7 @@ export class Buffer32 {
114
94
  return new Buffer32(padded);
115
95
  }
116
96
 
117
- /**
118
- * Converts a string into a Buffer32 object.
119
- */
97
+ /** Converts a string into a Buffer32 object. */
120
98
  public static fromString(str: string): Buffer32 {
121
99
  if (str.startsWith('0x')) {
122
100
  str = str.slice(2);
@@ -127,19 +105,12 @@ export class Buffer32 {
127
105
  return new Buffer32(Buffer.from(str, 'hex'));
128
106
  }
129
107
 
130
- /**
131
- * Converts a number into a Buffer32 object.
132
- * @param num - The number to convert.
133
- * @returns A new Buffer32 object.
134
- */
108
+ /** Converts a number into a Buffer32 object. */
135
109
  public static fromNumber(num: number): Buffer32 {
136
110
  return new Buffer32(serializeBigInt(BigInt(num), Buffer32.SIZE));
137
111
  }
138
112
 
139
- /**
140
- * Generates a random Buffer32.
141
- * @returns A new Buffer32 object.
142
- */
113
+ /** Generates a random Buffer32. */
143
114
  public static random(): Buffer32 {
144
115
  return new Buffer32(Buffer.from(randomBytes(Buffer32.SIZE)));
145
116
  }
@@ -1,2 +1,3 @@
1
1
  export * from './buffer32.js';
2
2
  export * from './buffer16.js';
3
+ export * from './utils.js';
@@ -0,0 +1,8 @@
1
+ /** Returns the number of bytes in the buffer, excluding any trailing zero bytes. */
2
+ export function trimmedBytesLength(buf: Uint8Array): number {
3
+ let end = buf.length;
4
+ while (end > 0 && buf[end - 1] === 0) {
5
+ end--;
6
+ }
7
+ return end;
8
+ }
@@ -315,3 +315,17 @@ export function partition<T>(items: T[], predicate: (item: T) => boolean): [T[],
315
315
  }
316
316
  return [pass, fail];
317
317
  }
318
+
319
+ /** Partitions the given iterable into two arrays based on the predicate. */
320
+ export async function partitionAsync<T>(items: T[], predicate: (item: T) => Promise<boolean>): Promise<[T[], T[]]> {
321
+ const pass: T[] = [];
322
+ const fail: T[] = [];
323
+ for (const item of items) {
324
+ if (await predicate(item)) {
325
+ pass.push(item);
326
+ } else {
327
+ fail.push(item);
328
+ }
329
+ }
330
+ return [pass, fail];
331
+ }
@@ -1,2 +1,3 @@
1
1
  export * from './array.js';
2
+ export * from './lru_set.js';
2
3
  export * from './object.js';
@@ -0,0 +1,115 @@
1
+ /** Node in a doubly-linked list used by {@link LruSet}. */
2
+ type LruNode<T> = {
3
+ value: T;
4
+ prev: LruNode<T> | undefined;
5
+ next: LruNode<T> | undefined;
6
+ };
7
+
8
+ /**
9
+ * A bounded set with Least Recently Used (LRU) eviction.
10
+ * Both {@link has} and {@link add} count as an access and refresh the entry's
11
+ * recency, so items that are actively checked stay in the set longest.
12
+ *
13
+ * Uses a doubly-linked list for O(1) ordering and a Map for O(1) lookup.
14
+ * Head = least recent, tail = most recent.
15
+ */
16
+ export class LruSet<T> {
17
+ /** Map from value to its linked-list node for O(1) lookup. */
18
+ private readonly map = new Map<T, LruNode<T>>();
19
+ private head: LruNode<T> | undefined;
20
+ private tail: LruNode<T> | undefined;
21
+
22
+ constructor(private readonly maxSize: number) {
23
+ if (maxSize < 1) {
24
+ throw new Error('LruSet maxSize must be at least 1');
25
+ }
26
+ }
27
+
28
+ /** Number of entries in the set. */
29
+ get size(): number {
30
+ return this.map.size;
31
+ }
32
+
33
+ /**
34
+ * Returns true if the item is in the set.
35
+ * Refreshes the item's recency so it becomes the most recently used.
36
+ */
37
+ has(item: T): boolean {
38
+ const node = this.map.get(item);
39
+ if (!node) {
40
+ return false;
41
+ }
42
+ this.moveToTail(node);
43
+ return true;
44
+ }
45
+
46
+ /**
47
+ * Adds an item to the set. If the item already exists, refreshes its recency.
48
+ * If the set is at capacity, evicts the least recently used item.
49
+ */
50
+ add(item: T): void {
51
+ const existing = this.map.get(item);
52
+ if (existing) {
53
+ this.moveToTail(existing);
54
+ return;
55
+ }
56
+
57
+ if (this.map.size >= this.maxSize) {
58
+ this.evictHead();
59
+ }
60
+
61
+ const node: LruNode<T> = { value: item, prev: this.tail, next: undefined };
62
+ if (this.tail) {
63
+ this.tail.next = node;
64
+ } else {
65
+ this.head = node;
66
+ }
67
+ this.tail = node;
68
+ this.map.set(item, node);
69
+ }
70
+
71
+ /** Removes all entries from the set. */
72
+ clear(): void {
73
+ this.map.clear();
74
+ this.head = undefined;
75
+ this.tail = undefined;
76
+ }
77
+
78
+ /** Unlinks a node from its current position and relinks it at the tail. */
79
+ private moveToTail(node: LruNode<T>): void {
80
+ if (node === this.tail) {
81
+ return;
82
+ }
83
+
84
+ // Unlink
85
+ if (node.prev) {
86
+ node.prev.next = node.next;
87
+ } else {
88
+ this.head = node.next;
89
+ }
90
+ if (node.next) {
91
+ node.next.prev = node.prev;
92
+ }
93
+
94
+ // Relink at tail
95
+ node.prev = this.tail;
96
+ node.next = undefined;
97
+ if (this.tail) {
98
+ this.tail.next = node;
99
+ }
100
+ this.tail = node;
101
+ }
102
+
103
+ /** Evicts the head (least recently used) node. */
104
+ private evictHead(): void {
105
+ const oldHead = this.head!;
106
+ this.map.delete(oldHead.value);
107
+
108
+ this.head = oldHead.next;
109
+ if (this.head) {
110
+ this.head.prev = undefined;
111
+ } else {
112
+ this.tail = undefined;
113
+ }
114
+ }
115
+ }
@@ -1,7 +1,6 @@
1
1
  export type EnvVar =
2
2
  | 'REGISTRY_CONTRACT_ADDRESS'
3
3
  | 'FEE_ASSET_HANDLER_CONTRACT_ADDRESS'
4
- | 'SLASH_FACTORY_CONTRACT_ADDRESS'
5
4
  | 'ACVM_BINARY_PATH'
6
5
  | 'ACVM_WORKING_DIRECTORY'
7
6
  | 'API_KEY'
@@ -12,6 +11,10 @@ export type EnvVar =
12
11
  | 'ARCHIVER_VIEM_POLLING_INTERVAL_MS'
13
12
  | 'ARCHIVER_BATCH_SIZE'
14
13
  | 'AZTEC_ADMIN_PORT'
14
+ | 'AZTEC_NODE_DEBUG'
15
+ | 'AZTEC_ADMIN_API_KEY_HASH'
16
+ | 'AZTEC_DISABLE_ADMIN_API_KEY'
17
+ | 'AZTEC_RESET_ADMIN_API_KEY'
15
18
  | 'AZTEC_NODE_ADMIN_URL'
16
19
  | 'AZTEC_NODE_URL'
17
20
  | 'AZTEC_PORT'
@@ -20,6 +23,8 @@ export type EnvVar =
20
23
  | 'BB_WORKING_DIRECTORY'
21
24
  | 'BB_NUM_IVC_VERIFIERS'
22
25
  | 'BB_IVC_CONCURRENCY'
26
+ | 'BB_CHONK_VERIFY_MAX_BATCH'
27
+ | 'BB_CHONK_VERIFY_BATCH_CONCURRENCY'
23
28
  | 'BOOTSTRAP_NODES'
24
29
  | 'BLOB_ARCHIVE_API_URL'
25
30
  | 'BLOB_FILE_STORE_URLS'
@@ -47,7 +52,10 @@ export type EnvVar =
47
52
  | 'BOT_TX_MINED_WAIT_SECONDS'
48
53
  | 'BOT_MAX_CONSECUTIVE_ERRORS'
49
54
  | 'BOT_STOP_WHEN_UNHEALTHY'
50
- | 'BOT_AMM_TXS'
55
+ | 'BOT_MODE'
56
+ | 'BOT_L2_TO_L1_MESSAGES_PER_TX'
57
+ | 'BOT_L1_TO_L2_SEED_COUNT'
58
+ | 'BOT_L1_TO_L2_SEED_INTERVAL'
51
59
  | 'COINBASE'
52
60
  | 'CRS_PATH'
53
61
  | 'DATA_DIRECTORY'
@@ -56,6 +64,7 @@ export type EnvVar =
56
64
  | 'BLOB_SINK_MAP_SIZE_KB'
57
65
  | 'P2P_STORE_MAP_SIZE_KB'
58
66
  | 'PROVER_BROKER_STORE_MAP_SIZE_KB'
67
+ | 'SIGNING_PROTECTION_MAP_SIZE_KB'
59
68
  | 'WS_DB_MAP_SIZE_KB'
60
69
  | 'ARCHIVE_TREE_MAP_SIZE_KB'
61
70
  | 'NULLIFIER_TREE_MAP_SIZE_KB'
@@ -64,6 +73,7 @@ export type EnvVar =
64
73
  | 'PUBLIC_DATA_TREE_MAP_SIZE_KB'
65
74
  | 'DEBUG'
66
75
  | 'DEBUG_P2P_DISABLE_COLOCATION_PENALTY'
76
+ | 'ENABLE_PROVER_NODE'
67
77
  | 'ETHEREUM_HOSTS'
68
78
  | 'ETHEREUM_DEBUG_HOSTS'
69
79
  | 'ETHEREUM_ALLOW_NO_DEBUG_HOSTS'
@@ -73,8 +83,10 @@ export type EnvVar =
73
83
  | 'KEY_STORE_DIRECTORY'
74
84
  | 'L1_CHAIN_ID'
75
85
  | 'L1_CONSENSUS_HOST_URLS'
86
+ | 'ETHEREUM_HTTP_TIMEOUT_MS'
76
87
  | 'L1_CONSENSUS_HOST_API_KEYS'
77
88
  | 'L1_CONSENSUS_HOST_API_KEY_HEADERS'
89
+ | 'L1_TX_FAILED_STORE'
78
90
  | 'LOG_JSON'
79
91
  | 'LOG_MULTILINE'
80
92
  | 'LOG_NO_COLOR_PER_ACTOR'
@@ -82,7 +94,6 @@ export type EnvVar =
82
94
  | 'MNEMONIC'
83
95
  | 'NETWORK'
84
96
  | 'NETWORK_CONFIG_LOCATION'
85
- | 'NO_PXE'
86
97
  | 'USE_GCLOUD_LOGGING'
87
98
  | 'OTEL_EXPORTER_OTLP_METRICS_ENDPOINT'
88
99
  | 'OTEL_EXPORTER_OTLP_TRACES_ENDPOINT'
@@ -100,6 +111,7 @@ export type EnvVar =
100
111
  | 'P2P_BATCH_TX_REQUESTER_TX_BATCH_SIZE'
101
112
  | 'P2P_BATCH_TX_REQUESTER_BAD_PEER_THRESHOLD'
102
113
  | 'P2P_BLOCK_CHECK_INTERVAL_MS'
114
+ | 'P2P_SLOT_CHECK_INTERVAL_MS'
103
115
  | 'P2P_BLOCK_REQUEST_BATCH_SIZE'
104
116
  | 'P2P_BOOTSTRAP_NODE_ENR_VERSION_CHECK'
105
117
  | 'P2P_BOOTSTRAP_NODES_AS_FULL_PEERS'
@@ -120,6 +132,7 @@ export type EnvVar =
120
132
  | 'P2P_L2_QUEUE_SIZE'
121
133
  | 'P2P_MAX_PEERS'
122
134
  | 'P2P_PEER_CHECK_INTERVAL_MS'
135
+ | 'P2P_PEER_FAILED_BAN_TIME_MS'
123
136
  | 'P2P_PEER_PENALTY_VALUES'
124
137
  | 'P2P_QUERY_FOR_IP'
125
138
  | 'P2P_REQRESP_INDIVIDUAL_REQUEST_TIMEOUT_MS'
@@ -140,9 +153,10 @@ export type EnvVar =
140
153
  | 'P2P_PREFERRED_PEERS'
141
154
  | 'P2P_MAX_PENDING_TX_COUNT'
142
155
  | 'P2P_SEEN_MSG_CACHE_SIZE'
143
- | 'P2P_DROP_TX'
144
156
  | 'P2P_DROP_TX_CHANCE'
145
157
  | 'P2P_TX_POOL_DELETE_TXS_AFTER_REORG'
158
+ | 'P2P_MIN_TX_POOL_AGE_MS'
159
+ | 'P2P_RPC_PRICE_BUMP_PERCENTAGE'
146
160
  | 'DEBUG_P2P_INSTRUMENT_MESSAGES'
147
161
  | 'PEER_ID_PRIVATE_KEY'
148
162
  | 'PEER_ID_PRIVATE_KEY_PATH'
@@ -158,6 +172,7 @@ export type EnvVar =
158
172
  | 'PROVER_BROKER_MAX_EPOCHS_TO_KEEP_RESULTS_FOR'
159
173
  | 'PROVER_BROKER_DEBUG_REPLAY_ENABLED'
160
174
  | 'PROVER_CANCEL_JOBS_ON_STOP'
175
+ | 'PROVER_ENQUEUE_CONCURRENCY'
161
176
  | 'PROVER_COORDINATION_NODE_URLS'
162
177
  | 'PROVER_PROOF_STORE'
163
178
  | 'PROVER_FAILED_PROOF_STORE'
@@ -191,27 +206,33 @@ export type EnvVar =
191
206
  | 'SENTINEL_ENABLED'
192
207
  | 'SENTINEL_HISTORY_LENGTH_IN_EPOCHS'
193
208
  | 'SENTINEL_HISTORIC_PROVEN_PERFORMANCE_LENGTH_IN_EPOCHS'
194
- | 'SEQ_MAX_BLOCK_SIZE_IN_BYTES'
209
+ | 'SEQ_ENABLE_PROPOSER_PIPELINING'
195
210
  | 'SEQ_MAX_TX_PER_BLOCK'
211
+ | 'SEQ_MAX_TX_PER_CHECKPOINT'
196
212
  | 'SEQ_MIN_TX_PER_BLOCK'
197
213
  | 'SEQ_PUBLISH_TXS_WITH_PROPOSALS'
198
214
  | 'SEQ_MAX_DA_BLOCK_GAS'
199
215
  | 'SEQ_MAX_L2_BLOCK_GAS'
216
+ | 'SEQ_PER_BLOCK_ALLOCATION_MULTIPLIER'
217
+ | 'SEQ_REDISTRIBUTE_CHECKPOINT_BUDGET'
200
218
  | 'SEQ_PUBLISHER_PRIVATE_KEY'
201
219
  | 'SEQ_PUBLISHER_PRIVATE_KEYS'
202
220
  | 'SEQ_PUBLISHER_ADDRESSES'
203
221
  | 'SEQ_PUBLISHER_ALLOW_INVALID_STATES'
204
222
  | 'SEQ_PUBLISHER_FORWARDER_ADDRESS'
223
+ | 'PUBLISHER_FUNDING_THRESHOLD'
224
+ | 'PUBLISHER_FUNDING_AMOUNT'
205
225
  | 'SEQ_POLLING_INTERVAL_MS'
206
226
  | 'SEQ_ENFORCE_TIME_TABLE'
207
227
  | 'SEQ_L1_PUBLISHING_TIME_ALLOWANCE_IN_SLOT'
208
228
  | 'SEQ_ATTESTATION_PROPAGATION_TIME'
209
229
  | 'SEQ_BLOCK_DURATION_MS'
230
+ | 'SEQ_LAST_BLOCK_DURATION_MS'
231
+ | 'SEQ_EXPECTED_BLOCK_PROPOSALS_PER_SLOT'
210
232
  | 'SEQ_BUILD_CHECKPOINT_IF_EMPTY'
211
233
  | 'SEQ_SECONDS_BEFORE_INVALIDATING_BLOCK_AS_COMMITTEE_MEMBER'
212
234
  | 'SEQ_SECONDS_BEFORE_INVALIDATING_BLOCK_AS_NON_COMMITTEE_MEMBER'
213
- | 'SLASH_MIN_PENALTY_PERCENTAGE'
214
- | 'SLASH_MAX_PENALTY_PERCENTAGE'
235
+ | 'SEQ_SKIP_CHECKPOINT_PUBLISH_PERCENT'
215
236
  | 'SLASH_VALIDATORS_ALWAYS'
216
237
  | 'SLASH_VALIDATORS_NEVER'
217
238
  | 'SLASH_PRUNE_PENALTY'
@@ -220,6 +241,8 @@ export type EnvVar =
220
241
  | 'SLASH_INACTIVITY_TARGET_PERCENTAGE'
221
242
  | 'SLASH_INACTIVITY_CONSECUTIVE_EPOCH_THRESHOLD'
222
243
  | 'SLASH_INVALID_BLOCK_PENALTY'
244
+ | 'SLASH_DUPLICATE_PROPOSAL_PENALTY'
245
+ | 'SLASH_DUPLICATE_ATTESTATION_PENALTY'
223
246
  | 'SLASH_OVERRIDE_PAYLOAD'
224
247
  | 'SLASH_PROPOSE_INVALID_ATTESTATIONS_PENALTY'
225
248
  | 'SLASH_ATTEST_DESCENDANT_OF_INVALID_PENALTY'
@@ -234,6 +257,7 @@ export type EnvVar =
234
257
  | 'TELEMETRY'
235
258
  | 'TEST_ACCOUNTS'
236
259
  | 'SPONSORED_FPC'
260
+ | 'PREFUND_ADDRESSES'
237
261
  | 'TX_COLLECTION_FAST_NODES_TIMEOUT_BEFORE_REQ_RESP_MS'
238
262
  | 'TX_COLLECTION_SLOW_NODES_INTERVAL_MS'
239
263
  | 'TX_COLLECTION_SLOW_REQ_RESP_INTERVAL_MS'
@@ -244,9 +268,17 @@ export type EnvVar =
244
268
  | 'TX_COLLECTION_FAST_MAX_PARALLEL_REQUESTS_PER_NODE'
245
269
  | 'TX_COLLECTION_NODE_RPC_MAX_BATCH_SIZE'
246
270
  | 'TX_COLLECTION_NODE_RPC_URLS'
247
- | 'TX_COLLECTION_PROPOSAL_TX_COLLECTOR_TYPE'
271
+ | 'TX_COLLECTION_MISSING_TXS_COLLECTOR_TYPE'
272
+ | 'TX_COLLECTION_FILE_STORE_URLS'
273
+ | 'TX_COLLECTION_FILE_STORE_SLOW_DELAY_MS'
274
+ | 'TX_COLLECTION_FILE_STORE_FAST_DELAY_MS'
275
+ | 'TX_COLLECTION_FILE_STORE_FAST_WORKER_COUNT'
276
+ | 'TX_COLLECTION_FILE_STORE_SLOW_WORKER_COUNT'
277
+ | 'TX_COLLECTION_FILE_STORE_FAST_BACKOFF_BASE_MS'
278
+ | 'TX_COLLECTION_FILE_STORE_SLOW_BACKOFF_BASE_MS'
279
+ | 'TX_COLLECTION_FILE_STORE_FAST_BACKOFF_MAX_MS'
280
+ | 'TX_COLLECTION_FILE_STORE_SLOW_BACKOFF_MAX_MS'
248
281
  | 'TX_FILE_STORE_URL'
249
- | 'TX_FILE_STORE_DOWNLOAD_URL'
250
282
  | 'TX_FILE_STORE_UPLOAD_CONCURRENCY'
251
283
  | 'TX_FILE_STORE_MAX_QUEUE_SIZE'
252
284
  | 'TX_FILE_STORE_ENABLED'
@@ -255,15 +287,19 @@ export type EnvVar =
255
287
  | 'TRANSACTIONS_DISABLED'
256
288
  | 'VALIDATOR_ATTESTATIONS_POLLING_INTERVAL_MS'
257
289
  | 'VALIDATOR_DISABLED'
290
+ | 'VALIDATOR_MAX_DA_BLOCK_GAS'
291
+ | 'VALIDATOR_MAX_L2_BLOCK_GAS'
292
+ | 'VALIDATOR_MAX_TX_PER_BLOCK'
293
+ | 'VALIDATOR_MAX_TX_PER_CHECKPOINT'
258
294
  | 'VALIDATOR_PRIVATE_KEYS'
259
295
  | 'VALIDATOR_PRIVATE_KEY'
260
- | 'VALIDATOR_REEXECUTE'
261
296
  | 'VALIDATOR_ADDRESSES'
262
297
  | 'ROLLUP_VERSION'
263
298
  | 'WS_BLOCK_CHECK_INTERVAL_MS'
264
299
  | 'WS_BLOCK_REQUEST_BATCH_SIZE'
265
300
  | 'L1_READER_VIEM_POLLING_INTERVAL_MS'
266
301
  | 'WS_DATA_DIRECTORY'
302
+ | 'WS_NUM_HISTORIC_CHECKPOINTS'
267
303
  | 'WS_NUM_HISTORIC_BLOCKS'
268
304
  | 'ETHEREUM_SLOT_DURATION'
269
305
  | 'AZTEC_SLOT_DURATION'
@@ -289,7 +325,7 @@ export type EnvVar =
289
325
  | 'AZTEC_SLASH_AMOUNT_SMALL'
290
326
  | 'AZTEC_SLASH_AMOUNT_MEDIUM'
291
327
  | 'AZTEC_SLASH_AMOUNT_LARGE'
292
- | 'AZTEC_SLASHER_FLAVOR'
328
+ | 'AZTEC_SLASHER_ENABLED'
293
329
  | 'AZTEC_GOVERNANCE_PROPOSER_QUORUM'
294
330
  | 'AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE'
295
331
  | 'AZTEC_GOVERNANCE_VOTING_DURATION'
@@ -318,12 +354,12 @@ export type EnvVar =
318
354
  | 'K8S_POD_NAME'
319
355
  | 'K8S_POD_UID'
320
356
  | 'K8S_NAMESPACE_NAME'
321
- | 'VALIDATOR_REEXECUTE_DEADLINE_MS'
322
- | 'AUTO_UPDATE'
323
- | 'AUTO_UPDATE_URL'
357
+ | 'ENABLE_VERSION_CHECK'
324
358
  | 'WEB3_SIGNER_URL'
325
359
  | 'SKIP_ARCHIVER_INITIAL_SYNC'
326
360
  | 'BLOB_ALLOW_EMPTY_SOURCES'
361
+ | 'BLOB_PREFER_FILESTORES'
362
+ | 'BLOB_FILE_STORE_TIMEOUT_MS'
327
363
  | 'FISHERMAN_MODE'
328
364
  | 'MAX_ALLOWED_ETH_CLIENT_DRIFT_SECONDS'
329
365
  | 'LEGACY_BLS_CLI'