@hyperlane-xyz/rebalancer 0.1.2 → 1.0.0

package/dist/test/helpers.js

@@ -1,10 +1,243 @@
 import { ethers } from 'ethers';
+import Sinon from 'sinon';
+import { EvmMovableCollateralAdapter, } from '@hyperlane-xyz/sdk';
 import { RebalancerStrategyOptions } from '../config/types.js';
+// === Mock Classes ===
 export class MockRebalancer {
     rebalance(_routes) {
-        return Promise.resolve();
+        return Promise.resolve([]);
     }
 }
+// === Test Data Builders ===
+export function buildTestRoute(overrides = {}) {
+    return {
+        origin: 'ethereum',
+        destination: 'arbitrum',
+        amount: ethers.utils.parseEther('100').toBigInt(),
+        bridge: TEST_ADDRESSES.bridge,
+        ...overrides,
+    };
+}
+export function buildTestRebalanceRoute(overrides = {}) {
+    return {
+        intentId: overrides.intentId ?? `test-route-${Date.now()}`,
+        origin: 'ethereum',
+        destination: 'arbitrum',
+        amount: ethers.utils.parseEther('100').toBigInt(),
+        bridge: TEST_ADDRESSES.bridge,
+        ...overrides,
+    };
+}
+export function buildTestResult(overrides = {}) {
+    const route = overrides.route ?? buildTestRebalanceRoute();
+    return {
+        route,
+        success: true,
+        messageId: '0x1111111111111111111111111111111111111111111111111111111111111111',
+        txHash: '0x2222222222222222222222222222222222222222222222222222222222222222',
+        ...overrides,
+    };
+}
+export function buildTestPreparedTransaction(overrides = {}) {
+    const route = overrides.route ?? buildTestRebalanceRoute();
+    return {
+        populatedTx: {
+            to: TEST_ADDRESSES.token,
+            data: '0x',
+            value: ethers.BigNumber.from(0),
+        },
+        route,
+        originTokenAmount: createMockTokenAmount(route.amount),
+        ...overrides,
+    };
+}
+// === Mock Factories ===
+export function createMockTokenAmount(amount) {
+    return {
+        amount,
+        token: {
+            name: 'TestToken',
+            symbol: 'TEST',
+            decimals: 18,
+            addressOrDenom: TEST_ADDRESSES.token,
+        },
+        getDecimalFormattedAmount: () => ethers.utils.formatEther(amount),
+    };
+}
+export function createMockAdapter(config = {}) {
+    const { isRebalancer = true, allowedDestination = TEST_ADDRESSES.arbitrum, isBridgeAllowed = true, quotes = [{ igpQuote: { amount: BigInt(1000000) } }], populatedTx = {
+        to: TEST_ADDRESSES.token,
+        data: '0x',
+        value: ethers.BigNumber.from(0),
+    }, throwOnQuotes, throwOnPopulate, } = config;
+    const adapter = {
+        isRebalancer: Sinon.stub().resolves(isRebalancer),
+        getAllowedDestination: Sinon.stub().resolves(allowedDestination),
+        isBridgeAllowed: Sinon.stub().resolves(isBridgeAllowed),
+        getRebalanceQuotes: throwOnQuotes
+            ? Sinon.stub().rejects(throwOnQuotes)
+            : Sinon.stub().resolves(quotes),
+        populateRebalanceTx: throwOnPopulate
+            ? Sinon.stub().rejects(throwOnPopulate)
+            : Sinon.stub().resolves(populatedTx),
+    };
+    Object.setPrototypeOf(adapter, EvmMovableCollateralAdapter.prototype);
+    return adapter;
+}
+export function createMockToken(config = {}) {
+    const { name = 'TestToken', decimals = 18, addressOrDenom = TEST_ADDRESSES.token, adapter = createMockAdapter(), } = config;
+    const token = {
+        name,
+        decimals,
+        addressOrDenom,
+        amount: (amt) => createMockTokenAmount(amt),
+        getHypAdapter: Sinon.stub().returns(adapter),
+    };
+    return { token, adapter };
+}
+export function createMockMultiProvider(config = {}) {
+    const { chainMetadata = {}, signerAddress = TEST_ADDRESSES.signer, sendTransactionReceipt = {
+        transactionHash: '0x1111111111111111111111111111111111111111111111111111111111111111',
+        blockNumber: 100,
+        status: 1,
+    }, throwOnSendTransaction, throwOnEstimateGas, providerWaitForTransaction = sendTransactionReceipt, providerGetBlock = { number: 150 }, providerGetTransactionReceipt = sendTransactionReceipt, } = config;
+    const mockProvider = {
+        waitForTransaction: Sinon.stub().resolves(providerWaitForTransaction),
+        getBlock: Sinon.stub().resolves(providerGetBlock),
+        getTransactionReceipt: Sinon.stub().resolves(providerGetTransactionReceipt),
+    };
+    const mockSigner = {
+        getAddress: Sinon.stub().resolves(signerAddress),
+        sendTransaction: throwOnSendTransaction
+            ? Sinon.stub().rejects(throwOnSendTransaction)
+            : Sinon.stub().resolves({
+                hash: sendTransactionReceipt.transactionHash,
+                wait: Sinon.stub().resolves(sendTransactionReceipt),
+            }),
+    };
+    const defaultChainMetadata = {
+        ethereum: { domainId: 1, blocks: { confirmations: 32, reorgPeriod: 32 } },
+        arbitrum: { domainId: 42161, blocks: { confirmations: 0, reorgPeriod: 0 } },
+    };
+    const mergedMetadata = { ...defaultChainMetadata, ...chainMetadata };
+    return {
+        getChainMetadata: Sinon.stub().callsFake((chain) => mergedMetadata[chain] ?? {}),
+        getProvider: Sinon.stub().returns(mockProvider),
+        getSigner: Sinon.stub().returns(mockSigner),
+        estimateGas: throwOnEstimateGas
+            ? Sinon.stub().rejects(throwOnEstimateGas)
+            : Sinon.stub().resolves(ethers.BigNumber.from(100000)),
+        sendTransaction: throwOnSendTransaction
+            ? Sinon.stub().rejects(throwOnSendTransaction)
+            : Sinon.stub().resolves(sendTransactionReceipt),
+        getDomainId: Sinon.stub().callsFake((chain) => mergedMetadata[chain]?.domainId ?? 0),
+        _mockProvider: mockProvider,
+        _mockSigner: mockSigner,
+    };
+}
+export function createMockWarpCore(multiProvider) {
+    return {
+        multiProvider,
+    };
+}
+// Valid EVM test addresses (40 hex chars after 0x)
+export const TEST_ADDRESSES = {
+    ethereum: '0x1111111111111111111111111111111111111111',
+    arbitrum: '0x2222222222222222222222222222222222222222',
+    optimism: '0x3333333333333333333333333333333333333333',
+    polygon: '0x4444444444444444444444444444444444444444',
+    bridge: '0xBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB',
+    signer: '0xAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+    token: '0xCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC',
+};
+export function getTestAddress(key) {
+    return TEST_ADDRESSES[key] ?? `0x${key.padStart(40, '0').slice(-40)}`;
+}
+export function buildTestBridges(chains = ['ethereum', 'arbitrum']) {
+    return chains.reduce((acc, chain) => {
+        acc[chain] = {
+            bridge: TEST_ADDRESSES.bridge,
+            bridgeMinAcceptedAmount: 0,
+        };
+        return acc;
+    }, {});
+}
+/**
+ * Convert a chain config map (with bridge addresses) to a BridgeConfigWithOverride map.
+ * Useful for tests that define bridge addresses in the strategy config.
+ */
+export function extractBridgeConfigs(chainConfig) {
+    return Object.entries(chainConfig).reduce((acc, [chain, config]) => {
+        acc[chain] = {
+            bridge: config.bridge,
+            bridgeMinAcceptedAmount: config.bridgeMinAcceptedAmount ?? 0,
+        };
+        return acc;
+    }, {});
+}
+export function buildTestChainMetadata(chains = ['ethereum', 'arbitrum']) {
+    const domainIds = {
+        ethereum: 1,
+        arbitrum: 42161,
+        optimism: 10,
+        polygon: 137,
+    };
+    return chains.reduce((acc, chain) => {
+        acc[chain] = {
+            name: chain,
+            chainId: domainIds[chain] ?? 1,
+            domainId: domainIds[chain] ?? 1,
+            protocol: 'ethereum',
+            rpcUrls: [{ http: 'http://localhost:8545' }],
+            blocks: { reorgPeriod: chain === 'polygon' ? 'finalized' : 32 },
+        };
+        return acc;
+    }, {});
+}
+export function createRebalancerTestContext(chains = ['ethereum', 'arbitrum'], adapterConfigs = {}) {
+    const multiProvider = createMockMultiProvider();
+    const warpCore = createMockWarpCore(multiProvider);
+    const bridges = buildTestBridges(chains);
+    const chainMetadata = buildTestChainMetadata(chains);
+    const adapters = {};
+    const tokensByChainName = {};
+    for (const chain of chains) {
+        const adapterConfig = adapterConfigs[chain] ?? {};
+        const tokenAddress = getTestAddress(chain);
+        const { token, adapter } = createMockToken({
+            name: `${chain}Token`,
+            addressOrDenom: tokenAddress,
+            adapter: createMockAdapter(adapterConfig),
+        });
+        adapters[chain] = adapter;
+        tokensByChainName[chain] = token;
+    }
+    for (const originChain of chains) {
+        const adapterConfig = adapterConfigs[originChain] ?? {};
+        if (adapterConfig.allowedDestination === undefined) {
+            const destAddressMap = {};
+            for (const destChain of chains) {
+                if (originChain !== destChain) {
+                    destAddressMap[chainMetadata[destChain].domainId] =
+                        getTestAddress(destChain);
+                }
+            }
+            adapters[originChain].getAllowedDestination.callsFake((domainId) => {
+                return Promise.resolve(destAddressMap[domainId] ??
+                    '0x0000000000000000000000000000000000000000');
+            });
+        }
+    }
+    return {
+        multiProvider,
+        warpCore,
+        bridges,
+        chainMetadata,
+        tokensByChainName,
+        adapters,
+    };
+}
+// === Config Builders ===
 export function buildTestConfig(overrides = {}, chains = ['chain1']) {
     const baseChains = chains.reduce((acc, chain) => {
         acc[chain] = {
@@ -17,17 +250,41 @@ export function buildTestConfig(overrides = {}, chains = ['chain1']) {
         };
         return acc;
     }, {});
+    // Build the default strategy config
+    const defaultStrategyConfig = {
+        rebalanceStrategy: RebalancerStrategyOptions.Weighted,
+        chains: baseChains,
+    };
+    // If overrides has strategyConfig as an array, use it directly
+    // Otherwise, wrap single strategy in an array
+    let strategyConfig;
+    if (overrides.strategyConfig) {
+        if (Array.isArray(overrides.strategyConfig)) {
+            strategyConfig = overrides.strategyConfig;
+        }
+        else {
+            // Single strategy override - use it directly wrapped in array
+            // If chains is explicitly provided, use it (don't merge with baseChains)
+            const singleConfig = overrides.strategyConfig;
+            strategyConfig = [
+                {
+                    ...singleConfig,
+                    chains: singleConfig.chains !== undefined
+                        ? singleConfig.chains
+                        : baseChains,
+                },
+            ];
+        }
+    }
+    else {
+        strategyConfig = [defaultStrategyConfig];
+    }
+    // Destructure to exclude strategyConfig from overrides spread
+    const { strategyConfig: _, ...restOverrides } = overrides;
     return {
         warpRouteId: 'test-route',
-        strategyConfig: {
-            rebalanceStrategy: RebalancerStrategyOptions.Weighted,
-            chains: {
-                ...baseChains,
-                ...(overrides.strategyConfig?.chains ?? {}),
-            },
-            ...overrides.strategyConfig,
-        },
-        ...overrides,
+        ...restOverrides,
+        strategyConfig,
     };
 }
 //# sourceMappingURL=helpers.js.map

package/dist/test/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/test/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAI/D,MAAM,OAAO,cAAc;IACzB,SAAS,CAAC,OAA2B;QACnC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAC7B,YAAuC,EAAE,EACzC,SAAmB,CAAC,QAAQ,CAAC;IAE7B,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAC9B,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACZ,GAAW,CAAC,KAAK,CAAC,GAAG;YACpB,cAAc,EAAE,EAAE,GAAG,IAAI;YACzB,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW;YACpC,QAAQ,EAAE;gBACR,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;gBACjB,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;aACrB;SACF,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAAyB,CAC1B,CAAC;IAEF,OAAO;QACL,WAAW,EAAE,YAAY;QACzB,cAAc,EAAE;YACd,iBAAiB,EAAE,yBAAyB,CAAC,QAAQ;YACrD,MAAM,EAAE;gBACN,GAAG,UAAU;gBACb,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,IAAI,EAAE,CAAC;aAC5C;YACD,GAAG,SAAS,CAAC,cAAc;SAC5B;QACD,GAAG,SAAS;KACc,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/test/helpers.ts"],"names":[],"mappings":"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"}

package/dist/tracking/ActionTracker.d.ts

@@ -0,0 +1,49 @@
+import type { Logger } from 'pino';
+import type { HyperlaneCore } from '@hyperlane-xyz/sdk';
+import type { Address, Domain } from '@hyperlane-xyz/utils';
+import type { ConfirmedBlockTags } from '../interfaces/IMonitor.js';
+import type { ExplorerClient } from '../utils/ExplorerClient.js';
+import type { CreateRebalanceActionParams, CreateRebalanceIntentParams, IActionTracker } from './IActionTracker.js';
+import type { IRebalanceActionStore, IRebalanceIntentStore, ITransferStore, RebalanceAction, RebalanceIntent, Transfer } from './types.js';
+export interface ActionTrackerConfig {
+    routersByDomain: Record<number, string>;
+    bridges: Address[];
+    rebalancerAddress: Address;
+}
+/**
+ * ActionTracker implementation managing the lifecycle of tracked entities.
+ */
+export declare class ActionTracker implements IActionTracker {
+    private readonly transferStore;
+    private readonly rebalanceIntentStore;
+    private readonly rebalanceActionStore;
+    private readonly explorerClient;
+    private readonly core;
+    private readonly config;
+    private readonly logger;
+    constructor(transferStore: ITransferStore, rebalanceIntentStore: IRebalanceIntentStore, rebalanceActionStore: IRebalanceActionStore, explorerClient: ExplorerClient, core: HyperlaneCore, config: ActionTrackerConfig, logger: Logger);
+    initialize(): Promise<void>;
+    syncTransfers(confirmedBlockTags?: ConfirmedBlockTags): Promise<void>;
+    syncRebalanceIntents(): Promise<void>;
+    syncRebalanceActions(confirmedBlockTags?: ConfirmedBlockTags): Promise<void>;
+    getInProgressTransfers(): Promise<Transfer[]>;
+    getTransfersByDestination(destination: Domain): Promise<Transfer[]>;
+    getActiveRebalanceIntents(): Promise<RebalanceIntent[]>;
+    getRebalanceIntentsByDestination(destination: Domain): Promise<RebalanceIntent[]>;
+    createRebalanceIntent(params: CreateRebalanceIntentParams): Promise<RebalanceIntent>;
+    completeRebalanceIntent(id: string): Promise<void>;
+    cancelRebalanceIntent(id: string): Promise<void>;
+    failRebalanceIntent(id: string): Promise<void>;
+    createRebalanceAction(params: CreateRebalanceActionParams): Promise<RebalanceAction>;
+    completeRebalanceAction(id: string): Promise<void>;
+    failRebalanceAction(id: string): Promise<void>;
+    /**
+     * Log the contents of all stores.
+     * Logs each item separately for full visibility (avoids [Object] truncation).
+     */
+    logStoreContents(): Promise<void>;
+    private getConfirmedBlockTag;
+    private isMessageDelivered;
+    private recoverAction;
+}
+//# sourceMappingURL=ActionTracker.d.ts.map

package/dist/tracking/ActionTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionTracker.d.ts","sourceRoot":"","sources":["../../src/tracking/ActionTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,eAAe,EACf,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAEhD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBANN,aAAa,EAAE,cAAc,EAC7B,oBAAoB,EAAE,qBAAqB,EAC3C,oBAAoB,EAAE,qBAAqB,EAC3C,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,MAAM;IAK3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+C3B,aAAa,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuGrE,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBrC,oBAAoB,CACxB,kBAAkB,CAAC,EAAE,kBAAkB,GACtC,OAAO,CAAC,IAAI,CAAC;IA4EV,sBAAsB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI7C,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAMnE,yBAAyB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAMvD,gCAAgC,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,EAAE,CAAC;IAMvB,qBAAqB,CACzB,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,eAAe,CAAC;IAwBrB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,qBAAqB,CACzB,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,eAAe,CAAC;IAoCrB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BlD,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;YAwEzB,oBAAoB;YAuBpB,kBAAkB;YA4BlB,aAAa;CA8E5B"}