@hyperlane-xyz/rebalancer 0.1.0-beta.5a8bd28ab

package/dist/metrics/scripts/metrics.js

@@ -0,0 +1,198 @@
+import { Counter, Gauge, Registry } from 'prom-client';
+import { TokenStandard } from '@hyperlane-xyz/sdk';
+export const metricsRegister = new Registry();
+const warpRouteMetricLabels = [
+    'chain_name',
+    'token_address',
+    'token_name',
+    'wallet_address',
+    'token_standard',
+    'warp_route_id',
+    'related_chain_names',
+];
+const warpRouteTokenBalance = new Gauge({
+    name: 'hyperlane_warp_route_token_balance',
+    help: 'HypERC20 token balance of a Warp Route',
+    registers: [metricsRegister],
+    labelNames: warpRouteMetricLabels,
+});
+const warpRouteCollateralValue = new Gauge({
+    name: 'hyperlane_warp_route_collateral_value',
+    help: 'Total value of collateral held in a HypERC20Collateral or HypNative contract of a Warp Route',
+    registers: [metricsRegister],
+    labelNames: warpRouteMetricLabels,
+});
+const warpRouteValueAtRiskMetricLabels = [
+    'chain_name',
+    'collateral_chain_name',
+    'token_address',
+    'token_name',
+    'collateral_token_standard',
+    'warp_route_id',
+];
+const warpRouteValueAtRisk = new Gauge({
+    name: 'hyperlane_warp_route_value_at_risk',
+    help: 'Value at risk on chain for a given Warp Route',
+    registers: [metricsRegister],
+    labelNames: warpRouteValueAtRiskMetricLabels,
+});
+export const rebalancerExecutionTotal = new Counter({
+    name: 'hyperlane_rebalancer_executions_total',
+    help: 'Total number of rebalance execution attempts.',
+    registers: [metricsRegister],
+    labelNames: ['warp_route_id', 'succeeded'],
+});
+export const rebalancerExecutionAmount = new Counter({
+    name: 'hyperlane_rebalancer_execution_amount',
+    help: 'Total amount of tokens rebalanced.',
+    registers: [metricsRegister],
+    labelNames: ['warp_route_id', 'origin', 'destination', 'token'],
+});
+export const rebalancerPollingErrorsTotal = new Counter({
+    name: 'hyperlane_rebalancer_polling_errors_total',
+    help: 'Total number of errors during the monitor polling phase.',
+    registers: [metricsRegister],
+    labelNames: ['warp_route_id'],
+});
+const walletBalanceGauge = new Gauge({
+    // Mirror the rust/main/ethers-prometheus `wallet_balance` gauge metric.
+    name: 'hyperlane_wallet_balance',
+    help: 'Current balance of a wallet for a token',
+    registers: [metricsRegister],
+    labelNames: [
+        'chain',
+        'wallet_address',
+        'wallet_name',
+        'token_address',
+        'token_symbol',
+        'token_name',
+    ],
+});
+const xERC20LimitsGauge = new Gauge({
+    name: 'hyperlane_xerc20_limits',
+    help: 'Current minting and burning limits of xERC20 tokens',
+    registers: [metricsRegister],
+    labelNames: [
+        'chain_name',
+        'limit_type',
+        'token_name',
+        'bridge_address',
+        'token_address',
+        'bridge_label',
+    ],
+});
+export function updateTokenBalanceMetrics(warpCore, token, balanceInfo, warpRouteId, logger) {
+    const allChains = warpCore.getTokenChains().sort();
+    const relatedChains = allChains.filter((chainName) => chainName !== token.chainName);
+    const metrics = {
+        chain_name: token.chainName,
+        token_address: balanceInfo.tokenAddress,
+        token_name: token.name,
+        wallet_address: 
+        // the balance for an EvmHypERC20 token is returned as the total supply of the xERC20 token,
+        // therefore we set the wallet address to the token address,
+        // we follow the same pattern or synthetic tokens
+        token.standard !== TokenStandard.EvmHypXERC20
+            ? token.addressOrDenom
+            : balanceInfo.tokenAddress,
+        token_standard: 
+        // as we are reporting the total supply for clarity we report the standard as xERC20
+        token.standard !== TokenStandard.EvmHypXERC20 ? token.standard : 'xERC20',
+        warp_route_id: warpRouteId,
+        // TODO: consider deprecating this label given that we have the value at risk metric
+        related_chain_names: relatedChains.join(','),
+    };
+    warpRouteTokenBalance.labels(metrics).set(balanceInfo.balance);
+    logger.info({
+        labels: metrics,
+        balance: balanceInfo.balance,
+    }, 'Wallet balance updated for token');
+    if (balanceInfo.valueUSD) {
+        // TODO: consider deprecating this metric in favor of the value at risk metric
+        warpRouteCollateralValue.labels(metrics).set(balanceInfo.valueUSD);
+        logger.info({
+            labels: metrics,
+            valueUSD: balanceInfo.valueUSD,
+        }, 'Wallet value updated for token');
+        for (const chainName of allChains) {
+            const labels = {
+                chain_name: chainName,
+                collateral_chain_name: metrics.chain_name,
+                token_address: metrics.token_address,
+                token_name: metrics.token_name,
+                collateral_token_standard: metrics.token_standard,
+                warp_route_id: metrics.warp_route_id,
+            };
+            warpRouteValueAtRisk.labels(labels).set(balanceInfo.valueUSD);
+            logger.info({
+                labels,
+                valueUSD: balanceInfo.valueUSD,
+            }, `Value at risk on ${chainName} updated for token`);
+        }
+    }
+}
+// TODO: This does not need to be a separate function, we can redefine updateTokenBalanceMetrics to be generic
+// TODO: Consider adding some identifier for the managedLockbox contract, could be adding collateralName label for lockboxes, this would help different manages lockboxes that has a different collateral token
+export function updateManagedLockboxBalanceMetrics(warpCore, chainName, tokenName, tokenAddress, lockBoxAddress, balanceInfo, warpRouteId, logger) {
+    const metrics = {
+        chain_name: chainName,
+        token_address: tokenAddress,
+        token_name: tokenName,
+        wallet_address: lockBoxAddress,
+        token_standard: 'EvmManagedLockbox', // TODO: we should eventually a new TokenStandard for this
+        warp_route_id: warpRouteId,
+        related_chain_names: warpCore
+            .getTokenChains()
+            .filter((_chainName) => _chainName !== chainName)
+            .sort()
+            .join(','),
+    };
+    warpRouteTokenBalance.labels(metrics).set(balanceInfo.balance);
+    logger.info({
+        labels: metrics,
+        balance: balanceInfo.balance,
+    }, 'ManagedLockbox collateral balance updated');
+    if (balanceInfo.valueUSD) {
+        warpRouteCollateralValue.labels(metrics).set(balanceInfo.valueUSD);
+        logger.info({
+            labels: metrics,
+            valueUSD: balanceInfo.valueUSD,
+        }, 'ManagedLockbox value updated for token');
+    }
+}
+export function updateNativeWalletBalanceMetrics(balance, logger) {
+    walletBalanceGauge
+        .labels({
+        chain: balance.chain,
+        wallet_address: balance.walletAddress,
+        wallet_name: balance.walletName,
+        token_symbol: 'Native',
+        token_name: 'Native',
+    })
+        .set(balance.balance);
+    logger.info({
+        balanceInfo: balance,
+    }, 'Native wallet balance updated');
+}
+export function updateXERC20LimitsMetrics(token, limits, bridgeAddress, bridgeLabel, xERC20Address, logger) {
+    const labels = {
+        chain_name: token.chainName,
+        token_name: token.name,
+        bridge_address: bridgeAddress,
+        token_address: xERC20Address,
+        bridge_label: bridgeLabel,
+    };
+    for (const [limitType, limit] of Object.entries(limits)) {
+        xERC20LimitsGauge
+            .labels({
+            ...labels,
+            limit_type: limitType,
+        })
+            .set(limit);
+    }
+    logger.info({
+        ...labels,
+        limits,
+    }, 'xERC20 limits updated for bridge on token');
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics/scripts/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/metrics/scripts/metrics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAoB,aAAa,EAAY,MAAM,oBAAoB,CAAC;AAS/E,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,QAAQ,EAAE,CAAC;AAiB9C,MAAM,qBAAqB,GAAoC;IAC7D,YAAY;IACZ,eAAe;IACf,YAAY;IACZ,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,qBAAqB;CACtB,CAAC;AAEF,MAAM,qBAAqB,GAAG,IAAI,KAAK,CAAC;IACtC,IAAI,EAAE,oCAAoC;IAC1C,IAAI,EAAE,wCAAwC;IAC9C,SAAS,EAAE,CAAC,eAAe,CAAC;IAC5B,UAAU,EAAE,qBAAqB;CAClC,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,IAAI,KAAK,CAAC;IACzC,IAAI,EAAE,uCAAuC;IAC7C,IAAI,EAAE,8FAA8F;IACpG,SAAS,EAAE,CAAC,eAAe,CAAC;IAC5B,UAAU,EAAE,qBAAqB;CAClC,CAAC,CAAC;AAOH,MAAM,gCAAgC,GACpC;IACE,YAAY;IACZ,uBAAuB;IACvB,eAAe;IACf,YAAY;IACZ,2BAA2B;IAC3B,eAAe;CAChB,CAAC;AAEJ,MAAM,oBAAoB,GAAG,IAAI,KAAK,CAAC;IACrC,IAAI,EAAE,oCAAoC;IAC1C,IAAI,EAAE,+CAA+C;IACrD,SAAS,EAAE,CAAC,eAAe,CAAC;IAC5B,UAAU,EAAE,gCAAgC;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,OAAO,CAAC;IAClD,IAAI,EAAE,uCAAuC;IAC7C,IAAI,EAAE,+CAA+C;IACrD,SAAS,EAAE,CAAC,eAAe,CAAC;IAC5B,UAAU,EAAE,CAAC,eAAe,EAAE,WAAW,CAAC;CAC3C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,OAAO,CAAC;IACnD,IAAI,EAAE,uCAAuC;IAC7C,IAAI,EAAE,oCAAoC;IAC1C,SAAS,EAAE,CAAC,eAAe,CAAC;IAC5B,UAAU,EAAE,CAAC,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC;CAChE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,OAAO,CAAC;IACtD,IAAI,EAAE,2CAA2C;IACjD,IAAI,EAAE,0DAA0D;IAChE,SAAS,EAAE,CAAC,eAAe,CAAC;IAC5B,UAAU,EAAE,CAAC,eAAe,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,IAAI,KAAK,CAAC;IACnC,wEAAwE;IACxE,IAAI,EAAE,0BAA0B;IAChC,IAAI,EAAE,yCAAyC;IAC/C,SAAS,EAAE,CAAC,eAAe,CAAC;IAC5B,UAAU,EAAE;QACV,OAAO;QACP,gBAAgB;QAChB,aAAa;QACb,eAAe;QACf,cAAc;QACd,YAAY;KACb;CACF,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,IAAI,KAAK,CAAC;IAClC,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,qDAAqD;IAC3D,SAAS,EAAE,CAAC,eAAe,CAAC;IAC5B,UAAU,EAAE;QACV,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,gBAAgB;QAChB,eAAe;QACf,cAAc;KACf;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CACvC,QAAkB,EAClB,KAAY,EACZ,WAA6B,EAC7B,WAAmB,EACnB,MAAc;IAEd,MAAM,SAAS,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CACpC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAC7C,CAAC;IAEF,MAAM,OAAO,GAA0B;QACrC,UAAU,EAAE,KAAK,CAAC,SAAS;QAC3B,aAAa,EAAE,WAAW,CAAC,YAAY;QACvC,UAAU,EAAE,KAAK,CAAC,IAAI;QACtB,cAAc;QACZ,4FAA4F;QAC5F,4DAA4D;QAC5D,iDAAiD;QACjD,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,YAAY;YAC3C,CAAC,CAAC,KAAK,CAAC,cAAc;YACtB,CAAC,CAAC,WAAW,CAAC,YAAY;QAC9B,cAAc;QACZ,oFAAoF;QACpF,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QAC3E,aAAa,EAAE,WAAW;QAC1B,oFAAoF;QACpF,mBAAmB,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;KAC7C,CAAC;IAEF,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,CAAC,IAAI,CACT;QACE,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,WAAW,CAAC,OAAO;KAC7B,EACD,kCAAkC,CACnC,CAAC;IAEF,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;QACzB,8EAA8E;QAC9E,wBAAwB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,CAAC,IAAI,CACT;YACE,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,WAAW,CAAC,QAAQ;SAC/B,EACD,gCAAgC,CACjC,CAAC;QAEF,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG;gBACb,UAAU,EAAE,SAAS;gBACrB,qBAAqB,EAAE,OAAO,CAAC,UAAU;gBACzC,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,yBAAyB,EAAE,OAAO,CAAC,cAAc;gBACjD,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC;YAEF,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,CAAC,IAAI,CACT;gBACE,MAAM;gBACN,QAAQ,EAAE,WAAW,CAAC,QAAQ;aAC/B,EACD,oBAAoB,SAAS,oBAAoB,CAClD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AACD,8GAA8G;AAC9G,+MAA+M;AAC/M,MAAM,UAAU,kCAAkC,CAChD,QAAkB,EAClB,SAAoB,EACpB,SAAiB,EACjB,YAAoB,EACpB,cAAsB,EACtB,WAA6B,EAC7B,WAAmB,EACnB,MAAc;IAEd,MAAM,OAAO,GAA0B;QACrC,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,YAAY;QAC3B,UAAU,EAAE,SAAS;QACrB,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,mBAAmB,EAAE,0DAA0D;QAC/F,aAAa,EAAE,WAAW;QAC1B,mBAAmB,EAAE,QAAQ;aAC1B,cAAc,EAAE;aAChB,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC;aAChD,IAAI,EAAE;aACN,IAAI,CAAC,GAAG,CAAC;KACb,CAAC;IAEF,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,CAAC,IAAI,CACT;QACE,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,WAAW,CAAC,OAAO;KAC7B,EACD,2CAA2C,CAC5C,CAAC;IAEF,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;QACzB,wBAAwB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,CAAC,IAAI,CACT;YACE,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,WAAW,CAAC,QAAQ;SAC/B,EACD,wCAAwC,CACzC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAA4B,EAC5B,MAAc;IAEd,kBAAkB;SACf,MAAM,CAAC;QACN,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,cAAc,EAAE,OAAO,CAAC,aAAa;QACrC,WAAW,EAAE,OAAO,CAAC,UAAU;QAC/B,YAAY,EAAE,QAAQ;QACtB,UAAU,EAAE,QAAQ;KACrB,CAAC;SACD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,MAAM,CAAC,IAAI,CACT;QACE,WAAW,EAAE,OAAO;KACrB,EACD,+BAA+B,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAY,EACZ,MAAmB,EACnB,aAAsB,EACtB,WAAmB,EACnB,aAAsB,EACtB,MAAc;IAEd,MAAM,MAAM,GAAG;QACb,UAAU,EAAE,KAAK,CAAC,SAAS;QAC3B,UAAU,EAAE,KAAK,CAAC,IAAI;QACtB,cAAc,EAAE,aAAa;QAC7B,aAAa,EAAE,aAAa;QAC5B,YAAY,EAAE,WAAW;KAC1B,CAAC;IAEF,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,iBAAiB;aACd,MAAM,CAAC;YACN,GAAG,MAAM;YACT,UAAU,EAAE,SAAS;SACtB,CAAC;aACD,GAAG,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAI,CACT;QACE,GAAG,MAAM;QACT,MAAM;KACP,EACD,2CAA2C,CAC5C,CAAC;AACJ,CAAC"}

package/dist/metrics/types.d.ts

@@ -0,0 +1,24 @@
+import { ChainName } from '@hyperlane-xyz/sdk';
+import { Address } from '@hyperlane-xyz/utils';
+export interface XERC20Limit {
+    mint: number;
+    burn: number;
+    mintMax: number;
+    burnMax: number;
+}
+export interface XERC20Info {
+    limits: XERC20Limit;
+    xERC20Address: Address;
+}
+export interface WarpRouteBalance {
+    balance: number;
+    valueUSD?: number;
+    tokenAddress: Address;
+}
+export interface NativeWalletBalance {
+    chain: ChainName;
+    walletAddress: Address;
+    walletName: string;
+    balance: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/metrics/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metrics/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/metrics/types.js

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

package/dist/metrics/types.js.map

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

package/dist/metrics/utils/metrics.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="pino-http" />
+import http from 'http';
+import { Registry } from 'prom-client';
+/**
+ * Start a simple HTTP server to host metrics. This just takes the registry and dumps the text
+ * string to people who request `GET /metrics`.
+ *
+ * PROMETHEUS_PORT env var is used to determine what port to host on, defaults to 9090.
+ */
+export declare function startMetricsServer(register: Registry): http.Server;
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/metrics/utils/metrics.ts"],"names":[],"mappings":";;AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMvC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC,MAAM,CAmBlE"}

package/dist/metrics/utils/metrics.js

@@ -0,0 +1,28 @@
+import http from 'http';
+import { rootLogger } from '@hyperlane-xyz/utils';
+const logger = rootLogger.child({ module: 'metrics' });
+/**
+ * Start a simple HTTP server to host metrics. This just takes the registry and dumps the text
+ * string to people who request `GET /metrics`.
+ *
+ * PROMETHEUS_PORT env var is used to determine what port to host on, defaults to 9090.
+ */
+export function startMetricsServer(register) {
+    return http
+        .createServer((req, res) => {
+        if (req.url != '/metrics') {
+            return res.writeHead(404, 'Invalid url').end();
+        }
+        if (req.method != 'GET') {
+            return res.writeHead(405, 'Invalid method').end();
+        }
+        return register
+            .metrics()
+            .then((metricsStr) => {
+            res.writeHead(200, { 'Content-Type': 'text/plain' }).end(metricsStr);
+        })
+            .catch((err) => logger.error(err));
+    })
+        .listen(parseInt(process.env['PROMETHEUS_PORT'] || '9090'));
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics/utils/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/metrics/utils/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,OAAO,IAAI;SACR,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACzB,IAAI,GAAG,CAAC,GAAG,IAAI,UAAU,EAAE,CAAC;YAC1B,OAAO,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,GAAG,EAAE,CAAC;QACjD,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YACxB,OAAO,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,GAAG,EAAE,CAAC;QACpD,CAAC;QAED,OAAO,QAAQ;aACZ,OAAO,EAAE;aACT,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;YACnB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvE,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC;SACD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/monitor/Monitor.d.ts

@@ -0,0 +1,26 @@
+import { Logger } from 'pino';
+import type { WarpCore } from '@hyperlane-xyz/sdk';
+import { type IMonitor, type MonitorEvent, MonitorEventType } from '../interfaces/IMonitor.js';
+/**
+ * Simple monitor implementation that polls warp route collateral balances and emits them as MonitorEvent.
+ */
+export declare class Monitor implements IMonitor {
+    private readonly checkFrequency;
+    private readonly warpCore;
+    private readonly logger;
+    private readonly emitter;
+    private isMonitorRunning;
+    private resolveStop;
+    private stopPromise;
+    /**
+     * @param checkFrequency - The frequency to poll balances in ms.
+     */
+    constructor(checkFrequency: number, warpCore: WarpCore, logger: Logger);
+    on(eventName: MonitorEventType.TokenInfo, fn: (event: MonitorEvent) => void): this;
+    on(eventName: MonitorEventType.Error, fn: (event: Error) => void): this;
+    on(eventName: MonitorEventType.Start, fn: () => void): this;
+    start(): Promise<void>;
+    private getTokenBridgedSupply;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=Monitor.d.ts.map

package/dist/monitor/Monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Monitor.d.ts","sourceRoot":"","sources":["../../src/monitor/Monitor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,gBAAgB,EAGjB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,qBAAa,OAAQ,YAAW,QAAQ;IAUpC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,WAAW,CAA8B;IAEjD;;OAEG;gBAEgB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM;IAIjC,EAAE,CACA,SAAS,EAAE,gBAAgB,CAAC,SAAS,EACrC,EAAE,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAChC,IAAI;IACP,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IACvE,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAMrD,KAAK;YAgFG,qBAAqB;IAgCnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBtB"}

package/dist/monitor/Monitor.js

@@ -0,0 +1,116 @@
+import EventEmitter from 'events';
+import { sleep } from '@hyperlane-xyz/utils';
+import { MonitorEventType, MonitorPollingError, MonitorStartError, } from '../interfaces/IMonitor.js';
+/**
+ * Simple monitor implementation that polls warp route collateral balances and emits them as MonitorEvent.
+ */
+export class Monitor {
+    checkFrequency;
+    warpCore;
+    logger;
+    emitter = new EventEmitter();
+    isMonitorRunning = false;
+    resolveStop = null;
+    stopPromise = null;
+    /**
+     * @param checkFrequency - The frequency to poll balances in ms.
+     */
+    constructor(checkFrequency, warpCore, logger) {
+        this.checkFrequency = checkFrequency;
+        this.warpCore = warpCore;
+        this.logger = logger;
+    }
+    on(eventName, fn) {
+        this.emitter.on(eventName, fn);
+        return this;
+    }
+    async start() {
+        if (this.isMonitorRunning) {
+            // Cannot start the same monitor multiple times
+            this.emitter.emit(MonitorEventType.Error, new MonitorStartError('Monitor already running'));
+            return;
+        }
+        try {
+            this.isMonitorRunning = true;
+            this.logger.debug({ checkFrequency: this.checkFrequency }, 'Monitor started');
+            this.emitter.emit(MonitorEventType.Start);
+            while (this.isMonitorRunning) {
+                try {
+                    this.logger.debug('Polling cycle started');
+                    const event = {
+                        tokensInfo: [],
+                    };
+                    for (const token of this.warpCore.tokens) {
+                        this.logger.debug({
+                            chain: token.chainName,
+                            tokenSymbol: token.symbol,
+                            tokenAddress: token.addressOrDenom,
+                        }, 'Checking token');
+                        const bridgedSupply = await this.getTokenBridgedSupply(token);
+                        event.tokensInfo.push({
+                            token,
+                            bridgedSupply,
+                        });
+                    }
+                    // Emit the event warp routes info
+                    this.emitter.emit(MonitorEventType.TokenInfo, event);
+                    this.logger.debug('Polling cycle completed');
+                }
+                catch (error) {
+                    this.emitter.emit(MonitorEventType.Error, new MonitorPollingError(`Error during monitor execution cycle: ${error.message}`, error));
+                }
+                // Wait for the specified check frequency before the next iteration
+                await sleep(this.checkFrequency);
+            }
+        }
+        catch (error) {
+            this.emitter.emit(MonitorEventType.Error, new MonitorStartError(`Error starting monitor: ${error.message}`, error));
+        }
+        // After the loop has been gracefully terminated, we can clean up.
+        this.emitter.removeAllListeners();
+        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) {
+        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);
+        const 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;
+    }
+    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":"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"}

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,125 @@
+#!/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_KEY: Private key for signing transactions (required)
+ * - COINGECKO_API_KEY: API key for CoinGecko price fetching (optional, for metrics)
+ * - 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
+ *
+ * Usage:
+ *   node dist/service.js
+ *   REBALANCER_CONFIG_FILE=/config/rebalancer.yaml HYP_KEY=0x... node dist/service.js
+ */
+import { Wallet } from 'ethers';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { getRegistry } from '@hyperlane-xyz/registry/fs';
+import { MultiProtocolProvider, MultiProvider } from '@hyperlane-xyz/sdk';
+import { createServiceLogger, rootLogger } from '@hyperlane-xyz/utils';
+import { RebalancerConfig } from './config/RebalancerConfig.js';
+import { RebalancerService } from './core/RebalancerService.js';
+function getVersion() {
+    try {
+        const __dirname = fileURLToPath(new URL('.', import.meta.url));
+        const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '../package.json'), 'utf-8'));
+        return packageJson.version;
+    }
+    catch (error) {
+        rootLogger.warn({ error }, 'Could not read version from package.json');
+        return 'unknown';
+    }
+}
+async function main() {
+    const VERSION = getVersion();
+    // 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 privateKey = process.env.HYP_KEY;
+    if (!privateKey) {
+        rootLogger.error('HYP_KEY environment variable is required');
+        process.exit(1);
+    }
+    // Parse optional environment variables
+    let checkFrequency = 60000;
+    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 default registry URIs)
+        const registry = getRegistry({
+            registryUris: [],
+            enableProxy: false,
+            logger: rootLogger,
+        });
+        logger.info('✅ Initialized registry');
+        // Get chain metadata from registry
+        const chainMetadata = await registry.getMetadata();
+        logger.info(`✅ Loaded metadata for ${Object.keys(chainMetadata).length} chains`);
+        // Create MultiProvider with signer
+        const multiProvider = new MultiProvider(chainMetadata);
+        const signer = new Wallet(privateKey);
+        multiProvider.setSharedSigner(signer);
+        logger.info('✅ Initialized MultiProvider with signer');
+        // Create MultiProtocolProvider
+        const multiProtocolProvider = new MultiProtocolProvider(chainMetadata);
+        logger.info('✅ Initialized MultiProtocolProvider');
+        // Create the rebalancer service
+        const service = new RebalancerService(multiProvider, multiProtocolProvider, registry, rebalancerConfig, {
+            mode: 'daemon',
+            checkFrequency,
+            monitorOnly,
+            withMetrics,
+            coingeckoApiKey,
+            logger,
+            version: VERSION,
+        });
+        // Start the service
+        await service.start();
+    }
+    catch (error) {
+        logger.error({ error }, 'Failed to start rebalancer service');
+        process.exit(1);
+    }
+}
+// Run the service
+main().catch((error) => {
+    rootLogger.error({ error }, '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,34 @@
+import { Logger } from 'pino';
+import type { ChainName } from '@hyperlane-xyz/sdk';
+import type { IStrategy, RawBalances, RebalancingRoute } from '../interfaces/IStrategy.js';
+import { Metrics } from '../metrics/Metrics.js';
+export type Delta = {
+    chain: ChainName;
+    amount: bigint;
+};
+/**
+ * Base abstract class for rebalancing strategies
+ */
+export declare abstract class BaseStrategy implements IStrategy {
+    protected readonly chains: ChainName[];
+    protected readonly metrics?: Metrics;
+    protected readonly logger: Logger;
+    constructor(chains: ChainName[], logger: Logger, metrics?: Metrics);
+    /**
+     * Main method to get rebalancing routes
+     */
+    getRebalancingRoutes(rawBalances: RawBalances): RebalancingRoute[];
+    /**
+     * Abstract method to get balances categorized by surplus and deficit
+     * Each specific strategy should implement its own logic
+     */
+    protected abstract getCategorizedBalances(rawBalances: RawBalances): {
+        surpluses: Delta[];
+        deficits: Delta[];
+    };
+    /**
+     * Validates the raw balances against the chains configuration
+     */
+    protected validateRawBalances(rawBalances: RawBalances): void;
+}
+//# 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,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,MAAM,MAAM,KAAK,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;GAEG;AACH,8BAAsB,YAAa,YAAW,SAAS;IACrD,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;gBAEtB,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAUlE;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,gBAAgB,EAAE;IAgJlE;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG;QACnE,SAAS,EAAE,KAAK,EAAE,CAAC;QACnB,QAAQ,EAAE,KAAK,EAAE,CAAC;KACnB;IAED;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;CAmB9D"}