dexbot 1.6.11 → 1.6.12

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 (354) hide show
  1. package/CHANGELOG.md +35 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +2 -0
  4. package/analysis/tradingview/README.md +1 -1
  5. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  6. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  7. package/claw/modules/chain_broadcast.ts +7 -1
  8. package/claw/modules/claw_launcher.ts +1 -1
  9. package/claw/modules/launcher_mode_detector.ts +9 -2
  10. package/claw/package.json +1 -1
  11. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  12. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  13. package/dist/analysis/account_resolver.d.ts +1 -1
  14. package/dist/analysis/account_resolver.js +2 -1
  15. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  16. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
  17. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  18. package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
  19. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
  20. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
  21. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
  22. package/dist/analysis/analyze_args.d.ts +31 -0
  23. package/dist/analysis/analyze_args.js +41 -0
  24. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  25. package/dist/analysis/analyze_kalman.js +7 -17
  26. package/dist/analysis/analyze_regime.js +7 -17
  27. package/dist/analysis/analyze_regime_windows.js +8 -18
  28. package/dist/analysis/analyze_risk_profile.js +8 -18
  29. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  30. package/dist/analysis/analyze_volatility.js +7 -17
  31. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +220 -12
  32. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +6 -5
  33. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  34. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +11 -63
  35. package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
  36. package/dist/analysis/bot_fitting/shared_utils.js +2 -2
  37. package/dist/analysis/bot_key_utils.d.ts +18 -10
  38. package/dist/analysis/bot_key_utils.js +7 -4
  39. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  40. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  41. package/dist/analysis/chain_pool.d.ts +3 -1
  42. package/dist/analysis/chart_ui.d.ts +5 -2
  43. package/dist/analysis/chart_ui.js +6 -3
  44. package/dist/analysis/chart_utils.d.ts +5 -5
  45. package/dist/analysis/chart_utils.js +9 -0
  46. package/dist/analysis/fills_cache.d.ts +1 -1
  47. package/dist/analysis/fills_source.d.ts +2 -2
  48. package/dist/analysis/fills_source.js +14 -12
  49. package/dist/analysis/grid_correction_check.d.ts +1 -1
  50. package/dist/analysis/grid_correction_check.js +12 -11
  51. package/dist/analysis/math_utils.d.ts +7 -6
  52. package/dist/analysis/math_utils.js +5 -8
  53. package/dist/analysis/pnl_report.js +29 -29
  54. package/dist/analysis/price_sources.d.ts +8 -8
  55. package/dist/analysis/price_sources.js +5 -4
  56. package/dist/analysis/resolve_bot_accounts.js +2 -2
  57. package/dist/analysis/resolve_source.d.ts +1 -1
  58. package/dist/analysis/trade_profitability.d.ts +23 -2
  59. package/dist/analysis/trade_profitability.js +50 -50
  60. package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
  61. package/dist/analysis/tradingview/analyze_tradingview.js +6 -5
  62. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  63. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  64. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  65. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  66. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  67. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +18 -19
  68. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -1
  69. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +5 -5
  70. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  71. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +5 -4
  72. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  73. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  74. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  75. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  76. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  77. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  78. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  79. package/dist/credential-daemon.js +34 -20
  80. package/dist/dexbot.js +11 -11
  81. package/dist/market_adapter/candle_utils.d.ts +22 -18
  82. package/dist/market_adapter/candle_utils.js +24 -20
  83. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  84. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  85. package/dist/market_adapter/core/kibana_candles.d.ts +53 -18
  86. package/dist/market_adapter/core/kibana_candles.js +9 -7
  87. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  88. package/dist/market_adapter/core/kibana_client.js +8 -7
  89. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  90. package/dist/market_adapter/core/market_adapter_service.d.ts +284 -117
  91. package/dist/market_adapter/core/market_adapter_service.js +137 -113
  92. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  93. package/dist/market_adapter/core/strategies/ama.js +2 -4
  94. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  95. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  96. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  97. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  98. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  99. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  100. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  101. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  102. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  103. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  104. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  105. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  106. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  107. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  108. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  109. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  110. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  111. package/dist/market_adapter/inputs/fetch_book_data.js +3 -1
  112. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +96 -224
  113. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
  114. package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
  115. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  116. package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
  117. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  118. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  119. package/dist/market_adapter/inputs/window_cache.d.ts +99 -94
  120. package/dist/market_adapter/inputs/window_cache.js +8 -8
  121. package/dist/market_adapter/interval_utils.d.ts +4 -4
  122. package/dist/market_adapter/log_format.d.ts +6 -6
  123. package/dist/market_adapter/log_format.js +28 -21
  124. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  125. package/dist/market_adapter/lp_chart_core.js +26 -192
  126. package/dist/market_adapter/lp_chart_runner.d.ts +7 -7
  127. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  128. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  129. package/dist/market_adapter/market_adapter.d.ts +94 -32
  130. package/dist/market_adapter/market_adapter.js +67 -48
  131. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  132. package/dist/market_adapter/utils/adapter_client.js +2 -2
  133. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  134. package/dist/market_adapter/utils/chain.d.ts +50 -41
  135. package/dist/market_adapter/utils/chain.js +40 -46
  136. package/dist/market_adapter/utils/data_discovery.d.ts +4 -1
  137. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  138. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  139. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  140. package/dist/market_adapter/utils/file_lock.js +36 -32
  141. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  142. package/dist/market_adapter/utils/native_history.js +35 -28
  143. package/dist/modules/account_bots.d.ts +577 -21
  144. package/dist/modules/account_bots.js +182 -158
  145. package/dist/modules/account_orders.d.ts +66 -30
  146. package/dist/modules/account_orders.js +22 -20
  147. package/dist/modules/authority_resolver.d.ts +12 -2
  148. package/dist/modules/authority_resolver.js +15 -8
  149. package/dist/modules/bitshares-native/chain_client.d.ts +38 -3
  150. package/dist/modules/bitshares-native/chain_client.js +45 -46
  151. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  152. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  153. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  154. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  155. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  156. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  157. package/dist/modules/bitshares-native/index.d.ts +1 -1
  158. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  159. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  160. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  161. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  162. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  163. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  164. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  165. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  166. package/dist/modules/bitshares-native/serial/types.js +55 -62
  167. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  168. package/dist/modules/bitshares-native/signing_client.js +19 -14
  169. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  170. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  171. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  172. package/dist/modules/bitshares-native/transport.js +5 -4
  173. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  174. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  175. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  176. package/dist/modules/bitshares_client.d.ts +45 -13
  177. package/dist/modules/bitshares_client.js +28 -19
  178. package/dist/modules/bot_defaults.d.ts +6 -15
  179. package/dist/modules/bot_defaults.js +1 -5
  180. package/dist/modules/bot_settings.d.ts +44 -10
  181. package/dist/modules/bot_settings.js +11 -8
  182. package/dist/modules/bots_file_lock.d.ts +6 -6
  183. package/dist/modules/bots_file_lock.js +16 -12
  184. package/dist/modules/broadcast_failure.d.ts +2 -2
  185. package/dist/modules/broadcast_failure.js +5 -4
  186. package/dist/modules/chain_keys.d.ts +42 -40
  187. package/dist/modules/chain_keys.js +53 -45
  188. package/dist/modules/chain_orders.d.ts +93 -59
  189. package/dist/modules/chain_orders.js +31 -23
  190. package/dist/modules/constants.d.ts +527 -31
  191. package/dist/modules/constants.js +15 -47
  192. package/dist/modules/cr_planner.d.ts +40 -2
  193. package/dist/modules/credential_policy.d.ts +68 -8
  194. package/dist/modules/credential_policy.js +37 -31
  195. package/dist/modules/credential_session_cache.d.ts +2 -2
  196. package/dist/modules/credit_pricing.d.ts +42 -6
  197. package/dist/modules/credit_pricing.js +44 -30
  198. package/dist/modules/credit_runtime.d.ts +276 -118
  199. package/dist/modules/credit_runtime.js +462 -165
  200. package/dist/modules/crypto/browser_provider.js +6 -4
  201. package/dist/modules/crypto/node_provider.js +1 -1
  202. package/dist/modules/crypto/pure_scrypt.js +35 -4
  203. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  204. package/dist/modules/crypto/sync.d.ts +9 -9
  205. package/dist/modules/crypto/sync.js +16 -9
  206. package/dist/modules/dexbot_class.d.ts +195 -139
  207. package/dist/modules/dexbot_class.js +78 -28
  208. package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
  209. package/dist/modules/dexbot_cow_runtime.js +248 -206
  210. package/dist/modules/dexbot_credential_client.d.ts +19 -11
  211. package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
  212. package/dist/modules/dexbot_fill_runtime.js +48 -41
  213. package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
  214. package/dist/modules/dexbot_maintenance_runtime.js +108 -83
  215. package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
  216. package/dist/modules/dexbot_startup_runtime.js +43 -43
  217. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  218. package/dist/modules/dexbot_state_recovery.js +18 -13
  219. package/dist/modules/fund_registry.d.ts +4 -2
  220. package/dist/modules/fund_registry.js +10 -10
  221. package/dist/modules/general_settings.d.ts +30 -4
  222. package/dist/modules/graceful_shutdown.d.ts +3 -3
  223. package/dist/modules/graceful_shutdown.js +2 -2
  224. package/dist/modules/grid_price_source.d.ts +1 -1
  225. package/dist/modules/key_store.d.ts +14 -8
  226. package/dist/modules/key_store.js +7 -6
  227. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  228. package/dist/modules/launcher/adapter_requirement.js +5 -5
  229. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  230. package/dist/modules/launcher/bot_supervisor.js +12 -11
  231. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  232. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  233. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  234. package/dist/modules/launcher/credential_daemon.js +2 -2
  235. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  236. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  237. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  238. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  239. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  240. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  241. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  242. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  243. package/dist/modules/launcher/supervisor_control.js +4 -2
  244. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  245. package/dist/modules/market_adapter_whitelist.js +15 -3
  246. package/dist/modules/node_manager.d.ts +41 -11
  247. package/dist/modules/node_manager.js +5 -4
  248. package/dist/modules/order/accounting.d.ts +53 -24
  249. package/dist/modules/order/accounting.js +16 -15
  250. package/dist/modules/order/async_lock.d.ts +5 -2
  251. package/dist/modules/order/async_lock.js +1 -1
  252. package/dist/modules/order/export.d.ts +7 -6
  253. package/dist/modules/order/export.js +1 -7
  254. package/dist/modules/order/format.d.ts +4 -4
  255. package/dist/modules/order/genesis_policy.d.ts +21 -18
  256. package/dist/modules/order/genesis_policy.js +12 -8
  257. package/dist/modules/order/grid.d.ts +142 -36
  258. package/dist/modules/order/grid.js +148 -123
  259. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  260. package/dist/modules/order/grid_reconcile.js +13 -12
  261. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  262. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  263. package/dist/modules/order/index.d.ts +263 -1
  264. package/dist/modules/order/logger.d.ts +45 -11
  265. package/dist/modules/order/logger.js +38 -40
  266. package/dist/modules/order/logger_state.d.ts +4 -4
  267. package/dist/modules/order/manager.d.ts +225 -180
  268. package/dist/modules/order/manager.js +80 -83
  269. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  270. package/dist/modules/order/processed_fill_store.js +16 -27
  271. package/dist/modules/order/strategy.d.ts +21 -13
  272. package/dist/modules/order/strategy.js +5 -6
  273. package/dist/modules/order/sync_engine.d.ts +91 -33
  274. package/dist/modules/order/sync_engine.js +84 -53
  275. package/dist/modules/order/utils/math.d.ts +157 -102
  276. package/dist/modules/order/utils/math.js +77 -38
  277. package/dist/modules/order/utils/order.d.ts +310 -110
  278. package/dist/modules/order/utils/order.js +122 -99
  279. package/dist/modules/order/utils/slot.d.ts +1 -1
  280. package/dist/modules/order/utils/system.d.ts +176 -26
  281. package/dist/modules/order/utils/system.js +86 -69
  282. package/dist/modules/order/utils/validate.d.ts +89 -41
  283. package/dist/modules/order/utils/validate.js +24 -22
  284. package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
  285. package/dist/modules/order/utils/withPoolRef.js +18 -12
  286. package/dist/modules/order/working_grid.d.ts +14 -13
  287. package/dist/modules/paths.d.ts +1 -4
  288. package/dist/modules/paths.js +1 -27
  289. package/dist/modules/process_discovery.d.ts +1 -1
  290. package/dist/modules/process_discovery.js +2 -1
  291. package/dist/modules/runtime.d.ts +7 -3
  292. package/dist/modules/runtime.js +4 -3
  293. package/dist/modules/runtime_settings.d.ts +15 -10
  294. package/dist/modules/runtime_settings.js +30 -24
  295. package/dist/modules/settings_merge.d.ts +29 -3
  296. package/dist/modules/settings_merge.js +56 -78
  297. package/dist/modules/socket_json_client.d.ts +7 -4
  298. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  299. package/dist/modules/storage/browser_adapter.js +7 -30
  300. package/dist/modules/storage/index.d.ts +1 -1
  301. package/dist/modules/storage/node_adapter.d.ts +45 -27
  302. package/dist/modules/storage/node_adapter.js +9 -9
  303. package/dist/modules/storage/types.d.ts +5 -4
  304. package/dist/modules/types.d.ts +1071 -2
  305. package/dist/modules/types.js +4 -1
  306. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  307. package/dist/modules/utils/asset_symbols.js +2 -1
  308. package/dist/modules/utils/errors.d.ts +9 -0
  309. package/dist/modules/utils/errors.js +23 -1
  310. package/dist/modules/utils/time_range.d.ts +1 -12
  311. package/dist/modules/utils/time_range.js +1 -1
  312. package/dist/modules/validate_profiles.js +53 -43
  313. package/dist/modules/version_notice.d.ts +14 -3
  314. package/dist/modules/version_notice.js +6 -4
  315. package/dist/pm2.d.ts +29 -27
  316. package/dist/pm2.js +5 -5
  317. package/dist/scripts/analyze-credit.d.ts +2 -1
  318. package/dist/scripts/analyze-credit.js +23 -24
  319. package/dist/scripts/analyze-orders.d.ts +77 -9
  320. package/dist/scripts/analyze-orders.js +65 -40
  321. package/dist/scripts/chart_command.d.ts +27 -18
  322. package/dist/scripts/chart_command.js +13 -11
  323. package/dist/scripts/check_any.d.ts +18 -0
  324. package/dist/scripts/check_any.js +126 -0
  325. package/dist/scripts/diagnose-pool-history.js +12 -7
  326. package/dist/scripts/print_grid.js +0 -1
  327. package/dist/scripts/run-tests.js +39 -7
  328. package/dist/scripts/runner.js +1 -1
  329. package/dist/scripts/test-credit-renewal.js +30 -21
  330. package/dist/scripts/update.d.ts +10 -5
  331. package/dist/scripts/update.js +168 -103
  332. package/dist/scripts/update_dist_freshness.js +1 -0
  333. package/dist/scripts/update_layout.d.ts +61 -0
  334. package/dist/scripts/update_layout.js +180 -0
  335. package/dist/scripts/validate_bots.js +2 -1
  336. package/dist/scripts/verify-browser-bundle.js +8 -0
  337. package/dist/unlock.d.ts +28 -3
  338. package/dist/unlock.js +63 -35
  339. package/docs/BITSHARES_ONBOARDING.md +2 -0
  340. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
  341. package/docs/COW_INVARIANTS.md +13 -6
  342. package/docs/DEXBOT_COMPARISON.md +8 -8
  343. package/docs/EVOLUTION.md +10 -9
  344. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  345. package/docs/GRID_RECALCULATION.md +4 -2
  346. package/docs/GRID_RECONCILE.md +14 -3
  347. package/docs/LIFECYCLE.md +11 -11
  348. package/docs/MPA_CREDIT_USAGE.md +22 -3
  349. package/docs/README.md +14 -3
  350. package/docs/architecture.md +12 -9
  351. package/docs/developer_guide.md +6 -6
  352. package/market_adapter/README.md +6 -1
  353. package/modules/README.md +4 -1
  354. package/package.json +4 -1
@@ -16,28 +16,9 @@
16
16
  import { getCrypto } from '../../crypto/index.js';
17
17
  import * as pureSecp from '../../crypto/pure_secp256k1.js';
18
18
  import { base58Encode as _base58Encode, base58Decode as _base58Decode, encodeAsync as base58CheckEncode, decodeAsync as base58CheckDecode } from '../../utils/base58check.js';
19
+ import * as core from './ecc_core.js';
19
20
  const secp256k1 = pureSecp.secp256k1;
20
- const pointFromPublicKey = pureSecp.pointFromPublicKey;
21
- const publicKeyFromPoint = pureSecp.publicKeyFromPoint;
22
- const ecPointMul = pureSecp.ecPointMul;
23
- const ecPointAdd = pureSecp.ecPointAdd;
24
- const ecPointDouble = pureSecp.ecPointDouble;
25
- const modPow = pureSecp.modPow;
26
- const modInverse = pureSecp.modInverse;
27
- const mod = pureSecp.mod;
28
- const bytesFromHex = pureSecp.bytesFromHex;
29
21
  const concatBytes = pureSecp.concatBytes;
30
- // ── Helpers ─────────────────────────────────────────────────────────
31
- function equalsBuf(a, b) {
32
- if (a.length !== b.length)
33
- return false;
34
- for (let i = 0; i < a.length; i++)
35
- if (a[i] !== b[i])
36
- return false;
37
- return true;
38
- }
39
- // ── Curve constants ─────────────────────────────────────────────────
40
- const SECP256K1_BASE_POINT = { x: secp256k1.Gx, y: secp256k1.Gy };
41
22
  // ── Hashing (async, via CryptoProvider) ─────────────────────────────
42
23
  async function sha256(data) {
43
24
  return getCrypto().sha256(data);
@@ -68,10 +49,7 @@ function bufferFromBigInt(bn, length = 32) {
68
49
  return pureSecp.bufferFromBigInt(bn, length);
69
50
  }
70
51
  function isValidPrivateKey(rawKey) {
71
- if (rawKey.length !== 32)
72
- return false;
73
- const keyInt = bigIntFromBuffer(rawKey);
74
- return keyInt > 0n && keyInt < secp256k1.n;
52
+ return core.isValidPrivateKeyBytes(rawKey);
75
53
  }
76
54
  async function generatePrivateKey() {
77
55
  let key;
@@ -121,35 +99,7 @@ async function deterministicK(digest, privateKey, counter = 0) {
121
99
  }
122
100
  // ── Recovery ────────────────────────────────────────────────────────
123
101
  function recoverPublicKey(digest, r, s, recoveryId) {
124
- const n = secp256k1.n;
125
- const rBig = bigIntFromBuffer(r);
126
- const sBig = bigIntFromBuffer(s);
127
- const e = bigIntFromBuffer(digest) % n;
128
- if (rBig < 1n || rBig >= n || sBig < 1n || sBig >= n)
129
- throw new Error('Invalid signature parameters');
130
- const isYOdd = recoveryId & 1;
131
- const recoveryGroup = recoveryId >> 1;
132
- const x = rBig + BigInt(recoveryGroup) * n;
133
- if (x >= secp256k1.p)
134
- throw new Error('Invalid recovery point');
135
- const alpha = (x * x * x + secp256k1.a * x + secp256k1.b) % secp256k1.p;
136
- let y = modPow(alpha, (secp256k1.p + 1n) / 4n, secp256k1.p);
137
- if ((y & 1n) !== BigInt(isYOdd))
138
- y = secp256k1.p - y;
139
- const R = { x, y };
140
- const rInv = modInverse(rBig, n);
141
- const eNeg = (n - (e % n)) % n;
142
- const sr = ecPointMul(R, sBig);
143
- const eGNeg = ecPointMul(SECP256K1_BASE_POINT, eNeg);
144
- if (!sr || !eGNeg)
145
- throw new Error('Failed to compute recovery terms');
146
- const sum = ecPointAdd(sr, eGNeg);
147
- if (!sum)
148
- throw new Error('Failed to recover public key point');
149
- const Q = ecPointMul(sum, rInv);
150
- if (!Q)
151
- throw new Error('Failed to recover public key');
152
- return publicKeyFromPoint(Q);
102
+ return core.recoverPublicKeyBytes(digest, r, s, recoveryId);
153
103
  }
154
104
  // ── Sign / Verify ───────────────────────────────────────────────────
155
105
  async function sign(digest, privateKey) {
@@ -157,94 +107,22 @@ async function sign(digest, privateKey) {
157
107
  throw new Error('Digest must be 32 bytes');
158
108
  if (privateKey.length !== 32)
159
109
  throw new Error('Private key must be 32 bytes');
160
- const d = bigIntFromBuffer(privateKey);
161
- const e = bigIntFromBuffer(digest) % secp256k1.n;
162
- const nHalf = secp256k1.n >> 1n;
163
110
  const pubKeyKnown = await privateKeyToPublicKey(privateKey, true);
164
111
  const MAX_SIGN_RETRIES = 256;
165
112
  let nonce = 0;
166
113
  while (nonce < MAX_SIGN_RETRIES) {
167
114
  const k = await deterministicK(digest, privateKey, nonce);
168
- if (k === 0n) {
169
- nonce++;
170
- continue;
171
- }
172
- const R = ecPointMul(SECP256K1_BASE_POINT, k);
173
- const rBig = R ? R.x % secp256k1.n : 0n;
174
- if (!R || rBig === 0n) {
175
- nonce++;
176
- continue;
177
- }
178
- let sBig = mod(modInverse(k, secp256k1.n) * (e + rBig * d), secp256k1.n);
179
- if (sBig === 0n) {
180
- nonce++;
181
- continue;
182
- }
183
- let recoveryId = (R.y & 1n) === 1n ? 1 : 0;
184
- if (R.x >= secp256k1.n)
185
- recoveryId |= 2;
186
- if (sBig > nHalf) {
187
- sBig = secp256k1.n - sBig;
188
- recoveryId ^= 1;
189
- }
190
- const rBuf = bufferFromBigInt(rBig, 32);
191
- const sBuf = bufferFromBigInt(sBig, 32);
192
- if (!(rBuf[0] < 0x80 && (rBuf[0] !== 0 || rBuf[1] >= 0x80))) {
193
- nonce++;
194
- continue;
195
- }
196
- if (!(sBuf[0] < 0x80 && (sBuf[0] !== 0 || sBuf[1] >= 0x80))) {
197
- nonce++;
198
- continue;
199
- }
200
- for (let i = 0; i < 4; i++) {
201
- try {
202
- const recovered = recoverPublicKey(digest, rBuf, sBuf, i);
203
- if (equalsBuf(recovered, pubKeyKnown)) {
204
- recoveryId = i;
205
- break;
206
- }
207
- }
208
- catch (_) { }
209
- }
210
- if (recoveryId < 0 || recoveryId > 3) {
211
- nonce++;
212
- continue;
213
- }
214
- const compactI = recoveryId + 27 + 4;
215
- return concatBytes(new Uint8Array([compactI]), rBuf, sBuf);
115
+ const signature = core.buildSignatureFromK(digest, privateKey, pubKeyKnown, k);
116
+ if (signature)
117
+ return signature;
118
+ nonce++;
216
119
  }
217
120
  throw new Error(`Failed to produce valid signature after ${MAX_SIGN_RETRIES} retries`);
218
121
  }
219
122
  async function verify(digest, signature, publicKey) {
220
123
  if (digest.length !== 32)
221
124
  throw new Error('Digest must be 32 bytes');
222
- let r;
223
- let s;
224
- if (signature.length === 65) {
225
- r = signature.slice(1, 33);
226
- s = signature.slice(33, 65);
227
- }
228
- else if (signature.length === 64) {
229
- r = signature.slice(0, 32);
230
- s = signature.slice(32, 64);
231
- }
232
- else
233
- throw new Error('Invalid signature length: ' + signature.length);
234
- const rBig = bigIntFromBuffer(r);
235
- const sBig = bigIntFromBuffer(s);
236
- if (rBig <= 0n || rBig >= secp256k1.n || sBig <= 0n || sBig >= secp256k1.n)
237
- return false;
238
- const pubBuf = typeof publicKey === 'string' ? bytesFromHex(publicKey) : publicKey;
239
- const Q = pointFromPublicKey(pubBuf);
240
- const e = bigIntFromBuffer(digest) % secp256k1.n;
241
- const w = modInverse(sBig, secp256k1.n);
242
- const u1 = mod(e * w, secp256k1.n);
243
- const u2 = mod(rBig * w, secp256k1.n);
244
- const point = ecPointAdd(ecPointMul(SECP256K1_BASE_POINT, u1), ecPointMul(Q, u2));
245
- if (!point)
246
- return false;
247
- return mod(point.x, secp256k1.n) === rBig;
125
+ return core.verifyBytes(digest, signature, publicKey);
248
126
  }
249
127
  // ── Base58 (wrappers around shared utils) ───────────────────────────
250
128
  function base58Encode(buf) {
@@ -262,52 +140,14 @@ async function wifEncode(privateKey, compressed = true) {
262
140
  return base58CheckEncode(payload);
263
141
  }
264
142
  async function wifDecode(wif) {
265
- const payload = await base58CheckDecode(wif);
266
- if (payload.length < 33)
267
- throw new Error('Invalid WIF: too short');
268
- if (payload[0] !== 0x80)
269
- throw new Error('Invalid WIF: wrong version byte');
270
- const compressed = payload.length === 34 && payload[33] === 0x01;
271
- const privateKey = payload.slice(1, 33);
272
- if (!isValidPrivateKey(privateKey))
273
- throw new Error('Invalid WIF: invalid private key');
274
- return { privateKey, compressed };
143
+ return core.wifDecodePayload(await base58CheckDecode(wif));
275
144
  }
276
145
  // ── DER encoding ────────────────────────────────────────────────────
277
146
  function buildPublicKeyDer(compressedPub) {
278
- let point;
279
- if (compressedPub.length === 64) {
280
- point = concatBytes(new Uint8Array([0x04]), compressedPub);
281
- }
282
- else if (compressedPub.length === 33) {
283
- const prefix = compressedPub[0];
284
- const x = bigIntFromBuffer(compressedPub.slice(1, 33));
285
- const x3 = x * x * x;
286
- const ySq = (x3 + secp256k1.b) % secp256k1.p;
287
- let y = modPow(ySq, (secp256k1.p + 1n) / 4n, secp256k1.p);
288
- if ((y & 1n) !== BigInt(prefix === 0x03))
289
- y = secp256k1.p - y;
290
- point = concatBytes(new Uint8Array([0x04]), bufferFromBigInt(x, 32), bufferFromBigInt(y, 32));
291
- }
292
- else if (compressedPub.length === 65) {
293
- point = compressedPub;
294
- }
295
- else {
296
- throw new Error('Unsupported public key length: ' + compressedPub.length);
297
- }
298
- const seqHeader = bytesFromHex('3056301006072a8648ce3d020106052b8104000a034200');
299
- return concatBytes(seqHeader, point);
147
+ return core.buildPublicKeyDer(compressedPub);
300
148
  }
301
149
  function buildSignatureDer(r, s) {
302
- const encodeInt = (buf) => {
303
- let data = buf;
304
- if (data[0] & 0x80)
305
- data = concatBytes(new Uint8Array([0x00]), data);
306
- return concatBytes(new Uint8Array([0x02, data.length]), data);
307
- };
308
- const rEnc = encodeInt(r);
309
- const sEnc = encodeInt(s);
310
- return concatBytes(new Uint8Array([0x30, rEnc.length + sEnc.length]), rEnc, sEnc);
150
+ return core.buildSignatureDer(r, s);
311
151
  }
312
152
  // ── Brain key ───────────────────────────────────────────────────────
313
153
  async function normalizeBrainKey(name, role, password) {
@@ -1,8 +1,8 @@
1
1
  'use strict';
2
2
  import { createHash, createHmac, randomBytes as cryptoRandomBytes, createECDH } from '../../crypto/sync.js';
3
3
  import { base58Encode as _base58Encode, base58Decode as _base58Decode, encode as base58CheckEncode, decode as _base58CheckDecode } from '../../utils/base58check.js';
4
- import { getErrorMessage } from '../../utils/errors.js';
5
- import { secp256k1, SECP256K1_BASE_POINT, bigIntFromBuffer, bufferFromBigInt, mod, modPow, modInverse, ecPointMul, ecPointAdd, pointFromPublicKey, publicKeyFromPoint as _publicKeyFromPoint, } from '../../crypto/pure_secp256k1.js';
4
+ import { secp256k1, bigIntFromBuffer, bufferFromBigInt, } from '../../crypto/pure_secp256k1.js';
5
+ import { isValidPrivateKeyBytes, recoverPublicKeyBytes, verifyBytes, buildSignatureFromK, buildPublicKeyDer as buildPublicKeyDerCore, buildSignatureDer as buildSignatureDerCore, wifDecodePayload, } from './ecc_core.js';
6
6
  function sha256(data) {
7
7
  return createHash('sha256').update(data).digest();
8
8
  }
@@ -34,8 +34,7 @@ function generatePrivateKey() {
34
34
  function isValidPrivateKey(rawKey) {
35
35
  if (!Buffer.isBuffer(rawKey) || rawKey.length !== 32)
36
36
  return false;
37
- const keyInt = BigInt('0x' + rawKey.toString('hex'));
38
- return keyInt > 0n && keyInt < secp256k1.n;
37
+ return isValidPrivateKeyBytes(rawKey);
39
38
  }
40
39
  function privateKeyToPublicKey(rawKey, compressed = true) {
41
40
  if (!Buffer.isBuffer(rawKey) || rawKey.length !== 32) {
@@ -51,9 +50,6 @@ function publicKeyFromBuffer(pubKeyBuffer) {
51
50
  }
52
51
  return pubKeyBuffer;
53
52
  }
54
- function publicKeyFromPoint(point) {
55
- return Buffer.from(_publicKeyFromPoint(point));
56
- }
57
53
  function deterministicK(digest, privateKey, counter = 0) {
58
54
  const x = bufferFromBigInt(bigIntFromBuffer(privateKey), 32);
59
55
  const h1 = bufferFromBigInt(bigIntFromBuffer(digest) % secp256k1.n, 32);
@@ -86,38 +82,7 @@ function deterministicK(digest, privateKey, counter = 0) {
86
82
  return 0n;
87
83
  }
88
84
  function recoverPublicKey(digest, r, s, recoveryId) {
89
- const n = secp256k1.n;
90
- const rBig = bigIntFromBuffer(r);
91
- const sBig = bigIntFromBuffer(s);
92
- const e = bigIntFromBuffer(digest) % n;
93
- if (rBig < 1n || rBig >= n || sBig < 1n || sBig >= n) {
94
- throw new Error('Invalid signature parameters');
95
- }
96
- const isYOdd = recoveryId & 1;
97
- const recoveryGroup = recoveryId >> 1;
98
- const x = rBig + BigInt(recoveryGroup) * n;
99
- if (x >= secp256k1.p) {
100
- throw new Error('Invalid recovery point');
101
- }
102
- const alpha = (x * x * x + secp256k1.a * x + secp256k1.b) % secp256k1.p;
103
- let y = modPow(alpha, (secp256k1.p + 1n) / 4n, secp256k1.p);
104
- if ((y & 1n) !== BigInt(isYOdd)) {
105
- y = secp256k1.p - y;
106
- }
107
- const R = { x, y };
108
- const rInv = modInverse(rBig, n);
109
- const eNeg = (n - (e % n)) % n;
110
- const sr = ecPointMul(R, sBig);
111
- const eGNeg = ecPointMul(SECP256K1_BASE_POINT, eNeg);
112
- const sum = ecPointAdd(sr, eGNeg);
113
- if (!sum) {
114
- throw new Error('Failed to recover public key point');
115
- }
116
- const Q = ecPointMul(sum, rInv);
117
- if (!Q) {
118
- throw new Error('Failed to recover public key');
119
- }
120
- return publicKeyFromPoint(Q);
85
+ return Buffer.from(recoverPublicKeyBytes(digest, r, s, recoveryId));
121
86
  }
122
87
  function sign(digest, privateKey) {
123
88
  if (!Buffer.isBuffer(digest) || digest.length !== 32) {
@@ -126,61 +91,15 @@ function sign(digest, privateKey) {
126
91
  if (!Buffer.isBuffer(privateKey) || privateKey.length !== 32) {
127
92
  throw new Error('Private key must be 32 bytes');
128
93
  }
129
- const d = bigIntFromBuffer(privateKey);
130
- const e = bigIntFromBuffer(digest) % secp256k1.n;
131
- const nHalf = secp256k1.n >> 1n;
132
94
  const pubKeyKnown = privateKeyToPublicKey(privateKey, true);
133
95
  const MAX_SIGN_RETRIES = 256;
134
96
  let nonce = 0;
135
97
  while (nonce < MAX_SIGN_RETRIES) {
136
98
  const k = deterministicK(digest, privateKey, nonce);
137
- const R = ecPointMul(SECP256K1_BASE_POINT, k);
138
- const rBig = R ? R.x % secp256k1.n : 0n;
139
- if (!R || rBig === 0n) {
140
- nonce++;
141
- continue;
142
- }
143
- let sBig = mod(modInverse(k, secp256k1.n) * (e + rBig * d), secp256k1.n);
144
- if (sBig === 0n) {
145
- nonce++;
146
- continue;
147
- }
148
- let recoveryId = (R.y & 1n) === 1n ? 1 : 0;
149
- if (R.x >= secp256k1.n) {
150
- recoveryId |= 2;
151
- }
152
- if (sBig > nHalf) {
153
- sBig = secp256k1.n - sBig;
154
- recoveryId ^= 1;
155
- }
156
- const rBuf = Buffer.from(bufferFromBigInt(rBig, 32));
157
- const sBuf = Buffer.from(bufferFromBigInt(sBig, 32));
158
- if (!(rBuf[0] < 0x80 && (rBuf[0] !== 0 || rBuf[1] >= 0x80))) {
159
- nonce++;
160
- continue;
161
- }
162
- if (!(sBuf[0] < 0x80 && (sBuf[0] !== 0 || sBuf[1] >= 0x80))) {
163
- nonce++;
164
- continue;
165
- }
166
- for (let i = 0; i < 4; i++) {
167
- try {
168
- const recovered = recoverPublicKey(digest, rBuf, sBuf, i);
169
- if (Buffer.isBuffer(recovered) && recovered.equals(pubKeyKnown)) {
170
- recoveryId = i;
171
- break;
172
- }
173
- }
174
- catch (err) {
175
- console.warn('[ecc]', 'recoverPublicKey failed:', getErrorMessage(err));
176
- }
177
- }
178
- if (recoveryId < 0 || recoveryId > 3) {
179
- nonce++;
180
- continue;
181
- }
182
- const compactI = recoveryId + 27 + 4;
183
- return Buffer.concat([Buffer.from([compactI]), rBuf, sBuf]);
99
+ const signature = buildSignatureFromK(digest, privateKey, pubKeyKnown, k);
100
+ if (signature)
101
+ return Buffer.from(signature);
102
+ nonce++;
184
103
  }
185
104
  throw new Error(`Failed to produce valid signature after ${MAX_SIGN_RETRIES} retries`);
186
105
  }
@@ -188,84 +107,13 @@ function verify(digest, signature, publicKey) {
188
107
  if (!Buffer.isBuffer(digest) || digest.length !== 32) {
189
108
  throw new Error('Digest must be 32 bytes');
190
109
  }
191
- let r;
192
- let s;
193
- if (signature.length === 65) {
194
- r = signature.slice(1, 33);
195
- s = signature.slice(33, 65);
196
- }
197
- else if (signature.length === 64) {
198
- r = signature.slice(0, 32);
199
- s = signature.slice(32, 64);
200
- }
201
- else {
202
- throw new Error('Invalid signature length: ' + signature.length);
203
- }
204
- const rBig = bigIntFromBuffer(r);
205
- const sBig = bigIntFromBuffer(s);
206
- if (rBig <= 0n || rBig >= secp256k1.n || sBig <= 0n || sBig >= secp256k1.n) {
207
- return false;
208
- }
209
- const pubBuf = Buffer.isBuffer(publicKey) ? publicKey : Buffer.from(publicKey, 'hex');
210
- const Q = pointFromPublicKey(pubBuf);
211
- const e = bigIntFromBuffer(digest) % secp256k1.n;
212
- const w = modInverse(sBig, secp256k1.n);
213
- const u1 = mod(e * w, secp256k1.n);
214
- const u2 = mod(rBig * w, secp256k1.n);
215
- const point = ecPointAdd(ecPointMul(SECP256K1_BASE_POINT, u1), ecPointMul(Q, u2));
216
- if (!point) {
217
- return false;
218
- }
219
- return mod(point.x, secp256k1.n) === rBig;
110
+ return verifyBytes(digest, signature, publicKey);
220
111
  }
221
112
  function buildPublicKeyDer(compressedPub) {
222
- let point;
223
- if (compressedPub.length === 64) {
224
- point = Buffer.concat([Buffer.from([0x04]), compressedPub]);
225
- }
226
- else if (compressedPub.length === 33) {
227
- const prefix = compressedPub[0];
228
- const x = bigIntFromBuffer(compressedPub.slice(1, 33));
229
- const x3 = x * x * x;
230
- const ySq = (x3 + secp256k1.b) % secp256k1.p;
231
- let y = modPow(ySq, (secp256k1.p + 1n) / 4n, secp256k1.p);
232
- const isOdd = (prefix === 0x03);
233
- if ((y & 1n) !== BigInt(isOdd)) {
234
- y = secp256k1.p - y;
235
- }
236
- point = Buffer.concat([
237
- Buffer.from([0x04]),
238
- bufferFromBigInt(x, 32),
239
- bufferFromBigInt(y, 32),
240
- ]);
241
- }
242
- else if (compressedPub.length === 65) {
243
- point = compressedPub;
244
- }
245
- else {
246
- throw new Error('Unsupported public key length: ' + compressedPub.length);
247
- }
248
- const seqHeader = Buffer.from('3056301006072a8648ce3d020106052b8104000a034200', 'hex');
249
- return Buffer.concat([seqHeader, point]);
113
+ return Buffer.from(buildPublicKeyDerCore(compressedPub));
250
114
  }
251
115
  function buildSignatureDer(r, s) {
252
- const encodeInt = (buf) => {
253
- let data = buf;
254
- if (data[0] & 0x80) {
255
- data = Buffer.concat([Buffer.from([0x00]), data]);
256
- }
257
- return Buffer.concat([
258
- Buffer.from([0x02, data.length]),
259
- data,
260
- ]);
261
- };
262
- const rEnc = encodeInt(r);
263
- const sEnc = encodeInt(s);
264
- return Buffer.concat([
265
- Buffer.from([0x30, rEnc.length + sEnc.length]),
266
- rEnc,
267
- sEnc,
268
- ]);
116
+ return Buffer.from(buildSignatureDerCore(r, s));
269
117
  }
270
118
  function wifEncode(privateKey, compressed = true) {
271
119
  if (!Buffer.isBuffer(privateKey) || privateKey.length !== 32) {
@@ -279,19 +127,8 @@ function wifEncode(privateKey, compressed = true) {
279
127
  return base58CheckEncode(payload);
280
128
  }
281
129
  function wifDecode(wif) {
282
- const payload = base58CheckDecode(wif);
283
- if (!payload || payload.length < 33) {
284
- throw new Error('Invalid WIF: too short');
285
- }
286
- if (payload[0] !== 0x80) {
287
- throw new Error('Invalid WIF: wrong version byte');
288
- }
289
- const compressed = payload.length === 34 && payload[33] === 0x01;
290
- const privateKey = payload.slice(1, 33);
291
- if (!isValidPrivateKey(privateKey)) {
292
- throw new Error('Invalid WIF: invalid private key');
293
- }
294
- return { privateKey, compressed };
130
+ const { privateKey, compressed } = wifDecodePayload(base58CheckDecode(wif));
131
+ return { privateKey: Buffer.from(privateKey), compressed };
295
132
  }
296
133
  function base58Encode(buf) {
297
134
  return _base58Encode(buf);
@@ -0,0 +1,33 @@
1
+ declare function equalsBytes(a: Uint8Array, b: Uint8Array): boolean;
2
+ declare function isValidPrivateKeyBytes(rawKey: Uint8Array): boolean;
3
+ /**
4
+ * Recover the compressed public key for a signature component (r, s) and a
5
+ * recovery id. Throws when the recovery parameters are not resolvable to a
6
+ * point on the curve.
7
+ */
8
+ declare function recoverPublicKeyBytes(digest: Uint8Array, r: Uint8Array, s: Uint8Array, recoveryId: number): Uint8Array;
9
+ /**
10
+ * ECDSA verify over raw bytes. `publicKey` may be a compressed/uncompressed
11
+ * public key or a hex string. Returns false (rather than throwing) for
12
+ * out-of-range signature components or an unresolvable point.
13
+ */
14
+ declare function verifyBytes(digest: Uint8Array, signature: Uint8Array, publicKey: Uint8Array | string): boolean;
15
+ /**
16
+ * Build a compact (65-byte, header = recoveryId + 31) signature from a
17
+ * deterministic nonce k. Returns null when the candidate is not a valid,
18
+ * low-S, recoverable signature (the caller then tries the next nonce).
19
+ * `pubKeyKnown` is used to select the recovery id.
20
+ */
21
+ declare function buildSignatureFromK(digest: Uint8Array, privateKey: Uint8Array, pubKeyKnown: Uint8Array, k: bigint): Uint8Array | null;
22
+ declare function buildPublicKeyDer(compressedPub: Uint8Array): Uint8Array;
23
+ declare function buildSignatureDer(r: Uint8Array, s: Uint8Array): Uint8Array;
24
+ /**
25
+ * Validate a decoded WIF payload and extract the private key bytes.
26
+ * Throws on malformed payloads so both wrappers report identical errors.
27
+ */
28
+ declare function wifDecodePayload(payload: Uint8Array): {
29
+ privateKey: Uint8Array;
30
+ compressed: boolean;
31
+ };
32
+ export { equalsBytes, isValidPrivateKeyBytes, recoverPublicKeyBytes, verifyBytes, buildSignatureFromK, buildPublicKeyDer, buildSignatureDer, wifDecodePayload, };
33
+ //# sourceMappingURL=ecc_core.d.ts.map