@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,921 @@
1
+ import { expect } from 'chai';
2
+ import { ethers } from 'ethers';
3
+ import { rmSync } from 'fs';
4
+ import { tmpdir } from 'os';
5
+ import { join } from 'path';
6
+ import type { z } from 'zod';
7
+
8
+ import { writeYamlOrJson } from '@humanode-hyperlane/utils/fs';
9
+
10
+ import { RebalancerConfig } from './RebalancerConfig.js';
11
+ import {
12
+ DEFAULT_INTENT_TTL_MS,
13
+ ExecutionType,
14
+ ExternalBridgeType,
15
+ type RebalancerConfigFileInput,
16
+ RebalancerMinAmountType,
17
+ RebalancerStrategyOptions,
18
+ type StrategyConfig,
19
+ getAllBridges,
20
+ } from './types.js';
21
+
22
+ const TEST_CONFIG_PATH = join(tmpdir(), 'rebalancer-config-test.yaml');
23
+
24
+ // Helper to get strategy as array (for test type safety)
25
+ // Schema accepts both single object and array, but tests use array format
26
+ function getStrategyArray(
27
+ data: RebalancerConfigFileInput,
28
+ ): z.input<typeof import('./types.js').StrategyConfigSchema>[] {
29
+ return Array.isArray(data.strategy) ? data.strategy : [data.strategy];
30
+ }
31
+
32
+ describe('RebalancerConfig', () => {
33
+ let data: RebalancerConfigFileInput;
34
+
35
+ beforeEach(() => {
36
+ data = {
37
+ warpRouteId: 'warpRouteId',
38
+ strategy: [
39
+ {
40
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
41
+ chains: {
42
+ chain1: {
43
+ weighted: {
44
+ weight: 100,
45
+ tolerance: 0,
46
+ },
47
+ bridge: ethers.constants.AddressZero,
48
+ bridgeLockTime: 1,
49
+ },
50
+ chain2: {
51
+ weighted: {
52
+ weight: 100,
53
+ tolerance: 0,
54
+ },
55
+ bridge: ethers.constants.AddressZero,
56
+ bridgeLockTime: 1,
57
+ },
58
+ },
59
+ },
60
+ ],
61
+ };
62
+
63
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
64
+ });
65
+
66
+ afterEach(() => {
67
+ rmSync(TEST_CONFIG_PATH, { force: true });
68
+ });
69
+
70
+ it('should throw when the config file does not exist', () => {
71
+ rmSync(TEST_CONFIG_PATH, { force: true });
72
+
73
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw(
74
+ `File doesn't exist at ${TEST_CONFIG_PATH}`,
75
+ );
76
+ });
77
+
78
+ it('should load config from file', () => {
79
+ expect(RebalancerConfig.load(TEST_CONFIG_PATH)).to.deep.equal({
80
+ warpRouteId: 'warpRouteId',
81
+ strategyConfig: [
82
+ {
83
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
84
+ chains: {
85
+ chain1: {
86
+ weighted: {
87
+ weight: 100n,
88
+ tolerance: 0n,
89
+ },
90
+ bridge: ethers.constants.AddressZero,
91
+ bridgeLockTime: 1_000,
92
+ },
93
+ chain2: {
94
+ weighted: {
95
+ weight: 100n,
96
+ tolerance: 0n,
97
+ },
98
+ bridge: ethers.constants.AddressZero,
99
+ bridgeLockTime: 1_000,
100
+ },
101
+ },
102
+ },
103
+ ],
104
+ intentTTL: DEFAULT_INTENT_TTL_MS,
105
+ inventorySigners: undefined,
106
+ externalBridges: undefined,
107
+ });
108
+ });
109
+
110
+ it('should throw if chains are not configured', () => {
111
+ getStrategyArray(data)[0].chains = {};
112
+
113
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
114
+
115
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw(
116
+ 'No chains configured',
117
+ );
118
+ });
119
+
120
+ it('should throw if no warp route id is configured', () => {
121
+ // @ts-ignore
122
+ delete data.warpRouteId;
123
+
124
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
125
+
126
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw(
127
+ 'Validation error: Required at "warpRouteId"',
128
+ );
129
+ });
130
+
131
+ it('should load relative params without modifications', () => {
132
+ data = {
133
+ warpRouteId: 'warpRouteId',
134
+ strategy: [
135
+ {
136
+ rebalanceStrategy: RebalancerStrategyOptions.MinAmount,
137
+ chains: {
138
+ chain1: {
139
+ minAmount: {
140
+ min: '0.2',
141
+ target: 0.3,
142
+ type: RebalancerMinAmountType.Relative,
143
+ },
144
+ bridge: ethers.constants.AddressZero,
145
+ bridgeLockTime: 1,
146
+ },
147
+ chain2: {
148
+ minAmount: {
149
+ min: '0.2',
150
+ target: 0.3,
151
+ type: RebalancerMinAmountType.Relative,
152
+ },
153
+ bridge: ethers.constants.AddressZero,
154
+ bridgeLockTime: 1,
155
+ },
156
+ },
157
+ },
158
+ ],
159
+ };
160
+
161
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
162
+
163
+ expect(
164
+ RebalancerConfig.load(TEST_CONFIG_PATH).strategyConfig[0].chains.chain1,
165
+ ).to.deep.equal({
166
+ ...getStrategyArray(data)[0].chains.chain1,
167
+ bridgeLockTime: 1_000,
168
+ });
169
+ });
170
+
171
+ it('should load absolute params without modifications', () => {
172
+ data = {
173
+ warpRouteId: 'warpRouteId',
174
+ strategy: [
175
+ {
176
+ rebalanceStrategy: RebalancerStrategyOptions.MinAmount,
177
+ chains: {
178
+ chain1: {
179
+ minAmount: {
180
+ min: '100000',
181
+ target: 140000,
182
+ type: RebalancerMinAmountType.Absolute,
183
+ },
184
+ bridge: ethers.constants.AddressZero,
185
+ bridgeLockTime: 1,
186
+ },
187
+ chain2: {
188
+ minAmount: {
189
+ min: '100000',
190
+ target: 140000,
191
+ type: RebalancerMinAmountType.Absolute,
192
+ },
193
+ bridge: ethers.constants.AddressZero,
194
+ bridgeLockTime: 1,
195
+ },
196
+ },
197
+ },
198
+ ],
199
+ };
200
+
201
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
202
+
203
+ expect(
204
+ RebalancerConfig.load(TEST_CONFIG_PATH).strategyConfig[0].chains.chain1,
205
+ ).to.deep.equal({
206
+ ...getStrategyArray(data)[0].chains.chain1,
207
+ bridgeLockTime: 1_000,
208
+ });
209
+ });
210
+
211
+ describe('override functionality', () => {
212
+ it('should parse a config with overrides', () => {
213
+ data = {
214
+ warpRouteId: 'warpRouteId',
215
+ strategy: [
216
+ {
217
+ rebalanceStrategy: RebalancerStrategyOptions.MinAmount,
218
+ chains: {
219
+ chain1: {
220
+ minAmount: {
221
+ min: 1000,
222
+ target: 1100,
223
+ type: RebalancerMinAmountType.Absolute,
224
+ },
225
+ bridge: ethers.constants.AddressZero,
226
+ bridgeLockTime: 1,
227
+ override: {
228
+ chain2: {
229
+ bridge: '0x1234567890123456789012345678901234567890',
230
+ },
231
+ },
232
+ },
233
+ chain2: {
234
+ minAmount: {
235
+ min: 2000,
236
+ target: 2200,
237
+ type: RebalancerMinAmountType.Absolute,
238
+ },
239
+ bridge: ethers.constants.AddressZero,
240
+ bridgeLockTime: 1,
241
+ },
242
+ chain3: {
243
+ minAmount: {
244
+ min: 3000,
245
+ target: 3300,
246
+ type: RebalancerMinAmountType.Absolute,
247
+ },
248
+ bridge: ethers.constants.AddressZero,
249
+ bridgeLockTime: 1,
250
+ },
251
+ },
252
+ },
253
+ ],
254
+ };
255
+
256
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
257
+
258
+ const config = RebalancerConfig.load(TEST_CONFIG_PATH);
259
+ const chainConfig = config.strategyConfig[0].chains.chain1;
260
+ expect(chainConfig).to.have.property('override');
261
+
262
+ const override = chainConfig.override;
263
+ expect(override).to.not.be.undefined;
264
+ expect(override).to.have.property('chain2');
265
+
266
+ const toChain2Override = override!.chain2;
267
+ expect(toChain2Override).to.have.property('bridge');
268
+ expect(toChain2Override.bridge).to.equal(
269
+ '0x1234567890123456789012345678901234567890',
270
+ );
271
+ });
272
+
273
+ it('should throw when an override references a non-existent chain', () => {
274
+ data = {
275
+ warpRouteId: 'warpRouteId',
276
+ strategy: [
277
+ {
278
+ rebalanceStrategy: RebalancerStrategyOptions.MinAmount,
279
+ chains: {
280
+ chain1: {
281
+ minAmount: {
282
+ min: 1000,
283
+ target: 1100,
284
+ type: RebalancerMinAmountType.Absolute,
285
+ },
286
+ bridge: ethers.constants.AddressZero,
287
+ bridgeLockTime: 1,
288
+ override: {
289
+ chain2: {
290
+ bridge: '0x1234567890123456789012345678901234567890',
291
+ },
292
+ chain3: {
293
+ bridgeMinAcceptedAmount: 1000,
294
+ },
295
+ },
296
+ },
297
+ chain2: {
298
+ minAmount: {
299
+ min: 2000,
300
+ target: 2200,
301
+ type: RebalancerMinAmountType.Absolute,
302
+ },
303
+ bridge: ethers.constants.AddressZero,
304
+ bridgeLockTime: 1,
305
+ },
306
+ },
307
+ },
308
+ ],
309
+ };
310
+
311
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
312
+
313
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw(
314
+ "Chain 'chain1' has an override for 'chain3', but 'chain3' is not defined in the config",
315
+ );
316
+ });
317
+
318
+ it('should throw when an override references itself', () => {
319
+ data = {
320
+ warpRouteId: 'warpRouteId',
321
+ strategy: [
322
+ {
323
+ rebalanceStrategy: RebalancerStrategyOptions.MinAmount,
324
+ chains: {
325
+ chain1: {
326
+ minAmount: {
327
+ min: 1000,
328
+ target: 1100,
329
+ type: RebalancerMinAmountType.Absolute,
330
+ },
331
+ bridge: ethers.constants.AddressZero,
332
+ bridgeLockTime: 1,
333
+ override: {
334
+ chain1: {
335
+ bridgeMinAcceptedAmount: 1000,
336
+ },
337
+ },
338
+ },
339
+ chain2: {
340
+ minAmount: {
341
+ min: 2000,
342
+ target: 2200,
343
+ type: RebalancerMinAmountType.Absolute,
344
+ },
345
+ bridge: ethers.constants.AddressZero,
346
+ bridgeLockTime: 1,
347
+ },
348
+ },
349
+ },
350
+ ],
351
+ };
352
+
353
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
354
+
355
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw(
356
+ "Chain 'chain1' has an override for 'chain1', but 'chain1' is self-referencing",
357
+ );
358
+ });
359
+
360
+ it('should allow multiple chain overrides', () => {
361
+ getStrategyArray(data)[0].chains.chain1 = {
362
+ bridge: ethers.constants.AddressZero,
363
+ bridgeMinAcceptedAmount: 3000,
364
+ bridgeLockTime: 1,
365
+ weighted: {
366
+ weight: 100,
367
+ tolerance: 0,
368
+ },
369
+ override: {
370
+ chain2: {
371
+ bridgeMinAcceptedAmount: 4000,
372
+ },
373
+ chain3: {
374
+ bridge: '0x1234567890123456789012345678901234567890',
375
+ },
376
+ },
377
+ };
378
+
379
+ getStrategyArray(data)[0].chains.chain2 = {
380
+ bridge: ethers.constants.AddressZero,
381
+ bridgeMinAcceptedAmount: 5000,
382
+ bridgeLockTime: 1,
383
+ weighted: {
384
+ weight: 100,
385
+ tolerance: 0,
386
+ },
387
+ };
388
+
389
+ getStrategyArray(data)[0].chains.chain3 = {
390
+ bridge: ethers.constants.AddressZero,
391
+ bridgeMinAcceptedAmount: 6000,
392
+ bridgeLockTime: 1,
393
+ weighted: {
394
+ weight: 100,
395
+ tolerance: 0,
396
+ },
397
+ };
398
+
399
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
400
+
401
+ const config = RebalancerConfig.load(TEST_CONFIG_PATH);
402
+ const chainConfig = config.strategyConfig[0].chains.chain1;
403
+ const chain1Overrides = chainConfig.override;
404
+ expect(chain1Overrides).to.not.be.undefined;
405
+ expect(chain1Overrides).to.have.property('chain2');
406
+ expect(chain1Overrides).to.have.property('chain3');
407
+
408
+ const chain2Overrides = chain1Overrides!.chain2;
409
+ expect(chain2Overrides).to.have.property('bridgeMinAcceptedAmount');
410
+ expect(chain2Overrides.bridgeMinAcceptedAmount).to.equal(4000);
411
+
412
+ const chain3Overrides = chain1Overrides!.chain3;
413
+ expect(chain3Overrides).to.have.property('bridge');
414
+ expect(chain3Overrides.bridge).to.equal(
415
+ '0x1234567890123456789012345678901234567890',
416
+ );
417
+ });
418
+
419
+ it('should require externalBridge when override executionType is inventory', () => {
420
+ data = {
421
+ warpRouteId: 'warpRouteId',
422
+ strategy: [
423
+ {
424
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
425
+ chains: {
426
+ chain1: {
427
+ weighted: { weight: 60, tolerance: 5 },
428
+ bridge: ethers.constants.AddressZero,
429
+ override: {
430
+ chain2: {
431
+ executionType: ExecutionType.Inventory,
432
+ },
433
+ },
434
+ },
435
+ chain2: {
436
+ weighted: { weight: 40, tolerance: 5 },
437
+ bridge: ethers.constants.AddressZero,
438
+ },
439
+ },
440
+ },
441
+ ],
442
+ inventorySigners: { ethereum: ethers.constants.AddressZero },
443
+ externalBridges: { lifi: { integrator: 'test' } },
444
+ };
445
+
446
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
447
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw(
448
+ /override.*inventory execution.*externalBridge/i,
449
+ );
450
+ });
451
+
452
+ it('should require inventorySigners when only override enables inventory execution', () => {
453
+ data = {
454
+ warpRouteId: 'warpRouteId',
455
+ strategy: [
456
+ {
457
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
458
+ chains: {
459
+ chain1: {
460
+ weighted: { weight: 60, tolerance: 5 },
461
+ bridge: ethers.constants.AddressZero,
462
+ override: {
463
+ chain2: {
464
+ executionType: ExecutionType.Inventory,
465
+ externalBridge: ExternalBridgeType.LiFi,
466
+ },
467
+ },
468
+ },
469
+ chain2: {
470
+ weighted: { weight: 40, tolerance: 5 },
471
+ bridge: ethers.constants.AddressZero,
472
+ },
473
+ },
474
+ },
475
+ ],
476
+ externalBridges: { lifi: { integrator: 'test' } },
477
+ };
478
+
479
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
480
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw(
481
+ /inventorySigners.*required/i,
482
+ );
483
+ });
484
+ });
485
+
486
+ describe('composite strategy validation', () => {
487
+ it('should throw if CollateralDeficitStrategy is not first in composite', () => {
488
+ data = {
489
+ warpRouteId: 'warpRouteId',
490
+ strategy: [
491
+ {
492
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
493
+ chains: {
494
+ chain1: {
495
+ weighted: { weight: 100, tolerance: 0 },
496
+ bridge: ethers.constants.AddressZero,
497
+ bridgeLockTime: 1,
498
+ },
499
+ chain2: {
500
+ weighted: { weight: 100, tolerance: 0 },
501
+ bridge: ethers.constants.AddressZero,
502
+ bridgeLockTime: 1,
503
+ },
504
+ },
505
+ },
506
+ {
507
+ rebalanceStrategy: RebalancerStrategyOptions.CollateralDeficit,
508
+ chains: {
509
+ chain1: {
510
+ buffer: 1000,
511
+ bridge: ethers.constants.AddressZero,
512
+ bridgeLockTime: 1,
513
+ },
514
+ chain2: {
515
+ buffer: 1000,
516
+ bridge: ethers.constants.AddressZero,
517
+ bridgeLockTime: 1,
518
+ },
519
+ },
520
+ },
521
+ ],
522
+ };
523
+
524
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
525
+
526
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.throw(
527
+ 'CollateralDeficitStrategy must be first when used in composite strategy',
528
+ );
529
+ });
530
+
531
+ it('should allow CollateralDeficitStrategy first in composite', () => {
532
+ data = {
533
+ warpRouteId: 'warpRouteId',
534
+ strategy: [
535
+ {
536
+ rebalanceStrategy: RebalancerStrategyOptions.CollateralDeficit,
537
+ chains: {
538
+ chain1: {
539
+ buffer: 1000,
540
+ bridge: ethers.constants.AddressZero,
541
+ bridgeLockTime: 1,
542
+ },
543
+ chain2: {
544
+ buffer: 1000,
545
+ bridge: ethers.constants.AddressZero,
546
+ bridgeLockTime: 1,
547
+ },
548
+ },
549
+ },
550
+ {
551
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
552
+ chains: {
553
+ chain1: {
554
+ weighted: { weight: 100, tolerance: 0 },
555
+ bridge: ethers.constants.AddressZero,
556
+ bridgeLockTime: 1,
557
+ },
558
+ chain2: {
559
+ weighted: { weight: 100, tolerance: 0 },
560
+ bridge: ethers.constants.AddressZero,
561
+ bridgeLockTime: 1,
562
+ },
563
+ },
564
+ },
565
+ ],
566
+ };
567
+
568
+ writeYamlOrJson(TEST_CONFIG_PATH, data);
569
+
570
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH)).to.not.throw();
571
+ });
572
+ });
573
+ });
574
+
575
+ describe('per-chain bridge configuration', () => {
576
+ const TEST_CONFIG_PATH_BRIDGE = join(tmpdir(), 'rebalancer-bridge-test.yaml');
577
+
578
+ afterEach(() => {
579
+ rmSync(TEST_CONFIG_PATH_BRIDGE, { force: true });
580
+ });
581
+
582
+ it('should accept externalBridge field on chain config when using inventory execution', () => {
583
+ const data: RebalancerConfigFileInput = {
584
+ warpRouteId: 'test-route',
585
+ strategy: [
586
+ {
587
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
588
+ chains: {
589
+ ethereum: {
590
+ weighted: { weight: 50, tolerance: 5 },
591
+ executionType: ExecutionType.Inventory,
592
+ externalBridge: ExternalBridgeType.LiFi,
593
+ },
594
+ arbitrum: {
595
+ weighted: { weight: 50, tolerance: 5 },
596
+ executionType: ExecutionType.Inventory,
597
+ externalBridge: ExternalBridgeType.LiFi,
598
+ },
599
+ },
600
+ },
601
+ ],
602
+ inventorySigners: {
603
+ ethereum: '0x1234567890123456789012345678901234567890',
604
+ },
605
+ externalBridges: {
606
+ lifi: {
607
+ integrator: 'test-app',
608
+ },
609
+ },
610
+ };
611
+
612
+ writeYamlOrJson(TEST_CONFIG_PATH_BRIDGE, data);
613
+ const config = RebalancerConfig.load(TEST_CONFIG_PATH_BRIDGE);
614
+
615
+ expect(config.strategyConfig[0].chains.ethereum.externalBridge).to.equal(
616
+ 'lifi',
617
+ );
618
+ expect(config.externalBridges?.lifi?.integrator).to.equal('test-app');
619
+ });
620
+
621
+ it('should accept bridges.lifi section with integrator and optional defaultSlippage', () => {
622
+ const data: RebalancerConfigFileInput = {
623
+ warpRouteId: 'test-route',
624
+ strategy: [
625
+ {
626
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
627
+ chains: {
628
+ ethereum: {
629
+ weighted: { weight: 100, tolerance: 5 },
630
+ executionType: ExecutionType.Inventory,
631
+ externalBridge: ExternalBridgeType.LiFi,
632
+ },
633
+ },
634
+ },
635
+ ],
636
+ inventorySigners: {
637
+ ethereum: '0x1234567890123456789012345678901234567890',
638
+ },
639
+ externalBridges: {
640
+ lifi: {
641
+ integrator: 'my-app',
642
+ defaultSlippage: 0.01,
643
+ },
644
+ },
645
+ };
646
+
647
+ writeYamlOrJson(TEST_CONFIG_PATH_BRIDGE, data);
648
+ const config = RebalancerConfig.load(TEST_CONFIG_PATH_BRIDGE);
649
+
650
+ expect(config.externalBridges?.lifi).to.deep.include({
651
+ integrator: 'my-app',
652
+ defaultSlippage: 0.01,
653
+ });
654
+ });
655
+
656
+ it('should require externalBridges.lifi when executionType is inventory', () => {
657
+ const data = {
658
+ warpRouteId: 'test-route',
659
+ strategy: [
660
+ {
661
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
662
+ chains: {
663
+ ethereum: {
664
+ weighted: { weight: 100, tolerance: 5 },
665
+ executionType: ExecutionType.Inventory,
666
+ },
667
+ },
668
+ },
669
+ ],
670
+ inventorySigners: {
671
+ ethereum: '0x1234567890123456789012345678901234567890',
672
+ },
673
+ };
674
+
675
+ writeYamlOrJson(TEST_CONFIG_PATH_BRIDGE, data);
676
+
677
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH_BRIDGE)).to.throw(
678
+ /externalBridges\.lifi.*required/i,
679
+ );
680
+ });
681
+
682
+ it('should require externalBridges.lifi when externalBridge is lifi', () => {
683
+ const data = {
684
+ warpRouteId: 'test-route',
685
+ strategy: [
686
+ {
687
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
688
+ chains: {
689
+ ethereum: {
690
+ weighted: { weight: 100, tolerance: 5 },
691
+ executionType: ExecutionType.Inventory,
692
+ externalBridge: ExternalBridgeType.LiFi,
693
+ },
694
+ },
695
+ },
696
+ ],
697
+ inventorySigners: {
698
+ ethereum: '0x1234567890123456789012345678901234567890',
699
+ },
700
+ };
701
+
702
+ writeYamlOrJson(TEST_CONFIG_PATH_BRIDGE, data);
703
+
704
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH_BRIDGE)).to.throw(
705
+ /externalBridges\.lifi.*required|lifi.*not configured/i,
706
+ );
707
+ });
708
+
709
+ it('should require externalBridge field when executionType is inventory', () => {
710
+ const data = {
711
+ warpRouteId: 'test-route',
712
+ strategy: [
713
+ {
714
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
715
+ chains: {
716
+ ethereum: {
717
+ weighted: { weight: 100, tolerance: 5 },
718
+ executionType: ExecutionType.Inventory,
719
+ },
720
+ },
721
+ },
722
+ ],
723
+ inventorySigners: {
724
+ ethereum: '0x1234567890123456789012345678901234567890',
725
+ },
726
+ externalBridges: {
727
+ lifi: {
728
+ integrator: 'test-app',
729
+ },
730
+ },
731
+ };
732
+
733
+ writeYamlOrJson(TEST_CONFIG_PATH_BRIDGE, data);
734
+
735
+ expect(() => RebalancerConfig.load(TEST_CONFIG_PATH_BRIDGE)).to.throw(
736
+ /ethereum.*inventory execution.*externalBridge/i,
737
+ );
738
+ });
739
+ });
740
+
741
+ describe('getAllBridges', () => {
742
+ const BRIDGE_A = '0xAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA';
743
+ const BRIDGE_B = '0xBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB';
744
+ const BRIDGE_C = '0xCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC';
745
+
746
+ it('should return empty array for empty strategies', () => {
747
+ const result = getAllBridges([]);
748
+ expect(result).to.deep.equal([]);
749
+ });
750
+
751
+ it('should return bridge from single strategy', () => {
752
+ const strategies: StrategyConfig[] = [
753
+ {
754
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
755
+ chains: {
756
+ chain1: {
757
+ weighted: { weight: 100n, tolerance: 0n },
758
+ bridge: BRIDGE_A,
759
+ bridgeLockTime: 1000,
760
+ },
761
+ chain2: {
762
+ weighted: { weight: 100n, tolerance: 0n },
763
+ bridge: BRIDGE_A,
764
+ bridgeLockTime: 1000,
765
+ },
766
+ },
767
+ },
768
+ ];
769
+
770
+ const result = getAllBridges(strategies);
771
+ expect(result).to.deep.equal([BRIDGE_A]);
772
+ });
773
+
774
+ it('should return all bridges from multiple strategies', () => {
775
+ const strategies: StrategyConfig[] = [
776
+ {
777
+ rebalanceStrategy: RebalancerStrategyOptions.CollateralDeficit,
778
+ chains: {
779
+ chain1: {
780
+ buffer: 1000,
781
+ bridge: BRIDGE_A,
782
+ bridgeLockTime: 1000,
783
+ },
784
+ chain2: {
785
+ buffer: 1000,
786
+ bridge: BRIDGE_A,
787
+ bridgeLockTime: 1000,
788
+ },
789
+ },
790
+ },
791
+ {
792
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
793
+ chains: {
794
+ chain1: {
795
+ weighted: { weight: 100n, tolerance: 0n },
796
+ bridge: BRIDGE_B,
797
+ bridgeLockTime: 1000,
798
+ },
799
+ chain2: {
800
+ weighted: { weight: 100n, tolerance: 0n },
801
+ bridge: BRIDGE_B,
802
+ bridgeLockTime: 1000,
803
+ },
804
+ },
805
+ },
806
+ ];
807
+
808
+ const result = getAllBridges(strategies);
809
+ expect(result).to.have.members([BRIDGE_A, BRIDGE_B]);
810
+ expect(result).to.have.lengthOf(2);
811
+ });
812
+
813
+ it('should include bridges from per-destination overrides', () => {
814
+ const strategies: StrategyConfig[] = [
815
+ {
816
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
817
+ chains: {
818
+ chain1: {
819
+ weighted: { weight: 100n, tolerance: 0n },
820
+ bridge: BRIDGE_A,
821
+ bridgeLockTime: 1000,
822
+ override: {
823
+ chain2: {
824
+ bridge: BRIDGE_B,
825
+ },
826
+ chain3: {
827
+ bridge: BRIDGE_C,
828
+ },
829
+ },
830
+ },
831
+ chain2: {
832
+ weighted: { weight: 100n, tolerance: 0n },
833
+ bridge: BRIDGE_A,
834
+ bridgeLockTime: 1000,
835
+ },
836
+ chain3: {
837
+ weighted: { weight: 100n, tolerance: 0n },
838
+ bridge: BRIDGE_A,
839
+ bridgeLockTime: 1000,
840
+ },
841
+ },
842
+ },
843
+ ];
844
+
845
+ const result = getAllBridges(strategies);
846
+ expect(result).to.have.members([BRIDGE_A, BRIDGE_B, BRIDGE_C]);
847
+ expect(result).to.have.lengthOf(3);
848
+ });
849
+
850
+ it('should deduplicate bridges across strategies and overrides', () => {
851
+ const strategies: StrategyConfig[] = [
852
+ {
853
+ rebalanceStrategy: RebalancerStrategyOptions.CollateralDeficit,
854
+ chains: {
855
+ chain1: {
856
+ buffer: 1000,
857
+ bridge: BRIDGE_A,
858
+ bridgeLockTime: 1000,
859
+ },
860
+ chain2: {
861
+ buffer: 1000,
862
+ bridge: BRIDGE_B,
863
+ bridgeLockTime: 1000,
864
+ },
865
+ },
866
+ },
867
+ {
868
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
869
+ chains: {
870
+ chain1: {
871
+ weighted: { weight: 100n, tolerance: 0n },
872
+ bridge: BRIDGE_A, // Same as first strategy
873
+ bridgeLockTime: 1000,
874
+ override: {
875
+ chain2: {
876
+ bridge: BRIDGE_B, // Same as chain2 default
877
+ },
878
+ },
879
+ },
880
+ chain2: {
881
+ weighted: { weight: 100n, tolerance: 0n },
882
+ bridge: BRIDGE_B,
883
+ bridgeLockTime: 1000,
884
+ },
885
+ },
886
+ },
887
+ ];
888
+
889
+ const result = getAllBridges(strategies);
890
+ expect(result).to.have.members([BRIDGE_A, BRIDGE_B]);
891
+ expect(result).to.have.lengthOf(2);
892
+ });
893
+
894
+ it('should handle overrides without bridge property', () => {
895
+ const strategies: StrategyConfig[] = [
896
+ {
897
+ rebalanceStrategy: RebalancerStrategyOptions.Weighted,
898
+ chains: {
899
+ chain1: {
900
+ weighted: { weight: 100n, tolerance: 0n },
901
+ bridge: BRIDGE_A,
902
+ bridgeLockTime: 1000,
903
+ override: {
904
+ chain2: {
905
+ bridgeMinAcceptedAmount: 5000, // Override without bridge
906
+ },
907
+ },
908
+ },
909
+ chain2: {
910
+ weighted: { weight: 100n, tolerance: 0n },
911
+ bridge: BRIDGE_A,
912
+ bridgeLockTime: 1000,
913
+ },
914
+ },
915
+ },
916
+ ];
917
+
918
+ const result = getAllBridges(strategies);
919
+ expect(result).to.deep.equal([BRIDGE_A]);
920
+ });
921
+ });