@aztec/foundation 0.0.1-commit.64b6bbb → 0.0.1-commit.69c59a8b3

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 (187) hide show
  1. package/dest/branded-types/buffer32_hash.d.ts +24 -0
  2. package/dest/branded-types/buffer32_hash.d.ts.map +1 -0
  3. package/dest/branded-types/buffer32_hash.js +19 -0
  4. package/dest/branded-types/checkpoint_number.d.ts +4 -1
  5. package/dest/branded-types/checkpoint_number.d.ts.map +1 -1
  6. package/dest/branded-types/checkpoint_number.js +3 -0
  7. package/dest/branded-types/index.d.ts +2 -1
  8. package/dest/branded-types/index.d.ts.map +1 -1
  9. package/dest/branded-types/index.js +1 -0
  10. package/dest/branded-types/slot.d.ts +4 -1
  11. package/dest/branded-types/slot.d.ts.map +1 -1
  12. package/dest/branded-types/slot.js +3 -0
  13. package/dest/buffer/buffer16.d.ts +3 -1
  14. package/dest/buffer/buffer16.d.ts.map +1 -1
  15. package/dest/buffer/buffer32.d.ts +28 -61
  16. package/dest/buffer/buffer32.d.ts.map +1 -1
  17. package/dest/buffer/buffer32.js +26 -60
  18. package/dest/buffer/index.d.ts +2 -1
  19. package/dest/buffer/index.d.ts.map +1 -1
  20. package/dest/buffer/index.js +1 -0
  21. package/dest/buffer/utils.d.ts +3 -0
  22. package/dest/buffer/utils.d.ts.map +1 -0
  23. package/dest/buffer/utils.js +7 -0
  24. package/dest/collection/array.d.ts +3 -1
  25. package/dest/collection/array.d.ts.map +1 -1
  26. package/dest/collection/array.js +15 -0
  27. package/dest/collection/index.d.ts +2 -1
  28. package/dest/collection/index.d.ts.map +1 -1
  29. package/dest/collection/index.js +1 -0
  30. package/dest/collection/lru_set.d.ts +35 -0
  31. package/dest/collection/lru_set.d.ts.map +1 -0
  32. package/dest/collection/lru_set.js +95 -0
  33. package/dest/config/env_var.d.ts +2 -2
  34. package/dest/config/env_var.d.ts.map +1 -1
  35. package/dest/config/index.d.ts +48 -30
  36. package/dest/config/index.d.ts.map +1 -1
  37. package/dest/config/index.js +35 -29
  38. package/dest/config/network_config.d.ts +19 -1
  39. package/dest/config/network_config.d.ts.map +1 -1
  40. package/dest/config/network_config.js +4 -1
  41. package/dest/config/network_name.d.ts +2 -2
  42. package/dest/config/network_name.d.ts.map +1 -1
  43. package/dest/config/network_name.js +2 -0
  44. package/dest/crypto/aes128/index.d.ts +2 -1
  45. package/dest/crypto/aes128/index.d.ts.map +1 -1
  46. package/dest/crypto/aes128/index.js +11 -2
  47. package/dest/crypto/bls/bn254_keystore.d.ts +1 -10
  48. package/dest/crypto/bls/bn254_keystore.d.ts.map +1 -1
  49. package/dest/crypto/bls/bn254_keystore.js +0 -17
  50. package/dest/crypto/poseidon/index.d.ts +1 -1
  51. package/dest/crypto/poseidon/index.d.ts.map +1 -1
  52. package/dest/crypto/poseidon/index.js +40 -33
  53. package/dest/crypto/secp256k1-signer/utils.d.ts +12 -1
  54. package/dest/crypto/secp256k1-signer/utils.d.ts.map +1 -1
  55. package/dest/crypto/secp256k1-signer/utils.js +26 -0
  56. package/dest/curves/bls12/field.d.ts +1 -1
  57. package/dest/curves/bls12/field.d.ts.map +1 -1
  58. package/dest/curves/bls12/field.js +0 -5
  59. package/dest/curves/bn254/field.d.ts +18 -16
  60. package/dest/curves/bn254/field.d.ts.map +1 -1
  61. package/dest/curves/bn254/field.js +23 -15
  62. package/dest/curves/grumpkin/point.d.ts +4 -4
  63. package/dest/curves/grumpkin/point.d.ts.map +1 -1
  64. package/dest/curves/grumpkin/point.js +7 -4
  65. package/dest/eth-address/index.d.ts +1 -1
  66. package/dest/eth-address/index.d.ts.map +1 -1
  67. package/dest/eth-address/index.js +0 -3
  68. package/dest/eth-signature/eth_signature.d.ts +2 -1
  69. package/dest/eth-signature/eth_signature.d.ts.map +1 -1
  70. package/dest/eth-signature/eth_signature.js +7 -2
  71. package/dest/fifo/fifo_frame_reader.d.ts +41 -0
  72. package/dest/fifo/fifo_frame_reader.d.ts.map +1 -0
  73. package/dest/fifo/fifo_frame_reader.js +74 -0
  74. package/dest/fifo/index.d.ts +2 -0
  75. package/dest/fifo/index.d.ts.map +1 -0
  76. package/dest/fifo/index.js +1 -0
  77. package/dest/jest/setup.js +24 -0
  78. package/dest/json-rpc/client/fetch.d.ts +1 -1
  79. package/dest/json-rpc/client/fetch.d.ts.map +1 -1
  80. package/dest/json-rpc/client/fetch.js +4 -3
  81. package/dest/json-rpc/client/safe_json_rpc_client.d.ts +2 -1
  82. package/dest/json-rpc/client/safe_json_rpc_client.d.ts.map +1 -1
  83. package/dest/json-rpc/client/safe_json_rpc_client.js +1 -1
  84. package/dest/json-rpc/client/undici.d.ts +1 -1
  85. package/dest/json-rpc/client/undici.d.ts.map +1 -1
  86. package/dest/json-rpc/client/undici.js +5 -3
  87. package/dest/json-rpc/server/api_key_auth.d.ts +19 -0
  88. package/dest/json-rpc/server/api_key_auth.d.ts.map +1 -0
  89. package/dest/json-rpc/server/api_key_auth.js +57 -0
  90. package/dest/json-rpc/server/index.d.ts +2 -1
  91. package/dest/json-rpc/server/index.d.ts.map +1 -1
  92. package/dest/json-rpc/server/index.js +1 -0
  93. package/dest/log/bigint-utils.d.ts +5 -0
  94. package/dest/log/bigint-utils.d.ts.map +1 -0
  95. package/dest/log/bigint-utils.js +21 -0
  96. package/dest/log/gcloud-logger-config.d.ts +1 -1
  97. package/dest/log/gcloud-logger-config.d.ts.map +1 -1
  98. package/dest/log/gcloud-logger-config.js +3 -0
  99. package/dest/log/pino-logger.d.ts +1 -1
  100. package/dest/log/pino-logger.d.ts.map +1 -1
  101. package/dest/log/pino-logger.js +21 -2
  102. package/dest/queue/batch_queue.d.ts +1 -1
  103. package/dest/queue/batch_queue.d.ts.map +1 -1
  104. package/dest/queue/batch_queue.js +1 -0
  105. package/dest/retry/index.d.ts +12 -1
  106. package/dest/retry/index.d.ts.map +1 -1
  107. package/dest/retry/index.js +21 -0
  108. package/dest/schemas/api.d.ts +2 -2
  109. package/dest/schemas/api.d.ts.map +1 -1
  110. package/dest/serialize/buffer_reader.d.ts +8 -1
  111. package/dest/serialize/buffer_reader.d.ts.map +1 -1
  112. package/dest/serialize/buffer_reader.js +13 -0
  113. package/dest/serialize/serialize.d.ts +19 -1
  114. package/dest/serialize/serialize.d.ts.map +1 -1
  115. package/dest/serialize/serialize.js +31 -0
  116. package/dest/sleep/index.d.ts +2 -1
  117. package/dest/sleep/index.d.ts.map +1 -1
  118. package/dest/sleep/index.js +10 -1
  119. package/dest/string/index.js +1 -1
  120. package/dest/timer/date.d.ts +3 -1
  121. package/dest/timer/date.d.ts.map +1 -1
  122. package/dest/timer/date.js +4 -0
  123. package/dest/transport/dispatch/create_dispatch_proxy.d.ts +11 -2
  124. package/dest/transport/dispatch/create_dispatch_proxy.d.ts.map +1 -1
  125. package/dest/transport/index.d.ts +1 -2
  126. package/dest/transport/index.d.ts.map +1 -1
  127. package/dest/transport/index.js +0 -1
  128. package/dest/transport/transport_client.js +2 -2
  129. package/dest/trees/indexed_merkle_tree_calculator.d.ts +1 -1
  130. package/dest/trees/indexed_merkle_tree_calculator.d.ts.map +1 -1
  131. package/dest/trees/indexed_merkle_tree_calculator.js +5 -1
  132. package/package.json +3 -2
  133. package/src/branded-types/buffer32_hash.ts +42 -0
  134. package/src/branded-types/checkpoint_number.ts +5 -0
  135. package/src/branded-types/index.ts +1 -0
  136. package/src/branded-types/slot.ts +5 -0
  137. package/src/buffer/buffer16.ts +3 -0
  138. package/src/buffer/buffer32.ts +36 -65
  139. package/src/buffer/index.ts +1 -0
  140. package/src/buffer/utils.ts +8 -0
  141. package/src/collection/array.ts +14 -0
  142. package/src/collection/index.ts +1 -0
  143. package/src/collection/lru_set.ts +115 -0
  144. package/src/config/env_var.ts +43 -12
  145. package/src/config/index.ts +110 -83
  146. package/src/config/network_config.ts +3 -0
  147. package/src/config/network_name.ts +4 -1
  148. package/src/crypto/aes128/index.ts +11 -2
  149. package/src/crypto/bls/bn254_keystore.ts +0 -23
  150. package/src/crypto/poseidon/index.ts +42 -34
  151. package/src/crypto/secp256k1-signer/utils.ts +32 -0
  152. package/src/curves/bls12/field.ts +0 -7
  153. package/src/curves/bn254/field.ts +31 -33
  154. package/src/curves/grumpkin/point.ts +6 -3
  155. package/src/eth-address/index.ts +0 -4
  156. package/src/eth-signature/eth_signature.ts +7 -1
  157. package/src/fifo/fifo_frame_reader.ts +98 -0
  158. package/src/fifo/index.ts +1 -0
  159. package/src/jest/setup.mjs +27 -0
  160. package/src/json-rpc/client/fetch.ts +4 -3
  161. package/src/json-rpc/client/safe_json_rpc_client.ts +2 -0
  162. package/src/json-rpc/client/undici.ts +5 -3
  163. package/src/json-rpc/server/api_key_auth.ts +63 -0
  164. package/src/json-rpc/server/index.ts +1 -0
  165. package/src/log/bigint-utils.ts +25 -0
  166. package/src/log/gcloud-logger-config.ts +5 -0
  167. package/src/log/pino-logger.ts +23 -2
  168. package/src/queue/batch_queue.ts +1 -0
  169. package/src/retry/index.ts +30 -0
  170. package/src/schemas/api.ts +4 -1
  171. package/src/serialize/buffer_reader.ts +15 -0
  172. package/src/serialize/serialize.ts +32 -0
  173. package/src/sleep/index.ts +10 -1
  174. package/src/string/index.ts +1 -1
  175. package/src/timer/date.ts +6 -0
  176. package/src/transport/dispatch/create_dispatch_proxy.ts +11 -1
  177. package/src/transport/index.ts +0 -1
  178. package/src/transport/transport_client.ts +2 -2
  179. package/src/trees/indexed_merkle_tree_calculator.ts +5 -1
  180. package/dest/crypto/serialize.d.ts +0 -51
  181. package/dest/crypto/serialize.d.ts.map +0 -1
  182. package/dest/crypto/serialize.js +0 -68
  183. package/dest/transport/dispatch/create_dispatch_fn.d.ts +0 -25
  184. package/dest/transport/dispatch/create_dispatch_fn.d.ts.map +0 -1
  185. package/dest/transport/dispatch/create_dispatch_fn.js +0 -17
  186. package/src/crypto/serialize.ts +0 -85
  187. package/src/transport/dispatch/create_dispatch_fn.ts +0 -35
@@ -10,14 +10,15 @@ export type { EnvVar, NetworkNames };
10
10
  export type { NetworkConfig, NetworkConfigMap } from './network_config.js';
11
11
  export { NetworkConfigMapSchema, NetworkConfigSchema } from './network_config.js';
12
12
 
13
- export interface ConfigMapping {
13
+ export interface ConfigMapping<T> {
14
14
  env?: EnvVar;
15
- parseEnv?: (val: string) => any;
16
- defaultValue?: any;
15
+ /** Parse an env-var string into `T`. Throws on invalid input. */
16
+ parseEnv?: (val: string) => T;
17
+ defaultValue?: T;
17
18
  printDefault?: (val: any) => string;
18
19
  description: string;
19
20
  isBoolean?: boolean;
20
- nested?: Record<string, ConfigMapping>;
21
+ nested?: Record<string, ConfigMapping<any>>;
21
22
  fallback?: EnvVar[];
22
23
  /**
23
24
  * List of deprecated env vars that are still supported but will log a warning.
@@ -30,7 +31,9 @@ export function isBooleanConfigValue<T>(obj: T, key: keyof T): boolean {
30
31
  return typeof obj[key] === 'boolean';
31
32
  }
32
33
 
33
- export type ConfigMappingsType<T> = Record<keyof T, ConfigMapping>;
34
+ export type ConfigMappingsType<T> = {
35
+ [K in keyof T]-?: ConfigMapping<Required<T>[K]>;
36
+ };
34
37
 
35
38
  /**
36
39
  * Shared utility function to get a value from environment variables with fallback support.
@@ -66,8 +69,8 @@ export function getValueFromEnvWithFallback<T>(
66
69
  }
67
70
  }
68
71
 
69
- // Parse the value if needed
70
- if (value !== undefined) {
72
+ // Parse the value if needed. Empty strings are treated as "not set".
73
+ if (value !== undefined && value !== '') {
71
74
  return parseFunc ? parseFunc(value) : (value as unknown as T);
72
75
  }
73
76
 
@@ -84,7 +87,11 @@ export function getConfigFromMappings<T>(configMappings: ConfigMappingsType<T>):
84
87
  (config as any)[key] = getConfigFromMappings(nested);
85
88
  } else {
86
89
  // Use the shared utility function
87
- (config as any)[key] = getValueFromEnvWithFallback(env, parseEnv, defaultValue, fallback);
90
+ try {
91
+ (config as any)[key] = getValueFromEnvWithFallback(env, parseEnv, defaultValue, fallback);
92
+ } catch (e: any) {
93
+ throw new Error(`Failed to parse config '${key}' (env: ${env ?? 'none'}): ${e.message}`);
94
+ }
88
95
 
89
96
  // Check for deprecated env vars and warn if logger is set
90
97
  if (deprecatedFallback?.length) {
@@ -123,7 +130,7 @@ export function omitConfigMappings<T, K extends keyof T>(
123
130
  * @param defaultVal - The default numerical value to use if the environment variable is not set or is invalid
124
131
  * @returns Object with parseEnv and default values for a numerical config value
125
132
  */
126
- export function numberConfigHelper(defaultVal: number): Pick<ConfigMapping, 'parseEnv' | 'defaultValue'> {
133
+ export function numberConfigHelper(defaultVal: number): Pick<ConfigMapping<number>, 'parseEnv' | 'defaultValue'> {
127
134
  return {
128
135
  parseEnv: (val: string) => safeParseNumber(val, defaultVal),
129
136
  defaultValue: defaultVal,
@@ -138,7 +145,7 @@ export function numberConfigHelper(defaultVal: number): Pick<ConfigMapping, 'par
138
145
  export function floatConfigHelper(
139
146
  defaultVal: number,
140
147
  validationFn?: (val: number) => void,
141
- ): Pick<ConfigMapping, 'parseEnv' | 'defaultValue'> {
148
+ ): Pick<ConfigMapping<number>, 'parseEnv' | 'defaultValue'> {
142
149
  return {
143
150
  parseEnv: (val: string): number => {
144
151
  const parsed = safeParseFloat(val, defaultVal);
@@ -152,7 +159,7 @@ export function floatConfigHelper(
152
159
  /**
153
160
  * Parses an environment variable to a 0-1 percentage value
154
161
  */
155
- export function percentageConfigHelper(defaultVal: number): Pick<ConfigMapping, 'parseEnv' | 'defaultValue'> {
162
+ export function percentageConfigHelper(defaultVal: number): Pick<ConfigMapping<number>, 'parseEnv' | 'defaultValue'> {
156
163
  return {
157
164
  parseEnv: (val: string): number => {
158
165
  const parsed = safeParseFloat(val, defaultVal);
@@ -171,11 +178,27 @@ export function percentageConfigHelper(defaultVal: number): Pick<ConfigMapping,
171
178
  * @param defaultVal - The default numerical value to use if the environment variable is not set or is invalid
172
179
  * @returns Object with parseEnv and default values for a numerical config value
173
180
  */
174
- export function bigintConfigHelper(defaultVal?: bigint): Pick<ConfigMapping, 'parseEnv' | 'defaultValue'> {
181
+ export function bigintConfigHelper(defaultVal: bigint): Pick<ConfigMapping<bigint>, 'parseEnv' | 'defaultValue'>;
182
+ export function bigintConfigHelper(): Pick<ConfigMapping<bigint | undefined>, 'parseEnv' | 'defaultValue'>;
183
+ export function bigintConfigHelper(
184
+ defaultVal?: bigint,
185
+ ): Pick<ConfigMapping<bigint | undefined>, 'parseEnv' | 'defaultValue'> {
175
186
  return {
176
187
  parseEnv: (val: string) => {
177
- if (val === '') {
178
- return defaultVal;
188
+ // Handle scientific notation (e.g. "1e+23", "2E23") which BigInt() doesn't accept directly.
189
+ // We parse it losslessly using bigint arithmetic instead of going through float64.
190
+ if (/[eE]/.test(val)) {
191
+ const match = val.match(/^(-?\d+(?:\.(\d+))?)[eE]([+-]?\d+)$/);
192
+ if (!match) {
193
+ throw new Error(`Cannot convert '${val}' to a BigInt`);
194
+ }
195
+ const digits = match[1].replace('.', '');
196
+ const decimalPlaces = match[2]?.length ?? 0;
197
+ const exponent = parseInt(match[3], 10) - decimalPlaces;
198
+ if (exponent < 0) {
199
+ throw new Error(`Cannot convert '${val}' to a BigInt: result is not an integer`);
200
+ }
201
+ return BigInt(digits) * 10n ** BigInt(exponent);
179
202
  }
180
203
  return BigInt(val);
181
204
  },
@@ -185,32 +208,37 @@ export function bigintConfigHelper(defaultVal?: bigint): Pick<ConfigMapping, 'pa
185
208
 
186
209
  /**
187
210
  * Generates parseEnv for an optional numerical config value.
211
+ * Empty strings are already handled by getValueFromEnvWithFallback.
188
212
  */
189
- export function optionalNumberConfigHelper(): Pick<ConfigMapping, 'parseEnv'> {
213
+ export function optionalNumberConfigHelper(): Pick<ConfigMapping<number>, 'parseEnv'> {
190
214
  return {
191
- parseEnv: (val: string | undefined) => {
192
- if (val !== undefined && val.length > 0) {
193
- const parsedValue = parseInt(val);
194
- return Number.isSafeInteger(parsedValue) ? parsedValue : undefined;
215
+ parseEnv: (val: string) => {
216
+ const parsedValue = parseInt(val);
217
+ if (!Number.isSafeInteger(parsedValue)) {
218
+ throw new Error(`Invalid number: ${val}`);
195
219
  }
196
- return undefined;
220
+ return parsedValue;
197
221
  },
198
222
  };
199
223
  }
200
224
 
201
225
  /** Generates parseEnv for an enum-like config value. */
226
+ export function enumConfigHelper<T extends string>(
227
+ values: T[],
228
+ defaultValue: NoInfer<T>,
229
+ ): Pick<ConfigMapping<T>, 'parseEnv' | 'defaultValue'>;
230
+ export function enumConfigHelper<T extends string>(
231
+ values: T[],
232
+ ): Pick<ConfigMapping<T | undefined>, 'parseEnv' | 'defaultValue'>;
202
233
  export function enumConfigHelper<T extends string>(
203
234
  values: T[],
204
235
  defaultValue?: NoInfer<T>,
205
- ): Pick<ConfigMapping, 'parseEnv' | 'defaultValue'> {
236
+ ): Pick<ConfigMapping<T | undefined>, 'parseEnv' | 'defaultValue'> {
206
237
  return {
207
238
  parseEnv: (val: string) => {
208
- const sanitizedVal = (val ?? '').trim().toLowerCase();
209
- if (values.includes(sanitizedVal as T)) {
210
- return sanitizedVal as T;
211
- }
212
- if (!val && defaultValue) {
213
- return defaultValue;
239
+ const sanitizedVal = val.trim().toLowerCase();
240
+ if (values.some(v => v.toLowerCase() === sanitizedVal)) {
241
+ return values.find(v => v.toLowerCase() === sanitizedVal)!;
214
242
  }
215
243
  throw new Error(`Invalid config value '${val}' (must be one of ${values.join(', ')})`);
216
244
  },
@@ -225,7 +253,9 @@ export function enumConfigHelper<T extends string>(
225
253
  */
226
254
  export function booleanConfigHelper(
227
255
  defaultVal = false,
228
- ): Required<Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & { parseVal: (val: string) => boolean }> {
256
+ ): Required<
257
+ Pick<ConfigMapping<boolean>, 'parseEnv' | 'defaultValue' | 'isBoolean'> & { parseVal: (val: string) => boolean }
258
+ > {
229
259
  const parse = (val: string | boolean) => (typeof val === 'boolean' ? val : parseBooleanEnv(val));
230
260
  return {
231
261
  parseEnv: parse,
@@ -235,91 +265,88 @@ export function booleanConfigHelper(
235
265
  };
236
266
  }
237
267
 
238
- export function secretValueConfigHelper<T>(parse: (val: string | undefined) => T): Required<
239
- Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
240
- parseVal: (val: string) => SecretValue<T>;
241
- }
242
- > {
268
+ export function secretValueConfigHelper<T>(parse: (val: string | undefined) => T): Pick<
269
+ ConfigMapping<SecretValue<T>>,
270
+ 'parseEnv' | 'defaultValue'
271
+ > & {
272
+ parseVal: (val: string) => SecretValue<T>;
273
+ } {
243
274
  const wrap = (val: string) => new SecretValue(parse(val));
244
275
  return {
245
276
  parseEnv: wrap,
246
277
  parseVal: wrap,
247
278
  defaultValue: new SecretValue(parse(undefined)),
248
- isBoolean: true,
249
279
  };
250
280
  }
251
281
 
252
282
  export { parseBooleanEnv } from './parse-env.js';
253
283
 
254
- export function secretStringConfigHelper(): Required<
255
- Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
256
- parseVal: (val: string) => SecretValue<string | undefined>;
257
- }
258
- >;
259
- export function secretStringConfigHelper(defaultValue: string): Required<
260
- Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
261
- parseVal: (val: string) => SecretValue<string>;
262
- }
263
- >;
264
- export function secretStringConfigHelper(defaultValue?: string): Required<
265
- Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
266
- parseVal: (val: string) => SecretValue<string | typeof defaultValue>;
267
- }
268
- > {
284
+ export function secretStringConfigHelper(): {
285
+ parseEnv: (val: string) => SecretValue<string>;
286
+ parseVal: (val: string) => SecretValue<string>;
287
+ defaultValue: undefined;
288
+ };
289
+ export function secretStringConfigHelper(defaultValue: string): {
290
+ parseEnv: (val: string) => SecretValue<string>;
291
+ parseVal: (val: string) => SecretValue<string>;
292
+ defaultValue: SecretValue<string>;
293
+ };
294
+ export function secretStringConfigHelper(defaultValue?: string): {
295
+ parseEnv: (val: string) => SecretValue<string>;
296
+ parseVal: (val: string) => SecretValue<string>;
297
+ defaultValue: SecretValue<string> | undefined;
298
+ } {
269
299
  const parse = (val: string) => new SecretValue(val);
270
300
  return {
271
301
  parseEnv: parse,
272
302
  parseVal: parse,
273
303
  defaultValue: defaultValue !== undefined ? new SecretValue(defaultValue) : undefined,
274
- isBoolean: true,
275
304
  };
276
305
  }
277
306
 
278
- export function secretFrConfigHelper(): Required<
279
- Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
280
- parseVal: (val: string) => SecretValue<Fr | undefined>;
281
- }
282
- >;
283
- export function secretFrConfigHelper(defaultValue: Fr): Required<
284
- Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
285
- parseVal: (val: string) => SecretValue<Fr>;
286
- }
287
- >;
288
- export function secretFrConfigHelper(defaultValue?: Fr): Required<
289
- Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
290
- parseVal: (val: string) => SecretValue<Fr | typeof defaultValue>;
291
- }
292
- > {
307
+ export function secretFrConfigHelper(): {
308
+ parseEnv: (val: string) => SecretValue<Fr>;
309
+ parseVal: (val: string) => SecretValue<Fr>;
310
+ defaultValue: undefined;
311
+ };
312
+ export function secretFrConfigHelper(defaultValue: Fr): {
313
+ parseEnv: (val: string) => SecretValue<Fr>;
314
+ parseVal: (val: string) => SecretValue<Fr>;
315
+ defaultValue: SecretValue<Fr>;
316
+ };
317
+ export function secretFrConfigHelper(defaultValue?: Fr): {
318
+ parseEnv: (val: string) => SecretValue<Fr>;
319
+ parseVal: (val: string) => SecretValue<Fr>;
320
+ defaultValue: SecretValue<Fr> | undefined;
321
+ } {
293
322
  const parse = (val: string) => new SecretValue(Fr.fromHexString(val));
294
323
  return {
295
324
  parseEnv: parse,
296
325
  parseVal: parse,
297
326
  defaultValue: defaultValue !== undefined ? new SecretValue(defaultValue) : undefined,
298
- isBoolean: true,
299
327
  };
300
328
  }
301
329
 
302
- export function secretFqConfigHelper(defaultValue: Fq): Required<
303
- Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
304
- parseVal: (val: string) => SecretValue<Fq>;
305
- }
306
- >;
307
- export function secretFqConfigHelper(): Required<
308
- Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
309
- parseVal: (val: string) => SecretValue<Fq | undefined>;
310
- }
311
- >;
312
- export function secretFqConfigHelper(defaultValue?: Fq): Required<
313
- Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
314
- parseVal: (val: string) => SecretValue<Fq | typeof defaultValue>;
315
- }
316
- > {
330
+ export function secretFqConfigHelper(): {
331
+ parseEnv: (val: string) => SecretValue<Fq>;
332
+ parseVal: (val: string) => SecretValue<Fq>;
333
+ defaultValue: undefined;
334
+ };
335
+ export function secretFqConfigHelper(defaultValue: Fq): {
336
+ parseEnv: (val: string) => SecretValue<Fq>;
337
+ parseVal: (val: string) => SecretValue<Fq>;
338
+ defaultValue: SecretValue<Fq>;
339
+ };
340
+ export function secretFqConfigHelper(defaultValue?: Fq): {
341
+ parseEnv: (val: string) => SecretValue<Fq>;
342
+ parseVal: (val: string) => SecretValue<Fq>;
343
+ defaultValue: SecretValue<Fq> | undefined;
344
+ } {
317
345
  const parse = (val: string) => new SecretValue(Fq.fromHexString(val));
318
346
  return {
319
347
  parseEnv: parse,
320
348
  parseVal: parse,
321
- defaultValue: typeof defaultValue !== 'undefined' ? new SecretValue(defaultValue) : undefined,
322
- isBoolean: true,
349
+ defaultValue: defaultValue !== undefined ? new SecretValue(defaultValue) : undefined,
323
350
  };
324
351
  }
325
352
 
@@ -5,10 +5,13 @@ export const NetworkConfigSchema = z
5
5
  bootnodes: z.array(z.string()),
6
6
  snapshots: z.array(z.string()),
7
7
  blobFileStoreUrls: z.array(z.string()).optional(),
8
+ txCollectionFileStoreUrls: z.array(z.string()).optional(),
8
9
  registryAddress: z.string(),
9
10
  feeAssetHandlerAddress: z.string().optional(),
10
11
  l1ChainId: z.number(),
11
12
  blockDurationMs: z.number().positive().optional(),
13
+ txPublicSetupAllowListExtend: z.string().optional(),
14
+ nodeVersion: z.string().optional(),
12
15
  })
13
16
  .passthrough(); // Allow additional unknown fields to pass through
14
17
 
@@ -5,7 +5,8 @@ export type NetworkNames =
5
5
  | 'testnet'
6
6
  | 'mainnet'
7
7
  | 'next-net'
8
- | 'devnet';
8
+ | 'devnet'
9
+ | `v${number}-devnet-${number}`;
9
10
 
10
11
  export function getActiveNetworkName(name?: string): NetworkNames {
11
12
  const network = name || process.env.NETWORK;
@@ -23,6 +24,8 @@ export function getActiveNetworkName(name?: string): NetworkNames {
23
24
  return 'next-net';
24
25
  } else if (network === 'devnet') {
25
26
  return 'devnet';
27
+ } else if (/^v\d+-devnet-\d+$/.test(network)) {
28
+ return network as `v${number}-devnet-${number}`;
26
29
  }
27
30
  throw new Error(`Unknown network: ${network}`);
28
31
  }
@@ -59,10 +59,19 @@ export class Aes128 {
59
59
  * @param iv - AES initialization vector.
60
60
  * @param key - Key to decrypt with.
61
61
  * @returns Decrypted data.
62
+ * @throws If the decrypted buffer has invalid PKCS#7 padding.
62
63
  */
63
64
  public async decryptBufferCBC(data: Uint8Array, iv: Uint8Array, key: Uint8Array) {
64
65
  const paddedBuffer = await this.decryptBufferCBCKeepPadding(data, iv, key);
65
- const paddingToRemove = paddedBuffer[paddedBuffer.length - 1];
66
- return paddedBuffer.subarray(0, paddedBuffer.length - paddingToRemove);
66
+ const paddingLen = paddedBuffer[paddedBuffer.length - 1];
67
+ if (paddingLen === 0 || paddingLen > 16) {
68
+ throw new Error(`Invalid PKCS#7 padding length: ${paddingLen}`);
69
+ }
70
+ for (let i = paddedBuffer.length - paddingLen; i < paddedBuffer.length; i++) {
71
+ if (paddedBuffer[i] !== paddingLen) {
72
+ throw new Error('Invalid PKCS#7 padding');
73
+ }
74
+ }
75
+ return paddedBuffer.subarray(0, paddedBuffer.length - paddingLen);
67
76
  }
68
77
  }
@@ -262,26 +262,3 @@ export function decryptBn254KeystoreFromObject(keystore: Bn254Keystore, password
262
262
  throw new Bn254KeystoreError(`Failed to decrypt keystore: ${String(error)}`, error as Error);
263
263
  }
264
264
  }
265
-
266
- /**
267
- * Validates that a decrypted private key matches the public key in the keystore.
268
- *
269
- * @param privateKeyHex - Decrypted private key (0x-prefixed)
270
- * @param expectedPubkey - Expected public key from keystore
271
- * @param computePublicKey - Function to compute public key from private key
272
- * @returns true if keys match, false otherwise
273
- */
274
- export function verifyBn254Keypair(
275
- privateKeyHex: string,
276
- expectedPubkey: string,
277
- computePublicKey: (privateKey: string) => string,
278
- ): boolean {
279
- try {
280
- const computedPubkey = computePublicKey(privateKeyHex);
281
- const normalizedExpected = expectedPubkey.toLowerCase().replace(/^0x/i, '');
282
- const normalizedComputed = computedPubkey.toLowerCase().replace(/^0x/i, '');
283
- return normalizedExpected === normalizedComputed;
284
- } catch {
285
- return false;
286
- }
287
- }
@@ -1,21 +1,35 @@
1
- import { BarretenbergSync } from '@aztec/bb.js';
1
+ import { Barretenberg, BarretenbergSync } from '@aztec/bb.js';
2
2
 
3
3
  import { Fr } from '../../curves/bn254/field.js';
4
4
  import { type Fieldable, serializeToFields } from '../../serialize/serialize.js';
5
5
 
6
+ const IS_BROWSER = typeof self !== 'undefined';
7
+
8
+ async function poseidon2HashFields(inputFields: Fr[]): Promise<Fr> {
9
+ if (IS_BROWSER) {
10
+ await BarretenbergSync.initSingleton();
11
+ const api = BarretenbergSync.getSingleton();
12
+ const response = api.poseidon2Hash({
13
+ inputs: inputFields.map(i => i.toBuffer()),
14
+ });
15
+ return Fr.fromBuffer(Buffer.from(response.hash));
16
+ } else {
17
+ await Barretenberg.initSingleton();
18
+ const api = Barretenberg.getSingleton();
19
+ const response = await api.poseidon2Hash({
20
+ inputs: inputFields.map(i => i.toBuffer()),
21
+ });
22
+ return Fr.fromBuffer(Buffer.from(response.hash));
23
+ }
24
+ }
25
+
6
26
  /**
7
27
  * Create a poseidon hash (field) from an array of input fields.
8
28
  * @param input - The input fields to hash.
9
29
  * @returns The poseidon hash.
10
30
  */
11
- export async function poseidon2Hash(input: Fieldable[]): Promise<Fr> {
12
- const inputFields = serializeToFields(input);
13
- await BarretenbergSync.initSingleton();
14
- const api = BarretenbergSync.getSingleton();
15
- const response = api.poseidon2Hash({
16
- inputs: inputFields.map(i => i.toBuffer()),
17
- });
18
- return Fr.fromBuffer(Buffer.from(response.hash));
31
+ export function poseidon2Hash(input: Fieldable[]): Promise<Fr> {
32
+ return poseidon2HashFields(serializeToFields(input));
19
33
  }
20
34
 
21
35
  /**
@@ -24,15 +38,10 @@ export async function poseidon2Hash(input: Fieldable[]): Promise<Fr> {
24
38
  * @param separator - The domain separator.
25
39
  * @returns The poseidon hash.
26
40
  */
27
- export async function poseidon2HashWithSeparator(input: Fieldable[], separator: number): Promise<Fr> {
41
+ export function poseidon2HashWithSeparator(input: Fieldable[], separator: number): Promise<Fr> {
28
42
  const inputFields = serializeToFields(input);
29
43
  inputFields.unshift(new Fr(separator));
30
- await BarretenbergSync.initSingleton();
31
- const api = BarretenbergSync.getSingleton();
32
- const response = api.poseidon2Hash({
33
- inputs: inputFields.map(i => i.toBuffer()),
34
- });
35
- return Fr.fromBuffer(Buffer.from(response.hash));
44
+ return poseidon2HashFields(inputFields);
36
45
  }
37
46
 
38
47
  /**
@@ -42,19 +51,24 @@ export async function poseidon2HashWithSeparator(input: Fieldable[], separator:
42
51
  */
43
52
  export async function poseidon2Permutation(input: Fieldable[]): Promise<Fr[]> {
44
53
  const inputFields = serializeToFields(input);
45
- // We'd like this assertion but it's not possible to use it in the browser.
46
- // assert(input.length === 4, 'Input state must be of size 4');
47
- await BarretenbergSync.initSingleton();
48
- const api = BarretenbergSync.getSingleton();
49
- const response = api.poseidon2Permutation({
50
- inputs: inputFields.map(i => i.toBuffer()),
51
- });
52
- // We'd like this assertion but it's not possible to use it in the browser.
53
- // assert(response.outputs.length === 4, 'Output state must be of size 4');
54
- return response.outputs.map(o => Fr.fromBuffer(Buffer.from(o)));
54
+ if (IS_BROWSER) {
55
+ await BarretenbergSync.initSingleton();
56
+ const api = BarretenbergSync.getSingleton();
57
+ const response = api.poseidon2Permutation({
58
+ inputs: inputFields.map(i => i.toBuffer()),
59
+ });
60
+ return response.outputs.map(o => Fr.fromBuffer(Buffer.from(o)));
61
+ } else {
62
+ await Barretenberg.initSingleton();
63
+ const api = Barretenberg.getSingleton();
64
+ const response = await api.poseidon2Permutation({
65
+ inputs: inputFields.map(i => i.toBuffer()),
66
+ });
67
+ return response.outputs.map(o => Fr.fromBuffer(Buffer.from(o)));
68
+ }
55
69
  }
56
70
 
57
- export async function poseidon2HashBytes(input: Buffer): Promise<Fr> {
71
+ export function poseidon2HashBytes(input: Buffer): Promise<Fr> {
58
72
  const inputFields = [];
59
73
  for (let i = 0; i < input.length; i += 31) {
60
74
  const fieldBytes = Buffer.alloc(32, 0);
@@ -65,11 +79,5 @@ export async function poseidon2HashBytes(input: Buffer): Promise<Fr> {
65
79
  inputFields.push(Fr.fromBuffer(fieldBytes));
66
80
  }
67
81
 
68
- await BarretenbergSync.initSingleton();
69
- const api = BarretenbergSync.getSingleton();
70
- const response = api.poseidon2Hash({
71
- inputs: inputFields.map(i => i.toBuffer()),
72
- });
73
-
74
- return Fr.fromBuffer(Buffer.from(response.hash));
82
+ return poseidon2HashFields(inputFields);
75
83
  }
@@ -210,3 +210,35 @@ export function recoverPublicKey(hash: Buffer32, signature: Signature, opts: Rec
210
210
  const publicKey = sig.recoverPublicKey(hash.buffer).toHex(false);
211
211
  return Buffer.from(publicKey, 'hex');
212
212
  }
213
+
214
+ /** Arbitrary hash used for testing signature recoverability. */
215
+ const PROBE_HASH = Buffer32.fromBuffer(keccak256(Buffer.from('signature-recoverability-probe')));
216
+
217
+ /**
218
+ * Generates a random valid ECDSA signature that is recoverable to some address.
219
+ * Since Signature.random() produces real signatures via secp256k1 signing, the result is always
220
+ * recoverable, but we verify defensively by checking tryRecoverAddress.
221
+ */
222
+ export function generateRecoverableSignature(): Signature {
223
+ for (let i = 0; i < 100; i++) {
224
+ const sig = Signature.random();
225
+ if (tryRecoverAddress(PROBE_HASH, sig) !== undefined) {
226
+ return sig;
227
+ }
228
+ }
229
+ throw new Secp256k1Error('Failed to generate a recoverable signature after 100 attempts');
230
+ }
231
+
232
+ /**
233
+ * Generates a random signature where ECDSA address recovery fails.
234
+ * Uses random r/s values (not from real signing) so that r is unlikely to be a valid secp256k1 x-coordinate.
235
+ */
236
+ export function generateUnrecoverableSignature(): Signature {
237
+ for (let i = 0; i < 100; i++) {
238
+ const sig = new Signature(Buffer32.random(), Buffer32.random(), 27);
239
+ if (tryRecoverAddress(PROBE_HASH, sig) === undefined) {
240
+ return sig;
241
+ }
242
+ }
243
+ throw new Secp256k1Error('Failed to generate an unrecoverable signature after 100 attempts');
244
+ }
@@ -6,7 +6,6 @@ import { toBigIntBE, toBufferBE } from '../../bigint-buffer/index.js';
6
6
  import { randomBytes } from '../../crypto/random/index.js';
7
7
  import { hexSchemaFor } from '../../schemas/utils.js';
8
8
  import { BufferReader } from '../../serialize/buffer_reader.js';
9
- import { TypeRegistry } from '../../serialize/type_registry.js';
10
9
  import { Fr } from '../bn254/field.js';
11
10
 
12
11
  /**
@@ -323,9 +322,6 @@ export class BLS12Fr extends BLS12Field {
323
322
  }
324
323
  }
325
324
 
326
- // For deserializing JSON.
327
- TypeRegistry.register('BLS12Fr', BLS12Fr);
328
-
329
325
  /**
330
326
  * Fq field class.
331
327
  * @dev This class is used to represent elements of BLS12-381 base field.
@@ -458,6 +454,3 @@ export class BLS12Fq extends BLS12Field {
458
454
  return hexSchemaFor(BLS12Fq);
459
455
  }
460
456
  }
461
-
462
- // For deserializing JSON.
463
- TypeRegistry.register('BLS12Fq', BLS12Fq);