@aztec/foundation 0.0.1-fake-ceab37513c → 0.0.2-commit.217f559981

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 (520) hide show
  1. package/dest/array/array.d.ts +1 -9
  2. package/dest/array/array.d.ts.map +1 -1
  3. package/dest/array/array.js +0 -11
  4. package/dest/array/index.d.ts +2 -1
  5. package/dest/array/index.d.ts.map +1 -1
  6. package/dest/array/index.js +1 -0
  7. package/dest/array/sorted_array.d.ts +15 -0
  8. package/dest/array/sorted_array.d.ts.map +1 -0
  9. package/dest/array/sorted_array.js +109 -0
  10. package/dest/async-map/index.d.ts +1 -1
  11. package/dest/async-pool/index.d.ts +1 -1
  12. package/dest/bigint/index.d.ts +1 -1
  13. package/dest/bigint-buffer/index.d.ts +1 -1
  14. package/dest/branded-types/block_number.d.ts +56 -0
  15. package/dest/branded-types/block_number.d.ts.map +1 -0
  16. package/dest/branded-types/block_number.js +78 -0
  17. package/dest/branded-types/checkpoint_number.d.ts +54 -0
  18. package/dest/branded-types/checkpoint_number.d.ts.map +1 -0
  19. package/dest/branded-types/checkpoint_number.js +77 -0
  20. package/dest/branded-types/epoch.d.ts +42 -0
  21. package/dest/branded-types/epoch.d.ts.map +1 -0
  22. package/dest/branded-types/epoch.js +59 -0
  23. package/dest/branded-types/index.d.ts +7 -0
  24. package/dest/branded-types/index.d.ts.map +1 -0
  25. package/dest/branded-types/index.js +5 -0
  26. package/dest/branded-types/index_within_checkpoint.d.ts +42 -0
  27. package/dest/branded-types/index_within_checkpoint.d.ts.map +1 -0
  28. package/dest/branded-types/index_within_checkpoint.js +59 -0
  29. package/dest/branded-types/slot.d.ts +42 -0
  30. package/dest/branded-types/slot.d.ts.map +1 -0
  31. package/dest/branded-types/slot.js +59 -0
  32. package/dest/branded-types/types.d.ts +5 -0
  33. package/dest/branded-types/types.d.ts.map +1 -0
  34. package/dest/branded-types/types.js +1 -0
  35. package/dest/buffer/buffer16.d.ts +2 -2
  36. package/dest/buffer/buffer16.d.ts.map +1 -1
  37. package/dest/buffer/buffer16.js +4 -2
  38. package/dest/buffer/buffer32.d.ts +2 -2
  39. package/dest/buffer/buffer32.d.ts.map +1 -1
  40. package/dest/buffer/buffer32.js +4 -2
  41. package/dest/buffer/index.d.ts +1 -1
  42. package/dest/collection/array.d.ts +14 -1
  43. package/dest/collection/array.d.ts.map +1 -1
  44. package/dest/collection/array.js +63 -3
  45. package/dest/collection/index.d.ts +1 -1
  46. package/dest/collection/object.d.ts +1 -1
  47. package/dest/committable/committable.d.ts +1 -1
  48. package/dest/committable/committable.d.ts.map +1 -1
  49. package/dest/committable/index.d.ts +1 -1
  50. package/dest/config/env_var.d.ts +2 -2
  51. package/dest/config/env_var.d.ts.map +1 -1
  52. package/dest/config/index.d.ts +15 -4
  53. package/dest/config/index.d.ts.map +1 -1
  54. package/dest/config/index.js +32 -9
  55. package/dest/config/network_config.d.ts +13 -1
  56. package/dest/config/network_config.d.ts.map +1 -1
  57. package/dest/config/network_config.js +3 -1
  58. package/dest/config/network_name.d.ts +2 -2
  59. package/dest/config/network_name.d.ts.map +1 -1
  60. package/dest/config/network_name.js +6 -0
  61. package/dest/config/parse-env.d.ts +3 -0
  62. package/dest/config/parse-env.d.ts.map +1 -0
  63. package/dest/config/parse-env.js +7 -0
  64. package/dest/config/secret_value.d.ts +1 -1
  65. package/dest/config/secret_value.d.ts.map +1 -1
  66. package/dest/config/secret_value.js +3 -1
  67. package/dest/crypto/aes128/index.d.ts +1 -1
  68. package/dest/crypto/aes128/index.d.ts.map +1 -1
  69. package/dest/crypto/aes128/index.js +19 -6
  70. package/dest/crypto/bls/bn254_keystore.d.ts +296 -0
  71. package/dest/crypto/bls/bn254_keystore.d.ts.map +1 -0
  72. package/dest/crypto/bls/bn254_keystore.js +218 -0
  73. package/dest/crypto/bls/index.d.ts +13 -0
  74. package/dest/crypto/bls/index.d.ts.map +1 -0
  75. package/dest/crypto/bls/index.js +87 -0
  76. package/dest/crypto/bn254/index.d.ts +39 -0
  77. package/dest/crypto/bn254/index.d.ts.map +1 -0
  78. package/dest/crypto/bn254/index.js +56 -0
  79. package/dest/crypto/ecdsa/index.d.ts +1 -1
  80. package/dest/crypto/ecdsa/index.d.ts.map +1 -1
  81. package/dest/crypto/ecdsa/index.js +58 -48
  82. package/dest/crypto/ecdsa/signature.d.ts +2 -2
  83. package/dest/crypto/ecdsa/signature.d.ts.map +1 -1
  84. package/dest/crypto/ecdsa/signature.js +2 -2
  85. package/dest/crypto/grumpkin/index.d.ts +10 -13
  86. package/dest/crypto/grumpkin/index.d.ts.map +1 -1
  87. package/dest/crypto/grumpkin/index.js +61 -55
  88. package/dest/crypto/keccak/index.d.ts +1 -1
  89. package/dest/crypto/keys/index.d.ts +2 -2
  90. package/dest/crypto/keys/index.d.ts.map +1 -1
  91. package/dest/crypto/keys/index.js +8 -5
  92. package/dest/crypto/pedersen/index.d.ts +1 -1
  93. package/dest/crypto/pedersen/pedersen.noble.d.ts +1 -1
  94. package/dest/crypto/pedersen/pedersen.wasm.d.ts +2 -2
  95. package/dest/crypto/pedersen/pedersen.wasm.d.ts.map +1 -1
  96. package/dest/crypto/pedersen/pedersen.wasm.js +24 -14
  97. package/dest/crypto/poseidon/index.d.ts +2 -3
  98. package/dest/crypto/poseidon/index.d.ts.map +1 -1
  99. package/dest/crypto/poseidon/index.js +27 -21
  100. package/dest/crypto/random/index.d.ts +1 -1
  101. package/dest/crypto/random/index.d.ts.map +1 -1
  102. package/dest/crypto/random/randomness_singleton.d.ts +4 -3
  103. package/dest/crypto/random/randomness_singleton.d.ts.map +1 -1
  104. package/dest/crypto/random/randomness_singleton.js +5 -5
  105. package/dest/crypto/schnorr/index.d.ts +3 -2
  106. package/dest/crypto/schnorr/index.d.ts.map +1 -1
  107. package/dest/crypto/schnorr/index.js +30 -38
  108. package/dest/crypto/schnorr/signature.d.ts +2 -2
  109. package/dest/crypto/schnorr/signature.d.ts.map +1 -1
  110. package/dest/crypto/schnorr/signature.js +2 -2
  111. package/dest/crypto/secp256k1/index.d.ts +1 -1
  112. package/dest/crypto/secp256k1/index.d.ts.map +1 -1
  113. package/dest/crypto/secp256k1/index.js +23 -18
  114. package/dest/crypto/secp256k1-signer/index.d.ts +1 -1
  115. package/dest/crypto/secp256k1-signer/secp256k1_signer.d.ts +1 -1
  116. package/dest/crypto/secp256k1-signer/secp256k1_signer.d.ts.map +1 -1
  117. package/dest/crypto/secp256k1-signer/utils.d.ts +43 -5
  118. package/dest/crypto/secp256k1-signer/utils.d.ts.map +1 -1
  119. package/dest/crypto/secp256k1-signer/utils.js +76 -8
  120. package/dest/crypto/serialize.d.ts +1 -1
  121. package/dest/crypto/sha256/index.d.ts +2 -2
  122. package/dest/crypto/sha256/index.d.ts.map +1 -1
  123. package/dest/crypto/sha256/index.js +1 -1
  124. package/dest/crypto/sha512/index.d.ts +3 -3
  125. package/dest/crypto/sha512/index.d.ts.map +1 -1
  126. package/dest/crypto/sha512/index.js +1 -1
  127. package/dest/crypto/signature/index.d.ts +2 -2
  128. package/dest/crypto/signature/index.d.ts.map +1 -1
  129. package/dest/crypto/sync/index.d.ts +1 -1
  130. package/dest/crypto/sync/index.js +1 -1
  131. package/dest/crypto/sync/pedersen/index.d.ts +2 -2
  132. package/dest/crypto/sync/pedersen/index.d.ts.map +1 -1
  133. package/dest/crypto/sync/pedersen/index.js +18 -11
  134. package/dest/crypto/sync/poseidon/index.d.ts +2 -3
  135. package/dest/crypto/sync/poseidon/index.d.ts.map +1 -1
  136. package/dest/crypto/sync/poseidon/index.js +23 -16
  137. package/dest/{fields/bls12_fields.d.ts → curves/bls12/field.d.ts} +3 -3
  138. package/dest/curves/bls12/field.d.ts.map +1 -0
  139. package/dest/{fields/bls12_fields.js → curves/bls12/field.js} +12 -9
  140. package/dest/curves/bls12/index.d.ts +3 -0
  141. package/dest/curves/bls12/index.d.ts.map +1 -0
  142. package/dest/curves/bls12/index.js +2 -0
  143. package/dest/{fields/bls12_point.d.ts → curves/bls12/point.d.ts} +11 -11
  144. package/dest/curves/bls12/point.d.ts.map +1 -0
  145. package/dest/{fields/bls12_point.js → curves/bls12/point.js} +17 -15
  146. package/dest/curves/bn254/field.d.ts +180 -0
  147. package/dest/curves/bn254/field.d.ts.map +1 -0
  148. package/dest/{fields/fields.js → curves/bn254/field.js} +71 -59
  149. package/dest/curves/bn254/index.d.ts +3 -0
  150. package/dest/curves/bn254/index.d.ts.map +1 -0
  151. package/dest/curves/bn254/index.js +2 -0
  152. package/dest/curves/bn254/point.d.ts +54 -0
  153. package/dest/curves/bn254/point.d.ts.map +1 -0
  154. package/dest/curves/bn254/point.js +143 -0
  155. package/dest/curves/grumpkin/index.d.ts +10 -0
  156. package/dest/curves/grumpkin/index.d.ts.map +1 -0
  157. package/dest/curves/grumpkin/index.js +3 -0
  158. package/dest/{fields → curves/grumpkin}/point.d.ts +12 -3
  159. package/dest/curves/grumpkin/point.d.ts.map +1 -0
  160. package/dest/{fields → curves/grumpkin}/point.js +24 -7
  161. package/dest/decorators/index.d.ts +1 -1
  162. package/dest/decorators/memoize.d.ts +1 -1
  163. package/dest/decorators/memoize.d.ts.map +1 -1
  164. package/dest/error/index.d.ts +1 -1
  165. package/dest/eth-address/index.d.ts +12 -2
  166. package/dest/eth-address/index.d.ts.map +1 -1
  167. package/dest/eth-address/index.js +27 -3
  168. package/dest/eth-signature/eth_signature.d.ts +1 -1
  169. package/dest/eth-signature/eth_signature.d.ts.map +1 -1
  170. package/dest/eth-signature/index.d.ts +1 -1
  171. package/dest/fs/index.d.ts +1 -1
  172. package/dest/fs/run_in_dir.d.ts +1 -1
  173. package/dest/fs/try_rm_dir.d.ts +1 -1
  174. package/dest/iterable/all.d.ts +1 -1
  175. package/dest/iterable/filter.d.ts +1 -1
  176. package/dest/iterable/index.d.ts +1 -1
  177. package/dest/iterable/isAsyncIt.d.ts +1 -1
  178. package/dest/iterable/map.d.ts +1 -1
  179. package/dest/iterable/peek.d.ts +1 -1
  180. package/dest/iterable/sort.d.ts +1 -1
  181. package/dest/iterable/take.d.ts +1 -1
  182. package/dest/iterable/toArray.d.ts +1 -1
  183. package/dest/iterator/filter.d.ts +3 -0
  184. package/dest/iterator/filter.d.ts.map +1 -0
  185. package/dest/iterator/filter.js +7 -0
  186. package/dest/iterator/index.d.ts +2 -0
  187. package/dest/iterator/index.d.ts.map +1 -0
  188. package/dest/iterator/index.js +1 -0
  189. package/dest/jest/setup.js +4 -1
  190. package/dest/json-rpc/client/fetch.d.ts +1 -1
  191. package/dest/json-rpc/client/index.d.ts +1 -1
  192. package/dest/json-rpc/client/safe_json_rpc_client.d.ts +2 -1
  193. package/dest/json-rpc/client/safe_json_rpc_client.d.ts.map +1 -1
  194. package/dest/json-rpc/client/safe_json_rpc_client.js +10 -1
  195. package/dest/json-rpc/client/undici.d.ts +1 -1
  196. package/dest/json-rpc/client/undici.d.ts.map +1 -1
  197. package/dest/json-rpc/client/undici.js +21 -4
  198. package/dest/json-rpc/convert.d.ts +1 -1
  199. package/dest/json-rpc/errors.d.ts +1 -1
  200. package/dest/json-rpc/errors.d.ts.map +1 -1
  201. package/dest/json-rpc/fixtures/class_a.d.ts +1 -1
  202. package/dest/json-rpc/fixtures/class_a.d.ts.map +1 -1
  203. package/dest/json-rpc/fixtures/class_b.d.ts +1 -1
  204. package/dest/json-rpc/fixtures/class_b.d.ts.map +1 -1
  205. package/dest/json-rpc/fixtures/test_state.d.ts +1 -1
  206. package/dest/json-rpc/fixtures/test_state.d.ts.map +1 -1
  207. package/dest/json-rpc/index.d.ts +1 -1
  208. package/dest/json-rpc/js_utils.d.ts +1 -1
  209. package/dest/json-rpc/js_utils.d.ts.map +1 -1
  210. package/dest/json-rpc/server/api_key_auth.d.ts +19 -0
  211. package/dest/json-rpc/server/api_key_auth.d.ts.map +1 -0
  212. package/dest/json-rpc/server/api_key_auth.js +57 -0
  213. package/dest/json-rpc/server/index.d.ts +2 -1
  214. package/dest/json-rpc/server/index.d.ts.map +1 -1
  215. package/dest/json-rpc/server/index.js +1 -0
  216. package/dest/json-rpc/server/safe_json_rpc_server.d.ts +1 -1
  217. package/dest/json-rpc/server/safe_json_rpc_server.d.ts.map +1 -1
  218. package/dest/json-rpc/server/safe_json_rpc_server.js +1 -1
  219. package/dest/json-rpc/test/index.d.ts +1 -1
  220. package/dest/json-rpc/test/integration.d.ts +1 -1
  221. package/dest/log/bigint-utils.d.ts +5 -0
  222. package/dest/log/bigint-utils.d.ts.map +1 -0
  223. package/dest/log/bigint-utils.js +18 -0
  224. package/dest/log/console.d.ts +1 -1
  225. package/dest/log/gcloud-logger-config.d.ts +1 -1
  226. package/dest/log/gcloud-logger-config.d.ts.map +1 -1
  227. package/dest/log/gcloud-logger-config.js +3 -0
  228. package/dest/log/index.d.ts +1 -1
  229. package/dest/log/libp2p_logger.d.ts +5 -2
  230. package/dest/log/libp2p_logger.d.ts.map +1 -1
  231. package/dest/log/libp2p_logger.js +14 -4
  232. package/dest/log/log-filters.d.ts +17 -4
  233. package/dest/log/log-filters.d.ts.map +1 -1
  234. package/dest/log/log-filters.js +26 -12
  235. package/dest/log/log-levels.d.ts +1 -1
  236. package/dest/log/log_fn.d.ts +1 -1
  237. package/dest/log/noir_debug_log_util.d.ts +1 -1
  238. package/dest/log/pino-logger-server.d.ts +9 -0
  239. package/dest/log/pino-logger-server.d.ts.map +1 -0
  240. package/dest/log/pino-logger-server.js +18 -0
  241. package/dest/log/pino-logger.d.ts +38 -9
  242. package/dest/log/pino-logger.d.ts.map +1 -1
  243. package/dest/log/pino-logger.js +122 -30
  244. package/dest/message/index.d.ts +1 -1
  245. package/dest/message/index.d.ts.map +1 -1
  246. package/dest/mutex/index.d.ts +1 -1
  247. package/dest/mutex/index.d.ts.map +1 -1
  248. package/dest/mutex/mutex_database.d.ts +1 -1
  249. package/dest/noir/index.d.ts +1 -1
  250. package/dest/noir/noir_package_config.d.ts +9 -9
  251. package/dest/number/index.d.ts +1 -1
  252. package/dest/profiler/index.d.ts +2 -0
  253. package/dest/profiler/index.d.ts.map +1 -0
  254. package/dest/profiler/index.js +1 -0
  255. package/dest/profiler/profiler.d.ts +8 -0
  256. package/dest/profiler/profiler.d.ts.map +1 -0
  257. package/dest/profiler/profiler.js +97 -0
  258. package/dest/promise/index.d.ts +1 -1
  259. package/dest/promise/running-promise.d.ts +1 -1
  260. package/dest/promise/running-promise.d.ts.map +1 -1
  261. package/dest/promise/utils.d.ts +1 -1
  262. package/dest/queue/base_memory_queue.d.ts +2 -2
  263. package/dest/queue/base_memory_queue.d.ts.map +1 -1
  264. package/dest/queue/batch_queue.d.ts +1 -1
  265. package/dest/queue/batch_queue.d.ts.map +1 -1
  266. package/dest/queue/bounded_serial_queue.d.ts +1 -1
  267. package/dest/queue/bounded_serial_queue.d.ts.map +1 -1
  268. package/dest/queue/fifo_memory_queue.d.ts +1 -1
  269. package/dest/queue/fifo_memory_queue.d.ts.map +1 -1
  270. package/dest/queue/index.d.ts +1 -1
  271. package/dest/queue/priority_memory_queue.d.ts +1 -1
  272. package/dest/queue/priority_memory_queue.d.ts.map +1 -1
  273. package/dest/queue/priority_queue.d.ts +1 -1
  274. package/dest/queue/priority_queue.d.ts.map +1 -1
  275. package/dest/queue/semaphore.d.ts +5 -1
  276. package/dest/queue/semaphore.d.ts.map +1 -1
  277. package/dest/queue/serial_queue.d.ts +1 -1
  278. package/dest/queue/serial_queue.d.ts.map +1 -1
  279. package/dest/retry/index.d.ts +11 -1
  280. package/dest/retry/index.d.ts.map +1 -1
  281. package/dest/retry/index.js +11 -0
  282. package/dest/running-promise/index.d.ts +1 -1
  283. package/dest/schemas/api.d.ts +1 -1
  284. package/dest/schemas/index.d.ts +1 -1
  285. package/dest/schemas/parse.d.ts +1 -1
  286. package/dest/schemas/schemas.d.ts +15 -17
  287. package/dest/schemas/schemas.d.ts.map +1 -1
  288. package/dest/schemas/schemas.js +14 -10
  289. package/dest/schemas/types.d.ts +31 -1
  290. package/dest/schemas/types.d.ts.map +1 -1
  291. package/dest/schemas/types.js +25 -1
  292. package/dest/schemas/utils.d.ts +4 -4
  293. package/dest/schemas/utils.d.ts.map +1 -1
  294. package/dest/schemas/utils.js +15 -5
  295. package/dest/serialize/buffer_reader.d.ts +14 -4
  296. package/dest/serialize/buffer_reader.d.ts.map +1 -1
  297. package/dest/serialize/buffer_reader.js +26 -4
  298. package/dest/serialize/field_reader.d.ts +2 -2
  299. package/dest/serialize/field_reader.d.ts.map +1 -1
  300. package/dest/serialize/field_reader.js +1 -1
  301. package/dest/serialize/free_funcs.d.ts +2 -2
  302. package/dest/serialize/free_funcs.d.ts.map +1 -1
  303. package/dest/serialize/free_funcs.js +1 -1
  304. package/dest/serialize/index.d.ts +1 -1
  305. package/dest/serialize/serialize.d.ts +20 -2
  306. package/dest/serialize/serialize.d.ts.map +1 -1
  307. package/dest/serialize/serialize.js +32 -1
  308. package/dest/serialize/type_registry.d.ts +1 -1
  309. package/dest/serialize/type_registry.d.ts.map +1 -1
  310. package/dest/serialize/types.d.ts +1 -1
  311. package/dest/sleep/index.d.ts +3 -1
  312. package/dest/sleep/index.d.ts.map +1 -1
  313. package/dest/sleep/index.js +4 -0
  314. package/dest/string/index.d.ts +5 -1
  315. package/dest/string/index.d.ts.map +1 -1
  316. package/dest/string/index.js +1 -1
  317. package/dest/testing/files/index.d.ts +2 -1
  318. package/dest/testing/files/index.d.ts.map +1 -1
  319. package/dest/testing/files/index.js +1 -1
  320. package/dest/testing/formatting.d.ts +4 -0
  321. package/dest/testing/formatting.d.ts.map +1 -0
  322. package/dest/testing/formatting.js +3 -0
  323. package/dest/testing/index.d.ts +2 -1
  324. package/dest/testing/index.d.ts.map +1 -1
  325. package/dest/testing/index.js +1 -0
  326. package/dest/testing/port_allocator.d.ts +1 -1
  327. package/dest/testing/snapshot_serializer.d.ts +1 -1
  328. package/dest/testing/test_data.d.ts +1 -1
  329. package/dest/timer/date.d.ts +26 -1
  330. package/dest/timer/date.d.ts.map +1 -1
  331. package/dest/timer/date.js +36 -0
  332. package/dest/timer/elapsed.d.ts +1 -1
  333. package/dest/timer/index.d.ts +1 -1
  334. package/dest/timer/timeout.d.ts +1 -1
  335. package/dest/timer/timeout.d.ts.map +1 -1
  336. package/dest/timer/timer.d.ts +1 -1
  337. package/dest/timer/timer.d.ts.map +1 -1
  338. package/dest/transport/dispatch/create_dispatch_fn.d.ts +1 -1
  339. package/dest/transport/dispatch/create_dispatch_fn.d.ts.map +1 -1
  340. package/dest/transport/dispatch/create_dispatch_proxy.d.ts +1 -1
  341. package/dest/transport/dispatch/messages.d.ts +1 -1
  342. package/dest/transport/index.d.ts +1 -1
  343. package/dest/transport/interface/connector.d.ts +1 -1
  344. package/dest/transport/interface/listener.d.ts +1 -1
  345. package/dest/transport/interface/socket.d.ts +1 -1
  346. package/dest/transport/interface/transferable.d.ts +1 -1
  347. package/dest/transport/node/index.d.ts +1 -1
  348. package/dest/transport/node/node_connector.d.ts +1 -1
  349. package/dest/transport/node/node_connector.d.ts.map +1 -1
  350. package/dest/transport/node/node_connector_socket.d.ts +1 -1
  351. package/dest/transport/node/node_connector_socket.d.ts.map +1 -1
  352. package/dest/transport/node/node_listener.d.ts +1 -1
  353. package/dest/transport/node/node_listener.d.ts.map +1 -1
  354. package/dest/transport/node/node_listener_socket.d.ts +1 -1
  355. package/dest/transport/node/node_listener_socket.d.ts.map +1 -1
  356. package/dest/transport/transport_client.d.ts +1 -1
  357. package/dest/transport/transport_client.d.ts.map +1 -1
  358. package/dest/transport/transport_server.d.ts +1 -10
  359. package/dest/transport/transport_server.d.ts.map +1 -1
  360. package/dest/trees/balanced_merkle_tree_root.d.ts +17 -0
  361. package/dest/trees/balanced_merkle_tree_root.d.ts.map +1 -0
  362. package/dest/trees/balanced_merkle_tree_root.js +51 -0
  363. package/dest/trees/hasher.d.ts +3 -1
  364. package/dest/trees/hasher.d.ts.map +1 -1
  365. package/dest/trees/hasher.js +10 -5
  366. package/dest/trees/index.d.ts +4 -3
  367. package/dest/trees/index.d.ts.map +1 -1
  368. package/dest/trees/index.js +3 -2
  369. package/dest/trees/indexed_merkle_tree.d.ts +1 -1
  370. package/dest/trees/indexed_merkle_tree.d.ts.map +1 -1
  371. package/dest/trees/indexed_merkle_tree.js +1 -1
  372. package/dest/trees/indexed_merkle_tree_calculator.d.ts +1 -1
  373. package/dest/trees/indexed_merkle_tree_calculator.d.ts.map +1 -1
  374. package/dest/trees/indexed_tree_leaf.d.ts +1 -1
  375. package/dest/trees/membership_witness.d.ts +7 -18
  376. package/dest/trees/membership_witness.d.ts.map +1 -1
  377. package/dest/trees/membership_witness.js +10 -1
  378. package/dest/trees/merkle_tree.d.ts +1 -1
  379. package/dest/trees/merkle_tree.d.ts.map +1 -1
  380. package/dest/trees/merkle_tree_calculator.d.ts +2 -12
  381. package/dest/trees/merkle_tree_calculator.d.ts.map +1 -1
  382. package/dest/trees/merkle_tree_calculator.js +2 -32
  383. package/dest/trees/sibling_path.d.ts +5 -38
  384. package/dest/trees/sibling_path.d.ts.map +1 -1
  385. package/dest/trees/sibling_path.js +3 -3
  386. package/dest/trees/unbalanced_merkle_tree_calculator.d.ts +26 -23
  387. package/dest/trees/unbalanced_merkle_tree_calculator.d.ts.map +1 -1
  388. package/dest/trees/unbalanced_merkle_tree_calculator.js +119 -97
  389. package/dest/trees/unbalanced_merkle_tree_root.d.ts +28 -0
  390. package/dest/trees/unbalanced_merkle_tree_root.d.ts.map +1 -0
  391. package/dest/trees/unbalanced_merkle_tree_root.js +84 -0
  392. package/dest/trees/unbalanced_tree_store.d.ts +6 -1
  393. package/dest/trees/unbalanced_tree_store.d.ts.map +1 -1
  394. package/dest/trees/unbalanced_tree_store.js +55 -1
  395. package/dest/types/index.d.ts +6 -2
  396. package/dest/types/index.d.ts.map +1 -1
  397. package/dest/types/index.js +6 -0
  398. package/dest/url/index.d.ts +1 -1
  399. package/dest/validation/index.d.ts +1 -1
  400. package/package.json +53 -8
  401. package/src/array/array.ts +0 -16
  402. package/src/array/index.ts +1 -0
  403. package/src/array/sorted_array.ts +138 -0
  404. package/src/branded-types/block_number.ts +117 -0
  405. package/src/branded-types/checkpoint_number.ts +115 -0
  406. package/src/branded-types/epoch.ts +88 -0
  407. package/src/branded-types/index.ts +7 -0
  408. package/src/branded-types/index_within_checkpoint.ts +88 -0
  409. package/src/branded-types/slot.ts +88 -0
  410. package/src/branded-types/types.ts +2 -0
  411. package/src/buffer/buffer16.ts +2 -2
  412. package/src/buffer/buffer32.ts +2 -2
  413. package/src/collection/array.ts +67 -3
  414. package/src/config/env_var.ts +82 -15
  415. package/src/config/index.ts +39 -6
  416. package/src/config/network_config.ts +2 -0
  417. package/src/config/network_name.ts +15 -1
  418. package/src/config/parse-env.ts +4 -0
  419. package/src/crypto/aes128/index.ts +19 -10
  420. package/src/crypto/bls/bn254_keystore.ts +287 -0
  421. package/src/crypto/bls/index.ts +77 -0
  422. package/src/crypto/bn254/index.ts +64 -0
  423. package/src/crypto/ecdsa/index.ts +40 -37
  424. package/src/crypto/ecdsa/signature.ts +2 -2
  425. package/src/crypto/grumpkin/index.ts +38 -46
  426. package/src/crypto/keys/index.ts +6 -6
  427. package/src/crypto/pedersen/pedersen.wasm.ts +23 -19
  428. package/src/crypto/poseidon/index.ts +27 -29
  429. package/src/crypto/random/randomness_singleton.ts +6 -4
  430. package/src/crypto/schnorr/index.ts +22 -18
  431. package/src/crypto/schnorr/signature.ts +2 -2
  432. package/src/crypto/secp256k1/index.ts +15 -11
  433. package/src/crypto/secp256k1-signer/utils.ts +102 -10
  434. package/src/crypto/sha256/index.ts +1 -1
  435. package/src/crypto/sha512/index.ts +1 -1
  436. package/src/crypto/signature/index.ts +1 -1
  437. package/src/crypto/sync/index.ts +1 -1
  438. package/src/crypto/sync/pedersen/index.ts +17 -16
  439. package/src/crypto/sync/poseidon/index.ts +23 -27
  440. package/src/{fields/bls12_fields.ts → curves/bls12/field.ts} +6 -6
  441. package/src/curves/bls12/index.ts +2 -0
  442. package/src/{fields/bls12_point.ts → curves/bls12/point.ts} +14 -14
  443. package/src/{fields/fields.ts → curves/bn254/field.ts} +69 -62
  444. package/src/curves/bn254/index.ts +2 -0
  445. package/src/curves/bn254/point.ts +170 -0
  446. package/src/curves/grumpkin/index.ts +11 -0
  447. package/src/{fields → curves/grumpkin}/point.ts +26 -7
  448. package/src/eth-address/index.ts +27 -2
  449. package/src/iterator/filter.ts +11 -0
  450. package/src/iterator/index.ts +1 -0
  451. package/src/jest/setup.mjs +4 -1
  452. package/src/json-rpc/client/safe_json_rpc_client.ts +11 -0
  453. package/src/json-rpc/client/undici.ts +21 -3
  454. package/src/json-rpc/server/api_key_auth.ts +63 -0
  455. package/src/json-rpc/server/index.ts +1 -0
  456. package/src/json-rpc/server/safe_json_rpc_server.ts +1 -1
  457. package/src/log/bigint-utils.ts +22 -0
  458. package/src/log/gcloud-logger-config.ts +5 -0
  459. package/src/log/libp2p_logger.ts +12 -5
  460. package/src/log/log-filters.ts +29 -11
  461. package/src/log/pino-logger-server.ts +25 -0
  462. package/src/log/pino-logger.ts +144 -40
  463. package/src/profiler/index.ts +1 -0
  464. package/src/profiler/profiler.ts +125 -0
  465. package/src/queue/base_memory_queue.ts +1 -1
  466. package/src/queue/semaphore.ts +5 -0
  467. package/src/retry/index.ts +18 -0
  468. package/src/schemas/schemas.ts +24 -13
  469. package/src/schemas/types.ts +33 -0
  470. package/src/schemas/utils.ts +21 -8
  471. package/src/serialize/buffer_reader.ts +36 -9
  472. package/src/serialize/field_reader.ts +1 -1
  473. package/src/serialize/free_funcs.ts +1 -1
  474. package/src/serialize/serialize.ts +33 -1
  475. package/src/sleep/index.ts +6 -0
  476. package/src/string/index.ts +3 -0
  477. package/src/testing/files/index.ts +1 -1
  478. package/src/testing/formatting.ts +3 -0
  479. package/src/testing/index.ts +1 -0
  480. package/src/timer/date.ts +52 -0
  481. package/src/trees/balanced_merkle_tree_root.ts +68 -0
  482. package/src/trees/hasher.ts +9 -0
  483. package/src/trees/index.ts +3 -2
  484. package/src/trees/indexed_merkle_tree.ts +1 -1
  485. package/src/trees/membership_witness.ts +9 -1
  486. package/src/trees/merkle_tree_calculator.ts +2 -35
  487. package/src/trees/sibling_path.ts +3 -3
  488. package/src/trees/unbalanced_merkle_tree_calculator.ts +123 -93
  489. package/src/trees/unbalanced_merkle_tree_root.ts +115 -0
  490. package/src/trees/unbalanced_tree_store.ts +62 -3
  491. package/src/types/index.ts +11 -1
  492. package/dest/crypto/index.d.ts +0 -15
  493. package/dest/crypto/index.d.ts.map +0 -1
  494. package/dest/crypto/index.js +0 -14
  495. package/dest/fields/bls12_fields.d.ts.map +0 -1
  496. package/dest/fields/bls12_point.d.ts.map +0 -1
  497. package/dest/fields/coordinate.d.ts +0 -66
  498. package/dest/fields/coordinate.d.ts.map +0 -1
  499. package/dest/fields/coordinate.js +0 -96
  500. package/dest/fields/fields.d.ts +0 -174
  501. package/dest/fields/fields.d.ts.map +0 -1
  502. package/dest/fields/index.d.ts +0 -6
  503. package/dest/fields/index.d.ts.map +0 -1
  504. package/dest/fields/index.js +0 -5
  505. package/dest/fields/point.d.ts.map +0 -1
  506. package/dest/index.d.ts +0 -29
  507. package/dest/index.d.ts.map +0 -1
  508. package/dest/index.js +0 -29
  509. package/dest/json-rpc/server/telemetry.d.ts +0 -2
  510. package/dest/json-rpc/server/telemetry.d.ts.map +0 -1
  511. package/dest/json-rpc/server/telemetry.js +0 -0
  512. package/dest/trees/unbalanced_merkle_tree.d.ts +0 -29
  513. package/dest/trees/unbalanced_merkle_tree.d.ts.map +0 -1
  514. package/dest/trees/unbalanced_merkle_tree.js +0 -99
  515. package/src/crypto/index.ts +0 -14
  516. package/src/fields/coordinate.ts +0 -104
  517. package/src/fields/index.ts +0 -5
  518. package/src/index.ts +0 -29
  519. package/src/json-rpc/server/telemetry.ts +0 -0
  520. package/src/trees/unbalanced_merkle_tree.ts +0 -111
package/package.json CHANGED
@@ -1,9 +1,29 @@
1
1
  {
2
2
  "name": "@aztec/foundation",
3
- "version": "0.0.1-fake-ceab37513c",
3
+ "version": "0.0.2-commit.217f559981",
4
4
  "type": "module",
5
5
  "main": "./dest/index.js",
6
6
  "types": "./dest/index.d.ts",
7
+ "typedocOptions": {
8
+ "entryPoints": [
9
+ "./src/buffer/index.ts",
10
+ "./src/collection/index.ts",
11
+ "./src/config/index.ts",
12
+ "./src/crypto/random/index.ts",
13
+ "./src/error/index.ts",
14
+ "./src/eth-address/index.ts",
15
+ "./src/json-rpc/index.ts",
16
+ "./src/log/index.ts",
17
+ "./src/retry/index.ts",
18
+ "./src/schemas/index.ts",
19
+ "./src/serialize/index.ts",
20
+ "./src/sleep/index.ts",
21
+ "./src/timer/index.ts",
22
+ "./src/types/index.ts"
23
+ ],
24
+ "name": "Foundation",
25
+ "tsconfig": "./tsconfig.json"
26
+ },
7
27
  "exports": {
8
28
  "./eslint": "./eslint.config.js",
9
29
  "./eslint.docs": "./eslint.config.docs.js",
@@ -12,10 +32,30 @@
12
32
  "./async-map": "./dest/async-map/index.js",
13
33
  "./async-pool": "./dest/async-pool/index.js",
14
34
  "./bigint": "./dest/bigint/index.js",
35
+ "./branded-types": "./dest/branded-types/index.js",
15
36
  "./collection": "./dest/collection/index.js",
16
37
  "./config": "./dest/config/index.js",
17
- "./crypto": "./dest/crypto/index.js",
38
+ "./crypto/aes128": "./dest/crypto/aes128/index.js",
39
+ "./crypto/bls": "./dest/crypto/bls/index.js",
40
+ "./crypto/bls/bn254_keystore": "./dest/crypto/bls/bn254_keystore.js",
41
+ "./crypto/bn254": "./dest/crypto/bn254/index.js",
42
+ "./crypto/ecdsa": "./dest/crypto/ecdsa/index.js",
43
+ "./crypto/grumpkin": "./dest/crypto/grumpkin/index.js",
44
+ "./crypto/keccak": "./dest/crypto/keccak/index.js",
45
+ "./crypto/keys": "./dest/crypto/keys/index.js",
46
+ "./crypto/pedersen": "./dest/crypto/pedersen/index.js",
47
+ "./crypto/poseidon": "./dest/crypto/poseidon/index.js",
48
+ "./crypto/random": "./dest/crypto/random/index.js",
49
+ "./crypto/schnorr": "./dest/crypto/schnorr/index.js",
50
+ "./crypto/secp256k1": "./dest/crypto/secp256k1/index.js",
51
+ "./crypto/secp256k1-signer": "./dest/crypto/secp256k1-signer/index.js",
52
+ "./crypto/sha256": "./dest/crypto/sha256/index.js",
53
+ "./crypto/sha512": "./dest/crypto/sha512/index.js",
54
+ "./crypto/signature": "./dest/crypto/signature/index.js",
18
55
  "./crypto/sync": "./dest/crypto/sync/index.js",
56
+ "./curves/bn254": "./dest/curves/bn254/index.js",
57
+ "./curves/grumpkin": "./dest/curves/grumpkin/index.js",
58
+ "./curves/bls12": "./dest/curves/bls12/index.js",
19
59
  "./decorators": "./dest/decorators/index.js",
20
60
  "./error": "./dest/error/index.js",
21
61
  "./eth-address": "./dest/eth-address/index.js",
@@ -29,9 +69,10 @@
29
69
  "./json-rpc/undici": "./dest/json-rpc/client/undici.js",
30
70
  "./json-rpc/test": "./dest/json-rpc/test/index.js",
31
71
  "./iterable": "./dest/iterable/index.js",
72
+ "./iterator": "./dest/iterator/index.js",
32
73
  "./log": "./dest/log/index.js",
74
+ "./log/server": "./dest/log/pino-logger-server.js",
33
75
  "./mutex": "./dest/mutex/index.js",
34
- "./fields": "./dest/fields/index.js",
35
76
  "./retry": "./dest/retry/index.js",
36
77
  "./running-promise": "./dest/running-promise/index.js",
37
78
  "./serialize": "./dest/serialize/index.js",
@@ -47,6 +88,7 @@
47
88
  "./noir": "./dest/noir/index.js",
48
89
  "./testing": "./dest/testing/index.js",
49
90
  "./testing/files": "./dest/testing/files/index.js",
91
+ "./profiler": "./dest/profiler/index.js",
50
92
  "./array": "./dest/array/index.js",
51
93
  "./validation": "./dest/validation/index.js",
52
94
  "./promise": "./dest/promise/index.js",
@@ -55,8 +97,8 @@
55
97
  "./number": "./dest/number/index.js"
56
98
  },
57
99
  "scripts": {
58
- "build": "yarn clean && tsc -b",
59
- "build:dev": "tsc -b --watch",
100
+ "build": "yarn clean && ../scripts/tsc.sh",
101
+ "build:dev": "../scripts/tsc.sh --watch",
60
102
  "clean": "rm -rf ./dest .tsbuildinfo",
61
103
  "generate": "true",
62
104
  "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}"
@@ -102,9 +144,11 @@
102
144
  "testEnvironment": "../../foundation/src/jest/env.mjs"
103
145
  },
104
146
  "dependencies": {
105
- "@aztec/bb.js": "0.0.1-fake-ceab37513c",
147
+ "@aztec/bb.js": "0.0.2-commit.217f559981",
106
148
  "@koa/cors": "^5.0.0",
107
149
  "@noble/curves": "=1.7.0",
150
+ "@noble/hashes": "^1.6.1",
151
+ "@scure/bip39": "^2.0.1",
108
152
  "bn.js": "^5.2.1",
109
153
  "colorette": "^2.0.20",
110
154
  "detect-node": "^2.1.0",
@@ -139,10 +183,11 @@
139
183
  "@types/node": "^22.15.17",
140
184
  "@types/pako": "^2.0.0",
141
185
  "@types/supertest": "^2.0.12",
186
+ "@typescript/native-preview": "7.0.0-dev.20260113.1",
142
187
  "comlink": "^4.4.1",
143
188
  "eslint": "^9.26.0",
144
189
  "eslint-config-prettier": "^10.1.5",
145
- "eslint-plugin-import": "^2.31.0",
190
+ "eslint-plugin-import-x": "^4.6.1",
146
191
  "eslint-plugin-jsdoc": "^50.6.14",
147
192
  "eslint-plugin-no-only-tests": "^3.3.0",
148
193
  "eslint-plugin-tsdoc": "^0.4.0",
@@ -153,7 +198,7 @@
153
198
  "ts-node": "^10.9.1",
154
199
  "typescript": "^5.3.3",
155
200
  "typescript-eslint": "^8.32.1",
156
- "viem": "npm:@spalladino/viem@2.38.2-eip7594.0"
201
+ "viem": "npm:@aztec/viem@2.38.2"
157
202
  },
158
203
  "files": [
159
204
  "dest",
@@ -42,22 +42,6 @@ export async function makeTupleAsync<T, N extends number>(length: N, fn: (i: num
42
42
  )) as Tuple<T, N>;
43
43
  }
44
44
 
45
- /**
46
- * Create an array over an integer range, filled with a function 'fn'. However, the latter half of the array are set to zeros.
47
- * see `makeTuple` above.
48
- * @param n - The number of integers.
49
- * @param fn - The generator function.
50
- * @returns The array of numbers.
51
- */
52
- export function makeHalfFullTuple<T, N extends number>(
53
- length: N,
54
- fn: (i: number) => T,
55
- offset = 0,
56
- makeEmpty: () => T,
57
- ) {
58
- return Array.from({ length }, (_: any, i: number) => (i < length / 2 ? fn(i + offset) : makeEmpty())) as Tuple<T, N>;
59
- }
60
-
61
45
  /**
62
46
  * Assert a member of an object is a certain length.
63
47
  * @param obj - An object.
@@ -1 +1,2 @@
1
1
  export * from './array.js';
2
+ export * from './sorted_array.js';
@@ -0,0 +1,138 @@
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
+ const index = findInsertionIndexInSortedArray(arr, item, cmp);
25
+
26
+ if (!allowDuplicates) {
27
+ // Check element before insertion point (upper bound returns index after equal elements)
28
+ if (index > 0 && cmp(arr[index - 1], item) === 0) {
29
+ return false;
30
+ }
31
+ }
32
+
33
+ arr.splice(index, 0, item);
34
+ return true;
35
+ }
36
+
37
+ /**
38
+ * Finds the index where needle would be inserted to maintain sorted order.
39
+ * Returns the count of elements less than or equal to needle.
40
+ */
41
+ export function findInsertionIndexInSortedArray<T, N>(values: T[], needle: N, cmp: (a: T, b: N) => number): number {
42
+ let start = 0;
43
+ let end = values.length;
44
+
45
+ while (start < end) {
46
+ const mid = start + (((end - start) / 2) | 0);
47
+ const comparison = cmp(values[mid], needle);
48
+
49
+ if (comparison <= 0) {
50
+ start = mid + 1;
51
+ } else {
52
+ end = mid;
53
+ }
54
+ }
55
+
56
+ return start;
57
+ }
58
+
59
+ export function findIndexInSortedArray<T, N>(values: T[], needle: N, cmp: (a: T, b: N) => number): number {
60
+ let start = 0;
61
+ let end = values.length - 1;
62
+
63
+ while (start <= end) {
64
+ const mid = start + (((end - start) / 2) | 0);
65
+ const comparison = cmp(values[mid], needle);
66
+
67
+ if (comparison === 0) {
68
+ return mid;
69
+ }
70
+
71
+ if (comparison > 0) {
72
+ end = mid - 1;
73
+ } else {
74
+ start = mid + 1;
75
+ }
76
+ }
77
+
78
+ return -1;
79
+ }
80
+
81
+ export function findInSortedArray<T, N>(values: T[], needle: N, cmp: (a: T, b: N) => number): T | undefined {
82
+ const idx = findIndexInSortedArray(values, needle, cmp);
83
+ return idx > -1 ? values[idx] : undefined;
84
+ }
85
+
86
+ export function removeAnyOf<T, N>(arr: T[], vals: N[], cmp: (a: T, b: N) => -1 | 0 | 1): void {
87
+ let writeIdx = 0;
88
+ let readIdx = 0;
89
+ let valIdx = 0;
90
+
91
+ while (readIdx < arr.length && valIdx < vals.length) {
92
+ const comparison = cmp(arr[readIdx], vals[valIdx]);
93
+
94
+ if (comparison < 0) {
95
+ arr[writeIdx++] = arr[readIdx++];
96
+ } else if (comparison > 0) {
97
+ valIdx++;
98
+ } else {
99
+ readIdx++;
100
+ }
101
+ }
102
+
103
+ while (readIdx < arr.length) {
104
+ arr[writeIdx++] = arr[readIdx++];
105
+ }
106
+
107
+ arr.length = writeIdx;
108
+ }
109
+
110
+ export function removeFromSortedArray<T, N>(arr: T[], val: N, cmp: (a: T, b: N) => -1 | 0 | 1) {
111
+ const idx = findIndexInSortedArray(arr, val, cmp);
112
+ if (idx > -1) {
113
+ arr.splice(idx, 1);
114
+ }
115
+ }
116
+
117
+ export function merge<T>(arr: T[], toInsert: T[], cmp: (a: T, b: T) => -1 | 0 | 1): void {
118
+ const result = new Array<T>(arr.length + toInsert.length);
119
+ let i = 0,
120
+ j = 0,
121
+ k = 0;
122
+
123
+ while (i < arr.length && j < toInsert.length) {
124
+ result[k++] = cmp(arr[i], toInsert[j]) <= 0 ? arr[i++] : toInsert[j++];
125
+ }
126
+
127
+ while (i < arr.length) {
128
+ result[k++] = arr[i++];
129
+ }
130
+ while (j < toInsert.length) {
131
+ result[k++] = toInsert[j++];
132
+ }
133
+
134
+ for (i = 0; i < result.length; i++) {
135
+ arr[i] = result[i];
136
+ }
137
+ arr.length = result.length;
138
+ }
@@ -0,0 +1,117 @@
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
+ /** Increments a BlockNumber by a given value. */
91
+ BlockNumber.add = function (bn: BlockNumber, increment: number): BlockNumber {
92
+ return BlockNumber(bn + increment);
93
+ };
94
+
95
+ /**
96
+ * The zero block value (genesis block).
97
+ */
98
+ BlockNumber.ZERO = BlockNumber(0);
99
+
100
+ function makeBlockNumberSchema(minValue: number) {
101
+ return z
102
+ .union([z.number(), z.bigint(), z.string()])
103
+ .pipe(z.coerce.number().int().min(minValue))
104
+ .transform(value => BlockNumber(value));
105
+ }
106
+
107
+ /**
108
+ * Zod schema for parsing and validating BlockNumber values.
109
+ * Accepts numbers, bigints, or strings and coerces them to BlockNumber.
110
+ */
111
+ export const BlockNumberSchema = makeBlockNumberSchema(0);
112
+
113
+ /**
114
+ * Zod schema for parsing and validating BlockNumber values that are strictly positive.
115
+ * Accepts numbers, bigints, or strings and coerces them to BlockNumber.
116
+ */
117
+ 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);
@@ -0,0 +1,88 @@
1
+ import { z } from 'zod';
2
+
3
+ import type { Branded } from './types.js';
4
+
5
+ /**
6
+ * A branded type representing an epoch number.
7
+ * Epochs are used in the Aztec protocol to group slots and manage validator committees.
8
+ *
9
+ * This is a nominal type backed by a number, but TypeScript will treat it as
10
+ * incompatible with plain numbers and other branded numeric types (like Slot, BlockNumber, etc.).
11
+ *
12
+ * @example
13
+ * ```ts
14
+ * const epoch = EpochNumber(5);
15
+ * const plainNumber: number = epoch; // OK - EpochNumber is assignable to number
16
+ * const epochFromNumber: EpochNumber = 5; // ERROR - number is not assignable to EpochNumber
17
+ * ```
18
+ */
19
+ export type EpochNumber = Branded<number, 'EpochNumber'>;
20
+
21
+ /**
22
+ * Creates an EpochNumber from a number.
23
+ * @param value - The epoch number (must be a non-negative integer)
24
+ * @returns The branded EpochNumber value
25
+ * @throws If the value is negative or not an integer
26
+ */
27
+ export function EpochNumber(value: number): EpochNumber {
28
+ if (!Number.isInteger(value)) {
29
+ throw new Error(`EpochNumber must be an integer, got ${value}`);
30
+ }
31
+ if (value < 0) {
32
+ throw new Error(`EpochNumber must be non-negative, got ${value}`);
33
+ }
34
+ return value as EpochNumber;
35
+ }
36
+
37
+ /**
38
+ * Creates an EpochNumber from a bigint.
39
+ * @param value - The epoch number as bigint (must be a non-negative integer within safe integer range)
40
+ * @returns The branded EpochNumber value
41
+ * @throws If the value is negative or exceeds Number.MAX_SAFE_INTEGER
42
+ */
43
+ EpochNumber.fromBigInt = function (value: bigint): EpochNumber {
44
+ if (value < 0n) {
45
+ throw new Error(`EpochNumber must be non-negative, got ${value}`);
46
+ }
47
+ if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
48
+ throw new Error(`EpochNumber ${value} exceeds MAX_SAFE_INTEGER`);
49
+ }
50
+ return Number(value) as EpochNumber;
51
+ };
52
+
53
+ /**
54
+ * Creates an EpochNumber from a string.
55
+ * @param value - The epoch number as a string
56
+ * @returns The branded EpochNumber value
57
+ * @throws If the string cannot be parsed as a valid epoch
58
+ */
59
+ EpochNumber.fromString = function (value: string): EpochNumber {
60
+ const parsed = parseInt(value, 10);
61
+ if (isNaN(parsed)) {
62
+ throw new Error(`Cannot parse EpochNumber from string: ${value}`);
63
+ }
64
+ return EpochNumber(parsed);
65
+ };
66
+
67
+ /**
68
+ * Type guard to check if a value is a valid EpochNumber.
69
+ * Note: At runtime, an EpochNumber is just a number, so this checks if the value
70
+ * is a non-negative integer.
71
+ */
72
+ EpochNumber.isValid = function (value: unknown): value is EpochNumber {
73
+ return typeof value === 'number' && Number.isInteger(value) && value >= 0;
74
+ };
75
+
76
+ /**
77
+ * The zero epoch value.
78
+ */
79
+ EpochNumber.ZERO = EpochNumber(0);
80
+
81
+ /**
82
+ * Zod schema for parsing and validating EpochNumber values.
83
+ * Accepts numbers, bigints, or strings and coerces them to EpochNumber.
84
+ */
85
+ export const EpochNumberSchema = z
86
+ .union([z.number(), z.bigint(), z.string()])
87
+ .pipe(z.coerce.number().int().min(0))
88
+ .transform(value => EpochNumber(value));
@@ -0,0 +1,7 @@
1
+ export { BlockNumber, BlockNumberSchema, BlockNumberPositiveSchema } from './block_number.js';
2
+ export { CheckpointNumber, CheckpointNumberSchema, CheckpointNumberPositiveSchema } from './checkpoint_number.js';
3
+ export { EpochNumber, EpochNumberSchema } from './epoch.js';
4
+ export { IndexWithinCheckpoint, IndexWithinCheckpointSchema } from './index_within_checkpoint.js';
5
+ export { SlotNumber, SlotNumberSchema } from './slot.js';
6
+
7
+ export type { Branded } from './types.js';