@across-protocol/sdk 3.1.18 → 3.1.20

package/dist/esm/providers/retryProvider.js

@@ -0,0 +1,249 @@
+import { __awaiter, __extends, __generator, __spreadArray } from "tslib";
+import { ethers, logger } from "ethers";
+import { delay, isDefined, isPromiseFulfilled, isPromiseRejected } from "../utils";
+import { getOriginFromURL } from "../utils/NetworkUtils";
+import { CacheProvider } from "./cachedProvider";
+import { compareRpcResults, createSendErrorWithMessage, formatProviderError } from "./utils";
+import { PROVIDER_CACHE_TTL } from "./constants";
+var RetryProvider = /** @class */ (function (_super) {
+    __extends(RetryProvider, _super);
+    function RetryProvider(params, chainId, nodeQuorumThreshold, retries, delay, maxConcurrency, providerCacheNamespace, pctRpcCallsLogged, redisClient, standardTtlBlockDistance, noTtlBlockDistance, providerCacheTtl, logger) {
+        if (providerCacheTtl === void 0) { providerCacheTtl = PROVIDER_CACHE_TTL; }
+        var _this = 
+        // Initialize the super just with the chainId, which stops it from trying to immediately send out a .send before
+        // this derived class is initialized.
+        _super.call(this, undefined, chainId) || this;
+        _this.nodeQuorumThreshold = nodeQuorumThreshold;
+        _this.retries = retries;
+        _this.delay = delay;
+        _this.maxConcurrency = maxConcurrency;
+        _this.providers = params.map(function (inputs) {
+            return new (CacheProvider.bind.apply(CacheProvider, __spreadArray([void 0, providerCacheNamespace,
+                redisClient,
+                standardTtlBlockDistance,
+                noTtlBlockDistance,
+                providerCacheTtl,
+                maxConcurrency,
+                pctRpcCallsLogged,
+                logger], inputs, false)))();
+        });
+        if (_this.nodeQuorumThreshold < 1 || !Number.isInteger(_this.nodeQuorumThreshold)) {
+            throw new Error("nodeQuorum,Threshold cannot be < 1 and must be an integer. Currently set to ".concat(_this.nodeQuorumThreshold));
+        }
+        if (_this.retries < 0 || !Number.isInteger(_this.retries)) {
+            throw new Error("retries cannot be < 0 and must be an integer. Currently set to ".concat(_this.retries));
+        }
+        if (_this.delay < 0) {
+            throw new Error("delay cannot be < 0. Currently set to ".concat(_this.delay));
+        }
+        if (_this.nodeQuorumThreshold > _this.providers.length) {
+            throw new Error("nodeQuorumThreshold (".concat(_this.nodeQuorumThreshold, ") must be <= the number of providers (").concat(_this.providers.length, ")"));
+        }
+        return _this;
+    }
+    RetryProvider.prototype.send = function (method, params) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function () {
+            var quorumThreshold, requiredProviders, fallbackProviders, errors, tryWithFallback, results, errorTexts, successfulProviderUrls, values, throwQuorumError, fallbackResults, fallbackValues, counts, _b, quorumResult, count, mismatchedProviders, quorumProviders;
+            var _this = this;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        quorumThreshold = this._getQuorum(method, params);
+                        requiredProviders = this.providers.slice(0, quorumThreshold);
+                        fallbackProviders = this.providers.slice(quorumThreshold);
+                        errors = [];
+                        tryWithFallback = function (provider) {
+                            return _this._trySend(provider, method, params)
+                                .then(function (result) { return [provider, result]; })
+                                .catch(function (err) {
+                                // Append the provider and error to the error array.
+                                errors.push([provider, (err === null || err === void 0 ? void 0 : err.stack) || (err === null || err === void 0 ? void 0 : err.toString())]);
+                                // If there are no new fallback providers to use, terminate the recursion by throwing an error.
+                                // Otherwise, we can try to call another provider.
+                                if (fallbackProviders.length === 0) {
+                                    throw err;
+                                }
+                                // This line does two things:
+                                // 1. Removes a fallback provider from the array so it cannot be used as a fallback for another required
+                                // provider.
+                                // 2. Recursively calls this method with that provider so it goes through the same try logic as the previous one.
+                                return tryWithFallback(fallbackProviders.shift());
+                            });
+                        };
+                        return [4 /*yield*/, Promise.allSettled(requiredProviders.map(tryWithFallback))];
+                    case 1:
+                        results = _c.sent();
+                        if (!results.every(isPromiseFulfilled)) {
+                            errorTexts = errors.map(function (_a) {
+                                var provider = _a[0], errorText = _a[1];
+                                return formatProviderError(provider, errorText);
+                            });
+                            successfulProviderUrls = results.filter(isPromiseFulfilled).map(function (result) { return result.value[0].connection.url; });
+                            throw createSendErrorWithMessage("Not enough providers succeeded. Errors:\n".concat(errorTexts.join("\n"), "\n") +
+                                "Successful Providers:\n".concat(successfulProviderUrls.join("\n")), (_a = results.find(isPromiseRejected)) === null || _a === void 0 ? void 0 : _a.reason);
+                        }
+                        values = results.map(function (result) { return result.value; });
+                        // Start at element 1 and begin comparing.
+                        // If _all_ values are equal, we have hit quorum, so return.
+                        if (values.slice(1).every(function (_a) {
+                            var output = _a[1];
+                            return compareRpcResults(method, values[0][1], output);
+                        })) {
+                            return [2 /*return*/, values[0][1]];
+                        }
+                        throwQuorumError = function () {
+                            var errorTexts = errors.map(function (_a) {
+                                var provider = _a[0], errorText = _a[1];
+                                return formatProviderError(provider, errorText);
+                            });
+                            var successfulProviderUrls = values.map(function (_a) {
+                                var provider = _a[0];
+                                return provider.connection.url;
+                            });
+                            throw new Error("Not enough providers agreed to meet quorum.\n" +
+                                "Providers that errored:\n" +
+                                "".concat(errorTexts.join("\n"), "\n") +
+                                "Providers that succeeded, but some failed to match:\n" +
+                                successfulProviderUrls.join("\n"));
+                        };
+                        // Exit early if there are no fallback providers left.
+                        if (fallbackProviders.length === 0) {
+                            throwQuorumError();
+                        }
+                        return [4 /*yield*/, Promise.allSettled(fallbackProviders.map(function (provider) {
+                                return _this._trySend(provider, method, params)
+                                    .then(function (result) { return [provider, result]; })
+                                    .catch(function (err) {
+                                    errors.push([provider, (err === null || err === void 0 ? void 0 : err.stack) || (err === null || err === void 0 ? void 0 : err.toString())]);
+                                    throw new Error("No fallbacks during quorum search");
+                                });
+                            }))];
+                    case 2:
+                        fallbackResults = _c.sent();
+                        fallbackValues = fallbackResults.filter(isPromiseFulfilled).map(function (promise) { return promise.value; });
+                        counts = __spreadArray(__spreadArray([], values, true), fallbackValues, true).reduce(function (acc, curr) {
+                            var result = curr[1];
+                            // Find the first result that matches the return value.
+                            var existingMatch = acc.find(function (_a) {
+                                var existingResult = _a[0];
+                                return compareRpcResults(method, existingResult, result);
+                            });
+                            // Increment the count if a match is found, else add a new element to the match array with a count of 1.
+                            if (existingMatch) {
+                                existingMatch[1]++;
+                            }
+                            else {
+                                acc.push([result, 1]);
+                            }
+                            // Return the same acc object because it was modified in place.
+                            return acc;
+                        }, [[undefined, 0]] // Initialize with [undefined, 0] as the first element so something is always returned.
+                        );
+                        // Sort so the result with the highest count is first.
+                        counts.sort(function (_a, _b) {
+                            var a = _a[1];
+                            var b = _b[1];
+                            return b - a;
+                        });
+                        _b = counts[0], quorumResult = _b[0], count = _b[1];
+                        // If this count is less than we need for quorum, throw the quorum error.
+                        if (count < quorumThreshold) {
+                            throwQuorumError();
+                        }
+                        mismatchedProviders = Object.fromEntries(__spreadArray(__spreadArray([], values, true), fallbackValues, true).filter(function (_a) {
+                            var result = _a[1];
+                            return !compareRpcResults(method, result, quorumResult);
+                        })
+                            .map(function (_a) {
+                            var provider = _a[0], result = _a[1];
+                            return [provider.connection.url, result];
+                        }));
+                        quorumProviders = __spreadArray(__spreadArray([], values, true), fallbackValues, true).filter(function (_a) {
+                            var result = _a[1];
+                            return compareRpcResults(method, result, quorumResult);
+                        })
+                            .map(function (_a) {
+                            var provider = _a[0];
+                            return provider.connection.url;
+                        });
+                        if (Object.keys(mismatchedProviders).length > 0 || errors.length > 0) {
+                            logger.warn({
+                                at: "ProviderUtils",
+                                message: "Some providers mismatched with the quorum result or failed 🚸",
+                                notificationPath: "across-warn",
+                                method: method,
+                                params: params,
+                                quorumProviders: quorumProviders,
+                                mismatchedProviders: mismatchedProviders,
+                                erroringProviders: errors.map(function (_a) {
+                                    var provider = _a[0], errorText = _a[1];
+                                    return formatProviderError(provider, errorText);
+                                }),
+                            });
+                        }
+                        return [2 /*return*/, quorumResult];
+                }
+            });
+        });
+    };
+    RetryProvider.prototype._validateResponse = function (method, _, response) {
+        // Basic validation logic to start.
+        // Note: eth_getTransactionReceipt is ignored here because null responses are expected in the case that ethers is
+        // polling for the transaction receipt and receiving null until it does.
+        return isDefined(response) || method === "eth_getTransactionReceipt";
+    };
+    RetryProvider.prototype._sendAndValidate = function (provider, method, params) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, provider.send(method, params)];
+                    case 1:
+                        response = _a.sent();
+                        if (!this._validateResponse(method, params, response)) {
+                            // Not a warning to avoid spam since this could trigger a lot.
+                            logger.debug({
+                                at: "ProviderUtils",
+                                message: "Provider returned invalid response",
+                                provider: getOriginFromURL(provider.connection.url),
+                                method: method,
+                                params: params,
+                                response: response,
+                            });
+                            throw new Error("Response failed validation");
+                        }
+                        return [2 /*return*/, response];
+                }
+            });
+        });
+    };
+    RetryProvider.prototype._trySend = function (provider, method, params) {
+        var _this = this;
+        var promise = this._sendAndValidate(provider, method, params);
+        for (var i = 0; i < this.retries; i++) {
+            promise = promise.catch(function () { return delay(_this.delay).then(function () { return _this._sendAndValidate(provider, method, params); }); });
+        }
+        return promise;
+    };
+    RetryProvider.prototype._getQuorum = function (method, params) {
+        // Only use quorum if this is a historical query that doesn't depend on the current block number.
+        // All logs queries should use quorum.
+        if (method === "eth_getLogs") {
+            return this.nodeQuorumThreshold;
+        }
+        // getBlockByNumber should only use the quorum if it's not asking for the latest block.
+        if (method === "eth_getBlockByNumber" && params[0] !== "latest") {
+            return this.nodeQuorumThreshold;
+        }
+        // eth_call should only use quorum for queries at a specific past block.
+        if (method === "eth_call" && params[1] !== "latest") {
+            return this.nodeQuorumThreshold;
+        }
+        // All other calls should use quorum 1 to avoid errors due to sync differences.
+        return 1;
+    };
+    return RetryProvider;
+}(ethers.providers.StaticJsonRpcProvider));
+export { RetryProvider };
+//# sourceMappingURL=retryProvider.js.map

package/dist/esm/providers/retryProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryProvider.js","sourceRoot":"","sources":["../../../src/providers/retryProvider.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;IAAmC,iCAAsC;IAEvE,uBACE,MAA8E,EAC9E,OAAe,EACN,mBAA2B,EAC3B,OAAe,EACf,KAAa,EACb,cAAsB,EAC/B,sBAA8B,EAC9B,iBAAyB,EACzB,WAAuC,EACvC,wBAAiC,EACjC,kBAA2B,EAC3B,gBAAqC,EACrC,MAAwB;QADxB,iCAAA,EAAA,qCAAqC;QAZvC;QAeE,gHAAgH;QAChH,qCAAqC;QACrC,kBAAM,SAAS,EAAE,OAAO,CAAC,SA+B1B;QA7CU,yBAAmB,GAAnB,mBAAmB,CAAQ;QAC3B,aAAO,GAAP,OAAO,CAAQ;QACf,WAAK,GAAL,KAAK,CAAQ;QACb,oBAAc,GAAd,cAAc,CAAQ;QAY/B,KAAI,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,CACzB,UAAC,MAAM;YACL,YAAI,aAAa,YAAb,aAAa,yBACf,sBAAsB;gBACtB,WAAW;gBACX,wBAAwB;gBACxB,kBAAkB;gBAClB,gBAAgB;gBAChB,cAAc;gBACd,iBAAiB;gBACjB,MAAM,GACH,MAAM;QATX,CAUC,CACJ,CAAC;QACF,IAAI,KAAI,CAAC,mBAAmB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAI,CAAC,mBAAmB,CAAC,EAAE;YAC/E,MAAM,IAAI,KAAK,CACb,sFAA+E,KAAI,CAAC,mBAAmB,CAAE,CAC1G,CAAC;SACH;QACD,IAAI,KAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAI,CAAC,OAAO,CAAC,EAAE;YACvD,MAAM,IAAI,KAAK,CAAC,yEAAkE,KAAI,CAAC,OAAO,CAAE,CAAC,CAAC;SACnG;QACD,IAAI,KAAI,CAAC,KAAK,GAAG,CAAC,EAAE;YAClB,MAAM,IAAI,KAAK,CAAC,gDAAyC,KAAI,CAAC,KAAK,CAAE,CAAC,CAAC;SACxE;QACD,IAAI,KAAI,CAAC,mBAAmB,GAAG,KAAI,CAAC,SAAS,CAAC,MAAM,EAAE;YACpD,MAAM,IAAI,KAAK,CACb,+BAAwB,KAAI,CAAC,mBAAmB,mDAAyC,KAAI,CAAC,SAAS,CAAC,MAAM,MAAG,CAClH,CAAC;SACH;;IACH,CAAC;IAEc,4BAAI,GAAnB,UAAoB,MAAc,EAAE,MAAsB;;;;;;;;wBAClD,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;wBAClD,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;wBAC7D,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;wBAC1D,MAAM,GAAuD,EAAE,CAAC;wBAMhE,eAAe,GAAG,UACtB,QAAgD;4BAEhD,OAAO,KAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;iCAC3C,IAAI,CAAC,UAAC,MAAM,IAAwD,OAAA,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAlB,CAAkB,CAAC;iCACvF,KAAK,CAAC,UAAC,GAAG;gCACT,oDAAoD;gCACpD,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,KAAK,MAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,QAAQ,EAAE,CAAA,CAAC,CAAC,CAAC;gCAEvD,+FAA+F;gCAC/F,kDAAkD;gCAClD,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE;oCAClC,MAAM,GAAG,CAAC;iCACX;gCAED,6BAA6B;gCAC7B,wGAAwG;gCACxG,YAAY;gCACZ,iHAAiH;gCACjH,OAAO,eAAe,CAAC,iBAAiB,CAAC,KAAK,EAAG,CAAC,CAAC;4BACrD,CAAC,CAAC,CAAC;wBACP,CAAC,CAAC;wBAEc,qBAAM,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,EAAA;;wBAA1E,OAAO,GAAG,SAAgE;wBAEhF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE;4BAEhC,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,UAAC,EAAqB;oCAApB,QAAQ,QAAA,EAAE,SAAS,QAAA;gCAAM,OAAA,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC;4BAAxC,CAAwC,CAAC,CAAC;4BAC7F,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,UAAC,MAAM,IAAK,OAAA,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAA9B,CAA8B,CAAC,CAAC;4BAClH,MAAM,0BAA0B,CAC9B,mDAA4C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAI;gCACnE,iCAA0B,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAE,EAC/D,MAAA,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,0CAAE,MAAM,CACxC,CAAC;yBACH;wBAEK,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAC,MAAM,IAAK,OAAA,MAAM,CAAC,KAAK,EAAZ,CAAY,CAAC,CAAC;wBAErD,0CAA0C;wBAC1C,4DAA4D;wBAC5D,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAC,EAAU;gCAAP,MAAM,QAAA;4BAAM,OAAA,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;wBAA/C,CAA+C,CAAC,EAAE;4BAC1F,sBAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAC;yBACrB;wBAEK,gBAAgB,GAAG;4BACvB,IAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,UAAC,EAAqB;oCAApB,QAAQ,QAAA,EAAE,SAAS,QAAA;gCAAM,OAAA,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC;4BAAxC,CAAwC,CAAC,CAAC;4BACnG,IAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,UAAC,EAAU;oCAAT,QAAQ,QAAA;gCAAM,OAAA,QAAQ,CAAC,UAAU,CAAC,GAAG;4BAAvB,CAAuB,CAAC,CAAC;4BACnF,MAAM,IAAI,KAAK,CACb,+CAA+C;gCAC7C,2BAA2B;gCAC3B,UAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAI;gCAC5B,uDAAuD;gCACvD,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CACpC,CAAC;wBACJ,CAAC,CAAC;wBAEF,sDAAsD;wBACtD,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE;4BAClC,gBAAgB,EAAE,CAAC;yBACpB;wBAGuB,qBAAM,OAAO,CAAC,UAAU,CAC9C,iBAAiB,CAAC,GAAG,CAAC,UAAC,QAAQ;gCAC7B,OAAA,KAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;qCACpC,IAAI,CAAC,UAAC,MAAM,IAAwD,OAAA,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAlB,CAAkB,CAAC;qCACvF,KAAK,CAAC,UAAC,GAAG;oCACT,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,KAAK,MAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,QAAQ,EAAE,CAAA,CAAC,CAAC,CAAC;oCACvD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;gCACvD,CAAC,CAAC;4BALJ,CAKI,CACL,CACF,EAAA;;wBATK,eAAe,GAAG,SASvB;wBAGK,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,UAAC,OAAO,IAAK,OAAA,OAAO,CAAC,KAAK,EAAb,CAAa,CAAC,CAAC;wBAG5F,MAAM,GAAG,gCAAI,MAAM,SAAK,cAAc,QAAE,MAAM,CAClD,UAAC,GAAG,EAAE,IAAI;4BACC,IAAA,MAAM,GAAI,IAAI,GAAR,CAAS;4BAExB,uDAAuD;4BACvD,IAAM,aAAa,GAAG,GAAG,CAAC,IAAI,CAAC,UAAC,EAAgB;oCAAf,cAAc,QAAA;gCAAM,OAAA,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC;4BAAjD,CAAiD,CAAC,CAAC;4BAExG,wGAAwG;4BACxG,IAAI,aAAa,EAAE;gCACjB,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;6BACpB;iCAAM;gCACL,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;6BACvB;4BAED,+DAA+D;4BAC/D,OAAO,GAAG,CAAC;wBACb,CAAC,EACD,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAwB,CAAC,uFAAuF;yBAChI,CAAC;wBAEF,sDAAsD;wBACtD,MAAM,CAAC,IAAI,CAAC,UAAC,EAAK,EAAE,EAAK;gCAAT,CAAC,QAAA;gCAAM,CAAC,QAAA;4BAAM,OAAA,CAAC,GAAG,CAAC;wBAAL,CAAK,CAAC,CAAC;wBAG/B,KAAwB,MAAM,CAAC,CAAC,CAAC,EAAhC,YAAY,QAAA,EAAE,KAAK,QAAA,CAAc;wBAExC,yEAAyE;wBACzE,IAAI,KAAK,GAAG,eAAe,EAAE;4BAC3B,gBAAgB,EAAE,CAAC;yBACpB;wBAGK,mBAAmB,GAAG,MAAM,CAAC,WAAW,CAC5C,gCAAI,MAAM,SAAK,cAAc,QAC1B,MAAM,CAAC,UAAC,EAAU;gCAAP,MAAM,QAAA;4BAAM,OAAA,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC;wBAAhD,CAAgD,CAAC;6BACxE,GAAG,CAAC,UAAC,EAAkB;gCAAjB,QAAQ,QAAA,EAAE,MAAM,QAAA;4BAAM,OAAA,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;wBAAjC,CAAiC,CAAC,CAClE,CAAC;wBACI,eAAe,GAAG,gCAAI,MAAM,SAAK,cAAc,QAClD,MAAM,CAAC,UAAC,EAAU;gCAAP,MAAM,QAAA;4BAAM,OAAA,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC;wBAA/C,CAA+C,CAAC;6BACvE,GAAG,CAAC,UAAC,EAAU;gCAAT,QAAQ,QAAA;4BAAM,OAAA,QAAQ,CAAC,UAAU,CAAC,GAAG;wBAAvB,CAAuB,CAAC,CAAC;wBAChD,IAAI,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE;4BACpE,MAAM,CAAC,IAAI,CAAC;gCACV,EAAE,EAAE,eAAe;gCACnB,OAAO,EAAE,+DAA+D;gCACxE,gBAAgB,EAAE,aAAa;gCAC/B,MAAM,QAAA;gCACN,MAAM,QAAA;gCACN,eAAe,iBAAA;gCACf,mBAAmB,qBAAA;gCACnB,iBAAiB,EAAE,MAAM,CAAC,GAAG,CAAC,UAAC,EAAqB;wCAApB,QAAQ,QAAA,EAAE,SAAS,QAAA;oCAAM,OAAA,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC;gCAAxC,CAAwC,CAAC;6BACnG,CAAC,CAAC;yBACJ;wBAED,sBAAO,YAAY,EAAC;;;;KACrB;IAED,yCAAiB,GAAjB,UAAkB,MAAc,EAAE,CAAiB,EAAE,QAAiB;QACpE,mCAAmC;QACnC,iHAAiH;QACjH,wEAAwE;QACxE,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,MAAM,KAAK,2BAA2B,CAAC;IACvE,CAAC;IAEK,wCAAgB,GAAtB,UACE,QAAgD,EAChD,MAAc,EACd,MAAsB;;;;;4BAEL,qBAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAA;;wBAA9C,QAAQ,GAAG,SAAmC;wBACpD,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;4BACrD,8DAA8D;4BAC9D,MAAM,CAAC,KAAK,CAAC;gCACX,EAAE,EAAE,eAAe;gCACnB,OAAO,EAAE,oCAAoC;gCAC7C,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;gCACnD,MAAM,QAAA;gCACN,MAAM,QAAA;gCACN,QAAQ,UAAA;6BACT,CAAC,CAAC;4BACH,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;yBAC/C;wBACD,sBAAO,QAAQ,EAAC;;;;KACjB;IAED,gCAAQ,GAAR,UAAS,QAAgD,EAAE,MAAc,EAAE,MAAsB;QAAjG,iBAMC;QALC,IAAI,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;YACrC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,cAAM,OAAA,KAAK,CAAC,KAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAM,OAAA,KAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAA/C,CAA+C,CAAC,EAA7E,CAA6E,CAAC,CAAC;SAC9G;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,kCAAU,GAAV,UAAW,MAAc,EAAE,MAAsB;QAC/C,iGAAiG;QAEjG,sCAAsC;QACtC,IAAI,MAAM,KAAK,aAAa,EAAE;YAC5B,OAAO,IAAI,CAAC,mBAAmB,CAAC;SACjC;QAED,uFAAuF;QACvF,IAAI,MAAM,KAAK,sBAAsB,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE;YAC/D,OAAO,IAAI,CAAC,mBAAmB,CAAC;SACjC;QAED,wEAAwE;QACxE,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE;YACnD,OAAO,IAAI,CAAC,mBAAmB,CAAC;SACjC;QAED,+EAA+E;QAC/E,OAAO,CAAC,CAAC;IACX,CAAC;IACH,oBAAC;AAAD,CAAC,AA5PD,CAAmC,MAAM,CAAC,SAAS,CAAC,qBAAqB,GA4PxE"}

package/dist/esm/providers/utils.d.ts

@@ -0,0 +1,39 @@
+import { providers } from "ethers";
+export declare function compareResultsAndFilterIgnoredKeys(ignoredKeys: string[], _objA: Record<string, unknown>, _objB: Record<string, unknown>): boolean;
+export declare function compareArrayResultsWithIgnoredKeys(ignoredKeys: string[], objA: unknown[], objB: unknown[]): boolean;
+/**
+ * This is the type we pass to define a request "task".
+ */
+export interface RateLimitTask {
+    sendArgs: [string, Array<unknown>];
+    resolve: (result: unknown) => void;
+    reject: (err: unknown) => void;
+}
+/**
+ * A helper function to format an error message for a provider.
+ * @param provider The provider that failed.
+ * @param rawErrorText The raw error text.
+ * @returns The formatted error message.
+ */
+export declare function formatProviderError(provider: providers.StaticJsonRpcProvider, rawErrorText: string): string;
+export declare function createSendErrorWithMessage(message: string, sendError: Record<string, unknown>): {
+    name: string;
+    message: string;
+    stack?: string | undefined;
+    cause?: unknown;
+};
+/**
+ * Compares two RPC results, filtering out fields that are known to differ between providers.
+ * Note: this function references `IGNORED_ERROR_CODES` which is a record of error codes that correspond to fields
+ *       that should be ignored when comparing RPC results.
+ * @param method The method that was called - conditionally filters out fields based on the method.
+ * @param rpcResultA The first RPC result.
+ * @param rpcResultB The second RPC result.
+ * @returns True if the results are equal, false otherwise.
+ */
+export declare function compareRpcResults(method: string, rpcResultA: unknown, rpcResultB: unknown): boolean;
+export declare enum CacheType {
+    NONE = 0,
+    WITH_TTL = 1,
+    NO_TTL = 2
+}

package/dist/esm/providers/utils.js

@@ -0,0 +1,89 @@
+// The async/queue library has a task-based interface for building a concurrent queue.
+import { __assign } from "tslib";
+import { isDefined } from "../utils";
+import { isEqual } from "lodash";
+/**
+ * Deletes keys from an object and returns new copy of object without ignored keys
+ * @param ignoredKeys
+ * @param obj
+ * @returns Objects with ignored keys removed
+ */
+function deleteIgnoredKeys(ignoredKeys, obj) {
+    if (!isDefined(obj)) {
+        return;
+    }
+    var newObj = __assign({}, obj);
+    for (var _i = 0, ignoredKeys_1 = ignoredKeys; _i < ignoredKeys_1.length; _i++) {
+        var key = ignoredKeys_1[_i];
+        delete newObj[key];
+    }
+    return newObj;
+}
+export function compareResultsAndFilterIgnoredKeys(ignoredKeys, _objA, _objB) {
+    // Remove ignored keys from copied objects.
+    var filteredA = deleteIgnoredKeys(ignoredKeys, _objA);
+    var filteredB = deleteIgnoredKeys(ignoredKeys, _objB);
+    // Compare objects without the ignored keys.
+    return isEqual(filteredA, filteredB);
+}
+export function compareArrayResultsWithIgnoredKeys(ignoredKeys, objA, objB) {
+    // Remove ignored keys from each element of copied arrays.
+    var filteredA = objA === null || objA === void 0 ? void 0 : objA.map(function (obj) { return deleteIgnoredKeys(ignoredKeys, obj); });
+    var filteredB = objB === null || objB === void 0 ? void 0 : objB.map(function (obj) { return deleteIgnoredKeys(ignoredKeys, obj); });
+    // Compare objects without the ignored keys.
+    return isDefined(filteredA) && isDefined(filteredB) && isEqual(filteredA, filteredB);
+}
+/**
+ * A helper function to format an error message for a provider.
+ * @param provider The provider that failed.
+ * @param rawErrorText The raw error text.
+ * @returns The formatted error message.
+ */
+export function formatProviderError(provider, rawErrorText) {
+    return "Provider ".concat(provider.connection.url, " failed with error: ").concat(rawErrorText);
+}
+export function createSendErrorWithMessage(message, sendError) {
+    var error = new Error(message);
+    return __assign(__assign({}, sendError), error);
+}
+/**
+ * Compares two RPC results, filtering out fields that are known to differ between providers.
+ * Note: this function references `IGNORED_ERROR_CODES` which is a record of error codes that correspond to fields
+ *       that should be ignored when comparing RPC results.
+ * @param method The method that was called - conditionally filters out fields based on the method.
+ * @param rpcResultA The first RPC result.
+ * @param rpcResultB The second RPC result.
+ * @returns True if the results are equal, false otherwise.
+ */
+export function compareRpcResults(method, rpcResultA, rpcResultB) {
+    if (method === "eth_getBlockByNumber") {
+        // We've seen RPC's disagree on the miner field, for example when Polygon nodes updated software that
+        // led alchemy and quicknode to disagree on the miner field's value.
+        return compareResultsAndFilterIgnoredKeys([
+            "miner",
+            "l1BatchNumber",
+            "l1BatchTimestamp",
+            "size",
+            "totalDifficulty", // Quicknode/Alchemy (sometimes)
+        ], rpcResultA, rpcResultB);
+    }
+    else if (method === "eth_getLogs") {
+        // We've seen some RPC's like QuickNode add in transactionLogIndex which isn't in the
+        // JSON RPC spec: https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterchanges
+        // Additional reference: https://github.com/ethers-io/ethers.js/issues/1721
+        // 2023-08-31 Added blockHash because of upstream zkSync provider disagreements. Consider removing later.
+        // 2024-05-07 Added l1BatchNumber and logType due to Alchemy. Consider removing later.
+        // 2024-07-11 Added blockTimestamp after zkSync rolled out a new node release.
+        return compareArrayResultsWithIgnoredKeys(["blockTimestamp", "transactionLogIndex", "l1BatchNumber", "logType"], rpcResultA, rpcResultB);
+    }
+    else {
+        return isEqual(rpcResultA, rpcResultB);
+    }
+}
+export var CacheType;
+(function (CacheType) {
+    CacheType[CacheType["NONE"] = 0] = "NONE";
+    CacheType[CacheType["WITH_TTL"] = 1] = "WITH_TTL";
+    CacheType[CacheType["NO_TTL"] = 2] = "NO_TTL";
+})(CacheType || (CacheType = {}));
+//# sourceMappingURL=utils.js.map

package/dist/esm/providers/utils.js.map

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

package/dist/esm/utils/NetworkUtils.d.ts

@@ -64,3 +64,9 @@ export declare function chainIsCCTPEnabled(chainId: number): boolean;
  * @returns True if chainId requires manual L1 -> L2 finalization, otherwise false.
  */
 export declare function chainRequiresL1ToL2Finalization(chainId: number): boolean;
+/**
+ * Returns the origin of a URL.
+ * @param url A URL.
+ * @returns The origin of the URL, or "UNKNOWN" if the URL is invalid.
+ */
+export declare function getOriginFromURL(url: string): string;

package/dist/esm/utils/NetworkUtils.js

@@ -106,4 +106,17 @@ export function chainIsCCTPEnabled(chainId) {
 export function chainRequiresL1ToL2Finalization(chainId) {
     return chainIsCCTPEnabled(chainId) || chainIsLinea(chainId);
 }
+/**
+ * Returns the origin of a URL.
+ * @param url A URL.
+ * @returns The origin of the URL, or "UNKNOWN" if the URL is invalid.
+ */
+export function getOriginFromURL(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch (e) {
+        return "UNKNOWN";
+    }
+}
 //# sourceMappingURL=NetworkUtils.js.map

package/dist/esm/utils/NetworkUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkUtils.js","sourceRoot":"","sources":["../../../src/utils/NetworkUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE7G,IAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,UAAU;CACjB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAA0B;;IACvD,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9B,OAAO,MAAA,MAAA,MAAA,eAAe,CAAC,SAAS,CAAC,0CAAE,IAAI,mCAAI,WAAW,CAAC,SAAS,CAAC,mCAAI,SAAS,CAAC;AACjF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAwB;;IAC3D,OAAO,MAAA,MAAA,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,0CAAE,WAAW,mCAAI,KAAK,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;;IAC5C,OAAO,MAAA,CAAA,MAAA,eAAe,CAAC,OAAO,CAAC,0CAAE,MAAM,MAAK,WAAW,CAAC,QAAQ,mCAAI,KAAK,CAAC;AAC5E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO;QACL,WAAW;QACX,SAAS,CAAC,IAAI;QACd,SAAS,CAAC,QAAQ;QAClB,SAAS,CAAC,QAAQ;QAClB,SAAS,CAAC,OAAO;QACjB,WAAW;QACX,SAAS,CAAC,YAAY;QACtB,SAAS,CAAC,gBAAgB;QAC1B,SAAS,CAAC,gBAAgB;QAC1B,SAAS,CAAC,YAAY;KACvB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,OAAe;IAC7D,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"NetworkUtils.js","sourceRoot":"","sources":["../../../src/utils/NetworkUtils.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/ObjectUtils.js

@@ -1,8 +1,8 @@
-import { __assign, __spreadArray } from "tslib";
 /* eslint-disable @typescript-eslint/explicit-module-boundary-types */
 /* eslint-disable @typescript-eslint/no-explicit-any */
 // Append value along the keyPath to object. For example assign(deposits, ['1337', '31337'], [{depositId:1}]) will create
 // deposits = {1337:{31337:[{depositId:1}]}}. Note that if the path into the object exists then this will append. This
+import { __assign, __spreadArray } from "tslib";
 // function respects the destination type; if it is an object then deep merge and if an array effectively will push.
 export function assign(obj, keyPath, value) {
     var lastKeyIndex = keyPath.length - 1;

package/dist/esm/utils/ObjectUtils.js.map

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

package/dist/types/index.d.ts

@@ -13,4 +13,5 @@ export * as typeguards from "./typeguards";
 export * as clients from "./clients";
 export * as typechain from "./typechain";
 export * as caching from "./caching";
+export * as providers from "./providers";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,kBAAkB,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,iBAAiB,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,kBAAkB,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,iBAAiB,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC"}

package/dist/types/providers/cachedProvider.d.ts

@@ -0,0 +1,18 @@
+import { CachingMechanismInterface } from "../interfaces";
+import { RateLimitedProvider } from "./rateLimitedProvider";
+export declare class CacheProvider extends RateLimitedProvider {
+    readonly redisClient?: CachingMechanismInterface | undefined;
+    readonly standardTtlBlockDistance: number;
+    readonly noTtlBlockDistance: number;
+    readonly providerCacheTtl: number;
+    readonly getBlockByNumberPrefix: string;
+    readonly getLogsCachePrefix: string;
+    readonly callCachePrefix: string;
+    readonly baseTTL: number;
+    constructor(providerCacheNamespace: string, redisClient?: CachingMechanismInterface | undefined, standardTtlBlockDistance: number, noTtlBlockDistance: number, providerCacheTtl: number, ...jsonRpcConstructorParams: ConstructorParameters<typeof RateLimitedProvider>);
+    send(method: string, params: Array<unknown>): Promise<unknown>;
+    private buildRedisKey;
+    private cacheType;
+    private cacheTypeForBlock;
+}
+//# sourceMappingURL=cachedProvider.d.ts.map

package/dist/types/providers/cachedProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cachedProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/cachedProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,qBAAa,aAAc,SAAQ,mBAAmB;IAQlD,QAAQ,CAAC,WAAW,CAAC;IAErB,QAAQ,CAAC,wBAAwB;IAEjC,QAAQ,CAAC,kBAAkB;IAC3B,QAAQ,CAAC,gBAAgB;IAZ3B,SAAgB,sBAAsB,EAAE,MAAM,CAAC;IAC/C,SAAgB,kBAAkB,EAAE,MAAM,CAAC;IAC3C,SAAgB,eAAe,EAAE,MAAM,CAAC;IACxC,SAAgB,OAAO,EAAE,MAAM,CAAC;gBAG9B,sBAAsB,EAAE,MAAM,EACrB,WAAW,CAAC,uCAA2B,EAEvC,wBAAwB,QAA2B,EAEnD,kBAAkB,QAA2B,EAC7C,gBAAgB,QAAqB,EAC9C,GAAG,wBAAwB,EAAE,qBAAqB,CAAC,OAAO,mBAAmB,CAAC;IAmBjE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAwC7E,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,SAAS;YAuCH,iBAAiB;CAsBhC"}

package/dist/types/providers/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const BLOCK_NUMBER_TTL = 60;
+export declare const PROVIDER_CACHE_TTL = 3600;
+export declare const PROVIDER_CACHE_TTL_MODIFIER = 0.15;
+/**
+ * A default timeout for requests of 60 seconds.
+ */
+export declare const defaultTimeout: number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/providers/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAGnC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,cAAc,QAAY,CAAC"}

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

@@ -0,0 +1,6 @@
+export * from "./rateLimitedProvider";
+export * from "./cachedProvider";
+export * from "./retryProvider";
+export * from "./constants";
+export * from "./utils";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/types/providers/rateLimitedProvider.d.ts

@@ -0,0 +1,11 @@
+import { ethers } from "ethers";
+import { Logger } from "winston";
+export declare class RateLimitedProvider extends ethers.providers.StaticJsonRpcProvider {
+    readonly pctRpcCallsLogged: number;
+    readonly logger: Logger;
+    private queue;
+    constructor(maxConcurrency: number, pctRpcCallsLogged: number, logger?: Logger, ...cacheConstructorParams: ConstructorParameters<typeof ethers.providers.StaticJsonRpcProvider>);
+    wrapSendWithLog(method: string, params: Array<unknown>): Promise<any>;
+    send(method: string, params: Array<unknown>): Promise<unknown>;
+}
+//# sourceMappingURL=rateLimitedProvider.d.ts.map

package/dist/types/providers/rateLimitedProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimitedProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/rateLimitedProvider.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAKjC,qBAAa,mBAAoB,SAAQ,MAAM,CAAC,SAAS,CAAC,qBAAqB;IAQ3E,QAAQ,CAAC,iBAAiB,EAAE,MAAM;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAPzB,OAAO,CAAC,KAAK,CAA6B;gBAKxC,cAAc,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,MAAM,GAAE,MAAkB,EACnC,GAAG,sBAAsB,EAAE,qBAAqB,CAAC,OAAO,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC;IAiB3F,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;IAwCnD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAaxE"}

package/dist/types/providers/retryProvider.d.ts

@@ -0,0 +1,17 @@
+import { ethers } from "ethers";
+import { CachingMechanismInterface } from "../interfaces";
+import { AugmentedLogger } from "@uma/logger";
+export declare class RetryProvider extends ethers.providers.StaticJsonRpcProvider {
+    readonly nodeQuorumThreshold: number;
+    readonly retries: number;
+    readonly delay: number;
+    readonly maxConcurrency: number;
+    readonly providers: ethers.providers.StaticJsonRpcProvider[];
+    constructor(params: ConstructorParameters<typeof ethers.providers.StaticJsonRpcProvider>[], chainId: number, nodeQuorumThreshold: number, retries: number, delay: number, maxConcurrency: number, providerCacheNamespace: string, pctRpcCallsLogged: number, redisClient?: CachingMechanismInterface, standardTtlBlockDistance?: number, noTtlBlockDistance?: number, providerCacheTtl?: number, logger?: AugmentedLogger);
+    send(method: string, params: Array<unknown>): Promise<unknown>;
+    _validateResponse(method: string, _: Array<unknown>, response: unknown): boolean;
+    _sendAndValidate(provider: ethers.providers.StaticJsonRpcProvider, method: string, params: Array<unknown>): Promise<unknown>;
+    _trySend(provider: ethers.providers.StaticJsonRpcProvider, method: string, params: Array<unknown>): Promise<unknown>;
+    _getQuorum(method: string, params: Array<unknown>): number;
+}
+//# sourceMappingURL=retryProvider.d.ts.map

package/dist/types/providers/retryProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/retryProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAK1D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,qBAAa,aAAc,SAAQ,MAAM,CAAC,SAAS,CAAC,qBAAqB;IAKrE,QAAQ,CAAC,mBAAmB,EAAE,MAAM;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM;IAPjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC;gBAE3D,MAAM,EAAE,qBAAqB,CAAC,OAAO,MAAM,CAAC,SAAS,CAAC,qBAAqB,CAAC,EAAE,EAC9E,OAAO,EAAE,MAAM,EACN,mBAAmB,EAAE,MAAM,EAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EAC/B,sBAAsB,EAAE,MAAM,EAC9B,iBAAiB,EAAE,MAAM,EACzB,WAAW,CAAC,EAAE,yBAAyB,EACvC,wBAAwB,CAAC,EAAE,MAAM,EACjC,kBAAkB,CAAC,EAAE,MAAM,EAC3B,gBAAgB,SAAqB,EACrC,MAAM,CAAC,EAAE,eAAe;IAqCX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IA+I7E,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO;IAO1E,gBAAgB,CACpB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,qBAAqB,EAChD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GACrB,OAAO,CAAC,OAAO,CAAC;IAiBnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM;CAqB3D"}

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

@@ -0,0 +1,40 @@
+import { providers } from "ethers";
+export declare function compareResultsAndFilterIgnoredKeys(ignoredKeys: string[], _objA: Record<string, unknown>, _objB: Record<string, unknown>): boolean;
+export declare function compareArrayResultsWithIgnoredKeys(ignoredKeys: string[], objA: unknown[], objB: unknown[]): boolean;
+/**
+ * This is the type we pass to define a request "task".
+ */
+export interface RateLimitTask {
+    sendArgs: [string, Array<unknown>];
+    resolve: (result: unknown) => void;
+    reject: (err: unknown) => void;
+}
+/**
+ * A helper function to format an error message for a provider.
+ * @param provider The provider that failed.
+ * @param rawErrorText The raw error text.
+ * @returns The formatted error message.
+ */
+export declare function formatProviderError(provider: providers.StaticJsonRpcProvider, rawErrorText: string): string;
+export declare function createSendErrorWithMessage(message: string, sendError: Record<string, unknown>): {
+    name: string;
+    message: string;
+    stack?: string | undefined;
+    cause?: unknown;
+};
+/**
+ * Compares two RPC results, filtering out fields that are known to differ between providers.
+ * Note: this function references `IGNORED_ERROR_CODES` which is a record of error codes that correspond to fields
+ *       that should be ignored when comparing RPC results.
+ * @param method The method that was called - conditionally filters out fields based on the method.
+ * @param rpcResultA The first RPC result.
+ * @param rpcResultB The second RPC result.
+ * @returns True if the results are equal, false otherwise.
+ */
+export declare function compareRpcResults(method: string, rpcResultA: unknown, rpcResultB: unknown): boolean;
+export declare enum CacheType {
+    NONE = 0,
+    WITH_TTL = 1,
+    NO_TTL = 2
+}
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/providers/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAqBnC,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAOT;AAED,wBAAgB,kCAAkC,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAOnH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAE5B,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAInC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,qBAAqB,EAAE,YAAY,EAAE,MAAM,UAElG;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;EAG7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CA8BnG;AAED,oBAAY,SAAS;IACnB,IAAI,IAAA;IACJ,QAAQ,IAAA;IACR,MAAM,IAAA;CACP"}