@across-protocol/sdk 3.0.0

package/dist/cjs/utils/AddressUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressUtils.js","sourceRoot":"","sources":["../../../src/utils/AddressUtils.ts"],"names":[],"mappings":";;;;AAAA,iCAA0C;AAQ1C,SAAsB,2BAA2B,CAAC,OAAe,EAAE,QAA4B;;;;;;oBAE7F,IAAI,CAAC,OAAO,IAAI,CAAC,cAAK,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;wBACzC,WAAO,KAAK,EAAC;qBACd;oBAEY,WAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAA;;oBAAtC,IAAI,GAAG,SAA+B;oBAE5C,WAAO,IAAI,KAAK,IAAI,EAAC;;;;CACtB;AATD,kEASC"}

package/dist/cjs/utils/ArrayUtils.d.ts

@@ -0,0 +1,12 @@
+export declare function dedupArray<T>(array: T[]): T[];
+export declare function chunk<T>(array: T[], chunkSize: number): T[][];
+export declare function findLastIndex<T>(array: T[], predicate: (value: T, index: number, obj: T[]) => boolean): number;
+export declare function findLast<T>(array: T[], predicate: (value: T, index: number, obj: T[]) => boolean): T | undefined;
+export declare function filterAsync<T>(array: T[], predicate: (value: T, index: number, obj: T[]) => Promise<boolean>): Promise<T[]>;
+export declare function mapAsync<T, U>(array: T[], mapper: (value: T, index: number, obj: T[]) => Promise<U>): Promise<U[]>;
+export declare function reduceAsync<T, U>(array: T[], reducer: (accumulator: U, currentValue: T, currentIndex: number, obj: T[]) => Promise<U>, initialValue: U): Promise<U>;
+export declare function forEachAsync<T>(array: T[], callback: (value: T, index: number, obj: T[]) => Promise<void>): Promise<void>;
+export declare function someAsync<T>(array: T[], predicate: (value: T, index: number, obj: T[]) => Promise<boolean>): Promise<boolean>;
+export declare function everyAsync<T>(array: T[], predicate: (value: T, index: number, obj: T[]) => Promise<boolean>): Promise<boolean>;
+export declare function includesAsync<T>(array: T[], predicate: (value: T, index: number, obj: T[]) => Promise<boolean>): Promise<boolean>;
+export declare function isArrayOf<T>(array: unknown, predicate: (value: unknown) => value is T): array is T[];

package/dist/cjs/utils/ArrayUtils.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isArrayOf = exports.includesAsync = exports.everyAsync = exports.someAsync = exports.forEachAsync = exports.reduceAsync = exports.mapAsync = exports.filterAsync = exports.findLast = exports.findLastIndex = exports.chunk = exports.dedupArray = void 0;
+var tslib_1 = require("tslib");
+function dedupArray(array) {
+    return Array.from(new Set(array));
+}
+exports.dedupArray = dedupArray;
+function chunk(array, chunkSize) {
+    var chunks = [];
+    for (var i = 0; i < array.length; i += chunkSize) {
+        chunks.push(array.slice(i, i + chunkSize));
+    }
+    return chunks;
+}
+exports.chunk = chunk;
+function findLastIndex(array, predicate) {
+    for (var i = array.length - 1; i >= 0; i--) {
+        if (predicate(array[i], i, array)) {
+            return i;
+        }
+    }
+    return -1;
+}
+exports.findLastIndex = findLastIndex;
+function findLast(array, predicate) {
+    var index = findLastIndex(array, predicate);
+    return index >= 0 ? array[index] : undefined;
+}
+exports.findLast = findLast;
+function filterAsync(array, predicate) {
+    return tslib_1.__awaiter(this, void 0, void 0, function () {
+        var results;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4, Promise.all(array.map(predicate))];
+                case 1:
+                    results = _a.sent();
+                    return [2, array.filter(function (_, index) { return results[index]; })];
+            }
+        });
+    });
+}
+exports.filterAsync = filterAsync;
+function mapAsync(array, mapper) {
+    return Promise.all(array.map(mapper));
+}
+exports.mapAsync = mapAsync;
+function reduceAsync(array, reducer, initialValue) {
+    return tslib_1.__awaiter(this, void 0, void 0, function () {
+        var accumulator, i;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    accumulator = initialValue;
+                    i = 0;
+                    _a.label = 1;
+                case 1:
+                    if (!(i < array.length)) return [3, 4];
+                    return [4, reducer(accumulator, array[i], i, array)];
+                case 2:
+                    accumulator = _a.sent();
+                    _a.label = 3;
+                case 3:
+                    i++;
+                    return [3, 1];
+                case 4: return [2, accumulator];
+            }
+        });
+    });
+}
+exports.reduceAsync = reduceAsync;
+function forEachAsync(array, callback) {
+    return tslib_1.__awaiter(this, void 0, void 0, function () {
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4, mapAsync(array, callback)];
+                case 1:
+                    _a.sent();
+                    return [2];
+            }
+        });
+    });
+}
+exports.forEachAsync = forEachAsync;
+function someAsync(array, predicate) {
+    return tslib_1.__awaiter(this, void 0, void 0, function () {
+        var results;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4, mapAsync(array, predicate)];
+                case 1:
+                    results = _a.sent();
+                    return [2, results.some(function (value) { return value; })];
+            }
+        });
+    });
+}
+exports.someAsync = someAsync;
+function everyAsync(array, predicate) {
+    return tslib_1.__awaiter(this, void 0, void 0, function () {
+        var _this = this;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4, someAsync(array, function (value, index, obj) { return tslib_1.__awaiter(_this, void 0, void 0, function () { return tslib_1.__generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0: return [4, predicate(value, index, obj)];
+                            case 1: return [2, !(_a.sent())];
+                        }
+                    }); }); })];
+                case 1: return [2, !(_a.sent())];
+            }
+        });
+    });
+}
+exports.everyAsync = everyAsync;
+function includesAsync(array, predicate) {
+    return someAsync(array, predicate);
+}
+exports.includesAsync = includesAsync;
+function isArrayOf(array, predicate) {
+    return Array.isArray(array) && array.every(predicate);
+}
+exports.isArrayOf = isArrayOf;
+//# sourceMappingURL=ArrayUtils.js.map

package/dist/cjs/utils/ArrayUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayUtils.js","sourceRoot":"","sources":["../../../src/utils/ArrayUtils.ts"],"names":[],"mappings":";;;;AAMA,SAAgB,UAAU,CAAI,KAAU;IACtC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACpC,CAAC;AAFD,gCAEC;AAQD,SAAgB,KAAK,CAAI,KAAU,EAAE,SAAiB;IACpD,IAAM,MAAM,GAAU,EAAE,CAAC;IAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE;QAChD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;KAC5C;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AARD,sBAQC;AASD,SAAgB,aAAa,CAAI,KAAU,EAAE,SAAyD;IACpG,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1C,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE;YACjC,OAAO,CAAC,CAAC;SACV;KACF;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAPD,sCAOC;AASD,SAAgB,QAAQ,CAAI,KAAU,EAAE,SAAyD;IAC/F,IAAM,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC9C,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAHD,4BAGC;AASD,SAAsB,WAAW,CAC/B,KAAU,EACV,SAAkE;;;;;wBAElD,WAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAA;;oBAAjD,OAAO,GAAG,SAAuC;oBACvD,WAAO,KAAK,CAAC,MAAM,CAAC,UAAC,CAAC,EAAE,KAAK,IAAK,OAAA,OAAO,CAAC,KAAK,CAAC,EAAd,CAAc,CAAC,EAAC;;;;CACnD;AAND,kCAMC;AASD,SAAgB,QAAQ,CAAO,KAAU,EAAE,MAAyD;IAClG,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACxC,CAAC;AAFD,4BAEC;AAUD,SAAsB,WAAW,CAC/B,KAAU,EACV,OAAwF,EACxF,YAAe;;;;;;oBAEX,WAAW,GAAG,YAAY,CAAC;oBACtB,CAAC,GAAG,CAAC;;;yBAAE,CAAA,CAAC,GAAG,KAAK,CAAC,MAAM,CAAA;oBAChB,WAAM,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAA;;oBAA5D,WAAW,GAAG,SAA8C,CAAC;;;oBAD7B,CAAC,EAAE,CAAA;;wBAGrC,WAAO,WAAW,EAAC;;;;CACpB;AAVD,kCAUC;AASD,SAAsB,YAAY,CAChC,KAAU,EACV,QAA8D;;;;wBAE9D,WAAM,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAA;;oBAA/B,SAA+B,CAAC;;;;;CACjC;AALD,oCAKC;AASD,SAAsB,SAAS,CAC7B,KAAU,EACV,SAAkE;;;;;wBAElD,WAAM,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAA;;oBAA1C,OAAO,GAAG,SAAgC;oBAChD,WAAO,OAAO,CAAC,IAAI,CAAC,UAAC,KAAK,IAAK,OAAA,KAAK,EAAL,CAAK,CAAC,EAAC;;;;CACvC;AAND,8BAMC;AAWD,SAAsB,UAAU,CAC9B,KAAU,EACV,SAAkE;;;;;wBAEzD,WAAM,SAAS,CAAC,KAAK,EAAE,UAAO,KAAK,EAAE,KAAK,EAAE,GAAG;;oCAAO,WAAM,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAA;oCAApC,WAAA,CAAC,CAAC,SAAkC,CAAC,EAAA;;6BAAA,CAAC,EAAA;wBAAnG,WAAO,CAAC,CAAC,SAA0F,CAAC,EAAC;;;;CACtG;AALD,gCAKC;AAUD,SAAgB,aAAa,CAC3B,KAAU,EACV,SAAkE;IAElE,OAAO,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACrC,CAAC;AALD,sCAKC;AASD,SAAgB,SAAS,CAAI,KAAc,EAAE,SAAyC;IACpF,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAFD,8BAEC"}

package/dist/cjs/utils/BigNumberUtils.d.ts

@@ -0,0 +1,8 @@
+import { ethers } from "ethers";
+export type BigNumberish = ethers.BigNumberish;
+export type BN = ethers.BigNumber;
+export declare const bnZero: ethers.BigNumber, bnOne: ethers.BigNumber, bnUint256Max: ethers.BigNumber;
+export declare const bnUint32Max: ethers.BigNumber;
+export declare function toWei(num: BigNumberish): BN;
+export declare function toGWei(num: BigNumberish): BN;
+export declare const toBN: (num: BigNumberish, rounding?: "floor" | "round" | "ceil") => BN;

package/dist/cjs/utils/BigNumberUtils.js

@@ -0,0 +1,26 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBN = exports.toGWei = exports.toWei = exports.bnUint32Max = exports.bnUint256Max = exports.bnOne = exports.bnZero = void 0;
+var ethers_1 = require("ethers");
+exports.bnZero = (_a = ethers_1.ethers.constants, _a.Zero), exports.bnOne = _a.One, exports.bnUint256Max = _a.MaxUint256;
+exports.bnUint32Max = ethers_1.BigNumber.from("0xffffffff");
+function toWei(num) {
+    return ethers_1.ethers.utils.parseEther(num.toString());
+}
+exports.toWei = toWei;
+function toGWei(num) {
+    return ethers_1.ethers.utils.parseUnits(num.toString(), 9);
+}
+exports.toGWei = toGWei;
+var toBN = function (num, rounding) {
+    if (rounding === void 0) { rounding = "floor"; }
+    if (num.toString().includes(".")) {
+        var _a = num.toString().split("."), integer = _a[0], decimal = _a[1];
+        var roundUp = decimal.length > 0 && (rounding === "ceil" || (rounding === "round" && parseInt(decimal[0]) >= 5));
+        return ethers_1.BigNumber.from(integer).add(roundUp ? 1 : 0);
+    }
+    return ethers_1.BigNumber.from(num.toString());
+};
+exports.toBN = toBN;
+//# sourceMappingURL=BigNumberUtils.js.map

package/dist/cjs/utils/BigNumberUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BigNumberUtils.js","sourceRoot":"","sources":["../../../src/utils/BigNumberUtils.ts"],"names":[],"mappings":";;;;AAMA,iCAA2C;AAKtB,QAAA,MAAM,IAAd,KAAyD,eAAM,CAAC,SAAS,YAApD,QAAA,KAAK,WAAc,QAAA,YAAY,iBAAsB;AAE1E,QAAA,WAAW,GAAG,kBAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAOxD,SAAgB,KAAK,CAAC,GAAiB;IACrC,OAAO,eAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;AACjD,CAAC;AAFD,sBAEC;AAOD,SAAgB,MAAM,CAAC,GAAiB;IACtC,OAAO,eAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;AACpD,CAAC;AAFD,wBAEC;AAUM,IAAM,IAAI,GAAG,UAAC,GAAiB,EAAE,QAA8C;IAA9C,yBAAA,EAAA,kBAA8C;IAEpF,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QAE1B,IAAA,KAAqB,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAA7C,OAAO,QAAA,EAAE,OAAO,QAA6B,CAAC;QAMrD,IAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnH,OAAO,kBAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACrD;IAED,OAAO,kBAAS,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC;AAhBW,QAAA,IAAI,QAgBf"}

package/dist/cjs/utils/BlockExplorerUtils.d.ts

@@ -0,0 +1,3 @@
+export declare function blockExplorerLink(txHashOrAddress: string, chainId: number | string): string;
+export declare function resolveBlockExplorerDomain(networkId: number): string | undefined;
+export declare function blockExplorerLinks(txHashesOrAddresses: string[], chainId: number | string): string;

package/dist/cjs/utils/BlockExplorerUtils.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blockExplorerLinks = exports.resolveBlockExplorerDomain = exports.blockExplorerLink = void 0;
+var ethers_1 = require("ethers");
+var constants_1 = require("../constants");
+var FormattingUtils_1 = require("./FormattingUtils");
+var TypeGuards_1 = require("./TypeGuards");
+function blockExplorerLink(txHashOrAddress, chainId) {
+    var _a;
+    return (_a = _createBlockExplorerLinkMarkdown(txHashOrAddress, Number(chainId))) !== null && _a !== void 0 ? _a : "<>";
+}
+exports.blockExplorerLink = blockExplorerLink;
+function resolveBlockExplorerDomain(networkId) {
+    var _a;
+    return (_a = constants_1.PUBLIC_NETWORKS[networkId]) === null || _a === void 0 ? void 0 : _a.blockExplorer;
+}
+exports.resolveBlockExplorerDomain = resolveBlockExplorerDomain;
+function constructURL(domain, parts) {
+    parts = parts.flatMap(function (p) { return p.split("/"); });
+    parts = parts.filter(function (p) { return p !== ""; });
+    var path = parts.join("/");
+    return "".concat(domain, "/").concat(path).replace(/\/+$/, "");
+}
+function _createBlockExplorerLinkMarkdown(hex, chainId) {
+    if (chainId === void 0) { chainId = 1; }
+    var explorerDomain = resolveBlockExplorerDomain(chainId);
+    if (!(0, TypeGuards_1.isDefined)(explorerDomain)) {
+        return "<unsupported chain/hash ".concat(chainId, ":").concat(hex, ">}");
+    }
+    if (hex.substring(0, 2) !== "0x") {
+        hex = "0x".concat(hex);
+    }
+    if (!ethers_1.ethers.utils.isHexString(hex)) {
+        return null;
+    }
+    var shortURLString = (0, FormattingUtils_1.createShortHexString)(hex);
+    for (var _i = 0, _a = [
+        [66, "tx"],
+        [42, "address"],
+    ]; _i < _a.length; _i++) {
+        var _b = _a[_i], length_1 = _b[0], route = _b[1];
+        if (hex.length === length_1) {
+            return "<".concat(constructURL(explorerDomain, [route, hex]), "|").concat(shortURLString, ">");
+        }
+    }
+    return null;
+}
+function blockExplorerLinks(txHashesOrAddresses, chainId) {
+    return txHashesOrAddresses.map(function (hash) { return "".concat(blockExplorerLink(hash, chainId), "\n"); }).join("");
+}
+exports.blockExplorerLinks = blockExplorerLinks;
+//# sourceMappingURL=BlockExplorerUtils.js.map

package/dist/cjs/utils/BlockExplorerUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockExplorerUtils.js","sourceRoot":"","sources":["../../../src/utils/BlockExplorerUtils.ts"],"names":[],"mappings":";;;AAAA,iCAAgC;AAChC,0CAA+C;AAC/C,qDAAyD;AACzD,2CAAyC;AAQzC,SAAgB,iBAAiB,CAAC,eAAuB,EAAE,OAAwB;;IACjF,OAAO,MAAA,gCAAgC,CAAC,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,mCAAI,IAAI,CAAC;AACpF,CAAC;AAFD,8CAEC;AAOD,SAAgB,0BAA0B,CAAC,SAAiB;;IAC1D,OAAO,MAAA,2BAAe,CAAC,SAAS,CAAC,0CAAE,aAAa,CAAC;AACnD,CAAC;AAFD,gEAEC;AAYD,SAAS,YAAY,CAAC,MAAc,EAAE,KAAe;IAEnD,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAC,CAAC,IAAK,OAAA,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAZ,CAAY,CAAC,CAAC;IAE3C,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,UAAC,CAAC,IAAK,OAAA,CAAC,KAAK,EAAE,EAAR,CAAQ,CAAC,CAAC;IAEtC,IAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE7B,OAAO,UAAG,MAAM,cAAI,IAAI,CAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAQD,SAAS,gCAAgC,CAAC,GAAW,EAAE,OAAW;IAAX,wBAAA,EAAA,WAAW;IAEhE,IAAM,cAAc,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAE3D,IAAI,CAAC,IAAA,sBAAS,EAAC,cAAc,CAAC,EAAE;QAC9B,OAAO,kCAA2B,OAAO,cAAI,GAAG,OAAI,CAAC;KACtD;IAED,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;QAChC,GAAG,GAAG,YAAK,GAAG,CAAE,CAAC;KAClB;IAED,IAAI,CAAC,eAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE;QAClC,OAAO,IAAI,CAAC;KACb;IAED,IAAM,cAAc,GAAG,IAAA,sCAAoB,EAAC,GAAG,CAAC,CAAC;IAEjD,KAA8B,UAGP,EAHO,KAAA;QAC5B,CAAC,EAAE,EAAE,IAAI,CAAC;QACV,CAAC,EAAE,EAAE,SAAS,CAAC;KACM,EAHO,cAGP,EAHO,IAGP,EAAE;QAHd,IAAA,WAAe,EAAd,QAAM,QAAA,EAAE,KAAK,QAAA;QAKvB,IAAI,GAAG,CAAC,MAAM,KAAK,QAAM,EAAE;YACzB,OAAO,WAAI,YAAY,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,cAAI,cAAc,MAAG,CAAC;SAC5E;KACF;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AASD,SAAgB,kBAAkB,CAAC,mBAA6B,EAAE,OAAwB;IACxF,OAAO,mBAAmB,CAAC,GAAG,CAAC,UAAC,IAAI,IAAK,OAAA,UAAG,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,OAAI,EAAvC,CAAuC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7F,CAAC;AAFD,gDAEC"}

package/dist/cjs/utils/BlockUtils.d.ts

@@ -0,0 +1,28 @@
+import type { Block, Provider } from "@ethersproject/abstract-provider";
+import { CachingMechanismInterface } from "../interfaces";
+type Opts = {
+    highBlock?: number;
+    highBlockOffset?: number;
+    blockRange?: number;
+};
+type BlockTimeAverage = {
+    average: number;
+    blockRange: number;
+    timestamp: number;
+};
+export declare function averageBlockTime(provider: Provider, { highBlock, highBlockOffset, blockRange }?: Opts): Promise<Pick<BlockTimeAverage, "average" | "blockRange">>;
+export type BlockFinderHints = {
+    lowBlock?: number;
+    highBlock?: number;
+};
+export declare class BlockFinder {
+    private readonly provider;
+    private readonly blocks;
+    constructor(provider: Provider, blocks?: Block[]);
+    getBlockForTimestamp(timestamp: number | string, hints?: BlockFinderHints): Promise<Block>;
+    private getLatestBlock;
+    private getBlock;
+    private findBlock;
+}
+export declare function getCachedBlockForTimestamp(chainId: number, timestamp: number, blockFinder: BlockFinder, cache?: CachingMechanismInterface, hints?: BlockFinderHints): Promise<number>;
+export {};

package/dist/cjs/utils/BlockUtils.js

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCachedBlockForTimestamp = exports.BlockFinder = exports.averageBlockTime = void 0;
+var tslib_1 = require("tslib");
+var assert_1 = tslib_1.__importDefault(require("assert"));
+var lodash_1 = require("lodash");
+var NetworkUtils_1 = require("./NetworkUtils");
+var TypeGuards_1 = require("./TypeGuards");
+var TimeUtils_1 = require("./TimeUtils");
+var CachingUtils_1 = require("./CachingUtils");
+var constants_1 = require("../constants");
+var defaultBlockRange = 120;
+var defaultHighBlockOffset = 10;
+var cacheTTL = 60 * 15;
+var now = (0, TimeUtils_1.getCurrentTime)();
+var blockTimes = {
+    1: { average: 12.5, timestamp: now, blockRange: 1 },
+    10: { average: 2, timestamp: now, blockRange: 1 },
+    8453: { average: 2, timestamp: now, blockRange: 1 },
+    34443: { average: 2, timestamp: now, blockRange: 1 },
+    59144: { average: 3, timestamp: now, blockRange: 1 },
+};
+function averageBlockTime(provider, _a) {
+    var _b = _a === void 0 ? {} : _a, highBlock = _b.highBlock, highBlockOffset = _b.highBlockOffset, blockRange = _b.blockRange;
+    return tslib_1.__awaiter(this, void 0, void 0, function () {
+        var chainId, cache, now, earliestBlockNumber, _c, firstBlock, lastBlock, average;
+        return tslib_1.__generator(this, function (_d) {
+            switch (_d.label) {
+                case 0: return [4, provider.getNetwork()];
+                case 1:
+                    chainId = (_d.sent()).chainId;
+                    cache = blockTimes[chainId];
+                    now = (0, TimeUtils_1.getCurrentTime)();
+                    if ((0, TypeGuards_1.isDefined)(cache) && now < cache.timestamp + cacheTTL) {
+                        return [2, { average: cache.average, blockRange: cache.blockRange }];
+                    }
+                    if (!!(0, TypeGuards_1.isDefined)(highBlock)) return [3, 3];
+                    return [4, provider.getBlockNumber()];
+                case 2:
+                    highBlock = _d.sent();
+                    highBlock -= highBlockOffset !== null && highBlockOffset !== void 0 ? highBlockOffset : defaultHighBlockOffset;
+                    _d.label = 3;
+                case 3:
+                    blockRange !== null && blockRange !== void 0 ? blockRange : (blockRange = defaultBlockRange);
+                    earliestBlockNumber = highBlock - blockRange;
+                    return [4, Promise.all([
+                            provider.getBlock(earliestBlockNumber),
+                            provider.getBlock(highBlock),
+                        ])];
+                case 4:
+                    _c = _d.sent(), firstBlock = _c[0], lastBlock = _c[1];
+                    [firstBlock, lastBlock].forEach(function (block) {
+                        if (!(0, TypeGuards_1.isDefined)(block === null || block === void 0 ? void 0 : block.timestamp)) {
+                            var network = (0, NetworkUtils_1.getNetworkName)(chainId);
+                            var blockNumber = block === firstBlock ? earliestBlockNumber : highBlock;
+                            throw new Error("BlockFinder: Failed to fetch block ".concat(blockNumber, " on ").concat(network));
+                        }
+                    });
+                    average = (lastBlock.timestamp - firstBlock.timestamp) / blockRange;
+                    blockTimes[chainId] = { timestamp: now, average: average, blockRange: blockRange };
+                    return [2, { average: average, blockRange: blockRange }];
+            }
+        });
+    });
+}
+exports.averageBlockTime = averageBlockTime;
+function estimateBlocksElapsed(seconds, cushionPercentage, provider) {
+    if (cushionPercentage === void 0) { cushionPercentage = 0.0; }
+    return tslib_1.__awaiter(this, void 0, void 0, function () {
+        var cushionMultiplier, average;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    cushionMultiplier = cushionPercentage + 1.0;
+                    return [4, averageBlockTime(provider)];
+                case 1:
+                    average = (_a.sent()).average;
+                    return [2, Math.floor((seconds * cushionMultiplier) / average)];
+            }
+        });
+    });
+}
+var BlockFinder = (function () {
+    function BlockFinder(provider, blocks) {
+        if (blocks === void 0) { blocks = []; }
+        this.provider = provider;
+        this.blocks = blocks;
+    }
+    BlockFinder.prototype.getBlockForTimestamp = function (timestamp, hints) {
+        if (hints === void 0) { hints = {}; }
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var block, initialBlock, cushion, incrementDistance, _a, _b, multiplier, distance, blockNumber, block, index;
+            var _this = this;
+            return tslib_1.__generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        timestamp = Number(timestamp);
+                        (0, assert_1.default)(timestamp !== undefined && timestamp !== null, "timestamp must be provided");
+                        if (!(this.blocks.length === 0 || this.blocks[this.blocks.length - 1].timestamp < timestamp)) return [3, 2];
+                        return [4, this.getLatestBlock()];
+                    case 1:
+                        block = _c.sent();
+                        if (timestamp >= block.timestamp)
+                            return [2, block];
+                        _c.label = 2;
+                    case 2: return [4, Promise.all(Object.values(hints)
+                            .filter(function (blockNumber) { return (0, TypeGuards_1.isDefined)(blockNumber); })
+                            .map(function (blockNumber) { return _this.getBlock(blockNumber); }))];
+                    case 3:
+                        _c.sent();
+                        if (!(this.blocks[0].timestamp > timestamp)) return [3, 8];
+                        initialBlock = this.blocks[0];
+                        cushion = 1;
+                        _b = (_a = Math).max;
+                        return [4, estimateBlocksElapsed(initialBlock.timestamp - timestamp, cushion, this.provider)];
+                    case 4:
+                        incrementDistance = _b.apply(_a, [_c.sent(), 1]);
+                        multiplier = 1;
+                        _c.label = 5;
+                    case 5:
+                        distance = multiplier * incrementDistance;
+                        blockNumber = Math.max(0, initialBlock.number - distance);
+                        return [4, this.getBlock(blockNumber)];
+                    case 6:
+                        block = _c.sent();
+                        if (block.timestamp <= timestamp)
+                            return [3, 8];
+                        (0, assert_1.default)(blockNumber > 0, "timestamp is before block 0");
+                        _c.label = 7;
+                    case 7:
+                        multiplier++;
+                        return [3, 5];
+                    case 8:
+                        index = (0, lodash_1.sortedIndexBy)(this.blocks, { timestamp: timestamp }, "timestamp");
+                        return [2, this.findBlock(this.blocks[index - 1], this.blocks[index], timestamp)];
+                }
+            });
+        });
+    };
+    BlockFinder.prototype.getLatestBlock = function () {
+        var _a;
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var block, index;
+            return tslib_1.__generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0: return [4, this.provider.getBlock("latest")];
+                    case 1:
+                        block = _b.sent();
+                        index = (0, lodash_1.sortedIndexBy)(this.blocks, block, "number");
+                        if (((_a = this.blocks[index]) === null || _a === void 0 ? void 0 : _a.number) !== block.number)
+                            this.blocks.splice(index, 0, block);
+                        return [2, this.blocks[index]];
+                }
+            });
+        });
+    };
+    BlockFinder.prototype.getBlock = function (number) {
+        var _a, _b;
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var index, block;
+            return tslib_1.__generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        index = (0, lodash_1.sortedIndexBy)(this.blocks, { number: number }, "number");
+                        if (((_a = this.blocks[index]) === null || _a === void 0 ? void 0 : _a.number) === number)
+                            return [2, this.blocks[index]];
+                        return [4, this.provider.getBlock(number)];
+                    case 1:
+                        block = _c.sent();
+                        index = (0, lodash_1.sortedIndexBy)(this.blocks, { number: number }, "number");
+                        if (((_b = this.blocks[index]) === null || _b === void 0 ? void 0 : _b.number) === number)
+                            return [2, this.blocks[index]];
+                        this.blocks.splice(index, 0, block);
+                        return [2, block];
+                }
+            });
+        });
+    };
+    BlockFinder.prototype.findBlock = function (_startBlock, _endBlock, timestamp) {
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var _a, startBlock, endBlock, totalTimeDifference, totalBlockDistance, blockPercentile, estimatedBlock, newBlock;
+            return tslib_1.__generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _a = [_startBlock, _endBlock], startBlock = _a[0], endBlock = _a[1];
+                        if (endBlock.timestamp === timestamp)
+                            return [2, endBlock];
+                        if (endBlock.number === startBlock.number + 1)
+                            return [2, startBlock];
+                        (0, assert_1.default)(endBlock.number !== startBlock.number, "startBlock cannot equal endBlock");
+                        (0, assert_1.default)(timestamp < endBlock.timestamp && timestamp > startBlock.timestamp, "timestamp not in between start and end blocks");
+                        totalTimeDifference = endBlock.timestamp - startBlock.timestamp;
+                        totalBlockDistance = endBlock.number - startBlock.number;
+                        blockPercentile = (timestamp - startBlock.timestamp) / totalTimeDifference;
+                        estimatedBlock = startBlock.number + Math.round(blockPercentile * totalBlockDistance);
+                        return [4, this.getBlock((0, lodash_1.clamp)(estimatedBlock, startBlock.number + 1, endBlock.number - 1))];
+                    case 1:
+                        newBlock = _b.sent();
+                        if (newBlock.timestamp < timestamp) {
+                            return [2, this.findBlock(newBlock, endBlock, timestamp)];
+                        }
+                        else {
+                            return [2, this.findBlock(startBlock, newBlock, timestamp)];
+                        }
+                        return [2];
+                }
+            });
+        });
+    };
+    return BlockFinder;
+}());
+exports.BlockFinder = BlockFinder;
+function getCachedBlockForTimestamp(chainId, timestamp, blockFinder, cache, hints) {
+    return tslib_1.__awaiter(this, void 0, void 0, function () {
+        var resolver, key, result, blockNumber;
+        var _this = this;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    resolver = function () { return tslib_1.__awaiter(_this, void 0, void 0, function () { return tslib_1.__generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0: return [4, blockFinder.getBlockForTimestamp(timestamp, hints)];
+                            case 1: return [2, (_a.sent()).number];
+                        }
+                    }); }); };
+                    if (!(0, TypeGuards_1.isDefined)(cache)) {
+                        return [2, resolver()];
+                    }
+                    key = "".concat(chainId, "_block_number_").concat(timestamp);
+                    if (!(0, CachingUtils_1.shouldCache)(timestamp, (0, TimeUtils_1.getCurrentTime)(), constants_1.DEFAULT_CACHING_SAFE_LAG)) return [3, 6];
+                    return [4, cache.get(key)];
+                case 1:
+                    result = _a.sent();
+                    if (!(result !== null)) return [3, 2];
+                    return [2, parseInt(result)];
+                case 2: return [4, resolver()];
+                case 3:
+                    blockNumber = _a.sent();
+                    return [4, cache.set(key, blockNumber.toString(), 60 * 60 * 24 * 90)];
+                case 4:
+                    _a.sent();
+                    return [2, blockNumber];
+                case 5: return [3, 7];
+                case 6: return [2, resolver()];
+                case 7: return [2];
+            }
+        });
+    });
+}
+exports.getCachedBlockForTimestamp = getCachedBlockForTimestamp;
+//# sourceMappingURL=BlockUtils.js.map

package/dist/cjs/utils/BlockUtils.js.map

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

package/dist/cjs/utils/BundleUtils.d.ts

@@ -0,0 +1,5 @@
+import { AcrossConfigStoreClient, HubPoolClient } from "../clients";
+import { ProposedRootBundle } from "../interfaces";
+export declare function getBlockForChain(bundleEvaluationBlockNumbers: number[], chain: number, chainIdListForBundleEvaluationBlockNumbers: number[]): number;
+export declare function getBlockRangeForChain(blockRanges: number[][], chain: number, chainIdListForBundleEvaluationBlockNumbers: number[]): number[];
+export declare function getImpliedBundleBlockRanges(hubPoolClient: HubPoolClient, configStoreClient: AcrossConfigStoreClient, rootBundle: ProposedRootBundle): number[][];

package/dist/cjs/utils/BundleUtils.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getImpliedBundleBlockRanges = exports.getBlockRangeForChain = exports.getBlockForChain = void 0;
+function getBlockForChain(bundleEvaluationBlockNumbers, chain, chainIdListForBundleEvaluationBlockNumbers) {
+    var indexForChain = chainIdListForBundleEvaluationBlockNumbers.indexOf(chain);
+    if (indexForChain === -1) {
+        throw new Error("Could not find chain ".concat(chain, " in chain ID list ").concat(chainIdListForBundleEvaluationBlockNumbers));
+    }
+    var blockForChain = bundleEvaluationBlockNumbers[indexForChain];
+    if (blockForChain === undefined) {
+        throw new Error("Invalid block range for chain ".concat(chain));
+    }
+    return blockForChain;
+}
+exports.getBlockForChain = getBlockForChain;
+function getBlockRangeForChain(blockRanges, chain, chainIdListForBundleEvaluationBlockNumbers) {
+    var indexForChain = chainIdListForBundleEvaluationBlockNumbers.indexOf(chain);
+    if (indexForChain === -1) {
+        throw new Error("Could not find chain ".concat(chain, " in chain ID list ").concat(chainIdListForBundleEvaluationBlockNumbers));
+    }
+    var blockRangeForChain = blockRanges[indexForChain];
+    if (!blockRangeForChain || blockRangeForChain.length !== 2) {
+        throw new Error("Invalid block range for chain ".concat(chain));
+    }
+    return blockRangeForChain;
+}
+exports.getBlockRangeForChain = getBlockRangeForChain;
+function getImpliedBundleBlockRanges(hubPoolClient, configStoreClient, rootBundle) {
+    var _a;
+    var prevRootBundle = hubPoolClient.getLatestFullyExecutedRootBundle(rootBundle.blockNumber);
+    var mainnetStartBlock = (_a = prevRootBundle === null || prevRootBundle === void 0 ? void 0 : prevRootBundle.bundleEvaluationBlockNumbers[0].toNumber()) !== null && _a !== void 0 ? _a : 0;
+    var enabledChainsAtMainnetStartBlock = configStoreClient.getEnabledChains(mainnetStartBlock);
+    var chainIdIndices = configStoreClient.getChainIdIndicesForBlock(rootBundle.blockNumber);
+    var result = rootBundle.bundleEvaluationBlockNumbers.map(function (endBlock, i) {
+        var _a;
+        var fromBlock = ((_a = prevRootBundle === null || prevRootBundle === void 0 ? void 0 : prevRootBundle.bundleEvaluationBlockNumbers) === null || _a === void 0 ? void 0 : _a[i])
+            ? prevRootBundle.bundleEvaluationBlockNumbers[i].toNumber() + 1
+            : 0;
+        var chainId = chainIdIndices[i];
+        if (!enabledChainsAtMainnetStartBlock.includes(chainId)) {
+            return [endBlock.toNumber(), endBlock.toNumber()];
+        }
+        return [fromBlock, endBlock.toNumber()];
+    });
+    result.forEach(function (_a, i) {
+        var start = _a[0], end = _a[1];
+        var chainId = chainIdIndices[i];
+        if (enabledChainsAtMainnetStartBlock.includes(chainId)) {
+            if (start >= end) {
+                throw new Error("Invalid block range for enabled chain ".concat(chainId, ": start block ").concat(start, " is greater than or equal to end block ").concat(end));
+            }
+        }
+        else {
+            if (start !== end) {
+                throw new Error("Invalid block range for disabled chain ".concat(chainId, ": start block ").concat(start, " is not equal to end block ").concat(end));
+            }
+        }
+    });
+    return result;
+}
+exports.getImpliedBundleBlockRanges = getImpliedBundleBlockRanges;
+//# sourceMappingURL=BundleUtils.js.map

package/dist/cjs/utils/BundleUtils.js.map

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

package/dist/cjs/utils/CachingUtils.d.ts

@@ -0,0 +1,5 @@
+import { CachingMechanismInterface, Deposit, Fill, SlowFillRequest } from "../interfaces";
+export declare function shouldCache(eventTimestamp: number, latestTime: number, cachingMaxAge: number): boolean;
+export declare function getDepositInCache(key: string, cache: CachingMechanismInterface): Promise<Deposit | undefined>;
+export declare function setDepositInCache(deposit: Deposit, currentChainTime: number, cache: CachingMechanismInterface, expirySeconds?: number, timeToCache?: number): Promise<void>;
+export declare function getDepositKey(bridgeEvent: Deposit | Fill | SlowFillRequest): string;