@aztec/foundation 5.0.0-private.20260319 → 5.0.0-rc.1

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 (244) hide show
  1. package/dest/bigint-buffer/index.d.ts +1 -1
  2. package/dest/bigint-buffer/index.d.ts.map +1 -1
  3. package/dest/bigint-buffer/index.js +6 -1
  4. package/dest/branded-types/block_number.d.ts +3 -3
  5. package/dest/branded-types/block_number.d.ts.map +1 -1
  6. package/dest/branded-types/block_number.js +15 -4
  7. package/dest/branded-types/buffer32_hash.d.ts +27 -0
  8. package/dest/branded-types/buffer32_hash.d.ts.map +1 -0
  9. package/dest/branded-types/buffer32_hash.js +12 -0
  10. package/dest/branded-types/checkpoint_number.d.ts +9 -3
  11. package/dest/branded-types/checkpoint_number.d.ts.map +1 -1
  12. package/dest/branded-types/checkpoint_number.js +11 -0
  13. package/dest/branded-types/epoch.d.ts +2 -2
  14. package/dest/branded-types/epoch.d.ts.map +1 -1
  15. package/dest/branded-types/index.d.ts +2 -1
  16. package/dest/branded-types/index.d.ts.map +1 -1
  17. package/dest/branded-types/index.js +1 -0
  18. package/dest/branded-types/index_within_checkpoint.d.ts +2 -2
  19. package/dest/branded-types/index_within_checkpoint.d.ts.map +1 -1
  20. package/dest/branded-types/slot.d.ts +5 -2
  21. package/dest/branded-types/slot.d.ts.map +1 -1
  22. package/dest/branded-types/slot.js +3 -0
  23. package/dest/buffer/buffer16.d.ts +3 -1
  24. package/dest/buffer/buffer16.d.ts.map +1 -1
  25. package/dest/buffer/buffer32.d.ts +28 -61
  26. package/dest/buffer/buffer32.d.ts.map +1 -1
  27. package/dest/buffer/buffer32.js +29 -63
  28. package/dest/collection/array.d.ts +11 -1
  29. package/dest/collection/array.d.ts.map +1 -1
  30. package/dest/collection/array.js +33 -0
  31. package/dest/collection/index.d.ts +3 -1
  32. package/dest/collection/index.d.ts.map +1 -1
  33. package/dest/collection/index.js +2 -0
  34. package/dest/collection/lru_map.d.ts +41 -0
  35. package/dest/collection/lru_map.d.ts.map +1 -0
  36. package/dest/collection/lru_map.js +119 -0
  37. package/dest/collection/lru_set.d.ts +35 -0
  38. package/dest/collection/lru_set.d.ts.map +1 -0
  39. package/dest/collection/lru_set.js +95 -0
  40. package/dest/committable/committable.js +1 -1
  41. package/dest/config/env_var.d.ts +2 -2
  42. package/dest/config/env_var.d.ts.map +1 -1
  43. package/dest/config/index.d.ts +47 -30
  44. package/dest/config/index.d.ts.map +1 -1
  45. package/dest/config/index.js +30 -45
  46. package/dest/config/network_config.d.ts +11 -55
  47. package/dest/config/network_config.d.ts.map +1 -1
  48. package/dest/config/network_name.d.ts +2 -2
  49. package/dest/config/network_name.d.ts.map +1 -1
  50. package/dest/config/network_name.js +1 -3
  51. package/dest/config/secret_value.d.ts +2 -2
  52. package/dest/config/secret_value.d.ts.map +1 -1
  53. package/dest/crypto/aes128/index.d.ts +2 -1
  54. package/dest/crypto/aes128/index.d.ts.map +1 -1
  55. package/dest/crypto/aes128/index.js +11 -2
  56. package/dest/crypto/bls/bn254_keystore.d.ts +9 -176
  57. package/dest/crypto/bls/bn254_keystore.d.ts.map +1 -1
  58. package/dest/crypto/bls/bn254_keystore.js +0 -17
  59. package/dest/crypto/poseidon/index.d.ts +1 -1
  60. package/dest/crypto/poseidon/index.d.ts.map +1 -1
  61. package/dest/crypto/poseidon/index.js +40 -33
  62. package/dest/crypto/schnorr/index.d.ts +8 -7
  63. package/dest/crypto/schnorr/index.d.ts.map +1 -1
  64. package/dest/crypto/schnorr/index.js +6 -6
  65. package/dest/crypto/schnorr/signature.d.ts +9 -29
  66. package/dest/crypto/schnorr/signature.d.ts.map +1 -1
  67. package/dest/crypto/schnorr/signature.js +20 -36
  68. package/dest/curves/bls12/field.d.ts +3 -3
  69. package/dest/curves/bls12/field.d.ts.map +1 -1
  70. package/dest/curves/bls12/field.js +0 -5
  71. package/dest/curves/bls12/point.d.ts +2 -2
  72. package/dest/curves/bls12/point.d.ts.map +1 -1
  73. package/dest/curves/bn254/field.d.ts +23 -19
  74. package/dest/curves/bn254/field.d.ts.map +1 -1
  75. package/dest/curves/bn254/field.js +23 -17
  76. package/dest/curves/grumpkin/point.d.ts +14 -28
  77. package/dest/curves/grumpkin/point.d.ts.map +1 -1
  78. package/dest/curves/grumpkin/point.js +29 -43
  79. package/dest/eth-address/index.d.ts +2 -2
  80. package/dest/eth-address/index.d.ts.map +1 -1
  81. package/dest/eth-address/index.js +0 -3
  82. package/dest/eth-signature/eth_signature.d.ts +2 -2
  83. package/dest/eth-signature/eth_signature.d.ts.map +1 -1
  84. package/dest/fifo/fifo_frame_reader.d.ts +41 -0
  85. package/dest/fifo/fifo_frame_reader.d.ts.map +1 -0
  86. package/dest/fifo/fifo_frame_reader.js +74 -0
  87. package/dest/fifo/index.d.ts +2 -0
  88. package/dest/fifo/index.d.ts.map +1 -0
  89. package/dest/fifo/index.js +1 -0
  90. package/dest/fifo_set/fifo_set.d.ts +15 -0
  91. package/dest/fifo_set/fifo_set.d.ts.map +1 -0
  92. package/dest/fifo_set/fifo_set.js +39 -0
  93. package/dest/fifo_set/index.d.ts +2 -0
  94. package/dest/fifo_set/index.d.ts.map +1 -0
  95. package/dest/fifo_set/index.js +1 -0
  96. package/dest/json-rpc/client/fetch.d.ts +1 -1
  97. package/dest/json-rpc/client/fetch.d.ts.map +1 -1
  98. package/dest/json-rpc/client/fetch.js +4 -3
  99. package/dest/json-rpc/client/safe_json_rpc_client.d.ts +1 -1
  100. package/dest/json-rpc/client/safe_json_rpc_client.d.ts.map +1 -1
  101. package/dest/json-rpc/client/safe_json_rpc_client.js +2 -2
  102. package/dest/json-rpc/client/undici.d.ts +1 -1
  103. package/dest/json-rpc/client/undici.d.ts.map +1 -1
  104. package/dest/json-rpc/client/undici.js +5 -3
  105. package/dest/json-rpc/fixtures/test_state.d.ts +4 -8
  106. package/dest/json-rpc/fixtures/test_state.d.ts.map +1 -1
  107. package/dest/json-rpc/fixtures/test_state.js +57 -17
  108. package/dest/json-rpc/server/safe_json_rpc_server.d.ts +8 -3
  109. package/dest/json-rpc/server/safe_json_rpc_server.d.ts.map +1 -1
  110. package/dest/json-rpc/server/safe_json_rpc_server.js +27 -13
  111. package/dest/log/pino-logger.d.ts +1 -1
  112. package/dest/log/pino-logger.d.ts.map +1 -1
  113. package/dest/log/pino-logger.js +17 -2
  114. package/dest/noir/noir_package_config.d.ts +19 -104
  115. package/dest/noir/noir_package_config.d.ts.map +1 -1
  116. package/dest/noir/noir_package_config.js +1 -1
  117. package/dest/queue/batch_queue.d.ts +1 -1
  118. package/dest/queue/batch_queue.d.ts.map +1 -1
  119. package/dest/queue/batch_queue.js +1 -0
  120. package/dest/retry/index.d.ts +31 -3
  121. package/dest/retry/index.d.ts.map +1 -1
  122. package/dest/retry/index.js +44 -2
  123. package/dest/schemas/api.d.ts +12 -10
  124. package/dest/schemas/api.d.ts.map +1 -1
  125. package/dest/schemas/api.js +7 -1
  126. package/dest/schemas/parse.d.ts +4 -4
  127. package/dest/schemas/parse.d.ts.map +1 -1
  128. package/dest/schemas/parse.js +6 -5
  129. package/dest/schemas/schemas.d.ts +15 -15
  130. package/dest/schemas/types.d.ts +3 -3
  131. package/dest/schemas/types.d.ts.map +1 -1
  132. package/dest/schemas/utils.d.ts +7 -11
  133. package/dest/schemas/utils.d.ts.map +1 -1
  134. package/dest/schemas/utils.js +2 -18
  135. package/dest/serialize/buffer_sink.d.ts +134 -0
  136. package/dest/serialize/buffer_sink.d.ts.map +1 -0
  137. package/dest/serialize/buffer_sink.js +297 -0
  138. package/dest/serialize/index.d.ts +2 -1
  139. package/dest/serialize/index.d.ts.map +1 -1
  140. package/dest/serialize/index.js +1 -0
  141. package/dest/string/index.js +1 -1
  142. package/dest/timer/index.d.ts +2 -2
  143. package/dest/timer/index.d.ts.map +1 -1
  144. package/dest/timer/index.js +1 -1
  145. package/dest/timer/timeout.d.ts +3 -1
  146. package/dest/timer/timeout.d.ts.map +1 -1
  147. package/dest/timer/timeout.js +26 -0
  148. package/dest/transport/dispatch/create_dispatch_proxy.d.ts +11 -2
  149. package/dest/transport/dispatch/create_dispatch_proxy.d.ts.map +1 -1
  150. package/dest/transport/index.d.ts +1 -2
  151. package/dest/transport/index.d.ts.map +1 -1
  152. package/dest/transport/index.js +0 -1
  153. package/dest/trees/balanced_merkle_tree_root.d.ts +2 -3
  154. package/dest/trees/balanced_merkle_tree_root.d.ts.map +1 -1
  155. package/dest/trees/balanced_merkle_tree_root.js +2 -3
  156. package/dest/trees/hasher.d.ts +3 -2
  157. package/dest/trees/hasher.d.ts.map +1 -1
  158. package/dest/trees/hasher.js +5 -5
  159. package/dest/trees/indexed_merkle_tree_calculator.d.ts +1 -1
  160. package/dest/trees/indexed_merkle_tree_calculator.d.ts.map +1 -1
  161. package/dest/trees/indexed_merkle_tree_calculator.js +5 -1
  162. package/dest/trees/membership_witness.d.ts +2 -2
  163. package/dest/trees/membership_witness.d.ts.map +1 -1
  164. package/dest/trees/merkle_tree_calculator.d.ts +4 -2
  165. package/dest/trees/merkle_tree_calculator.d.ts.map +1 -1
  166. package/dest/trees/merkle_tree_calculator.js +1 -5
  167. package/dest/trees/sibling_path.d.ts +5 -4
  168. package/dest/trees/sibling_path.d.ts.map +1 -1
  169. package/dest/trees/sibling_path.js +10 -8
  170. package/dest/trees/unbalanced_merkle_tree_root.d.ts +2 -3
  171. package/dest/trees/unbalanced_merkle_tree_root.d.ts.map +1 -1
  172. package/dest/trees/unbalanced_merkle_tree_root.js +2 -3
  173. package/dest/types/index.d.ts +23 -1
  174. package/dest/types/index.d.ts.map +1 -1
  175. package/dest/types/index.js +15 -0
  176. package/package.json +6 -4
  177. package/src/bigint-buffer/index.ts +6 -1
  178. package/src/branded-types/block_number.ts +20 -2
  179. package/src/branded-types/buffer32_hash.ts +38 -0
  180. package/src/branded-types/checkpoint_number.ts +16 -1
  181. package/src/branded-types/epoch.ts +1 -1
  182. package/src/branded-types/index.ts +1 -0
  183. package/src/branded-types/index_within_checkpoint.ts +1 -1
  184. package/src/branded-types/slot.ts +6 -1
  185. package/src/buffer/buffer16.ts +3 -0
  186. package/src/buffer/buffer32.ts +39 -68
  187. package/src/collection/array.ts +34 -0
  188. package/src/collection/index.ts +2 -0
  189. package/src/collection/lru_map.ts +143 -0
  190. package/src/collection/lru_set.ts +115 -0
  191. package/src/committable/committable.ts +1 -1
  192. package/src/config/env_var.ts +35 -23
  193. package/src/config/index.ts +102 -97
  194. package/src/config/network_name.ts +2 -5
  195. package/src/config/secret_value.ts +1 -1
  196. package/src/crypto/aes128/index.ts +11 -2
  197. package/src/crypto/bls/bn254_keystore.ts +0 -23
  198. package/src/crypto/poseidon/index.ts +42 -34
  199. package/src/crypto/schnorr/index.ts +9 -8
  200. package/src/crypto/schnorr/signature.ts +17 -46
  201. package/src/curves/bls12/field.ts +0 -7
  202. package/src/curves/bn254/field.ts +35 -34
  203. package/src/curves/grumpkin/point.ts +23 -40
  204. package/src/eth-address/index.ts +0 -4
  205. package/src/fifo/fifo_frame_reader.ts +98 -0
  206. package/src/fifo/index.ts +1 -0
  207. package/src/fifo_set/fifo_set.ts +52 -0
  208. package/src/fifo_set/index.ts +1 -0
  209. package/src/json-rpc/client/fetch.ts +4 -3
  210. package/src/json-rpc/client/safe_json_rpc_client.ts +2 -2
  211. package/src/json-rpc/client/undici.ts +5 -3
  212. package/src/json-rpc/fixtures/test_state.ts +10 -10
  213. package/src/json-rpc/server/safe_json_rpc_server.ts +31 -13
  214. package/src/log/pino-logger.ts +19 -2
  215. package/src/noir/noir_package_config.ts +32 -20
  216. package/src/queue/batch_queue.ts +1 -0
  217. package/src/retry/index.ts +66 -4
  218. package/src/schemas/api.ts +25 -25
  219. package/src/schemas/parse.ts +9 -6
  220. package/src/schemas/schemas.ts +4 -4
  221. package/src/schemas/types.ts +2 -2
  222. package/src/schemas/utils.ts +4 -38
  223. package/src/serialize/buffer_sink.ts +350 -0
  224. package/src/serialize/index.ts +1 -0
  225. package/src/string/index.ts +1 -1
  226. package/src/timer/index.ts +1 -1
  227. package/src/timer/timeout.ts +31 -0
  228. package/src/transport/dispatch/create_dispatch_proxy.ts +11 -1
  229. package/src/transport/index.ts +0 -1
  230. package/src/trees/balanced_merkle_tree_root.ts +2 -5
  231. package/src/trees/hasher.ts +6 -3
  232. package/src/trees/indexed_merkle_tree_calculator.ts +5 -1
  233. package/src/trees/merkle_tree_calculator.ts +4 -10
  234. package/src/trees/sibling_path.ts +11 -6
  235. package/src/trees/unbalanced_merkle_tree_root.ts +2 -5
  236. package/src/types/index.ts +47 -0
  237. package/dest/crypto/serialize.d.ts +0 -51
  238. package/dest/crypto/serialize.d.ts.map +0 -1
  239. package/dest/crypto/serialize.js +0 -68
  240. package/dest/transport/dispatch/create_dispatch_fn.d.ts +0 -25
  241. package/dest/transport/dispatch/create_dispatch_fn.d.ts.map +0 -1
  242. package/dest/transport/dispatch/create_dispatch_fn.js +0 -17
  243. package/src/crypto/serialize.ts +0 -85
  244. package/src/transport/dispatch/create_dispatch_fn.ts +0 -35
@@ -37,4 +37,4 @@ export declare function toHex(num: bigint, padTo32?: boolean): `0x${string}`;
37
37
  * @returns A buffer.
38
38
  */
39
39
  export declare function fromHex(value: string): Buffer;
40
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9iaWdpbnQtYnVmZmVyL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7O0dBSUc7QUFDSCx3QkFBZ0IsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQVE5QztBQUVEOzs7O0dBSUc7QUFDSCx3QkFBZ0IsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQU05QztBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxNQUFNLEdBQUcsTUFBTSxDQVE3RDtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxNQUFNLEdBQUcsTUFBTSxDQVU3RDtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLEtBQUssQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLE9BQU8sVUFBUSxHQUFHLEtBQUssTUFBTSxFQUFFLENBS2pFO0FBRUQ7Ozs7R0FJRztBQUNILHdCQUFnQixPQUFPLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxNQUFNLENBTTdDIn0=
40
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9iaWdpbnQtYnVmZmVyL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7O0dBSUc7QUFDSCx3QkFBZ0IsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQVE5QztBQUVEOzs7O0dBSUc7QUFDSCx3QkFBZ0IsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsTUFBTSxDQU05QztBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxNQUFNLEdBQUcsTUFBTSxDQVE3RDtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxNQUFNLEdBQUcsTUFBTSxDQWU3RDtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLEtBQUssQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLE9BQU8sVUFBUSxHQUFHLEtBQUssTUFBTSxFQUFFLENBS2pFO0FBRUQ7Ozs7R0FJRztBQUNILHdCQUFnQixPQUFPLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxNQUFNLENBTTdDIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bigint-buffer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAU7D;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,KAAK,MAAM,EAAE,CAKjE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bigint-buffer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAe7D;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,KAAK,MAAM,EAAE,CAKjE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C"}
@@ -42,9 +42,14 @@
42
42
  * @param width - The number of bytes that the resulting buffer should be.
43
43
  * @returns A big-endian buffer representation of num.
44
44
  */ export function toBufferBE(num, width) {
45
- if (num < BigInt(0)) {
45
+ if (num < 0n) {
46
46
  throw new Error(`Cannot convert negative bigint ${num.toString()} to buffer with toBufferBE.`);
47
47
  }
48
+ // The values serialized in the hot paths are overwhelmingly zero (field elements are mostly
49
+ // zero-padding in protocol structs), and the hex round-trip is wasteful for them.
50
+ if (num === 0n) {
51
+ return Buffer.alloc(width);
52
+ }
48
53
  const hex = num.toString(16);
49
54
  const buffer = Buffer.from(hex.padStart(width * 2, '0').slice(0, width * 2), 'hex');
50
55
  if (buffer.length > width) {
@@ -47,10 +47,10 @@ export declare namespace BlockNumber {
47
47
  * Zod schema for parsing and validating BlockNumber values.
48
48
  * Accepts numbers, bigints, or strings and coerces them to BlockNumber.
49
49
  */
50
- export declare const BlockNumberSchema: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, BlockNumber, string | number | bigint>;
50
+ export declare const BlockNumberSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodBigInt, z.ZodTransform<number, bigint>>, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>, z.ZodTransform<BlockNumber, number>>;
51
51
  /**
52
52
  * Zod schema for parsing and validating BlockNumber values that are strictly positive.
53
53
  * Accepts numbers, bigints, or strings and coerces them to BlockNumber.
54
54
  */
55
- export declare const BlockNumberPositiveSchema: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, BlockNumber, string | number | bigint>;
56
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2tfbnVtYmVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYnJhbmRlZC10eXBlcy9ibG9ja19udW1iZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQy9ELE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLFlBQVksQ0FBQztBQUUxQzs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxNQUFNLE1BQU0sV0FBVyxHQUFHLE9BQU8sQ0FBQyxNQUFNLEVBQUUsYUFBYSxDQUFDLENBQUM7QUFFekQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsV0FBVyxDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsV0FBVyxDQVF0RDs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQXFFRDs7O0dBR0c7QUFDSCxlQUFPLE1BQU0saUJBQWlCLHNJQUEyQixDQUFDO0FBRTFEOzs7R0FHRztBQUNILGVBQU8sTUFBTSx5QkFBeUIsc0lBQTJCLENBQUMifQ==
55
+ export declare const BlockNumberPositiveSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodBigInt, z.ZodTransform<number, bigint>>, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>, z.ZodTransform<BlockNumber, number>>;
56
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2tfbnVtYmVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYnJhbmRlZC10eXBlcy9ibG9ja19udW1iZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQy9ELE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLFlBQVksQ0FBQztBQUUxQzs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxNQUFNLE1BQU0sV0FBVyxHQUFHLE9BQU8sQ0FBQyxNQUFNLEVBQUUsYUFBYSxDQUFDLENBQUM7QUFFekQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsV0FBVyxDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsV0FBVyxDQVF0RDs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQXVGRDs7O0dBR0c7QUFDSCxlQUFPLE1BQU0saUJBQWlCLG9NQUEyQixDQUFDO0FBRTFEOzs7R0FHRztBQUNILGVBQU8sTUFBTSx5QkFBeUIsb01BQTJCLENBQUMifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"block_number.d.ts","sourceRoot":"","sources":["../../src/branded-types/block_number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAQtD;;;;;;;;;;;;;;;;;;;AAqED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,sIAA2B,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,yBAAyB,sIAA2B,CAAC"}
1
+ {"version":3,"file":"block_number.d.ts","sourceRoot":"","sources":["../../src/branded-types/block_number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAQtD;;;;;;;;;;;;;;;;;;;AAuFD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,oMAA2B,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,yBAAyB,oMAA2B,CAAC"}
@@ -62,11 +62,22 @@ import { z } from 'zod';
62
62
  * The zero block value (genesis block).
63
63
  */ BlockNumber.ZERO = BlockNumber(0);
64
64
  function makeBlockNumberSchema(minValue) {
65
+ const max = Number.MAX_SAFE_INTEGER;
65
66
  return z.union([
66
- z.number(),
67
- z.bigint(),
68
- z.string()
69
- ]).pipe(z.coerce.number().int().min(minValue)).transform((value)=>BlockNumber(value));
67
+ z.number().int().min(minValue).max(max),
68
+ z.bigint().min(BigInt(minValue)).max(BigInt(max)).transform((v)=>Number(v)),
69
+ z.string().regex(/^\d+$/, 'BlockNumber string must be a non-negative decimal integer').transform((v, ctx)=>{
70
+ const parsed = Number(v);
71
+ if (!Number.isInteger(parsed) || parsed > max || parsed < minValue) {
72
+ ctx.addIssue({
73
+ code: z.ZodIssueCode.custom,
74
+ message: `BlockNumber out of range: ${v}`
75
+ });
76
+ return z.NEVER;
77
+ }
78
+ return parsed;
79
+ })
80
+ ]).transform((value)=>BlockNumber(value));
70
81
  }
71
82
  /**
72
83
  * Zod schema for parsing and validating BlockNumber values.
@@ -0,0 +1,27 @@
1
+ import type { Branded } from './types.js';
2
+ /**
3
+ * A branded `0x`-prefixed hex string representing a checkpoint proposal payload hash.
4
+ *
5
+ * A `CheckpointProposal` and the matching `CheckpointAttestation` sign the same
6
+ * `ConsensusPayload`, so they share this hash type. Used by the p2p attestation
7
+ * pool to dedup signed payloads and detect equivocations.
8
+ */
9
+ export type CheckpointProposalHash = Branded<`0x${string}`, 'CheckpointProposalHash'>;
10
+ /** Brands a `0x`-prefixed hex string as a CheckpointProposalHash. */
11
+ export declare function CheckpointProposalHash(s: `0x${string}`): CheckpointProposalHash;
12
+ export declare namespace CheckpointProposalHash {
13
+ var fromBuffer: (buf: Buffer<ArrayBufferLike>) => CheckpointProposalHash;
14
+ }
15
+ /**
16
+ * A branded `0x`-prefixed hex string representing a block proposal payload hash.
17
+ *
18
+ * Used by the p2p attestation pool to dedup signed payloads at a given
19
+ * `(slot, indexWithinCheckpoint)` and detect equivocations.
20
+ */
21
+ export type BlockProposalHash = Branded<`0x${string}`, 'BlockProposalHash'>;
22
+ /** Brands a `0x`-prefixed hex string as a BlockProposalHash. */
23
+ export declare function BlockProposalHash(s: `0x${string}`): BlockProposalHash;
24
+ export declare namespace BlockProposalHash {
25
+ var fromBuffer: (buf: Buffer<ArrayBufferLike>) => BlockProposalHash;
26
+ }
27
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyMzJfaGFzaC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2JyYW5kZWQtdHlwZXMvYnVmZmVyMzJfaGFzaC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFMUM7Ozs7OztHQU1HO0FBQ0gsTUFBTSxNQUFNLHNCQUFzQixHQUFHLE9BQU8sQ0FBQyxLQUFLLE1BQU0sRUFBRSxFQUFFLHdCQUF3QixDQUFDLENBQUM7QUFFdEYscUVBQXFFO0FBQ3JFLHdCQUFnQixzQkFBc0IsQ0FBQyxDQUFDLEVBQUUsS0FBSyxNQUFNLEVBQUUsR0FBRyxzQkFBc0IsQ0FFL0U7Ozs7QUFPRDs7Ozs7R0FLRztBQUNILE1BQU0sTUFBTSxpQkFBaUIsR0FBRyxPQUFPLENBQUMsS0FBSyxNQUFNLEVBQUUsRUFBRSxtQkFBbUIsQ0FBQyxDQUFDO0FBRTVFLGdFQUFnRTtBQUNoRSx3QkFBZ0IsaUJBQWlCLENBQUMsQ0FBQyxFQUFFLEtBQUssTUFBTSxFQUFFLEdBQUcsaUJBQWlCLENBRXJFIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"buffer32_hash.d.ts","sourceRoot":"","sources":["../../src/branded-types/buffer32_hash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC;AAEtF,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,sBAAsB,CAE/E;;;;AAOD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC;AAE5E,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,iBAAiB,CAErE"}
@@ -0,0 +1,12 @@
1
+ /** Brands a `0x`-prefixed hex string as a CheckpointProposalHash. */ export function CheckpointProposalHash(s) {
2
+ return s;
3
+ }
4
+ /** Constructs a CheckpointProposalHash from a raw 32-byte hash buffer. */ CheckpointProposalHash.fromBuffer = function(buf) {
5
+ return `0x${buf.toString('hex')}`;
6
+ };
7
+ /** Brands a `0x`-prefixed hex string as a BlockProposalHash. */ export function BlockProposalHash(s) {
8
+ return s;
9
+ }
10
+ /** Constructs a BlockProposalHash from a raw 32-byte hash buffer. */ BlockProposalHash.fromBuffer = function(buf) {
11
+ return `0x${buf.toString('hex')}`;
12
+ };
@@ -35,6 +35,12 @@ export declare namespace CheckpointNumber {
35
35
  export declare namespace CheckpointNumber {
36
36
  var isValid: (value: unknown) => value is CheckpointNumber;
37
37
  }
38
+ export declare namespace CheckpointNumber {
39
+ var add: (n: CheckpointNumber, increment: number) => CheckpointNumber;
40
+ }
41
+ export declare namespace CheckpointNumber {
42
+ var max: (...values: (CheckpointNumber | undefined)[]) => CheckpointNumber | undefined;
43
+ }
38
44
  export declare namespace CheckpointNumber {
39
45
  var ZERO: CheckpointNumber;
40
46
  }
@@ -45,10 +51,10 @@ export declare namespace CheckpointNumber {
45
51
  * Zod schema for parsing and validating Checkpoint values.
46
52
  * Accepts numbers, bigints, or strings and coerces them to CheckpointNumber.
47
53
  */
48
- export declare const CheckpointNumberSchema: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, CheckpointNumber, string | number | bigint>;
54
+ export declare const CheckpointNumberSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodCoercedNumber<string | number | bigint>>, z.ZodTransform<CheckpointNumber, number>>;
49
55
  /**
50
56
  * Zod schema for parsing and validating CheckpointNumber values that are strictly positive.
51
57
  * Accepts numbers, bigints, or strings and coerces them to CheckpointNumber.
52
58
  */
53
- export declare const CheckpointNumberPositiveSchema: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, CheckpointNumber, string | number | bigint>;
54
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hlY2twb2ludF9udW1iZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9icmFuZGVkLXR5cGVzL2NoZWNrcG9pbnRfbnVtYmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDckQsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRTFDOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxNQUFNLE1BQU0sZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLE1BQU0sRUFBRSxrQkFBa0IsQ0FBQyxDQUFDO0FBRW5FOzs7OztHQUtHO0FBQ0gsd0JBQWdCLGdCQUFnQixDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsZ0JBQWdCLENBUWhFOzs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBcUVEOzs7R0FHRztBQUNILGVBQU8sTUFBTSxzQkFBc0IsMklBQWdDLENBQUM7QUFFcEU7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLDhCQUE4QiwySUFBZ0MsQ0FBQyJ9
59
+ export declare const CheckpointNumberPositiveSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodCoercedNumber<string | number | bigint>>, z.ZodTransform<CheckpointNumber, number>>;
60
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hlY2twb2ludF9udW1iZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9icmFuZGVkLXR5cGVzL2NoZWNrcG9pbnRfbnVtYmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFHeEIsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDckQsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRTFDOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxNQUFNLE1BQU0sZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLE1BQU0sRUFBRSxrQkFBa0IsQ0FBQyxDQUFDO0FBRW5FOzs7OztHQUtHO0FBQ0gsd0JBQWdCLGdCQUFnQixDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsZ0JBQWdCLENBUWhFOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBbUZEOzs7R0FHRztBQUNILGVBQU8sTUFBTSxzQkFBc0IsNEtBQWdDLENBQUM7QUFFcEU7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLDhCQUE4Qiw0S0FBZ0MsQ0FBQyJ9
@@ -1 +1 @@
1
- {"version":3,"file":"checkpoint_number.d.ts","sourceRoot":"","sources":["../../src/branded-types/checkpoint_number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAQhE;;;;;;;;;;;;;;;;;;;AAqED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,2IAAgC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,8BAA8B,2IAAgC,CAAC"}
1
+ {"version":3,"file":"checkpoint_number.d.ts","sourceRoot":"","sources":["../../src/branded-types/checkpoint_number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAQhE;;;;;;;;;;;;;;;;;;;;;;;;;AAmFD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,4KAAgC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,8BAA8B,4KAAgC,CAAC"}
@@ -1,4 +1,5 @@
1
1
  import { z } from 'zod';
2
+ import { isDefined } from '../types/index.js';
2
3
  /**
3
4
  * Creates an CheckpointNumber from a number.
4
5
  * @param value - The checkpoint number (must be a non-negative integer)
@@ -55,6 +56,16 @@ import { z } from 'zod';
55
56
  */ CheckpointNumber.isValid = function(value) {
56
57
  return typeof value === 'number' && Number.isInteger(value) && value >= 0;
57
58
  };
59
+ /** Increments a CheckpointNumber by a given value. */ CheckpointNumber.add = function(n, increment) {
60
+ return CheckpointNumber(n + increment);
61
+ };
62
+ /** Computes max of a set of checkpoint numbers, ignoring undefined values. */ CheckpointNumber.max = function(...values) {
63
+ const filtered = values.filter(isDefined);
64
+ if (filtered.length === 0) {
65
+ return undefined;
66
+ }
67
+ return CheckpointNumber(Math.max(...filtered));
68
+ };
58
69
  /** The zero checkpoint value. */ CheckpointNumber.ZERO = CheckpointNumber(0);
59
70
  /** Initial checkpoint. */ CheckpointNumber.INITIAL = CheckpointNumber(1);
60
71
  /**
@@ -38,5 +38,5 @@ export declare namespace EpochNumber {
38
38
  * Zod schema for parsing and validating EpochNumber values.
39
39
  * Accepts numbers, bigints, or strings and coerces them to EpochNumber.
40
40
  */
41
- export declare const EpochNumberSchema: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, EpochNumber, string | number | bigint>;
42
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXBvY2guZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9icmFuZGVkLXR5cGVzL2Vwb2NoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRTFDOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxNQUFNLE1BQU0sV0FBVyxHQUFHLE9BQU8sQ0FBQyxNQUFNLEVBQUUsYUFBYSxDQUFDLENBQUM7QUFFekQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsV0FBVyxDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsV0FBVyxDQVF0RDs7Ozs7Ozs7Ozs7OztBQThDRDs7O0dBR0c7QUFDSCxlQUFPLE1BQU0saUJBQWlCLHNJQUdXLENBQUMifQ==
41
+ export declare const EpochNumberSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodCoercedNumber<string | number | bigint>>, z.ZodTransform<EpochNumber, number>>;
42
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXBvY2guZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9icmFuZGVkLXR5cGVzL2Vwb2NoLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRTFDOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxNQUFNLE1BQU0sV0FBVyxHQUFHLE9BQU8sQ0FBQyxNQUFNLEVBQUUsYUFBYSxDQUFDLENBQUM7QUFFekQ7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IsV0FBVyxDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsV0FBVyxDQVF0RDs7Ozs7Ozs7Ozs7OztBQThDRDs7O0dBR0c7QUFDSCxlQUFPLE1BQU0saUJBQWlCLHVLQUdXLENBQUMifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"epoch.d.ts","sourceRoot":"","sources":["../../src/branded-types/epoch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAQtD;;;;;;;;;;;;;AA8CD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,sIAGW,CAAC"}
1
+ {"version":3,"file":"epoch.d.ts","sourceRoot":"","sources":["../../src/branded-types/epoch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAQtD;;;;;;;;;;;;;AA8CD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,uKAGW,CAAC"}
@@ -1,7 +1,8 @@
1
1
  export { BlockNumber, BlockNumberSchema, BlockNumberPositiveSchema } from './block_number.js';
2
+ export { BlockProposalHash, CheckpointProposalHash } from './buffer32_hash.js';
2
3
  export { CheckpointNumber, CheckpointNumberSchema, CheckpointNumberPositiveSchema } from './checkpoint_number.js';
3
4
  export { EpochNumber, EpochNumberSchema } from './epoch.js';
4
5
  export { IndexWithinCheckpoint, IndexWithinCheckpointSchema } from './index_within_checkpoint.js';
5
6
  export { SlotNumber, SlotNumberSchema } from './slot.js';
6
7
  export type { Branded } from './types.js';
7
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9icmFuZGVkLXR5cGVzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQUUsaUJBQWlCLEVBQUUseUJBQXlCLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUM5RixPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsc0JBQXNCLEVBQUUsOEJBQThCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNsSCxPQUFPLEVBQUUsV0FBVyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQzVELE9BQU8sRUFBRSxxQkFBcUIsRUFBRSwyQkFBMkIsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQ2xHLE9BQU8sRUFBRSxVQUFVLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFFekQsWUFBWSxFQUFFLE9BQU8sRUFBRSxNQUFNLFlBQVksQ0FBQyJ9
8
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9icmFuZGVkLXR5cGVzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQUUsaUJBQWlCLEVBQUUseUJBQXlCLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUM5RixPQUFPLEVBQUUsaUJBQWlCLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUMvRSxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsc0JBQXNCLEVBQUUsOEJBQThCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNsSCxPQUFPLEVBQUUsV0FBVyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQzVELE9BQU8sRUFBRSxxQkFBcUIsRUFBRSwyQkFBMkIsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQ2xHLE9BQU8sRUFBRSxVQUFVLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFFekQsWUFBWSxFQUFFLE9BQU8sRUFBRSxNQUFNLFlBQVksQ0FBQyJ9
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/branded-types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEzD,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/branded-types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEzD,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}
@@ -1,4 +1,5 @@
1
1
  export { BlockNumber, BlockNumberSchema, BlockNumberPositiveSchema } from './block_number.js';
2
+ export { BlockProposalHash, CheckpointProposalHash } from './buffer32_hash.js';
2
3
  export { CheckpointNumber, CheckpointNumberSchema, CheckpointNumberPositiveSchema } from './checkpoint_number.js';
3
4
  export { EpochNumber, EpochNumberSchema } from './epoch.js';
4
5
  export { IndexWithinCheckpoint, IndexWithinCheckpointSchema } from './index_within_checkpoint.js';
@@ -38,5 +38,5 @@ export declare namespace IndexWithinCheckpoint {
38
38
  * Zod schema for parsing and validating IndexWithinCheckpoint values.
39
39
  * Accepts numbers, bigints, or strings and coerces them to IndexWithinCheckpoint.
40
40
  */
41
- export declare const IndexWithinCheckpointSchema: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, IndexWithinCheckpoint, string | number | bigint>;
42
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXhfd2l0aGluX2NoZWNrcG9pbnQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9icmFuZGVkLXR5cGVzL2luZGV4X3dpdGhpbl9jaGVja3BvaW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRTFDOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxNQUFNLE1BQU0scUJBQXFCLEdBQUcsT0FBTyxDQUFDLE1BQU0sRUFBRSx1QkFBdUIsQ0FBQyxDQUFDO0FBRTdFOzs7OztHQUtHO0FBQ0gsd0JBQWdCLHFCQUFxQixDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcscUJBQXFCLENBUTFFOzs7Ozs7Ozs7Ozs7O0FBOENEOzs7R0FHRztBQUNILGVBQU8sTUFBTSwyQkFBMkIsZ0pBR1csQ0FBQyJ9
41
+ export declare const IndexWithinCheckpointSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodCoercedNumber<string | number | bigint>>, z.ZodTransform<IndexWithinCheckpoint, number>>;
42
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXhfd2l0aGluX2NoZWNrcG9pbnQuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9icmFuZGVkLXR5cGVzL2luZGV4X3dpdGhpbl9jaGVja3BvaW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRTFDOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxNQUFNLE1BQU0scUJBQXFCLEdBQUcsT0FBTyxDQUFDLE1BQU0sRUFBRSx1QkFBdUIsQ0FBQyxDQUFDO0FBRTdFOzs7OztHQUtHO0FBQ0gsd0JBQWdCLHFCQUFxQixDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcscUJBQXFCLENBUTFFOzs7Ozs7Ozs7Ozs7O0FBOENEOzs7R0FHRztBQUNILGVBQU8sTUFBTSwyQkFBMkIsaUxBR1csQ0FBQyJ9
@@ -1 +1 @@
1
- {"version":3,"file":"index_within_checkpoint.d.ts","sourceRoot":"","sources":["../../src/branded-types/index_within_checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAQ1E;;;;;;;;;;;;;AA8CD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,gJAGW,CAAC"}
1
+ {"version":3,"file":"index_within_checkpoint.d.ts","sourceRoot":"","sources":["../../src/branded-types/index_within_checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAQ1E;;;;;;;;;;;;;AA8CD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,iLAGW,CAAC"}
@@ -31,6 +31,9 @@ export declare namespace SlotNumber {
31
31
  export declare namespace SlotNumber {
32
32
  var isValid: (value: unknown) => value is SlotNumber;
33
33
  }
34
+ export declare namespace SlotNumber {
35
+ var add: (sn: SlotNumber, increment: number) => SlotNumber;
36
+ }
34
37
  export declare namespace SlotNumber {
35
38
  var ZERO: SlotNumber;
36
39
  }
@@ -38,5 +41,5 @@ export declare namespace SlotNumber {
38
41
  * Zod schema for parsing and validating SlotNumber values.
39
42
  * Accepts numbers, bigints, or strings and coerces them to SlotNumber.
40
43
  */
41
- export declare const SlotNumberSchema: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, SlotNumber, string | number | bigint>;
42
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2xvdC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2JyYW5kZWQtdHlwZXMvc2xvdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLFlBQVksQ0FBQztBQUUxQzs7Ozs7Ozs7Ozs7OztHQWFHO0FBQ0gsTUFBTSxNQUFNLFVBQVUsR0FBRyxPQUFPLENBQUMsTUFBTSxFQUFFLFlBQVksQ0FBQyxDQUFDO0FBRXZEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLFVBQVUsQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLFVBQVUsQ0FRcEQ7Ozs7Ozs7Ozs7Ozs7QUE4Q0Q7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLGdCQUFnQixxSUFHVyxDQUFDIn0=
44
+ export declare const SlotNumberSchema: z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodCoercedNumber<string | number | bigint>>, z.ZodTransform<SlotNumber, number>>;
45
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2xvdC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2JyYW5kZWQtdHlwZXMvc2xvdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLFlBQVksQ0FBQztBQUUxQzs7Ozs7Ozs7Ozs7OztHQWFHO0FBQ0gsTUFBTSxNQUFNLFVBQVUsR0FBRyxPQUFPLENBQUMsTUFBTSxFQUFFLFlBQVksQ0FBQyxDQUFDO0FBRXZEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLFVBQVUsQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLFVBQVUsQ0FRcEQ7Ozs7Ozs7Ozs7Ozs7Ozs7QUFtREQ7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLGdCQUFnQixzS0FHVyxDQUFDIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../src/branded-types/slot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAQpD;;;;;;;;;;;;;AA8CD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,qIAGW,CAAC"}
1
+ {"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../src/branded-types/slot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAQpD;;;;;;;;;;;;;;;;AAmDD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,sKAGW,CAAC"}
@@ -46,6 +46,9 @@ import { z } from 'zod';
46
46
  */ SlotNumber.isValid = function(value) {
47
47
  return typeof value === 'number' && Number.isInteger(value) && value >= 0;
48
48
  };
49
+ /** Increments a SlotNumber by a given value. */ SlotNumber.add = function(sn, increment) {
50
+ return SlotNumber(sn + increment);
51
+ };
49
52
  /**
50
53
  * The zero slot value.
51
54
  */ SlotNumber.ZERO = SlotNumber(0);
@@ -9,6 +9,8 @@ export declare class Buffer16 {
9
9
  * The buffer containing the hash.
10
10
  */
11
11
  buffer: Buffer;
12
+ /** Branding for nominal typing. */
13
+ private readonly _branding;
12
14
  /**
13
15
  * The size of the hash in bytes.
14
16
  */
@@ -77,4 +79,4 @@ export declare class Buffer16 {
77
79
  */
78
80
  static random(): Buffer16;
79
81
  }
80
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyMTYuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9idWZmZXIvYnVmZmVyMTYudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDekQsT0FBTyxFQUFFLFlBQVksRUFBc0MsTUFBTSw2QkFBNkIsQ0FBQztBQUUvRixPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBSS9COztHQUVHO0FBQ0gscUJBQWEsUUFBUTtJQVlqQjs7T0FFRztJQUNJLE1BQU0sRUFBRSxNQUFNO0lBZHZCOztPQUVHO0lBQ0gsT0FBYyxJQUFJLFNBQU07SUFFeEI7O09BRUc7SUFDSCxPQUFjLElBQUksV0FBNkM7SUFFL0Q7SUFDRTs7T0FFRztJQUNJLE1BQU0sRUFBRSxNQUFNLEVBS3RCO0lBRUQ7OztPQUdHO0lBQ0ksUUFBUSw0QkFFZDtJQUVEOzs7O09BSUc7SUFDSCxPQUFjLFVBQVUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksWUFHckQ7SUFFRDs7OztPQUlHO0lBQ0ksTUFBTSxDQUFDLElBQUksRUFBRSxRQUFRLEdBQUcsT0FBTyxDQUVyQztJQUVEOzs7T0FHRztJQUNJLE1BQU0sSUFBSSxPQUFPLENBRXZCO0lBRUQ7OztPQUdHO0lBQ0ksUUFBUSxrQkFFZDtJQUVELENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxXQUVmO0lBRUQsTUFBTSxrQkFFTDtJQUVEOzs7T0FHRztJQUNJLFFBQVEsV0FFZDtJQUVEOztPQUVHO0lBQ0gsT0FBYyxVQUFVLENBQUMsSUFBSSxFQUFFLE1BQU0sWUFFcEM7SUFFRCxPQUFjLFNBQVMsQ0FBQyxJQUFJLEVBQUUsRUFBRSxZQUUvQjtJQUVEOztPQUVHO0lBQ0gsT0FBYyxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxRQUFRLENBUTlDO0lBRUQ7Ozs7T0FJRztJQUNILE9BQWMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsUUFBUSxDQUU5QztJQUVEOzs7T0FHRztJQUNILE9BQWMsTUFBTSxJQUFJLFFBQVEsQ0FFL0I7Q0FDRiJ9
82
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyMTYuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9idWZmZXIvYnVmZmVyMTYudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDekQsT0FBTyxFQUFFLFlBQVksRUFBc0MsTUFBTSw2QkFBNkIsQ0FBQztBQUUvRixPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBSS9COztHQUVHO0FBQ0gscUJBQWEsUUFBUTtJQWVqQjs7T0FFRztJQUNJLE1BQU0sRUFBRSxNQUFNO0lBakJ2QixtQ0FBbUM7SUFDbkMsaUJBQXlCLFNBQVMsQ0FBYTtJQUUvQzs7T0FFRztJQUNILE9BQWMsSUFBSSxTQUFNO0lBRXhCOztPQUVHO0lBQ0gsT0FBYyxJQUFJLFdBQTZDO0lBRS9EO0lBQ0U7O09BRUc7SUFDSSxNQUFNLEVBQUUsTUFBTSxFQUt0QjtJQUVEOzs7T0FHRztJQUNJLFFBQVEsNEJBRWQ7SUFFRDs7OztPQUlHO0lBQ0gsT0FBYyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLFlBR3JEO0lBRUQ7Ozs7T0FJRztJQUNJLE1BQU0sQ0FBQyxJQUFJLEVBQUUsUUFBUSxHQUFHLE9BQU8sQ0FFckM7SUFFRDs7O09BR0c7SUFDSSxNQUFNLElBQUksT0FBTyxDQUV2QjtJQUVEOzs7T0FHRztJQUNJLFFBQVEsa0JBRWQ7SUFFRCxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsV0FFZjtJQUVELE1BQU0sa0JBRUw7SUFFRDs7O09BR0c7SUFDSSxRQUFRLFdBRWQ7SUFFRDs7T0FFRztJQUNILE9BQWMsVUFBVSxDQUFDLElBQUksRUFBRSxNQUFNLFlBRXBDO0lBRUQsT0FBYyxTQUFTLENBQUMsSUFBSSxFQUFFLEVBQUUsWUFFL0I7SUFFRDs7T0FFRztJQUNILE9BQWMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsUUFBUSxDQVE5QztJQUVEOzs7O09BSUc7SUFDSCxPQUFjLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLFFBQVEsQ0FFOUM7SUFFRDs7O09BR0c7SUFDSCxPQUFjLE1BQU0sSUFBSSxRQUFRLENBRS9CO0NBQ0YifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"buffer16.d.ts","sourceRoot":"","sources":["../../src/buffer/buffer16.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAsC,MAAM,6BAA6B,CAAC;AAE/F,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI/B;;GAEG;AACH,qBAAa,QAAQ;IAYjB;;OAEG;IACI,MAAM,EAAE,MAAM;IAdvB;;OAEG;IACH,OAAc,IAAI,SAAM;IAExB;;OAEG;IACH,OAAc,IAAI,WAA6C;IAE/D;IACE;;OAEG;IACI,MAAM,EAAE,MAAM,EAKtB;IAED;;;OAGG;IACI,QAAQ,4BAEd;IAED;;;;OAIG;IACH,OAAc,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,YAGrD;IAED;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErC;IAED;;;OAGG;IACI,MAAM,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACI,QAAQ,kBAEd;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,WAEf;IAED,MAAM,kBAEL;IAED;;;OAGG;IACI,QAAQ,WAEd;IAED;;OAEG;IACH,OAAc,UAAU,CAAC,IAAI,EAAE,MAAM,YAEpC;IAED,OAAc,SAAS,CAAC,IAAI,EAAE,EAAE,YAE/B;IAED;;OAEG;IACH,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAQ9C;IAED;;;;OAIG;IACH,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAE9C;IAED;;;OAGG;IACH,OAAc,MAAM,IAAI,QAAQ,CAE/B;CACF"}
1
+ {"version":3,"file":"buffer16.d.ts","sourceRoot":"","sources":["../../src/buffer/buffer16.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAsC,MAAM,6BAA6B,CAAC;AAE/F,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI/B;;GAEG;AACH,qBAAa,QAAQ;IAejB;;OAEG;IACI,MAAM,EAAE,MAAM;IAjBvB,mCAAmC;IACnC,iBAAyB,SAAS,CAAa;IAE/C;;OAEG;IACH,OAAc,IAAI,SAAM;IAExB;;OAEG;IACH,OAAc,IAAI,WAA6C;IAE/D;IACE;;OAEG;IACI,MAAM,EAAE,MAAM,EAKtB;IAED;;;OAGG;IACI,QAAQ,4BAEd;IAED;;;;OAIG;IACH,OAAc,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,YAGrD;IAED;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErC;IAED;;;OAGG;IACI,MAAM,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACI,QAAQ,kBAEd;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,WAEf;IAED,MAAM,kBAEL;IAED;;;OAGG;IACI,QAAQ,WAEd;IAED;;OAEG;IACH,OAAc,UAAU,CAAC,IAAI,EAAE,MAAM,YAEpC;IAED,OAAc,SAAS,CAAC,IAAI,EAAE,EAAE,YAE/B;IAED;;OAEG;IACH,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAQ9C;IAED;;;;OAIG;IACH,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAE9C;IAED;;;OAGG;IACH,OAAc,MAAM,IAAI,QAAQ,CAE/B;CACF"}
@@ -2,86 +2,53 @@ import type { Fr } from '@aztec/foundation/curves/bn254';
2
2
  import { BufferReader } from '@aztec/foundation/serialize';
3
3
  import { inspect } from 'util';
4
4
  /**
5
- * A class representing a 32 byte Buffer.
5
+ * Abstract unbranded base class for 32-byte buffers.
6
+ * Extend this instead of Buffer32 when defining a branded subtype
7
+ * to avoid inheriting Buffer32's `_branding`.
6
8
  */
7
- export declare class Buffer32 {
8
- /**
9
- * The buffer containing the hash.
10
- */
9
+ export declare abstract class BaseBuffer32 {
10
+ /** The buffer containing the data. */
11
11
  buffer: Buffer;
12
- /**
13
- * The size of the hash in bytes.
14
- */
12
+ /** The size of the buffer in bytes. */
15
13
  static SIZE: number;
16
- /**
17
- * Buffer32 with value zero.
18
- */
19
- static ZERO: Buffer32;
20
14
  constructor(
21
- /**
22
- * The buffer containing the hash.
23
- */
15
+ /** The buffer containing the data. */
24
16
  buffer: Buffer);
25
- /**
26
- * Returns the raw buffer of the hash.
27
- * @returns The buffer containing the hash.
28
- */
17
+ /** Returns the raw buffer. */
29
18
  toBuffer(): Buffer<ArrayBufferLike>;
30
- /**
31
- * Creates a Buffer32 from a buffer.
32
- * @param buffer - The buffer to create from.
33
- * @returns A new Buffer32 object.
34
- */
35
- static fromBuffer(buffer: Buffer | BufferReader): Buffer32;
36
- /**
37
- * Checks if this hash and another hash are equal.
38
- * @param hash - A hash to compare with.
39
- * @returns True if the hashes are equal, false otherwise.
40
- */
41
- equals(hash: Buffer32): boolean;
42
- /**
43
- * Returns true if this hash is zero.
44
- * @returns True if this hash is zero.
45
- */
19
+ /** Checks if this and another buffer are equal. */
20
+ equals(hash: BaseBuffer32): boolean;
21
+ /** Returns true if all bytes are zero. */
46
22
  isZero(): boolean;
47
- /**
48
- * Convert this hash to a hex string.
49
- * @returns The hex string.
50
- */
23
+ /** Convert to a hex string. */
51
24
  toString(): `0x${string}`;
52
25
  [inspect.custom](): string;
53
26
  toJSON(): `0x${string}`;
54
- /**
55
- * Convert this hash to a big int.
56
- * @returns The big int.
57
- */
27
+ /** Convert to a big int. */
58
28
  toBigInt(): bigint;
59
- /**
60
- * Creates a Buffer32 from a bigint.
61
- */
29
+ }
30
+ /** A branded 32-byte buffer. */
31
+ export declare class Buffer32 extends BaseBuffer32 {
32
+ /** Branding for nominal typing. */
33
+ private readonly _branding;
34
+ /** Buffer32 with value zero. */
35
+ static ZERO: Buffer32;
36
+ /** Creates a Buffer32 from a buffer. */
37
+ static fromBuffer(buffer: Buffer | BufferReader): Buffer32;
38
+ /** Creates a Buffer32 from a bigint. */
62
39
  static fromBigInt(hash: bigint): Buffer32;
63
40
  static fromField(hash: Fr): Buffer32;
64
41
  /**
65
- * Converts this hash from a buffer of 28 bytes.
66
- * Verifies the input is 28 bytes.
42
+ * Converts from a buffer of 28 bytes.
67
43
  * @param buffer - The 28 byte buffer to construct from.
68
44
  * @returns A Buffer32 created from the input buffer with 4 bytes 0 padding at the front.
69
45
  */
70
46
  static fromBuffer28(buffer: Buffer): Buffer32;
71
- /**
72
- * Converts a string into a Buffer32 object.
73
- */
47
+ /** Converts a string into a Buffer32 object. */
74
48
  static fromString(str: string): Buffer32;
75
- /**
76
- * Converts a number into a Buffer32 object.
77
- * @param num - The number to convert.
78
- * @returns A new Buffer32 object.
79
- */
49
+ /** Converts a number into a Buffer32 object. */
80
50
  static fromNumber(num: number): Buffer32;
81
- /**
82
- * Generates a random Buffer32.
83
- * @returns A new Buffer32 object.
84
- */
51
+ /** Generates a random Buffer32. */
85
52
  static random(): Buffer32;
86
53
  }
87
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyMzIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9idWZmZXIvYnVmZmVyMzIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDekQsT0FBTyxFQUFFLFlBQVksRUFBc0MsTUFBTSw2QkFBNkIsQ0FBQztBQUUvRixPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBSS9COztHQUVHO0FBQ0gscUJBQWEsUUFBUTtJQVlqQjs7T0FFRztJQUNJLE1BQU0sRUFBRSxNQUFNO0lBZHZCOztPQUVHO0lBQ0gsT0FBYyxJQUFJLFNBQU07SUFFeEI7O09BRUc7SUFDSCxPQUFjLElBQUksV0FBNkM7SUFFL0Q7SUFDRTs7T0FFRztJQUNJLE1BQU0sRUFBRSxNQUFNLEVBS3RCO0lBRUQ7OztPQUdHO0lBQ0ksUUFBUSw0QkFFZDtJQUVEOzs7O09BSUc7SUFDSCxPQUFjLFVBQVUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksWUFHckQ7SUFFRDs7OztPQUlHO0lBQ0ksTUFBTSxDQUFDLElBQUksRUFBRSxRQUFRLEdBQUcsT0FBTyxDQUVyQztJQUVEOzs7T0FHRztJQUNJLE1BQU0sSUFBSSxPQUFPLENBRXZCO0lBRUQ7OztPQUdHO0lBQ0ksUUFBUSxrQkFFZDtJQUVELENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxXQUVmO0lBRUQsTUFBTSxrQkFFTDtJQUVEOzs7T0FHRztJQUNJLFFBQVEsV0FFZDtJQUNEOztPQUVHO0lBQ0gsT0FBYyxVQUFVLENBQUMsSUFBSSxFQUFFLE1BQU0sWUFFcEM7SUFFRCxPQUFjLFNBQVMsQ0FBQyxJQUFJLEVBQUUsRUFBRSxZQUUvQjtJQUVEOzs7OztPQUtHO0lBQ0gsT0FBYyxZQUFZLENBQUMsTUFBTSxFQUFFLE1BQU0sWUFNeEM7SUFFRDs7T0FFRztJQUNILE9BQWMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsUUFBUSxDQVE5QztJQUVEOzs7O09BSUc7SUFDSCxPQUFjLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLFFBQVEsQ0FFOUM7SUFFRDs7O09BR0c7SUFDSCxPQUFjLE1BQU0sSUFBSSxRQUFRLENBRS9CO0NBQ0YifQ==
54
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVmZmVyMzIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9idWZmZXIvYnVmZmVyMzIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDekQsT0FBTyxFQUFFLFlBQVksRUFBc0MsTUFBTSw2QkFBNkIsQ0FBQztBQUUvRixPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBSS9COzs7O0dBSUc7QUFDSCw4QkFBc0IsWUFBWTtJQUs5QixzQ0FBc0M7SUFDL0IsTUFBTSxFQUFFLE1BQU07SUFMdkIsdUNBQXVDO0lBQ3ZDLE9BQWMsSUFBSSxTQUFNO0lBRXhCO0lBQ0Usc0NBQXNDO0lBQy9CLE1BQU0sRUFBRSxNQUFNLEVBS3RCO0lBRUQsOEJBQThCO0lBQ3ZCLFFBQVEsNEJBRWQ7SUFFRCxtREFBbUQ7SUFDNUMsTUFBTSxDQUFDLElBQUksRUFBRSxZQUFZLEdBQUcsT0FBTyxDQUV6QztJQUVELDBDQUEwQztJQUNuQyxNQUFNLElBQUksT0FBTyxDQUV2QjtJQUVELCtCQUErQjtJQUN4QixRQUFRLGtCQUVkO0lBRUQsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLFdBRWY7SUFFRCxNQUFNLGtCQUVMO0lBRUQsNEJBQTRCO0lBQ3JCLFFBQVEsV0FFZDtDQUNGO0FBRUQsZ0NBQWdDO0FBQ2hDLHFCQUFhLFFBQVMsU0FBUSxZQUFZO0lBQ3hDLG1DQUFtQztJQUNuQyxpQkFBeUIsU0FBUyxDQUFhO0lBRS9DLGdDQUFnQztJQUNoQyxPQUFjLElBQUksV0FBNkM7SUFFL0Qsd0NBQXdDO0lBQ3hDLE9BQWMsVUFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsWUFBWSxZQUdyRDtJQUVELHdDQUF3QztJQUN4QyxPQUFjLFVBQVUsQ0FBQyxJQUFJLEVBQUUsTUFBTSxZQUVwQztJQUVELE9BQWMsU0FBUyxDQUFDLElBQUksRUFBRSxFQUFFLFlBRS9CO0lBRUQ7Ozs7T0FJRztJQUNILE9BQWMsWUFBWSxDQUFDLE1BQU0sRUFBRSxNQUFNLFlBTXhDO0lBRUQsZ0RBQWdEO0lBQ2hELE9BQWMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsUUFBUSxDQVE5QztJQUVELGdEQUFnRDtJQUNoRCxPQUFjLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLFFBQVEsQ0FFOUM7SUFFRCxtQ0FBbUM7SUFDbkMsT0FBYyxNQUFNLElBQUksUUFBUSxDQUUvQjtDQUNGIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"buffer32.d.ts","sourceRoot":"","sources":["../../src/buffer/buffer32.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAsC,MAAM,6BAA6B,CAAC;AAE/F,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI/B;;GAEG;AACH,qBAAa,QAAQ;IAYjB;;OAEG;IACI,MAAM,EAAE,MAAM;IAdvB;;OAEG;IACH,OAAc,IAAI,SAAM;IAExB;;OAEG;IACH,OAAc,IAAI,WAA6C;IAE/D;IACE;;OAEG;IACI,MAAM,EAAE,MAAM,EAKtB;IAED;;;OAGG;IACI,QAAQ,4BAEd;IAED;;;;OAIG;IACH,OAAc,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,YAGrD;IAED;;;;OAIG;IACI,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErC;IAED;;;OAGG;IACI,MAAM,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACI,QAAQ,kBAEd;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,WAEf;IAED,MAAM,kBAEL;IAED;;;OAGG;IACI,QAAQ,WAEd;IACD;;OAEG;IACH,OAAc,UAAU,CAAC,IAAI,EAAE,MAAM,YAEpC;IAED,OAAc,SAAS,CAAC,IAAI,EAAE,EAAE,YAE/B;IAED;;;;;OAKG;IACH,OAAc,YAAY,CAAC,MAAM,EAAE,MAAM,YAMxC;IAED;;OAEG;IACH,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAQ9C;IAED;;;;OAIG;IACH,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAE9C;IAED;;;OAGG;IACH,OAAc,MAAM,IAAI,QAAQ,CAE/B;CACF"}
1
+ {"version":3,"file":"buffer32.d.ts","sourceRoot":"","sources":["../../src/buffer/buffer32.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAsC,MAAM,6BAA6B,CAAC;AAE/F,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAI/B;;;;GAIG;AACH,8BAAsB,YAAY;IAK9B,sCAAsC;IAC/B,MAAM,EAAE,MAAM;IALvB,uCAAuC;IACvC,OAAc,IAAI,SAAM;IAExB;IACE,sCAAsC;IAC/B,MAAM,EAAE,MAAM,EAKtB;IAED,8BAA8B;IACvB,QAAQ,4BAEd;IAED,mDAAmD;IAC5C,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAEzC;IAED,0CAA0C;IACnC,MAAM,IAAI,OAAO,CAEvB;IAED,+BAA+B;IACxB,QAAQ,kBAEd;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,WAEf;IAED,MAAM,kBAEL;IAED,4BAA4B;IACrB,QAAQ,WAEd;CACF;AAED,gCAAgC;AAChC,qBAAa,QAAS,SAAQ,YAAY;IACxC,mCAAmC;IACnC,iBAAyB,SAAS,CAAa;IAE/C,gCAAgC;IAChC,OAAc,IAAI,WAA6C;IAE/D,wCAAwC;IACxC,OAAc,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,YAGrD;IAED,wCAAwC;IACxC,OAAc,UAAU,CAAC,IAAI,EAAE,MAAM,YAEpC;IAED,OAAc,SAAS,CAAC,IAAI,EAAE,EAAE,YAE/B;IAED;;;;OAIG;IACH,OAAc,YAAY,CAAC,MAAM,EAAE,MAAM,YAMxC;IAED,gDAAgD;IAChD,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAQ9C;IAED,gDAAgD;IAChD,OAAc,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAE9C;IAED,mCAAmC;IACnC,OAAc,MAAM,IAAI,QAAQ,CAE/B;CACF"}
@@ -5,54 +5,28 @@ import { inspect } from 'util';
5
5
  import { bufferToHex } from '../string/index.js';
6
6
  _computedKey = inspect.custom;
7
7
  /**
8
- * A class representing a 32 byte Buffer.
9
- */ export class Buffer32 {
8
+ * Abstract unbranded base class for 32-byte buffers.
9
+ * Extend this instead of Buffer32 when defining a branded subtype
10
+ * to avoid inheriting Buffer32's `_branding`.
11
+ */ export class BaseBuffer32 {
10
12
  buffer;
11
- /**
12
- * The size of the hash in bytes.
13
- */ static SIZE = 32;
14
- /**
15
- * Buffer32 with value zero.
16
- */ static ZERO = new Buffer32(Buffer.alloc(Buffer32.SIZE));
17
- constructor(/**
18
- * The buffer containing the hash.
19
- */ buffer){
13
+ /** The size of the buffer in bytes. */ static SIZE = 32;
14
+ constructor(/** The buffer containing the data. */ buffer){
20
15
  this.buffer = buffer;
21
- if (buffer.length !== Buffer32.SIZE) {
22
- throw new Error(`Expected buffer to have length ${Buffer32.SIZE} but was ${buffer.length}`);
16
+ if (buffer.length !== BaseBuffer32.SIZE) {
17
+ throw new Error(`Expected buffer to have length ${BaseBuffer32.SIZE} but was ${buffer.length}`);
23
18
  }
24
19
  }
25
- /**
26
- * Returns the raw buffer of the hash.
27
- * @returns The buffer containing the hash.
28
- */ toBuffer() {
20
+ /** Returns the raw buffer. */ toBuffer() {
29
21
  return this.buffer;
30
22
  }
31
- /**
32
- * Creates a Buffer32 from a buffer.
33
- * @param buffer - The buffer to create from.
34
- * @returns A new Buffer32 object.
35
- */ static fromBuffer(buffer) {
36
- const reader = BufferReader.asReader(buffer);
37
- return new Buffer32(reader.readBytes(Buffer32.SIZE));
38
- }
39
- /**
40
- * Checks if this hash and another hash are equal.
41
- * @param hash - A hash to compare with.
42
- * @returns True if the hashes are equal, false otherwise.
43
- */ equals(hash) {
23
+ /** Checks if this and another buffer are equal. */ equals(hash) {
44
24
  return this.buffer.equals(hash.buffer);
45
25
  }
46
- /**
47
- * Returns true if this hash is zero.
48
- * @returns True if this hash is zero.
49
- */ isZero() {
26
+ /** Returns true if all bytes are zero. */ isZero() {
50
27
  return this.buffer.equals(Buffer.alloc(32, 0));
51
28
  }
52
- /**
53
- * Convert this hash to a hex string.
54
- * @returns The hex string.
55
- */ toString() {
29
+ /** Convert to a hex string. */ toString() {
56
30
  return bufferToHex(this.buffer);
57
31
  }
58
32
  [_computedKey]() {
@@ -61,23 +35,24 @@ _computedKey = inspect.custom;
61
35
  toJSON() {
62
36
  return this.toString();
63
37
  }
64
- /**
65
- * Convert this hash to a big int.
66
- * @returns The big int.
67
- */ toBigInt() {
68
- return deserializeBigInt(this.buffer, 0, Buffer32.SIZE).elem;
38
+ /** Convert to a big int. */ toBigInt() {
39
+ return deserializeBigInt(this.buffer, 0, BaseBuffer32.SIZE).elem;
69
40
  }
70
- /**
71
- * Creates a Buffer32 from a bigint.
72
- */ static fromBigInt(hash) {
41
+ }
42
+ /** A branded 32-byte buffer. */ export class Buffer32 extends BaseBuffer32 {
43
+ /** Buffer32 with value zero. */ static ZERO = new Buffer32(Buffer.alloc(Buffer32.SIZE));
44
+ /** Creates a Buffer32 from a buffer. */ static fromBuffer(buffer) {
45
+ const reader = BufferReader.asReader(buffer);
46
+ return new Buffer32(reader.readBytes(Buffer32.SIZE));
47
+ }
48
+ /** Creates a Buffer32 from a bigint. */ static fromBigInt(hash) {
73
49
  return new Buffer32(serializeBigInt(hash, Buffer32.SIZE));
74
50
  }
75
51
  static fromField(hash) {
76
52
  return new Buffer32(serializeBigInt(hash.toBigInt()));
77
53
  }
78
54
  /**
79
- * Converts this hash from a buffer of 28 bytes.
80
- * Verifies the input is 28 bytes.
55
+ * Converts from a buffer of 28 bytes.
81
56
  * @param buffer - The 28 byte buffer to construct from.
82
57
  * @returns A Buffer32 created from the input buffer with 4 bytes 0 padding at the front.
83
58
  */ static fromBuffer28(buffer) {
@@ -85,33 +60,24 @@ _computedKey = inspect.custom;
85
60
  throw new Error(`Expected Buffer32 input buffer to be 28 bytes`);
86
61
  }
87
62
  const padded = Buffer.concat([
88
- Buffer.alloc(this.SIZE - 28),
63
+ Buffer.alloc(Buffer32.SIZE - 28),
89
64
  buffer
90
65
  ]);
91
66
  return new Buffer32(padded);
92
67
  }
93
- /**
94
- * Converts a string into a Buffer32 object.
95
- */ static fromString(str) {
68
+ /** Converts a string into a Buffer32 object. */ static fromString(str) {
96
69
  if (str.startsWith('0x')) {
97
70
  str = str.slice(2);
98
71
  }
99
- if (str.length !== this.SIZE * 2) {
100
- throw new Error(`Expected string to be ${this.SIZE * 2} characters long, but was ${str.length}`);
72
+ if (str.length !== Buffer32.SIZE * 2) {
73
+ throw new Error(`Expected string to be ${Buffer32.SIZE * 2} characters long, but was ${str.length}`);
101
74
  }
102
75
  return new Buffer32(Buffer.from(str, 'hex'));
103
76
  }
104
- /**
105
- * Converts a number into a Buffer32 object.
106
- * @param num - The number to convert.
107
- * @returns A new Buffer32 object.
108
- */ static fromNumber(num) {
77
+ /** Converts a number into a Buffer32 object. */ static fromNumber(num) {
109
78
  return new Buffer32(serializeBigInt(BigInt(num), Buffer32.SIZE));
110
79
  }
111
- /**
112
- * Generates a random Buffer32.
113
- * @returns A new Buffer32 object.
114
- */ static random() {
80
+ /** Generates a random Buffer32. */ static random() {
115
81
  return new Buffer32(Buffer.from(randomBytes(Buffer32.SIZE)));
116
82
  }
117
83
  }