@humanode-hyperlane/rebalancer 0.0.0-stage → 27.2.2

package/dist/interfaces/IStrategy.d.ts

@@ -0,0 +1,60 @@
+import { type ChainMap, type ChainName } from '@humanode-hyperlane/sdk';
+import type { Address } from '@humanode-hyperlane/utils';
+import { ExternalBridgeType } from '../config/types.js';
+import { ExecutionMethod } from '../tracking/types.js';
+export type RawBalances = ChainMap<bigint>;
+export interface Route {
+    origin: ChainName;
+    destination: ChainName;
+    amount: bigint;
+    /** Execution method used for this rebalance */
+    executionMethod?: ExecutionMethod;
+}
+export interface RouteWithContext extends Route {
+    /** For inventory intents: sum of complete inventory_deposit actions (message delivered) */
+    deliveredAmount?: bigint;
+    /** For inventory intents: sum of in_progress inventory_deposit actions (tx confirmed, message pending) */
+    awaitingDeliveryAmount?: bigint;
+}
+/**
+ * Route using movable collateral execution (on-chain rebalance via bridge)
+ */
+export interface MovableCollateralRoute extends Route {
+    executionType: 'movableCollateral';
+    bridge: Address;
+}
+/**
+ * Route using inventory execution (external bridge + transferRemote)
+ */
+export interface InventoryRoute extends Route {
+    executionType: 'inventory';
+    externalBridge: ExternalBridgeType;
+}
+/**
+ * Discriminated union of route types by executionType
+ */
+export type StrategyRoute = MovableCollateralRoute | InventoryRoute;
+/**
+ * Type guard to check if a route is a MovableCollateralRoute
+ */
+export declare function isMovableCollateralRoute(route: StrategyRoute): route is MovableCollateralRoute;
+/**
+ * Type guard to check if a route is an InventoryRoute
+ */
+export declare function isInventoryRoute(route: StrategyRoute): route is InventoryRoute;
+export type InflightContext = {
+    /**
+     * In-flight rebalances from ActionTracker.
+     * Uses Route[] because recovered intents (from Explorer startup recovery)
+     * don't have bridge information. Some routes may have bridge at runtime.
+     */
+    pendingRebalances: RouteWithContext[];
+    pendingTransfers: RouteWithContext[];
+    /** Routes from earlier strategies - always have bridge */
+    proposedRebalances?: StrategyRoute[];
+};
+export interface IStrategy {
+    readonly name: string;
+    getRebalancingRoutes(rawBalances: RawBalances, inflightContext?: InflightContext): StrategyRoute[];
+}
+//# sourceMappingURL=IStrategy.d.ts.map

package/dist/interfaces/IStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStrategy.d.ts","sourceRoot":"","sources":["../../src/interfaces/IStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;AAE3C,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,SAAS,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,gBAAiB,SAAQ,KAAK;IAC7C,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0GAA0G;IAC1G,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,KAAK;IACnD,aAAa,EAAE,mBAAmB,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK;IAC3C,aAAa,EAAE,WAAW,CAAC;IAC3B,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,sBAAsB,GAAG,cAAc,CAAC;AAEpE;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,GACnB,KAAK,IAAI,sBAAsB,CAEjC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,GACnB,KAAK,IAAI,cAAc,CAEzB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;OAIG;IACH,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,aAAa,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAClB,WAAW,EAAE,WAAW,EACxB,eAAe,CAAC,EAAE,eAAe,GAChC,aAAa,EAAE,CAAC;CACpB"}

package/dist/interfaces/IStrategy.js

@@ -0,0 +1,13 @@
+/**
+ * Type guard to check if a route is a MovableCollateralRoute
+ */
+export function isMovableCollateralRoute(route) {
+    return route.executionType === 'movableCollateral';
+}
+/**
+ * Type guard to check if a route is an InventoryRoute
+ */
+export function isInventoryRoute(route) {
+    return route.executionType === 'inventory';
+}
+//# sourceMappingURL=IStrategy.js.map

package/dist/interfaces/IStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStrategy.js","sourceRoot":"","sources":["../../src/interfaces/IStrategy.ts"],"names":[],"mappings":"AA4CA;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAoB;IAEpB,OAAO,KAAK,CAAC,aAAa,KAAK,mBAAmB,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAoB;IAEpB,OAAO,KAAK,CAAC,aAAa,KAAK,WAAW,CAAC;AAC7C,CAAC"}

package/dist/metrics/Metrics.d.ts

@@ -0,0 +1,25 @@
+import { type Logger } from 'pino';
+import { Token, type TokenAmount, type WarpCore, type WarpRouteDeployConfig } from '@humanode-hyperlane/sdk';
+import { type IMetrics } from '../interfaces/IMetrics.js';
+import { type MonitorEvent } from '../interfaces/IMonitor.js';
+import { type StrategyRoute } from '../interfaces/IStrategy.js';
+import { type PriceGetter } from './PriceGetter.js';
+export declare class Metrics implements IMetrics {
+    private readonly tokenPriceGetter;
+    private readonly warpDeployConfig;
+    private readonly warpCore;
+    private readonly warpRouteId;
+    private readonly logger;
+    private readonly priceGetter;
+    constructor(tokenPriceGetter: PriceGetter, warpDeployConfig: WarpRouteDeployConfig | null, warpCore: WarpCore, warpRouteId: string, logger: Logger);
+    recordRebalancerSuccess(): void;
+    recordRebalanceAmount(route: StrategyRoute, originTokenAmount: TokenAmount): void;
+    recordRebalancerFailure(): void;
+    recordPollingError(): void;
+    recordIntentCreated(route: StrategyRoute, strategy: string): void;
+    recordActionAttempt(route: StrategyRoute, succeeded: boolean): void;
+    processToken({ token, bridgedSupply, }: MonitorEvent['tokensInfo'][number]): Promise<void>;
+    private updateTokenMetrics;
+    static getWarpRouteCollateralTokenSymbol(tokens: Token[]): string;
+}
+//# sourceMappingURL=Metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Metrics.d.ts","sourceRoot":"","sources":["../../src/metrics/Metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAYnC,OAAO,EACL,KAAK,EACL,KAAK,WAAW,EAGhB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAcpD,qBAAa,OAAQ,YAAW,QAAQ;IAKpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAP9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;gBAG5B,gBAAgB,EAAE,WAAW,EAC7B,gBAAgB,EAAE,qBAAqB,GAAG,IAAI,EAC9C,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,MAAM,EACpC,MAAM,EAAE,MAAM;IAahB,uBAAuB;IAMvB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW;IAW1E,uBAAuB;IAMvB,kBAAkB;IAMlB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM;IAW1D,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO;IAWtD,YAAY,CAAC,EACjB,KAAK,EACL,aAAa,GACd,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;YAWvB,kBAAkB;IA6KhC,MAAM,CAAC,iCAAiC,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM;CAkClE"}

package/dist/metrics/Metrics.js

@@ -0,0 +1,164 @@
+import { getExtraLockboxBalance, getExtraLockboxInfo, getManagedLockBoxCollateralInfo, getSealevelAtaPayerBalance, getTokenBridgedBalance, getXERC20Info, startMetricsServer, } from '@humanode-hyperlane/metrics';
+import { TokenStandard, TokenType, } from '@humanode-hyperlane/sdk';
+import { ProtocolType, tryFn } from '@humanode-hyperlane/utils';
+import { metricsRegister, rebalancerActionsCreatedTotal, rebalancerExecutionAmount, rebalancerExecutionTotal, rebalancerIntentsCreatedTotal, rebalancerPollingErrorsTotal, updateManagedLockboxBalanceMetrics, updateNativeWalletBalanceMetrics, updateTokenBalanceMetrics, updateXERC20LimitsMetrics, } from './scripts/metrics.js';
+export class Metrics {
+    tokenPriceGetter;
+    warpDeployConfig;
+    warpCore;
+    warpRouteId;
+    logger;
+    priceGetter;
+    constructor(tokenPriceGetter, warpDeployConfig, warpCore, warpRouteId, logger) {
+        this.tokenPriceGetter = tokenPriceGetter;
+        this.warpDeployConfig = warpDeployConfig;
+        this.warpCore = warpCore;
+        this.warpRouteId = warpRouteId;
+        this.logger = logger.child({ class: Metrics.name });
+        startMetricsServer(metricsRegister);
+        // Wrap PriceGetter to match TokenPriceGetter interface
+        this.priceGetter = {
+            tryGetTokenPrice: async (token) => {
+                return this.tokenPriceGetter.tryGetTokenPrice(token);
+            },
+        };
+    }
+    recordRebalancerSuccess() {
+        rebalancerExecutionTotal
+            .labels({ warp_route_id: this.warpRouteId, succeeded: 'true' })
+            .inc();
+    }
+    recordRebalanceAmount(route, originTokenAmount) {
+        rebalancerExecutionAmount
+            .labels({
+            warp_route_id: this.warpRouteId,
+            origin: route.origin,
+            destination: route.destination,
+            token: originTokenAmount.token.symbol,
+        })
+            .inc(originTokenAmount.getDecimalFormattedAmount());
+    }
+    recordRebalancerFailure() {
+        rebalancerExecutionTotal
+            .labels({ warp_route_id: this.warpRouteId, succeeded: 'false' })
+            .inc();
+    }
+    recordPollingError() {
+        rebalancerPollingErrorsTotal
+            .labels({ warp_route_id: this.warpRouteId })
+            .inc();
+    }
+    recordIntentCreated(route, strategy) {
+        rebalancerIntentsCreatedTotal
+            .labels({
+            warp_route_id: this.warpRouteId,
+            strategy,
+            origin: route.origin,
+            destination: route.destination,
+        })
+            .inc();
+    }
+    recordActionAttempt(route, succeeded) {
+        rebalancerActionsCreatedTotal
+            .labels({
+            warp_route_id: this.warpRouteId,
+            origin: route.origin,
+            destination: route.destination,
+            succeeded: String(succeeded),
+        })
+            .inc();
+    }
+    async processToken({ token, bridgedSupply, }) {
+        await tryFn(async () => {
+            await this.updateTokenMetrics(token, bridgedSupply);
+        }, 'Updating warp route metrics', this.logger);
+    }
+    // Updates the metrics for a single token in a warp route.
+    async updateTokenMetrics(token, bridgedSupply) {
+        const promises = [
+            tryFn(async () => {
+                const balanceInfo = await getTokenBridgedBalance(this.warpCore, token, this.priceGetter, this.logger, bridgedSupply);
+                if (!balanceInfo) {
+                    return;
+                }
+                updateTokenBalanceMetrics(this.warpCore, token, balanceInfo, this.warpRouteId, this.logger);
+            }, 'Getting bridged balance and value', this.logger),
+        ];
+        // For Sealevel collateral and synthetic tokens, there is an
+        // "Associated Token Account" (ATA) rent payer that has a balance
+        // that's used to pay for rent for the accounts that store user balances.
+        // This is necessary if the recipient has never received any tokens before.
+        if (token.protocol === ProtocolType.Sealevel && !token.isNative()) {
+            promises.push(tryFn(async () => {
+                const balance = await getSealevelAtaPayerBalance(this.warpCore, token, this.warpRouteId);
+                updateNativeWalletBalanceMetrics(balance, this.logger);
+            }, 'Getting ATA payer balance', this.logger));
+        }
+        if (token.isXerc20()) {
+            promises.push(tryFn(async () => {
+                const { limits, xERC20Address } = await getXERC20Info(this.warpCore, token);
+                const routerAddress = token.addressOrDenom;
+                updateXERC20LimitsMetrics(token, limits, routerAddress, token.standard, xERC20Address, this.logger);
+            }, 'Getting xERC20 limits', this.logger));
+            if (!this.warpDeployConfig) {
+                this.logger.warn({
+                    tokenSymbol: token.symbol,
+                    chain: token.chainName,
+                }, "Can't read warp deploy config, skipping extra lockboxes");
+                return;
+            }
+            // If the current token is an xERC20, we need to check if there are any extra lockboxes
+            const currentTokenDeployConfig = this.warpDeployConfig[token.chainName];
+            if (currentTokenDeployConfig.type !== TokenType.XERC20 &&
+                currentTokenDeployConfig.type !== TokenType.XERC20Lockbox) {
+                this.logger.error({
+                    tokenSymbol: token.symbol,
+                    chain: token.chainName,
+                    expectedType: [TokenType.XERC20, TokenType.XERC20Lockbox],
+                    actualType: currentTokenDeployConfig.type,
+                }, 'Token type mismatch in deploy config for xERC20 token');
+                return;
+            }
+            const extraLockboxes = currentTokenDeployConfig.xERC20?.extraBridges ?? [];
+            for (const lockbox of extraLockboxes) {
+                promises.push(tryFn(async () => {
+                    const { limits, xERC20Address } = await getExtraLockboxInfo(this.warpCore.multiProvider, token, lockbox.lockbox);
+                    updateXERC20LimitsMetrics(token, limits, lockbox.lockbox, 'EvmManagedLockbox', xERC20Address, this.logger);
+                }, 'Getting extra lockbox limits', this.logger), tryFn(async () => {
+                    const balance = await getExtraLockboxBalance(this.warpCore.multiProvider, token, this.priceGetter, lockbox.lockbox, this.logger);
+                    if (balance) {
+                        const { tokenName, tokenAddress } = await getManagedLockBoxCollateralInfo(this.warpCore.multiProvider, token, lockbox.lockbox);
+                        updateManagedLockboxBalanceMetrics(this.warpCore, token.chainName, tokenName, tokenAddress, lockbox.lockbox, balance, this.warpRouteId, this.logger);
+                    }
+                }, `Updating extra lockbox balance for contract at "${lockbox.lockbox}" on chain ${token.chainName}`, this.logger));
+            }
+        }
+        await Promise.all(promises);
+    }
+    static getWarpRouteCollateralTokenSymbol(tokens) {
+        // We need to have a deterministic way to determine the symbol of the warp route
+        // as its used to identify the warp route in metrics. This method should support routes where:
+        // - All tokens have the same symbol, token standards can be all collateral, all synthetic or a mix
+        // - All tokens have different symbol, but there is a collateral token to break the tie, where there are multiple collateral tokens, alphabetically first is chosen
+        // - All tokens have different symbol, but there is no collateral token to break the tie, pick the alphabetically first symbol
+        // Get all unique symbols from the tokens array
+        const uniqueSymbols = new Set(tokens.map((token) => token.symbol));
+        // If all tokens have the same symbol, return that symbol
+        if (uniqueSymbols.size === 1) {
+            return tokens[0].symbol;
+        }
+        // Find all collateralized tokens
+        const collateralTokens = tokens.filter((token) => token.isCollateralized() ||
+            token.standard === TokenStandard.EvmHypXERC20Lockbox);
+        if (collateralTokens.length === 0) {
+            // If there are no collateralized tokens, return the alphabetically first symbol
+            return [...uniqueSymbols].sort()[0];
+        }
+        // if there is a single unique collateral symbol return it or
+        // if there are multiple, return the alphabetically first symbol
+        const collateralSymbols = collateralTokens.map((token) => token.symbol);
+        const uniqueCollateralSymbols = [...new Set(collateralSymbols)];
+        return uniqueCollateralSymbols.sort()[0];
+    }
+}
+//# sourceMappingURL=Metrics.js.map

package/dist/metrics/Metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metrics.js","sourceRoot":"","sources":["../../src/metrics/Metrics.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,sBAAsB,EACtB,mBAAmB,EACnB,+BAA+B,EAC/B,0BAA0B,EAC1B,sBAAsB,EACtB,aAAa,EACb,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,aAAa,EACb,SAAS,GAGV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAOhE,OAAO,EACL,eAAe,EACf,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,kCAAkC,EAClC,gCAAgC,EAChC,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,OAAO,OAAO;IAKC;IACA;IACA;IACA;IAPF,MAAM,CAAS;IACf,WAAW,CAAmB;IAE/C,YACmB,gBAA6B,EAC7B,gBAA8C,EAC9C,QAAkB,EAClB,WAAmB,EACpC,MAAc;QAJG,qBAAgB,GAAhB,gBAAgB,CAAa;QAC7B,qBAAgB,GAAhB,gBAAgB,CAA8B;QAC9C,aAAQ,GAAR,QAAQ,CAAU;QAClB,gBAAW,GAAX,WAAW,CAAQ;QAGpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,kBAAkB,CAAC,eAAe,CAAC,CAAC;QAEpC,uDAAuD;QACvD,IAAI,CAAC,WAAW,GAAG;YACjB,gBAAgB,EAAE,KAAK,EAAE,KAAY,EAAE,EAAE;gBACvC,OAAO,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACvD,CAAC;SACF,CAAC;IACJ,CAAC;IAED,uBAAuB;QACrB,wBAAwB;aACrB,MAAM,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;aAC9D,GAAG,EAAE,CAAC;IACX,CAAC;IAED,qBAAqB,CAAC,KAAoB,EAAE,iBAA8B;QACxE,yBAAyB;aACtB,MAAM,CAAC;YACN,aAAa,EAAE,IAAI,CAAC,WAAW;YAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,MAAM;SACtC,CAAC;aACD,GAAG,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,uBAAuB;QACrB,wBAAwB;aACrB,MAAM,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;aAC/D,GAAG,EAAE,CAAC;IACX,CAAC;IAED,kBAAkB;QAChB,4BAA4B;aACzB,MAAM,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;aAC3C,GAAG,EAAE,CAAC;IACX,CAAC;IAED,mBAAmB,CAAC,KAAoB,EAAE,QAAgB;QACxD,6BAA6B;aAC1B,MAAM,CAAC;YACN,aAAa,EAAE,IAAI,CAAC,WAAW;YAC/B,QAAQ;YACR,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC;aACD,GAAG,EAAE,CAAC;IACX,CAAC;IAED,mBAAmB,CAAC,KAAoB,EAAE,SAAkB;QAC1D,6BAA6B;aAC1B,MAAM,CAAC;YACN,aAAa,EAAE,IAAI,CAAC,WAAW;YAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;SAC7B,CAAC;aACD,GAAG,EAAE,CAAC;IACX,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EACjB,KAAK,EACL,aAAa,GACsB;QACnC,MAAM,KAAK,CACT,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACtD,CAAC,EACD,6BAA6B,EAC7B,IAAI,CAAC,MAAM,CACZ,CAAC;IACJ,CAAC;IAED,0DAA0D;IAClD,KAAK,CAAC,kBAAkB,CAC9B,KAAY,EACZ,aAAsB;QAEtB,MAAM,QAAQ,GAAG;YACf,KAAK,CACH,KAAK,IAAI,EAAE;gBACT,MAAM,WAAW,GAAG,MAAM,sBAAsB,CAC9C,IAAI,CAAC,QAAQ,EACb,KAAK,EACL,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,EACX,aAAa,CACd,CAAC;gBAEF,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,OAAO;gBACT,CAAC;gBAED,yBAAyB,CACvB,IAAI,CAAC,QAAQ,EACb,KAAK,EACL,WAAW,EACX,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,CACZ,CAAC;YACJ,CAAC,EACD,mCAAmC,EACnC,IAAI,CAAC,MAAM,CACZ;SACF,CAAC;QAEF,4DAA4D;QAC5D,iEAAiE;QACjE,yEAAyE;QACzE,2EAA2E;QAC3E,IAAI,KAAK,CAAC,QAAQ,KAAK,YAAY,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;YAClE,QAAQ,CAAC,IAAI,CACX,KAAK,CACH,KAAK,IAAI,EAAE;gBACT,MAAM,OAAO,GAAG,MAAM,0BAA0B,CAC9C,IAAI,CAAC,QAAQ,EACb,KAAK,EACL,IAAI,CAAC,WAAW,CACjB,CAAC;gBAEF,gCAAgC,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACzD,CAAC,EACD,2BAA2B,EAC3B,IAAI,CAAC,MAAM,CACZ,CACF,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;YACrB,QAAQ,CAAC,IAAI,CACX,KAAK,CACH,KAAK,IAAI,EAAE;gBACT,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,aAAa,CACnD,IAAI,CAAC,QAAQ,EACb,KAAK,CACN,CAAC;gBACF,MAAM,aAAa,GAAG,KAAK,CAAC,cAAc,CAAC;gBAE3C,yBAAyB,CACvB,KAAK,EACL,MAAM,EACN,aAAa,EACb,KAAK,CAAC,QAAQ,EACd,aAAa,EACb,IAAI,CAAC,MAAM,CACZ,CAAC;YACJ,CAAC,EACD,uBAAuB,EACvB,IAAI,CAAC,MAAM,CACZ,CACF,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;oBACE,WAAW,EAAE,KAAK,CAAC,MAAM;oBACzB,KAAK,EAAE,KAAK,CAAC,SAAS;iBACvB,EACD,yDAAyD,CAC1D,CAAC;gBACF,OAAO;YACT,CAAC;YAED,uFAAuF;YACvF,MAAM,wBAAwB,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAExE,IACE,wBAAwB,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM;gBAClD,wBAAwB,CAAC,IAAI,KAAK,SAAS,CAAC,aAAa,EACzD,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,KAAK,CACf;oBACE,WAAW,EAAE,KAAK,CAAC,MAAM;oBACzB,KAAK,EAAE,KAAK,CAAC,SAAS;oBACtB,YAAY,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,aAAa,CAAC;oBACzD,UAAU,EAAE,wBAAwB,CAAC,IAAI;iBAC1C,EACD,uDAAuD,CACxD,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,cAAc,GAClB,wBAAwB,CAAC,MAAM,EAAE,YAAY,IAAI,EAAE,CAAC;YAEtD,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;gBACrC,QAAQ,CAAC,IAAI,CACX,KAAK,CACH,KAAK,IAAI,EAAE;oBACT,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,mBAAmB,CACzD,IAAI,CAAC,QAAQ,CAAC,aAAa,EAC3B,KAAK,EACL,OAAO,CAAC,OAAO,CAChB,CAAC;oBAEF,yBAAyB,CACvB,KAAK,EACL,MAAM,EACN,OAAO,CAAC,OAAO,EACf,mBAAmB,EACnB,aAAa,EACb,IAAI,CAAC,MAAM,CACZ,CAAC;gBACJ,CAAC,EACD,8BAA8B,EAC9B,IAAI,CAAC,MAAM,CACZ,EACD,KAAK,CACH,KAAK,IAAI,EAAE;oBACT,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAC1C,IAAI,CAAC,QAAQ,CAAC,aAAa,EAC3B,KAAK,EACL,IAAI,CAAC,WAAW,EAChB,OAAO,CAAC,OAAO,EACf,IAAI,CAAC,MAAM,CACZ,CAAC;oBAEF,IAAI,OAAO,EAAE,CAAC;wBACZ,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAC/B,MAAM,+BAA+B,CACnC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAC3B,KAAK,EACL,OAAO,CAAC,OAAO,CAChB,CAAC;wBAEJ,kCAAkC,CAChC,IAAI,CAAC,QAAQ,EACb,KAAK,CAAC,SAAS,EACf,SAAS,EACT,YAAY,EACZ,OAAO,CAAC,OAAO,EACf,OAAO,EACP,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,CACZ,CAAC;oBACJ,CAAC;gBACH,CAAC,EACD,mDAAmD,OAAO,CAAC,OAAO,cAAc,KAAK,CAAC,SAAS,EAAE,EACjG,IAAI,CAAC,MAAM,CACZ,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,iCAAiC,CAAC,MAAe;QACtD,gFAAgF;QAChF,8FAA8F;QAC9F,mGAAmG;QACnG,mKAAmK;QACnK,8HAA8H;QAE9H,+CAA+C;QAC/C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAEnE,yDAAyD;QACzD,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1B,CAAC;QAED,iCAAiC;QACjC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CACpC,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,gBAAgB,EAAE;YACxB,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,mBAAmB,CACvD,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,gFAAgF;YAChF,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,6DAA6D;QAC7D,gEAAgE;QAChE,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,uBAAuB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAEhE,OAAO,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/metrics/PriceGetter.d.ts

@@ -0,0 +1,10 @@
+import { type Logger } from 'pino';
+import { type ChainMap, type ChainMetadata, CoinGeckoTokenPriceGetter, type Token } from '@humanode-hyperlane/sdk';
+export declare class PriceGetter extends CoinGeckoTokenPriceGetter {
+    private readonly logger;
+    private constructor();
+    static create(chainMetadata: ChainMap<ChainMetadata>, logger: Logger, coingeckoApiKey?: string, expirySeconds?: number, sleepMsBetweenRequests?: number): PriceGetter;
+    tryGetTokenPrice(token: Token): Promise<number | undefined>;
+    getCoingeckoPrice(coingeckoId: string): Promise<number | undefined>;
+}
+//# sourceMappingURL=PriceGetter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PriceGetter.d.ts","sourceRoot":"","sources":["../../src/metrics/PriceGetter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,yBAAyB,EACzB,KAAK,KAAK,EACX,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,WAAY,SAAQ,yBAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO;WAiBO,MAAM,CAClB,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,EACxB,aAAa,CAAC,EAAE,MAAM,EACtB,sBAAsB,CAAC,EAAE,MAAM;IAa3B,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAqB3D,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAK1E"}

package/dist/metrics/PriceGetter.js

@@ -0,0 +1,41 @@
+import { CoinGeckoTokenPriceGetter, } from '@humanode-hyperlane/sdk';
+export class PriceGetter extends CoinGeckoTokenPriceGetter {
+    logger;
+    constructor({ chainMetadata, logger, apiKey, expirySeconds, sleepMsBetweenRequests, }) {
+        super({ chainMetadata, apiKey, expirySeconds, sleepMsBetweenRequests });
+        this.logger = logger;
+    }
+    static create(chainMetadata, logger, coingeckoApiKey, expirySeconds, sleepMsBetweenRequests) {
+        return new PriceGetter({
+            chainMetadata,
+            logger,
+            apiKey: coingeckoApiKey,
+            expirySeconds,
+            sleepMsBetweenRequests,
+        });
+    }
+    // Tries to get the price of a token from CoinGecko. Returns undefined if there's no
+    // CoinGecko ID for the token.
+    async tryGetTokenPrice(token) {
+        // We only get a price if the token defines a CoinGecko ID.
+        // This way we can ignore values of certain types of collateralized warp routes,
+        // e.g. Native warp routes on rollups that have been pre-funded.
+        const coinGeckoId = token.coinGeckoId;
+        if (!coinGeckoId) {
+            this.logger.debug({
+                tokenSymbol: token.symbol,
+                chain: token.chainName,
+                tokenAddress: token.addressOrDenom,
+            }, 'CoinGecko ID missing for token');
+            return undefined;
+        }
+        return this.getCoingeckoPrice(coinGeckoId);
+    }
+    async getCoingeckoPrice(coingeckoId) {
+        const prices = await this.getTokenPriceByIds([coingeckoId]);
+        if (!prices)
+            return undefined;
+        return prices[0];
+    }
+}
+//# sourceMappingURL=PriceGetter.js.map

package/dist/metrics/PriceGetter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PriceGetter.js","sourceRoot":"","sources":["../../src/metrics/PriceGetter.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,yBAAyB,GAE1B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,OAAO,WAAY,SAAQ,yBAAyB;IACvC,MAAM,CAAS;IAEhC,YAAoB,EAClB,aAAa,EACb,MAAM,EACN,MAAM,EACN,aAAa,EACb,sBAAsB,GAOvB;QACC,KAAK,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,sBAAsB,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,MAAM,CAAC,MAAM,CAClB,aAAsC,EACtC,MAAc,EACd,eAAwB,EACxB,aAAsB,EACtB,sBAA+B;QAE/B,OAAO,IAAI,WAAW,CAAC;YACrB,aAAa;YACb,MAAM;YACN,MAAM,EAAE,eAAe;YACvB,aAAa;YACb,sBAAsB;SACvB,CAAC,CAAC;IACL,CAAC;IAED,oFAAoF;IACpF,8BAA8B;IAC9B,KAAK,CAAC,gBAAgB,CAAC,KAAY;QACjC,2DAA2D;QAC3D,gFAAgF;QAChF,gEAAgE;QAChE,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QAEtC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf;gBACE,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,KAAK,EAAE,KAAK,CAAC,SAAS;gBACtB,YAAY,EAAE,KAAK,CAAC,cAAc;aACnC,EACD,gCAAgC,CACjC,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,WAAmB;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;CACF"}

package/dist/metrics/scripts/metrics.d.ts

@@ -0,0 +1,28 @@
+import { type Logger } from 'pino';
+import { Counter, Registry } from 'prom-client';
+import { type NativeWalletBalance, type WarpRouteBalance, type XERC20Limit } from '@humanode-hyperlane/metrics';
+import { type ChainName, type Token, type WarpCore } from '@humanode-hyperlane/sdk';
+import { type Address } from '@humanode-hyperlane/utils';
+export declare const metricsRegister: Registry;
+export declare const rebalancerExecutionTotal: Counter<"warp_route_id" | "succeeded">;
+export declare const rebalancerExecutionAmount: Counter<"destination" | "origin" | "warp_route_id" | "token">;
+export declare const rebalancerPollingErrorsTotal: Counter<"warp_route_id">;
+export declare const rebalancerIntentsCreatedTotal: Counter<"strategy" | "destination" | "origin" | "warp_route_id">;
+export declare const rebalancerActionsCreatedTotal: Counter<"destination" | "origin" | "warp_route_id" | "succeeded">;
+/**
+ * Updates token balance metrics for a warp route token.
+ */
+export declare function updateTokenBalanceMetrics(warpCore: WarpCore, token: Token, balanceInfo: WarpRouteBalance, warpRouteId: string, logger: Logger): void;
+/**
+ * Updates managed lockbox balance metrics.
+ */
+export declare function updateManagedLockboxBalanceMetrics(warpCore: WarpCore, chainName: ChainName, tokenName: string, tokenAddress: string, lockBoxAddress: string, balanceInfo: WarpRouteBalance, warpRouteId: string, logger: Logger): void;
+/**
+ * Updates native wallet balance metrics.
+ */
+export declare function updateNativeWalletBalanceMetrics(balance: NativeWalletBalance, logger: Logger): void;
+/**
+ * Updates xERC20 limits metrics.
+ */
+export declare function updateXERC20LimitsMetrics(token: Token, limits: XERC20Limit, bridgeAddress: Address, bridgeLabel: string, xERC20Address: Address, logger: Logger): void;
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/metrics/scripts/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,KAAK,mBAAmB,EAExB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAMjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,QAAQ,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,eAAO,MAAM,eAAe,UAAiB,CAAC;AAM9C,eAAO,MAAM,wBAAwB,wCAKnC,CAAC;AAEH,eAAO,MAAM,yBAAyB,+DAKpC,CAAC;AAEH,eAAO,MAAM,4BAA4B,0BAKvC,CAAC;AAEH,eAAO,MAAM,6BAA6B,kEAKxC,CAAC;AAEH,eAAO,MAAM,6BAA6B,mEAKxC,CAAC;AAEH;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,gBAAgB,EAC7B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,gBAAgB,EAC7B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,MAAM,GACb,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,OAAO,EACtB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,OAAO,EACtB,MAAM,EAAE,MAAM,GACb,IAAI,CAUN"}

package/dist/metrics/scripts/metrics.js

@@ -0,0 +1,61 @@
+import { Counter, Registry } from 'prom-client';
+import { createWarpMetricsGauges, updateManagedLockboxBalanceMetrics as sharedUpdateManagedLockboxBalanceMetrics, updateNativeWalletBalanceMetrics as sharedUpdateNativeWalletBalanceMetrics, updateTokenBalanceMetrics as sharedUpdateTokenBalanceMetrics, updateXERC20LimitsMetrics as sharedUpdateXERC20LimitsMetrics, } from '@humanode-hyperlane/metrics';
+export const metricsRegister = new Registry();
+// Create shared warp metrics gauges
+const gauges = createWarpMetricsGauges(metricsRegister);
+// Rebalancer-specific metrics
+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'],
+});
+export const rebalancerIntentsCreatedTotal = new Counter({
+    name: 'hyperlane_rebalancer_intents_created_total',
+    help: 'Total number of rebalancing intents (routes) created.',
+    registers: [metricsRegister],
+    labelNames: ['warp_route_id', 'strategy', 'origin', 'destination'],
+});
+export const rebalancerActionsCreatedTotal = new Counter({
+    name: 'hyperlane_rebalancer_actions_created_total',
+    help: 'Total number of rebalancing actions (transactions) attempted.',
+    registers: [metricsRegister],
+    labelNames: ['warp_route_id', 'origin', 'destination', 'succeeded'],
+});
+/**
+ * Updates token balance metrics for a warp route token.
+ */
+export function updateTokenBalanceMetrics(warpCore, token, balanceInfo, warpRouteId, logger) {
+    sharedUpdateTokenBalanceMetrics(gauges, warpCore, token, balanceInfo, warpRouteId, logger);
+}
+/**
+ * Updates managed lockbox balance metrics.
+ */
+export function updateManagedLockboxBalanceMetrics(warpCore, chainName, tokenName, tokenAddress, lockBoxAddress, balanceInfo, warpRouteId, logger) {
+    sharedUpdateManagedLockboxBalanceMetrics(gauges, warpCore, chainName, tokenName, tokenAddress, lockBoxAddress, balanceInfo, warpRouteId, logger);
+}
+/**
+ * Updates native wallet balance metrics.
+ */
+export function updateNativeWalletBalanceMetrics(balance, logger) {
+    sharedUpdateNativeWalletBalanceMetrics(gauges, balance, logger);
+}
+/**
+ * Updates xERC20 limits metrics.
+ */
+export function updateXERC20LimitsMetrics(token, limits, bridgeAddress, bridgeLabel, xERC20Address, logger) {
+    sharedUpdateXERC20LimitsMetrics(gauges, token, limits, bridgeAddress, bridgeLabel, xERC20Address, logger);
+}
+//# 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":"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"}

package/dist/monitor/Monitor.d.ts

@@ -0,0 +1,40 @@
+import { type Logger } from 'pino';
+import { type ChainName, type WarpCore } from '@humanode-hyperlane/sdk';
+import { Address, ProtocolType } from '@humanode-hyperlane/utils';
+import { type IMonitor, type MonitorEvent, MonitorEventType } from '../interfaces/IMonitor.js';
+/**
+ * Configuration for the Monitor's inventory tracking.
+ */
+export interface InventoryMonitorConfig {
+    inventoryAddresses: Partial<Record<ProtocolType, Address>>;
+    chains: ChainName[];
+}
+/**
+ * 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 declare class Monitor implements IMonitor {
+    private readonly checkFrequency;
+    private readonly warpCore;
+    private readonly logger;
+    private readonly inventoryConfig?;
+    private tokenInfoHandler?;
+    private errorHandler?;
+    private startHandler?;
+    private isMonitorRunning;
+    private resolveStop;
+    private stopPromise;
+    /**
+     * @param checkFrequency - The frequency to poll balances in ms.
+     */
+    constructor(checkFrequency: number, warpCore: WarpCore, logger: Logger, inventoryConfig?: InventoryMonitorConfig | undefined);
+    private computeConfirmedBlockTags;
+    on(eventName: MonitorEventType.TokenInfo, fn: (event: MonitorEvent) => void | Promise<void>): this;
+    on(eventName: MonitorEventType.Error, fn: (event: Error) => void): this;
+    on(eventName: MonitorEventType.Start, fn: () => void): this;
+    start(): Promise<void>;
+    private getTokenBridgedSupply;
+    private fetchInventoryBalances;
+    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":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,QAAQ,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAS,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,gBAAgB,EAGjB,MAAM,2BAA2B,CAAC;AAGnC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,OAAQ,YAAW,QAAQ;IAYpC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IAdnC,OAAO,CAAC,gBAAgB,CAAC,CAAgD;IACzE,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,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,EACd,eAAe,CAAC,EAAE,sBAAsB,YAAA;YAG7C,yBAAyB;IAgBvC,EAAE,CACA,SAAS,EAAE,gBAAgB,CAAC,SAAS,EACrC,EAAE,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAChD,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;IAkBrD,KAAK;YA+GG,qBAAqB;YAmDrB,sBAAsB;IAsDpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBtB"}