@humanode-hyperlane/rebalancer 0.0.0-stage → 27.2.2-humanode.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 (439) hide show
  1. package/LICENSE.md +193 -0
  2. package/README.md +297 -2
  3. package/dist/bridges/LiFiBridge.d.ts +93 -0
  4. package/dist/bridges/LiFiBridge.d.ts.map +1 -0
  5. package/dist/bridges/LiFiBridge.js +527 -0
  6. package/dist/bridges/LiFiBridge.js.map +1 -0
  7. package/dist/bridges/LiFiBridge.test.d.ts +2 -0
  8. package/dist/bridges/LiFiBridge.test.d.ts.map +1 -0
  9. package/dist/bridges/LiFiBridge.test.js +504 -0
  10. package/dist/bridges/LiFiBridge.test.js.map +1 -0
  11. package/dist/config/RebalancerConfig.d.ts +20 -0
  12. package/dist/config/RebalancerConfig.d.ts.map +1 -0
  13. package/dist/config/RebalancerConfig.js +35 -0
  14. package/dist/config/RebalancerConfig.js.map +1 -0
  15. package/dist/config/RebalancerConfig.test.d.ts +2 -0
  16. package/dist/config/RebalancerConfig.test.d.ts.map +1 -0
  17. package/dist/config/RebalancerConfig.test.js +798 -0
  18. package/dist/config/RebalancerConfig.test.js.map +1 -0
  19. package/dist/config/types.d.ts +3008 -0
  20. package/dist/config/types.d.ts.map +1 -0
  21. package/dist/config/types.js +451 -0
  22. package/dist/config/types.js.map +1 -0
  23. package/dist/core/InventoryRebalancer.d.ts +201 -0
  24. package/dist/core/InventoryRebalancer.d.ts.map +1 -0
  25. package/dist/core/InventoryRebalancer.js +994 -0
  26. package/dist/core/InventoryRebalancer.js.map +1 -0
  27. package/dist/core/InventoryRebalancer.test.d.ts +2 -0
  28. package/dist/core/InventoryRebalancer.test.d.ts.map +1 -0
  29. package/dist/core/InventoryRebalancer.test.js +1511 -0
  30. package/dist/core/InventoryRebalancer.test.js.map +1 -0
  31. package/dist/core/Rebalancer.d.ts +37 -0
  32. package/dist/core/Rebalancer.d.ts.map +1 -0
  33. package/dist/core/Rebalancer.js +433 -0
  34. package/dist/core/Rebalancer.js.map +1 -0
  35. package/dist/core/Rebalancer.test.d.ts +2 -0
  36. package/dist/core/Rebalancer.test.d.ts.map +1 -0
  37. package/dist/core/Rebalancer.test.js +424 -0
  38. package/dist/core/Rebalancer.test.js.map +1 -0
  39. package/dist/core/RebalancerOrchestrator.d.ts +56 -0
  40. package/dist/core/RebalancerOrchestrator.d.ts.map +1 -0
  41. package/dist/core/RebalancerOrchestrator.js +154 -0
  42. package/dist/core/RebalancerOrchestrator.js.map +1 -0
  43. package/dist/core/RebalancerOrchestrator.test.d.ts +2 -0
  44. package/dist/core/RebalancerOrchestrator.test.d.ts.map +1 -0
  45. package/dist/core/RebalancerOrchestrator.test.js +721 -0
  46. package/dist/core/RebalancerOrchestrator.test.js.map +1 -0
  47. package/dist/core/RebalancerService.d.ts +127 -0
  48. package/dist/core/RebalancerService.d.ts.map +1 -0
  49. package/dist/core/RebalancerService.js +270 -0
  50. package/dist/core/RebalancerService.js.map +1 -0
  51. package/dist/core/RebalancerService.test.d.ts +2 -0
  52. package/dist/core/RebalancerService.test.d.ts.map +1 -0
  53. package/dist/core/RebalancerService.test.js +777 -0
  54. package/dist/core/RebalancerService.test.js.map +1 -0
  55. package/dist/e2e/collateral-deficit.e2e-test.d.ts +2 -0
  56. package/dist/e2e/collateral-deficit.e2e-test.d.ts.map +1 -0
  57. package/dist/e2e/collateral-deficit.e2e-test.js +227 -0
  58. package/dist/e2e/collateral-deficit.e2e-test.js.map +1 -0
  59. package/dist/e2e/composite.e2e-test.d.ts +2 -0
  60. package/dist/e2e/composite.e2e-test.d.ts.map +1 -0
  61. package/dist/e2e/composite.e2e-test.js +666 -0
  62. package/dist/e2e/composite.e2e-test.js.map +1 -0
  63. package/dist/e2e/fixtures/routes.d.ts +89 -0
  64. package/dist/e2e/fixtures/routes.d.ts.map +1 -0
  65. package/dist/e2e/fixtures/routes.js +420 -0
  66. package/dist/e2e/fixtures/routes.js.map +1 -0
  67. package/dist/e2e/harness/BaseLocalDeploymentManager.d.ts +38 -0
  68. package/dist/e2e/harness/BaseLocalDeploymentManager.d.ts.map +1 -0
  69. package/dist/e2e/harness/BaseLocalDeploymentManager.js +144 -0
  70. package/dist/e2e/harness/BaseLocalDeploymentManager.js.map +1 -0
  71. package/dist/e2e/harness/BridgeSetup.d.ts +11 -0
  72. package/dist/e2e/harness/BridgeSetup.d.ts.map +1 -0
  73. package/dist/e2e/harness/BridgeSetup.js +50 -0
  74. package/dist/e2e/harness/BridgeSetup.js.map +1 -0
  75. package/dist/e2e/harness/Erc20InventoryLocalDeploymentManager.d.ts +13 -0
  76. package/dist/e2e/harness/Erc20InventoryLocalDeploymentManager.d.ts.map +1 -0
  77. package/dist/e2e/harness/Erc20InventoryLocalDeploymentManager.js +105 -0
  78. package/dist/e2e/harness/Erc20InventoryLocalDeploymentManager.js.map +1 -0
  79. package/dist/e2e/harness/Erc20LocalDeploymentManager.d.ts +11 -0
  80. package/dist/e2e/harness/Erc20LocalDeploymentManager.d.ts.map +1 -0
  81. package/dist/e2e/harness/Erc20LocalDeploymentManager.js +105 -0
  82. package/dist/e2e/harness/Erc20LocalDeploymentManager.js.map +1 -0
  83. package/dist/e2e/harness/ForkIndexer.d.ts +23 -0
  84. package/dist/e2e/harness/ForkIndexer.d.ts.map +1 -0
  85. package/dist/e2e/harness/ForkIndexer.js +127 -0
  86. package/dist/e2e/harness/ForkIndexer.js.map +1 -0
  87. package/dist/e2e/harness/ForkIndexer.test.d.ts +2 -0
  88. package/dist/e2e/harness/ForkIndexer.test.d.ts.map +1 -0
  89. package/dist/e2e/harness/ForkIndexer.test.js +257 -0
  90. package/dist/e2e/harness/ForkIndexer.test.js.map +1 -0
  91. package/dist/e2e/harness/MixedLocalDeploymentManager.d.ts +21 -0
  92. package/dist/e2e/harness/MixedLocalDeploymentManager.d.ts.map +1 -0
  93. package/dist/e2e/harness/MixedLocalDeploymentManager.js +115 -0
  94. package/dist/e2e/harness/MixedLocalDeploymentManager.js.map +1 -0
  95. package/dist/e2e/harness/MockExplorerClient.d.ts +23 -0
  96. package/dist/e2e/harness/MockExplorerClient.d.ts.map +1 -0
  97. package/dist/e2e/harness/MockExplorerClient.js +57 -0
  98. package/dist/e2e/harness/MockExplorerClient.js.map +1 -0
  99. package/dist/e2e/harness/MockExternalBridge.d.ts +32 -0
  100. package/dist/e2e/harness/MockExternalBridge.d.ts.map +1 -0
  101. package/dist/e2e/harness/MockExternalBridge.js +247 -0
  102. package/dist/e2e/harness/MockExternalBridge.js.map +1 -0
  103. package/dist/e2e/harness/NativeLocalDeploymentManager.d.ts +13 -0
  104. package/dist/e2e/harness/NativeLocalDeploymentManager.d.ts.map +1 -0
  105. package/dist/e2e/harness/NativeLocalDeploymentManager.js +91 -0
  106. package/dist/e2e/harness/NativeLocalDeploymentManager.js.map +1 -0
  107. package/dist/e2e/harness/SnapshotHelper.d.ts +13 -0
  108. package/dist/e2e/harness/SnapshotHelper.d.ts.map +1 -0
  109. package/dist/e2e/harness/SnapshotHelper.js +36 -0
  110. package/dist/e2e/harness/SnapshotHelper.js.map +1 -0
  111. package/dist/e2e/harness/TestHelpers.d.ts +25 -0
  112. package/dist/e2e/harness/TestHelpers.d.ts.map +1 -0
  113. package/dist/e2e/harness/TestHelpers.js +103 -0
  114. package/dist/e2e/harness/TestHelpers.js.map +1 -0
  115. package/dist/e2e/harness/TestRebalancer.d.ts +85 -0
  116. package/dist/e2e/harness/TestRebalancer.d.ts.map +1 -0
  117. package/dist/e2e/harness/TestRebalancer.js +427 -0
  118. package/dist/e2e/harness/TestRebalancer.js.map +1 -0
  119. package/dist/e2e/harness/TransferHelper.d.ts +34 -0
  120. package/dist/e2e/harness/TransferHelper.d.ts.map +1 -0
  121. package/dist/e2e/harness/TransferHelper.js +93 -0
  122. package/dist/e2e/harness/TransferHelper.js.map +1 -0
  123. package/dist/e2e/inventory-erc20-minAmount.e2e-test.d.ts +2 -0
  124. package/dist/e2e/inventory-erc20-minAmount.e2e-test.d.ts.map +1 -0
  125. package/dist/e2e/inventory-erc20-minAmount.e2e-test.js +411 -0
  126. package/dist/e2e/inventory-erc20-minAmount.e2e-test.js.map +1 -0
  127. package/dist/e2e/inventory-erc20-weighted.e2e-test.d.ts +2 -0
  128. package/dist/e2e/inventory-erc20-weighted.e2e-test.d.ts.map +1 -0
  129. package/dist/e2e/inventory-erc20-weighted.e2e-test.js +408 -0
  130. package/dist/e2e/inventory-erc20-weighted.e2e-test.js.map +1 -0
  131. package/dist/e2e/inventory-minAmount.e2e-test.d.ts +2 -0
  132. package/dist/e2e/inventory-minAmount.e2e-test.d.ts.map +1 -0
  133. package/dist/e2e/inventory-minAmount.e2e-test.js +411 -0
  134. package/dist/e2e/inventory-minAmount.e2e-test.js.map +1 -0
  135. package/dist/e2e/inventory-weighted.e2e-test.d.ts +2 -0
  136. package/dist/e2e/inventory-weighted.e2e-test.d.ts.map +1 -0
  137. package/dist/e2e/inventory-weighted.e2e-test.js +409 -0
  138. package/dist/e2e/inventory-weighted.e2e-test.js.map +1 -0
  139. package/dist/e2e/minAmount.e2e-test.d.ts +2 -0
  140. package/dist/e2e/minAmount.e2e-test.d.ts.map +1 -0
  141. package/dist/e2e/minAmount.e2e-test.js +203 -0
  142. package/dist/e2e/minAmount.e2e-test.js.map +1 -0
  143. package/dist/e2e/mixed-weighted.e2e-test.d.ts +2 -0
  144. package/dist/e2e/mixed-weighted.e2e-test.d.ts.map +1 -0
  145. package/dist/e2e/mixed-weighted.e2e-test.js +189 -0
  146. package/dist/e2e/mixed-weighted.e2e-test.js.map +1 -0
  147. package/dist/e2e/weighted.e2e-test.d.ts +2 -0
  148. package/dist/e2e/weighted.e2e-test.d.ts.map +1 -0
  149. package/dist/e2e/weighted.e2e-test.js +198 -0
  150. package/dist/e2e/weighted.e2e-test.js.map +1 -0
  151. package/dist/factories/RebalancerContextFactory.d.ts +89 -0
  152. package/dist/factories/RebalancerContextFactory.d.ts.map +1 -0
  153. package/dist/factories/RebalancerContextFactory.js +420 -0
  154. package/dist/factories/RebalancerContextFactory.js.map +1 -0
  155. package/dist/factories/RebalancerContextFactory.test.d.ts +2 -0
  156. package/dist/factories/RebalancerContextFactory.test.d.ts.map +1 -0
  157. package/dist/factories/RebalancerContextFactory.test.js +270 -0
  158. package/dist/factories/RebalancerContextFactory.test.js.map +1 -0
  159. package/dist/index.d.ts +37 -0
  160. package/dist/index.d.ts.map +1 -0
  161. package/dist/index.js +37 -0
  162. package/dist/index.js.map +1 -0
  163. package/dist/interfaces/IExternalBridge.d.ts +103 -0
  164. package/dist/interfaces/IExternalBridge.d.ts.map +1 -0
  165. package/dist/interfaces/IExternalBridge.js +2 -0
  166. package/dist/interfaces/IExternalBridge.js.map +1 -0
  167. package/dist/interfaces/IMetrics.d.ts +5 -0
  168. package/dist/interfaces/IMetrics.d.ts.map +1 -0
  169. package/dist/interfaces/IMetrics.js +2 -0
  170. package/dist/interfaces/IMetrics.js.map +1 -0
  171. package/dist/interfaces/IMonitor.d.ts +50 -0
  172. package/dist/interfaces/IMonitor.d.ts.map +1 -0
  173. package/dist/interfaces/IMonitor.js +14 -0
  174. package/dist/interfaces/IMonitor.js.map +1 -0
  175. package/dist/interfaces/IRebalancer.d.ts +31 -0
  176. package/dist/interfaces/IRebalancer.d.ts.map +1 -0
  177. package/dist/interfaces/IRebalancer.js +2 -0
  178. package/dist/interfaces/IRebalancer.js.map +1 -0
  179. package/dist/interfaces/IStrategy.d.ts +60 -0
  180. package/dist/interfaces/IStrategy.d.ts.map +1 -0
  181. package/dist/interfaces/IStrategy.js +13 -0
  182. package/dist/interfaces/IStrategy.js.map +1 -0
  183. package/dist/metrics/Metrics.d.ts +25 -0
  184. package/dist/metrics/Metrics.d.ts.map +1 -0
  185. package/dist/metrics/Metrics.js +164 -0
  186. package/dist/metrics/Metrics.js.map +1 -0
  187. package/dist/metrics/PriceGetter.d.ts +10 -0
  188. package/dist/metrics/PriceGetter.d.ts.map +1 -0
  189. package/dist/metrics/PriceGetter.js +41 -0
  190. package/dist/metrics/PriceGetter.js.map +1 -0
  191. package/dist/metrics/scripts/metrics.d.ts +28 -0
  192. package/dist/metrics/scripts/metrics.d.ts.map +1 -0
  193. package/dist/metrics/scripts/metrics.js +61 -0
  194. package/dist/metrics/scripts/metrics.js.map +1 -0
  195. package/dist/monitor/Monitor.d.ts +40 -0
  196. package/dist/monitor/Monitor.d.ts.map +1 -0
  197. package/dist/monitor/Monitor.js +211 -0
  198. package/dist/monitor/Monitor.js.map +1 -0
  199. package/dist/service.d.ts +3 -0
  200. package/dist/service.d.ts.map +1 -0
  201. package/dist/service.js +205 -0
  202. package/dist/service.js.map +1 -0
  203. package/dist/strategy/BaseStrategy.d.ts +86 -0
  204. package/dist/strategy/BaseStrategy.d.ts.map +1 -0
  205. package/dist/strategy/BaseStrategy.js +342 -0
  206. package/dist/strategy/BaseStrategy.js.map +1 -0
  207. package/dist/strategy/CollateralDeficitStrategy.d.ts +65 -0
  208. package/dist/strategy/CollateralDeficitStrategy.d.ts.map +1 -0
  209. package/dist/strategy/CollateralDeficitStrategy.js +253 -0
  210. package/dist/strategy/CollateralDeficitStrategy.js.map +1 -0
  211. package/dist/strategy/CollateralDeficitStrategy.test.d.ts +2 -0
  212. package/dist/strategy/CollateralDeficitStrategy.test.d.ts.map +1 -0
  213. package/dist/strategy/CollateralDeficitStrategy.test.js +497 -0
  214. package/dist/strategy/CollateralDeficitStrategy.test.js.map +1 -0
  215. package/dist/strategy/CompositeStrategy.d.ts +18 -0
  216. package/dist/strategy/CompositeStrategy.d.ts.map +1 -0
  217. package/dist/strategy/CompositeStrategy.js +63 -0
  218. package/dist/strategy/CompositeStrategy.js.map +1 -0
  219. package/dist/strategy/CompositeStrategy.test.d.ts +2 -0
  220. package/dist/strategy/CompositeStrategy.test.d.ts.map +1 -0
  221. package/dist/strategy/CompositeStrategy.test.js +278 -0
  222. package/dist/strategy/CompositeStrategy.test.js.map +1 -0
  223. package/dist/strategy/MinAmountStrategy.d.ts +35 -0
  224. package/dist/strategy/MinAmountStrategy.d.ts.map +1 -0
  225. package/dist/strategy/MinAmountStrategy.js +112 -0
  226. package/dist/strategy/MinAmountStrategy.js.map +1 -0
  227. package/dist/strategy/MinAmountStrategy.test.d.ts +2 -0
  228. package/dist/strategy/MinAmountStrategy.test.d.ts.map +1 -0
  229. package/dist/strategy/MinAmountStrategy.test.js +547 -0
  230. package/dist/strategy/MinAmountStrategy.test.js.map +1 -0
  231. package/dist/strategy/StrategyFactory.d.ts +27 -0
  232. package/dist/strategy/StrategyFactory.d.ts.map +1 -0
  233. package/dist/strategy/StrategyFactory.js +79 -0
  234. package/dist/strategy/StrategyFactory.js.map +1 -0
  235. package/dist/strategy/StrategyFactory.test.d.ts +2 -0
  236. package/dist/strategy/StrategyFactory.test.d.ts.map +1 -0
  237. package/dist/strategy/StrategyFactory.test.js +81 -0
  238. package/dist/strategy/StrategyFactory.test.js.map +1 -0
  239. package/dist/strategy/WeightedStrategy.d.ts +32 -0
  240. package/dist/strategy/WeightedStrategy.d.ts.map +1 -0
  241. package/dist/strategy/WeightedStrategy.js +73 -0
  242. package/dist/strategy/WeightedStrategy.js.map +1 -0
  243. package/dist/strategy/WeightedStrategy.test.d.ts +2 -0
  244. package/dist/strategy/WeightedStrategy.test.d.ts.map +1 -0
  245. package/dist/strategy/WeightedStrategy.test.js +403 -0
  246. package/dist/strategy/WeightedStrategy.test.js.map +1 -0
  247. package/dist/strategy/index.d.ts +7 -0
  248. package/dist/strategy/index.d.ts.map +1 -0
  249. package/dist/strategy/index.js +7 -0
  250. package/dist/strategy/index.js.map +1 -0
  251. package/dist/test/helpers.d.ts +99 -0
  252. package/dist/test/helpers.d.ts.map +1 -0
  253. package/dist/test/helpers.js +311 -0
  254. package/dist/test/helpers.js.map +1 -0
  255. package/dist/test/lifiMocks.d.ts +52 -0
  256. package/dist/test/lifiMocks.d.ts.map +1 -0
  257. package/dist/test/lifiMocks.js +160 -0
  258. package/dist/test/lifiMocks.js.map +1 -0
  259. package/dist/tracking/ActionTracker.d.ts +90 -0
  260. package/dist/tracking/ActionTracker.d.ts.map +1 -0
  261. package/dist/tracking/ActionTracker.js +678 -0
  262. package/dist/tracking/ActionTracker.js.map +1 -0
  263. package/dist/tracking/ActionTracker.test.d.ts +2 -0
  264. package/dist/tracking/ActionTracker.test.d.ts.map +1 -0
  265. package/dist/tracking/ActionTracker.test.js +1351 -0
  266. package/dist/tracking/ActionTracker.test.js.map +1 -0
  267. package/dist/tracking/IActionTracker.d.ts +157 -0
  268. package/dist/tracking/IActionTracker.d.ts.map +1 -0
  269. package/dist/tracking/IActionTracker.js +2 -0
  270. package/dist/tracking/IActionTracker.js.map +1 -0
  271. package/dist/tracking/InflightContextAdapter.d.ts +18 -0
  272. package/dist/tracking/InflightContextAdapter.d.ts.map +1 -0
  273. package/dist/tracking/InflightContextAdapter.js +52 -0
  274. package/dist/tracking/InflightContextAdapter.js.map +1 -0
  275. package/dist/tracking/InflightContextAdapter.test.d.ts +2 -0
  276. package/dist/tracking/InflightContextAdapter.test.d.ts.map +1 -0
  277. package/dist/tracking/InflightContextAdapter.test.js +175 -0
  278. package/dist/tracking/InflightContextAdapter.test.js.map +1 -0
  279. package/dist/tracking/store/IStore.d.ts +41 -0
  280. package/dist/tracking/store/IStore.d.ts.map +1 -0
  281. package/dist/tracking/store/IStore.js +2 -0
  282. package/dist/tracking/store/IStore.js.map +1 -0
  283. package/dist/tracking/store/InMemoryStore.d.ts +21 -0
  284. package/dist/tracking/store/InMemoryStore.d.ts.map +1 -0
  285. package/dist/tracking/store/InMemoryStore.js +40 -0
  286. package/dist/tracking/store/InMemoryStore.js.map +1 -0
  287. package/dist/tracking/store/InMemoryStore.test.d.ts +2 -0
  288. package/dist/tracking/store/InMemoryStore.test.d.ts.map +1 -0
  289. package/dist/tracking/store/InMemoryStore.test.js +290 -0
  290. package/dist/tracking/store/InMemoryStore.test.js.map +1 -0
  291. package/dist/tracking/store/index.d.ts +3 -0
  292. package/dist/tracking/store/index.d.ts.map +1 -0
  293. package/dist/tracking/store/index.js +2 -0
  294. package/dist/tracking/store/index.js.map +1 -0
  295. package/dist/tracking/types.d.ts +77 -0
  296. package/dist/tracking/types.d.ts.map +1 -0
  297. package/dist/tracking/types.js +2 -0
  298. package/dist/tracking/types.js.map +1 -0
  299. package/dist/utils/ExplorerClient.d.ts +68 -0
  300. package/dist/utils/ExplorerClient.d.ts.map +1 -0
  301. package/dist/utils/ExplorerClient.js +324 -0
  302. package/dist/utils/ExplorerClient.js.map +1 -0
  303. package/dist/utils/ExplorerClient.test.d.ts +2 -0
  304. package/dist/utils/ExplorerClient.test.d.ts.map +1 -0
  305. package/dist/utils/ExplorerClient.test.js +261 -0
  306. package/dist/utils/ExplorerClient.test.js.map +1 -0
  307. package/dist/utils/balanceUtils.d.ts +12 -0
  308. package/dist/utils/balanceUtils.d.ts.map +1 -0
  309. package/dist/utils/balanceUtils.js +40 -0
  310. package/dist/utils/balanceUtils.js.map +1 -0
  311. package/dist/utils/balanceUtils.test.d.ts +2 -0
  312. package/dist/utils/balanceUtils.test.d.ts.map +1 -0
  313. package/dist/utils/balanceUtils.test.js +55 -0
  314. package/dist/utils/balanceUtils.test.js.map +1 -0
  315. package/dist/utils/blockTag.d.ts +14 -0
  316. package/dist/utils/blockTag.d.ts.map +1 -0
  317. package/dist/utils/blockTag.js +46 -0
  318. package/dist/utils/blockTag.js.map +1 -0
  319. package/dist/utils/bridgeUtils.d.ts +40 -0
  320. package/dist/utils/bridgeUtils.d.ts.map +1 -0
  321. package/dist/utils/bridgeUtils.js +54 -0
  322. package/dist/utils/bridgeUtils.js.map +1 -0
  323. package/dist/utils/bridgeUtils.test.d.ts +2 -0
  324. package/dist/utils/bridgeUtils.test.d.ts.map +1 -0
  325. package/dist/utils/bridgeUtils.test.js +163 -0
  326. package/dist/utils/bridgeUtils.test.js.map +1 -0
  327. package/dist/utils/errors.d.ts +4 -0
  328. package/dist/utils/errors.d.ts.map +1 -0
  329. package/dist/utils/errors.js +6 -0
  330. package/dist/utils/errors.js.map +1 -0
  331. package/dist/utils/gasEstimation.d.ts +65 -0
  332. package/dist/utils/gasEstimation.d.ts.map +1 -0
  333. package/dist/utils/gasEstimation.js +206 -0
  334. package/dist/utils/gasEstimation.js.map +1 -0
  335. package/dist/utils/solanaKeyParser.d.ts +10 -0
  336. package/dist/utils/solanaKeyParser.d.ts.map +1 -0
  337. package/dist/utils/solanaKeyParser.js +87 -0
  338. package/dist/utils/solanaKeyParser.js.map +1 -0
  339. package/dist/utils/solanaKeyParser.test.d.ts +2 -0
  340. package/dist/utils/solanaKeyParser.test.d.ts.map +1 -0
  341. package/dist/utils/solanaKeyParser.test.js +71 -0
  342. package/dist/utils/solanaKeyParser.test.js.map +1 -0
  343. package/dist/utils/tokenUtils.d.ts +38 -0
  344. package/dist/utils/tokenUtils.d.ts.map +1 -0
  345. package/dist/utils/tokenUtils.js +65 -0
  346. package/dist/utils/tokenUtils.js.map +1 -0
  347. package/dist/utils/transactionUtils.d.ts +22 -0
  348. package/dist/utils/transactionUtils.d.ts.map +1 -0
  349. package/dist/utils/transactionUtils.js +26 -0
  350. package/dist/utils/transactionUtils.js.map +1 -0
  351. package/package.json +87 -3
  352. package/src/bridges/LiFiBridge.test.ts +615 -0
  353. package/src/bridges/LiFiBridge.ts +731 -0
  354. package/src/config/RebalancerConfig.test.ts +921 -0
  355. package/src/config/RebalancerConfig.ts +63 -0
  356. package/src/config/types.ts +613 -0
  357. package/src/core/InventoryRebalancer.test.ts +1858 -0
  358. package/src/core/InventoryRebalancer.ts +1455 -0
  359. package/src/core/Rebalancer.test.ts +686 -0
  360. package/src/core/Rebalancer.ts +686 -0
  361. package/src/core/RebalancerOrchestrator.test.ts +871 -0
  362. package/src/core/RebalancerOrchestrator.ts +273 -0
  363. package/src/core/RebalancerService.test.ts +1094 -0
  364. package/src/core/RebalancerService.ts +412 -0
  365. package/src/e2e/E2E_TEST_CONVENTIONS.md +222 -0
  366. package/src/e2e/collateral-deficit.e2e-test.ts +403 -0
  367. package/src/e2e/composite.e2e-test.ts +1008 -0
  368. package/src/e2e/fixtures/routes.ts +532 -0
  369. package/src/e2e/harness/BaseLocalDeploymentManager.ts +246 -0
  370. package/src/e2e/harness/BridgeSetup.ts +95 -0
  371. package/src/e2e/harness/Erc20InventoryLocalDeploymentManager.ts +183 -0
  372. package/src/e2e/harness/Erc20LocalDeploymentManager.ts +190 -0
  373. package/src/e2e/harness/ForkIndexer.test.ts +448 -0
  374. package/src/e2e/harness/ForkIndexer.ts +183 -0
  375. package/src/e2e/harness/MixedLocalDeploymentManager.ts +196 -0
  376. package/src/e2e/harness/MockExplorerClient.ts +94 -0
  377. package/src/e2e/harness/MockExternalBridge.ts +411 -0
  378. package/src/e2e/harness/NativeLocalDeploymentManager.ts +138 -0
  379. package/src/e2e/harness/SnapshotHelper.ts +56 -0
  380. package/src/e2e/harness/TestHelpers.ts +169 -0
  381. package/src/e2e/harness/TestRebalancer.ts +758 -0
  382. package/src/e2e/harness/TransferHelper.ts +188 -0
  383. package/src/e2e/inventory-erc20-minAmount.e2e-test.ts +735 -0
  384. package/src/e2e/inventory-erc20-weighted.e2e-test.ts +733 -0
  385. package/src/e2e/inventory-minAmount.e2e-test.ts +734 -0
  386. package/src/e2e/inventory-weighted.e2e-test.ts +734 -0
  387. package/src/e2e/minAmount.e2e-test.ts +313 -0
  388. package/src/e2e/mixed-weighted.e2e-test.ts +267 -0
  389. package/src/e2e/weighted.e2e-test.ts +304 -0
  390. package/src/factories/RebalancerContextFactory.test.ts +394 -0
  391. package/src/factories/RebalancerContextFactory.ts +771 -0
  392. package/src/index.ts +125 -0
  393. package/src/interfaces/IExternalBridge.ts +117 -0
  394. package/src/interfaces/IMetrics.ts +5 -0
  395. package/src/interfaces/IMonitor.ts +71 -0
  396. package/src/interfaces/IRebalancer.ts +57 -0
  397. package/src/interfaces/IStrategy.ts +81 -0
  398. package/src/metrics/Metrics.ts +335 -0
  399. package/src/metrics/PriceGetter.ts +74 -0
  400. package/src/metrics/scripts/metrics.ts +139 -0
  401. package/src/monitor/Monitor.ts +324 -0
  402. package/src/service.ts +285 -0
  403. package/src/strategy/BaseStrategy.ts +553 -0
  404. package/src/strategy/CollateralDeficitStrategy.test.ts +728 -0
  405. package/src/strategy/CollateralDeficitStrategy.ts +421 -0
  406. package/src/strategy/CompositeStrategy.test.ts +418 -0
  407. package/src/strategy/CompositeStrategy.ts +102 -0
  408. package/src/strategy/MinAmountStrategy.test.ts +732 -0
  409. package/src/strategy/MinAmountStrategy.ts +200 -0
  410. package/src/strategy/StrategyFactory.test.ts +108 -0
  411. package/src/strategy/StrategyFactory.ts +157 -0
  412. package/src/strategy/WeightedStrategy.test.ts +529 -0
  413. package/src/strategy/WeightedStrategy.ts +126 -0
  414. package/src/strategy/index.ts +6 -0
  415. package/src/test/helpers.ts +477 -0
  416. package/src/test/lifiMocks.ts +211 -0
  417. package/src/tracking/ActionTracker.test.ts +1625 -0
  418. package/src/tracking/ActionTracker.ts +1019 -0
  419. package/src/tracking/IActionTracker.ts +213 -0
  420. package/src/tracking/InflightContextAdapter.test.ts +206 -0
  421. package/src/tracking/InflightContextAdapter.ts +75 -0
  422. package/src/tracking/store/IStore.ts +48 -0
  423. package/src/tracking/store/InMemoryStore.test.ts +338 -0
  424. package/src/tracking/store/InMemoryStore.ts +59 -0
  425. package/src/tracking/store/index.ts +2 -0
  426. package/src/tracking/types.ts +118 -0
  427. package/src/utils/ExplorerClient.test.ts +386 -0
  428. package/src/utils/ExplorerClient.ts +439 -0
  429. package/src/utils/balanceUtils.test.ts +79 -0
  430. package/src/utils/balanceUtils.ts +65 -0
  431. package/src/utils/blockTag.ts +68 -0
  432. package/src/utils/bridgeUtils.test.ts +193 -0
  433. package/src/utils/bridgeUtils.ts +101 -0
  434. package/src/utils/errors.ts +5 -0
  435. package/src/utils/gasEstimation.ts +306 -0
  436. package/src/utils/solanaKeyParser.test.ts +103 -0
  437. package/src/utils/solanaKeyParser.ts +117 -0
  438. package/src/utils/tokenUtils.ts +89 -0
  439. package/src/utils/transactionUtils.ts +41 -0
@@ -0,0 +1,278 @@
1
+ import { expect } from 'chai';
2
+ import { pino } from 'pino';
3
+ import { CompositeStrategy } from './CompositeStrategy.js';
4
+ const testLogger = pino({ level: 'silent' });
5
+ const TEST_BRIDGE = '0x1234567890123456789012345678901234567890';
6
+ class MockStrategy {
7
+ routesToReturn;
8
+ name = 'mock';
9
+ lastInflightContext;
10
+ constructor(routesToReturn) {
11
+ this.routesToReturn = routesToReturn;
12
+ }
13
+ getRebalancingRoutes(_rawBalances, inflightContext) {
14
+ this.lastInflightContext = inflightContext;
15
+ return this.routesToReturn;
16
+ }
17
+ }
18
+ describe('CompositeStrategy', () => {
19
+ let chain1;
20
+ let chain2;
21
+ let chain3;
22
+ beforeEach(() => {
23
+ chain1 = 'chain1';
24
+ chain2 = 'chain2';
25
+ chain3 = 'chain3';
26
+ });
27
+ describe('constructor', () => {
28
+ it('should throw an error when less than 2 strategies are provided', () => {
29
+ const mockStrategy = new MockStrategy([]);
30
+ expect(() => new CompositeStrategy([mockStrategy], testLogger)).to.throw('CompositeStrategy requires at least 2 sub-strategies');
31
+ });
32
+ it('should throw an error when no strategies are provided', () => {
33
+ expect(() => new CompositeStrategy([], testLogger)).to.throw('CompositeStrategy requires at least 2 sub-strategies');
34
+ });
35
+ it('should create a strategy with 2+ sub-strategies', () => {
36
+ const strategy1 = new MockStrategy([]);
37
+ const strategy2 = new MockStrategy([]);
38
+ const composite = new CompositeStrategy([strategy1, strategy2], testLogger);
39
+ expect(composite).to.be.instanceOf(CompositeStrategy);
40
+ });
41
+ });
42
+ describe('getRebalancingRoutes', () => {
43
+ it('should concatenate routes from all sub-strategies', () => {
44
+ const route1 = {
45
+ origin: chain1,
46
+ destination: chain2,
47
+ amount: 1000n,
48
+ executionType: 'movableCollateral',
49
+ bridge: TEST_BRIDGE,
50
+ };
51
+ const route2 = {
52
+ origin: chain2,
53
+ destination: chain3,
54
+ amount: 2000n,
55
+ executionType: 'movableCollateral',
56
+ bridge: TEST_BRIDGE,
57
+ };
58
+ const strategy1 = new MockStrategy([route1]);
59
+ const strategy2 = new MockStrategy([route2]);
60
+ const composite = new CompositeStrategy([strategy1, strategy2], testLogger);
61
+ const rawBalances = {
62
+ [chain1]: 5000n,
63
+ [chain2]: 10000n,
64
+ [chain3]: 3000n,
65
+ };
66
+ const routes = composite.getRebalancingRoutes(rawBalances);
67
+ expect(routes).to.have.lengthOf(2);
68
+ expect(routes[0]).to.deep.equal(route1);
69
+ expect(routes[1]).to.deep.equal(route2);
70
+ });
71
+ it('should pass routes from earlier strategies as proposedRebalances to later strategies', () => {
72
+ const route1 = {
73
+ origin: chain1,
74
+ destination: chain2,
75
+ amount: 1000n,
76
+ executionType: 'movableCollateral',
77
+ bridge: TEST_BRIDGE,
78
+ };
79
+ const strategy1 = new MockStrategy([route1]);
80
+ const strategy2 = new MockStrategy([]);
81
+ const composite = new CompositeStrategy([strategy1, strategy2], testLogger);
82
+ const rawBalances = {
83
+ [chain1]: 5000n,
84
+ [chain2]: 10000n,
85
+ };
86
+ composite.getRebalancingRoutes(rawBalances);
87
+ // Strategy 1 should receive empty proposedRebalances (none from earlier strategies)
88
+ expect(strategy1.lastInflightContext?.proposedRebalances).to.deep.equal([]);
89
+ // Strategy 2 should receive route1 as proposedRebalances (from earlier strategy)
90
+ expect(strategy2.lastInflightContext?.proposedRebalances).to.have.lengthOf(1);
91
+ expect(strategy2.lastInflightContext?.proposedRebalances?.[0]).to.deep.equal(route1);
92
+ });
93
+ it('should accumulate routes across multiple strategies as proposedRebalances', () => {
94
+ const route1 = {
95
+ origin: chain1,
96
+ destination: chain2,
97
+ amount: 1000n,
98
+ executionType: 'movableCollateral',
99
+ bridge: TEST_BRIDGE,
100
+ };
101
+ const route2 = {
102
+ origin: chain2,
103
+ destination: chain3,
104
+ amount: 2000n,
105
+ executionType: 'movableCollateral',
106
+ bridge: TEST_BRIDGE,
107
+ };
108
+ const route3 = {
109
+ origin: chain3,
110
+ destination: chain1,
111
+ amount: 3000n,
112
+ executionType: 'movableCollateral',
113
+ bridge: TEST_BRIDGE,
114
+ };
115
+ const strategy1 = new MockStrategy([route1]);
116
+ const strategy2 = new MockStrategy([route2]);
117
+ const strategy3 = new MockStrategy([route3]);
118
+ const composite = new CompositeStrategy([strategy1, strategy2, strategy3], testLogger);
119
+ const rawBalances = {
120
+ [chain1]: 5000n,
121
+ [chain2]: 10000n,
122
+ [chain3]: 3000n,
123
+ };
124
+ composite.getRebalancingRoutes(rawBalances);
125
+ // Strategy 1: empty proposedRebalances (no earlier strategies)
126
+ expect(strategy1.lastInflightContext?.proposedRebalances).to.deep.equal([]);
127
+ // Strategy 2: receives route1 as proposedRebalances
128
+ expect(strategy2.lastInflightContext?.proposedRebalances).to.have.lengthOf(1);
129
+ // Strategy 3: receives route1 + route2 as proposedRebalances
130
+ expect(strategy3.lastInflightContext?.proposedRebalances).to.have.lengthOf(2);
131
+ expect(strategy3.lastInflightContext?.proposedRebalances?.[0]).to.deep.equal(route1);
132
+ expect(strategy3.lastInflightContext?.proposedRebalances?.[1]).to.deep.equal(route2);
133
+ });
134
+ it('should preserve original pendingRebalances and use proposedRebalances for new routes', () => {
135
+ const originalPendingRebalance = {
136
+ origin: chain3,
137
+ destination: chain1,
138
+ amount: 500n,
139
+ executionType: 'movableCollateral',
140
+ bridge: TEST_BRIDGE,
141
+ };
142
+ const route1 = {
143
+ origin: chain1,
144
+ destination: chain2,
145
+ amount: 1000n,
146
+ executionType: 'movableCollateral',
147
+ bridge: TEST_BRIDGE,
148
+ };
149
+ const strategy1 = new MockStrategy([route1]);
150
+ const strategy2 = new MockStrategy([]);
151
+ const composite = new CompositeStrategy([strategy1, strategy2], testLogger);
152
+ const rawBalances = {
153
+ [chain1]: 5000n,
154
+ [chain2]: 10000n,
155
+ [chain3]: 3000n,
156
+ };
157
+ const inflightContext = {
158
+ pendingTransfers: [],
159
+ pendingRebalances: [originalPendingRebalance],
160
+ };
161
+ composite.getRebalancingRoutes(rawBalances, inflightContext);
162
+ // Both strategies should receive the SAME original pendingRebalances (inflight intents)
163
+ expect(strategy1.lastInflightContext?.pendingRebalances).to.have.lengthOf(1);
164
+ expect(strategy1.lastInflightContext?.pendingRebalances[0]).to.deep.equal(originalPendingRebalance);
165
+ expect(strategy2.lastInflightContext?.pendingRebalances).to.have.lengthOf(1);
166
+ expect(strategy2.lastInflightContext?.pendingRebalances[0]).to.deep.equal(originalPendingRebalance);
167
+ // Strategy 1: empty proposedRebalances (no earlier strategies)
168
+ expect(strategy1.lastInflightContext?.proposedRebalances).to.deep.equal([]);
169
+ // Strategy 2: receives route1 as proposedRebalances (from earlier strategy)
170
+ expect(strategy2.lastInflightContext?.proposedRebalances).to.have.lengthOf(1);
171
+ expect(strategy2.lastInflightContext?.proposedRebalances?.[0]).to.deep.equal(route1);
172
+ });
173
+ it('should preserve pendingTransfers for all strategies', () => {
174
+ const pendingTransfer = {
175
+ origin: chain1,
176
+ destination: chain2,
177
+ amount: 500n,
178
+ };
179
+ const strategy1 = new MockStrategy([]);
180
+ const strategy2 = new MockStrategy([]);
181
+ const composite = new CompositeStrategy([strategy1, strategy2], testLogger);
182
+ const rawBalances = {
183
+ [chain1]: 5000n,
184
+ [chain2]: 10000n,
185
+ };
186
+ const inflightContext = {
187
+ pendingTransfers: [pendingTransfer],
188
+ pendingRebalances: [],
189
+ };
190
+ composite.getRebalancingRoutes(rawBalances, inflightContext);
191
+ // Both strategies should receive the same pendingTransfers
192
+ expect(strategy1.lastInflightContext?.pendingTransfers).to.deep.equal([
193
+ pendingTransfer,
194
+ ]);
195
+ expect(strategy2.lastInflightContext?.pendingTransfers).to.deep.equal([
196
+ pendingTransfer,
197
+ ]);
198
+ });
199
+ it('should maintain route order (first strategy routes come first)', () => {
200
+ const route1a = {
201
+ origin: chain1,
202
+ destination: chain2,
203
+ amount: 1000n,
204
+ executionType: 'movableCollateral',
205
+ bridge: TEST_BRIDGE,
206
+ };
207
+ const route1b = {
208
+ origin: chain1,
209
+ destination: chain3,
210
+ amount: 1500n,
211
+ executionType: 'movableCollateral',
212
+ bridge: TEST_BRIDGE,
213
+ };
214
+ const route2a = {
215
+ origin: chain2,
216
+ destination: chain3,
217
+ amount: 2000n,
218
+ executionType: 'movableCollateral',
219
+ bridge: TEST_BRIDGE,
220
+ };
221
+ const strategy1 = new MockStrategy([route1a, route1b]);
222
+ const strategy2 = new MockStrategy([route2a]);
223
+ const composite = new CompositeStrategy([strategy1, strategy2], testLogger);
224
+ const rawBalances = {
225
+ [chain1]: 5000n,
226
+ [chain2]: 10000n,
227
+ [chain3]: 3000n,
228
+ };
229
+ const routes = composite.getRebalancingRoutes(rawBalances);
230
+ expect(routes).to.have.lengthOf(3);
231
+ expect(routes[0]).to.deep.equal(route1a);
232
+ expect(routes[1]).to.deep.equal(route1b);
233
+ expect(routes[2]).to.deep.equal(route2a);
234
+ });
235
+ it('should handle strategies that return no routes', () => {
236
+ const route2 = {
237
+ origin: chain2,
238
+ destination: chain3,
239
+ amount: 2000n,
240
+ executionType: 'movableCollateral',
241
+ bridge: TEST_BRIDGE,
242
+ };
243
+ const strategy1 = new MockStrategy([]);
244
+ const strategy2 = new MockStrategy([route2]);
245
+ const strategy3 = new MockStrategy([]);
246
+ const composite = new CompositeStrategy([strategy1, strategy2, strategy3], testLogger);
247
+ const rawBalances = {
248
+ [chain1]: 5000n,
249
+ [chain2]: 10000n,
250
+ [chain3]: 3000n,
251
+ };
252
+ const routes = composite.getRebalancingRoutes(rawBalances);
253
+ expect(routes).to.have.lengthOf(1);
254
+ expect(routes[0]).to.deep.equal(route2);
255
+ });
256
+ it('should handle undefined inflightContext', () => {
257
+ const route1 = {
258
+ origin: chain1,
259
+ destination: chain2,
260
+ amount: 1000n,
261
+ executionType: 'movableCollateral',
262
+ bridge: TEST_BRIDGE,
263
+ };
264
+ const strategy1 = new MockStrategy([route1]);
265
+ const strategy2 = new MockStrategy([]);
266
+ const composite = new CompositeStrategy([strategy1, strategy2], testLogger);
267
+ const rawBalances = {
268
+ [chain1]: 5000n,
269
+ [chain2]: 10000n,
270
+ };
271
+ const routes = composite.getRebalancingRoutes(rawBalances, undefined);
272
+ expect(routes).to.have.lengthOf(1);
273
+ expect(strategy1.lastInflightContext?.pendingTransfers).to.deep.equal([]);
274
+ expect(strategy1.lastInflightContext?.pendingRebalances).to.deep.equal([]);
275
+ });
276
+ });
277
+ });
278
+ //# sourceMappingURL=CompositeStrategy.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CompositeStrategy.test.js","sourceRoot":"","sources":["../../src/strategy/CompositeStrategy.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAY5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7C,MAAM,WAAW,GAAG,4CAA4C,CAAC;AAEjE,MAAM,YAAY;IAIa;IAHpB,IAAI,GAAG,MAAM,CAAC;IAChB,mBAAmB,CAAmB;IAE7C,YAA6B,cAA+B;QAA/B,mBAAc,GAAd,cAAc,CAAiB;IAAG,CAAC;IAEhE,oBAAoB,CAClB,YAAyB,EACzB,eAAiC;QAEjC,IAAI,CAAC,mBAAmB,GAAG,eAAe,CAAC;QAC3C,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAI,MAAiB,CAAC;IACtB,IAAI,MAAiB,CAAC;IACtB,IAAI,MAAiB,CAAC;IAEtB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,QAAQ,CAAC;QAClB,MAAM,GAAG,QAAQ,CAAC;QAClB,MAAM,GAAG,QAAQ,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACxE,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YAE1C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,iBAAiB,CAAC,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CACtE,sDAAsD,CACvD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,iBAAiB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAC1D,sDAAsD,CACvD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YAEvC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,CAAC,SAAS,EAAE,SAAS,CAAC,EACtB,UAAU,CACX,CAAC;YACF,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,MAAM,GAAkB;gBAC5B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YACF,MAAM,MAAM,GAAkB;gBAC5B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAE7C,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,CAAC,SAAS,EAAE,SAAS,CAAC,EACtB,UAAU,CACX,CAAC;YAEF,MAAM,WAAW,GAAgB;gBAC/B,CAAC,MAAM,CAAC,EAAE,KAAK;gBACf,CAAC,MAAM,CAAC,EAAE,MAAM;gBAChB,CAAC,MAAM,CAAC,EAAE,KAAK;aAChB,CAAC;YAEF,MAAM,MAAM,GAAG,SAAS,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;YAC9F,MAAM,MAAM,GAAkB;gBAC5B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YAEvC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,CAAC,SAAS,EAAE,SAAS,CAAC,EACtB,UAAU,CACX,CAAC;YAEF,MAAM,WAAW,GAAgB;gBAC/B,CAAC,MAAM,CAAC,EAAE,KAAK;gBACf,CAAC,MAAM,CAAC,EAAE,MAAM;aACjB,CAAC;YAEF,SAAS,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAE5C,oFAAoF;YACpF,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CACrE,EAAE,CACH,CAAC;YAEF,iFAAiF;YACjF,MAAM,CACJ,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,CAClD,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,CACJ,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,CACvD,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;YACnF,MAAM,MAAM,GAAkB;gBAC5B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YACF,MAAM,MAAM,GAAkB;gBAC5B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YACF,MAAM,MAAM,GAAkB;gBAC5B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAE7C,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EACjC,UAAU,CACX,CAAC;YAEF,MAAM,WAAW,GAAgB;gBAC/B,CAAC,MAAM,CAAC,EAAE,KAAK;gBACf,CAAC,MAAM,CAAC,EAAE,MAAM;gBAChB,CAAC,MAAM,CAAC,EAAE,KAAK;aAChB,CAAC;YAEF,SAAS,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAE5C,+DAA+D;YAC/D,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CACrE,EAAE,CACH,CAAC;YAEF,oDAAoD;YACpD,MAAM,CACJ,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,CAClD,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAEtB,6DAA6D;YAC7D,MAAM,CACJ,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,CAClD,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,CACJ,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,CACvD,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACxB,MAAM,CACJ,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,CACvD,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;YAC9F,MAAM,wBAAwB,GAAkB;gBAC9C,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,IAAI;gBACZ,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YAEF,MAAM,MAAM,GAAkB;gBAC5B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YAEvC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,CAAC,SAAS,EAAE,SAAS,CAAC,EACtB,UAAU,CACX,CAAC;YAEF,MAAM,WAAW,GAAgB;gBAC/B,CAAC,MAAM,CAAC,EAAE,KAAK;gBACf,CAAC,MAAM,CAAC,EAAE,MAAM;gBAChB,CAAC,MAAM,CAAC,EAAE,KAAK;aAChB,CAAC;YAEF,MAAM,eAAe,GAAoB;gBACvC,gBAAgB,EAAE,EAAE;gBACpB,iBAAiB,EAAE,CAAC,wBAAwB,CAAC;aAC9C,CAAC;YAEF,SAAS,CAAC,oBAAoB,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;YAE7D,wFAAwF;YACxF,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CACvE,CAAC,CACF,CAAC;YACF,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CACvE,wBAAwB,CACzB,CAAC;YACF,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CACvE,CAAC,CACF,CAAC;YACF,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CACvE,wBAAwB,CACzB,CAAC;YAEF,+DAA+D;YAC/D,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CACrE,EAAE,CACH,CAAC;YAEF,4EAA4E;YAC5E,MAAM,CACJ,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,CAClD,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,CACJ,SAAS,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,CACvD,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,MAAM,eAAe,GAAU;gBAC7B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,IAAI;aACb,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YAEvC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,CAAC,SAAS,EAAE,SAAS,CAAC,EACtB,UAAU,CACX,CAAC;YAEF,MAAM,WAAW,GAAgB;gBAC/B,CAAC,MAAM,CAAC,EAAE,KAAK;gBACf,CAAC,MAAM,CAAC,EAAE,MAAM;aACjB,CAAC;YAEF,MAAM,eAAe,GAAoB;gBACvC,gBAAgB,EAAE,CAAC,eAAe,CAAC;gBACnC,iBAAiB,EAAE,EAAE;aACtB,CAAC;YAEF,SAAS,CAAC,oBAAoB,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;YAE7D,2DAA2D;YAC3D,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;gBACpE,eAAe;aAChB,CAAC,CAAC;YACH,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;gBACpE,eAAe;aAChB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACxE,MAAM,OAAO,GAAkB;gBAC7B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YACF,MAAM,OAAO,GAAkB;gBAC7B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YACF,MAAM,OAAO,GAAkB;gBAC7B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YAE9C,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,CAAC,SAAS,EAAE,SAAS,CAAC,EACtB,UAAU,CACX,CAAC;YAEF,MAAM,WAAW,GAAgB;gBAC/B,CAAC,MAAM,CAAC,EAAE,KAAK;gBACf,CAAC,MAAM,CAAC,EAAE,MAAM;gBAChB,CAAC,MAAM,CAAC,EAAE,KAAK;aAChB,CAAC;YAEF,MAAM,MAAM,GAAG,SAAS,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,MAAM,GAAkB;gBAC5B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YAEvC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EACjC,UAAU,CACX,CAAC;YAEF,MAAM,WAAW,GAAgB;gBAC/B,CAAC,MAAM,CAAC,EAAE,KAAK;gBACf,CAAC,MAAM,CAAC,EAAE,MAAM;gBAChB,CAAC,MAAM,CAAC,EAAE,KAAK;aAChB,CAAC;YAEF,MAAM,MAAM,GAAG,SAAS,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,MAAM,GAAkB;gBAC5B,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,KAAK;gBACb,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,WAAW;aACpB,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YAEvC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,CAAC,SAAS,EAAE,SAAS,CAAC,EACtB,UAAU,CACX,CAAC;YAEF,MAAM,WAAW,GAAgB;gBAC/B,CAAC,MAAM,CAAC,EAAE,KAAK;gBACf,CAAC,MAAM,CAAC,EAAE,MAAM;aACjB,CAAC;YAEF,MAAM,MAAM,GAAG,SAAS,CAAC,oBAAoB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAEtE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1E,MAAM,CAAC,SAAS,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CACpE,EAAE,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { type Logger } from 'pino';
2
+ import { type ChainMap, type Token } from '@humanode-hyperlane/sdk';
3
+ import { type MinAmountStrategyConfig, RebalancerStrategyOptions } from '../config/types.js';
4
+ import type { RawBalances, Route, StrategyRoute } from '../interfaces/IStrategy.js';
5
+ import { type Metrics } from '../metrics/Metrics.js';
6
+ import type { BridgeConfigWithOverride } from '../utils/bridgeUtils.js';
7
+ import { BaseStrategy, type Delta } from './BaseStrategy.js';
8
+ /**
9
+ * Strategy implementation that rebalance based on minimum amounts
10
+ * It ensures each chain has at least the specified minimum amount
11
+ */
12
+ export declare class MinAmountStrategy extends BaseStrategy {
13
+ readonly name = RebalancerStrategyOptions.MinAmount;
14
+ private readonly config;
15
+ protected readonly logger: Logger;
16
+ constructor(config: MinAmountStrategyConfig, tokensByChainName: ChainMap<Token>, initialTotalCollateral: bigint, logger: Logger, bridgeConfigs: ChainMap<BridgeConfigWithOverride>, metrics?: Metrics);
17
+ /**
18
+ * Gets balances categorized by surplus and deficit based on minimum amounts and targets
19
+ * - For absolute values: Uses exact token amounts
20
+ * - For relative values: Uses percentages of total balance across all chains
21
+ *
22
+ * Simulates both types of rebalances before calculating surpluses/deficits:
23
+ * - pendingRebalances: in-flight intents (origin tx confirmed, add to destination only)
24
+ * - proposedRebalances: routes from earlier strategies (subtract from origin AND add to destination)
25
+ *
26
+ * This prevents over-rebalancing when multiple strategies run in sequence.
27
+ */
28
+ protected getCategorizedBalances(rawBalances: RawBalances, pendingRebalances?: Route[], proposedRebalances?: StrategyRoute[]): {
29
+ surpluses: Delta[];
30
+ deficits: Delta[];
31
+ };
32
+ protected getTokenByChainName(chainName: string): Token;
33
+ private validateAmounts;
34
+ }
35
+ //# sourceMappingURL=MinAmountStrategy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MinAmountStrategy.d.ts","sourceRoot":"","sources":["../../src/strategy/MinAmountStrategy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,EACL,KAAK,uBAAuB,EAE5B,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,WAAW,EACX,KAAK,EACL,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE7D;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,QAAQ,CAAC,IAAI,uCAAuC;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGhC,MAAM,EAAE,uBAAuB,EAC/B,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,EAClC,sBAAsB,EAAE,MAAM,EAC9B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EACjD,OAAO,CAAC,EAAE,OAAO;IAqCnB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,sBAAsB,CAC9B,WAAW,EAAE,WAAW,EACxB,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAC3B,kBAAkB,CAAC,EAAE,aAAa,EAAE,GACnC;QACD,SAAS,EAAE,KAAK,EAAE,CAAC;QACnB,QAAQ,EAAE,KAAK,EAAE,CAAC;KACnB;IAgED,SAAS,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAUvD,OAAO,CAAC,eAAe;CAkCxB"}
@@ -0,0 +1,112 @@
1
+ import { BigNumber } from 'bignumber.js';
2
+ import { fromWei, toWei } from '@humanode-hyperlane/utils';
3
+ import { RebalancerMinAmountType, RebalancerStrategyOptions, } from '../config/types.js';
4
+ import { BaseStrategy } from './BaseStrategy.js';
5
+ /**
6
+ * Strategy implementation that rebalance based on minimum amounts
7
+ * It ensures each chain has at least the specified minimum amount
8
+ */
9
+ export class MinAmountStrategy extends BaseStrategy {
10
+ name = RebalancerStrategyOptions.MinAmount;
11
+ config = {};
12
+ logger;
13
+ constructor(config, tokensByChainName, initialTotalCollateral, logger, bridgeConfigs, metrics) {
14
+ const chains = Object.keys(config);
15
+ const log = logger.child({ class: MinAmountStrategy.name });
16
+ super(chains, log, bridgeConfigs, metrics, tokensByChainName);
17
+ this.logger = log;
18
+ const minAmountType = config[chains[0]].minAmount.type;
19
+ this.validateAmounts(initialTotalCollateral, minAmountType, config);
20
+ for (const chain of chains) {
21
+ const { min, target } = config[chain].minAmount;
22
+ // check range constraints
23
+ if (BigNumber(target).lt(min)) {
24
+ throw new Error(`Target (${target}) must be greater than or equal to min (${min}) for chain ${chain}`);
25
+ }
26
+ if (BigNumber(min).lt(0)) {
27
+ throw new Error(`Minimum amount (${min}) cannot be negative for chain ${chain}`);
28
+ }
29
+ if (BigNumber(target).lt(0)) {
30
+ throw new Error(`Target amount (${target}) cannot be negative for chain ${chain}`);
31
+ }
32
+ }
33
+ this.config = config;
34
+ this.logger.info('MinAmountStrategy created');
35
+ }
36
+ /**
37
+ * Gets balances categorized by surplus and deficit based on minimum amounts and targets
38
+ * - For absolute values: Uses exact token amounts
39
+ * - For relative values: Uses percentages of total balance across all chains
40
+ *
41
+ * Simulates both types of rebalances before calculating surpluses/deficits:
42
+ * - pendingRebalances: in-flight intents (origin tx confirmed, add to destination only)
43
+ * - proposedRebalances: routes from earlier strategies (subtract from origin AND add to destination)
44
+ *
45
+ * This prevents over-rebalancing when multiple strategies run in sequence.
46
+ */
47
+ getCategorizedBalances(rawBalances, pendingRebalances, proposedRebalances) {
48
+ // Step 1: Simulate pending rebalances (in-flight, origin already deducted on-chain)
49
+ let simulatedBalances = this.simulatePendingRebalances(rawBalances, pendingRebalances ?? []);
50
+ // Step 2: Simulate proposed rebalances (from earlier strategies, not yet executed)
51
+ simulatedBalances = this.simulateProposedRebalances(simulatedBalances, proposedRebalances ?? []);
52
+ const totalCollateral = this.chains.reduce((sum, chain) => sum + simulatedBalances[chain], 0n);
53
+ return this.chains.reduce((acc, chain) => {
54
+ const chainConfig = this.config[chain];
55
+ const balance = simulatedBalances[chain];
56
+ let minAmount;
57
+ let targetAmount;
58
+ if (chainConfig.minAmount.type === RebalancerMinAmountType.Absolute) {
59
+ const token = this.getTokenByChainName(chain);
60
+ minAmount = BigInt(toWei(chainConfig.minAmount.min, token.decimals));
61
+ targetAmount = BigInt(toWei(chainConfig.minAmount.target, token.decimals));
62
+ }
63
+ else {
64
+ minAmount = BigInt(BigNumber(totalCollateral.toString())
65
+ .times(chainConfig.minAmount.min)
66
+ .toFixed(0, BigNumber.ROUND_FLOOR));
67
+ targetAmount = BigInt(BigNumber(totalCollateral.toString())
68
+ .times(chainConfig.minAmount.target)
69
+ .toFixed(0, BigNumber.ROUND_FLOOR));
70
+ }
71
+ // If balance is less than minAmount, it has a deficit
72
+ if (balance < minAmount) {
73
+ acc.deficits.push({ chain, amount: targetAmount - balance });
74
+ }
75
+ else {
76
+ // Any chain with more than minAmount potentially has surplus
77
+ const surplus = balance - minAmount;
78
+ if (surplus > 0n) {
79
+ acc.surpluses.push({ chain, amount: surplus });
80
+ }
81
+ }
82
+ return acc;
83
+ }, {
84
+ surpluses: [],
85
+ deficits: [],
86
+ });
87
+ }
88
+ getTokenByChainName(chainName) {
89
+ const token = this.tokensByChainName[chainName];
90
+ if (token === undefined) {
91
+ throw new Error(`Token not found for chain ${chainName}`);
92
+ }
93
+ return token;
94
+ }
95
+ validateAmounts(totalCollateral, minAmountType, config) {
96
+ config ??= this.config;
97
+ if (minAmountType === RebalancerMinAmountType.Absolute) {
98
+ let totalTargets = 0n;
99
+ let decimals = 0;
100
+ for (const chainName of this.chains) {
101
+ const token = this.getTokenByChainName(chainName);
102
+ // all the tokens have the same amount of decimals
103
+ decimals = token.decimals;
104
+ totalTargets += BigInt(toWei(config[chainName].minAmount.target, token.decimals));
105
+ }
106
+ if (totalTargets > totalCollateral) {
107
+ throw new Error(`Consider reducing the targets as the sum (${fromWei(totalTargets.toString(), decimals)}) is greater than sum of collaterals (${fromWei(totalCollateral.toString(), decimals)})`);
108
+ }
109
+ }
110
+ }
111
+ }
112
+ //# sourceMappingURL=MinAmountStrategy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MinAmountStrategy.js","sourceRoot":"","sources":["../../src/strategy/MinAmountStrategy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=MinAmountStrategy.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MinAmountStrategy.test.d.ts","sourceRoot":"","sources":["../../src/strategy/MinAmountStrategy.test.ts"],"names":[],"mappings":""}