@hyperlane-xyz/rebalancer 0.1.2 → 1.0.0

package/src/utils/ExplorerClient.ts

@@ -2,11 +2,37 @@ import type { Logger } from 'pino';
 
 export type InflightRebalanceQueryParams = {
   bridges: string[];
-  domains: number[];
+  routersByDomain: Record<number, string>; // Domain ID → router address (derive routers and domains from this)
   txSender: string;
   limit?: number;
 };
 
+export type UserTransferQueryParams = {
+  routersByDomain: Record<number, string>; // Domain ID → router address (derive routers and domains from this)
+  excludeTxSender: string; // Rebalancer address to exclude
+  limit?: number;
+};
+
+export type RebalanceActionQueryParams = {
+  bridges: string[]; // Bridge contract addresses
+  routersByDomain: Record<number, string>; // Domain ID → router address (derive routers and domains from this)
+  rebalancerAddress: string; // Only include rebalancer's txs
+  limit?: number;
+};
+
+export type ExplorerMessage = {
+  msg_id: string;
+  origin_domain_id: number;
+  destination_domain_id: number;
+  sender: string;
+  recipient: string;
+  origin_tx_hash: string;
+  origin_tx_sender: string;
+  origin_tx_recipient: string;
+  is_delivered: boolean;
+  message_body: string;
+};
+
 export class ExplorerClient {
   constructor(private readonly baseUrl: string) {}
 
@@ -14,15 +40,43 @@ export class ExplorerClient {
     return addr.replace(/^0x/i, '\\x').toLowerCase();
   }
 
+  /**
+   * Normalize all hex fields in Explorer response from PostgreSQL bytea format (\\x) to standard hex (0x)
+   */
+  private normalizeExplorerMessage(msg: any): ExplorerMessage {
+    const normalizeHex = (hex: string): string => {
+      if (!hex) return hex;
+      return hex.startsWith('\\x') ? '0x' + hex.slice(2) : hex;
+    };
+
+    return {
+      msg_id: normalizeHex(msg.msg_id),
+      origin_domain_id: msg.origin_domain_id,
+      destination_domain_id: msg.destination_domain_id,
+      sender: normalizeHex(msg.sender),
+      recipient: normalizeHex(msg.recipient),
+      origin_tx_hash: normalizeHex(msg.origin_tx_hash),
+      origin_tx_sender: normalizeHex(msg.origin_tx_sender),
+      origin_tx_recipient: normalizeHex(msg.origin_tx_recipient),
+      is_delivered: msg.is_delivered,
+      message_body: normalizeHex(msg.message_body),
+    };
+  }
+
   async hasUndeliveredRebalance(
     params: InflightRebalanceQueryParams,
     logger: Logger,
   ): Promise<boolean> {
-    const { bridges, domains, txSender, limit = 5 } = params;
+    const { bridges, routersByDomain, txSender, limit = 5 } = params;
+
+    // Derive routers and domains from routersByDomain
+    const routers = Object.values(routersByDomain);
+    const domains = Object.keys(routersByDomain).map(Number);
 
     const variables = {
       senders: bridges.map((a) => this.toBytea(a)),
       recipients: bridges.map((a) => this.toBytea(a)),
+      originTxRecipients: routers.map((a) => this.toBytea(a)),
       originDomains: domains,
       destDomains: domains,
       txSenders: [this.toBytea(txSender)],
@@ -35,6 +89,7 @@ export class ExplorerClient {
       query InflightRebalancesForRoute(
         $senders: [bytea!],
         $recipients: [bytea!],
+        $originTxRecipients: [bytea!],
         $originDomains: [Int!],
         $destDomains: [Int!],
         $txSenders: [bytea!],
@@ -46,6 +101,7 @@ export class ExplorerClient {
               { is_delivered: { _eq: false } },
               { sender: { _in: $senders } },
               { recipient: { _in: $recipients } },
+              { origin_tx_recipient: { _in: $originTxRecipients } },
               { origin_domain_id: { _in: $originDomains } },
               { destination_domain_id: { _in: $destDomains } },
               { origin_tx_sender: { _in: $txSenders } }
@@ -61,7 +117,9 @@ export class ExplorerClient {
           recipient
           origin_tx_hash
           origin_tx_sender
+          origin_tx_recipient
           is_delivered
+          message_body
         }
       }`;
 
@@ -94,6 +152,211 @@ export class ExplorerClient {
 
     logger.debug({ rows }, 'Explorer query rows');
 
-    return rows.length > 0;
+    // Post-query validation: verify each message's origin domain matches the expected router
+    const validatedRows = rows.filter((msg: any) => {
+      const expectedRouter = routersByDomain[msg.origin_domain_id];
+      if (!expectedRouter) return false;
+      const normalizedMsgRouter = msg.origin_tx_recipient?.startsWith('\\x')
+        ? '0x' + msg.origin_tx_recipient.slice(2)
+        : msg.origin_tx_recipient;
+      return (
+        normalizedMsgRouter?.toLowerCase() === expectedRouter.toLowerCase()
+      );
+    });
+
+    logger.debug(
+      { totalRows: rows.length, validatedRows: validatedRows.length },
+      'Post-query validation results',
+    );
+
+    return validatedRows.length > 0;
+  }
+
+  /**
+   * Query inflight user transfers from the Explorer.
+   * Returns transfers where sender/recipient are routers, excluding rebalancer's own transactions.
+   */
+  async getInflightUserTransfers(
+    params: UserTransferQueryParams,
+    logger: Logger,
+  ): Promise<ExplorerMessage[]> {
+    const { routersByDomain, excludeTxSender, limit = 100 } = params;
+
+    // Derive routers and domains from routersByDomain
+    const routers = Object.values(routersByDomain);
+    const domains = Object.keys(routersByDomain).map(Number);
+
+    const variables = {
+      senders: routers.map((a) => this.toBytea(a)),
+      recipients: routers.map((a) => this.toBytea(a)),
+      originDomains: domains,
+      destDomains: domains,
+      excludeTxSender: this.toBytea(excludeTxSender),
+      limit,
+    };
+
+    logger.debug({ variables }, 'Explorer getInflightUserTransfers query');
+
+    const query = `
+      query InflightUserTransfers(
+        $senders: [bytea!],
+        $recipients: [bytea!],
+        $originDomains: [Int!],
+        $destDomains: [Int!],
+        $excludeTxSender: bytea!,
+        $limit: Int = 100
+      ) {
+        message_view(
+          where: {
+            _and: [
+              { is_delivered: { _eq: false } },
+              { sender: { _in: $senders } },
+              { recipient: { _in: $recipients } },
+              { origin_domain_id: { _in: $originDomains } },
+              { destination_domain_id: { _in: $destDomains } },
+              { origin_tx_sender: { _neq: $excludeTxSender } }
+            ]
+          }
+          order_by: { origin_tx_id: desc }
+          limit: $limit
+        ) {
+          msg_id
+          origin_domain_id
+          destination_domain_id
+          sender
+          recipient
+          origin_tx_hash
+          origin_tx_sender
+          origin_tx_recipient
+          is_delivered
+          message_body
+        }
+      }`;
+
+    const res = await fetch(this.baseUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ query, variables }),
+    });
+
+    logger.debug(
+      { status: res.status },
+      'Explorer getInflightUserTransfers response',
+    );
+
+    if (!res.ok) {
+      let errorDetails: string;
+      try {
+        const errorJson = await res.json();
+        errorDetails = JSON.stringify(errorJson);
+      } catch (_e) {
+        try {
+          errorDetails = await res.text();
+        } catch (_textError) {
+          errorDetails = 'Unable to read response body';
+        }
+      }
+      throw new Error(`Explorer query failed: ${res.status} ${errorDetails}`);
+    }
+
+    const json = await res.json();
+    const messages = json?.data?.message_view ?? [];
+    return messages.map((msg: any) => this.normalizeExplorerMessage(msg));
+  }
+
+  /**
+   * Query inflight rebalance actions from the Explorer.
+   * Returns messages where sender/recipient are bridges, tx sender is the rebalancer,
+   * and origin_tx_recipient is one of this warp route's routers.
+   */
+  async getInflightRebalanceActions(
+    params: RebalanceActionQueryParams,
+    logger: Logger,
+  ): Promise<ExplorerMessage[]> {
+    const { bridges, routersByDomain, rebalancerAddress, limit = 100 } = params;
+
+    // Derive routers and domains from routersByDomain
+    const routers = Object.values(routersByDomain);
+    const domains = Object.keys(routersByDomain).map(Number);
+
+    const variables = {
+      senders: bridges.map((a) => this.toBytea(a)),
+      recipients: bridges.map((a) => this.toBytea(a)),
+      originTxRecipients: routers.map((a) => this.toBytea(a)),
+      originDomains: domains,
+      destDomains: domains,
+      txSender: this.toBytea(rebalancerAddress),
+      limit,
+    };
+
+    logger.debug({ variables }, 'Explorer getInflightRebalanceActions query');
+
+    const query = `
+      query InflightRebalanceActions(
+        $senders: [bytea!],
+        $recipients: [bytea!],
+        $originTxRecipients: [bytea!],
+        $originDomains: [Int!],
+        $destDomains: [Int!],
+        $txSender: bytea!,
+        $limit: Int = 100
+      ) {
+        message_view(
+          where: {
+            _and: [
+              { is_delivered: { _eq: false } },
+              { sender: { _in: $senders } },
+              { recipient: { _in: $recipients } },
+              { origin_tx_recipient: { _in: $originTxRecipients } },
+              { origin_domain_id: { _in: $originDomains } },
+              { destination_domain_id: { _in: $destDomains } },
+              { origin_tx_sender: { _eq: $txSender } }
+            ]
+          }
+          order_by: { origin_tx_id: desc }
+          limit: $limit
+        ) {
+          msg_id
+          origin_domain_id
+          destination_domain_id
+          sender
+          recipient
+          origin_tx_hash
+          origin_tx_sender
+          origin_tx_recipient
+          is_delivered
+          message_body
+        }
+      }`;
+
+    const res = await fetch(this.baseUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ query, variables }),
+    });
+
+    logger.debug(
+      { status: res.status },
+      'Explorer getInflightRebalanceActions response',
+    );
+
+    if (!res.ok) {
+      let errorDetails: string;
+      try {
+        const errorJson = await res.json();
+        errorDetails = JSON.stringify(errorJson);
+      } catch (_e) {
+        try {
+          errorDetails = await res.text();
+        } catch (_textError) {
+          errorDetails = 'Unable to read response body';
+        }
+      }
+      throw new Error(`Explorer query failed: ${res.status} ${errorDetails}`);
+    }
+
+    const json = await res.json();
+    const messages = json?.data?.message_view ?? [];
+    return messages.map((msg: any) => this.normalizeExplorerMessage(msg));
   }
 }

package/src/utils/balanceUtils.test.ts

@@ -35,6 +35,7 @@ describe('getRawBalances', () => {
           bridgedSupply: tokenBridgedSupply,
         },
       ],
+      confirmedBlockTags: { mainnet: 1000 },
     };
   });
 

package/src/utils/balanceUtils.ts

@@ -26,7 +26,7 @@ export function getRawBalances(
 
     // Ignore tokens that are not in the provided chains list
     if (!chainSet.has(token.chainName)) {
-      logger.info(
+      logger.debug(
         {
           context: getRawBalances.name,
           chain: token.chainName,
@@ -40,7 +40,7 @@ export function getRawBalances(
 
     // Ignore tokens that are not collateralized or are otherwise ineligible
     if (!isCollateralizedTokenEligibleForRebalancing(token)) {
-      logger.info(
+      logger.debug(
         {
           context: getRawBalances.name,
           chain: token.chainName,

package/src/utils/bridgeUtils.test.ts

@@ -1,5 +1,4 @@
 import { expect } from 'chai';
-import { pino } from 'pino';
 
 import { type ChainMap } from '@hyperlane-xyz/sdk';
 
@@ -8,29 +7,24 @@ import {
   getBridgeConfig,
 } from './bridgeUtils.js';
 
-const testLogger = pino({ level: 'silent' });
-
 describe('bridgeConfig', () => {
   it('should return the base bridge config when no overrides exist', () => {
     const bridges: ChainMap<BridgeConfigWithOverride> = {
       chain1: {
         bridge: '0x1234567890123456789012345678901234567890',
         bridgeMinAcceptedAmount: 1000,
-        bridgeIsWarp: true,
       },
       chain2: {
         bridge: '0x0987654321098765432109876543210987654321',
         bridgeMinAcceptedAmount: 2000,
-        bridgeIsWarp: true,
       },
     };
 
-    const result = getBridgeConfig(bridges, 'chain1', 'chain2', testLogger);
+    const result = getBridgeConfig(bridges, 'chain1', 'chain2');
 
     expect(result).to.deep.equal({
       bridge: '0x1234567890123456789012345678901234567890',
       bridgeMinAcceptedAmount: 1000,
-      bridgeIsWarp: true,
     });
   });
 
@@ -39,7 +33,6 @@ describe('bridgeConfig', () => {
       chain1: {
         bridge: '0x1234567890123456789012345678901234567890',
         bridgeMinAcceptedAmount: 1000,
-        bridgeIsWarp: true,
         override: {
           chain2: {
             bridgeMinAcceptedAmount: 5000,
@@ -49,16 +42,14 @@ describe('bridgeConfig', () => {
       chain2: {
         bridge: '0x0987654321098765432109876543210987654321',
         bridgeMinAcceptedAmount: 2000,
-        bridgeIsWarp: true,
       },
     };
 
-    const result = getBridgeConfig(bridges, 'chain1', 'chain2', testLogger);
+    const result = getBridgeConfig(bridges, 'chain1', 'chain2');
 
     expect(result).to.deep.equal({
       bridge: '0x1234567890123456789012345678901234567890',
       bridgeMinAcceptedAmount: 5000,
-      bridgeIsWarp: true,
     });
   });
 
@@ -67,7 +58,6 @@ describe('bridgeConfig', () => {
       chain1: {
         bridge: '0x1234567890123456789012345678901234567890',
         bridgeMinAcceptedAmount: 1000,
-        bridgeIsWarp: true,
         override: {
           chain2: {
             bridge: '0xABCDEF0123456789ABCDEF0123456789ABCDEF01',
@@ -77,16 +67,14 @@ describe('bridgeConfig', () => {
       chain2: {
         bridge: '0x0987654321098765432109876543210987654321',
         bridgeMinAcceptedAmount: 2000,
-        bridgeIsWarp: true,
       },
     };
 
-    const result = getBridgeConfig(bridges, 'chain1', 'chain2', testLogger);
+    const result = getBridgeConfig(bridges, 'chain1', 'chain2');
 
     expect(result).to.deep.equal({
       bridge: '0xABCDEF0123456789ABCDEF0123456789ABCDEF01',
       bridgeMinAcceptedAmount: 1000,
-      bridgeIsWarp: true,
     });
   });
 });

package/src/utils/bridgeUtils.ts

@@ -1,5 +1,3 @@
-import { type Logger } from 'pino';
-
 import type { ChainMap, ChainName } from '@hyperlane-xyz/sdk';
 
 export type BridgeConfigWithOverride = BridgeConfig & {
@@ -9,7 +7,6 @@ export type BridgeConfigWithOverride = BridgeConfig & {
 export type BridgeConfig = {
   bridge: string;
   bridgeMinAcceptedAmount: string | number;
-  bridgeIsWarp: boolean;
 };
 
 /**
@@ -23,15 +20,8 @@ export function getBridgeConfig(
   bridges: ChainMap<BridgeConfigWithOverride>,
   fromChain: ChainName,
   toChain: ChainName,
-  logger: Logger,
 ): BridgeConfig {
   const fromConfig = bridges[fromChain];
-
-  if (!fromConfig) {
-    logger.error({ fromChain }, 'Bridge config not found');
-    throw new Error(`Bridge config not found for chain ${fromChain}`);
-  }
-
   const routeSpecificOverrides = fromConfig.override?.[toChain];
 
   // Create a new object with the properties from bridgeConfig, excluding the overrides property

package/dist/core/WithInflightGuard.d.ts

@@ -1,20 +0,0 @@
-import type { Logger } from 'pino';
-import { type ChainMetadataManager } from '@hyperlane-xyz/sdk';
-import { type RebalancerConfig } from '../config/RebalancerConfig.js';
-import type { IRebalancer } from '../interfaces/IRebalancer.js';
-import type { RebalancingRoute } from '../interfaces/IStrategy.js';
-import { type ExplorerClient } from '../utils/ExplorerClient.js';
-/**
- * Prevents rebalancing if there are inflight rebalances for the warp route.
- */
-export declare class WithInflightGuard implements IRebalancer {
-    private readonly config;
-    private readonly rebalancer;
-    private readonly explorer;
-    private readonly txSender;
-    private readonly chainManager;
-    private readonly logger;
-    constructor(config: RebalancerConfig, rebalancer: IRebalancer, explorer: ExplorerClient, txSender: string, chainManager: ChainMetadataManager, logger: Logger);
-    rebalance(routes: RebalancingRoute[]): Promise<void>;
-}
-//# sourceMappingURL=WithInflightGuard.d.ts.map

package/dist/core/WithInflightGuard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WithInflightGuard.d.ts","sourceRoot":"","sources":["../../src/core/WithInflightGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;GAEG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IAIjD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAP/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,WAAW,EACvB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,oBAAoB,EACnD,MAAM,EAAE,MAAM;IAKV,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAwC3D"}

package/dist/core/WithInflightGuard.js

@@ -1,47 +0,0 @@
-/**
- * Prevents rebalancing if there are inflight rebalances for the warp route.
- */
-export class WithInflightGuard {
-    config;
-    rebalancer;
-    explorer;
-    txSender;
-    chainManager;
-    logger;
-    constructor(config, rebalancer, explorer, txSender, chainManager, logger) {
-        this.config = config;
-        this.rebalancer = rebalancer;
-        this.explorer = explorer;
-        this.txSender = txSender;
-        this.chainManager = chainManager;
-        this.logger = logger.child({ class: WithInflightGuard.name });
-    }
-    async rebalance(routes) {
-        // Always enforce the inflight guard
-        if (routes.length === 0) {
-            return this.rebalancer.rebalance(routes);
-        }
-        const chains = Object.keys(this.config.strategyConfig.chains);
-        const bridges = chains.map((chain) => this.config.strategyConfig.chains[chain].bridge);
-        const domains = chains.map((chain) => this.chainManager.getDomainId(chain));
-        let hasInflightRebalances = false;
-        try {
-            hasInflightRebalances = await this.explorer.hasUndeliveredRebalance({
-                bridges,
-                domains: Array.from(new Set(domains)),
-                txSender: this.txSender,
-                limit: 5,
-            }, this.logger);
-        }
-        catch (e) {
-            this.logger.error({ status: e.status, body: e.body }, 'Explorer inflight query failed');
-            throw e;
-        }
-        if (hasInflightRebalances) {
-            this.logger.info('Inflight rebalance detected via Explorer; skipping this cycle');
-            return;
-        }
-        return this.rebalancer.rebalance(routes);
-    }
-}
-//# sourceMappingURL=WithInflightGuard.js.map

package/dist/core/WithInflightGuard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"WithInflightGuard.js","sourceRoot":"","sources":["../../src/core/WithInflightGuard.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAIT;IACA;IACA;IACA;IACA;IAPF,MAAM,CAAS;IAEhC,YACmB,MAAwB,EACxB,UAAuB,EACvB,QAAwB,EACxB,QAAgB,EAChB,YAAkC,EACnD,MAAc;QALG,WAAM,GAAN,MAAM,CAAkB;QACxB,eAAU,GAAV,UAAU,CAAa;QACvB,aAAQ,GAAR,QAAQ,CAAgB;QACxB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,iBAAY,GAAZ,YAAY,CAAsB;QAGnD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAA0B;QACxC,oCAAoC;QACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CACxB,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAC3D,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAE5E,IAAI,qBAAqB,GAAG,KAAK,CAAC;QAClC,IAAI,CAAC;YACH,qBAAqB,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CACjE;gBACE,OAAO;gBACP,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;gBACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,CAAC;aACT,EACD,IAAI,CAAC,MAAM,CACZ,CAAC;QACJ,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAClC,gCAAgC,CACjC,CAAC;YACF,MAAM,CAAC,CAAC;QACV,CAAC;QAED,IAAI,qBAAqB,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/core/WithInflightGuard.test.d.ts

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

package/dist/core/WithInflightGuard.test.d.ts.map

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

package/dist/core/WithInflightGuard.test.js

@@ -1,64 +0,0 @@
-import chai, { expect } from 'chai';
-import chaiAsPromised from 'chai-as-promised';
-import { ethers } from 'ethers';
-import { pino } from 'pino';
-import Sinon from 'sinon';
-import { chainMetadata } from '@hyperlane-xyz/registry';
-import { ChainMetadataManager } from '@hyperlane-xyz/sdk';
-import { MockRebalancer, buildTestConfig } from '../test/helpers.js';
-import { ExplorerClient } from '../utils/ExplorerClient.js';
-import { WithInflightGuard } from './WithInflightGuard.js';
-chai.use(chaiAsPromised);
-const testLogger = pino({ level: 'silent' });
-describe('WithInflightGuard', () => {
-    it('forwards empty routes without calling Explorer', async () => {
-        const config = buildTestConfig();
-        const rebalancer = new MockRebalancer();
-        const rebalanceSpy = Sinon.spy(rebalancer, 'rebalance');
-        const explorer = new ExplorerClient('http://localhost');
-        const explorerSpy = Sinon.stub(explorer, 'hasUndeliveredRebalance');
-        const guard = new WithInflightGuard(config, rebalancer, explorer, ethers.Wallet.createRandom().address, new ChainMetadataManager(chainMetadata), testLogger);
-        await guard.rebalance([]);
-        expect(explorerSpy.called).to.be.false;
-        expect(rebalanceSpy.calledOnce).to.be.true;
-        expect(rebalanceSpy.calledWith([])).to.be.true;
-    });
-    it('calls underlying rebalancer when no inflight is detected', async () => {
-        const config = buildTestConfig({}, ['ethereum', 'arbitrum']);
-        const routes = [{ origin: 'ethereum' }];
-        const rebalancer = new MockRebalancer();
-        const rebalanceSpy = Sinon.spy(rebalancer, 'rebalance');
-        const explorer = new ExplorerClient('http://localhost');
-        const explorerSpy = Sinon.stub(explorer, 'hasUndeliveredRebalance').resolves(false);
-        const guard = new WithInflightGuard(config, rebalancer, explorer, ethers.Wallet.createRandom().address, new ChainMetadataManager(chainMetadata), testLogger);
-        await guard.rebalance(routes);
-        expect(explorerSpy.calledOnce).to.be.true;
-        expect(rebalanceSpy.calledOnce).to.be.true;
-        expect(rebalanceSpy.calledWith(routes)).to.be.true;
-    });
-    it('skips rebalancing when inflight is detected', async () => {
-        const config = buildTestConfig({}, ['ethereum', 'arbitrum']);
-        const routes = [{ origin: 'ethereum' }];
-        const rebalancer = new MockRebalancer();
-        const rebalanceSpy = Sinon.spy(rebalancer, 'rebalance');
-        const explorer = new ExplorerClient('http://localhost');
-        const explorerSpy = Sinon.stub(explorer, 'hasUndeliveredRebalance').resolves(true);
-        const guard = new WithInflightGuard(config, rebalancer, explorer, ethers.Wallet.createRandom().address, new ChainMetadataManager(chainMetadata), testLogger);
-        await guard.rebalance(routes);
-        expect(explorerSpy.calledOnce).to.be.true;
-        expect(rebalanceSpy.called).to.be.false;
-    });
-    it('propagates explorer query error', async () => {
-        const config = buildTestConfig({}, ['ethereum', 'arbitrum']);
-        const routes = [{ origin: 'ethereum' }];
-        const rebalancer = new MockRebalancer();
-        const rebalanceSpy = Sinon.spy(rebalancer, 'rebalance');
-        const explorer = new ExplorerClient('http://localhost');
-        const explorerSpy = Sinon.stub(explorer, 'hasUndeliveredRebalance').rejects(new Error('Explorer HTTP 405'));
-        const guard = new WithInflightGuard(config, rebalancer, explorer, ethers.Wallet.createRandom().address, new ChainMetadataManager(chainMetadata), testLogger);
-        await expect(guard.rebalance(routes)).to.be.rejectedWith('Explorer HTTP 405');
-        expect(explorerSpy.calledOnce).to.be.true;
-        expect(rebalanceSpy.called).to.be.false;
-    });
-});
-//# sourceMappingURL=WithInflightGuard.test.js.map

package/dist/core/WithInflightGuard.test.js.map

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

package/dist/core/WithSemaphore.d.ts

@@ -1,22 +0,0 @@
-import type { Logger } from 'pino';
-import { type RebalancerConfig } from '../config/RebalancerConfig.js';
-import type { IRebalancer } from '../interfaces/IRebalancer.js';
-import type { RebalancingRoute } from '../interfaces/IStrategy.js';
-/**
- * Prevents frequent rebalancing operations while bridges complete.
- */
-export declare class WithSemaphore implements IRebalancer {
-    private readonly config;
-    private readonly rebalancer;
-    private waitUntil;
-    private executing;
-    private readonly logger;
-    constructor(config: RebalancerConfig, rebalancer: IRebalancer, logger: Logger);
-    /**
-     * Rebalance with timing control
-     * @param routes - Routes to process
-     */
-    rebalance(routes: RebalancingRoute[]): Promise<void>;
-    private getHighestLockTime;
-}
-//# sourceMappingURL=WithSemaphore.d.ts.map

package/dist/core/WithSemaphore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WithSemaphore.d.ts","sourceRoot":"","sources":["../../src/core/WithSemaphore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;GAEG;AACH,qBAAa,aAAc,YAAW,WAAW;IAQ7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAP7B,OAAO,CAAC,SAAS,CAAa;IAE9B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,WAAW,EACxC,MAAM,EAAE,MAAM;IAKhB;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C1D,OAAO,CAAC,kBAAkB;CAgB3B"}