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

package/dist/monitor/Monitor.js

@@ -0,0 +1,211 @@
+import { sleep } from '@humanode-hyperlane/utils';
+import { MonitorEventType, MonitorPollingError, MonitorStartError, } from '../interfaces/IMonitor.js';
+import { getConfirmedBlockTag } from '../utils/blockTag.js';
+/**
+ * Simple monitor implementation that polls warp route collateral balances and emits them as MonitorEvent.
+ * Awaits the TokenInfo handler before starting the next cycle to prevent race conditions.
+ */
+export class Monitor {
+    checkFrequency;
+    warpCore;
+    logger;
+    inventoryConfig;
+    tokenInfoHandler;
+    errorHandler;
+    startHandler;
+    isMonitorRunning = false;
+    resolveStop = null;
+    stopPromise = null;
+    /**
+     * @param checkFrequency - The frequency to poll balances in ms.
+     */
+    constructor(checkFrequency, warpCore, logger, inventoryConfig) {
+        this.checkFrequency = checkFrequency;
+        this.warpCore = warpCore;
+        this.logger = logger;
+        this.inventoryConfig = inventoryConfig;
+    }
+    async computeConfirmedBlockTags() {
+        const blockTags = {};
+        const chains = new Set(this.warpCore.tokens.map((t) => t.chainName));
+        for (const chain of chains) {
+            blockTags[chain] = await getConfirmedBlockTag(this.warpCore.multiProvider, chain, this.logger);
+        }
+        return blockTags;
+    }
+    on(eventName, fn) {
+        switch (eventName) {
+            case MonitorEventType.TokenInfo:
+                this.tokenInfoHandler = fn;
+                break;
+            case MonitorEventType.Error:
+                this.errorHandler = fn;
+                break;
+            case MonitorEventType.Start:
+                this.startHandler = fn;
+                break;
+        }
+        return this;
+    }
+    async start() {
+        if (this.isMonitorRunning) {
+            // Cannot start the same monitor multiple times
+            this.errorHandler?.(new MonitorStartError('Monitor already running'));
+            return;
+        }
+        try {
+            this.isMonitorRunning = true;
+            this.logger.debug({ checkFrequency: this.checkFrequency }, 'Monitor started');
+            this.startHandler?.();
+            while (this.isMonitorRunning) {
+                const cycleStart = Date.now();
+                try {
+                    this.logger.debug('Polling cycle started');
+                    const confirmedBlockTags = await this.computeConfirmedBlockTags();
+                    const event = {
+                        tokensInfo: [],
+                        confirmedBlockTags,
+                    };
+                    for (const token of this.warpCore.tokens) {
+                        this.logger.debug({
+                            chain: token.chainName,
+                            tokenSymbol: token.symbol,
+                            tokenAddress: token.addressOrDenom,
+                        }, 'Checking token');
+                        const blockTag = confirmedBlockTags[token.chainName];
+                        const bridgedSupply = await this.getTokenBridgedSupply(token, blockTag);
+                        event.tokensInfo.push({
+                            token,
+                            bridgedSupply,
+                        });
+                    }
+                    const inventoryBalances = await this.fetchInventoryBalances();
+                    if (Object.keys(inventoryBalances).length > 0) {
+                        event.inventoryBalances = inventoryBalances;
+                        this.logger.info({
+                            chainsMonitored: Object.keys(inventoryBalances).length,
+                            balances: Object.entries(inventoryBalances).map(([chain, balance]) => ({
+                                chain,
+                                balance: balance.toString(),
+                                balanceEth: (Number(balance) / 1e18).toFixed(6),
+                            })),
+                        }, 'Inventory balances fetched');
+                    }
+                    if (this.tokenInfoHandler) {
+                        await this.tokenInfoHandler(event);
+                    }
+                    this.logger.debug('Polling cycle completed');
+                }
+                catch (error) {
+                    this.errorHandler?.(new MonitorPollingError(`Error during monitor execution cycle: ${error.message}`, error));
+                }
+                // Smart sleep: only wait for remaining time after cycle completes
+                const elapsed = Date.now() - cycleStart;
+                const remaining = this.checkFrequency - elapsed;
+                if (remaining > 0) {
+                    await sleep(remaining);
+                }
+                // If elapsed >= checkFrequency, start next cycle immediately
+            }
+        }
+        catch (error) {
+            this.errorHandler?.(new MonitorStartError(`Error starting monitor: ${error.message}`, error));
+        }
+        // After the loop has been gracefully terminated, we can clean up.
+        this.tokenInfoHandler = undefined;
+        this.errorHandler = undefined;
+        this.startHandler = undefined;
+        this.logger.info('Monitor stopped');
+        // If stop() was called, resolve the promise to signal that we're done.
+        if (this.resolveStop) {
+            this.resolveStop();
+            this.resolveStop = null;
+            this.stopPromise = null;
+        }
+    }
+    async getTokenBridgedSupply(token, blockTag) {
+        if (!token.isHypToken()) {
+            this.logger.warn({
+                chain: token.chainName,
+                tokenSymbol: token.symbol,
+                tokenAddress: token.addressOrDenom,
+            }, 'Cannot get bridged balance for a non-Hyperlane token');
+            return;
+        }
+        const adapter = token.getHypAdapter(this.warpCore.multiProvider);
+        let bridgedSupply;
+        try {
+            bridgedSupply = await adapter.getBridgedSupply({ blockTag });
+            this.logger.debug({ chain: token.chainName, blockTag }, 'Queried confirmed balance');
+        }
+        catch (error) {
+            this.logger.warn({
+                chain: token.chainName,
+                blockTag,
+                error: error.message,
+            }, 'Historical block query failed, falling back to latest');
+            bridgedSupply = await adapter.getBridgedSupply();
+        }
+        if (bridgedSupply === undefined) {
+            this.logger.warn({
+                chain: token.chainName,
+                tokenSymbol: token.symbol,
+                tokenAddress: token.addressOrDenom,
+            }, 'Bridged supply not found for token');
+        }
+        return bridgedSupply;
+    }
+    async fetchInventoryBalances() {
+        if (!this.inventoryConfig)
+            return {};
+        const balances = {};
+        const readPromises = this.inventoryConfig.chains.map(async (chainName) => {
+            const token = this.warpCore.tokens.find((t) => t.chainName === chainName);
+            if (!token) {
+                this.logger.warn({ chain: chainName }, 'No token found for inventory chain');
+                return { chainName, balance: 0n };
+            }
+            try {
+                const address = this.inventoryConfig.inventoryAddresses[token.protocol];
+                if (!address) {
+                    this.logger.warn({ chain: chainName, protocol: token.protocol }, 'No inventory address for chain protocol, skipping');
+                    return { chainName, balance: 0n };
+                }
+                const adapter = token.getAdapter(this.warpCore.multiProvider);
+                const balance = await adapter.getBalance(address);
+                this.logger.debug({
+                    chain: chainName,
+                    token: token.addressOrDenom,
+                    balance: balance.toString(),
+                }, 'Read inventory balance');
+                return { chainName, balance };
+            }
+            catch (error) {
+                this.logger.error({ chain: chainName, error: error.message }, 'Failed to read inventory balance');
+                return { chainName, balance: 0n };
+            }
+        });
+        const results = await Promise.all(readPromises);
+        for (const { chainName, balance } of results) {
+            balances[chainName] = balance;
+        }
+        return balances;
+    }
+    stop() {
+        if (!this.isMonitorRunning)
+            return Promise.resolve();
+        // If stop is already in progress, return the existing promise
+        if (this.stopPromise)
+            return this.stopPromise;
+        this.logger.info('Stopping monitor...');
+        // Signal the while loop to terminate after its current iteration
+        this.isMonitorRunning = false;
+        // Create a promise that will be resolved by the start() method
+        // once the loop and cleanup are complete.
+        this.stopPromise = new Promise((resolve) => {
+            this.resolveStop = resolve;
+        });
+        return this.stopPromise;
+    }
+}
+//# sourceMappingURL=Monitor.js.map

package/dist/monitor/Monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Monitor.js","sourceRoot":"","sources":["../../src/monitor/Monitor.ts"],"names":[],"mappings":"AAQA,OAAO,EAAyB,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAKL,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAU5D;;;GAGG;AACH,MAAM,OAAO,OAAO;IAYC;IACA;IACA;IACA;IAdX,gBAAgB,CAAiD;IACjE,YAAY,CAA0B;IACtC,YAAY,CAAc;IAC1B,gBAAgB,GAAG,KAAK,CAAC;IACzB,WAAW,GAAwB,IAAI,CAAC;IACxC,WAAW,GAAyB,IAAI,CAAC;IAEjD;;OAEG;IACH,YACmB,cAAsB,EACtB,QAAkB,EAClB,MAAc,EACd,eAAwC;QAHxC,mBAAc,GAAd,cAAc,CAAQ;QACtB,aAAQ,GAAR,QAAQ,CAAU;QAClB,WAAM,GAAN,MAAM,CAAQ;QACd,oBAAe,GAAf,eAAe,CAAyB;IACxD,CAAC;IAEI,KAAK,CAAC,yBAAyB;QACrC,MAAM,SAAS,GAAuB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAErE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,oBAAoB,CAC3C,IAAI,CAAC,QAAQ,CAAC,aAAa,EAC3B,KAAK,EACL,IAAI,CAAC,MAAM,CACZ,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IASD,EAAE,CAAC,SAAiB,EAAE,EAA4C;QAChE,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,gBAAgB,CAAC,SAAS;gBAC7B,IAAI,CAAC,gBAAgB,GAAG,EAEC,CAAC;gBAC1B,MAAM;YACR,KAAK,gBAAgB,CAAC,KAAK;gBACzB,IAAI,CAAC,YAAY,GAAG,EAA4B,CAAC;gBACjD,MAAM;YACR,KAAK,gBAAgB,CAAC,KAAK;gBACzB,IAAI,CAAC,YAAY,GAAG,EAAgB,CAAC;gBACrC,MAAM;QACV,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,+CAA+C;YAC/C,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,iBAAiB,CAAC,yBAAyB,CAAC,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,EACvC,iBAAiB,CAClB,CAAC;YACF,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YAEtB,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAE9B,IAAI,CAAC;oBACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;oBAE3C,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC,yBAAyB,EAAE,CAAC;oBAElE,MAAM,KAAK,GAAiB;wBAC1B,UAAU,EAAE,EAAE;wBACd,kBAAkB;qBACnB,CAAC;oBAEF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;wBACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf;4BACE,KAAK,EAAE,KAAK,CAAC,SAAS;4BACtB,WAAW,EAAE,KAAK,CAAC,MAAM;4BACzB,YAAY,EAAE,KAAK,CAAC,cAAc;yBACnC,EACD,gBAAgB,CACjB,CAAC;wBACF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;wBACrD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,qBAAqB,CACpD,KAAK,EACL,QAAQ,CACT,CAAC;wBAEF,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;4BACpB,KAAK;4BACL,aAAa;yBACd,CAAC,CAAC;oBACL,CAAC;oBAED,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;oBAC9D,IAAI,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC9C,KAAK,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;wBAC5C,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;4BACE,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM;4BACtD,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAC7C,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;gCACrB,KAAK;gCACL,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;gCAC3B,UAAU,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;6BAChD,CAAC,CACH;yBACF,EACD,4BAA4B,CAC7B,CAAC;oBACJ,CAAC;oBAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;wBAC1B,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;oBACrC,CAAC;oBACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBAC/C,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,YAAY,EAAE,CACjB,IAAI,mBAAmB,CACrB,yCAA0C,KAAe,CAAC,OAAO,EAAE,EACnE,KAAc,CACf,CACF,CAAC;gBACJ,CAAC;gBAED,kEAAkE;gBAClE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;gBACxC,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;gBAChD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;oBAClB,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;gBACzB,CAAC;gBACD,6DAA6D;YAC/D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,EAAE,CACjB,IAAI,iBAAiB,CACnB,2BAA4B,KAAe,CAAC,OAAO,EAAE,EACrD,KAAc,CACf,CACF,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEpC,uEAAuE;QACvE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,KAAY,EACZ,QAA4B;QAE5B,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;gBACE,KAAK,EAAE,KAAK,CAAC,SAAS;gBACtB,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,YAAY,EAAE,KAAK,CAAC,cAAc;aACnC,EACD,sDAAsD,CACvD,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACjE,IAAI,aAAiC,CAAC;QAEtC,IAAI,CAAC;YACH,aAAa,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7D,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,EACpC,2BAA2B,CAC5B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;gBACE,KAAK,EAAE,KAAK,CAAC,SAAS;gBACtB,QAAQ;gBACR,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,EACD,uDAAuD,CACxD,CAAC;YACF,aAAa,GAAG,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACnD,CAAC;QAED,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;gBACE,KAAK,EAAE,KAAK,CAAC,SAAS;gBACtB,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,YAAY,EAAE,KAAK,CAAC,cAAc;aACnC,EACD,oCAAoC,CACrC,CAAC;QACJ,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,sBAAsB;QAClC,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO,EAAE,CAAC;QAErC,MAAM,QAAQ,GAAqB,EAAE,CAAC;QAEtC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;YACvE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;YAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,KAAK,EAAE,SAAS,EAAE,EACpB,oCAAoC,CACrC,CAAC;gBACF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACpC,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,GACX,IAAI,CAAC,eAAgB,CAAC,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC3D,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,EAC9C,mDAAmD,CACpD,CAAC;oBACF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;gBACpC,CAAC;gBACD,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;gBAC9D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAClD,IAAI,CAAC,MAAM,CAAC,KAAK,CACf;oBACE,KAAK,EAAE,SAAS;oBAChB,KAAK,EAAE,KAAK,CAAC,cAAc;oBAC3B,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;iBAC5B,EACD,wBAAwB,CACzB,CAAC;gBACF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;YAChC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,EACrD,kCAAkC,CACnC,CAAC;gBACF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACpC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAEhD,KAAK,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,OAAO,EAAE,CAAC;YAC7C,QAAQ,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAChC,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,gBAAgB;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAErD,8DAA8D;QAC9D,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC;QAE9C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACxC,iEAAiE;QACjE,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAE9B,+DAA+D;QAC/D,0CAA0C;QAC1C,IAAI,CAAC,WAAW,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACzC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/service.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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

package/dist/service.js

@@ -0,0 +1,205 @@
+#!/usr/bin/env node
+/**
+ * Hyperlane Rebalancer Service Entry Point
+ *
+ * This is the main entry point for running the rebalancer as a standalone service
+ * in Kubernetes or other container environments. It reads configuration from
+ * environment variables and files, then starts the rebalancer in daemon mode.
+ *
+ * Environment Variables:
+ * - REBALANCER_CONFIG_FILE: Path to the rebalancer configuration YAML file (required)
+ * - HYP_REBALANCER_KEY: Private key for movable collateral rebalancing operations (preferred)
+ * - HYP_KEY: Fallback private key for HYP_REBALANCER_KEY (optional)
+ * - HYP_INVENTORY_KEY_<PROTOCOL>: Private key for inventory operations per protocol (e.g., HYP_INVENTORY_KEY_ETHEREUM, HYP_INVENTORY_KEY_SEALEVEL)
+ * - COINGECKO_API_KEY: API key for CoinGecko price fetching (optional, for metrics)
+ * - HYP_INVENTORY_KEY: Backward-compatible fallback for Ethereum inventory signer (optional, use HYP_INVENTORY_KEY_ETHEREUM preferentially)
+ * - CHECK_FREQUENCY: Balance check frequency in ms (default: 60000)
+ * - WITH_METRICS: Enable Prometheus metrics (default: "true")
+ * - MONITOR_ONLY: Run in monitor-only mode without executing transactions (default: "false")
+ * - LOG_LEVEL: Logging level (default: "info") - supported by pino
+ * - REGISTRY_URI: Registry URI for chain metadata. Can include /tree/{commit} to pin version (default: GitHub registry)
+ * - RPC_URL_<CHAIN>: Override RPC URL for a specific chain (e.g., RPC_URL_ETHEREUM, RPC_URL_ARBITRUM)
+ *
+ * Usage:
+ *   node dist/service.js
+ *   REBALANCER_CONFIG_FILE=/config/rebalancer.yaml HYP_REBALANCER_KEY=0x... HYP_INVENTORY_KEY=0x... node dist/service.js
+ */
+import { Wallet } from 'ethers';
+import { Keypair } from '@solana/web3.js';
+import { DEFAULT_GITHUB_REGISTRY } from '@humanode-hyperlane/registry';
+import { getRegistry } from '@humanode-hyperlane/registry/fs';
+import { MultiProvider } from '@humanode-hyperlane/sdk';
+import { applyRpcUrlOverridesFromEnv, createServiceLogger, ProtocolType, rootLogger, } from '@humanode-hyperlane/utils';
+import { RebalancerConfig } from './config/RebalancerConfig.js';
+import { RebalancerService } from './core/RebalancerService.js';
+import { parseSolanaPrivateKey } from './utils/solanaKeyParser.js';
+async function main() {
+    const VERSION = process.env.SERVICE_VERSION || 'dev';
+    // Validate required environment variables
+    const configFile = process.env.REBALANCER_CONFIG_FILE;
+    if (!configFile) {
+        rootLogger.error('REBALANCER_CONFIG_FILE environment variable is required');
+        process.exit(1);
+    }
+    const rebalancerPrivateKey = process.env.HYP_REBALANCER_KEY ?? process.env.HYP_KEY;
+    if (!rebalancerPrivateKey) {
+        rootLogger.error('HYP_REBALANCER_KEY (or HYP_KEY) environment variable is required');
+        process.exit(1);
+    }
+    // Build per-protocol private key map from env vars.
+    // Naming: HYP_INVENTORY_KEY_<UPPERCASE_PROTOCOL> (e.g., HYP_INVENTORY_KEY_ETHEREUM).
+    // HYP_INVENTORY_KEY (no suffix) is kept as backward-compatible fallback for Ethereum only.
+    const inventoryPrivateKeys = {};
+    for (const protocol of Object.values(ProtocolType)) {
+        const envKey = `HYP_INVENTORY_KEY_${protocol.toUpperCase()}`;
+        const val = process.env[envKey];
+        if (val) {
+            inventoryPrivateKeys[protocol] = val;
+        }
+    }
+    // Backward compat: HYP_INVENTORY_KEY (no suffix) as Ethereum fallback
+    if (!inventoryPrivateKeys[ProtocolType.Ethereum] &&
+        process.env.HYP_INVENTORY_KEY) {
+        inventoryPrivateKeys[ProtocolType.Ethereum] = process.env.HYP_INVENTORY_KEY;
+    }
+    // Parse optional environment variables
+    let checkFrequency = 60_000;
+    if (process.env.CHECK_FREQUENCY) {
+        const parsed = parseInt(process.env.CHECK_FREQUENCY, 10);
+        if (isNaN(parsed) || parsed <= 0) {
+            rootLogger.error('CHECK_FREQUENCY must be a positive number (milliseconds)');
+            process.exit(1);
+        }
+        checkFrequency = parsed;
+    }
+    const withMetrics = process.env.WITH_METRICS !== 'false';
+    const monitorOnly = process.env.MONITOR_ONLY === 'true';
+    const coingeckoApiKey = process.env.COINGECKO_API_KEY;
+    // Create logger (uses LOG_LEVEL environment variable for level configuration)
+    const logger = await createServiceLogger({
+        service: 'rebalancer',
+        version: VERSION,
+    });
+    logger.info({
+        version: VERSION,
+        configFile,
+        checkFrequency,
+        withMetrics,
+        monitorOnly,
+    }, 'Starting Hyperlane Rebalancer Service');
+    try {
+        // Load rebalancer configuration
+        const rebalancerConfig = RebalancerConfig.load(configFile);
+        logger.info('✅ Loaded rebalancer configuration');
+        // Initialize registry (uses env var or defaults to GitHub registry)
+        // For GitHub registries, REGISTRY_URI can include /tree/{commit} to pin to a specific version
+        const registryUri = process.env.REGISTRY_URI || DEFAULT_GITHUB_REGISTRY;
+        const registry = getRegistry({
+            registryUris: [registryUri],
+            enableProxy: true,
+            logger: rootLogger,
+        });
+        logger.info({ registryUri }, '✅ Initialized registry');
+        // Get chain metadata from registry
+        const chainMetadata = await registry.getMetadata();
+        logger.info(`✅ Loaded metadata for ${Object.keys(chainMetadata).length} chains`);
+        // Apply RPC URL overrides from environment variables
+        applyRpcUrlOverridesFromEnv(chainMetadata);
+        // Create MultiProvider with signer
+        const multiProvider = new MultiProvider(chainMetadata);
+        const rebalancerSigner = new Wallet(rebalancerPrivateKey);
+        multiProvider.setSharedSigner(rebalancerSigner);
+        logger.info({ rebalancerAddress: rebalancerSigner.address }, '✅ Initialized MultiProvider with rebalancer signer');
+        // Build consolidated inventory signers with keys embedded
+        const inventorySigners = {};
+        for (const [protocol, privateKey] of Object.entries(inventoryPrivateKeys)) {
+            if (!privateKey)
+                continue;
+            let derivedAddress;
+            if (protocol === ProtocolType.Ethereum) {
+                derivedAddress = new Wallet(privateKey).address;
+            }
+            else if (protocol === ProtocolType.Sealevel) {
+                const keyBytes = parseSolanaPrivateKey(privateKey);
+                const keypair = Keypair.fromSecretKey(keyBytes);
+                derivedAddress = keypair.publicKey.toBase58();
+            }
+            else {
+                logger.warn({ protocol }, `Unsupported protocol for inventory signer derivation, skipping`);
+                continue;
+            }
+            // Validate against config if present
+            const configuredAddress = rebalancerConfig.inventorySigners?.[protocol]?.address;
+            if (configuredAddress) {
+                const mismatch = protocol === ProtocolType.Ethereum
+                    ? configuredAddress.toLowerCase() !== derivedAddress.toLowerCase()
+                    : configuredAddress !== derivedAddress;
+                if (mismatch) {
+                    throw new Error(`inventorySigners.${protocol} mismatch: config has ${configuredAddress} but HYP_INVENTORY_KEY_${protocol.toUpperCase()} derives to ${derivedAddress}`);
+                }
+            }
+            inventorySigners[protocol] = {
+                address: derivedAddress,
+                key: privateKey,
+            };
+            logger.info({ protocol, address: derivedAddress }, `✅ ${protocol} inventory signer configured`);
+        }
+        // Fail fast if config references protocol-specific inventory signer but key is missing
+        if (!monitorOnly) {
+            for (const protocol of Object.values(ProtocolType)) {
+                if (rebalancerConfig.inventorySigners?.[protocol] &&
+                    !inventoryPrivateKeys[protocol]) {
+                    const envKey = `HYP_INVENTORY_KEY_${protocol.toUpperCase()}`;
+                    const hint = protocol === ProtocolType.Ethereum
+                        ? `${envKey} (or fallback HYP_INVENTORY_KEY)`
+                        : envKey;
+                    logger.error({
+                        inventorySigner: rebalancerConfig.inventorySigners[protocol]?.address,
+                    }, `Config specifies inventorySigners.${protocol} but ${hint} is not set.`);
+                    process.exit(1);
+                }
+            }
+        }
+        // Merge runtime keys into config — start from YAML config as base, overlay runtime keys per-protocol.
+        // This preserves YAML-only signer addresses (e.g., monitor-only configs) while adding runtime keys.
+        const mergedInventorySigners = { ...rebalancerConfig.inventorySigners };
+        for (const protocol of Object.values(ProtocolType)) {
+            const runtimeSigner = inventorySigners[protocol];
+            if (runtimeSigner) {
+                mergedInventorySigners[protocol] = {
+                    ...mergedInventorySigners[protocol],
+                    ...runtimeSigner,
+                };
+            }
+        }
+        const mergedRebalancerConfig = Object.keys(mergedInventorySigners).length > 0
+            ? new RebalancerConfig(rebalancerConfig.warpRouteId, rebalancerConfig.strategyConfig, rebalancerConfig.intentTTL, mergedInventorySigners, rebalancerConfig.externalBridges)
+            : rebalancerConfig;
+        // MultiProtocolProvider will be derived from multiProvider in factory
+        const multiProtocolProvider = undefined;
+        // Create the rebalancer service
+        const service = new RebalancerService(multiProvider, multiProtocolProvider, registry, mergedRebalancerConfig, {
+            mode: 'daemon',
+            checkFrequency,
+            monitorOnly,
+            withMetrics,
+            coingeckoApiKey,
+            logger,
+            version: VERSION,
+        });
+        // Start the service
+        await service.start();
+    }
+    catch (error) {
+        const err = error;
+        logger.error({ error: err.message, stack: err.stack }, 'Failed to start rebalancer service');
+        process.exit(1);
+    }
+}
+// Run the service
+main().catch((error) => {
+    const err = error;
+    rootLogger.error({ error: err.message, stack: err.stack }, 'Fatal error');
+    process.exit(1);
+});
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/strategy/BaseStrategy.d.ts

@@ -0,0 +1,86 @@
+import { type Logger } from 'pino';
+import type { ChainMap, ChainName, Token } from '@humanode-hyperlane/sdk';
+import type { IStrategy, InflightContext, RawBalances, Route, RouteWithContext, StrategyRoute } from '../interfaces/IStrategy.js';
+import { type Metrics } from '../metrics/Metrics.js';
+import { type BridgeConfig, type BridgeConfigWithOverride } from '../utils/bridgeUtils.js';
+export type Delta = {
+    chain: ChainName;
+    amount: bigint;
+};
+/**
+ * Base abstract class for rebalancing strategies
+ */
+export declare abstract class BaseStrategy implements IStrategy {
+    abstract readonly name: string;
+    protected readonly chains: ChainName[];
+    protected readonly metrics?: Metrics;
+    protected readonly logger: Logger;
+    protected readonly bridgeConfigs: ChainMap<BridgeConfigWithOverride>;
+    protected readonly tokensByChainName?: ChainMap<Token>;
+    constructor(chains: ChainName[], logger: Logger, bridgeConfigs: ChainMap<BridgeConfigWithOverride>, metrics?: Metrics, tokensByChainName?: ChainMap<Token>);
+    protected getBridgeConfigForRoute(origin: ChainName, destination: ChainName): BridgeConfig;
+    /**
+     * Main method to get rebalancing routes
+     */
+    getRebalancingRoutes(rawBalances: RawBalances, inflightContext?: InflightContext): StrategyRoute[];
+    /**
+     * Abstract method to get balances categorized by surplus and deficit
+     * Each specific strategy should implement its own logic
+     *
+     * @param balances - Effective balances (after collateral reservation)
+     * @param pendingRebalances - In-flight rebalances (origin tx confirmed, balance already deducted)
+     * @param proposedRebalances - Routes from earlier strategies in same cycle (not yet executed)
+     * @returns Categorized surpluses and deficits as Delta arrays
+     */
+    protected abstract getCategorizedBalances(balances: RawBalances, pendingRebalances?: Route[], proposedRebalances?: StrategyRoute[]): {
+        surpluses: Delta[];
+        deficits: Delta[];
+    };
+    /**
+     * Validates the raw balances against the chains configuration
+     */
+    protected validateRawBalances(rawBalances: RawBalances): void;
+    /**
+     * Reserve collateral for pending user transfers.
+     * Subtracts pending transfer amounts from destination balances.
+     * This ensures we don't drain collateral needed for incoming transfers.
+     *
+     * @param rawBalances - Current on-chain balances
+     * @param pendingTransfers - Transfers that will need collateral on destination
+     * @returns Balances with reserved amounts subtracted
+     */
+    protected reserveCollateral(rawBalances: RawBalances, pendingTransfers: Route[]): RawBalances;
+    /**
+     * Simulate pending rebalances based on execution method.
+     *
+     * For **movable_collateral** (default):
+     * - Add full amount to destination (origin already deducted on-chain)
+     *
+     * For **inventory**:
+     * - Simulate the eventual final state as if the entire intent will be fulfilled
+     * - Destination: add unfulfilled amount (total - delivered - awaiting)
+     *   This is what's NOT yet reflected in on-chain balance
+     * - Origin: subtract pending amount (total - delivered)
+     *   This is what WILL decrease when all messages deliver
+     *
+     * @param rawBalances - Current balances (may already have collateral reserved)
+     * @param pendingRebalances - In-flight rebalance operations (in_progress only)
+     * @returns Simulated future balances after rebalances complete
+     */
+    protected simulatePendingRebalances(rawBalances: RawBalances, pendingRebalances: RouteWithContext[]): RawBalances;
+    /**
+     * Simulate proposed rebalances by subtracting from origin AND adding to destination.
+     *
+     * Unlike pendingRebalances, proposedRebalances are routes from earlier strategies
+     * in the same cycle that haven't been executed yet. Therefore:
+     * - Origin balance has NOT been deducted on-chain
+     * - We must simulate both sides to maintain accurate total balance
+     *
+     * @param rawBalances - Current balances (may already have pending rebalances simulated)
+     * @param proposedRebalances - Routes from earlier strategies (not yet executed)
+     * @returns Simulated balances after proposed rebalances complete
+     */
+    protected simulateProposedRebalances(rawBalances: RawBalances, proposedRebalances: Route[]): RawBalances;
+    protected filterRoutes(routes: StrategyRoute[], actualBalances: RawBalances): StrategyRoute[];
+}
+//# sourceMappingURL=BaseStrategy.d.ts.map

package/dist/strategy/BaseStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseStrategy.d.ts","sourceRoot":"","sources":["../../src/strategy/BaseStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAG1E,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,KAAK,EACL,gBAAgB,EAChB,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAG9B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,KAAK,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;GAEG;AACH,8BAAsB,YAAa,YAAW,SAAS;IACrD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,wBAAwB,CAAC,CAAC;IACrE,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAGrD,MAAM,EAAE,SAAS,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EACjD,OAAO,CAAC,EAAE,OAAO,EACjB,iBAAiB,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;IAarC,SAAS,CAAC,uBAAuB,CAC/B,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,SAAS,GACrB,YAAY;IAIf;;OAEG;IACH,oBAAoB,CAClB,WAAW,EAAE,WAAW,EACxB,eAAe,CAAC,EAAE,eAAe,GAChC,aAAa,EAAE;IAgMlB;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,CAAC,sBAAsB,CACvC,QAAQ,EAAE,WAAW,EACrB,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAC3B,kBAAkB,CAAC,EAAE,aAAa,EAAE,GACnC;QACD,SAAS,EAAE,KAAK,EAAE,CAAC;QACnB,QAAQ,EAAE,KAAK,EAAE,CAAC;KACnB;IAED;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAoB7D;;;;;;;;OAQG;IACH,SAAS,CAAC,iBAAiB,CACzB,WAAW,EAAE,WAAW,EACxB,gBAAgB,EAAE,KAAK,EAAE,GACxB,WAAW;IAqCd;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,yBAAyB,CACjC,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,gBAAgB,EAAE,GACpC,WAAW;IAgFd;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,0BAA0B,CAClC,WAAW,EAAE,WAAW,EACxB,kBAAkB,EAAE,KAAK,EAAE,GAC1B,WAAW;IAyCd,SAAS,CAAC,YAAY,CACpB,MAAM,EAAE,aAAa,EAAE,EACvB,cAAc,EAAE,WAAW,GAC1B,aAAa,EAAE;CA8CnB"}