@humanode-hyperlane/rebalancer 27.2.2 → 1029.1.1

package/dist/tracking/pendingTransferMiddlewares/buildPendingTransferMiddlewares.d.ts

@@ -0,0 +1,25 @@
+import type { Logger } from 'pino';
+import type { MultiProvider } from '@humanode-hyperlane/sdk';
+import { type PendingTransferMiddlewareConfig } from '../../config/types.js';
+import type { IExplorerClient } from '../../utils/ExplorerClient.js';
+export interface PendingTransferMiddlewareDeps {
+    routersByDomain: Record<number, string>;
+    mailboxByDomain: Record<number, string>;
+    multiProvider: MultiProvider;
+    logger: Logger;
+}
+export interface PendingTransferMiddlewares {
+    client: IExplorerClient;
+    /** Set only when at least one middleware is configured. */
+    isIgnoredTransfer?: (messageId: string) => boolean;
+    /** Set only when at least one middleware is configured. */
+    isIgnoredRebalanceAction?: (messageId: string) => boolean;
+}
+/**
+ * Wraps `inner` with one middleware per configured item. Item 0 is the
+ * innermost middleware, so it sees the raw Explorer result first and each
+ * later item sees only what the earlier ones kept. With no items, `inner` is
+ * returned unchanged.
+ */
+export declare function buildPendingTransferMiddlewares(inner: IExplorerClient, configs: PendingTransferMiddlewareConfig[], deps: PendingTransferMiddlewareDeps): Promise<PendingTransferMiddlewares>;
+//# sourceMappingURL=buildPendingTransferMiddlewares.d.ts.map

package/dist/tracking/pendingTransferMiddlewares/buildPendingTransferMiddlewares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPendingTransferMiddlewares.d.ts","sourceRoot":"","sources":["../../../src/tracking/pendingTransferMiddlewares/buildPendingTransferMiddlewares.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EACL,KAAK,+BAA+B,EAErC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAMrE,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,2DAA2D;IAC3D,wBAAwB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3D;AA+BD;;;;;GAKG;AACH,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,+BAA+B,EAAE,EAC1C,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,0BAA0B,CAAC,CAoBrC"}

package/dist/tracking/pendingTransferMiddlewares/buildPendingTransferMiddlewares.js

@@ -0,0 +1,41 @@
+import { PendingTransferMiddlewareType, } from '../../config/types.js';
+import { BlacklistIsmMiddleware } from './BlacklistIsmMiddleware.js';
+import { RelayerDenylistMiddleware } from './RelayerDenylistMiddleware.js';
+function createMiddleware(config, inner, deps) {
+    switch (config.type) {
+        case PendingTransferMiddlewareType.RelayerDenylist:
+            return RelayerDenylistMiddleware.create(inner, {
+                url: config.url,
+                refreshIntervalMs: config.refreshIntervalSecs * 1_000,
+            }, deps.logger);
+        case PendingTransferMiddlewareType.BlacklistIsm:
+            return BlacklistIsmMiddleware.create(inner, {
+                refreshIntervalMs: config.refreshIntervalSecs * 1_000,
+                routersByDomain: deps.routersByDomain,
+                mailboxByDomain: deps.mailboxByDomain,
+                multiProvider: deps.multiProvider,
+            }, deps.logger);
+    }
+}
+/**
+ * Wraps `inner` with one middleware per configured item. Item 0 is the
+ * innermost middleware, so it sees the raw Explorer result first and each
+ * later item sees only what the earlier ones kept. With no items, `inner` is
+ * returned unchanged.
+ */
+export async function buildPendingTransferMiddlewares(inner, configs, deps) {
+    let outermost;
+    for (const config of configs) {
+        outermost = await createMiddleware(config, outermost ?? inner, deps);
+    }
+    if (!outermost)
+        return { client: inner };
+    deps.logger.info({ middlewares: configs.map((config) => config.type) }, 'Pending transfer middlewares enabled');
+    const client = outermost;
+    return {
+        client,
+        isIgnoredTransfer: (messageId) => client.isIgnored(messageId),
+        isIgnoredRebalanceAction: (messageId) => client.isIgnoredRebalanceAction(messageId),
+    };
+}
+//# sourceMappingURL=buildPendingTransferMiddlewares.js.map

package/dist/tracking/pendingTransferMiddlewares/buildPendingTransferMiddlewares.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPendingTransferMiddlewares.js","sourceRoot":"","sources":["../../../src/tracking/pendingTransferMiddlewares/buildPendingTransferMiddlewares.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAiB3E,SAAS,gBAAgB,CACvB,MAAuC,EACvC,KAAsB,EACtB,IAAmC;IAEnC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,6BAA6B,CAAC,eAAe;YAChD,OAAO,yBAAyB,CAAC,MAAM,CACrC,KAAK,EACL;gBACE,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,GAAG,KAAK;aACtD,EACD,IAAI,CAAC,MAAM,CACZ,CAAC;QACJ,KAAK,6BAA6B,CAAC,YAAY;YAC7C,OAAO,sBAAsB,CAAC,MAAM,CAClC,KAAK,EACL;gBACE,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,GAAG,KAAK;gBACrD,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,EACD,IAAI,CAAC,MAAM,CACZ,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,KAAsB,EACtB,OAA0C,EAC1C,IAAmC;IAEnC,IAAI,SAAgD,CAAC;IACrD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,SAAS,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,SAAS,IAAI,KAAK,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAEzC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EACrD,sCAAsC,CACvC,CAAC;IAEF,MAAM,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO;QACL,MAAM;QACN,iBAAiB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;QAC7D,wBAAwB,EAAE,CAAC,SAAS,EAAE,EAAE,CACtC,MAAM,CAAC,wBAAwB,CAAC,SAAS,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/dist/tracking/pendingTransferMiddlewares/buildPendingTransferMiddlewares.test.d.ts

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

package/dist/tracking/pendingTransferMiddlewares/buildPendingTransferMiddlewares.test.d.ts.map

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

package/dist/tracking/pendingTransferMiddlewares/buildPendingTransferMiddlewares.test.js

@@ -0,0 +1,141 @@
+import { expect } from 'chai';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { pino } from 'pino';
+import Sinon from 'sinon';
+import { MultiProvider } from '@humanode-hyperlane/sdk';
+import { ProtocolType, assert } from '@humanode-hyperlane/utils';
+import { PendingTransferMiddlewareType, } from '../../config/types.js';
+import { ID_A, ID_B, ID_C, PARAMS, REBALANCE_PARAMS, StubExplorerClient, buildMessage, } from '../../test/pendingTransferMiddlewareMocks.js';
+import { INITIAL_LOAD_RETRY_DELAY_MS } from './RelayerDenylistMiddleware.js';
+import { buildPendingTransferMiddlewares, } from './buildPendingTransferMiddlewares.js';
+describe('buildPendingTransferMiddlewares', () => {
+    const logger = pino({ level: 'silent' });
+    let deps;
+    beforeEach(() => {
+        const multiProvider = Sinon.createStubInstance(MultiProvider);
+        multiProvider.getProtocol.returns(ProtocolType.Ethereum);
+        multiProvider.getProvider.throws(new Error('No provider in this test'));
+        deps = {
+            routersByDomain: { 1: '0x67899664446ccfadf75e0d3f5668be262acd1069' },
+            mailboxByDomain: { 1: '0xc005dc82818d67af737725bd4bf75435d065d239' },
+            multiProvider,
+            logger,
+        };
+    });
+    it('returns the inner client unchanged when no middlewares are configured', async () => {
+        const inner = new StubExplorerClient([]);
+        const result = await buildPendingTransferMiddlewares(inner, [], deps);
+        expect(result.client).to.equal(inner);
+        expect(result.isIgnoredTransfer).to.equal(undefined);
+        expect(result.isIgnoredRebalanceAction).to.equal(undefined);
+    });
+    it('builds layers in config order and unions their ignored ids', async () => {
+        const dir = mkdtempSync(join(tmpdir(), 'pending-transfer-middlewares-'));
+        try {
+            const writeDenylist = (name, ids) => {
+                const path = join(dir, `${name}.json`);
+                writeFileSync(path, JSON.stringify({
+                    rules: ids.map((messageId) => ({
+                        reason: name,
+                        addedBy: 'tester',
+                        match: { messageId },
+                    })),
+                }));
+                return pathToFileURL(path).href;
+            };
+            const configs = [
+                {
+                    type: PendingTransferMiddlewareType.RelayerDenylist,
+                    url: writeDenylist('first', [ID_A, ID_B]),
+                    refreshIntervalSecs: 60,
+                },
+                {
+                    type: PendingTransferMiddlewareType.RelayerDenylist,
+                    url: writeDenylist('second', [ID_A]),
+                    refreshIntervalSecs: 60,
+                },
+            ];
+            const inner = new StubExplorerClient([
+                buildMessage(ID_A),
+                buildMessage(ID_B),
+                buildMessage(ID_C),
+            ]);
+            const queryLogger = pino({ level: 'silent' });
+            const info = Sinon.spy(queryLogger, 'info');
+            inner.rebalanceActions = [buildMessage(ID_B), buildMessage(ID_C)];
+            const { client, isIgnoredTransfer, isIgnoredRebalanceAction } = await buildPendingTransferMiddlewares(inner, configs, deps);
+            const result = await client.getInflightUserTransfers(PARAMS, queryLogger);
+            const rebalanceActions = await client.getInflightRebalanceActions(REBALANCE_PARAMS, queryLogger);
+            expect(result.map((msg) => msg.msg_id)).to.deep.equal([ID_C]);
+            // Item 0 is innermost, so it sees ID_A first and records its reason.
+            const ignoredLogs = info
+                .getCalls()
+                .filter((call) => call.args.includes('Ignoring pending transfer'));
+            expect(ignoredLogs).to.have.lengthOf(2);
+            for (const id of [ID_A, ID_B]) {
+                expect(info.calledWith(Sinon.match({ msgId: id, reason: 'first (added by tester)' }), 'Ignoring pending transfer')).to.be.true;
+            }
+            assert(isIgnoredTransfer, 'Expected an ignored-transfer predicate');
+            expect(isIgnoredTransfer(ID_A)).to.be.true;
+            expect(isIgnoredTransfer(ID_B)).to.be.true;
+            expect(isIgnoredTransfer(ID_C)).to.be.false;
+            expect(rebalanceActions.map((msg) => msg.msg_id)).to.deep.equal([
+                ID_B,
+                ID_C,
+            ]);
+            assert(isIgnoredRebalanceAction, 'Expected an ignored-rebalance-action predicate');
+            expect(isIgnoredRebalanceAction(ID_B)).to.be.true;
+            expect(isIgnoredRebalanceAction(ID_C)).to.be.false;
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+    it('fails when the BlacklistIsm trees cannot be resolved at startup', async () => {
+        const inner = new StubExplorerClient([]);
+        const configs = [
+            {
+                type: PendingTransferMiddlewareType.BlacklistIsm,
+                refreshIntervalSecs: 600,
+            },
+        ];
+        const error = await buildPendingTransferMiddlewares(inner, configs, deps).then(() => expect.fail('Expected buildPendingTransferMiddlewares to throw'), (err) => err);
+        expect(error).to.be.instanceOf(Error);
+        if (error instanceof Error) {
+            expect(error.message).to.equal('Failed to resolve the ISM of router 0x67899664446ccfadf75e0d3f5668be262acd1069 on domain 1: No provider in this test');
+        }
+    });
+    it('fails when a relayer denylist cannot be loaded at startup', async () => {
+        const inner = new StubExplorerClient([]);
+        const configs = [
+            {
+                type: PendingTransferMiddlewareType.RelayerDenylist,
+                url: 'https://example.com/denylist.json',
+                refreshIntervalSecs: 60,
+            },
+        ];
+        // Startup retries a failed fetch after a delay; a stubbed fetch keeps
+        // the faked delays off real I/O.
+        const clock = Sinon.useFakeTimers({
+            toFake: ['setTimeout', 'clearTimeout'],
+        });
+        const fetchStub = Sinon.stub(globalThis, 'fetch').rejects(new Error('getaddrinfo ENOTFOUND example.com'));
+        try {
+            const result = buildPendingTransferMiddlewares(inner, configs, deps).then(() => expect.fail('Expected buildPendingTransferMiddlewares to throw'), (err) => err);
+            await clock.tickAsync(2 * INITIAL_LOAD_RETRY_DELAY_MS);
+            const error = await result;
+            expect(error).to.be.instanceOf(Error);
+            if (error instanceof Error) {
+                expect(error.message).to.equal('Failed to load relayer denylist from https://example.com/denylist.json (fetch_failed): getaddrinfo ENOTFOUND example.com');
+            }
+        }
+        finally {
+            fetchStub.restore();
+            clock.restore();
+        }
+    });
+});
+//# sourceMappingURL=buildPendingTransferMiddlewares.test.js.map

package/dist/tracking/pendingTransferMiddlewares/buildPendingTransferMiddlewares.test.js.map

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

package/dist/tracking/pendingTransferMiddlewares/matchBody.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns the lowercase hex (without 0x) of the address a `matchBody: true`
+ * rule scans message bodies for. Like the relayer, only 20-byte EVM hex
+ * addresses may opt in.
+ */
+export declare function parseMatchBodyAddress(address: string, matchBody: boolean | undefined): string | undefined;
+/**
+ * Whether the message body contains the address at any byte boundary, like
+ * the relayer's `body.windows(20)` scan.
+ */
+export declare function bodyContainsAddress(messageBody: string, addressHex: string): boolean;
+//# sourceMappingURL=matchBody.d.ts.map

package/dist/tracking/pendingTransferMiddlewares/matchBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchBody.d.ts","sourceRoot":"","sources":["../../../src/tracking/pendingTransferMiddlewares/matchBody.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,GAAG,SAAS,GAC7B,MAAM,GAAG,SAAS,CASpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAYT"}

package/dist/tracking/pendingTransferMiddlewares/matchBody.js

@@ -0,0 +1,29 @@
+import { ethers } from 'ethers';
+import { strip0x } from '@humanode-hyperlane/utils';
+/**
+ * Returns the lowercase hex (without 0x) of the address a `matchBody: true`
+ * rule scans message bodies for. Like the relayer, only 20-byte EVM hex
+ * addresses may opt in.
+ */
+export function parseMatchBodyAddress(address, matchBody) {
+    if (matchBody !== true)
+        return undefined;
+    const trimmed = address.trim();
+    if (!ethers.utils.isHexString(trimmed, 20)) {
+        throw new Error('`matchBody` requires a 20-byte EVM hex address');
+    }
+    return strip0x(trimmed).toLowerCase();
+}
+/**
+ * Whether the message body contains the address at any byte boundary, like
+ * the relayer's `body.windows(20)` scan.
+ */
+export function bodyContainsAddress(messageBody, addressHex) {
+    const body = strip0x(messageBody).toLowerCase();
+    for (let index = body.indexOf(addressHex); index !== -1; index = body.indexOf(addressHex, index + 1)) {
+        if (index % 2 === 0)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=matchBody.js.map

package/dist/tracking/pendingTransferMiddlewares/matchBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchBody.js","sourceRoot":"","sources":["../../../src/tracking/pendingTransferMiddlewares/matchBody.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,SAA8B;IAE9B,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,UAAkB;IAElB,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;IAEhD,KACE,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EACpC,KAAK,KAAK,CAAC,CAAC,EACZ,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,EAC3C,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IACnC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tracking/pendingTransferMiddlewares/relayerDenylistRules.d.ts

@@ -0,0 +1,59 @@
+import { RE2JS } from 're2js';
+import type { ExplorerMessage } from '../../utils/ExplorerClient.js';
+export declare const DenylistLoadFailure: {
+    readonly FetchFailed: 'fetch_failed';
+    readonly InvalidFile: 'invalid_file';
+};
+export type DenylistLoadFailure = (typeof DenylistLoadFailure)[keyof typeof DenylistLoadFailure];
+export declare class DenylistLoadError extends Error {
+    readonly failure: DenylistLoadFailure;
+    constructor(failure: DenylistLoadFailure, message: string);
+}
+/** Unset fields are wildcards. Addresses and ids are lowercase bytes32 hex. */
+export interface DenylistMatchRule {
+    reason: string;
+    expiresAt?: number;
+    messageIds?: ReadonlySet<string>;
+    originDomains?: ReadonlySet<number>;
+    senders?: ReadonlySet<string>;
+    destinationDomains?: ReadonlySet<number>;
+    recipients?: ReadonlySet<string>;
+    /** Tested, unanchored, against the lowercase hex body without 0x. */
+    bodyRegex?: RE2JS;
+}
+export interface DenylistAddressRule {
+    reason: string;
+    expiresAt?: number;
+    address: string;
+    /** Set by `matchBody: true`: lowercase 20-byte hex searched in the body. */
+    bodyAddress?: string;
+}
+export interface DenylistRules {
+    matchRules: DenylistMatchRule[];
+    addressRules: DenylistAddressRule[];
+}
+/** Returns epoch milliseconds, or undefined if not an RFC 3339 timestamp. */
+export declare function parseRfc3339(value: string): number | undefined;
+/**
+ * Parses an address the way the relayer's `hex_or_base58_or_bech32_to_h256`
+ * does, plus its Tron checksum check, into lowercase bytes32 hex.
+ */
+export declare function parseDenylistAddress(value: string): string;
+/**
+ * Parses a runtime denylist file. Throws a `DenylistLoadError` if any rule is
+ * invalid. Expired rules are kept and skipped at match time.
+ */
+export declare function parseDenylistFile(text: string): DenylistRules;
+/**
+ * Returns the reason of the first active rule that denies the message, like
+ * the relayer: `match` rules first, then `address` rules against the sender,
+ * the recipient, the warp transfer recipient (first 32 body bytes), the
+ * origin tx sender and, for `matchBody` rules, anywhere in the body.
+ */
+export declare function findDenyReason(rules: DenylistRules, msg: ExplorerMessage, nowMs: number): string | undefined;
+/**
+ * Returns the reason of the first active `match` rule that sets only
+ * `messageId` and lists the message. Other rules are ignored.
+ */
+export declare function findMessageIdDenyReason(rules: DenylistRules, messageId: string, nowMs: number): string | undefined;
+//# sourceMappingURL=relayerDenylistRules.d.ts.map

package/dist/tracking/pendingTransferMiddlewares/relayerDenylistRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayerDenylistRules.d.ts","sourceRoot":"","sources":["../../../src/tracking/pendingTransferMiddlewares/relayerDenylistRules.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAgB9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AASrE,eAAO,MAAM,mBAAmB;aAC9B,WAAW,EAAE,cAAc;aAC3B,WAAW,EAAE,cAAc;CACnB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjE,qBAAa,iBAAkB,SAAQ,KAAK;IAExC,QAAQ,CAAC,OAAO,EAAE,mBAAmB;IADvC,YACW,OAAO,EAAE,mBAAmB,EACrC,OAAO,EAAE,MAAM,EAIhB;CACF;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,qEAAqE;IACrE,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,YAAY,EAAE,mBAAmB,EAAE,CAAC;CACrC;AAyBD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA4D9D;AAuFD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA8B1D;AA+hBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CA+B7D;AAaD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAiCpB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAapB"}