@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/aws/s3.js

@@ -0,0 +1,69 @@
+import { GetObjectCommand, S3Client } from '@aws-sdk/client-s3';
+import { streamToString } from '@recoillink/utils';
+export const S3_BUCKET_REGEX = /^(?:https?:\/\/)?(.*)\.s3\.(.*)\.amazonaws.com\/?$/;
+export class S3Wrapper {
+    config;
+    client;
+    cache;
+    static fromBucketUrl(bucketUrl) {
+        const match = bucketUrl.match(S3_BUCKET_REGEX);
+        if (!match)
+            throw new Error('Could not parse bucket url');
+        return new S3Wrapper({
+            bucket: match[1],
+            region: match[2],
+            caching: true,
+        });
+    }
+    constructor(config) {
+        this.config = config;
+        this.client = new S3Client({
+            ...config,
+            // explicitly set empty credentials to allow usage without env vars
+            credentials: {
+                accessKeyId: '',
+                secretAccessKey: '',
+            },
+            signer: { sign: async (req) => req },
+        });
+        if (config.caching) {
+            this.cache = {};
+        }
+    }
+    formatKey(key) {
+        return this.config.folder ? `${this.config.folder}/${key}` : key;
+    }
+    async getS3Obj(key) {
+        const Key = this.formatKey(key);
+        if (this.cache?.[Key]) {
+            return this.cache[Key];
+        }
+        const command = new GetObjectCommand({
+            Bucket: this.config.bucket,
+            Key,
+        });
+        try {
+            const response = await this.client.send(command);
+            const body = await streamToString(response.Body);
+            const result = {
+                data: JSON.parse(body),
+                modified: response.LastModified,
+            };
+            if (this.cache) {
+                this.cache[Key] = result;
+            }
+            return result;
+        }
+        catch (e) {
+            if (e.message.includes('The specified key does not exist.')) {
+                return;
+            }
+            throw e;
+        }
+    }
+    url(key) {
+        const Key = this.formatKey(key);
+        return `https://${this.config.bucket}.s3.${this.config.region}.amazonaws.com/${Key}`;
+    }
+}
+//# sourceMappingURL=s3.js.map

package/dist/aws/s3.js.map

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

package/dist/aws/validator.d.ts

@@ -0,0 +1,22 @@
+import { Announcement, BaseValidator, ReorgEvent, S3Announcement, S3CheckpointWithId, ValidatorConfig, ValidatorMetadata } from '@recoillink/utils';
+import { S3Config, S3Wrapper } from './s3.js';
+export declare const S3_LOCATION_PREFIX = "s3://";
+/**
+ * Extension of BaseValidator that includes AWS S3 utilities.
+ */
+export declare class S3Validator extends BaseValidator {
+    validatorConfig: ValidatorConfig;
+    s3Config: S3Config;
+    s3Bucket: S3Wrapper;
+    constructor(validatorConfig: ValidatorConfig, s3Config: S3Config);
+    static fromStorageLocation(storageLocation: string): Promise<S3Validator>;
+    getAnnouncement(): Promise<Announcement>;
+    getSignedAnnouncement(): Promise<S3Announcement>;
+    getMetadata(): Promise<ValidatorMetadata>;
+    getCheckpoint(index: number): Promise<S3CheckpointWithId | void>;
+    getLatestCheckpointIndex(): Promise<number>;
+    storageLocation(): string;
+    getLatestCheckpointUrl(): string;
+    getReorgStatus(): Promise<ReorgEvent | null>;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/aws/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/aws/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EAElB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAQ9C,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C;;GAEG;AACH,qBAAa,WAAY,SAAQ,aAAa;IAInC,eAAe,EAAE,eAAe;IAChC,QAAQ,EAAE,QAAQ;IAJpB,QAAQ,EAAE,SAAS,CAAC;IAE3B,YACS,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,QAAQ,EAI1B;IAED,OAAa,mBAAmB,CAC9B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,WAAW,CAAC,CA4BtB;IAEK,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAG7C;IAEK,qBAAqB,IAAI,OAAO,CAAC,cAAc,CAAC,CAOrD;IAEK,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAO9C;IAEK,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAYrE;IAEK,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAOhD;IAED,eAAe,IAAI,MAAM,CAExB;IAED,sBAAsB,IAAI,MAAM,CAE/B;IAEK,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAOjD;CACF"}

package/dist/aws/validator.js

@@ -0,0 +1,99 @@
+import { BaseValidator, isS3CheckpointWithId, } from '@recoillink/utils';
+import { S3Wrapper } from './s3.js';
+const checkpointWithMessageIdKey = (checkpointIndex) => `checkpoint_${checkpointIndex}_with_id.json`;
+const LATEST_KEY = 'checkpoint_latest_index.json';
+const ANNOUNCEMENT_KEY = 'announcement.json';
+const METADATA_KEY = 'metadata_latest.json';
+const REORG_KEY = 'reorg_flag.json';
+export const S3_LOCATION_PREFIX = 's3://';
+/**
+ * Extension of BaseValidator that includes AWS S3 utilities.
+ */
+export class S3Validator extends BaseValidator {
+    validatorConfig;
+    s3Config;
+    s3Bucket;
+    constructor(validatorConfig, s3Config) {
+        super(validatorConfig);
+        this.validatorConfig = validatorConfig;
+        this.s3Config = s3Config;
+        this.s3Bucket = new S3Wrapper(s3Config);
+    }
+    static async fromStorageLocation(storageLocation) {
+        if (storageLocation.startsWith(S3_LOCATION_PREFIX)) {
+            const suffix = storageLocation.slice(S3_LOCATION_PREFIX.length);
+            const pieces = suffix.split('/');
+            if (pieces.length >= 2) {
+                const s3Config = {
+                    bucket: pieces[0],
+                    region: pieces[1],
+                    folder: pieces.slice(2).join('/'),
+                    caching: true,
+                };
+                const s3Bucket = new S3Wrapper(s3Config);
+                const announcement = await s3Bucket.getS3Obj(ANNOUNCEMENT_KEY);
+                if (!announcement) {
+                    throw new Error('No announcement found');
+                }
+                const validatorConfig = {
+                    address: announcement.data.value.validator,
+                    localDomain: announcement.data.value.mailbox_domain,
+                    mailbox: announcement.data.value.mailbox_address,
+                };
+                return new S3Validator(validatorConfig, s3Config);
+            }
+        }
+        throw new Error(`Unable to parse location ${storageLocation}`);
+    }
+    async getAnnouncement() {
+        const { value } = await this.getSignedAnnouncement();
+        return value;
+    }
+    async getSignedAnnouncement() {
+        const resp = await this.s3Bucket.getS3Obj(ANNOUNCEMENT_KEY);
+        if (!resp) {
+            throw new Error(`No announcement found for ${this.config.localDomain}`);
+        }
+        return resp.data;
+    }
+    async getMetadata() {
+        const resp = await this.s3Bucket.getS3Obj(METADATA_KEY);
+        if (!resp) {
+            throw new Error(`No metadata found for ${this.config.localDomain}`);
+        }
+        return resp.data;
+    }
+    async getCheckpoint(index) {
+        const key = checkpointWithMessageIdKey(index);
+        const s3Object = await this.s3Bucket.getS3Obj(key);
+        if (!s3Object) {
+            return;
+        }
+        if (isS3CheckpointWithId(s3Object.data)) {
+            return s3Object.data;
+        }
+        else {
+            throw new Error('Failed to parse checkpoint');
+        }
+    }
+    async getLatestCheckpointIndex() {
+        const latestCheckpointIndex = await this.s3Bucket.getS3Obj(LATEST_KEY);
+        if (!latestCheckpointIndex)
+            return -1;
+        return latestCheckpointIndex.data;
+    }
+    storageLocation() {
+        return `${S3_LOCATION_PREFIX}/${this.s3Bucket.config.bucket}/${this.s3Bucket.config.region}`;
+    }
+    getLatestCheckpointUrl() {
+        return this.s3Bucket.url(LATEST_KEY);
+    }
+    async getReorgStatus() {
+        const resp = await this.s3Bucket.getS3Obj(REORG_KEY);
+        if (!resp) {
+            return null;
+        }
+        return resp.data;
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/aws/validator.js.map

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

package/dist/block-explorer/etherscan.d.ts

@@ -0,0 +1,142 @@
+import { Address, HexString } from '@recoillink/utils';
+import type { SolidityStandardJsonInput } from '../deploy/verify/types.js';
+import { GetEventLogsResponse } from '../rpc/evm/types.js';
+export declare enum EtherscanLikeExplorerApiModule {
+    LOGS = "logs",
+    CONTRACT = "contract"
+}
+export declare enum EtherscanLikeExplorerApiAction {
+    GETSOURCECODE = "getsourcecode",
+    VERIFY_IMPLEMENTATION = "verifysourcecode",
+    VERIFY_PROXY = "verifyproxycontract",
+    CHECK_IMPLEMENTATION_STATUS = "checkverifystatus",
+    CHECK_PROXY_STATUS = "checkproxyverification",
+    GET_CONTRACT_CREATION_CODE = "getcontractcreation",
+    GET_LOGS = "getLogs"
+}
+export declare enum EtherscanLikeExplorerApiErrors {
+    ALREADY_VERIFIED = "Contract source code already verified",
+    ALREADY_VERIFIED_ALT = "Already Verified",
+    NOT_VERIFIED = "Contract source code not verified",
+    VERIFICATION_PENDING = "Pending in queue",
+    PROXY_FAILED = "A corresponding implementation contract was unfortunately not detected for the proxy address.",
+    BYTECODE_MISMATCH = "Fail - Unable to verify. Compiled contract deployment bytecode does NOT match the transaction deployment bytecode.",
+    UNABLE_TO_VERIFY = "Fail - Unable to verify",
+    UNKNOWN_UID = "Unknown UID",
+    NO_RECORD = "No records found",
+    NO_LOGS_FOUND = "No logs found"
+}
+export declare enum ExplorerLicenseType {
+    NO_LICENSE = "1",
+    UNLICENSED = "2",
+    MIT = "3",
+    GPL2 = "4",
+    GPL3 = "5",
+    LGPL2 = "6",
+    LGPL3 = "7",
+    BSD2 = "8",
+    BSD3 = "9",
+    MPL2 = "10",
+    OSL3 = "11",
+    APACHE2 = "12",
+    AGPL3 = "13",
+    BSL = "14"
+}
+interface EtherscanLikeAPIOptions {
+    apiKey?: string;
+    apiUrl: string;
+}
+interface BaseEtherscanLikeAPIParams<TModule extends EtherscanLikeExplorerApiModule, TAction extends EtherscanLikeExplorerApiAction> {
+    module: TModule;
+    action: TAction;
+}
+type GetContractDeploymentTransactionResponse = {
+    contractAddress: Address;
+    contractCreator: Address;
+    txHash: HexString;
+    blockNumber?: number;
+};
+export declare function tryGetContractDeploymentTransaction(explorerOptions: EtherscanLikeAPIOptions, { contractAddress }: {
+    contractAddress: Address;
+}): Promise<GetContractDeploymentTransactionResponse | undefined>;
+export declare function getContractDeploymentTransaction(explorerOptions: EtherscanLikeAPIOptions, requestOptions: {
+    contractAddress: Address;
+}): Promise<GetContractDeploymentTransactionResponse>;
+interface GetEventLogs extends BaseEtherscanLikeAPIParams<EtherscanLikeExplorerApiModule.LOGS, EtherscanLikeExplorerApiAction.GET_LOGS> {
+    address: Address;
+    fromBlock: number;
+    toBlock: number;
+    topic0: string;
+    page: number;
+    offset: number;
+}
+type GetEventLogsOptions = Omit<GetEventLogs, 'module' | 'action' | 'page' | 'offset'>;
+type ExplorerLogRangeOptions = {
+    address?: Address;
+    fromBlock?: number | 'latest';
+    toBlock?: number | 'latest';
+};
+type ExplorerLogIdentity = {
+    blockNumber: number | string;
+    transactionHash: string;
+    logIndex: number | string;
+};
+/**
+ * Reads every explorer page for a log range or throws without returning the
+ * prefix collected so far. Both direct explorer reads and explorer providers
+ * use this so a successful getLogs response has the same completeness contract.
+ */
+export declare function readPaginatedExplorerLogs<T extends ExplorerLogIdentity>(options: ExplorerLogRangeOptions, readPage: (page: number, offset: number) => Promise<T[]>): Promise<T[]>;
+export declare function getLogsFromEtherscanLikeExplorerAPI({ apiUrl, apiKey: apikey }: EtherscanLikeAPIOptions, options: GetEventLogsOptions): Promise<Array<GetEventLogsResponse>>;
+type GetContractSourceCodeResponse = {
+    SourceCode: string;
+    ContractName: string;
+    CompilerVersion: string;
+    OptimizationUsed: string;
+    Runs: string;
+    ConstructorArguments: string;
+    EVMVersion: string;
+    Library: string;
+    LicenseType: string;
+    Proxy: string;
+    Implementation: string;
+    SwarmSource: string;
+    SimilarMatch: string;
+};
+export declare function getContractSourceCode(explorerOptions: EtherscanLikeAPIOptions, { contractAddress }: {
+    contractAddress: Address;
+}): Promise<GetContractSourceCodeResponse>;
+type VerifyImplementationContractViaSolidityStandardJsonOptions = {
+    sourceCode: SolidityStandardJsonInput;
+    contractName: string;
+    contractAddress: Address;
+    compilerVersion: string;
+    zkCompilerVersion?: string;
+    licenseType?: ExplorerLicenseType;
+    constructorArguments?: HexString;
+};
+/**
+ * Wrapper function for the `https://api.etherscan.io/v2/api?chainid=1&module=contract&action=verifysourcecode&apikey=...`
+ * endpoint request with the `codeformat` option set to `solidity-standard-json-input`
+ */
+export declare function verifyContractSourceCodeViaStandardJsonInput(explorerOptions: EtherscanLikeAPIOptions, verificationOptions: VerifyImplementationContractViaSolidityStandardJsonOptions): Promise<string>;
+type VerifyProxyContractOptions = {
+    contractAddress: Address;
+    implementationAddress: Address;
+};
+/**
+ * Wrapper function for the `https://api.etherscan.io/v2/api?chainid=...&module=contract&action=verifyproxycontract&apikey=...`
+ */
+export declare function verifyProxyContract(explorerOptions: EtherscanLikeAPIOptions, { contractAddress, implementationAddress }: VerifyProxyContractOptions): Promise<string>;
+/**
+ * Wrapper function for the
+ * `https://api.etherscan.io/v2/api?chainid=...&module=contract&action=...&guid=...&apikey=...`
+ * endpoint request with the `action` option set to `checkverifystatus` if `isProxy` is false
+ * or set to `checkproxyverification` if set to true.
+ */
+export declare function checkContractVerificationStatus(explorerOptions: EtherscanLikeAPIOptions, { isProxy, verificationId }: {
+    verificationId: string;
+    isProxy: boolean;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=etherscan.d.ts.map

package/dist/block-explorer/etherscan.d.ts.map

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

package/dist/block-explorer/etherscan.js

@@ -0,0 +1,307 @@
+import { assert, isNullish, pick, retryAsync, strip0x, } from '@recoillink/utils';
+import { toNumber } from '../utils/numbers.js';
+export var EtherscanLikeExplorerApiModule;
+(function (EtherscanLikeExplorerApiModule) {
+    EtherscanLikeExplorerApiModule["LOGS"] = "logs";
+    EtherscanLikeExplorerApiModule["CONTRACT"] = "contract";
+})(EtherscanLikeExplorerApiModule || (EtherscanLikeExplorerApiModule = {}));
+export var EtherscanLikeExplorerApiAction;
+(function (EtherscanLikeExplorerApiAction) {
+    EtherscanLikeExplorerApiAction["GETSOURCECODE"] = "getsourcecode";
+    EtherscanLikeExplorerApiAction["VERIFY_IMPLEMENTATION"] = "verifysourcecode";
+    EtherscanLikeExplorerApiAction["VERIFY_PROXY"] = "verifyproxycontract";
+    EtherscanLikeExplorerApiAction["CHECK_IMPLEMENTATION_STATUS"] = "checkverifystatus";
+    EtherscanLikeExplorerApiAction["CHECK_PROXY_STATUS"] = "checkproxyverification";
+    EtherscanLikeExplorerApiAction["GET_CONTRACT_CREATION_CODE"] = "getcontractcreation";
+    EtherscanLikeExplorerApiAction["GET_LOGS"] = "getLogs";
+})(EtherscanLikeExplorerApiAction || (EtherscanLikeExplorerApiAction = {}));
+export var EtherscanLikeExplorerApiErrors;
+(function (EtherscanLikeExplorerApiErrors) {
+    EtherscanLikeExplorerApiErrors["ALREADY_VERIFIED"] = "Contract source code already verified";
+    EtherscanLikeExplorerApiErrors["ALREADY_VERIFIED_ALT"] = "Already Verified";
+    EtherscanLikeExplorerApiErrors["NOT_VERIFIED"] = "Contract source code not verified";
+    EtherscanLikeExplorerApiErrors["VERIFICATION_PENDING"] = "Pending in queue";
+    EtherscanLikeExplorerApiErrors["PROXY_FAILED"] = "A corresponding implementation contract was unfortunately not detected for the proxy address.";
+    EtherscanLikeExplorerApiErrors["BYTECODE_MISMATCH"] = "Fail - Unable to verify. Compiled contract deployment bytecode does NOT match the transaction deployment bytecode.";
+    EtherscanLikeExplorerApiErrors["UNABLE_TO_VERIFY"] = "Fail - Unable to verify";
+    EtherscanLikeExplorerApiErrors["UNKNOWN_UID"] = "Unknown UID";
+    EtherscanLikeExplorerApiErrors["NO_RECORD"] = "No records found";
+    EtherscanLikeExplorerApiErrors["NO_LOGS_FOUND"] = "No logs found";
+})(EtherscanLikeExplorerApiErrors || (EtherscanLikeExplorerApiErrors = {}));
+// see https://etherscan.io/contract-license-types
+export var ExplorerLicenseType;
+(function (ExplorerLicenseType) {
+    ExplorerLicenseType["NO_LICENSE"] = "1";
+    ExplorerLicenseType["UNLICENSED"] = "2";
+    ExplorerLicenseType["MIT"] = "3";
+    ExplorerLicenseType["GPL2"] = "4";
+    ExplorerLicenseType["GPL3"] = "5";
+    ExplorerLicenseType["LGPL2"] = "6";
+    ExplorerLicenseType["LGPL3"] = "7";
+    ExplorerLicenseType["BSD2"] = "8";
+    ExplorerLicenseType["BSD3"] = "9";
+    ExplorerLicenseType["MPL2"] = "10";
+    ExplorerLicenseType["OSL3"] = "11";
+    ExplorerLicenseType["APACHE2"] = "12";
+    ExplorerLicenseType["AGPL3"] = "13";
+    ExplorerLicenseType["BSL"] = "14";
+})(ExplorerLicenseType || (ExplorerLicenseType = {}));
+function formatExplorerUrl({ apiUrl, apiKey }, params) {
+    // hack for Blockscout API urls that in the explorer have the `eth-rpc` path set
+    // as it will cause requests to fail with a not found error
+    const urlObject = new URL(apiUrl.replace('eth-rpc', ''));
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+            urlObject.searchParams.append(key, value.toString());
+        }
+    }
+    if (apiKey) {
+        urlObject.searchParams.append('apikey', apiKey);
+    }
+    return urlObject.toString();
+}
+async function handleEtherscanResponse(response) {
+    const body = await response.json();
+    const explorerUrl = new URL(response.url);
+    // Avoid throwing if no logs are found for the current address
+    if (body.status === '0' &&
+        body.message !== EtherscanLikeExplorerApiErrors.NO_RECORD &&
+        body.message !== EtherscanLikeExplorerApiErrors.NO_LOGS_FOUND) {
+        throw new Error(`Error while performing request to Etherscan like API at ${explorerUrl.host}: ${body.message} ${body.result}`);
+    }
+    return body.result;
+}
+function getFormPostRequestBody(input) {
+    const formParams = new URLSearchParams(Object.entries(input).filter(([_key, value]) => !isNullish(value)));
+    return {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: formParams,
+    };
+}
+export async function tryGetContractDeploymentTransaction(explorerOptions, { contractAddress }) {
+    const options = {
+        module: EtherscanLikeExplorerApiModule.CONTRACT,
+        action: EtherscanLikeExplorerApiAction.GET_CONTRACT_CREATION_CODE,
+        contractaddresses: contractAddress,
+    };
+    const requestUrl = formatExplorerUrl(explorerOptions, options);
+    const response = await fetch(requestUrl);
+    const [deploymentTx] = await handleEtherscanResponse(response);
+    if (!deploymentTx) {
+        return undefined;
+    }
+    return {
+        contractAddress: deploymentTx.contractAddress,
+        contractCreator: deploymentTx.contractCreator,
+        txHash: deploymentTx.txHash,
+        blockNumber: isNullish(deploymentTx.blockNumber)
+            ? undefined
+            : toNumber(deploymentTx.blockNumber, 'blockNumber'),
+    };
+}
+/**
+ * An explorer that has no record of a contract's deployment transaction will
+ * keep answering the same way, so `retryAsync` must not spend attempts on it.
+ */
+class ContractDeploymentTransactionNotFoundError extends Error {
+    isRecoverable = false;
+    constructor(contractAddress) {
+        super(`No deployment transaction found for contract ${contractAddress}`);
+        this.name = 'ContractDeploymentTransactionNotFoundError';
+    }
+}
+export async function getContractDeploymentTransaction(explorerOptions, requestOptions) {
+    const deploymentTx = await tryGetContractDeploymentTransaction(explorerOptions, requestOptions);
+    if (!deploymentTx) {
+        throw new ContractDeploymentTransactionNotFoundError(requestOptions.contractAddress);
+    }
+    return deploymentTx;
+}
+// Records per page and pages per block range, both measured against Etherscan
+// V2 on chainid 1: a request that names neither is answered with the first 1000
+// records of the range under a success status, and page 11 is refused whatever
+// the offset. Their product is therefore the most logs the endpoint will hand
+// over for one block range.
+const EXPLORER_LOGS_PAGE_SIZE = 1_000;
+const MAX_EXPLORER_LOG_PAGES = 10;
+/**
+ * Thrown when a block range holds more logs than the explorer will page
+ * through. What has been collected by then is a prefix of the range rather than
+ * the whole of it, and nothing in the responses says so, so it is dropped
+ * instead of returned.
+ *
+ * The ceiling is a property of the endpoint rather than of the moment, so
+ * `retryAsync` must not spend attempts on it: `isRecoverable = false` sends a
+ * reader or composite provider to its RPC fallback on the first response, and
+ * that fallback paginates by block and so has no equivalent ceiling.
+ */
+class ExplorerLogPageLimitError extends Error {
+    isRecoverable = false;
+    constructor(options) {
+        super(`Explorer served ${MAX_EXPLORER_LOG_PAGES} full pages of ${EXPLORER_LOGS_PAGE_SIZE} logs ${describeExplorerLogRange(options)}, which is as far as it pages, so the logs of that range cannot be read in full`);
+        this.name = 'ExplorerLogPageLimitError';
+    }
+}
+/**
+ * Thrown when a page of a block range's logs could not be read.
+ *
+ * The pages before it were served, so asking for the range again would repeat
+ * them, and the retries this page is worth have already been spent below. It
+ * therefore carries the same `isRecoverable = false` as the ceiling above, so a
+ * reader or composite provider moves on to its RPC fallback instead of
+ * restarting a read that is nine tenths done.
+ */
+class ExplorerLogPageReadError extends Error {
+    isRecoverable = false;
+    constructor(page, options, cause) {
+        const reason = cause instanceof Error ? cause.message : String(cause);
+        super(`Explorer failed to serve page ${page} of the logs ${describeExplorerLogRange(options)}: ${reason}`, { cause });
+        this.name = 'ExplorerLogPageReadError';
+    }
+}
+function describeExplorerLogRange({ address, fromBlock, toBlock, }) {
+    const addressDescription = address ? `for contract ${address} ` : '';
+    return `${addressDescription}between blocks ${fromBlock ?? 'earliest'} and ${toBlock ?? 'latest'}`;
+}
+// Explorers report a zero valued field as a bare "0x", which Number reads as
+// NaN: NaN compares false against everything, so a log index that arrived that
+// way silently loses the ordering comparisons the callers of this run on. A
+// field that is not a number at all throws here, which sends the reader to its
+// RPC fallback rather than into the same silence.
+function toEventLogsResponse(rawLog) {
+    return {
+        address: rawLog.address,
+        blockNumber: toNumber(rawLog.blockNumber, 'blockNumber'),
+        data: rawLog.data,
+        logIndex: toNumber(rawLog.logIndex, 'logIndex'),
+        topics: rawLog.topics,
+        transactionHash: rawLog.transactionHash,
+        transactionIndex: toNumber(rawLog.transactionIndex, 'transactionIndex'),
+    };
+}
+// A block whose logs straddle a page boundary is served at the end of one page
+// and again at the start of the next, so concatenating pages would repeat it.
+// The three fields together identify a log whether the explorer scopes
+// logIndex to the block or to the transaction.
+function logIdentity(log) {
+    return `${toNumber(log.blockNumber, 'blockNumber')}:${log.transactionHash.toLowerCase()}:${toNumber(log.logIndex, 'logIndex')}`;
+}
+// Retrying the page rather than the read is what keeps a rate limited page from
+// re-requesting the pages already served. Only the request is retried: a
+// response the explorer did serve is judged once, by the caller.
+async function readExplorerLogPage(readPage, page, options) {
+    try {
+        return await retryAsync(readPage);
+    }
+    catch (error) {
+        throw new ExplorerLogPageReadError(page, options, error);
+    }
+}
+/**
+ * Reads every explorer page for a log range or throws without returning the
+ * prefix collected so far. Both direct explorer reads and explorer providers
+ * use this so a successful getLogs response has the same completeness contract.
+ */
+export async function readPaginatedExplorerLogs(options, readPage) {
+    const logsByIdentity = new Map();
+    for (let page = 1; page <= MAX_EXPLORER_LOG_PAGES; page++) {
+        const pageLogs = await readExplorerLogPage(() => readPage(page, EXPLORER_LOGS_PAGE_SIZE), page, options);
+        assert(Array.isArray(pageLogs), `Explorer did not return a list of logs ${describeExplorerLogRange(options)}`);
+        for (const log of pageLogs) {
+            logsByIdentity.set(logIdentity(log), log);
+        }
+        // A page the explorer could not fill is the last one it has.
+        if (pageLogs.length < EXPLORER_LOGS_PAGE_SIZE) {
+            return [...logsByIdentity.values()];
+        }
+    }
+    throw new ExplorerLogPageLimitError(options);
+}
+export async function getLogsFromEtherscanLikeExplorerAPI({ apiUrl, apiKey: apikey }, options) {
+    const rawLogs = await readPaginatedExplorerLogs(options, async (page, offset) => {
+        const data = {
+            module: EtherscanLikeExplorerApiModule.LOGS,
+            action: EtherscanLikeExplorerApiAction.GET_LOGS,
+            address: options.address,
+            fromBlock: options.fromBlock,
+            toBlock: options.toBlock,
+            topic0: options.topic0,
+            page,
+            offset,
+        };
+        const requestUrl = formatExplorerUrl({ apiUrl, apiKey: apikey }, data);
+        const response = await fetch(requestUrl);
+        return handleEtherscanResponse(response);
+    });
+    return rawLogs.map(toEventLogsResponse);
+}
+export async function getContractSourceCode(explorerOptions, { contractAddress }) {
+    const options = {
+        action: EtherscanLikeExplorerApiAction.GETSOURCECODE,
+        address: contractAddress,
+        module: EtherscanLikeExplorerApiModule.CONTRACT,
+    };
+    const requestUrl = formatExplorerUrl(explorerOptions, options);
+    const response = await fetch(requestUrl);
+    const [sourceCodeResults] = await handleEtherscanResponse(response);
+    return sourceCodeResults;
+}
+/**
+ * Wrapper function for the `https://api.etherscan.io/v2/api?chainid=1&module=contract&action=verifysourcecode&apikey=...`
+ * endpoint request with the `codeformat` option set to `solidity-standard-json-input`
+ */
+export async function verifyContractSourceCodeViaStandardJsonInput(explorerOptions, verificationOptions) {
+    const input = {
+        module: EtherscanLikeExplorerApiModule.CONTRACT,
+        action: EtherscanLikeExplorerApiAction.VERIFY_IMPLEMENTATION,
+        codeformat: 'solidity-standard-json-input',
+        compilerversion: verificationOptions.compilerVersion,
+        contractaddress: verificationOptions.contractAddress,
+        contractname: verificationOptions.contractName,
+        sourceCode: JSON.stringify(verificationOptions.sourceCode),
+        constructorArguements: strip0x(verificationOptions.constructorArguments ?? ''),
+        licenseType: verificationOptions.licenseType,
+    };
+    if (!isNullish(verificationOptions.zkCompilerVersion)) {
+        input.zksolcversion = verificationOptions.zkCompilerVersion;
+    }
+    const params = pick(input, ['action', 'module']);
+    const requestUrl = formatExplorerUrl(explorerOptions, params);
+    const response = await fetch(requestUrl, getFormPostRequestBody(input));
+    return handleEtherscanResponse(response);
+}
+/**
+ * Wrapper function for the `https://api.etherscan.io/v2/api?chainid=...&module=contract&action=verifyproxycontract&apikey=...`
+ */
+export async function verifyProxyContract(explorerOptions, { contractAddress, implementationAddress }) {
+    const input = {
+        action: EtherscanLikeExplorerApiAction.VERIFY_PROXY,
+        module: EtherscanLikeExplorerApiModule.CONTRACT,
+        address: contractAddress,
+        expectedimplementation: implementationAddress,
+    };
+    const params = pick(input, ['action', 'module']);
+    const requestUrl = formatExplorerUrl(explorerOptions, params);
+    const response = await fetch(requestUrl, getFormPostRequestBody(input));
+    return handleEtherscanResponse(response);
+}
+/**
+ * Wrapper function for the
+ * `https://api.etherscan.io/v2/api?chainid=...&module=contract&action=...&guid=...&apikey=...`
+ * endpoint request with the `action` option set to `checkverifystatus` if `isProxy` is false
+ * or set to `checkproxyverification` if set to true.
+ */
+export async function checkContractVerificationStatus(explorerOptions, { isProxy, verificationId }) {
+    const input = {
+        action: isProxy
+            ? EtherscanLikeExplorerApiAction.CHECK_PROXY_STATUS
+            : EtherscanLikeExplorerApiAction.CHECK_IMPLEMENTATION_STATUS,
+        guid: verificationId,
+        module: EtherscanLikeExplorerApiModule.CONTRACT,
+    };
+    const requestUrl = formatExplorerUrl(explorerOptions, input);
+    const response = await fetch(requestUrl);
+    await handleEtherscanResponse(response);
+}
+//# sourceMappingURL=etherscan.js.map