@humanode-hyperlane/rebalancer 0.0.0-stage → 27.2.2

package/dist/factories/RebalancerContextFactory.test.js

@@ -0,0 +1,270 @@
+import { expect } from 'chai';
+import { pino } from 'pino';
+import Sinon from 'sinon';
+import { RegistryType } from '@humanode-hyperlane/registry';
+import { MultiProtocolProvider, MultiProvider, TokenStandard, } from '@humanode-hyperlane/sdk';
+import { ProtocolType, assert } from '@humanode-hyperlane/utils';
+import { ExecutionType, DEFAULT_INTENT_TTL_MS, RebalancerStrategyOptions, } from '../config/types.js';
+import { TEST_ADDRESSES } from '../test/helpers.js';
+import { RebalancerContextFactory } from './RebalancerContextFactory.js';
+const testLogger = pino({ level: 'silent' });
+function createMockRegistry() {
+    return {
+        type: RegistryType.Partial,
+        uri: 'mock://registry',
+        getUri: Sinon.stub().returns('mock://registry'),
+        listRegistryContent: Sinon.stub().resolves({
+            chains: {},
+            deployments: { warpRoutes: {}, warpDeployConfig: {} },
+        }),
+        getChains: Sinon.stub().resolves([]),
+        getMetadata: Sinon.stub().resolves({}),
+        getChainMetadata: Sinon.stub().resolves(null),
+        getAddresses: Sinon.stub().resolves({
+            ethereum: { mailbox: TEST_ADDRESSES.ethereum },
+            arbitrum: { mailbox: TEST_ADDRESSES.arbitrum },
+            paradex: { mailbox: TEST_ADDRESSES.polygon },
+        }),
+        getChainAddresses: Sinon.stub().resolves({
+            mailbox: TEST_ADDRESSES.ethereum,
+        }),
+        getChainLogoUri: Sinon.stub().resolves(null),
+        addChain: Sinon.stub().resolves(),
+        updateChain: Sinon.stub().resolves(),
+        removeChain: Sinon.stub().resolves(),
+        getWarpRoute: Sinon.stub().resolves(null),
+        getWarpRoutes: Sinon.stub().resolves({}),
+        addWarpRoute: Sinon.stub().resolves(),
+        addWarpRouteConfig: Sinon.stub().resolves(),
+        getWarpDeployConfig: Sinon.stub().resolves({}),
+        getWarpDeployConfigs: Sinon.stub().resolves({}),
+        merge: Sinon.stub().returnsThis(),
+    };
+}
+function createMockConfig() {
+    return {
+        warpRouteId: 'USDC/paradex',
+        strategyConfig: [
+            {
+                rebalanceStrategy: RebalancerStrategyOptions.Weighted,
+                chains: {
+                    ethereum: {
+                        bridge: TEST_ADDRESSES.bridge,
+                        bridgeMinAcceptedAmount: 0,
+                        weighted: { weight: 50n, tolerance: 10n },
+                    },
+                    arbitrum: {
+                        bridge: TEST_ADDRESSES.bridge,
+                        bridgeMinAcceptedAmount: 0,
+                        weighted: { weight: 50n, tolerance: 10n },
+                    },
+                },
+            },
+        ],
+        intentTTL: DEFAULT_INTENT_TTL_MS,
+    };
+}
+function createMockMpp() {
+    const mpp = Sinon.createStubInstance(MultiProtocolProvider);
+    mpp.extendChainMetadata.returnsThis();
+    return mpp;
+}
+function createToken(chainName, addressOrDenom, standard) {
+    return {
+        chainName,
+        addressOrDenom,
+        standard,
+        decimals: 6,
+        symbol: 'USDC',
+        name: 'USDC',
+    };
+}
+function createMockMultiProvider(chains) {
+    const protocolMap = Object.fromEntries(chains.map((c) => [c.name, c.protocol]));
+    const multiProvider = Sinon.createStubInstance(MultiProvider);
+    multiProvider.getProtocol.callsFake((chain) => {
+        const protocol = protocolMap[String(chain)];
+        assert(protocol, `No protocol in mock for chain ${chain}`);
+        return protocol;
+    });
+    return { multiProvider };
+}
+async function createFactory(config, multiProvider, warpCoreConfig) {
+    return RebalancerContextFactory.create(config, multiProvider, createMockMpp(), createMockRegistry(), testLogger, undefined, warpCoreConfig);
+}
+async function callCreate(multiProvider, warpCoreConfig) {
+    await createFactory(createMockConfig(), multiProvider, warpCoreConfig);
+}
+describe('RebalancerContextFactory', () => {
+    let sandbox;
+    beforeEach(() => {
+        sandbox = Sinon.createSandbox();
+    });
+    afterEach(() => {
+        sandbox.restore();
+    });
+    describe('create() — non-EVM chain handling', () => {
+        it('should skip provider initialization for StarkNet chains', async () => {
+            const { multiProvider } = createMockMultiProvider([
+                { name: 'ethereum', protocol: ProtocolType.Ethereum },
+                { name: 'arbitrum', protocol: ProtocolType.Ethereum },
+                { name: 'paradex', protocol: ProtocolType.Starknet },
+            ]);
+            await callCreate(multiProvider, {
+                tokens: [
+                    createToken('ethereum', TEST_ADDRESSES.ethereum, TokenStandard.EvmHypCollateral),
+                    createToken('arbitrum', TEST_ADDRESSES.arbitrum, TokenStandard.EvmHypSynthetic),
+                    createToken('paradex', '0xparadex', TokenStandard.StarknetHypSynthetic),
+                ],
+            });
+            expect(multiProvider.getProvider.callCount).to.equal(2);
+            const providerChains = multiProvider.getProvider
+                .getCalls()
+                .map((c) => c.args[0]);
+            expect(providerChains).to.include('ethereum');
+            expect(providerChains).to.include('arbitrum');
+            expect(providerChains).to.not.include('paradex');
+        });
+        it('should skip provider initialization for Sealevel chains', async () => {
+            const { multiProvider } = createMockMultiProvider([
+                { name: 'ethereum', protocol: ProtocolType.Ethereum },
+                { name: 'solana', protocol: ProtocolType.Sealevel },
+            ]);
+            await callCreate(multiProvider, {
+                tokens: [
+                    createToken('ethereum', TEST_ADDRESSES.ethereum, TokenStandard.EvmHypCollateral),
+                    createToken('solana', 'SolToken111', TokenStandard.SealevelHypSynthetic),
+                ],
+            });
+            expect(multiProvider.getProvider.callCount).to.equal(1);
+            expect(multiProvider.getProvider.firstCall.args[0]).to.equal('ethereum');
+        });
+        it('should call getProvider for all chains when all are EVM', async () => {
+            const { multiProvider } = createMockMultiProvider([
+                { name: 'ethereum', protocol: ProtocolType.Ethereum },
+                { name: 'arbitrum', protocol: ProtocolType.Ethereum },
+            ]);
+            await callCreate(multiProvider, {
+                tokens: [
+                    createToken('ethereum', TEST_ADDRESSES.ethereum, TokenStandard.EvmHypCollateral),
+                    createToken('arbitrum', TEST_ADDRESSES.arbitrum, TokenStandard.EvmHypSynthetic),
+                ],
+            });
+            expect(multiProvider.getProvider.callCount).to.equal(2);
+            const providerChains = multiProvider.getProvider
+                .getCalls()
+                .map((c) => c.args[0]);
+            expect(providerChains).to.include('ethereum');
+            expect(providerChains).to.include('arbitrum');
+        });
+        it('should fail early when inventory override origin protocol signer key is missing', async () => {
+            const sealevelChain = 'solana';
+            const evmChain = 'ethereum';
+            const { multiProvider } = createMockMultiProvider([
+                { name: evmChain, protocol: ProtocolType.Ethereum },
+                { name: sealevelChain, protocol: ProtocolType.Sealevel },
+            ]);
+            const config = {
+                warpRouteId: 'USDC/mixed-route',
+                strategyConfig: [
+                    {
+                        rebalanceStrategy: RebalancerStrategyOptions.Weighted,
+                        chains: {
+                            [sealevelChain]: {
+                                bridge: TEST_ADDRESSES.bridge,
+                                weighted: { weight: 50n, tolerance: 10n },
+                                override: {
+                                    [evmChain]: {
+                                        executionType: ExecutionType.Inventory,
+                                    },
+                                },
+                            },
+                            [evmChain]: {
+                                bridge: TEST_ADDRESSES.bridge,
+                                weighted: { weight: 50n, tolerance: 10n },
+                            },
+                        },
+                    },
+                ],
+                inventorySigners: {
+                    [ProtocolType.Ethereum]: {
+                        address: TEST_ADDRESSES.ethereum,
+                        key: '0xabc123',
+                    },
+                },
+                intentTTL: DEFAULT_INTENT_TTL_MS,
+            };
+            const factory = await createFactory(config, multiProvider, {
+                tokens: [
+                    createToken(evmChain, TEST_ADDRESSES.ethereum, TokenStandard.EvmHypSynthetic),
+                    createToken(sealevelChain, 'SolToken1111111111111111111111111111111111111', TokenStandard.SealevelHypCollateral),
+                ],
+            });
+            const getChainMetadataStub = factory.getWarpCore().multiProvider
+                .getChainMetadata;
+            getChainMetadataStub.callsFake((chainName) => ({
+                protocol: chainName === sealevelChain
+                    ? ProtocolType.Sealevel
+                    : ProtocolType.Ethereum,
+            }));
+            await expect(factory.createInventoryRebalancerAndConfig({}, {})).to.be.rejectedWith(`Missing inventory signer key for protocol ${ProtocolType.Sealevel}`);
+        });
+        it('should fail early when inventory chain uses unsupported protocol', async () => {
+            const cosmosChain = 'cosmoshub';
+            const evmChain = 'ethereum';
+            const { multiProvider } = createMockMultiProvider([
+                { name: evmChain, protocol: ProtocolType.Ethereum },
+                { name: cosmosChain, protocol: ProtocolType.Cosmos },
+            ]);
+            const config = {
+                warpRouteId: 'USDC/cosmos-route',
+                strategyConfig: [
+                    {
+                        rebalanceStrategy: RebalancerStrategyOptions.Weighted,
+                        chains: {
+                            [cosmosChain]: {
+                                bridge: TEST_ADDRESSES.bridge,
+                                weighted: { weight: 50n, tolerance: 10n },
+                                override: {
+                                    [evmChain]: {
+                                        executionType: ExecutionType.Inventory,
+                                    },
+                                },
+                            },
+                            [evmChain]: {
+                                bridge: TEST_ADDRESSES.bridge,
+                                weighted: { weight: 50n, tolerance: 10n },
+                            },
+                        },
+                    },
+                ],
+                inventorySigners: {
+                    [ProtocolType.Ethereum]: {
+                        address: TEST_ADDRESSES.ethereum,
+                        key: '0xabc123',
+                    },
+                    [ProtocolType.Cosmos]: {
+                        address: 'cosmos1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu',
+                        key: 'cosmos_key',
+                    },
+                },
+                intentTTL: DEFAULT_INTENT_TTL_MS,
+            };
+            const factory = await createFactory(config, multiProvider, {
+                tokens: [
+                    createToken(evmChain, TEST_ADDRESSES.ethereum, TokenStandard.EvmHypSynthetic),
+                    createToken(cosmosChain, 'cosmos1token', TokenStandard.EvmHypSynthetic),
+                ],
+            });
+            const getChainMetadataStub = factory.getWarpCore().multiProvider
+                .getChainMetadata;
+            getChainMetadataStub.callsFake((chainName) => ({
+                protocol: chainName === cosmosChain
+                    ? ProtocolType.Cosmos
+                    : ProtocolType.Ethereum,
+            }));
+            await expect(factory.createInventoryRebalancerAndConfig({}, {})).to.be.rejectedWith(`Inventory rebalancing does not support protocol '${ProtocolType.Cosmos}'`);
+        });
+    });
+});
+//# sourceMappingURL=RebalancerContextFactory.test.js.map

package/dist/factories/RebalancerContextFactory.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RebalancerContextFactory.test.js","sourceRoot":"","sources":["../../src/factories/RebalancerContextFactory.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @humanode-hyperlane/rebalancer
+ *
+ * Hyperlane Warp Route Collateral Rebalancer
+ *
+ * This package provides functionality for automatically rebalancing collateral
+ * across Hyperlane warp routes to maintain optimal token distribution.
+ */
+export { RebalancerService } from './core/RebalancerService.js';
+export type { RebalancerServiceConfig, ManualRebalanceRequest, } from './core/RebalancerService.js';
+export { Rebalancer } from './core/Rebalancer.js';
+export { RebalancerConfig } from './config/RebalancerConfig.js';
+export { DEFAULT_INTENT_TTL_MS, DEFAULT_INTENT_TTL_S, getStrategyChainConfig, getStrategyChainNames, RebalancerBaseChainConfigSchema, RebalancerConfigSchema, RebalancerMinAmountConfigSchema, RebalancerMinAmountType, RebalancerStrategyOptions, RebalancerStrategySchema, RebalancerWeightedChainConfigSchema, StrategyConfigSchema, } from './config/types.js';
+export type { MinAmountStrategyConfig, RebalancerConfig as RebalancerConfigType, RebalancerConfigFileInput, RebalancerMinAmountChainConfig, RebalancerWeightedChainConfig, StrategyConfig, WeightedStrategyConfig, } from './config/types.js';
+export { BaseStrategy } from './strategy/BaseStrategy.js';
+export { CompositeStrategy } from './strategy/CompositeStrategy.js';
+export { WeightedStrategy } from './strategy/WeightedStrategy.js';
+export { MinAmountStrategy } from './strategy/MinAmountStrategy.js';
+export { StrategyFactory } from './strategy/StrategyFactory.js';
+export { Monitor } from './monitor/Monitor.js';
+export { Metrics } from './metrics/Metrics.js';
+export { PriceGetter } from './metrics/PriceGetter.js';
+export type { ExecutionResult, IInventoryRebalancer, IMovableCollateralRebalancer, IRebalancer, InventoryExecutionResult, MovableCollateralExecutionResult, PreparedTransaction, RebalancerType, } from './interfaces/IRebalancer.js';
+export type { IStrategy, InflightContext, InventoryRoute, MovableCollateralRoute, RawBalances, Route, StrategyRoute, } from './interfaces/IStrategy.js';
+export type { ConfirmedBlockTag, ConfirmedBlockTags, IMonitor, } from './interfaces/IMonitor.js';
+export { MonitorEventType, MonitorEvent, MonitorPollingError, MonitorStartError, } from './interfaces/IMonitor.js';
+export type { IMetrics } from './interfaces/IMetrics.js';
+export { getBridgeConfig, isMovableCollateralConfig, isInventoryConfig, } from './utils/bridgeUtils.js';
+export type { BridgeConfigWithOverride, BridgeConfig, MovableCollateralBridgeConfig, InventoryBridgeConfig, } from './utils/bridgeUtils.js';
+export { getRawBalances } from './utils/balanceUtils.js';
+export { isCollateralizedTokenEligibleForRebalancing } from './utils/tokenUtils.js';
+export { ExplorerClient } from './utils/ExplorerClient.js';
+export { InflightContextAdapter } from './tracking/InflightContextAdapter.js';
+export type { IActionTracker, CreateRebalanceIntentParams, CreateRebalanceActionParams, } from './tracking/IActionTracker.js';
+export type { Transfer, RebalanceIntent, RebalanceAction, ActionType, PartialInventoryIntent, } from './tracking/types.js';
+export { RebalancerContextFactory } from './factories/RebalancerContextFactory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,+BAA+B,EAC/B,sBAAsB,EACtB,+BAA+B,EAC/B,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,mCAAmC,EACnC,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,uBAAuB,EACvB,gBAAgB,IAAI,oBAAoB,EACxC,yBAAyB,EACzB,8BAA8B,EAC9B,6BAA6B,EAC7B,cAAc,EACd,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,4BAA4B,EAC5B,WAAW,EACX,wBAAwB,EACxB,gCAAgC,EAChC,mBAAmB,EACnB,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,KAAK,EACL,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,GACT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,wBAAwB,EACxB,YAAY,EACZ,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,2CAA2C,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,YAAY,EACV,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,QAAQ,EACR,eAAe,EACf,eAAe,EACf,UAAU,EACV,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+/**
+ * @humanode-hyperlane/rebalancer
+ *
+ * Hyperlane Warp Route Collateral Rebalancer
+ *
+ * This package provides functionality for automatically rebalancing collateral
+ * across Hyperlane warp routes to maintain optimal token distribution.
+ */
+// Core service
+export { RebalancerService } from './core/RebalancerService.js';
+// Core rebalancing logic
+export { Rebalancer } from './core/Rebalancer.js';
+// Configuration
+export { RebalancerConfig } from './config/RebalancerConfig.js';
+export { DEFAULT_INTENT_TTL_MS, DEFAULT_INTENT_TTL_S, getStrategyChainConfig, getStrategyChainNames, RebalancerBaseChainConfigSchema, RebalancerConfigSchema, RebalancerMinAmountConfigSchema, RebalancerMinAmountType, RebalancerStrategyOptions, RebalancerStrategySchema, RebalancerWeightedChainConfigSchema, StrategyConfigSchema, } from './config/types.js';
+// Strategy
+export { BaseStrategy } from './strategy/BaseStrategy.js';
+export { CompositeStrategy } from './strategy/CompositeStrategy.js';
+export { WeightedStrategy } from './strategy/WeightedStrategy.js';
+export { MinAmountStrategy } from './strategy/MinAmountStrategy.js';
+export { StrategyFactory } from './strategy/StrategyFactory.js';
+// Monitor
+export { Monitor } from './monitor/Monitor.js';
+// Metrics
+export { Metrics } from './metrics/Metrics.js';
+export { PriceGetter } from './metrics/PriceGetter.js';
+export { MonitorEventType, MonitorPollingError, MonitorStartError, } from './interfaces/IMonitor.js';
+// Utils
+export { getBridgeConfig, isMovableCollateralConfig, isInventoryConfig, } from './utils/bridgeUtils.js';
+export { getRawBalances } from './utils/balanceUtils.js';
+export { isCollateralizedTokenEligibleForRebalancing } from './utils/tokenUtils.js';
+export { ExplorerClient } from './utils/ExplorerClient.js';
+// Tracking
+export { InflightContextAdapter } from './tracking/InflightContextAdapter.js';
+// Factory
+export { RebalancerContextFactory } from './factories/RebalancerContextFactory.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAMhE,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,+BAA+B,EAC/B,sBAAsB,EACtB,+BAA+B,EAC/B,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,mCAAmC,EACnC,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAW3B,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA2BvD,OAAO,EACL,gBAAgB,EAEhB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAGlC,QAAQ;AACR,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,2CAA2C,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,WAAW;AACX,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAc9E,UAAU;AACV,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/interfaces/IExternalBridge.d.ts

@@ -0,0 +1,103 @@
+import type { Logger } from 'pino';
+import type { ChainMap, ChainMetadata } from '@humanode-hyperlane/sdk';
+import { ProtocolType } from '@humanode-hyperlane/utils';
+import type { ExternalBridgeType } from '../config/types.js';
+/**
+ * Configuration for an external bridge.
+ */
+export interface ExternalBridgeConfig {
+    integrator: string;
+    apiKey?: string;
+    defaultSlippage?: number;
+    chainMetadata?: ChainMap<ChainMetadata>;
+}
+/**
+ * Parameters for requesting a bridge quote.
+ * Either fromAmount OR toAmount must be provided (mutually exclusive).
+ * - fromAmount: "I'm sending X, what do I get?" (standard quote)
+ * - toAmount: "I want X on destination, how much do I send?" (reverse quote)
+ */
+export interface BridgeQuoteParams {
+    fromChain: number;
+    toChain: number;
+    fromToken: string;
+    toToken: string;
+    fromAmount?: bigint;
+    toAmount?: bigint;
+    fromAddress: string;
+    toAddress?: string;
+    slippage?: number;
+}
+/**
+ * Quote response from a bridge.
+ */
+export interface BridgeQuote<R = unknown> {
+    id: string;
+    tool: string;
+    fromAmount: bigint;
+    toAmount: bigint;
+    toAmountMin: bigint;
+    executionDuration: number;
+    gasCosts: bigint;
+    feeCosts: bigint;
+    route: R;
+    requestParams: BridgeQuoteParams;
+}
+/**
+ * Result of executing a bridge transfer.
+ */
+export interface BridgeTransferResult {
+    txHash: string;
+    fromChain: number;
+    toChain: number;
+    transferId?: string;
+}
+/**
+ * Status of a bridge transfer.
+ */
+export type BridgeTransferStatus = {
+    status: 'pending';
+    substatus?: string;
+} | {
+    status: 'complete';
+    receivingTxHash: string;
+    receivedAmount: bigint;
+} | {
+    status: 'failed';
+    error?: string;
+} | {
+    status: 'not_found';
+};
+/**
+ * Interface for external bridge implementations (e.g., LiFi, Socket).
+ *
+ * External bridges are used for inventory rebalancing when chains don't support
+ * MovableCollateralRouter. The flow is:
+ * 1. quote() - Get a quote for bridging tokens
+ * 2. execute() - Execute the bridge transfer
+ * 3. getStatus() - Poll for transfer completion
+ */
+export interface IExternalBridge {
+    readonly externalBridgeId: string;
+    readonly logger: Logger;
+    getNativeTokenAddress?(): string;
+    quote(params: BridgeQuoteParams): Promise<BridgeQuote>;
+    /**
+     * Execute a bridge transfer using a previously obtained quote.
+     * @param quote - Quote obtained from quote()
+     * @param privateKeys - Private keys keyed by ProtocolType (e.g., { [ProtocolType.Ethereum]: '0x...' })
+     */
+    execute(quote: BridgeQuote, privateKeys: Partial<Record<ProtocolType, string>>): Promise<BridgeTransferResult>;
+    /**
+     * Get the status of a bridge transfer.
+     * @param txHash - Origin chain transaction hash
+     * @param fromChain - Source chain ID
+     * @param toChain - Destination chain ID
+     */
+    getStatus(txHash: string, fromChain: number, toChain: number): Promise<BridgeTransferStatus>;
+}
+/**
+ * Registry mapping external bridge types to their implementations.
+ */
+export type ExternalBridgeRegistry = Record<ExternalBridgeType, IExternalBridge>;
+//# sourceMappingURL=IExternalBridge.d.ts.map

package/dist/interfaces/IExternalBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IExternalBridge.d.ts","sourceRoot":"","sources":["../../src/interfaces/IExternalBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;CACzC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,CAAC,CAAC;IACT,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5B;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,qBAAqB,CAAC,IAAI,MAAM,CAAC;IAEjC,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEvD;;;;OAIG;IACH,OAAO,CACL,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GACjD,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,SAAS,CACP,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CACzC,kBAAkB,EAClB,eAAe,CAChB,CAAC"}

package/dist/interfaces/IExternalBridge.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IExternalBridge.js.map

package/dist/interfaces/IExternalBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IExternalBridge.js","sourceRoot":"","sources":["../../src/interfaces/IExternalBridge.ts"],"names":[],"mappings":""}

package/dist/interfaces/IMetrics.d.ts

@@ -0,0 +1,5 @@
+import { type MonitorEvent } from './IMonitor.js';
+export interface IMetrics {
+    processToken(tokenInfo: MonitorEvent['tokensInfo'][number]): Promise<void>;
+}
+//# sourceMappingURL=IMetrics.d.ts.map

package/dist/interfaces/IMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMetrics.d.ts","sourceRoot":"","sources":["../../src/interfaces/IMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E"}

package/dist/interfaces/IMetrics.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IMetrics.js.map

package/dist/interfaces/IMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMetrics.js","sourceRoot":"","sources":["../../src/interfaces/IMetrics.ts"],"names":[],"mappings":""}

package/dist/interfaces/IMonitor.d.ts

@@ -0,0 +1,50 @@
+import { type ChainMap, EthJsonRpcBlockParameterTag, type Token } from '@humanode-hyperlane/sdk';
+import { WrappedError } from '../utils/errors.js';
+export declare class MonitorStartError extends WrappedError {
+    name: string;
+}
+export declare class MonitorPollingError extends WrappedError {
+    name: string;
+}
+export declare enum MonitorEventType {
+    TokenInfo = "TokenInfo",
+    Error = "Error",
+    Start = "Start"
+}
+export type ConfirmedBlockTag = number | EthJsonRpcBlockParameterTag | undefined;
+export type ConfirmedBlockTags = ChainMap<ConfirmedBlockTag>;
+export type MonitorEvent = {
+    tokensInfo: {
+        token: Token;
+        bridgedSupply?: bigint;
+    }[];
+    confirmedBlockTags: ConfirmedBlockTags;
+    inventoryBalances?: ChainMap<bigint>;
+};
+/**
+ * Interface for a monitoring service that tracks token information across different chains.
+ */
+export interface IMonitor {
+    /**
+     * Allows subscribers to listen to hyperlane's tokens info.
+     * Handler can be async - Monitor will await it before starting next cycle.
+     */
+    on(eventName: MonitorEventType.TokenInfo, fn: (event: MonitorEvent) => void | Promise<void>): this;
+    /**
+     * Allows subscribers to listen to error events.
+     */
+    on(eventName: MonitorEventType.Error, fn: (event: Error) => void): this;
+    /**
+     * Allows subscribers to listen to start events.
+     */
+    on(eventName: MonitorEventType.Start, fn: () => void): this;
+    /**
+     * Starts the monitoring long-running process.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the monitoring long-running process.
+     */
+    stop(): void;
+}
+//# sourceMappingURL=IMonitor.d.ts.map

package/dist/interfaces/IMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMonitor.d.ts","sourceRoot":"","sources":["../../src/interfaces/IMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,2BAA2B,EAC3B,KAAK,KAAK,EACX,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,IAAI,SAAuB;CAC5B;AAED,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,IAAI,SAAyB;CAC9B;AAED,oBAAY,gBAAgB;IAC1B,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,2BAA2B,GAC3B,SAAS,CAAC;AAEd,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE;QACV,KAAK,EAAE,KAAK,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,EAAE,CAAC;IACJ,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,EAAE,CACA,SAAS,EAAE,gBAAgB,CAAC,SAAS,EACrC,EAAE,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAChD,IAAI,CAAC;IAER;;OAEG;IACH,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAExE;;OAEG;IACH,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;CACd"}

package/dist/interfaces/IMonitor.js

@@ -0,0 +1,14 @@
+import { WrappedError } from '../utils/errors.js';
+export class MonitorStartError extends WrappedError {
+    name = 'MonitorStartError';
+}
+export class MonitorPollingError extends WrappedError {
+    name = 'MonitorPollingError';
+}
+export var MonitorEventType;
+(function (MonitorEventType) {
+    MonitorEventType["TokenInfo"] = "TokenInfo";
+    MonitorEventType["Error"] = "Error";
+    MonitorEventType["Start"] = "Start";
+})(MonitorEventType || (MonitorEventType = {}));
+//# sourceMappingURL=IMonitor.js.map

package/dist/interfaces/IMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMonitor.js","sourceRoot":"","sources":["../../src/interfaces/IMonitor.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACjD,IAAI,GAAG,mBAAmB,CAAC;CAC5B;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnD,IAAI,GAAG,qBAAqB,CAAC;CAC9B;AAED,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,2CAAuB,CAAA;IACvB,mCAAe,CAAA;IACf,mCAAe,CAAA;AACjB,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B"}

package/dist/interfaces/IRebalancer.d.ts

@@ -0,0 +1,31 @@
+import { type EvmMovableCollateralAdapter, type TokenAmount } from '@humanode-hyperlane/sdk';
+import { type InventoryRoute, type MovableCollateralRoute, type Route } from './IStrategy.js';
+export type RebalancerType = 'movableCollateral' | 'inventory';
+export interface ExecutionResult<R extends Route = Route> {
+    route: R;
+    success: boolean;
+    error?: string;
+    txHash?: string;
+    reason?: string;
+}
+export interface MovableCollateralExecutionResult extends ExecutionResult<MovableCollateralRoute> {
+    messageId: string;
+}
+export interface InventoryExecutionResult extends ExecutionResult<InventoryRoute> {
+    messageId?: string;
+    amountSent?: bigint;
+}
+export interface IRebalancer<R extends Route = Route, E extends ExecutionResult<R> = ExecutionResult<R>> {
+    readonly rebalancerType: RebalancerType;
+    rebalance(routes: R[]): Promise<E[]>;
+}
+export type IMovableCollateralRebalancer = IRebalancer<MovableCollateralRoute, MovableCollateralExecutionResult>;
+export type IInventoryRebalancer = IRebalancer<InventoryRoute, InventoryExecutionResult>;
+export type PreparedTransaction = {
+    populatedTx: Awaited<ReturnType<EvmMovableCollateralAdapter['populateRebalanceTx']>>;
+    route: MovableCollateralRoute & {
+        intentId: string;
+    };
+    originTokenAmount: TokenAmount;
+};
+//# sourceMappingURL=IRebalancer.d.ts.map

package/dist/interfaces/IRebalancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRebalancer.d.ts","sourceRoot":"","sources":["../../src/interfaces/IRebalancer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,KAAK,EACX,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,WAAW,CAAC;AAE/D,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IACtD,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gCAAiC,SAAQ,eAAe,CAAC,sBAAsB,CAAC;IAC/F,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAyB,SAAQ,eAAe,CAAC,cAAc,CAAC;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW,CAC1B,CAAC,SAAS,KAAK,GAAG,KAAK,EACvB,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAEjD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,4BAA4B,GAAG,WAAW,CACpD,sBAAsB,EACtB,gCAAgC,CACjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAC5C,cAAc,EACd,wBAAwB,CACzB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,OAAO,CAClB,UAAU,CAAC,2BAA2B,CAAC,qBAAqB,CAAC,CAAC,CAC/D,CAAC;IACF,KAAK,EAAE,sBAAsB,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,iBAAiB,EAAE,WAAW,CAAC;CAChC,CAAC"}

package/dist/interfaces/IRebalancer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IRebalancer.js.map

package/dist/interfaces/IRebalancer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRebalancer.js","sourceRoot":"","sources":["../../src/interfaces/IRebalancer.ts"],"names":[],"mappings":""}