@humanode-hyperlane/rebalancer 0.0.0-stage → 27.2.2-humanode.1

package/dist/test/helpers.js

@@ -0,0 +1,311 @@
+import { ethers } from 'ethers';
+import Sinon from 'sinon';
+import { EvmMovableCollateralAdapter, } from '@humanode-hyperlane/sdk';
+import { RebalancerStrategyOptions } from '../config/types.js';
+// === Mock Classes ===
+export class MockRebalancer {
+    rebalancerType = 'movableCollateral';
+    rebalance(_routes) {
+        return Promise.resolve([]);
+    }
+}
+// === Test Data Builders ===
+export function buildTestRoute(overrides = {}, executionType = 'movableCollateral') {
+    if (executionType === 'inventory') {
+        return {
+            origin: 'ethereum',
+            destination: 'arbitrum',
+            amount: ethers.utils.parseEther('100').toBigInt(),
+            executionType: 'inventory',
+            externalBridge: 'lifi',
+            ...overrides,
+        };
+    }
+    return {
+        origin: 'ethereum',
+        destination: 'arbitrum',
+        amount: ethers.utils.parseEther('100').toBigInt(),
+        executionType: 'movableCollateral',
+        bridge: TEST_ADDRESSES.bridge,
+        ...overrides,
+    };
+}
+export function buildTestMovableCollateralRoute(overrides = {}) {
+    return {
+        origin: 'ethereum',
+        destination: 'arbitrum',
+        amount: ethers.utils.parseEther('100').toBigInt(),
+        executionType: 'movableCollateral',
+        bridge: TEST_ADDRESSES.bridge,
+        ...overrides,
+    };
+}
+export function buildTestResult(overrides = {}) {
+    const route = overrides.route ?? buildTestMovableCollateralRoute();
+    return {
+        route,
+        success: true,
+        messageId: '0x1111111111111111111111111111111111111111111111111111111111111111',
+        txHash: '0x2222222222222222222222222222222222222222222222222222222222222222',
+        ...overrides,
+    };
+}
+export function buildTestPreparedTransaction(overrides = {}) {
+    const route = overrides.route ??
+        {
+            ...buildTestMovableCollateralRoute(),
+            intentId: 'test-intent',
+        };
+    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, estimateBlockTime: 1 },
+        },
+    };
+    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] = {
+            executionType: 'movableCollateral',
+            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] = {
+            executionType: 'movableCollateral',
+            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] = {
+            bridgeLockTime: 60 * 1000,
+            bridge: ethers.constants.AddressZero,
+            weighted: {
+                weight: BigInt(1),
+                tolerance: BigInt(0),
+            },
+        };
+        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',
+        ...restOverrides,
+        strategyConfig,
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/test/helpers.js.map

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

package/dist/test/lifiMocks.d.ts

@@ -0,0 +1,52 @@
+import Sinon, { type SinonStub } from 'sinon';
+import type { BridgeQuote, BridgeTransferStatus } from '../interfaces/IExternalBridge.js';
+/**
+ * Create mock functions for LiFi SDK.
+ */
+export declare function createLiFiSdkMocks(): {
+    createConfig: Sinon.SinonStub<any[], any>;
+    getQuote: Sinon.SinonStub<any[], any>;
+    executeRoute: Sinon.SinonStub<any[], any>;
+    getStatus: Sinon.SinonStub<any[], any>;
+    convertQuoteToRoute: Sinon.SinonStub<any[], any>;
+};
+/**
+ * Configure a mock getQuote to return a successful quote.
+ */
+export declare function mockSuccessfulQuote(stub: SinonStub, overrides?: Partial<{
+    id: string;
+    tool: string;
+    fromAmount: string;
+    toAmount: string;
+    toAmountMin: string;
+    executionDuration: number;
+    fromChainId: number;
+    toChainId: number;
+}>): void;
+/**
+ * Configure a mock executeRoute to return a successful execution.
+ */
+export declare function mockSuccessfulExecution(stub: SinonStub, txHash: string): void;
+/**
+ * Configure a mock getStatus to return a specific status.
+ */
+export declare function mockLiFiStatus(stub: SinonStub, status: 'DONE' | 'PENDING' | 'FAILED' | 'NOT_FOUND', overrides?: Partial<{
+    receivingTxHash: string;
+    amount: string;
+    substatus: string;
+}>): void;
+/**
+ * Create a mock BridgeQuote for testing.
+ * The route structure includes all fields read by validateRouteAgainstRequest.
+ */
+export declare function createMockBridgeQuote(overrides?: Partial<BridgeQuote>): BridgeQuote;
+/**
+ * Create a mock BridgeTransferStatus for testing.
+ */
+export declare function createMockBridgeStatus(status: 'pending' | 'complete' | 'failed' | 'not_found', overrides?: Partial<{
+    substatus: string;
+    receivingTxHash: string;
+    receivedAmount: bigint;
+    error: string;
+}>): BridgeTransferStatus;
+//# sourceMappingURL=lifiMocks.d.ts.map

package/dist/test/lifiMocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifiMocks.d.ts","sourceRoot":"","sources":["../../src/test/lifiMocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,KAAK,EACV,WAAW,EAEX,oBAAoB,EACrB,MAAM,kCAAkC,CAAC;AAE1C;;GAEG;AACH,wBAAgB,kBAAkB;;;;;;EAkBjC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,SAAS,CAAC,EAAE,OAAO,CAAC;IAClB,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,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,QAsBH;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,QAUtE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,EACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,QAwBH;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC/B,WAAW,CAkDb;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,EACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,GACD,oBAAoB,CAqBtB"}

package/dist/test/lifiMocks.js

@@ -0,0 +1,160 @@
+import Sinon from 'sinon';
+/**
+ * Create mock functions for LiFi SDK.
+ */
+export function createLiFiSdkMocks() {
+    return {
+        createConfig: Sinon.stub(),
+        getQuote: Sinon.stub(),
+        executeRoute: Sinon.stub(),
+        getStatus: Sinon.stub(),
+        convertQuoteToRoute: Sinon.stub().callsFake((quote) => {
+            const q = quote;
+            return {
+                ...q,
+                fromChainId: q.action?.fromChainId ?? 42161,
+                toChainId: q.action?.toChainId ?? 1151111081099710,
+                steps: [],
+            };
+        }),
+    };
+}
+/**
+ * Configure a mock getQuote to return a successful quote.
+ */
+export function mockSuccessfulQuote(stub, overrides) {
+    const fromChainId = overrides?.fromChainId ?? 42161;
+    const toChainId = overrides?.toChainId ?? 1151111081099710;
+    const fromAmount = overrides?.fromAmount ?? '10000000000';
+    const toAmount = overrides?.toAmount ?? '9950000000';
+    const toAmountMin = overrides?.toAmountMin ?? '9900000000';
+    stub.resolves({
+        id: overrides?.id ?? 'quote-123',
+        tool: overrides?.tool ?? 'across',
+        action: {
+            fromAmount,
+            fromChainId,
+            toChainId,
+        },
+        estimate: {
+            toAmount,
+            toAmountMin,
+            executionDuration: overrides?.executionDuration ?? 300,
+        },
+    });
+}
+/**
+ * Configure a mock executeRoute to return a successful execution.
+ */
+export function mockSuccessfulExecution(stub, txHash) {
+    stub.resolves({
+        steps: [
+            {
+                execution: {
+                    process: [{ txHash }],
+                },
+            },
+        ],
+    });
+}
+/**
+ * Configure a mock getStatus to return a specific status.
+ */
+export function mockLiFiStatus(stub, status, overrides) {
+    const responses = {
+        DONE: {
+            status: 'DONE',
+            receiving: {
+                txHash: overrides?.receivingTxHash ?? '0xReceivingTxHash',
+                amount: overrides?.amount ?? '9950000000',
+            },
+        },
+        PENDING: {
+            status: 'PENDING',
+            substatus: overrides?.substatus ?? 'WAIT_SOURCE_CONFIRMATIONS',
+        },
+        FAILED: {
+            status: 'FAILED',
+            substatus: overrides?.substatus ?? 'BRIDGE_CALL_FAILED',
+        },
+        NOT_FOUND: {
+            status: 'NOT_FOUND',
+        },
+    };
+    stub.resolves(responses[status]);
+}
+/**
+ * Create a mock BridgeQuote for testing.
+ * The route structure includes all fields read by validateRouteAgainstRequest.
+ */
+export function createMockBridgeQuote(overrides) {
+    const route = overrides?.route;
+    const defaultRequestParams = {
+        fromChain: 42161,
+        toChain: 1399811149,
+        fromToken: '0xCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC',
+        toToken: '0xCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC',
+        fromAddress: '0xAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+        toAddress: '0xAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+        fromAmount: 10000000000n,
+    };
+    const requestParams = {
+        ...defaultRequestParams,
+        ...overrides?.requestParams,
+    };
+    const fromChainId = route?.action?.fromChainId ?? requestParams.fromChain;
+    const toChainId = route?.action?.toChainId ?? requestParams.toChain;
+    const fromAmount = overrides?.fromAmount ?? requestParams.fromAmount ?? 10000000000n;
+    const toAmount = overrides?.toAmount ?? 9950000000n;
+    const toAmountMin = overrides?.toAmountMin ?? 9900000000n;
+    return {
+        id: 'quote-123',
+        tool: 'across',
+        fromAmount,
+        toAmount,
+        toAmountMin,
+        executionDuration: 300,
+        gasCosts: 50000000n,
+        feeCosts: 0n,
+        // Route includes all fields read by validateRouteAgainstRequest for validation compatibility
+        route: {
+            action: { fromChainId, toChainId },
+            fromChainId,
+            toChainId,
+            fromToken: { address: requestParams.fromToken },
+            toToken: { address: requestParams.toToken },
+            fromAddress: requestParams.fromAddress,
+            toAddress: requestParams.toAddress ?? requestParams.fromAddress,
+            fromAmount: fromAmount.toString(),
+            toAmount: toAmount.toString(),
+        },
+        requestParams,
+        ...overrides,
+    };
+}
+/**
+ * Create a mock BridgeTransferStatus for testing.
+ */
+export function createMockBridgeStatus(status, overrides) {
+    switch (status) {
+        case 'pending':
+            return {
+                status: 'pending',
+                substatus: overrides?.substatus,
+            };
+        case 'complete':
+            return {
+                status: 'complete',
+                receivingTxHash: overrides?.receivingTxHash ?? '0xReceivingTxHash',
+                receivedAmount: overrides?.receivedAmount ?? 9950000000n,
+            };
+        case 'failed':
+            return {
+                status: 'failed',
+                error: overrides?.error,
+            };
+        case 'not_found':
+            return { status: 'not_found' };
+    }
+}
+//# sourceMappingURL=lifiMocks.js.map

package/dist/test/lifiMocks.js.map

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

package/dist/tracking/ActionTracker.d.ts

@@ -0,0 +1,90 @@
+import type { Logger } from 'pino';
+import type { MultiProtocolCore } from '@humanode-hyperlane/sdk';
+import type { Address, Domain } from '@humanode-hyperlane/utils';
+import type { ExternalBridgeRegistry } from '../interfaces/IExternalBridge.js';
+import type { ConfirmedBlockTags } from '../interfaces/IMonitor.js';
+import type { IExplorerClient } from '../utils/ExplorerClient.js';
+import type { CreateRebalanceActionParams, CreateRebalanceIntentParams, IActionTracker } from './IActionTracker.js';
+import type { ActionType, IRebalanceActionStore, IRebalanceIntentStore, ITransferStore, PartialInventoryIntent, RebalanceAction, RebalanceIntent, Transfer } from './types.js';
+export interface ActionTrackerConfig {
+    routersByDomain: Record<number, string>;
+    bridges: Address[];
+    rebalancerAddress: Address;
+    inventorySignerAddresses?: Address[];
+    intentTTL: number;
+}
+/**
+ * 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: IExplorerClient, core: MultiProtocolCore, config: ActionTrackerConfig, logger: Logger);
+    initialize(): Promise<void>;
+    syncTransfers(confirmedBlockTags?: ConfirmedBlockTags): Promise<void>;
+    syncRebalanceIntents(): Promise<void>;
+    syncRebalanceActions(confirmedBlockTags?: ConfirmedBlockTags): Promise<void>;
+    getTransfer(id: string): Promise<Transfer | undefined>;
+    getInProgressTransfers(): Promise<Transfer[]>;
+    getTransfersByDestination(destination: Domain): Promise<Transfer[]>;
+    getRebalanceIntent(id: string): Promise<RebalanceIntent | undefined>;
+    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>;
+    getRebalanceAction(id: string): Promise<RebalanceAction | undefined>;
+    getInProgressActions(): Promise<RebalanceAction[]>;
+    createRebalanceAction(params: CreateRebalanceActionParams): Promise<RebalanceAction>;
+    completeRebalanceAction(id: string): Promise<void>;
+    /**
+     * Check if an intent is fully fulfilled based on completed action amounts.
+     * Only `inventory_deposit` and `rebalance_message` actions count toward fulfillment.
+     */
+    private checkAndCompleteIntent;
+    /**
+     * Get the total completed amount for an intent from its actions.
+     * Only `inventory_deposit` and `rebalance_message` actions count.
+     */
+    private getCompletedAmountForIntent;
+    failRebalanceAction(id: string): Promise<void>;
+    getActionsByType(type: ActionType): Promise<RebalanceAction[]>;
+    getInflightInventoryMovements(origin: Domain): Promise<bigint>;
+    /**
+     * Get inventory intents that are in_progress or not_started but not fully settled.
+     * Intents with in-flight deposits are included but flagged via hasInflightDeposit.
+     * Returns enriched data with computed values derived from action states.
+     *
+     * NOTE: We include 'not_started' intents because they may have been created
+     * but failed to execute (e.g., all bridges failed viability check). Without
+     * checking for these, we would create duplicate intents every polling cycle.
+     */
+    getPartiallyFulfilledInventoryIntents(): Promise<PartialInventoryIntent[]>;
+    /**
+     * Get all actions associated with a specific intent.
+     */
+    getActionsForIntent(intentId: string): Promise<RebalanceAction[]>;
+    syncInventoryMovementActions(externalBridgeRegistry: Partial<ExternalBridgeRegistry>): Promise<{
+        completed: number;
+        failed: number;
+    }>;
+    /**
+     * Log the contents of all stores.
+     * Logs each item separately for full visibility (avoids [Object] truncation).
+     */
+    logStoreContents(): Promise<void>;
+    /**
+     * Get the confirmed block tag for delivery checks.
+     * Uses cached value from Monitor event if available, otherwise computes on-demand.
+     */
+    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":"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"}