@across-protocol/sdk 4.1.19 → 4.1.22

package/dist/types/providers/solana/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/solana/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/solana/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC"}

package/dist/types/providers/solana/rateLimitedRpcFactory.d.ts

@@ -1,4 +1,4 @@
-import { RpcResponse } from "@solana/web3.js";
+import { RpcResponse, RpcTransport } from "@solana/kit";
 import { Logger } from "winston";
 import { SolanaClusterRpcFactory } from "./baseRpcFactories";
 import { SolanaDefaultRpcFactory } from "./defaultRpcFactory";
@@ -6,7 +6,7 @@ export declare class RateLimitedSolanaRpcFactory extends SolanaClusterRpcFactory
     readonly pctRpcCallsLogged: number;
     readonly logger: Logger;
     private queue;
-    private readonly defaultTransport;
+    protected defaultTransport: RpcTransport;
     constructor(maxConcurrency: number, pctRpcCallsLogged: number, logger: Logger, ...defaultConstructorParams: ConstructorParameters<typeof SolanaDefaultRpcFactory>);
     private wrapSendWithLog;
     createTransport(): <TResponse>(config: Readonly<{

package/dist/types/providers/solana/rateLimitedRpcFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rateLimitedRpcFactory.d.ts","sourceRoot":"","sources":["../../../../src/providers/solana/rateLimitedRpcFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,iBAAiB,CAAC;AAE5D,OAAgB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAM9D,qBAAa,2BAA4B,SAAQ,uBAAuB;IAWpE,QAAQ,CAAC,iBAAiB,EAAE,MAAM;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAVzB,OAAO,CAAC,KAAK,CAAmC;IAGhD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAe;gBAK9C,cAAc,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAEf,EACF,GAAG,wBAAwB,EAAE,qBAAqB,CAAC,OAAO,uBAAuB,CAAC;YAkBtE,eAAe;IA0CtB,eAAe;;;;CAevB"}
+{"version":3,"file":"rateLimitedRpcFactory.d.ts","sourceRoot":"","sources":["../../../../src/providers/solana/rateLimitedRpcFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,OAAgB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAM9D,qBAAa,2BAA4B,SAAQ,uBAAuB;IAWpE,QAAQ,CAAC,iBAAiB,EAAE,MAAM;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAVzB,OAAO,CAAC,KAAK,CAAmC;IAGhD,SAAS,CAAC,gBAAgB,EAAE,YAAY,CAAC;gBAKvC,cAAc,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAEf,EACF,GAAG,wBAAwB,EAAE,qBAAqB,CAAC,OAAO,uBAAuB,CAAC;YAkBtE,eAAe;IA0CtB,eAAe;;;;CAevB"}

package/dist/types/svm/eventsClient.d.ts

@@ -0,0 +1,52 @@
+import web3, { GetSignaturesForAddressApi, RpcTransport } from "@solana/kit";
+import { EventData, EventName, EventWithData } from "./types";
+type GetSignaturesForAddressConfig = Parameters<GetSignaturesForAddressApi["getSignaturesForAddress"]>[1];
+export declare class SvmSpokeEventsClient {
+    private rpc;
+    private svmSpokeAddress;
+    private svmSpokeEventAuthority;
+    /**
+     * Private constructor. Use the async create() method to instantiate.
+     */
+    private constructor();
+    /**
+     * Factory method to asynchronously create an instance of SvmSpokeEventsClient.
+     */
+    static create(rpc: web3.Rpc<web3.SolanaRpcApiFromTransport<RpcTransport>>): Promise<SvmSpokeEventsClient>;
+    /**
+     * Queries events for the SvmSpoke program filtered by event name.
+     *
+     * @param eventName - The name of the event to filter by.
+     * @param fromSlot - Optional starting slot.
+     * @param toSlot - Optional ending slot.
+     * @param options - Options for fetching signatures.
+     * @returns A promise that resolves to an array of events matching the eventName.
+     */
+    queryEvents<T extends EventData>(eventName: EventName, fromSlot?: bigint, toSlot?: bigint, options?: GetSignaturesForAddressConfig): Promise<EventWithData<T>[]>;
+    /**
+     * Queries all events for a specific program.
+     *
+     * @param fromSlot - Optional starting slot.
+     * @param toSlot - Optional ending slot.
+     * @param options - Options for fetching signatures.
+     * @returns A promise that resolves to an array of all events with additional metadata.
+     */
+    private queryAllEvents;
+    /**
+     * Reads events from a transaction signature.
+     *
+     * @param txSignature - The transaction signature.
+     * @param commitment - Commitment level.
+     * @returns A promise that resolves to an array of events.
+     */
+    private readEventsFromSignature;
+    /**
+     * Processes events from a transaction.
+     *
+     * @param txResult - The transaction result.
+     * @returns A promise that resolves to an array of events with their data and name.
+     */
+    private processEventFromTx;
+}
+export {};
+//# sourceMappingURL=eventsClient.d.ts.map

package/dist/types/svm/eventsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventsClient.d.ts","sourceRoot":"","sources":["../../../src/svm/eventsClient.ts"],"names":[],"mappings":"AAGA,OAAO,IAAI,EAAE,EAGX,0BAA0B,EAE1B,YAAY,EAEb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAa9D,KAAK,6BAA6B,GAAG,UAAU,CAAC,0BAA0B,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAI1G,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,GAAG,CAAyD;IACpE,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,sBAAsB,CAAU;IAExC;;OAEG;IACH,OAAO;IAUP;;OAEG;WACiB,MAAM,CACxB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC,GAC1D,OAAO,CAAC,oBAAoB,CAAC;IAYhC;;;;;;;;OAQG;IACU,WAAW,CAAC,CAAC,SAAS,SAAS,EAC1C,SAAS,EAAE,SAAS,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE,6BAAwE,GAChF,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAK9B;;;;;;;OAOG;YACW,cAAc;IAoD5B;;;;;;OAMG;YACW,uBAAuB;IASrC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CAwC3B"}

package/dist/types/svm/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./eventsClient";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/svm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/svm/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/types/svm/types.d.ts

@@ -0,0 +1,30 @@
+import { Signature, Address, UnixTimestamp } from "@solana/kit";
+import { SvmSpokeClient } from "@across-protocol/contracts";
+export type EventData = SvmSpokeClient.BridgedToHubPool | SvmSpokeClient.TokensBridged | SvmSpokeClient.ExecutedRelayerRefundRoot | SvmSpokeClient.RelayedRootBundle | SvmSpokeClient.PausedDeposits | SvmSpokeClient.PausedFills | SvmSpokeClient.SetXDomainAdmin | SvmSpokeClient.EnabledDepositRoute | SvmSpokeClient.FilledRelay | SvmSpokeClient.FundsDeposited | SvmSpokeClient.EmergencyDeletedRootBundle | SvmSpokeClient.RequestedSlowFill | SvmSpokeClient.ClaimedRelayerRefund | SvmSpokeClient.TransferredOwnership;
+export declare enum SVMEventNames {
+    FilledRelay = "FilledRelay",
+    FundsDeposited = "FundsDeposited",
+    EnabledDepositRoute = "EnabledDepositRoute",
+    RelayedRootBundle = "RelayedRootBundle",
+    ExecutedRelayerRefundRoot = "ExecutedRelayerRefundRoot",
+    BridgedToHubPool = "BridgedToHubPool",
+    PausedDeposits = "PausedDeposits",
+    PausedFills = "PausedFills",
+    SetXDomainAdmin = "SetXDomainAdmin",
+    EmergencyDeletedRootBundle = "EmergencyDeletedRootBundle",
+    RequestedSlowFill = "RequestedSlowFill",
+    ClaimedRelayerRefund = "ClaimedRelayerRefund",
+    TokensBridged = "TokensBridged",
+    TransferredOwnership = "TransferredOwnership"
+}
+export type EventName = keyof typeof SVMEventNames;
+export type EventWithData<T extends EventData> = {
+    confirmationStatus: string | null;
+    blockTime: UnixTimestamp | null;
+    signature: Signature;
+    slot: bigint;
+    name: EventName;
+    data: T;
+    program: Address;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/svm/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,MAAM,SAAS,GACjB,cAAc,CAAC,gBAAgB,GAC/B,cAAc,CAAC,aAAa,GAC5B,cAAc,CAAC,yBAAyB,GACxC,cAAc,CAAC,iBAAiB,GAChC,cAAc,CAAC,cAAc,GAC7B,cAAc,CAAC,WAAW,GAC1B,cAAc,CAAC,eAAe,GAC9B,cAAc,CAAC,mBAAmB,GAClC,cAAc,CAAC,WAAW,GAC1B,cAAc,CAAC,cAAc,GAC7B,cAAc,CAAC,0BAA0B,GACzC,cAAc,CAAC,iBAAiB,GAChC,cAAc,CAAC,oBAAoB,GACnC,cAAc,CAAC,oBAAoB,CAAC;AAExC,oBAAY,aAAa;IACvB,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,yBAAyB,8BAA8B;IACvD,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;IAC3B,eAAe,oBAAoB;IACnC,0BAA0B,+BAA+B;IACzD,iBAAiB,sBAAsB;IACvC,oBAAoB,yBAAyB;IAC7C,aAAa,kBAAkB;IAC/B,oBAAoB,yBAAyB;CAC9C;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,aAAa,CAAC;AAEnD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,SAAS,IAAI;IAC/C,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC"}

package/dist/types/svm/utils/events.d.ts

@@ -0,0 +1,10 @@
+import { EventName } from "../types";
+/**
+ * Parses event data from a transaction.
+ */
+export declare function parseEventData(eventData: any): any;
+/**
+ * Gets the event name from a raw name.
+ */
+export declare function getEventName(rawName: string): EventName;
+//# sourceMappingURL=events.d.ts.map

package/dist/types/svm/utils/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/svm/utils/events.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAiB,MAAM,UAAU,CAAC;AAEpD;;GAEG;AAEH,wBAAgB,cAAc,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,CAsBlD;AASD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAGvD"}

package/dist/types/svm/utils/helpers.d.ts

@@ -0,0 +1,6 @@
+import web3, { RpcTransport } from "@solana/kit";
+/**
+ * Helper to determine if the current RPC network is devnet.
+ */
+export declare function isDevnet(rpc: web3.Rpc<web3.SolanaRpcApiFromTransport<RpcTransport>>): Promise<boolean>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/types/svm/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/svm/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAG5G"}

package/dist/types/utils/DepositUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DepositUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/DepositUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAc5G,oBAAY,WAAW;IACrB,gBAAgB,IAAI;IACpB,iBAAiB,IAAA;IACjB,YAAY,IAAA;IACZ,mBAAmB,IAAA;CACpB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GAC1C;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,wBAAsB,6BAA6B,CACjD,eAAe,EAAE,eAAe,EAChC,IAAI,EAAE,IAAI,GAAG,eAAe,EAC5B,KAAK,CAAC,EAAE,yBAAyB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CA6F9B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAAC,GAAG,OAAO,CAE7F;AAED,wBAAgB,gCAAgC,CAC9C,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,eAAe,EAAE,aAAa,GAAG,aAAa,CAAC,GAC7D,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAgB,GAAG,OAAO,CAE/D;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAI9D"}
+{"version":3,"file":"DepositUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/DepositUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAa5G,oBAAY,WAAW;IACrB,gBAAgB,IAAI;IACpB,iBAAiB,IAAA;IACjB,YAAY,IAAA;IACZ,mBAAmB,IAAA;CACpB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GAC1C;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,wBAAsB,6BAA6B,CACjD,eAAe,EAAE,eAAe,EAChC,IAAI,EAAE,IAAI,GAAG,eAAe,EAC5B,KAAK,CAAC,EAAE,yBAAyB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CA6F9B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAAC,GAAG,OAAO,CAE7F;AAED,wBAAgB,gCAAgC,CAC9C,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,eAAe,EAAE,aAAa,GAAG,aAAa,CAAC,GAC7D,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAgB,GAAG,OAAO,CAE/D;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAI9D"}

package/dist/types/utils/JSONUtils.d.ts

@@ -29,4 +29,12 @@ export declare function jsonReplacerWithBigNumbers(_key: string, value: unknown)
  * @returns The converted value
  */
 export declare function jsonReviverWithBigNumbers(_key: string, value: unknown): unknown;
+/**
+ * A replacer for `JSON.stringify` that converts BigInt to a decimal string with 'n' suffix.
+ */
+export declare function jsonReplacerWithBigInts(_key: string, value: unknown): unknown;
+/**
+ * A reviver for `JSON.parse` that converts strings ending in 'n' back to BigInt.
+ */
+export declare function jsonReviverWithBigInts(_key: string, value: unknown): unknown;
 //# sourceMappingURL=JSONUtils.d.ts.map

package/dist/types/utils/JSONUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JSONUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/JSONUtils.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAWlF;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOnE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAoBhF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAU/E"}
+{"version":3,"file":"JSONUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/JSONUtils.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAWlF;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOnE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAoBhF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAU/E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAE7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5E"}

package/dist/types/utils/LogUtils.d.ts

@@ -1,4 +1,6 @@
-import { Logger } from "winston";
+import winston from "winston";
+export declare class Logger extends winston.Logger {
+}
 export type DefaultLogLevels = "debug" | "info" | "warn" | "error";
 type LogParamType = {
     level: DefaultLogLevels;
@@ -9,6 +11,6 @@ type LogParamType = {
     };
     data?: Record<string | number, unknown>;
 };
-export declare function formattedLog(logger: Logger | undefined, { level, message, at: { location, function: fnName }, data }: LogParamType): void;
+export declare function formattedLog(logger: winston.Logger | undefined, { level, message, at: { location, function: fnName }, data }: LogParamType): void;
 export {};
 //# sourceMappingURL=LogUtils.d.ts.map

package/dist/types/utils/LogUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LogUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/LogUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,KAAK,YAAY,GAAG;IAClB,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE;QACF,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,CAAC;AAEF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,GACzE,IAAI,CAQN"}
+{"version":3,"file":"LogUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/LogUtils.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,qBAAa,MAAO,SAAQ,OAAO,CAAC,MAAM;CAAG;AAC7C,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,KAAK,YAAY,GAAG;IAClB,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE;QACF,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,CAAC;AAEF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,EAClC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,GACzE,IAAI,CAQN"}

package/dist/types/utils/SpokeUtils.d.ts

@@ -21,6 +21,15 @@ export declare function getRelayEventKey(data: Omit<RelayData, "message"> & {
     messageHash: string;
     destinationChainId: number;
 }): string;
+export declare function validateFillForDeposit(relayData: Omit<RelayData, "message"> & {
+    messageHash: string;
+    destinationChainId: number;
+}, deposit?: Omit<Deposit, "quoteTimestamp" | "fromLiteChain" | "toLiteChain">): {
+    valid: true;
+} | {
+    valid: false;
+    reason: string;
+};
 /**
  * Find the block range that contains the deposit ID. This is a binary search that searches for the block range
  * that contains the deposit ID.

package/dist/types/utils/SpokeUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpokeUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/SpokeUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,QAAQ,EAAE,oBAAoB,EAAE,SAAS,EAAwB,MAAM,QAAQ,CAAC;AAEpG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAuB,MAAM,kBAAkB,CAAC;AAQlE,KAAK,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;AAEnC;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,gBAAgB,SAA6B,GAC5C,OAAO,CAAC,oBAAoB,CAAC,CAgC/B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,GACrF,MAAM,CAkBR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,CAC7C,eAAe,EAAE,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAwHD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAQlG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CA+BzF;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,SAAS,GAAG;IAAE,kBAAkB,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE3F;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAQ/D;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,QAAQ,EACnB,SAAS,EAAE,SAAS,EACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,EAC5B,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,QAAQ,EACnB,SAAS,EAAE,SAAS,EAAE,EACtB,QAAQ,GAAE,QAAmB,GAC5B,OAAO,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,CAAC,CA8BrC;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,QAAQ,EACnB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgD7B;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,QAAQ,EACnB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAoCpC;AAGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"SpokeUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/SpokeUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,QAAQ,EAAE,oBAAoB,EAAE,SAAS,EAAwB,MAAM,QAAQ,CAAC;AAEpG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAuB,MAAM,kBAAkB,CAAC;AAQlE,KAAK,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;AAEnC;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,gBAAgB,SAA6B,GAC5C,OAAO,CAAC,oBAAoB,CAAC,CAgC/B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,GACrF,MAAM,CAkBR;AAoBD,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,EAC3F,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,GAAG,aAAa,CAAC,GAC1E;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAkBpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,CAC7C,eAAe,EAAE,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAwHD;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAQlG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CA+BzF;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,SAAS,GAAG;IAAE,kBAAkB,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE3F;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAQ/D;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,QAAQ,EACnB,SAAS,EAAE,SAAS,EACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,EAC5B,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,QAAQ,EACnB,SAAS,EAAE,SAAS,EAAE,EACtB,QAAQ,GAAE,QAAmB,GAC5B,OAAO,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,CAAC,CA8BrC;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,QAAQ,EACnB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgD7B;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,QAAQ,EACnB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAoCpC;AAGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/types/utils/index.d.ts

@@ -9,7 +9,6 @@ export * from "./TypeGuards";
 export * from "./TypeUtils";
 export * from "./TokenUtils";
 export * from "./LogUtils";
-export * from "./FlowUtils";
 export * from "./BundleUtils";
 export * from "./JSONUtils";
 export * from "./IPFSUtils";

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@across-protocol/sdk",
   "author": "UMA Team",
-  "version": "4.1.19",
+  "version": "4.1.22",
   "license": "AGPL-3.0",
   "homepage": "https://docs.across.to/reference/sdk",
   "files": [
@@ -12,6 +12,8 @@
     "node": ">=20.18.0"
   },
   "scripts": {
+    "build-bigint-buffer": "[ -d node_modules/bigint-buffer ] && command -v node-gyp > /dev/null && cd node_modules/bigint-buffer && node-gyp configure && node-gyp build || echo 'Skipping bigint-buffer build: folder or node-gyp not found'",
+    "postinstall": "yarn build-bigint-buffer",
     "start": "yarn typechain && nodemon -e ts,tsx,json,js,jsx --watch ./src --ignore ./dist --exec 'yarn dev'",
     "build": "yarn run clean && yarn typechain && yarn run build:cjs & yarn run build:esm & yarn run build:types; wait",
     "dev": "yarn run build:cjs & yarn run build:esm & yarn run build:types; wait",
@@ -101,11 +103,13 @@
   "dependencies": {
     "@across-protocol/across-token": "^1.0.0",
     "@across-protocol/constants": "^3.1.38",
-    "@across-protocol/contracts": "4.0.2",
+    "@across-protocol/contracts": "4.0.3",
+    "@coral-xyz/anchor": "^0.30.1",
     "@eth-optimism/sdk": "^3.3.1",
     "@ethersproject/bignumber": "^5.7.0",
     "@pinata/sdk": "^2.1.0",
-    "@solana/web3.js": "^2.0.0",
+    "@solana/kit": "^2.1.0",
+    "@solana/web3.js": "^1.31.0",
     "@types/mocha": "^10.0.1",
     "@uma/sdk": "^0.34.10",
     "arweave": "^1.14.4",
@@ -116,6 +120,7 @@
     "ethers": "^5.7.2",
     "lodash": "^4.17.21",
     "lodash.get": "^4.4.2",
+    "node-gyp": "^11.0.0",
     "superstruct": "^0.15.4",
     "tslib": "^2.6.2",
     "viem": "^2.21.15"

package/src/addressAggregator/adapters/bybit.ts

@@ -0,0 +1,32 @@
+import { array, defaulted, string, type } from "superstruct";
+import { AddressListAdapter } from "../types";
+import { logError, Logger, fetch } from "./util";
+
+const DEFAULT_URL = "https://hackscan.hackbounty.io/public/hack-address.json";
+
+// This type is a bit message and unweildy. Additional fields representing new chains may be added without notification.
+const bybitResponse = type({
+  "0221": type({
+    eth: defaulted(array(string()), []),
+    bsc: defaulted(array(string()), []),
+    arbi: defaulted(array(string()), []),
+  }),
+});
+
+export class AddressList implements AddressListAdapter {
+  readonly timeout = 2000; // ms
+  readonly retries = 1;
+  readonly name = "bybit";
+
+  constructor(readonly url = DEFAULT_URL) {}
+
+  async update(logger?: Logger): Promise<string[]> {
+    const response = await fetch(this.name, this.url, this.timeout, this.retries);
+    if (!bybitResponse.is(response)) {
+      // nb. don't log the response because it might be very large.
+      return logError(this.name, "Failed to validate response", logger);
+    }
+
+    return [...response["0221"].eth, ...response["0221"].bsc, ...response["0221"].arbi];
+  }
+}

package/src/addressAggregator/adapters/env.ts

@@ -0,0 +1,30 @@
+import { array, defaulted, string } from "superstruct";
+import { AddressListAdapter } from "../types";
+import { Logger, logError } from "./util";
+
+const envConfig = defaulted(array(string()), []);
+
+export class AddressList implements AddressListAdapter {
+  readonly name = "process.env";
+
+  constructor(readonly envVar = "ACROSS_IGNORED_ADDRESSES") {}
+
+  update(logger?: Logger): Promise<string[]> {
+    const config = process.env[this.envVar];
+    if (!config) {
+      return Promise.resolve([]);
+    }
+
+    let addresses: unknown;
+    try {
+      addresses = JSON.parse(config);
+      if (!envConfig.is(addresses)) {
+        return logError(this.name, "Address format validation failure.", logger);
+      }
+    } catch (err) {
+      return logError(this.name, err, logger);
+    }
+
+    return Promise.resolve(addresses);
+  }
+}

package/src/addressAggregator/adapters/file.ts

@@ -0,0 +1,39 @@
+import { readFile } from "node:fs/promises";
+import { array, defaulted, string } from "superstruct";
+import { AddressListAdapter } from "../types";
+import { Logger, logError } from "./util";
+
+const fileConfig = defaulted(array(string()), []);
+
+export class AddressList implements AddressListAdapter {
+  readonly name: string;
+
+  constructor(readonly path = "./addresses.json") {
+    this.name = `fs:${path}`;
+  }
+
+  async update(logger?: Logger): Promise<string[]> {
+    let data: string;
+    try {
+      data = await readFile(this.path, { encoding: "utf8" });
+    } catch (err) {
+      return logError(this.name, err, logger);
+    }
+
+    if (!data) {
+      return logError(this.name, `No addresses found in "${this.path}"`, logger);
+    }
+
+    let addresses: unknown;
+    try {
+      addresses = JSON.parse(data);
+      if (!fileConfig.is(addresses)) {
+        return logError(this.name, "Address format validation failure.", logger);
+      }
+    } catch (err) {
+      return logError(this.name, err, logger);
+    }
+
+    return Promise.resolve(addresses);
+  }
+}

package/src/addressAggregator/adapters/index.ts

@@ -0,0 +1,3 @@
+export * as bybit from "./bybit";
+export * as processEnv from "./env";
+export * as fs from "./file";

package/src/addressAggregator/adapters/util.ts

@@ -0,0 +1,47 @@
+import axios from "axios";
+import { Logger } from "../../utils";
+
+export { Logger } from "../../utils";
+
+const { ACROSS_USER_AGENT = "across-protocol" } = process.env;
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+export function logError(name: string, error: unknown, logger?: Logger): Promise<string[]> {
+  let reason: string;
+  if (error instanceof Error) {
+    reason = error.message;
+  } else {
+    reason = typeof error === "string" ? error : "unknown error";
+  }
+
+  logger?.warn({
+    at: `${name}::update`,
+    message: `Failed to read addresses from ${name}.`,
+    reason,
+  });
+  return Promise.resolve([]);
+}
+
+export async function fetch(name: string, url: string, timeout = 2000, retries = 1): Promise<unknown> {
+  const args = {
+    headers: { "User-Agent": ACROSS_USER_AGENT },
+    timeout,
+  };
+
+  const errs: string[] = [];
+  let tries = 0;
+  do {
+    try {
+      return (await axios(url, args)).data;
+    } catch (err) {
+      const errMsg = axios.isAxiosError(err) || err instanceof Error ? err.message : "unknown error";
+      errs.push(errMsg);
+      if (++tries <= retries) await sleep(Math.pow(1.5, tries) * 1000); // simple backoff
+    }
+  } while (tries <= retries);
+
+  throw new Error(`${name} retrieval failure (${errs.join(", ")})`);
+}

package/src/addressAggregator/index.ts

@@ -0,0 +1,86 @@
+import { utils as ethersUtils } from "ethers";
+import { Logger, mapAsync } from "../utils";
+import { AddressListAdapter, INVALID_ADDRESS } from "./types";
+import * as adapters from "./adapters";
+
+export * as adapters from "./adapters";
+
+export class AddressAggregator {
+  constructor(
+    readonly adapters: AddressListAdapter[],
+    protected readonly logger?: Logger
+  ) {}
+
+  static sources(): string[] {
+    return Object.keys(adapters);
+  }
+
+  async update(): Promise<Set<string>> {
+    this.logger?.debug({
+      at: "AddressAggregator::update",
+      message: "Updating addresses.",
+      sources: this.adapters.map((adapter) => adapter.name),
+      supportedSources: AddressAggregator.sources(),
+    });
+
+    const allAddresses = await mapAsync(this.adapters, async (adapter) => {
+      const invalidAddresses: string[] = [];
+      const addresses = (await adapter.update(this.logger))
+        .map((address) => {
+          try {
+            return ethersUtils.getAddress(address.toLowerCase());
+          } catch {
+            invalidAddresses.push(address);
+            return INVALID_ADDRESS;
+          }
+        })
+        .filter((address) => address !== INVALID_ADDRESS);
+
+      if (invalidAddresses.length > 0) {
+        this.logger?.warn({
+          at: "AddressAggregator::update()",
+          message: `Read ${invalidAddresses.length} malformed addresses on ${adapter.name}.`,
+          invalidAddresses,
+        });
+      }
+
+      this.logger?.debug({
+        at: "AddressAggregator::update",
+        message: `Loaded ${addresses.length} addresses from ${adapter.name}.`,
+      });
+
+      return addresses;
+    });
+
+    // Dedup the aggregated, normalised, filtered set of addresses.
+    const addresses = new Set(allAddresses.flat());
+
+    this.logger?.debug({
+      at: "AddressAggregator::update",
+      message: `Loaded ${addresses.size} addresses.`,
+      sources: this.adapters.map((adapter) => adapter.name),
+    });
+
+    return addresses;
+  }
+}
+
+async function run(): Promise<number> {
+  const addressList = new AddressAggregator([new adapters.bybit.AddressList(), new adapters.processEnv.AddressList()]);
+
+  const addresses = await addressList.update();
+  console.log(`Retrieved ${addresses.size} addresses: ${JSON.stringify(Array.from(addresses), null, 2)}`);
+
+  return 0;
+}
+
+if (require.main === module) {
+  run()
+    .then((result: number) => {
+      process.exitCode = result;
+    })
+    .catch((error) => {
+      console.error("Process exited with", error);
+      process.exitCode = 127;
+    });
+}

package/src/addressAggregator/types.ts

@@ -0,0 +1,8 @@
+import { Logger } from "../utils";
+
+export interface AddressListAdapter {
+  readonly name: string;
+  update(logger?: Logger): Promise<string[]>;
+}
+
+export const INVALID_ADDRESS = "";

package/src/caching/Memory/MemoryCacheClient.ts

@@ -0,0 +1,35 @@
+import { CachingMechanismInterface } from "../../interfaces";
+
+interface CacheEntry {
+  value: unknown;
+  expiresAt?: number | null;
+}
+
+/**
+ * A simple in-memory cache client that stores values in a map with TTL support.
+ */
+export class MemoryCacheClient implements CachingMechanismInterface {
+  private cache: Map<string, CacheEntry> = new Map();
+
+  get<T>(key: string): Promise<T | null> {
+    return new Promise((resolve) => {
+      const entry = this.cache.get(key);
+      if (entry === undefined) return resolve(null);
+
+      if (entry.expiresAt && entry.expiresAt < Date.now()) {
+        this.cache.delete(key);
+        return resolve(null);
+      }
+
+      resolve(entry.value as T);
+    });
+  }
+
+  set<T>(key: string, value: T, ttl?: number): Promise<string | undefined> {
+    return new Promise((resolve) => {
+      const expiresAt = ttl ? Date.now() + ttl * 1000 : null;
+      this.cache.set(key, { value, expiresAt });
+      resolve(key);
+    });
+  }
+}

package/src/caching/Memory/index.ts

@@ -0,0 +1 @@
+export * from "./MemoryCacheClient";

package/src/caching/index.ts

@@ -1,2 +1,3 @@
 export * from "./IPFS";
 export * from "./Arweave";
+export * from "./Memory";

package/src/clients/HubPoolClient.ts

@@ -510,14 +510,14 @@ export class HubPoolClient extends BaseAbstractClient {
     return this.getTokenInfoForL1Token(l1TokenCounterpart);
   }
 
-  getTokenInfoForDeposit(deposit: Deposit): L1Token | undefined {
+  getTokenInfoForDeposit(deposit: Pick<Deposit, "inputToken" | "originChainId">): L1Token | undefined {
     return this.getTokenInfoForL1Token(
       this.getL1TokenForL2TokenAtBlock(deposit.inputToken, deposit.originChainId, this.latestBlockSearched)
     );
   }
 
   getTokenInfo(chainId: number | string, tokenAddress: string): L1Token | undefined {
-    const deposit = { originChainId: parseInt(chainId.toString()), inputToken: tokenAddress } as Deposit;
+    const deposit = { originChainId: parseInt(chainId.toString()), inputToken: tokenAddress };
     return this.getTokenInfoForDeposit(deposit);
   }