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

package/dist/core/WithInflightGuard.d.ts

@@ -0,0 +1,20 @@
+import type { Logger } from 'pino';
+import { ChainMetadataManager } from '@hyperlane-xyz/sdk';
+import { RebalancerConfig } from '../config/RebalancerConfig.js';
+import type { IRebalancer } from '../interfaces/IRebalancer.js';
+import type { RebalancingRoute } from '../interfaces/IStrategy.js';
+import { 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

@@ -0,0 +1 @@
+{"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,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;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

@@ -0,0 +1,47 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

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

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

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

package/dist/core/WithInflightGuard.test.js

@@ -0,0 +1,64 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,22 @@
+import type { Logger } from 'pino';
+import { 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

@@ -0,0 +1 @@
+{"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,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,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"}

package/dist/core/WithSemaphore.js

@@ -0,0 +1,67 @@
+/**
+ * Prevents frequent rebalancing operations while bridges complete.
+ */
+export class WithSemaphore {
+    config;
+    rebalancer;
+    // Timestamp until which rebalancing should be blocked
+    waitUntil = 0;
+    // Lock to prevent concurrent rebalance execution
+    executing = false;
+    logger;
+    constructor(config, rebalancer, logger) {
+        this.config = config;
+        this.rebalancer = rebalancer;
+        this.logger = logger.child({ class: WithSemaphore.name });
+    }
+    /**
+     * Rebalance with timing control
+     * @param routes - Routes to process
+     */
+    async rebalance(routes) {
+        if (this.executing) {
+            this.logger.info('Currently executing rebalance. Skipping.');
+            return;
+        }
+        // No routes mean the system is balanced so we reset the timer to allow new rebalancing
+        if (!routes.length) {
+            this.logger.info('No routes to execute. Assuming rebalance is complete. Resetting semaphore timer.');
+            this.waitUntil = 0;
+            return;
+        }
+        // Skip if still in waiting period
+        if (Date.now() < this.waitUntil) {
+            this.logger.info('Still in waiting period. Skipping rebalance.');
+            return;
+        }
+        // The wait period will be determined by the bridge with the highest wait tolerance
+        const highestTolerance = this.getHighestLockTime(routes);
+        try {
+            // Execute rebalance
+            this.executing = true;
+            await this.rebalancer.rebalance(routes);
+        }
+        finally {
+            this.executing = false;
+        }
+        // Set new waiting period
+        this.waitUntil = Date.now() + highestTolerance;
+        this.logger.info({
+            highestTolerance,
+            waitUntil: this.waitUntil,
+        }, 'Rebalance semaphore locked');
+    }
+    getHighestLockTime(routes) {
+        return routes.reduce((highest, route) => {
+            const origin = this.config.strategyConfig.chains[route.origin];
+            if (!origin) {
+                this.logger.error({ route }, 'Chain not found in config. Skipping.');
+                throw new Error(`Chain ${route.origin} not found in config`);
+            }
+            const bridgeLockTime = origin.bridgeLockTime;
+            const overrideLockTime = origin.override?.[route.destination]?.bridgeLockTime ?? 0;
+            return Math.max(highest, bridgeLockTime, overrideLockTime);
+        }, 0);
+    }
+}
+//# sourceMappingURL=WithSemaphore.js.map

package/dist/core/WithSemaphore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WithSemaphore.js","sourceRoot":"","sources":["../../src/core/WithSemaphore.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,OAAO,aAAa;IAQL;IACA;IARnB,sDAAsD;IAC9C,SAAS,GAAW,CAAC,CAAC;IAC9B,iDAAiD;IACzC,SAAS,GAAY,KAAK,CAAC;IAClB,MAAM,CAAS;IAEhC,YACmB,MAAwB,EACxB,UAAuB,EACxC,MAAc;QAFG,WAAM,GAAN,MAAM,CAAkB;QACxB,eAAU,GAAV,UAAU,CAAa;QAGxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,MAA0B;QACxC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YAE7D,OAAO;QACT,CAAC;QAED,uFAAuF;QACvF,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,kFAAkF,CACnF,CAAC;YAEF,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QAED,kCAAkC;QAClC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAEjE,OAAO;QACT,CAAC;QAED,mFAAmF;QACnF,MAAM,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAEzD,IAAI,CAAC;YACH,oBAAoB;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACzB,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC;QAE/C,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;YACE,gBAAgB;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,EACD,4BAA4B,CAC7B,CAAC;IACJ,CAAC;IAEO,kBAAkB,CAAC,MAA0B;QACnD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAE/D,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,sCAAsC,CAAC,CAAC;gBACrE,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,CAAC,MAAM,sBAAsB,CAAC,CAAC;YAC/D,CAAC;YAED,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;YAC7C,MAAM,gBAAgB,GACpB,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,cAAc,IAAI,CAAC,CAAC;YAE5D,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;QAC7D,CAAC,EAAE,CAAC,CAAC,CAAC;IACR,CAAC;CACF"}

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

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

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

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

package/dist/core/WithSemaphore.test.js

@@ -0,0 +1,83 @@
+import chai, { expect } from 'chai';
+import chaiAsPromised from 'chai-as-promised';
+import { pino } from 'pino';
+import Sinon from 'sinon';
+import { RebalancerStrategyOptions } from '@hyperlane-xyz/sdk';
+import { MockRebalancer, buildTestConfig } from '../test/helpers.js';
+import { WithSemaphore } from './WithSemaphore.js';
+chai.use(chaiAsPromised);
+const testLogger = pino({ level: 'silent' });
+describe('WithSemaphore', () => {
+    it('should call the underlying rebalancer', async () => {
+        const config = buildTestConfig();
+        const routes = [
+            {
+                origin: 'chain1',
+            },
+        ];
+        const rebalancer = new MockRebalancer();
+        const rebalanceSpy = Sinon.spy(rebalancer, 'rebalance');
+        const withSemaphore = new WithSemaphore(config, rebalancer, testLogger);
+        await withSemaphore.rebalance(routes);
+        expect(rebalanceSpy.calledOnce).to.be.true;
+        expect(rebalanceSpy.calledWith(routes)).to.be.true;
+    });
+    it('should return early if there are no routes', async () => {
+        const config = buildTestConfig();
+        const rebalancer = new MockRebalancer();
+        const rebalanceSpy = Sinon.spy(rebalancer, 'rebalance');
+        const withSemaphore = new WithSemaphore(config, rebalancer, testLogger);
+        await withSemaphore.rebalance([]);
+        expect(rebalanceSpy.calledOnce).to.be.false;
+    });
+    it('should return early if rebalance occurs before waitUntil is reached', async () => {
+        const config = buildTestConfig();
+        const routes = [
+            {
+                origin: 'chain1',
+            },
+        ];
+        const rebalancer = new MockRebalancer();
+        const rebalanceSpy = Sinon.spy(rebalancer, 'rebalance');
+        const withSemaphore = new WithSemaphore(config, rebalancer, testLogger);
+        await withSemaphore.rebalance(routes);
+        expect(rebalanceSpy.calledOnce).to.be.true;
+        expect(rebalanceSpy.calledWith(routes)).to.be.true;
+        rebalanceSpy.resetHistory();
+        await withSemaphore.rebalance(routes);
+        expect(rebalanceSpy.calledOnce).to.be.false;
+    });
+    it('should throw if a chain is missing', async () => {
+        const config = buildTestConfig({
+            strategyConfig: {
+                rebalanceStrategy: RebalancerStrategyOptions.Weighted,
+                chains: {},
+            },
+        });
+        const routes = [
+            {
+                origin: 'chain1',
+            },
+        ];
+        const rebalancer = new MockRebalancer();
+        const withSemaphore = new WithSemaphore(config, rebalancer, testLogger);
+        await expect(withSemaphore.rebalance(routes)).to.be.rejectedWith(`Chain ${routes[0].origin} not found in config`);
+    });
+    it('should not execute if another rebalance is currently executing', async () => {
+        const config = buildTestConfig();
+        const routes = [
+            {
+                origin: 'chain1',
+            },
+        ];
+        const rebalancer = new MockRebalancer();
+        const rebalanceSpy = Sinon.spy(rebalancer, 'rebalance');
+        const withSemaphore = new WithSemaphore(config, rebalancer, testLogger);
+        const rebalancePromise1 = withSemaphore.rebalance(routes);
+        const rebalancePromise2 = withSemaphore.rebalance(routes);
+        await rebalancePromise1;
+        await rebalancePromise2;
+        expect(rebalanceSpy.calledOnce).to.be.true;
+    });
+});
+//# sourceMappingURL=WithSemaphore.test.js.map

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

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

package/dist/factories/RebalancerContextFactory.d.ts

@@ -0,0 +1,41 @@
+import { Logger } from 'pino';
+import { IRegistry } from '@hyperlane-xyz/registry';
+import { MultiProtocolProvider, MultiProvider, type Token, WarpCore } from '@hyperlane-xyz/sdk';
+import { RebalancerConfig } from '../config/RebalancerConfig.js';
+import type { IRebalancer } from '../interfaces/IRebalancer.js';
+import type { IStrategy } from '../interfaces/IStrategy.js';
+import { Metrics } from '../metrics/Metrics.js';
+import { Monitor } from '../monitor/Monitor.js';
+export declare class RebalancerContextFactory {
+    private readonly config;
+    private readonly warpCore;
+    private readonly tokensByChainName;
+    private readonly multiProvider;
+    private readonly registry;
+    private readonly logger;
+    /**
+     * @param config - The rebalancer config
+     * @param warpCore - An instance of `WarpCore` configured for the specified `warpRouteId`.
+     * @param tokensByChainName - A map of chain->token to ease the lookup of token by chain
+     * @param multiProvider - MultiProvider instance
+     * @param registry - IRegistry instance
+     * @param logger - Logger instance
+     */
+    private constructor();
+    /**
+     * @param config - The rebalancer config
+     * @param multiProvider - MultiProvider instance
+     * @param multiProtocolProvider - MultiProtocolProvider instance (optional, created from multiProvider if not provided)
+     * @param registry - IRegistry instance
+     * @param logger - Logger instance
+     */
+    static create(config: RebalancerConfig, multiProvider: MultiProvider, multiProtocolProvider: MultiProtocolProvider | undefined, registry: IRegistry, logger: Logger): Promise<RebalancerContextFactory>;
+    getWarpCore(): WarpCore;
+    getTokenForChain(chainName: string): Token | undefined;
+    createMetrics(coingeckoApiKey?: string): Promise<Metrics>;
+    createMonitor(checkFrequency: number): Monitor;
+    createStrategy(metrics?: Metrics): Promise<IStrategy>;
+    createRebalancer(metrics?: Metrics): IRebalancer;
+    private getInitialTotalCollateral;
+}
+//# sourceMappingURL=RebalancerContextFactory.d.ts.map

package/dist/factories/RebalancerContextFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RebalancerContextFactory.d.ts","sourceRoot":"","sources":["../../src/factories/RebalancerContextFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAEL,qBAAqB,EACrB,aAAa,EACb,KAAK,KAAK,EACV,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIhD,qBAAa,wBAAwB;IAUjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAdzB;;;;;;;OAOG;IACH,OAAO;IASP;;;;;;OAMG;WACiB,MAAM,CACxB,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,aAAa,EAC5B,qBAAqB,EAAE,qBAAqB,GAAG,SAAS,EACxD,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC;IA8C7B,WAAW,IAAI,QAAQ;IAIvB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIhD,aAAa,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB/D,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAWxC,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAiB3D,gBAAgB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,WAAW;YA8BzC,yBAAyB;CAoBxC"}

package/dist/factories/RebalancerContextFactory.js

@@ -0,0 +1,115 @@
+import { MultiProtocolProvider, WarpCore, } from '@hyperlane-xyz/sdk';
+import { objMap } from '@hyperlane-xyz/utils';
+import { Rebalancer } from '../core/Rebalancer.js';
+import { WithSemaphore } from '../core/WithSemaphore.js';
+import { Metrics } from '../metrics/Metrics.js';
+import { PriceGetter } from '../metrics/PriceGetter.js';
+import { Monitor } from '../monitor/Monitor.js';
+import { StrategyFactory } from '../strategy/StrategyFactory.js';
+import { isCollateralizedTokenEligibleForRebalancing } from '../utils/index.js';
+export class RebalancerContextFactory {
+    config;
+    warpCore;
+    tokensByChainName;
+    multiProvider;
+    registry;
+    logger;
+    /**
+     * @param config - The rebalancer config
+     * @param warpCore - An instance of `WarpCore` configured for the specified `warpRouteId`.
+     * @param tokensByChainName - A map of chain->token to ease the lookup of token by chain
+     * @param multiProvider - MultiProvider instance
+     * @param registry - IRegistry instance
+     * @param logger - Logger instance
+     */
+    constructor(config, warpCore, tokensByChainName, multiProvider, registry, logger) {
+        this.config = config;
+        this.warpCore = warpCore;
+        this.tokensByChainName = tokensByChainName;
+        this.multiProvider = multiProvider;
+        this.registry = registry;
+        this.logger = logger;
+    }
+    /**
+     * @param config - The rebalancer config
+     * @param multiProvider - MultiProvider instance
+     * @param multiProtocolProvider - MultiProtocolProvider instance (optional, created from multiProvider if not provided)
+     * @param registry - IRegistry instance
+     * @param logger - Logger instance
+     */
+    static async create(config, multiProvider, multiProtocolProvider, registry, logger) {
+        logger.debug({
+            warpRouteId: config.warpRouteId,
+        }, 'Creating RebalancerContextFactory');
+        const addresses = await registry.getAddresses();
+        // The Sealevel warp adapters require the Mailbox address, so we
+        // get mailboxes for all chains and merge them with the chain metadata.
+        const mailboxes = objMap(addresses, (_, { mailbox }) => ({ mailbox }));
+        // Create MultiProtocolProvider (convert from MultiProvider if not provided)
+        const mpp = multiProtocolProvider ??
+            MultiProtocolProvider.fromMultiProvider(multiProvider);
+        const provider = mpp.extendChainMetadata(mailboxes);
+        const warpCoreConfig = await registry.getWarpRoute(config.warpRouteId);
+        if (!warpCoreConfig) {
+            throw new Error(`Warp route config for ${config.warpRouteId} not found in registry`);
+        }
+        const warpCore = WarpCore.FromConfig(provider, warpCoreConfig);
+        const tokensByChainName = Object.fromEntries(warpCore.tokens.map((t) => [t.chainName, t]));
+        logger.debug({
+            warpRouteId: config.warpRouteId,
+        }, 'RebalancerContextFactory created successfully');
+        return new RebalancerContextFactory(config, warpCore, tokensByChainName, multiProvider, registry, logger);
+    }
+    getWarpCore() {
+        return this.warpCore;
+    }
+    getTokenForChain(chainName) {
+        return this.tokensByChainName[chainName];
+    }
+    async createMetrics(coingeckoApiKey) {
+        this.logger.debug({ warpRouteId: this.config.warpRouteId }, 'Creating Metrics');
+        const tokenPriceGetter = PriceGetter.create(this.multiProvider.metadata, this.logger, coingeckoApiKey);
+        const warpDeployConfig = await this.registry.getWarpDeployConfig(this.config.warpRouteId);
+        return new Metrics(tokenPriceGetter, warpDeployConfig, this.warpCore, this.config.warpRouteId, this.logger);
+    }
+    createMonitor(checkFrequency) {
+        this.logger.debug({
+            warpRouteId: this.config.warpRouteId,
+            checkFrequency: checkFrequency,
+        }, 'Creating Monitor');
+        return new Monitor(checkFrequency, this.warpCore, this.logger);
+    }
+    async createStrategy(metrics) {
+        this.logger.debug({
+            warpRouteId: this.config.warpRouteId,
+            strategyType: this.config.strategyConfig.rebalanceStrategy,
+        }, 'Creating Strategy');
+        return StrategyFactory.createStrategy(this.config.strategyConfig, this.tokensByChainName, await this.getInitialTotalCollateral(), this.logger, metrics);
+    }
+    createRebalancer(metrics) {
+        this.logger.debug({ warpRouteId: this.config.warpRouteId }, 'Creating Rebalancer');
+        const rebalancer = new Rebalancer(objMap(this.config.strategyConfig.chains, (_, v) => ({
+            bridge: v.bridge,
+            bridgeMinAcceptedAmount: v.bridgeMinAcceptedAmount ?? 0,
+            bridgeIsWarp: v.bridgeIsWarp ?? false,
+            override: v.override,
+        })), this.warpCore, this.multiProvider.metadata, this.tokensByChainName, this.multiProvider, this.logger, metrics);
+        // Wrap with semaphore for concurrency control
+        const withSemaphore = new WithSemaphore(this.config, rebalancer, this.logger);
+        return withSemaphore;
+    }
+    async getInitialTotalCollateral() {
+        let initialTotalCollateral = 0n;
+        const chainNames = new Set(Object.keys(this.config.strategyConfig.chains));
+        await Promise.all(this.warpCore.tokens.map(async (token) => {
+            if (isCollateralizedTokenEligibleForRebalancing(token) &&
+                chainNames.has(token.chainName)) {
+                const adapter = token.getHypAdapter(this.warpCore.multiProvider);
+                const bridgedSupply = await adapter.getBridgedSupply();
+                initialTotalCollateral += bridgedSupply ?? 0n;
+            }
+        }));
+        return initialTotalCollateral;
+    }
+}
+//# sourceMappingURL=RebalancerContextFactory.js.map

package/dist/factories/RebalancerContextFactory.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @hyperlane-xyz/rebalancer
+ *
+ * Hyperlane Warp Route Collateral Rebalancer
+ *
+ * This package provides functionality for automatically rebalancing collateral
+ * across Hyperlane warp routes to maintain optimal token distribution.
+ */
+export { RebalancerService } from './core/RebalancerService.js';
+export type { RebalancerServiceConfig, ManualRebalanceRequest, } from './core/RebalancerService.js';
+export { Rebalancer } from './core/Rebalancer.js';
+export { WithInflightGuard } from './core/WithInflightGuard.js';
+export { WithSemaphore } from './core/WithSemaphore.js';
+export { RebalancerConfig } from './config/RebalancerConfig.js';
+export { BaseStrategy } from './strategy/BaseStrategy.js';
+export { WeightedStrategy } from './strategy/WeightedStrategy.js';
+export { MinAmountStrategy } from './strategy/MinAmountStrategy.js';
+export { StrategyFactory } from './strategy/StrategyFactory.js';
+export { Monitor } from './monitor/Monitor.js';
+export { Metrics } from './metrics/Metrics.js';
+export { PriceGetter } from './metrics/PriceGetter.js';
+export type { IRebalancer, PreparedTransaction, } from './interfaces/IRebalancer.js';
+export type { IStrategy, RebalancingRoute, RawBalances, } from './interfaces/IStrategy.js';
+export type { IMonitor } from './interfaces/IMonitor.js';
+export { MonitorEventType, MonitorEvent, MonitorPollingError, MonitorStartError, } from './interfaces/IMonitor.js';
+export type { IMetrics } from './interfaces/IMetrics.js';
+export { getBridgeConfig } from './utils/bridgeUtils.js';
+export type { BridgeConfigWithOverride, BridgeConfig, } from './utils/bridgeUtils.js';
+export { getRawBalances } from './utils/balanceUtils.js';
+export { isCollateralizedTokenEligibleForRebalancing } from './utils/tokenUtils.js';
+export { ExplorerClient } from './utils/ExplorerClient.js';
+export { RebalancerContextFactory } from './factories/RebalancerContextFactory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,YAAY,EACV,WAAW,EACX,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,WAAW,GACZ,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EACV,wBAAwB,EACxB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,2CAA2C,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+/**
+ * @hyperlane-xyz/rebalancer
+ *
+ * Hyperlane Warp Route Collateral Rebalancer
+ *
+ * This package provides functionality for automatically rebalancing collateral
+ * across Hyperlane warp routes to maintain optimal token distribution.
+ */
+// Core service
+export { RebalancerService } from './core/RebalancerService.js';
+// Core rebalancing logic
+export { Rebalancer } from './core/Rebalancer.js';
+export { WithInflightGuard } from './core/WithInflightGuard.js';
+export { WithSemaphore } from './core/WithSemaphore.js';
+// Configuration
+export { RebalancerConfig } from './config/RebalancerConfig.js';
+// Strategy
+export { BaseStrategy } from './strategy/BaseStrategy.js';
+export { WeightedStrategy } from './strategy/WeightedStrategy.js';
+export { MinAmountStrategy } from './strategy/MinAmountStrategy.js';
+export { StrategyFactory } from './strategy/StrategyFactory.js';
+// Monitor
+export { Monitor } from './monitor/Monitor.js';
+// Metrics
+export { Metrics } from './metrics/Metrics.js';
+export { PriceGetter } from './metrics/PriceGetter.js';
+export { MonitorEventType, MonitorPollingError, MonitorStartError, } from './interfaces/IMonitor.js';
+// Utils
+export { getBridgeConfig } from './utils/bridgeUtils.js';
+export { getRawBalances } from './utils/balanceUtils.js';
+export { isCollateralizedTokenEligibleForRebalancing } from './utils/tokenUtils.js';
+export { ExplorerClient } from './utils/ExplorerClient.js';
+// Factory
+export { RebalancerContextFactory } from './factories/RebalancerContextFactory.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAMhE,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAavD,OAAO,EACL,gBAAgB,EAEhB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAGlC,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAKzD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,2CAA2C,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,UAAU;AACV,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/interfaces/IMetrics.d.ts

@@ -0,0 +1,5 @@
+import { MonitorEvent } from './IMonitor.js';
+export interface IMetrics {
+    processToken(tokenInfo: MonitorEvent['tokensInfo'][number]): Promise<void>;
+}
+//# sourceMappingURL=IMetrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IMetrics.d.ts","sourceRoot":"","sources":["../../src/interfaces/IMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,QAAQ;IACvB,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E"}

package/dist/interfaces/IMetrics.js

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