@ring-protocol/smart-order-router 0.5.0

package/build/module/providers/index.d.ts

@@ -0,0 +1,56 @@
+export * from './cache';
+export * from './cache-node';
+export * from './caching-gas-provider';
+export * from './caching-token-list-provider';
+export * from './caching-token-provider';
+export * from './caching/route';
+export * from './eip-1559-gas-price-provider';
+export * from './eth-estimate-gas-provider';
+export * from './eth-gas-station-info-gas-price-provider';
+export * from './gas-price-provider';
+export * from './legacy-gas-price-provider';
+export * from './multicall-provider';
+export * from './multicall-uniswap-provider';
+export * from './multicall-ringswap-provider';
+export * from './on-chain-gas-price-provider';
+export * from './on-chain-quote-provider';
+export * from './pool-provider';
+export * from './simulation-provider';
+export * from './static-gas-price-provider';
+export * from './swap-router-provider';
+export * from './tenderly-simulation-provider';
+export * from './token-properties-provider';
+export * from './token-provider';
+export * from './token-validator-provider';
+export * from './uri-subgraph-provider';
+export * from './v2/caching-pool-provider';
+export * from './v2/caching-subgraph-provider';
+export * from './v2/pool-provider';
+export * from './v2/quote-provider';
+export * from './v2/static-subgraph-provider';
+export * from './v2/subgraph-provider';
+export * from './v2/subgraph-provider-with-fallback';
+export * from './v2/uri-subgraph-provider';
+export * from './fewV2/ring-caching-pool-provider';
+export * from './fewV2/ring-caching-subgraph-provider';
+export * from './fewV2/ring-pool-provider';
+export * from './fewV2/ring-quote-provider';
+export * from './fewV2/ring-static-subgraph-provider';
+export * from './fewV2/ring-subgraph-provider';
+export * from './fewV2/ring-subgraph-provider-with-fallback';
+export * from './fewV2/ring-uri-subgraph-provider';
+export * from './v3/caching-pool-provider';
+export * from './v3/caching-subgraph-provider';
+export * from './v3/pool-provider';
+export * from './v3/static-subgraph-provider';
+export * from './v3/subgraph-provider';
+export * from './v3/subgraph-provider-with-fallback';
+export * from './v3/uri-subgraph-provider';
+export * from './v4/caching-pool-provider';
+export * from './v4/caching-subgraph-provider';
+export * from './v4/euler-swap-hooks-subgraph-provider';
+export * from './v4/pool-provider';
+export * from './v4/static-subgraph-provider';
+export * from './v4/subgraph-provider';
+export * from './v4/subgraph-provider-with-fallback';
+export * from './v4/uri-subgraph-provider';

package/build/module/providers/index.js

@@ -0,0 +1,57 @@
+export * from './cache';
+export * from './cache-node';
+export * from './caching-gas-provider';
+export * from './caching-token-list-provider';
+export * from './caching-token-provider';
+export * from './caching/route';
+export * from './eip-1559-gas-price-provider';
+export * from './eth-estimate-gas-provider';
+export * from './eth-gas-station-info-gas-price-provider';
+export * from './gas-price-provider';
+export * from './legacy-gas-price-provider';
+export * from './multicall-provider';
+export * from './multicall-uniswap-provider';
+export * from './multicall-ringswap-provider';
+export * from './on-chain-gas-price-provider';
+export * from './on-chain-quote-provider';
+export * from './pool-provider';
+export * from './simulation-provider';
+export * from './static-gas-price-provider';
+export * from './swap-router-provider';
+export * from './tenderly-simulation-provider';
+export * from './token-properties-provider';
+export * from './token-provider';
+export * from './token-validator-provider';
+export * from './uri-subgraph-provider';
+export * from './v2/caching-pool-provider';
+export * from './v2/caching-subgraph-provider';
+export * from './v2/pool-provider';
+export * from './v2/quote-provider';
+export * from './v2/static-subgraph-provider';
+export * from './v2/subgraph-provider';
+export * from './v2/subgraph-provider-with-fallback';
+export * from './v2/uri-subgraph-provider';
+export * from './fewV2/ring-caching-pool-provider';
+export * from './fewV2/ring-caching-subgraph-provider';
+export * from './fewV2/ring-pool-provider';
+export * from './fewV2/ring-quote-provider';
+export * from './fewV2/ring-static-subgraph-provider';
+export * from './fewV2/ring-subgraph-provider';
+export * from './fewV2/ring-subgraph-provider-with-fallback';
+export * from './fewV2/ring-uri-subgraph-provider';
+export * from './v3/caching-pool-provider';
+export * from './v3/caching-subgraph-provider';
+export * from './v3/pool-provider';
+export * from './v3/static-subgraph-provider';
+export * from './v3/subgraph-provider';
+export * from './v3/subgraph-provider-with-fallback';
+export * from './v3/uri-subgraph-provider';
+export * from './v4/caching-pool-provider';
+export * from './v4/caching-subgraph-provider';
+export * from './v4/euler-swap-hooks-subgraph-provider';
+export * from './v4/pool-provider';
+export * from './v4/static-subgraph-provider';
+export * from './v4/subgraph-provider';
+export * from './v4/subgraph-provider-with-fallback';
+export * from './v4/uri-subgraph-provider';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvcHJvdmlkZXJzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsU0FBUyxDQUFDO0FBQ3hCLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsd0JBQXdCLENBQUM7QUFDdkMsY0FBYywrQkFBK0IsQ0FBQztBQUM5QyxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYywrQkFBK0IsQ0FBQztBQUM5QyxjQUFjLDZCQUE2QixDQUFDO0FBQzVDLGNBQWMsMkNBQTJDLENBQUM7QUFDMUQsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLDZCQUE2QixDQUFDO0FBQzVDLGNBQWMsc0JBQXNCLENBQUM7QUFDckMsY0FBYyw4QkFBOEIsQ0FBQztBQUM3QyxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYywyQkFBMkIsQ0FBQztBQUMxQyxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsdUJBQXVCLENBQUM7QUFDdEMsY0FBYyw2QkFBNkIsQ0FBQztBQUM1QyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsZ0NBQWdDLENBQUM7QUFDL0MsY0FBYyw2QkFBNkIsQ0FBQztBQUM1QyxjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsNEJBQTRCLENBQUM7QUFDM0MsY0FBYyx5QkFBeUIsQ0FBQztBQUN4QyxjQUFjLDRCQUE0QixDQUFDO0FBQzNDLGNBQWMsZ0NBQWdDLENBQUM7QUFDL0MsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLHNDQUFzQyxDQUFDO0FBQ3JELGNBQWMsNEJBQTRCLENBQUM7QUFDM0MsY0FBYyxvQ0FBb0MsQ0FBQztBQUNuRCxjQUFjLHdDQUF3QyxDQUFDO0FBQ3ZELGNBQWMsNEJBQTRCLENBQUM7QUFDM0MsY0FBYyw2QkFBNkIsQ0FBQztBQUM1QyxjQUFjLHVDQUF1QyxDQUFDO0FBQ3RELGNBQWMsZ0NBQWdDLENBQUM7QUFDL0MsY0FBYyw4Q0FBOEMsQ0FBQztBQUM3RCxjQUFjLG9DQUFvQyxDQUFDO0FBQ25ELGNBQWMsNEJBQTRCLENBQUM7QUFDM0MsY0FBYyxnQ0FBZ0MsQ0FBQztBQUMvQyxjQUFjLG9CQUFvQixDQUFDO0FBQ25DLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLHNDQUFzQyxDQUFDO0FBQ3JELGNBQWMsNEJBQTRCLENBQUM7QUFDM0MsY0FBYyw0QkFBNEIsQ0FBQztBQUMzQyxjQUFjLGdDQUFnQyxDQUFDO0FBQy9DLGNBQWMseUNBQXlDLENBQUM7QUFDeEQsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsd0JBQXdCLENBQUM7QUFDdkMsY0FBYyxzQ0FBc0MsQ0FBQztBQUNyRCxjQUFjLDRCQUE0QixDQUFDIn0=

package/build/module/providers/legacy-gas-price-provider.d.ts

@@ -0,0 +1,7 @@
+import { JsonRpcProvider } from '@ethersproject/providers';
+import { GasPrice, IGasPriceProvider } from './gas-price-provider';
+export declare class LegacyGasPriceProvider extends IGasPriceProvider {
+    protected provider: JsonRpcProvider;
+    constructor(provider: JsonRpcProvider);
+    getGasPrice(_latestBlockNumber: number, _requestBlockNumber?: number): Promise<GasPrice>;
+}

package/build/module/providers/legacy-gas-price-provider.js

@@ -0,0 +1,14 @@
+import { IGasPriceProvider } from './gas-price-provider';
+export class LegacyGasPriceProvider extends IGasPriceProvider {
+    constructor(provider) {
+        super();
+        this.provider = provider;
+    }
+    async getGasPrice(_latestBlockNumber, _requestBlockNumber) {
+        const gasPriceWei = await this.provider.getGasPrice();
+        return {
+            gasPriceWei,
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGVnYWN5LWdhcy1wcmljZS1wcm92aWRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9wcm92aWRlcnMvbGVnYWN5LWdhcy1wcmljZS1wcm92aWRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQVksaUJBQWlCLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUVuRSxNQUFNLE9BQU8sc0JBQXVCLFNBQVEsaUJBQWlCO0lBQzNELFlBQXNCLFFBQXlCO1FBQzdDLEtBQUssRUFBRSxDQUFDO1FBRFksYUFBUSxHQUFSLFFBQVEsQ0FBaUI7SUFFL0MsQ0FBQztJQUVlLEtBQUssQ0FBQyxXQUFXLENBQy9CLGtCQUEwQixFQUMxQixtQkFBNEI7UUFFNUIsTUFBTSxXQUFXLEdBQUcsTUFBTSxJQUFJLENBQUMsUUFBUSxDQUFDLFdBQVcsRUFBRSxDQUFDO1FBQ3RELE9BQU87WUFDTCxXQUFXO1NBQ1osQ0FBQztJQUNKLENBQUM7Q0FDRiJ9

package/build/module/providers/multicall-provider.d.ts

@@ -0,0 +1,83 @@
+import { Interface } from '@ethersproject/abi';
+import { BigNumber } from '@ethersproject/bignumber';
+import { ProviderConfig } from './provider';
+export declare type CallSameFunctionOnMultipleContractsParams<TFunctionParams, TAdditionalConfig = any> = {
+    addresses: string[];
+    contractInterface: Interface;
+    functionName: string;
+    functionParams?: TFunctionParams;
+    providerConfig?: ProviderConfig;
+    additionalConfig?: TAdditionalConfig;
+};
+export declare type CallSameFunctionOnContractWithMultipleParams<TFunctionParams, TAdditionalConfig = any> = {
+    address: string;
+    contractInterface: Interface;
+    functionName: string;
+    functionParams: TFunctionParams[];
+    providerConfig?: ProviderConfig;
+    additionalConfig?: TAdditionalConfig;
+};
+export declare type CallMultipleFunctionsOnSameContractParams<TFunctionParams, TAdditionalConfig = any> = {
+    address: string;
+    contractInterface: Interface;
+    functionNames: string[];
+    functionParams?: TFunctionParams[];
+    providerConfig?: ProviderConfig;
+    additionalConfig?: TAdditionalConfig;
+};
+export declare type SuccessResult<TReturn> = {
+    success: true;
+    result: TReturn;
+};
+export declare type FailResult = {
+    success: false;
+    returnData: string;
+    gasUsed?: BigNumber;
+};
+export declare type Result<TReturn> = SuccessResult<TReturn> | FailResult;
+/**
+ * Provider for fetching data on chain using multicall contracts.
+ *
+ * @export
+ * @abstract
+ * @class IMulticallProvider
+ * @template TMulticallConfig
+ */
+export declare abstract class IMulticallProvider<TMulticallConfig = any> {
+    /**
+     * Calls the same function on multiple contracts.
+     *
+     * For example, if you wanted to get the ERC-20 balance of 10 different tokens
+     * this can be used to call balance on the 10 contracts in a single multicall.
+     *
+     * @abstract
+     * @template TFunctionParams
+     * @template TReturn
+     * @param params
+     * @returns {*}
+     */
+    abstract callSameFunctionOnMultipleContracts<TFunctionParams extends any[] | undefined, TReturn = any>(params: CallSameFunctionOnMultipleContractsParams<TFunctionParams, TMulticallConfig>): Promise<{
+        blockNumber: BigNumber;
+        results: Result<TReturn>[];
+    }>;
+    /**
+     * Calls a function on a single contract with different parameters.
+     *
+     * For example, if you wanted to call the Uniswap V3 Quoter with 10 different
+     * swap amounts this can be used to make the calls in a single multicall.
+     *
+     * @abstract
+     * @template TFunctionParams
+     * @template TReturn
+     * @param params
+     * @returns {*}
+     */
+    abstract callSameFunctionOnContractWithMultipleParams<TFunctionParams extends any[] | undefined, TReturn = any>(params: CallSameFunctionOnContractWithMultipleParams<TFunctionParams, TMulticallConfig>): Promise<{
+        blockNumber: BigNumber;
+        results: Result<TReturn>[];
+    }>;
+    abstract callMultipleFunctionsOnSameContract<TFunctionParams extends any[] | undefined, TReturn = any>(params: CallMultipleFunctionsOnSameContractParams<TFunctionParams, TMulticallConfig>): Promise<{
+        blockNumber: BigNumber;
+        results: Result<TReturn>[];
+    }>;
+}

package/build/module/providers/multicall-provider.js

@@ -0,0 +1,11 @@
+/**
+ * Provider for fetching data on chain using multicall contracts.
+ *
+ * @export
+ * @abstract
+ * @class IMulticallProvider
+ * @template TMulticallConfig
+ */
+export class IMulticallProvider {
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibXVsdGljYWxsLXByb3ZpZGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3Byb3ZpZGVycy9tdWx0aWNhbGwtcHJvdmlkZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBc0RBOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLE9BQWdCLGtCQUFrQjtDQStEdkMifQ==

package/build/module/providers/multicall-ringswap-provider.d.ts

@@ -0,0 +1,35 @@
+import { BigNumber } from '@ethersproject/bignumber';
+import { BaseProvider } from '@ethersproject/providers';
+import { ChainId } from '@ring-protocol/sdk-core';
+import { CallMultipleFunctionsOnSameContractParams, CallSameFunctionOnContractWithMultipleParams, CallSameFunctionOnMultipleContractsParams, IMulticallProvider, Result } from './multicall-provider';
+import { UniswapMulticallConfig } from './multicall-uniswap-provider';
+/**
+ * The UniswapMulticall contract has added functionality for limiting the amount of gas
+ * that each call within the multicall can consume. This is useful for operations where
+ * a call could consume such a large amount of gas that it causes the node to error out
+ * with an out of gas error.
+ *
+ * @export
+ * @class RingswapMulticallProvider
+ */
+export declare class RingswapMulticallProvider extends IMulticallProvider<UniswapMulticallConfig> {
+    protected chainId: ChainId;
+    protected provider: BaseProvider;
+    protected gasLimitPerCall: number;
+    private multicallContract;
+    constructor(chainId: ChainId, provider: BaseProvider, gasLimitPerCall?: number);
+    callSameFunctionOnMultipleContracts<TFunctionParams extends any[] | undefined, TReturn = any>(params: CallSameFunctionOnMultipleContractsParams<TFunctionParams>): Promise<{
+        blockNumber: BigNumber;
+        results: Result<TReturn>[];
+    }>;
+    callSameFunctionOnContractWithMultipleParams<TFunctionParams extends any[] | undefined, TReturn>(params: CallSameFunctionOnContractWithMultipleParams<TFunctionParams, UniswapMulticallConfig>): Promise<{
+        blockNumber: BigNumber;
+        results: Result<TReturn>[];
+        approxGasUsedPerSuccessCall: number;
+    }>;
+    callMultipleFunctionsOnSameContract<TFunctionParams extends any[] | undefined, TReturn>(params: CallMultipleFunctionsOnSameContractParams<TFunctionParams, UniswapMulticallConfig>): Promise<{
+        blockNumber: BigNumber;
+        results: Result<TReturn>[];
+        approxGasUsedPerSuccessCall: number;
+    }>;
+}

package/build/module/providers/multicall-ringswap-provider.js

@@ -0,0 +1,157 @@
+import _ from 'lodash';
+import stats from 'stats-lite';
+import { UniswapInterfaceMulticall__factory } from '../types/v3/factories/UniswapInterfaceMulticall__factory';
+import { RING_UNISWAP_MULTICALL_ADDRESSES } from '../util/addresses';
+import { log } from '../util/log';
+import { IMulticallProvider, } from './multicall-provider';
+/**
+ * The UniswapMulticall contract has added functionality for limiting the amount of gas
+ * that each call within the multicall can consume. This is useful for operations where
+ * a call could consume such a large amount of gas that it causes the node to error out
+ * with an out of gas error.
+ *
+ * @export
+ * @class RingswapMulticallProvider
+ */
+export class RingswapMulticallProvider extends IMulticallProvider {
+    constructor(chainId, provider, gasLimitPerCall = 1000000) {
+        super();
+        this.chainId = chainId;
+        this.provider = provider;
+        this.gasLimitPerCall = gasLimitPerCall;
+        const multicallAddress = RING_UNISWAP_MULTICALL_ADDRESSES[this.chainId];
+        if (!multicallAddress) {
+            throw new Error(`No address for Ring Swap Multicall Contract on chain id: ${chainId}`);
+        }
+        this.multicallContract = UniswapInterfaceMulticall__factory.connect(multicallAddress, this.provider);
+    }
+    async callSameFunctionOnMultipleContracts(params) {
+        var _a;
+        const { addresses, contractInterface, functionName, functionParams, providerConfig, } = params;
+        const blockNumberOverride = (_a = providerConfig === null || providerConfig === void 0 ? void 0 : providerConfig.blockNumber) !== null && _a !== void 0 ? _a : undefined;
+        const fragment = contractInterface.getFunction(functionName);
+        const callData = contractInterface.encodeFunctionData(fragment, functionParams);
+        const calls = _.map(addresses, (address) => {
+            return {
+                target: address,
+                callData,
+                gasLimit: this.gasLimitPerCall,
+            };
+        });
+        log.debug({ calls }, `About to multicall for ${functionName} across ${addresses.length} addresses`);
+        const { blockNumber, returnData: aggregateResults } = await this.multicallContract.callStatic.multicall(calls, {
+            blockTag: blockNumberOverride,
+        });
+        const results = [];
+        for (let i = 0; i < aggregateResults.length; i++) {
+            const { success, returnData } = aggregateResults[i];
+            // Return data "0x" is sometimes returned for invalid calls.
+            if (!success || returnData.length <= 2) {
+                log.debug({ result: aggregateResults[i] }, `Invalid result calling ${functionName} on address ${addresses[i]}`);
+                results.push({
+                    success: false,
+                    returnData,
+                });
+                continue;
+            }
+            results.push({
+                success: true,
+                result: contractInterface.decodeFunctionResult(fragment, returnData),
+            });
+        }
+        log.debug({ results }, `Results for multicall on ${functionName} across ${addresses.length} addresses as of block ${blockNumber}`);
+        return { blockNumber, results };
+    }
+    async callSameFunctionOnContractWithMultipleParams(params) {
+        var _a, _b;
+        const { address, contractInterface, functionName, functionParams, additionalConfig, providerConfig, } = params;
+        const fragment = contractInterface.getFunction(functionName);
+        const gasLimitPerCall = (_a = additionalConfig === null || additionalConfig === void 0 ? void 0 : additionalConfig.gasLimitPerCallOverride) !== null && _a !== void 0 ? _a : this.gasLimitPerCall;
+        const blockNumberOverride = (_b = providerConfig === null || providerConfig === void 0 ? void 0 : providerConfig.blockNumber) !== null && _b !== void 0 ? _b : undefined;
+        const calls = _.map(functionParams, (functionParam) => {
+            const callData = contractInterface.encodeFunctionData(fragment, functionParam);
+            return {
+                target: address,
+                callData,
+                gasLimit: gasLimitPerCall,
+            };
+        });
+        log.debug({ calls }, `About to multicall for ${functionName} at address ${address} with ${functionParams.length} different sets of params`);
+        const { blockNumber, returnData: aggregateResults } = await this.multicallContract.callStatic.multicall(calls, {
+            blockTag: blockNumberOverride,
+        });
+        const results = [];
+        const gasUsedForSuccess = [];
+        for (let i = 0; i < aggregateResults.length; i++) {
+            const { success, returnData, gasUsed } = aggregateResults[i];
+            // Return data "0x" is sometimes returned for invalid pools.
+            if (!success || returnData.length <= 2) {
+                log.debug({ result: aggregateResults[i] }, `Invalid result calling ${functionName} address ${address} with params ${functionParams[i]}`);
+                results.push({
+                    success: false,
+                    returnData,
+                    gasUsed,
+                });
+                continue;
+            }
+            gasUsedForSuccess.push(gasUsed.toNumber());
+            results.push({
+                success: true,
+                result: contractInterface.decodeFunctionResult(fragment, returnData),
+            });
+        }
+        log.debug({ results, functionName, address }, `Results for multicall for ${functionName} at address ${address} with ${functionParams.length} different sets of params. Results as of block ${blockNumber}`);
+        return {
+            blockNumber,
+            results,
+            approxGasUsedPerSuccessCall: stats.percentile(gasUsedForSuccess, 99),
+        };
+    }
+    async callMultipleFunctionsOnSameContract(params) {
+        var _a, _b;
+        const { address, contractInterface, functionNames, functionParams, additionalConfig, providerConfig, } = params;
+        const gasLimitPerCall = (_a = additionalConfig === null || additionalConfig === void 0 ? void 0 : additionalConfig.gasLimitPerCallOverride) !== null && _a !== void 0 ? _a : this.gasLimitPerCall;
+        const blockNumberOverride = (_b = providerConfig === null || providerConfig === void 0 ? void 0 : providerConfig.blockNumber) !== null && _b !== void 0 ? _b : undefined;
+        const calls = _.map(functionNames, (functionName, i) => {
+            const fragment = contractInterface.getFunction(functionName);
+            const param = functionParams ? functionParams[i] : [];
+            const callData = contractInterface.encodeFunctionData(fragment, param);
+            return {
+                target: address,
+                callData,
+                gasLimit: gasLimitPerCall,
+            };
+        });
+        log.debug({ calls }, `About to multicall for ${functionNames.length} functions at address ${address} with ${functionParams === null || functionParams === void 0 ? void 0 : functionParams.length} different sets of params`);
+        const { blockNumber, returnData: aggregateResults } = await this.multicallContract.callStatic.multicall(calls, {
+            blockTag: blockNumberOverride,
+        });
+        const results = [];
+        const gasUsedForSuccess = [];
+        for (let i = 0; i < aggregateResults.length; i++) {
+            const fragment = contractInterface.getFunction(functionNames[i]);
+            const { success, returnData, gasUsed } = aggregateResults[i];
+            // Return data "0x" is sometimes returned for invalid pools.
+            if (!success || returnData.length <= 2) {
+                log.debug({ result: aggregateResults[i] }, `Invalid result calling ${functionNames[i]} with ${functionParams ? functionParams[i] : '0'} params`);
+                results.push({
+                    success: false,
+                    returnData,
+                });
+                continue;
+            }
+            gasUsedForSuccess.push(gasUsed.toNumber());
+            results.push({
+                success: true,
+                result: contractInterface.decodeFunctionResult(fragment, returnData),
+            });
+        }
+        log.debug({ results, functionNames, address }, `Results for multicall for ${functionNames.length} functions at address ${address} with ${functionParams ? functionParams.length : ' 0'} different sets of params. Results as of block ${blockNumber}`);
+        return {
+            blockNumber,
+            results,
+            approxGasUsedPerSuccessCall: stats.percentile(gasUsedForSuccess, 99),
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibXVsdGljYWxsLXJpbmdzd2FwLXByb3ZpZGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3Byb3ZpZGVycy9tdWx0aWNhbGwtcmluZ3N3YXAtcHJvdmlkZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxDQUFDLE1BQU0sUUFBUSxDQUFDO0FBQ3ZCLE9BQU8sS0FBSyxNQUFNLFlBQVksQ0FBQztBQUUvQixPQUFPLEVBQUUsa0NBQWtDLEVBQUUsTUFBTSwwREFBMEQsQ0FBQztBQUU5RyxPQUFPLEVBQUUsZ0NBQWdDLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUNyRSxPQUFPLEVBQUUsR0FBRyxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRWxDLE9BQU8sRUFJTCxrQkFBa0IsR0FFbkIsTUFBTSxzQkFBc0IsQ0FBQztBQUc5Qjs7Ozs7Ozs7R0FRRztBQUNILE1BQU0sT0FBTyx5QkFBMEIsU0FBUSxrQkFBMEM7SUFHdkYsWUFDWSxPQUFnQixFQUNoQixRQUFzQixFQUN0QixrQkFBa0IsT0FBUztRQUVyQyxLQUFLLEVBQUUsQ0FBQztRQUpFLFlBQU8sR0FBUCxPQUFPLENBQVM7UUFDaEIsYUFBUSxHQUFSLFFBQVEsQ0FBYztRQUN0QixvQkFBZSxHQUFmLGVBQWUsQ0FBWTtRQUdyQyxNQUFNLGdCQUFnQixHQUFHLGdDQUFnQyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUV4RSxJQUFJLENBQUMsZ0JBQWdCLEVBQUU7WUFDckIsTUFBTSxJQUFJLEtBQUssQ0FDYiw0REFBNEQsT0FBTyxFQUFFLENBQ3RFLENBQUM7U0FDSDtRQUVELElBQUksQ0FBQyxpQkFBaUIsR0FBRyxrQ0FBa0MsQ0FBQyxPQUFPLENBQ2pFLGdCQUFnQixFQUNoQixJQUFJLENBQUMsUUFBUSxDQUNkLENBQUM7SUFDSixDQUFDO0lBRU0sS0FBSyxDQUFDLG1DQUFtQyxDQUk5QyxNQUFrRTs7UUFLbEUsTUFBTSxFQUNKLFNBQVMsRUFD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

package/build/module/providers/multicall-uniswap-provider.d.ts

@@ -0,0 +1,37 @@
+import { BigNumber } from '@ethersproject/bignumber';
+import { BaseProvider } from '@ethersproject/providers';
+import { ChainId } from '@ring-protocol/sdk-core';
+import { CallMultipleFunctionsOnSameContractParams, CallSameFunctionOnContractWithMultipleParams, CallSameFunctionOnMultipleContractsParams, IMulticallProvider, Result } from './multicall-provider';
+export declare type UniswapMulticallConfig = {
+    gasLimitPerCallOverride?: number;
+};
+/**
+ * The UniswapMulticall contract has added functionality for limiting the amount of gas
+ * that each call within the multicall can consume. This is useful for operations where
+ * a call could consume such a large amount of gas that it causes the node to error out
+ * with an out of gas error.
+ *
+ * @export
+ * @class UniswapMulticallProvider
+ */
+export declare class UniswapMulticallProvider extends IMulticallProvider<UniswapMulticallConfig> {
+    protected chainId: ChainId;
+    protected provider: BaseProvider;
+    protected gasLimitPerCall: number;
+    private multicallContract;
+    constructor(chainId: ChainId, provider: BaseProvider, gasLimitPerCall?: number);
+    callSameFunctionOnMultipleContracts<TFunctionParams extends any[] | undefined, TReturn = any>(params: CallSameFunctionOnMultipleContractsParams<TFunctionParams>): Promise<{
+        blockNumber: BigNumber;
+        results: Result<TReturn>[];
+    }>;
+    callSameFunctionOnContractWithMultipleParams<TFunctionParams extends any[] | undefined, TReturn>(params: CallSameFunctionOnContractWithMultipleParams<TFunctionParams, UniswapMulticallConfig>): Promise<{
+        blockNumber: BigNumber;
+        results: Result<TReturn>[];
+        approxGasUsedPerSuccessCall: number;
+    }>;
+    callMultipleFunctionsOnSameContract<TFunctionParams extends any[] | undefined, TReturn>(params: CallMultipleFunctionsOnSameContractParams<TFunctionParams, UniswapMulticallConfig>): Promise<{
+        blockNumber: BigNumber;
+        results: Result<TReturn>[];
+        approxGasUsedPerSuccessCall: number;
+    }>;
+}