@aztec/foundation 0.0.1-commit.9593d84 → 0.0.1-commit.96bb3f7

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 (236) hide show
  1. package/dest/array/index.d.ts +2 -1
  2. package/dest/array/index.d.ts.map +1 -1
  3. package/dest/array/index.js +1 -0
  4. package/dest/array/sorted_array.d.ts +10 -0
  5. package/dest/array/sorted_array.d.ts.map +1 -0
  6. package/dest/array/sorted_array.js +106 -0
  7. package/dest/branded-types/block_number.d.ts +53 -0
  8. package/dest/branded-types/block_number.d.ts.map +1 -0
  9. package/dest/branded-types/block_number.js +75 -0
  10. package/dest/branded-types/checkpoint_number.d.ts +54 -0
  11. package/dest/branded-types/checkpoint_number.d.ts.map +1 -0
  12. package/dest/branded-types/checkpoint_number.js +77 -0
  13. package/dest/branded-types/index.d.ts +3 -1
  14. package/dest/branded-types/index.d.ts.map +1 -1
  15. package/dest/branded-types/index.js +2 -0
  16. package/dest/buffer/buffer16.d.ts +2 -2
  17. package/dest/buffer/buffer16.d.ts.map +1 -1
  18. package/dest/buffer/buffer16.js +4 -2
  19. package/dest/buffer/buffer32.d.ts +2 -2
  20. package/dest/buffer/buffer32.d.ts.map +1 -1
  21. package/dest/buffer/buffer32.js +4 -2
  22. package/dest/config/env_var.d.ts +2 -2
  23. package/dest/config/env_var.d.ts.map +1 -1
  24. package/dest/config/index.d.ts +11 -4
  25. package/dest/config/index.d.ts.map +1 -1
  26. package/dest/config/index.js +18 -9
  27. package/dest/config/network_config.d.ts +13 -1
  28. package/dest/config/network_config.d.ts.map +1 -1
  29. package/dest/config/network_config.js +3 -1
  30. package/dest/config/parse-env.d.ts +3 -0
  31. package/dest/config/parse-env.d.ts.map +1 -0
  32. package/dest/config/parse-env.js +7 -0
  33. package/dest/config/secret_value.js +3 -1
  34. package/dest/crypto/bls/bn254_keystore.js +1 -1
  35. package/dest/crypto/bls/index.js +1 -1
  36. package/dest/crypto/bn254/index.d.ts +35 -51
  37. package/dest/crypto/bn254/index.d.ts.map +1 -1
  38. package/dest/crypto/bn254/index.js +51 -140
  39. package/dest/crypto/ecdsa/signature.d.ts +2 -2
  40. package/dest/crypto/ecdsa/signature.d.ts.map +1 -1
  41. package/dest/crypto/ecdsa/signature.js +2 -2
  42. package/dest/crypto/grumpkin/index.d.ts +4 -2
  43. package/dest/crypto/grumpkin/index.d.ts.map +1 -1
  44. package/dest/crypto/grumpkin/index.js +2 -1
  45. package/dest/crypto/keys/index.d.ts +2 -2
  46. package/dest/crypto/keys/index.d.ts.map +1 -1
  47. package/dest/crypto/keys/index.js +1 -1
  48. package/dest/crypto/pedersen/pedersen.wasm.d.ts +2 -2
  49. package/dest/crypto/pedersen/pedersen.wasm.d.ts.map +1 -1
  50. package/dest/crypto/pedersen/pedersen.wasm.js +1 -1
  51. package/dest/crypto/poseidon/index.d.ts +2 -2
  52. package/dest/crypto/poseidon/index.d.ts.map +1 -1
  53. package/dest/crypto/poseidon/index.js +1 -1
  54. package/dest/crypto/random/randomness_singleton.d.ts +2 -2
  55. package/dest/crypto/random/randomness_singleton.d.ts.map +1 -1
  56. package/dest/crypto/random/randomness_singleton.js +3 -3
  57. package/dest/crypto/schnorr/index.d.ts +3 -2
  58. package/dest/crypto/schnorr/index.d.ts.map +1 -1
  59. package/dest/crypto/schnorr/index.js +1 -1
  60. package/dest/crypto/schnorr/signature.d.ts +2 -2
  61. package/dest/crypto/schnorr/signature.d.ts.map +1 -1
  62. package/dest/crypto/schnorr/signature.js +2 -2
  63. package/dest/crypto/sha256/index.d.ts +2 -2
  64. package/dest/crypto/sha256/index.d.ts.map +1 -1
  65. package/dest/crypto/sha256/index.js +1 -1
  66. package/dest/crypto/sha512/index.d.ts +2 -2
  67. package/dest/crypto/sha512/index.d.ts.map +1 -1
  68. package/dest/crypto/sha512/index.js +1 -1
  69. package/dest/crypto/signature/index.d.ts +2 -2
  70. package/dest/crypto/signature/index.d.ts.map +1 -1
  71. package/dest/crypto/sync/pedersen/index.d.ts +2 -2
  72. package/dest/crypto/sync/pedersen/index.d.ts.map +1 -1
  73. package/dest/crypto/sync/pedersen/index.js +1 -1
  74. package/dest/crypto/sync/poseidon/index.d.ts +2 -2
  75. package/dest/crypto/sync/poseidon/index.d.ts.map +1 -1
  76. package/dest/crypto/sync/poseidon/index.js +1 -1
  77. package/dest/{fields/bls12_fields.d.ts → curves/bls12/field.d.ts} +3 -3
  78. package/dest/curves/bls12/field.d.ts.map +1 -0
  79. package/dest/{fields/bls12_fields.js → curves/bls12/field.js} +12 -9
  80. package/dest/curves/bls12/index.d.ts +3 -0
  81. package/dest/curves/bls12/index.d.ts.map +1 -0
  82. package/dest/curves/bls12/index.js +2 -0
  83. package/dest/{fields/bls12_point.d.ts → curves/bls12/point.d.ts} +4 -4
  84. package/dest/curves/bls12/point.d.ts.map +1 -0
  85. package/dest/{fields/bls12_point.js → curves/bls12/point.js} +10 -8
  86. package/dest/{fields/fields.d.ts → curves/bn254/field.d.ts} +7 -15
  87. package/dest/curves/bn254/field.d.ts.map +1 -0
  88. package/dest/{fields/fields.js → curves/bn254/field.js} +35 -49
  89. package/dest/curves/bn254/index.d.ts +3 -0
  90. package/dest/curves/bn254/index.d.ts.map +1 -0
  91. package/dest/curves/bn254/index.js +2 -0
  92. package/dest/curves/bn254/point.d.ts +54 -0
  93. package/dest/curves/bn254/point.d.ts.map +1 -0
  94. package/dest/curves/bn254/point.js +143 -0
  95. package/dest/curves/grumpkin/index.d.ts +10 -0
  96. package/dest/curves/grumpkin/index.d.ts.map +1 -0
  97. package/dest/curves/grumpkin/index.js +3 -0
  98. package/dest/{fields → curves/grumpkin}/point.d.ts +3 -3
  99. package/dest/curves/grumpkin/point.d.ts.map +1 -0
  100. package/dest/{fields → curves/grumpkin}/point.js +7 -7
  101. package/dest/eth-address/index.d.ts +3 -2
  102. package/dest/eth-address/index.d.ts.map +1 -1
  103. package/dest/eth-address/index.js +10 -3
  104. package/dest/iterator/filter.d.ts +3 -0
  105. package/dest/iterator/filter.d.ts.map +1 -0
  106. package/dest/iterator/filter.js +7 -0
  107. package/dest/iterator/index.d.ts +2 -0
  108. package/dest/iterator/index.d.ts.map +1 -0
  109. package/dest/iterator/index.js +1 -0
  110. package/dest/log/pino-logger.d.ts +1 -1
  111. package/dest/log/pino-logger.d.ts.map +1 -1
  112. package/dest/log/pino-logger.js +1 -1
  113. package/dest/schemas/schemas.d.ts +7 -3
  114. package/dest/schemas/schemas.d.ts.map +1 -1
  115. package/dest/schemas/schemas.js +9 -3
  116. package/dest/schemas/types.d.ts +31 -1
  117. package/dest/schemas/types.d.ts.map +1 -1
  118. package/dest/schemas/types.js +25 -1
  119. package/dest/serialize/field_reader.d.ts +2 -2
  120. package/dest/serialize/field_reader.d.ts.map +1 -1
  121. package/dest/serialize/field_reader.js +1 -1
  122. package/dest/serialize/free_funcs.d.ts +2 -2
  123. package/dest/serialize/free_funcs.d.ts.map +1 -1
  124. package/dest/serialize/free_funcs.js +1 -1
  125. package/dest/serialize/serialize.d.ts +2 -2
  126. package/dest/serialize/serialize.d.ts.map +1 -1
  127. package/dest/serialize/serialize.js +1 -1
  128. package/dest/sleep/index.d.ts +3 -1
  129. package/dest/sleep/index.d.ts.map +1 -1
  130. package/dest/sleep/index.js +4 -0
  131. package/dest/timer/date.d.ts +2 -1
  132. package/dest/timer/date.d.ts.map +1 -1
  133. package/dest/timer/date.js +3 -0
  134. package/dest/trees/balanced_merkle_tree.d.ts +1 -1
  135. package/dest/trees/balanced_merkle_tree.d.ts.map +1 -1
  136. package/dest/trees/balanced_merkle_tree.js +3 -1
  137. package/dest/trees/indexed_merkle_tree.js +1 -1
  138. package/dest/trees/membership_witness.d.ts +2 -2
  139. package/dest/trees/membership_witness.d.ts.map +1 -1
  140. package/dest/trees/membership_witness.js +1 -1
  141. package/dest/trees/merkle_tree_calculator.js +1 -1
  142. package/dest/trees/sibling_path.d.ts +2 -2
  143. package/dest/trees/sibling_path.d.ts.map +1 -1
  144. package/dest/trees/sibling_path.js +2 -2
  145. package/dest/trees/unbalanced_merkle_tree.d.ts +3 -1
  146. package/dest/trees/unbalanced_merkle_tree.d.ts.map +1 -1
  147. package/dest/trees/unbalanced_merkle_tree.js +6 -0
  148. package/dest/trees/unbalanced_merkle_tree_calculator.d.ts +1 -2
  149. package/dest/trees/unbalanced_merkle_tree_calculator.d.ts.map +1 -1
  150. package/dest/trees/unbalanced_merkle_tree_calculator.js +0 -4
  151. package/dest/types/index.d.ts +3 -1
  152. package/dest/types/index.d.ts.map +1 -1
  153. package/dest/types/index.js +3 -0
  154. package/package.json +25 -7
  155. package/src/array/index.ts +1 -0
  156. package/src/array/sorted_array.ts +133 -0
  157. package/src/branded-types/block_number.ts +112 -0
  158. package/src/branded-types/checkpoint_number.ts +115 -0
  159. package/src/branded-types/index.ts +2 -0
  160. package/src/buffer/buffer16.ts +2 -2
  161. package/src/buffer/buffer32.ts +2 -2
  162. package/src/config/env_var.ts +29 -10
  163. package/src/config/index.ts +22 -6
  164. package/src/config/network_config.ts +2 -0
  165. package/src/config/parse-env.ts +4 -0
  166. package/src/crypto/bls/bn254_keystore.ts +1 -1
  167. package/src/crypto/bls/index.ts +1 -1
  168. package/src/crypto/bn254/index.ts +50 -159
  169. package/src/crypto/ecdsa/signature.ts +2 -2
  170. package/src/crypto/grumpkin/index.ts +3 -1
  171. package/src/crypto/keys/index.ts +1 -1
  172. package/src/crypto/pedersen/pedersen.wasm.ts +1 -1
  173. package/src/crypto/poseidon/index.ts +1 -1
  174. package/src/crypto/random/randomness_singleton.ts +2 -4
  175. package/src/crypto/schnorr/index.ts +2 -1
  176. package/src/crypto/schnorr/signature.ts +2 -2
  177. package/src/crypto/sha256/index.ts +1 -1
  178. package/src/crypto/sha512/index.ts +1 -1
  179. package/src/crypto/signature/index.ts +1 -1
  180. package/src/crypto/sync/pedersen/index.ts +1 -1
  181. package/src/crypto/sync/poseidon/index.ts +1 -1
  182. package/src/{fields/bls12_fields.ts → curves/bls12/field.ts} +6 -6
  183. package/src/curves/bls12/index.ts +2 -0
  184. package/src/{fields/bls12_point.ts → curves/bls12/point.ts} +7 -7
  185. package/src/{fields/fields.ts → curves/bn254/field.ts} +33 -56
  186. package/src/curves/bn254/index.ts +2 -0
  187. package/src/curves/bn254/point.ts +170 -0
  188. package/src/curves/grumpkin/index.ts +11 -0
  189. package/src/{fields → curves/grumpkin}/point.ts +7 -7
  190. package/src/eth-address/index.ts +8 -2
  191. package/src/iterator/filter.ts +11 -0
  192. package/src/iterator/index.ts +1 -0
  193. package/src/log/pino-logger.ts +2 -1
  194. package/src/schemas/schemas.ts +14 -3
  195. package/src/schemas/types.ts +33 -0
  196. package/src/serialize/field_reader.ts +1 -1
  197. package/src/serialize/free_funcs.ts +1 -1
  198. package/src/serialize/serialize.ts +1 -1
  199. package/src/sleep/index.ts +6 -0
  200. package/src/timer/date.ts +4 -0
  201. package/src/trees/balanced_merkle_tree.ts +3 -1
  202. package/src/trees/indexed_merkle_tree.ts +1 -1
  203. package/src/trees/membership_witness.ts +1 -1
  204. package/src/trees/merkle_tree_calculator.ts +1 -1
  205. package/src/trees/sibling_path.ts +2 -2
  206. package/src/trees/unbalanced_merkle_tree.ts +14 -0
  207. package/src/trees/unbalanced_merkle_tree_calculator.ts +0 -10
  208. package/src/types/index.ts +5 -0
  209. package/dest/crypto/bn254/bn254_utils.d.ts +0 -39
  210. package/dest/crypto/bn254/bn254_utils.d.ts.map +0 -1
  211. package/dest/crypto/bn254/bn254_utils.js +0 -56
  212. package/dest/crypto/index.d.ts +0 -17
  213. package/dest/crypto/index.d.ts.map +0 -1
  214. package/dest/crypto/index.js +0 -16
  215. package/dest/fields/bls12_fields.d.ts.map +0 -1
  216. package/dest/fields/bls12_point.d.ts.map +0 -1
  217. package/dest/fields/coordinate.d.ts +0 -63
  218. package/dest/fields/coordinate.d.ts.map +0 -1
  219. package/dest/fields/coordinate.js +0 -96
  220. package/dest/fields/fields.d.ts.map +0 -1
  221. package/dest/fields/index.d.ts +0 -6
  222. package/dest/fields/index.d.ts.map +0 -1
  223. package/dest/fields/index.js +0 -5
  224. package/dest/fields/point.d.ts.map +0 -1
  225. package/dest/index.d.ts +0 -31
  226. package/dest/index.d.ts.map +0 -1
  227. package/dest/index.js +0 -31
  228. package/dest/json-rpc/server/telemetry.d.ts +0 -2
  229. package/dest/json-rpc/server/telemetry.d.ts.map +0 -1
  230. package/dest/json-rpc/server/telemetry.js +0 -0
  231. package/src/crypto/bn254/bn254_utils.ts +0 -64
  232. package/src/crypto/index.ts +0 -16
  233. package/src/fields/coordinate.ts +0 -104
  234. package/src/fields/index.ts +0 -5
  235. package/src/index.ts +0 -31
  236. package/src/json-rpc/server/telemetry.ts +0 -0
@@ -1,10 +1,6 @@
1
1
  import { shaMerkleHash } from './balanced_merkle_tree.js';
2
2
  import { SiblingPath } from './sibling_path.js';
3
3
  import { UnbalancedTreeStore } from './unbalanced_tree_store.js';
4
- export function computeCompressedUnbalancedMerkleTreeRoot(leaves, valueToCompress = Buffer.alloc(32), emptyRoot = Buffer.alloc(32), hasher) {
5
- const calculator = UnbalancedMerkleTreeCalculator.create(leaves, valueToCompress, emptyRoot, hasher);
6
- return calculator.getRoot();
7
- }
8
4
  /**
9
5
  * An ephemeral unbalanced Merkle tree implementation.
10
6
  * Follows the rollup implementation which greedily hashes pairs of nodes up the tree.
@@ -14,6 +14,8 @@ export type Writeable<T> = {
14
14
  };
15
15
  /** Removes readonly modifiers for an object. */
16
16
  export declare function unfreeze<T>(obj: T): Writeable<T>;
17
+ /** Is defined type guard */
18
+ export declare function isDefined<T>(value: T | undefined): value is T;
17
19
  /** Resolves a record-like type. Lifted from viem. */
18
20
  export type Prettify<T> = {
19
21
  [K in keyof T]: T[K];
@@ -39,4 +41,4 @@ export interface TypedEventEmitter<TEventMap extends {
39
41
  removeListener<K extends keyof TEventMap>(event: K, listener: TEventMap[K]): this;
40
42
  removeAllListeners<K extends keyof TEventMap>(event: K): this;
41
43
  }
42
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eXBlcy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxnQ0FBZ0M7QUFDaEMsTUFBTSxNQUFNLFFBQVEsQ0FBQyxDQUFDLElBQUk7S0FDdkIsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsU0FBUyxRQUFRLEdBQUcsS0FBSyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDO0NBQzFELENBQUM7QUFFRixrQ0FBa0M7QUFDbEMsTUFBTSxNQUFNLFdBQVcsQ0FBQyxDQUFDLElBQUk7S0FDMUIsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsU0FBUyxRQUFRLEdBQUcsQ0FBQyxHQUFHLEtBQUssR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDO0NBQzFELENBQUM7QUFFRix1REFBdUQ7QUFDdkQsTUFBTSxNQUFNLFNBQVMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxTQUFTLE1BQU0sQ0FBQyxJQUFJLElBQUksQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUUvRSw2Q0FBNkM7QUFDN0MsTUFBTSxNQUFNLFNBQVMsQ0FBQyxDQUFDLElBQUk7SUFBRSxDQUFDLFVBQVUsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUM7Q0FBRSxDQUFDO0FBRTlELGdEQUFnRDtBQUNoRCx3QkFBZ0IsUUFBUSxDQUFDLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQyxHQUFHLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FFaEQ7QUFFRCxxREFBcUQ7QUFDckQsTUFBTSxNQUFNLFFBQVEsQ0FBQyxDQUFDLElBQUk7S0FDdkIsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUM7Q0FDckIsR0FBRyxFQUFFLENBQUM7QUFFUDs7Ozs7Ozs7OztHQVVHO0FBQ0gsTUFBTSxXQUFXLGlCQUFpQixDQUFDLFNBQVMsU0FBUztLQUFHLEdBQUcsSUFBSSxNQUFNLFNBQVMsR0FBRyxDQUFDLEdBQUcsSUFBSSxFQUFFLEdBQUcsRUFBRSxLQUFLLElBQUk7Q0FBRTtJQUN6RyxJQUFJLENBQUMsQ0FBQyxTQUFTLE1BQU0sU0FBUyxFQUFFLEtBQUssRUFBRSxDQUFDLEVBQUUsUUFBUSxFQUFFLFNBQVMsQ0FBQyxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUM7SUFDeEUsRUFBRSxDQUFDLENBQUMsU0FBUyxNQUFNLFNBQVMsRUFBRSxLQUFLLEVBQUUsQ0FBQyxFQUFFLFFBQVEsRUFBRSxTQUFTLENBQUMsQ0FBQyxDQUFDLEdBQUcsSUFBSSxDQUFDO0lBQ3RFLEdBQUcsQ0FBQyxDQUFDLFNBQVMsTUFBTSxTQUFTLEVBQUUsS0FBSyxFQUFFLENBQUMsRUFBRSxRQUFRLEVBQUUsU0FBUyxDQUFDLENBQUMsQ0FBQyxHQUFHLElBQUksQ0FBQztJQUN2RSxJQUFJLENBQUMsQ0FBQyxTQUFTLE1BQU0sU0FBUyxFQUFFLEtBQUssRUFBRSxDQUFDLEVBQUUsR0FBRyxJQUFJLEVBQUUsVUFBVSxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQztJQUN0RixjQUFjLENBQUMsQ0FBQyxTQUFTLE1BQU0sU0FBUyxFQUFFLEtBQUssRUFBRSxDQUFDLEVBQUUsUUFBUSxFQUFFLFNBQVMsQ0FBQyxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUM7SUFDbEYsa0JBQWtCLENBQUMsQ0FBQyxTQUFTLE1BQU0sU0FBUyxFQUFFLEtBQUssRUFBRSxDQUFDLEdBQUcsSUFBSSxDQUFDO0NBRS9EIn0=
44
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eXBlcy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxnQ0FBZ0M7QUFDaEMsTUFBTSxNQUFNLFFBQVEsQ0FBQyxDQUFDLElBQUk7S0FDdkIsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsU0FBUyxRQUFRLEdBQUcsS0FBSyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDO0NBQzFELENBQUM7QUFFRixrQ0FBa0M7QUFDbEMsTUFBTSxNQUFNLFdBQVcsQ0FBQyxDQUFDLElBQUk7S0FDMUIsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsU0FBUyxRQUFRLEdBQUcsQ0FBQyxHQUFHLEtBQUssR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDO0NBQzFELENBQUM7QUFFRix1REFBdUQ7QUFDdkQsTUFBTSxNQUFNLFNBQVMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxTQUFTLE1BQU0sQ0FBQyxJQUFJLElBQUksQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUUvRSw2Q0FBNkM7QUFDN0MsTUFBTSxNQUFNLFNBQVMsQ0FBQyxDQUFDLElBQUk7SUFBRSxDQUFDLFVBQVUsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUM7Q0FBRSxDQUFDO0FBRTlELGdEQUFnRDtBQUNoRCx3QkFBZ0IsUUFBUSxDQUFDLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQyxHQUFHLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FFaEQ7QUFFRCw0QkFBNEI7QUFDNUIsd0JBQWdCLFNBQVMsQ0FBQyxDQUFDLEVBQUUsS0FBSyxFQUFFLENBQUMsR0FBRyxTQUFTLEdBQUcsS0FBSyxJQUFJLENBQUMsQ0FFN0Q7QUFFRCxxREFBcUQ7QUFDckQsTUFBTSxNQUFNLFFBQVEsQ0FBQyxDQUFDLElBQUk7S0FDdkIsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUM7Q0FDckIsR0FBRyxFQUFFLENBQUM7QUFFUDs7Ozs7Ozs7OztHQVVHO0FBQ0gsTUFBTSxXQUFXLGlCQUFpQixDQUFDLFNBQVMsU0FBUztLQUFHLEdBQUcsSUFBSSxNQUFNLFNBQVMsR0FBRyxDQUFDLEdBQUcsSUFBSSxFQUFFLEdBQUcsRUFBRSxLQUFLLElBQUk7Q0FBRTtJQUN6RyxJQUFJLENBQUMsQ0FBQyxTQUFTLE1BQU0sU0FBUyxFQUFFLEtBQUssRUFBRSxDQUFDLEVBQUUsUUFBUSxFQUFFLFNBQVMsQ0FBQyxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUM7SUFDeEUsRUFBRSxDQUFDLENBQUMsU0FBUyxNQUFNLFNBQVMsRUFBRSxLQUFLLEVBQUUsQ0FBQyxFQUFFLFFBQVEsRUFBRSxTQUFTLENBQUMsQ0FBQyxDQUFDLEdBQUcsSUFBSSxDQUFDO0lBQ3RFLEdBQUcsQ0FBQyxDQUFDLFNBQVMsTUFBTSxTQUFTLEVBQUUsS0FBSyxFQUFFLENBQUMsRUFBRSxRQUFRLEVBQUUsU0FBUyxDQUFDLENBQUMsQ0FBQyxHQUFHLElBQUksQ0FBQztJQUN2RSxJQUFJLENBQUMsQ0FBQyxTQUFTLE1BQU0sU0FBUyxFQUFFLEtBQUssRUFBRSxDQUFDLEVBQUUsR0FBRyxJQUFJLEVBQUUsVUFBVSxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQztJQUN0RixjQUFjLENBQUMsQ0FBQyxTQUFTLE1BQU0sU0FBUyxFQUFFLEtBQUssRUFBRSxDQUFDLEVBQUUsUUFBUSxFQUFFLFNBQVMsQ0FBQyxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUM7SUFDbEYsa0JBQWtCLENBQUMsQ0FBQyxTQUFTLE1BQU0sU0FBUyxFQUFFLEtBQUssRUFBRSxDQUFDLEdBQUcsSUFBSSxDQUFDO0NBRS9EIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC1D,CAAC;AAEF,kCAAkC;AAClC,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;CAC1D,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAE/E,6CAA6C;AAC7C,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAE9D,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAEhD;AAED,qDAAqD;AACrD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACrB,GAAG,EAAE,CAAC;AAEP;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB,CAAC,SAAS,SAAS;KAAG,GAAG,IAAI,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI;CAAE;IACzG,IAAI,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACxE,EAAE,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACtE,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACvE,IAAI,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IACtF,cAAc,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClF,kBAAkB,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CAE/D"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC1D,CAAC;AAEF,kCAAkC;AAClC,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;CAC1D,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAE/E,6CAA6C;AAC7C,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAE9D,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAEhD;AAED,4BAA4B;AAC5B,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAE7D;AAED,qDAAqD;AACrD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACrB,GAAG,EAAE,CAAC;AAEP;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB,CAAC,SAAS,SAAS;KAAG,GAAG,IAAI,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI;CAAE;IACzG,IAAI,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACxE,EAAE,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACtE,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACvE,IAAI,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IACtF,cAAc,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClF,kBAAkB,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CAE/D"}
@@ -1,3 +1,6 @@
1
1
  /** Strips methods of a type. */ /** Removes readonly modifiers for an object. */ export function unfreeze(obj) {
2
2
  return obj;
3
3
  }
4
+ /** Is defined type guard */ export function isDefined(value) {
5
+ return value !== undefined;
6
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/foundation",
3
- "version": "0.0.1-commit.9593d84",
3
+ "version": "0.0.1-commit.96bb3f7",
4
4
  "type": "module",
5
5
  "main": "./dest/index.js",
6
6
  "types": "./dest/index.d.ts",
@@ -15,9 +15,27 @@
15
15
  "./branded-types": "./dest/branded-types/index.js",
16
16
  "./collection": "./dest/collection/index.js",
17
17
  "./config": "./dest/config/index.js",
18
- "./crypto": "./dest/crypto/index.js",
19
- "./crypto/sync": "./dest/crypto/sync/index.js",
18
+ "./crypto/aes128": "./dest/crypto/aes128/index.js",
19
+ "./crypto/bls": "./dest/crypto/bls/index.js",
20
20
  "./crypto/bls/bn254_keystore": "./dest/crypto/bls/bn254_keystore.js",
21
+ "./crypto/bn254": "./dest/crypto/bn254/index.js",
22
+ "./crypto/ecdsa": "./dest/crypto/ecdsa/index.js",
23
+ "./crypto/grumpkin": "./dest/crypto/grumpkin/index.js",
24
+ "./crypto/keccak": "./dest/crypto/keccak/index.js",
25
+ "./crypto/keys": "./dest/crypto/keys/index.js",
26
+ "./crypto/pedersen": "./dest/crypto/pedersen/index.js",
27
+ "./crypto/poseidon": "./dest/crypto/poseidon/index.js",
28
+ "./crypto/random": "./dest/crypto/random/index.js",
29
+ "./crypto/schnorr": "./dest/crypto/schnorr/index.js",
30
+ "./crypto/secp256k1": "./dest/crypto/secp256k1/index.js",
31
+ "./crypto/secp256k1-signer": "./dest/crypto/secp256k1-signer/index.js",
32
+ "./crypto/sha256": "./dest/crypto/sha256/index.js",
33
+ "./crypto/sha512": "./dest/crypto/sha512/index.js",
34
+ "./crypto/signature": "./dest/crypto/signature/index.js",
35
+ "./crypto/sync": "./dest/crypto/sync/index.js",
36
+ "./curves/bn254": "./dest/curves/bn254/index.js",
37
+ "./curves/grumpkin": "./dest/curves/grumpkin/index.js",
38
+ "./curves/bls12": "./dest/curves/bls12/index.js",
21
39
  "./decorators": "./dest/decorators/index.js",
22
40
  "./error": "./dest/error/index.js",
23
41
  "./eth-address": "./dest/eth-address/index.js",
@@ -31,9 +49,9 @@
31
49
  "./json-rpc/undici": "./dest/json-rpc/client/undici.js",
32
50
  "./json-rpc/test": "./dest/json-rpc/test/index.js",
33
51
  "./iterable": "./dest/iterable/index.js",
52
+ "./iterator": "./dest/iterator/index.js",
34
53
  "./log": "./dest/log/index.js",
35
54
  "./mutex": "./dest/mutex/index.js",
36
- "./fields": "./dest/fields/index.js",
37
55
  "./retry": "./dest/retry/index.js",
38
56
  "./running-promise": "./dest/running-promise/index.js",
39
57
  "./serialize": "./dest/serialize/index.js",
@@ -58,8 +76,8 @@
58
76
  "./number": "./dest/number/index.js"
59
77
  },
60
78
  "scripts": {
61
- "build": "yarn clean && tsgo -b",
62
- "build:dev": "tsgo -b --watch",
79
+ "build": "yarn clean && ../scripts/tsc.sh",
80
+ "build:dev": "../scripts/tsc.sh --watch",
63
81
  "clean": "rm -rf ./dest .tsbuildinfo",
64
82
  "generate": "true",
65
83
  "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}"
@@ -105,7 +123,7 @@
105
123
  "testEnvironment": "../../foundation/src/jest/env.mjs"
106
124
  },
107
125
  "dependencies": {
108
- "@aztec/bb.js": "0.0.1-commit.9593d84",
126
+ "@aztec/bb.js": "0.0.1-commit.96bb3f7",
109
127
  "@koa/cors": "^5.0.0",
110
128
  "@noble/curves": "=1.7.0",
111
129
  "@noble/hashes": "^1.6.1",
@@ -1 +1,2 @@
1
1
  export * from './array.js';
2
+ export * from './sorted_array.js';
@@ -0,0 +1,133 @@
1
+ type Cmp<T> = (a: T, b: T) => -1 | 0 | 1;
2
+
3
+ export function dedupeSortedArray<T>(arr: T[], cmp: Cmp<T>): void {
4
+ for (let i = 0; i < arr.length; i++) {
5
+ let j = i + 1;
6
+ for (; j < arr.length; j++) {
7
+ const res = cmp(arr[i], arr[j]);
8
+ if (res === 0) {
9
+ continue;
10
+ } else if (res < 0) {
11
+ break;
12
+ } else {
13
+ throw new Error('Array not sorted');
14
+ }
15
+ }
16
+
17
+ if (j - i > 1) {
18
+ arr.splice(i + 1, j - i - 1);
19
+ }
20
+ }
21
+ }
22
+
23
+ export function insertIntoSortedArray<T>(arr: T[], item: T, cmp: Cmp<T>, allowDuplicates = true): boolean {
24
+ let start = 0;
25
+ let end = arr.length;
26
+
27
+ while (start < end) {
28
+ const mid = start + (((end - start) / 2) | 0);
29
+ const comparison = cmp(arr[mid], item);
30
+
31
+ if (comparison < 0) {
32
+ start = mid + 1;
33
+ } else {
34
+ end = mid;
35
+ }
36
+ }
37
+
38
+ if (!allowDuplicates) {
39
+ // Check element at insertion point
40
+ if (start < arr.length && cmp(arr[start], item) === 0) {
41
+ return false;
42
+ }
43
+
44
+ // Check element before insertion point (in case we landed after duplicates)
45
+ if (start > 0 && cmp(arr[start - 1], item) === 0) {
46
+ return false;
47
+ }
48
+ }
49
+
50
+ arr.splice(start, 0, item);
51
+ return true;
52
+ }
53
+
54
+ export function findIndexInSortedArray<T, N>(values: T[], needle: N, cmp: (a: T, b: N) => number): number {
55
+ let start = 0;
56
+ let end = values.length - 1;
57
+
58
+ while (start <= end) {
59
+ const mid = start + (((end - start) / 2) | 0);
60
+ const comparison = cmp(values[mid], needle);
61
+
62
+ if (comparison === 0) {
63
+ return mid;
64
+ }
65
+
66
+ if (comparison > 0) {
67
+ end = mid - 1;
68
+ } else {
69
+ start = mid + 1;
70
+ }
71
+ }
72
+
73
+ return -1;
74
+ }
75
+
76
+ export function findInSortedArray<T, N>(values: T[], needle: N, cmp: (a: T, b: N) => number): T | undefined {
77
+ const idx = findIndexInSortedArray(values, needle, cmp);
78
+ return idx > -1 ? values[idx] : undefined;
79
+ }
80
+
81
+ export function removeAnyOf<T, N>(arr: T[], vals: N[], cmp: (a: T, b: N) => -1 | 0 | 1): void {
82
+ let writeIdx = 0;
83
+ let readIdx = 0;
84
+ let valIdx = 0;
85
+
86
+ while (readIdx < arr.length && valIdx < vals.length) {
87
+ const comparison = cmp(arr[readIdx], vals[valIdx]);
88
+
89
+ if (comparison < 0) {
90
+ arr[writeIdx++] = arr[readIdx++];
91
+ } else if (comparison > 0) {
92
+ valIdx++;
93
+ } else {
94
+ readIdx++;
95
+ }
96
+ }
97
+
98
+ while (readIdx < arr.length) {
99
+ arr[writeIdx++] = arr[readIdx++];
100
+ }
101
+
102
+ arr.length = writeIdx;
103
+ }
104
+
105
+ export function removeFromSortedArray<T, N>(arr: T[], val: N, cmp: (a: T, b: N) => -1 | 0 | 1) {
106
+ const idx = findIndexInSortedArray(arr, val, cmp);
107
+ if (idx > -1) {
108
+ arr.splice(idx, 1);
109
+ }
110
+ }
111
+
112
+ export function merge<T>(arr: T[], toInsert: T[], cmp: (a: T, b: T) => -1 | 0 | 1): void {
113
+ const result = new Array<T>(arr.length + toInsert.length);
114
+ let i = 0,
115
+ j = 0,
116
+ k = 0;
117
+
118
+ while (i < arr.length && j < toInsert.length) {
119
+ result[k++] = cmp(arr[i], toInsert[j]) <= 0 ? arr[i++] : toInsert[j++];
120
+ }
121
+
122
+ while (i < arr.length) {
123
+ result[k++] = arr[i++];
124
+ }
125
+ while (j < toInsert.length) {
126
+ result[k++] = toInsert[j++];
127
+ }
128
+
129
+ for (i = 0; i < result.length; i++) {
130
+ arr[i] = result[i];
131
+ }
132
+ arr.length = result.length;
133
+ }
@@ -0,0 +1,112 @@
1
+ import { z } from 'zod';
2
+
3
+ import type { CheckpointNumber } from './checkpoint_number.js';
4
+ import type { Branded } from './types.js';
5
+
6
+ /**
7
+ * A branded type representing an Aztec (L2) block number.
8
+ * Block numbers are sequential identifiers for blocks in the Aztec rollup chain.
9
+ *
10
+ * This is a nominal type backed by a number, but TypeScript will treat it as
11
+ * incompatible with plain numbers and other branded numeric types (like EpochNumber, SlotNumber, etc.).
12
+ *
13
+ * Note: This type should ONLY be used for Aztec L2 block numbers, NOT for Ethereum L1 block numbers.
14
+ *
15
+ * @example
16
+ * ```ts
17
+ * const blockNumber = BlockNumber(100);
18
+ * const plainNumber: number = blockNumber; // OK - BlockNumber is assignable to number
19
+ * const blockFromNumber: BlockNumber = 100; // ERROR - number is not assignable to BlockNumber
20
+ * ```
21
+ */
22
+ export type BlockNumber = Branded<number, 'BlockNumber'>;
23
+
24
+ /**
25
+ * Creates a BlockNumber from a number.
26
+ * @param value - The block number (must be a non-negative integer)
27
+ * @returns The branded BlockNumber value
28
+ * @throws If the value is negative or not an integer
29
+ */
30
+ export function BlockNumber(value: number): BlockNumber {
31
+ if (!Number.isInteger(value)) {
32
+ throw new Error(`BlockNumber must be an integer, got ${value}`);
33
+ }
34
+ if (value < 0) {
35
+ throw new Error(`BlockNumber must be non-negative, got ${value}`);
36
+ }
37
+ return value as BlockNumber;
38
+ }
39
+
40
+ /**
41
+ * Creates a BlockNumber from a bigint.
42
+ * @param value - The block number as bigint (must be a non-negative integer within safe integer range)
43
+ * @returns The branded BlockNumber value
44
+ * @throws If the value is negative or exceeds Number.MAX_SAFE_INTEGER
45
+ */
46
+ BlockNumber.fromBigInt = function (value: bigint): BlockNumber {
47
+ if (value < 0n) {
48
+ throw new Error(`BlockNumber must be non-negative, got ${value}`);
49
+ }
50
+ if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
51
+ throw new Error(`BlockNumber ${value} exceeds MAX_SAFE_INTEGER`);
52
+ }
53
+ return Number(value) as BlockNumber;
54
+ };
55
+
56
+ /**
57
+ * Creates a BlockNumber from a string.
58
+ * @param value - The block number as a string
59
+ * @returns The branded BlockNumber value
60
+ * @throws If the string cannot be parsed as a valid block number
61
+ */
62
+ BlockNumber.fromString = function (value: string): BlockNumber {
63
+ const parsed = parseInt(value, 10);
64
+ if (isNaN(parsed)) {
65
+ throw new Error(`Cannot parse BlockNumber from string: ${value}`);
66
+ }
67
+ return BlockNumber(parsed);
68
+ };
69
+
70
+ /**
71
+ * Converts a CheckpointNumber to a BlockNumber.
72
+ * This is used in checkpoint-based systems where checkpoint numbers align with block numbers.
73
+ * WARNING: This should only be used when you know the checkpoint number corresponds to a block number.
74
+ * @param value - The checkpoint number to convert
75
+ * @returns The corresponding BlockNumber
76
+ */
77
+ BlockNumber.fromCheckpointNumber = function (value: CheckpointNumber): BlockNumber {
78
+ return value as unknown as BlockNumber;
79
+ };
80
+
81
+ /**
82
+ * Type guard to check if a value is a valid BlockNumber.
83
+ * Note: At runtime, a BlockNumber is just a number, so this checks if the value
84
+ * is a non-negative integer.
85
+ */
86
+ BlockNumber.isValid = function (value: unknown): value is BlockNumber {
87
+ return typeof value === 'number' && Number.isInteger(value) && value >= 0;
88
+ };
89
+
90
+ /**
91
+ * The zero block value (genesis block).
92
+ */
93
+ BlockNumber.ZERO = BlockNumber(0);
94
+
95
+ function makeBlockNumberSchema(minValue: number) {
96
+ return z
97
+ .union([z.number(), z.bigint(), z.string()])
98
+ .pipe(z.coerce.number().int().min(minValue))
99
+ .transform(value => BlockNumber(value));
100
+ }
101
+
102
+ /**
103
+ * Zod schema for parsing and validating BlockNumber values.
104
+ * Accepts numbers, bigints, or strings and coerces them to BlockNumber.
105
+ */
106
+ export const BlockNumberSchema = makeBlockNumberSchema(0);
107
+
108
+ /**
109
+ * Zod schema for parsing and validating BlockNumber values that are strictly positive.
110
+ * Accepts numbers, bigints, or strings and coerces them to BlockNumber.
111
+ */
112
+ export const BlockNumberPositiveSchema = makeBlockNumberSchema(1);
@@ -0,0 +1,115 @@
1
+ import { z } from 'zod';
2
+
3
+ import type { BlockNumber } from './block_number.js';
4
+ import type { Branded } from './types.js';
5
+
6
+ /**
7
+ * A branded type representing an checkpoint number.
8
+ * Checkpoints are used in the Aztec protocol to group L2 blocks.
9
+ *
10
+ * This is a nominal type backed by a number, but TypeScript will treat it as
11
+ * incompatible with plain numbers and other branded numeric types (like Slot, BlockNumber, etc.).
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * const checkpoint = CheckpointNumber(5);
16
+ * const plainNumber: number = checkpoint; // OK - CheckpointNumber is assignable to number
17
+ * const checkpointFromNumber: CheckpointNumber = 5; // ERROR - number is not assignable to CheckpointNumber
18
+ * ```
19
+ */
20
+ export type CheckpointNumber = Branded<number, 'CheckpointNumber'>;
21
+
22
+ /**
23
+ * Creates an CheckpointNumber from a number.
24
+ * @param value - The checkpoint number (must be a non-negative integer)
25
+ * @returns The branded CheckpointNumber value
26
+ * @throws If the value is negative or not an integer
27
+ */
28
+ export function CheckpointNumber(value: number): CheckpointNumber {
29
+ if (!Number.isInteger(value)) {
30
+ throw new Error(`CheckpointNumber must be an integer, got ${value}`);
31
+ }
32
+ if (value < 0) {
33
+ throw new Error(`CheckpointNumber must be non-negative, got ${value}`);
34
+ }
35
+ return value as CheckpointNumber;
36
+ }
37
+
38
+ /**
39
+ * @param value - The block number
40
+ * @returns The branded CheckpointNumber value
41
+ *
42
+ * @deprecated Checkpoint number and block number should no longer convert to each other once we support multiple blocks
43
+ * per checkpoint everywhere.
44
+ */
45
+ CheckpointNumber.fromBlockNumber = function (value: BlockNumber): CheckpointNumber {
46
+ return CheckpointNumber(value);
47
+ };
48
+
49
+ /**
50
+ * Creates an CheckpointNumber from a bigint.
51
+ * @param value - The checkpoint number as bigint (must be a non-negative integer within safe integer range)
52
+ * @returns The branded CheckpointNumber value
53
+ * @throws If the value is negative or exceeds Number.MAX_SAFE_INTEGER
54
+ */
55
+ CheckpointNumber.fromBigInt = function (value: bigint): CheckpointNumber {
56
+ if (value < 0n) {
57
+ throw new Error(`CheckpointNumber must be non-negative, got ${value}`);
58
+ }
59
+ if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
60
+ throw new Error(`CheckpointNumber ${value} exceeds MAX_SAFE_INTEGER`);
61
+ }
62
+ return Number(value) as CheckpointNumber;
63
+ };
64
+
65
+ /**
66
+ * Creates an CheckpointNumber from a string.
67
+ * @param value - The checkpoint number as a string
68
+ * @returns The branded CheckpointNumber value
69
+ * @throws If the string cannot be parsed as a valid checkpoint
70
+ */
71
+ CheckpointNumber.fromString = function (value: string): CheckpointNumber {
72
+ const parsed = parseInt(value, 10);
73
+ if (isNaN(parsed)) {
74
+ throw new Error(`Cannot parse CheckpointNumber from string: ${value}`);
75
+ }
76
+ return CheckpointNumber(parsed);
77
+ };
78
+
79
+ /**
80
+ * Type guard to check if a value is a valid CheckpointNumber.
81
+ * Note: At runtime, an CheckpointNumber is just a number, so this checks if the value
82
+ * is a non-negative integer.
83
+ */
84
+ CheckpointNumber.isValid = function (value: unknown): value is CheckpointNumber {
85
+ return typeof value === 'number' && Number.isInteger(value) && value >= 0;
86
+ };
87
+
88
+ /** The zero checkpoint value. */
89
+ CheckpointNumber.ZERO = CheckpointNumber(0);
90
+
91
+ /** Initial checkpoint. */
92
+ CheckpointNumber.INITIAL = CheckpointNumber(1);
93
+
94
+ /**
95
+ * Zod schema for parsing and validating CheckpointNumber values.
96
+ * Accepts numbers, bigints, or strings and coerces them to CheckpointNumber.
97
+ */
98
+ function makeCheckpointNumberSchema(minValue: number) {
99
+ return z
100
+ .union([z.number(), z.bigint(), z.string()])
101
+ .pipe(z.coerce.number().int().min(minValue))
102
+ .transform(value => CheckpointNumber(value));
103
+ }
104
+
105
+ /**
106
+ * Zod schema for parsing and validating Checkpoint values.
107
+ * Accepts numbers, bigints, or strings and coerces them to CheckpointNumber.
108
+ */
109
+ export const CheckpointNumberSchema = makeCheckpointNumberSchema(0);
110
+
111
+ /**
112
+ * Zod schema for parsing and validating CheckpointNumber values that are strictly positive.
113
+ * Accepts numbers, bigints, or strings and coerces them to CheckpointNumber.
114
+ */
115
+ export const CheckpointNumberPositiveSchema = makeCheckpointNumberSchema(1);
@@ -1,3 +1,5 @@
1
+ export { BlockNumber, BlockNumberSchema, BlockNumberPositiveSchema } from './block_number.js';
2
+ export { CheckpointNumber, CheckpointNumberSchema, CheckpointNumberPositiveSchema } from './checkpoint_number.js';
1
3
  export { EpochNumber, EpochNumberSchema } from './epoch.js';
2
4
  export { SlotNumber, SlotNumberSchema } from './slot.js';
3
5
 
@@ -1,5 +1,5 @@
1
- import { randomBytes } from '@aztec/foundation/crypto';
2
- import type { Fr } from '@aztec/foundation/fields';
1
+ import { randomBytes } from '@aztec/foundation/crypto/random';
2
+ import type { Fr } from '@aztec/foundation/curves/bn254';
3
3
  import { BufferReader, deserializeBigInt, serializeBigInt } from '@aztec/foundation/serialize';
4
4
 
5
5
  import { inspect } from 'util';
@@ -1,5 +1,5 @@
1
- import { randomBytes } from '@aztec/foundation/crypto';
2
- import type { Fr } from '@aztec/foundation/fields';
1
+ import { randomBytes } from '@aztec/foundation/crypto/random';
2
+ import type { Fr } from '@aztec/foundation/curves/bn254';
3
3
  import { BufferReader, deserializeBigInt, serializeBigInt } from '@aztec/foundation/serialize';
4
4
 
5
5
  import { inspect } from 'util';
@@ -21,12 +21,13 @@ export type EnvVar =
21
21
  | 'BB_NUM_IVC_VERIFIERS'
22
22
  | 'BB_IVC_CONCURRENCY'
23
23
  | 'BOOTSTRAP_NODES'
24
- | 'BLOB_SINK_ARCHIVE_API_URL'
25
- | 'BLOB_SINK_PORT'
26
- | 'BLOB_SINK_URL'
24
+ | 'BLOB_ARCHIVE_API_URL'
25
+ | 'BLOB_FILE_STORE_URLS'
26
+ | 'BLOB_FILE_STORE_UPLOAD_URL'
27
+ | 'BLOB_HEALTHCHECK_UPLOAD_INTERVAL_MINUTES'
27
28
  | 'BOT_DA_GAS_LIMIT'
28
29
  | 'BOT_FEE_PAYMENT_METHOD'
29
- | 'BOT_BASE_FEE_PADDING'
30
+ | 'BOT_MIN_FEE_PADDING'
30
31
  | 'BOT_FLUSH_SETUP_TRANSACTIONS'
31
32
  | 'BOT_FOLLOW_CHAIN'
32
33
  | 'BOT_L2_GAS_LIMIT'
@@ -63,8 +64,9 @@ export type EnvVar =
63
64
  | 'PUBLIC_DATA_TREE_MAP_SIZE_KB'
64
65
  | 'DEBUG'
65
66
  | 'DEBUG_P2P_DISABLE_COLOCATION_PENALTY'
66
- | 'DEPLOY_AZTEC_CONTRACTS_SALT'
67
67
  | 'ETHEREUM_HOSTS'
68
+ | 'ETHEREUM_DEBUG_HOSTS'
69
+ | 'ETHEREUM_ALLOW_NO_DEBUG_HOSTS'
68
70
  | 'FEE_RECIPIENT'
69
71
  | 'FORCE_COLOR'
70
72
  | 'GOVERNANCE_PROPOSER_PAYLOAD_ADDRESS'
@@ -131,8 +133,7 @@ export type EnvVar =
131
133
  | 'P2P_TRUSTED_PEERS'
132
134
  | 'P2P_PRIVATE_PEERS'
133
135
  | 'P2P_PREFERRED_PEERS'
134
- | 'P2P_MAX_TX_POOL_SIZE'
135
- | 'P2P_TX_POOL_OVERFLOW_FACTOR'
136
+ | 'P2P_MAX_PENDING_TX_COUNT'
136
137
  | 'P2P_SEEN_MSG_CACHE_SIZE'
137
138
  | 'P2P_DROP_TX'
138
139
  | 'P2P_DROP_TX_CHANCE'
@@ -166,6 +167,7 @@ export type EnvVar =
166
167
  | 'PROVER_PUBLISHER_PRIVATE_KEYS'
167
168
  | 'PROVER_PUBLISHER_ADDRESSES'
168
169
  | 'PROVER_PUBLISHER_ALLOW_INVALID_STATES'
170
+ | 'PROVER_PUBLISHER_FORWARDER_ADDRESS'
169
171
  | 'PROVER_REAL_PROOFS'
170
172
  | 'PROVER_TEST_DELAY_FACTOR'
171
173
  | 'PROVER_TEST_DELAY_MS'
@@ -190,10 +192,13 @@ export type EnvVar =
190
192
  | 'SEQ_PUBLISHER_PRIVATE_KEYS'
191
193
  | 'SEQ_PUBLISHER_ADDRESSES'
192
194
  | 'SEQ_PUBLISHER_ALLOW_INVALID_STATES'
193
- | 'SEQ_TX_POLLING_INTERVAL_MS'
195
+ | 'SEQ_PUBLISHER_FORWARDER_ADDRESS'
196
+ | 'SEQ_POLLING_INTERVAL_MS'
194
197
  | 'SEQ_ENFORCE_TIME_TABLE'
195
- | 'SEQ_MAX_L1_TX_INCLUSION_TIME_INTO_SLOT'
198
+ | 'SEQ_L1_PUBLISHING_TIME_ALLOWANCE_IN_SLOT'
196
199
  | 'SEQ_ATTESTATION_PROPAGATION_TIME'
200
+ | 'SEQ_BLOCK_DURATION_MS'
201
+ | 'SEQ_BUILD_CHECKPOINT_IF_EMPTY'
197
202
  | 'SEQ_SECONDS_BEFORE_INVALIDATING_BLOCK_AS_COMMITTEE_MEMBER'
198
203
  | 'SEQ_SECONDS_BEFORE_INVALIDATING_BLOCK_AS_NON_COMMITTEE_MEMBER'
199
204
  | 'SLASH_MIN_PENALTY_PERCENTAGE'
@@ -252,6 +257,7 @@ export type EnvVar =
252
257
  | 'AZTEC_TARGET_COMMITTEE_SIZE'
253
258
  | 'AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET'
254
259
  | 'AZTEC_LAG_IN_EPOCHS_FOR_RANDAO'
260
+ | 'AZTEC_INBOX_LAG'
255
261
  | 'AZTEC_PROOF_SUBMISSION_EPOCHS'
256
262
  | 'AZTEC_ACTIVATION_THRESHOLD'
257
263
  | 'AZTEC_EJECTION_THRESHOLD'
@@ -279,6 +285,7 @@ export type EnvVar =
279
285
  | 'L1_BLOB_FEE_PER_GAS_GWEI_MAX'
280
286
  | 'L1_PRIORITY_FEE_BUMP_PERCENTAGE'
281
287
  | 'L1_PRIORITY_FEE_RETRY_BUMP_PERCENTAGE'
288
+ | 'L1_MINIMUM_PRIORITY_FEE_PER_GAS_GWEI'
282
289
  | 'L1_FIXED_PRIORITY_FEE_PER_GAS'
283
290
  | 'L1_FIXED_PRIORITY_FEE_PER_GAS_GWEI'
284
291
  | 'L1_TX_MONITOR_MAX_ATTEMPTS'
@@ -304,4 +311,16 @@ export type EnvVar =
304
311
  | 'BLOB_ALLOW_EMPTY_SOURCES'
305
312
  | 'FISHERMAN_MODE'
306
313
  | 'MAX_ALLOWED_ETH_CLIENT_DRIFT_SECONDS'
307
- | 'LEGACY_BLS_CLI';
314
+ | 'LEGACY_BLS_CLI'
315
+ | 'DEBUG_FORCE_TX_PROOF_VERIFICATION'
316
+ | 'SLASHING_PROTECTION_NODE_ID'
317
+ | 'SLASHING_PROTECTION_POLLING_INTERVAL_MS'
318
+ | 'SLASHING_PROTECTION_SIGNING_TIMEOUT_MS'
319
+ | 'SLASHING_PROTECTION_ENABLED'
320
+ | 'SLASHING_PROTECTION_MAX_STUCK_DUTIES_AGE_MS'
321
+ | 'VALIDATOR_HA_DATABASE_URL'
322
+ | 'VALIDATOR_HA_RUN_MIGRATIONS'
323
+ | 'VALIDATOR_HA_POOL_MAX'
324
+ | 'VALIDATOR_HA_POOL_MIN'
325
+ | 'VALIDATOR_HA_POOL_IDLE_TIMEOUT_MS'
326
+ | 'VALIDATOR_HA_POOL_CONNECTION_TIMEOUT_MS';
@@ -1,6 +1,8 @@
1
- import { Fq, Fr } from '../fields/fields.js';
1
+ import { Fq, Fr } from '../curves/bn254/field.js';
2
+ import { createConsoleLogger } from '../log/console.js';
2
3
  import type { EnvVar } from './env_var.js';
3
4
  import { type NetworkNames, getActiveNetworkName } from './network_name.js';
5
+ import { parseBooleanEnv } from './parse-env.js';
4
6
  import { SecretValue } from './secret_value.js';
5
7
 
6
8
  export { SecretValue, getActiveNetworkName };
@@ -17,6 +19,11 @@ export interface ConfigMapping {
17
19
  isBoolean?: boolean;
18
20
  nested?: Record<string, ConfigMapping>;
19
21
  fallback?: EnvVar[];
22
+ /**
23
+ * List of deprecated env vars that are still supported but will log a warning.
24
+ * These should also be included in the fallback array for parsing.
25
+ */
26
+ deprecatedFallback?: { env: EnvVar; message?: string }[];
20
27
  }
21
28
 
22
29
  export function isBooleanConfigValue<T>(obj: T, key: keyof T): boolean {
@@ -72,12 +79,24 @@ export function getConfigFromMappings<T>(configMappings: ConfigMappingsType<T>):
72
79
  const config = {} as T;
73
80
 
74
81
  for (const key in configMappings) {
75
- const { env, parseEnv, defaultValue, nested, fallback } = configMappings[key];
82
+ const { env, parseEnv, defaultValue, nested, fallback, deprecatedFallback } = configMappings[key];
76
83
  if (nested) {
77
84
  (config as any)[key] = getConfigFromMappings(nested);
78
85
  } else {
79
86
  // Use the shared utility function
80
87
  (config as any)[key] = getValueFromEnvWithFallback(env, parseEnv, defaultValue, fallback);
88
+
89
+ // Check for deprecated env vars and warn if logger is set
90
+ if (deprecatedFallback?.length) {
91
+ const userLog = createConsoleLogger('[DEPRECATED]');
92
+ for (const { env: deprecatedEnv, message } of deprecatedFallback) {
93
+ if (process.env[deprecatedEnv]) {
94
+ const warningMessage =
95
+ message ?? `Environment variable ${deprecatedEnv} is deprecated. Please use ${env} instead.`;
96
+ userLog(warningMessage, { deprecatedEnvVar: deprecatedEnv, newEnvVar: env });
97
+ }
98
+ }
99
+ }
81
100
  }
82
101
  }
83
102
 
@@ -213,10 +232,7 @@ export function secretValueConfigHelper<T>(parse: (val: string | undefined) => T
213
232
  };
214
233
  }
215
234
 
216
- /** Parses an env var as boolean. Returns true only if value is 1, true, or TRUE. */
217
- export function parseBooleanEnv(val: string | undefined): boolean {
218
- return val !== undefined && ['1', 'true', 'TRUE'].includes(val);
219
- }
235
+ export { parseBooleanEnv } from './parse-env.js';
220
236
 
221
237
  export function secretStringConfigHelper(): Required<
222
238
  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {