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

package/dist/utils/balanceUtils.js

@@ -0,0 +1,40 @@
+import { isCollateralizedTokenEligibleForRebalancing } from './tokenUtils.js';
+/**
+ * Returns the raw balances required by the strategies from the monitor event
+ * @param chains - The chains that should be included in the raw balances (e.g. the chains in the rebalancer config)
+ * @param event - The monitor event to extract the raw balances from
+ * @returns An object mapping chain names to their raw balances.
+ */
+export function getRawBalances(chains, event, logger) {
+    const balances = {};
+    const chainSet = new Set(chains);
+    for (const tokenInfo of event.tokensInfo) {
+        const { token, bridgedSupply } = tokenInfo;
+        // Ignore tokens that are not in the provided chains list
+        if (!chainSet.has(token.chainName)) {
+            logger.debug({
+                context: getRawBalances.name,
+                chain: token.chainName,
+                tokenSymbol: token.symbol,
+                tokenAddress: token.addressOrDenom,
+            }, 'Skipping token: not in configured chains list');
+            continue;
+        }
+        // Ignore tokens that are not collateralized or are otherwise ineligible
+        if (!isCollateralizedTokenEligibleForRebalancing(token)) {
+            logger.debug({
+                context: getRawBalances.name,
+                chain: token.chainName,
+                tokenSymbol: token.symbol,
+                tokenAddress: token.addressOrDenom,
+            }, 'Skipping token: not collateralized or ineligible for rebalancing');
+            continue;
+        }
+        if (bridgedSupply === undefined) {
+            throw new Error(`bridgedSupply should not be undefined for collateralized token ${token.addressOrDenom}`);
+        }
+        balances[token.chainName] = bridgedSupply;
+    }
+    return balances;
+}
+//# sourceMappingURL=balanceUtils.js.map

package/dist/utils/balanceUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balanceUtils.js","sourceRoot":"","sources":["../../src/utils/balanceUtils.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,2CAA2C,EAAE,MAAM,iBAAiB,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,KAAmB,EACnB,MAAc;IAEd,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAEjC,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;QAE3C,yDAAyD;QACzD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,KAAK,CACV;gBACE,OAAO,EAAE,cAAc,CAAC,IAAI;gBAC5B,KAAK,EAAE,KAAK,CAAC,SAAS;gBACtB,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,YAAY,EAAE,KAAK,CAAC,cAAc;aACnC,EACD,+CAA+C,CAChD,CAAC;YACF,SAAS;QACX,CAAC;QAED,wEAAwE;QACxE,IAAI,CAAC,2CAA2C,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,CAAC,KAAK,CACV;gBACE,OAAO,EAAE,cAAc,CAAC,IAAI;gBAC5B,KAAK,EAAE,KAAK,CAAC,SAAS;gBACtB,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,YAAY,EAAE,KAAK,CAAC,cAAc;aACnC,EACD,kEAAkE,CACnE,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,kEAAkE,KAAK,CAAC,cAAc,EAAE,CACzF,CAAC;QACJ,CAAC;QAED,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC;IAC5C,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/balanceUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=balanceUtils.test.d.ts.map

package/dist/utils/balanceUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balanceUtils.test.d.ts","sourceRoot":"","sources":["../../src/utils/balanceUtils.test.ts"],"names":[],"mappings":""}

package/dist/utils/balanceUtils.test.js

@@ -0,0 +1,55 @@
+import { expect } from 'chai';
+import { pino } from 'pino';
+import sinon from 'sinon';
+import { TokenStandard, } from '@humanode-hyperlane/sdk';
+import { getRawBalances } from './balanceUtils.js';
+const testLogger = pino({ level: 'silent' });
+describe('getRawBalances', () => {
+    let chains;
+    let token;
+    let tokenBridgedSupply;
+    let event;
+    beforeEach(() => {
+        chains = ['mainnet'];
+        token = {
+            chainName: 'mainnet',
+            addressOrDenom: '0xAddress',
+            isCollateralized: sinon.stub().returns(true),
+            standard: TokenStandard.EvmHypCollateral,
+        };
+        tokenBridgedSupply = 100n;
+        event = {
+            tokensInfo: [
+                {
+                    token,
+                    bridgedSupply: tokenBridgedSupply,
+                },
+            ],
+            confirmedBlockTags: { mainnet: 1000 },
+        };
+    });
+    it('should return the bridged supply for the token (EvmHypCollateral)', () => {
+        expect(getRawBalances(chains, event, testLogger)).to.deep.equal({
+            mainnet: tokenBridgedSupply,
+        });
+    });
+    it('should return the bridged supply for the token (EvmHypNative)', () => {
+        token.standard = TokenStandard.EvmHypNative;
+        expect(getRawBalances(chains, event, testLogger)).to.deep.equal({
+            mainnet: tokenBridgedSupply,
+        });
+    });
+    it('should ignore non supported token standards', () => {
+        token.standard = TokenStandard.EvmHypOwnerCollateral;
+        expect(getRawBalances(chains, event, testLogger)).to.deep.equal({});
+    });
+    it('should ignore tokens that are not in the chains list', () => {
+        chains = [];
+        expect(getRawBalances(chains, event, testLogger)).to.deep.equal({});
+    });
+    it('should throw if the bridged supply is undefined', () => {
+        delete event.tokensInfo[0].bridgedSupply;
+        expect(() => getRawBalances(chains, event, testLogger)).to.throw('bridgedSupply should not be undefined for collateralized token 0xAddress');
+    });
+});
+//# sourceMappingURL=balanceUtils.test.js.map

package/dist/utils/balanceUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balanceUtils.test.js","sourceRoot":"","sources":["../../src/utils/balanceUtils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAGL,aAAa,GACd,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE7C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,MAAmB,CAAC;IACxB,IAAI,KAAY,CAAC;IACjB,IAAI,kBAA0B,CAAC;IAC/B,IAAI,KAAmB,CAAC;IAExB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC;QAErB,KAAK,GAAG;YACN,SAAS,EAAE,SAAS;YACpB,cAAc,EAAE,WAAW;YAC3B,gBAAgB,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;YAC5C,QAAQ,EAAE,aAAa,CAAC,gBAAgB;SACrB,CAAC;QAEtB,kBAAkB,GAAG,IAAI,CAAC;QAE1B,KAAK,GAAG;YACN,UAAU,EAAE;gBACV;oBACE,KAAK;oBACL,aAAa,EAAE,kBAAkB;iBAClC;aACF;YACD,kBAAkB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;SACtC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;YAC9D,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,KAAK,CAAC,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC;QAE5C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;YAC9D,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,KAAK,CAAC,QAAQ,GAAG,aAAa,CAAC,qBAAqB,CAAC;QAErD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,GAAG,EAAE,CAAC;QAEZ,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,OAAO,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QAEzC,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAC9D,0EAA0E,CAC3E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/blockTag.d.ts

@@ -0,0 +1,14 @@
+import type { Logger } from 'pino';
+import { MultiProtocolProvider } from '@humanode-hyperlane/sdk';
+import type { ConfirmedBlockTag } from '../interfaces/IMonitor.js';
+/**
+ * Get the confirmed block tag for a chain, accounting for reorg period.
+ * Returns a block number that is safe from reorgs, or a named tag like 'finalized'.
+ *
+ * @param multiProvider - MultiProtocolProvider instance
+ * @param chainName - Name of the chain
+ * @param logger - Optional logger for warnings
+ * @returns Confirmed block tag (number, named tag, or undefined on error)
+ */
+export declare function getConfirmedBlockTag(multiProvider: MultiProtocolProvider, chainName: string, logger?: Logger): Promise<ConfirmedBlockTag>;
+//# sourceMappingURL=blockTag.d.ts.map

package/dist/utils/blockTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockTag.d.ts","sourceRoot":"","sources":["../../src/utils/blockTag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAInC,OAAO,EAEL,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,qBAAqB,EACpC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CA2C5B"}

package/dist/utils/blockTag.js

@@ -0,0 +1,46 @@
+import { providers } from 'ethers';
+import { ProtocolType } from '@humanode-hyperlane/utils';
+/**
+ * Get the confirmed block tag for a chain, accounting for reorg period.
+ * Returns a block number that is safe from reorgs, or a named tag like 'finalized'.
+ *
+ * @param multiProvider - MultiProtocolProvider instance
+ * @param chainName - Name of the chain
+ * @param logger - Optional logger for warnings
+ * @returns Confirmed block tag (number, named tag, or undefined on error)
+ */
+export async function getConfirmedBlockTag(multiProvider, chainName, logger) {
+    try {
+        const metadata = multiProvider.getChainMetadata(chainName);
+        // Only EVM chains support block tag queries
+        if (metadata.protocol !== ProtocolType.Ethereum) {
+            return undefined;
+        }
+        const reorgPeriod = metadata.blocks?.reorgPeriod ?? 32;
+        if (typeof reorgPeriod === 'string') {
+            return reorgPeriod;
+        }
+        const provider = multiProvider.getEthersV5Provider(chainName);
+        let latestBlock;
+        if (provider instanceof providers.JsonRpcProvider) {
+            const latestBlockHex = await provider.send('eth_blockNumber', []);
+            if (typeof latestBlockHex !== 'string' ||
+                !/^0x[0-9a-fA-F]+$/.test(latestBlockHex)) {
+                throw new Error(`Invalid eth_blockNumber response for ${chainName}: ${latestBlockHex}`);
+            }
+            latestBlock = parseInt(latestBlockHex, 16);
+            if (!Number.isFinite(latestBlock)) {
+                throw new Error(`Parsed block number is not finite for ${chainName}: ${latestBlockHex}`);
+            }
+        }
+        else {
+            latestBlock = await provider.getBlockNumber();
+        }
+        return Math.max(0, latestBlock - reorgPeriod);
+    }
+    catch (error) {
+        logger?.warn({ chain: chainName, error: error.message }, 'Failed to get confirmed block, using latest');
+        return undefined;
+    }
+}
+//# sourceMappingURL=blockTag.js.map

package/dist/utils/blockTag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockTag.js","sourceRoot":"","sources":["../../src/utils/blockTag.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,aAAoC,EACpC,SAAiB,EACjB,MAAe;IAEf,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,aAAa,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAE3D,4CAA4C;QAC5C,IAAI,QAAQ,CAAC,QAAQ,KAAK,YAAY,CAAC,QAAQ,EAAE,CAAC;YAChD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC;QACvD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO,WAA0C,CAAC;QACpD,CAAC;QAED,MAAM,QAAQ,GAAG,aAAa,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,WAAmB,CAAC;QACxB,IAAI,QAAQ,YAAY,SAAS,CAAC,eAAe,EAAE,CAAC;YAClD,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YAClE,IACE,OAAO,cAAc,KAAK,QAAQ;gBAClC,CAAC,kBAAkB,CAAC,IAAI,CAAC,cAAc,CAAC,EACxC,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,wCAAwC,SAAS,KAAK,cAAc,EAAE,CACvE,CAAC;YACJ,CAAC;YACD,WAAW,GAAG,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CACb,yCAAyC,SAAS,KAAK,cAAc,EAAE,CACxE,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,CAAC;QAChD,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,IAAI,CACV,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,EACrD,6CAA6C,CAC9C,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/utils/bridgeUtils.d.ts

@@ -0,0 +1,40 @@
+import type { ChainMap, ChainName } from '@humanode-hyperlane/sdk';
+import type { Address } from '@humanode-hyperlane/utils';
+import type { ExternalBridgeType } from '../config/types.js';
+import type { StrategyRoute } from '../interfaces/IStrategy.js';
+type BaseBridgeConfig = {
+    bridgeMinAcceptedAmount?: string | number;
+};
+export type MovableCollateralBridgeConfig = BaseBridgeConfig & {
+    executionType: 'movableCollateral';
+    bridge: Address;
+};
+export type InventoryBridgeConfig = BaseBridgeConfig & {
+    executionType: 'inventory';
+    externalBridge: ExternalBridgeType;
+};
+export type BridgeConfig = MovableCollateralBridgeConfig | InventoryBridgeConfig;
+export declare function isMovableCollateralConfig(config: BridgeConfig): config is MovableCollateralBridgeConfig;
+export declare function isInventoryConfig(config: BridgeConfig): config is InventoryBridgeConfig;
+export type BridgeConfigWithOverride = BridgeConfig & {
+    override?: ChainMap<Partial<BridgeConfig>>;
+};
+/**
+ * Gets the bridge configuration for a specific chain pair, applying any overrides
+ * @param bridges The map of bridge configurations by chain
+ * @param fromChain The source chain
+ * @param toChain The destination chain
+ * @returns The bridge configuration with any overrides applied
+ */
+export declare function getBridgeConfig(bridges: ChainMap<BridgeConfigWithOverride>, fromChain: ChainName, toChain: ChainName): BridgeConfig;
+/**
+ * Creates a StrategyRoute from a BridgeConfig with exhaustive type checking
+ * @param bridgeConfig The bridge configuration
+ * @param origin The origin chain
+ * @param destination The destination chain
+ * @param amount The amount to transfer
+ * @returns A StrategyRoute with the appropriate execution type
+ */
+export declare function createStrategyRoute(bridgeConfig: BridgeConfig, origin: ChainName, destination: ChainName, amount: bigint): StrategyRoute;
+export {};
+//# sourceMappingURL=bridgeUtils.d.ts.map

package/dist/utils/bridgeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/bridgeUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,KAAK,gBAAgB,GAAG;IACtB,uBAAuB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,gBAAgB,GAAG;IAC7D,aAAa,EAAE,mBAAmB,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG;IACrD,aAAa,EAAE,WAAW,CAAC;IAC3B,cAAc,EAAE,kBAAkB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB,6BAA6B,GAC7B,qBAAqB,CAAC;AAE1B,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,GACnB,MAAM,IAAI,6BAA6B,CAEzC;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,GACnB,MAAM,IAAI,qBAAqB,CAEjC;AAED,MAAM,MAAM,wBAAwB,GAAG,YAAY,GAAG;IACpD,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EAC3C,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,SAAS,GACjB,YAAY,CASd;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,SAAS,EACtB,MAAM,EAAE,MAAM,GACb,aAAa,CAyBf"}

package/dist/utils/bridgeUtils.js

@@ -0,0 +1,54 @@
+export function isMovableCollateralConfig(config) {
+    return config.executionType === 'movableCollateral';
+}
+export function isInventoryConfig(config) {
+    return config.executionType === 'inventory';
+}
+/**
+ * Gets the bridge configuration for a specific chain pair, applying any overrides
+ * @param bridges The map of bridge configurations by chain
+ * @param fromChain The source chain
+ * @param toChain The destination chain
+ * @returns The bridge configuration with any overrides applied
+ */
+export function getBridgeConfig(bridges, fromChain, toChain) {
+    const fromConfig = bridges[fromChain];
+    const routeSpecificOverrides = fromConfig.override?.[toChain];
+    // Create a new object with the properties from bridgeConfig, excluding the overrides property
+    const { override: _, ...baseConfig } = fromConfig;
+    // Return a new object with the base config and any overrides
+    return { ...baseConfig, ...routeSpecificOverrides };
+}
+/**
+ * Creates a StrategyRoute from a BridgeConfig with exhaustive type checking
+ * @param bridgeConfig The bridge configuration
+ * @param origin The origin chain
+ * @param destination The destination chain
+ * @param amount The amount to transfer
+ * @returns A StrategyRoute with the appropriate execution type
+ */
+export function createStrategyRoute(bridgeConfig, origin, destination, amount) {
+    switch (bridgeConfig.executionType) {
+        case 'inventory':
+            return {
+                origin,
+                destination,
+                amount,
+                executionType: 'inventory',
+                externalBridge: bridgeConfig.externalBridge,
+            };
+        case 'movableCollateral':
+            return {
+                origin,
+                destination,
+                amount,
+                executionType: 'movableCollateral',
+                bridge: bridgeConfig.bridge,
+            };
+        default: {
+            const _exhaustive = bridgeConfig;
+            throw new Error(`Unknown execution type: ${_exhaustive.executionType}`);
+        }
+    }
+}
+//# sourceMappingURL=bridgeUtils.js.map

package/dist/utils/bridgeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeUtils.js","sourceRoot":"","sources":["../../src/utils/bridgeUtils.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,yBAAyB,CACvC,MAAoB;IAEpB,OAAO,MAAM,CAAC,aAAa,KAAK,mBAAmB,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAoB;IAEpB,OAAO,MAAM,CAAC,aAAa,KAAK,WAAW,CAAC;AAC9C,CAAC;AAMD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA2C,EAC3C,SAAoB,EACpB,OAAkB;IAElB,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,sBAAsB,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC;IAE9D,8FAA8F;IAC9F,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,UAAU,CAAC;IAElD,6DAA6D;IAC7D,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,sBAAsB,EAAkB,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAA0B,EAC1B,MAAiB,EACjB,WAAsB,EACtB,MAAc;IAEd,QAAQ,YAAY,CAAC,aAAa,EAAE,CAAC;QACnC,KAAK,WAAW;YACd,OAAO;gBACL,MAAM;gBACN,WAAW;gBACX,MAAM;gBACN,aAAa,EAAE,WAAW;gBAC1B,cAAc,EAAE,YAAY,CAAC,cAAc;aAC5C,CAAC;QACJ,KAAK,mBAAmB;YACtB,OAAO;gBACL,MAAM;gBACN,WAAW;gBACX,MAAM;gBACN,aAAa,EAAE,mBAAmB;gBAClC,MAAM,EAAE,YAAY,CAAC,MAAM;aAC5B,CAAC;QACJ,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,YAAY,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,2BAA4B,WAA4B,CAAC,aAAa,EAAE,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/bridgeUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bridgeUtils.test.d.ts.map

package/dist/utils/bridgeUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeUtils.test.d.ts","sourceRoot":"","sources":["../../src/utils/bridgeUtils.test.ts"],"names":[],"mappings":""}

package/dist/utils/bridgeUtils.test.js

@@ -0,0 +1,163 @@
+import assert from 'node:assert';
+import { expect } from 'chai';
+import { ExecutionType, ExternalBridgeType } from '../config/types.js';
+import { getBridgeConfig, isInventoryConfig, isMovableCollateralConfig, } from './bridgeUtils.js';
+describe('bridgeConfig', () => {
+    it('should return the base bridge config when no overrides exist', () => {
+        const bridges = {
+            chain1: {
+                executionType: 'movableCollateral',
+                bridge: '0x1234567890123456789012345678901234567890',
+                bridgeMinAcceptedAmount: 1000,
+            },
+            chain2: {
+                executionType: 'movableCollateral',
+                bridge: '0x0987654321098765432109876543210987654321',
+                bridgeMinAcceptedAmount: 2000,
+            },
+        };
+        const result = getBridgeConfig(bridges, 'chain1', 'chain2');
+        expect(result).to.deep.equal({
+            executionType: 'movableCollateral',
+            bridge: '0x1234567890123456789012345678901234567890',
+            bridgeMinAcceptedAmount: 1000,
+        });
+    });
+    it('should merge base config with overrides when they exist', () => {
+        const bridges = {
+            chain1: {
+                executionType: 'movableCollateral',
+                bridge: '0x1234567890123456789012345678901234567890',
+                bridgeMinAcceptedAmount: 1000,
+                override: {
+                    chain2: {
+                        bridgeMinAcceptedAmount: 5000,
+                    },
+                },
+            },
+            chain2: {
+                executionType: 'movableCollateral',
+                bridge: '0x0987654321098765432109876543210987654321',
+                bridgeMinAcceptedAmount: 2000,
+            },
+        };
+        const result = getBridgeConfig(bridges, 'chain1', 'chain2');
+        expect(result).to.deep.equal({
+            executionType: 'movableCollateral',
+            bridge: '0x1234567890123456789012345678901234567890',
+            bridgeMinAcceptedAmount: 5000,
+        });
+    });
+    it('should handle overrides that change the bridge address', () => {
+        const bridges = {
+            chain1: {
+                executionType: 'movableCollateral',
+                bridge: '0x1234567890123456789012345678901234567890',
+                bridgeMinAcceptedAmount: 1000,
+                override: {
+                    chain2: {
+                        bridge: '0xABCDEF0123456789ABCDEF0123456789ABCDEF01',
+                    },
+                },
+            },
+            chain2: {
+                executionType: 'movableCollateral',
+                bridge: '0x0987654321098765432109876543210987654321',
+                bridgeMinAcceptedAmount: 2000,
+            },
+        };
+        const result = getBridgeConfig(bridges, 'chain1', 'chain2');
+        expect(result).to.deep.equal({
+            executionType: 'movableCollateral',
+            bridge: '0xABCDEF0123456789ABCDEF0123456789ABCDEF01',
+            bridgeMinAcceptedAmount: 1000,
+        });
+    });
+    it('should apply override with executionType: inventory', () => {
+        const bridges = {
+            chain1: {
+                executionType: ExecutionType.MovableCollateral,
+                bridge: '0x1234567890123456789012345678901234567890',
+                bridgeMinAcceptedAmount: 1000,
+                override: {
+                    chain2: {
+                        executionType: ExecutionType.Inventory,
+                        externalBridge: ExternalBridgeType.LiFi,
+                    },
+                },
+            },
+            chain2: {
+                executionType: ExecutionType.MovableCollateral,
+                bridge: '0x0987654321098765432109876543210987654321',
+                bridgeMinAcceptedAmount: 2000,
+            },
+        };
+        const result = getBridgeConfig(bridges, 'chain1', 'chain2');
+        expect(result.executionType).to.equal(ExecutionType.Inventory);
+        assert(isInventoryConfig(result));
+        expect(result.externalBridge).to.equal(ExternalBridgeType.LiFi);
+        expect(result.bridgeMinAcceptedAmount).to.equal(1000);
+    });
+    it('should apply override with executionType: inventory and externalBridge', () => {
+        const bridges = {
+            chain1: {
+                executionType: ExecutionType.MovableCollateral,
+                bridge: '0x1234567890123456789012345678901234567890',
+                override: {
+                    chain2: {
+                        executionType: ExecutionType.Inventory,
+                        externalBridge: ExternalBridgeType.LiFi,
+                    },
+                },
+            },
+            chain2: {
+                executionType: ExecutionType.MovableCollateral,
+                bridge: '0x0987654321098765432109876543210987654321',
+            },
+        };
+        const result = getBridgeConfig(bridges, 'chain1', 'chain2');
+        expect(result.executionType).to.equal(ExecutionType.Inventory);
+        assert(isInventoryConfig(result));
+        expect(result.externalBridge).to.equal(ExternalBridgeType.LiFi);
+    });
+    it('should allow override to change executionType from movableCollateral to inventory', () => {
+        const bridges = {
+            chain1: {
+                executionType: ExecutionType.MovableCollateral,
+                bridge: '0x1234567890123456789012345678901234567890',
+                override: {
+                    chain2: {
+                        executionType: ExecutionType.Inventory,
+                        externalBridge: ExternalBridgeType.LiFi,
+                    },
+                },
+            },
+            chain2: {
+                executionType: ExecutionType.MovableCollateral,
+                bridge: '0x0987654321098765432109876543210987654321',
+            },
+        };
+        const result = getBridgeConfig(bridges, 'chain1', 'chain2');
+        // Override should win: executionType should be inventory, not movableCollateral
+        expect(result.executionType).to.equal(ExecutionType.Inventory);
+        assert(isInventoryConfig(result));
+        expect(result.externalBridge).to.equal(ExternalBridgeType.LiFi);
+    });
+    it('should preserve base chain executionType when no override exists', () => {
+        const bridges = {
+            chain1: {
+                executionType: ExecutionType.MovableCollateral,
+                bridge: '0x1234567890123456789012345678901234567890',
+            },
+            chain2: {
+                executionType: ExecutionType.MovableCollateral,
+                bridge: '0x0987654321098765432109876543210987654321',
+            },
+        };
+        const result = getBridgeConfig(bridges, 'chain1', 'chain2');
+        expect(result.executionType).to.equal(ExecutionType.MovableCollateral);
+        assert(isMovableCollateralConfig(result));
+        expect(result.bridge).to.equal('0x1234567890123456789012345678901234567890');
+    });
+});
+//# sourceMappingURL=bridgeUtils.test.js.map

package/dist/utils/bridgeUtils.test.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class WrappedError extends Error {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG3C"}

package/dist/utils/errors.js

@@ -0,0 +1,6 @@
+export class WrappedError extends Error {
+    constructor(message, cause) {
+        super(message, cause ? { cause } : undefined);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/utils/gasEstimation.d.ts

@@ -0,0 +1,65 @@
+import type { Logger } from 'pino';
+import { type ChainName, type InterchainGasQuote, type MultiProvider, type Token, TokenStandard } from '@humanode-hyperlane/sdk';
+/**
+ * Fallback gas limit for transferRemote when eth_estimateGas fails.
+ * Conservative estimate for cross-chain token transfers.
+ */
+export declare const FALLBACK_TRANSFER_REMOTE_GAS_LIMIT = 300000n;
+/**
+ * Cost multiplier for minimum viable transfer.
+ * A transfer must be worth at least this multiple of its cost to be worthwhile.
+ */
+export declare const MIN_VIABLE_COST_MULTIPLIER = 2n;
+/**
+ * Transfer cost estimate for native token transfers.
+ * Contains all cost components needed for transfer decisions.
+ */
+export interface TransferCostEstimate {
+    /** IGP cost for the Hyperlane message */
+    igpCost: bigint;
+    /** Estimated gas cost for the transferRemote transaction (with buffer) */
+    gasCost: bigint;
+    /** Token fee cost (native denom only) */
+    tokenFeeCost: bigint;
+    /** Total cost = igpCost + gasCost + tokenFeeCost */
+    totalCost: bigint;
+    /** Maximum transferable amount after reserving costs (availableInventory - totalCost) */
+    maxTransferable: bigint;
+    /** Minimum viable transfer (totalCost * MIN_VIABLE_COST_MULTIPLIER) */
+    minViableTransfer: bigint;
+    /** Gas quote from adapter (for passing to executeTransferRemote) */
+    gasQuote?: InterchainGasQuote;
+}
+/**
+ * Estimate gas for a transferRemote transaction using eth_estimateGas.
+ * Falls back to conservative estimate if estimation fails.
+ *
+ * @param originChain - Chain where transferRemote will be called
+ * @param destinationChain - Chain where the Hyperlane message goes
+ * @param amount - Amount to transfer
+ * @param multiProvider - MultiProvider for chain access
+ * @param warpCoreMultiProvider - MultiProvider from WarpCore for adapter access
+ * @param getTokenForChain - Function to get token for a chain
+ * @param inventorySigner - Address of the inventory signer
+ * @param logger - Logger instance
+ * @returns Estimated gas limit for the transaction
+ */
+export declare function estimateTransferRemoteGas(originChain: ChainName, destinationChain: ChainName, amount: bigint, multiProvider: MultiProvider, warpCoreMultiProvider: any, getTokenForChain: (chain: ChainName) => Token | undefined, inventorySigner: string, logger: Logger): Promise<bigint>;
+/**
+ * Calculate all transfer costs for a transferRemote operation.
+ * Consolidates IGP costs, gas costs, and derived values (max transferable, min viable).
+ *
+ * @param originChain - Chain to transfer from (where transferRemote is called)
+ * @param destinationChain - Chain to transfer to (Hyperlane message destination)
+ * @param availableInventory - Available token balance on origin chain
+ * @param requestedAmount - Requested transfer amount
+ * @param multiProvider - MultiProvider for chain access
+ * @param warpCoreMultiProvider - MultiProvider from WarpCore for adapter access
+ * @param getTokenForChain - Function to get token for a chain
+ * @param inventorySigner - Address of the inventory signer
+ * @param isNativeTokenStandard - Function to check if token standard is native
+ * @param logger - Logger instance
+ * @returns Cost estimate with all components and derived values
+ */
+export declare function calculateTransferCosts(originChain: ChainName, destinationChain: ChainName, availableInventory: bigint, requestedAmount: bigint, multiProvider: MultiProvider, warpCoreMultiProvider: any, getTokenForChain: (chain: ChainName) => Token | undefined, inventorySigner: string, isNativeTokenStandard: (standard: TokenStandard) => boolean, logger: Logger): Promise<TransferCostEstimate>;
+//# sourceMappingURL=gasEstimation.d.ts.map

package/dist/utils/gasEstimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasEstimation.d.ts","sourceRoot":"","sources":["../../src/utils/gasEstimation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,aAAa,EACd,MAAM,yBAAyB,CAAC;AAOjC;;;GAGG;AACH,eAAO,MAAM,kCAAkC,UAAW,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,eAAe,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,SAAS,EACtB,gBAAgB,EAAE,SAAS,EAC3B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,aAAa,EAC5B,qBAAqB,EAAE,GAAG,EAC1B,gBAAgB,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,KAAK,GAAG,SAAS,EACzD,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAoEjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,SAAS,EACtB,gBAAgB,EAAE,SAAS,EAC3B,kBAAkB,EAAE,MAAM,EAC1B,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,aAAa,EAC5B,qBAAqB,EAAE,GAAG,EAC1B,gBAAgB,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,KAAK,GAAG,SAAS,EACzD,eAAe,EAAE,MAAM,EACvB,qBAAqB,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,OAAO,EAC3D,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAuI/B"}