@nomiclabs/hardhat-etherscan/src/solc/version.ts

Hardhat plugin for verifying contracts on etherscan

import { pluginName } from "../constants";
import { HardhatEtherscanPluginError } from "../errors";
import { sendGetRequest } from "../undici";

const COMPILERS_LIST_URL = "https://solc-bin.ethereum.org/bin/list.json";

// Non-exhaustive interface for the official compiler list.
export interface CompilersList {
  releases: {
    [version: string]: string;
  };
  latestRelease: string;
}

// TODO: this could be retrieved from the hardhat config instead.
export async function getLongVersion(shortVersion: string): Promise<string> {
  const versions = await getVersions();
  const fullVersion = versions.releases[shortVersion];

  if (fullVersion === undefined || fullVersion === "") {
    throw new HardhatEtherscanPluginError(
      pluginName,
      "Given solc version doesn't exist"
    );
  }

  return fullVersion.replace(/(soljson-)(.*)(.js)/, "$2");
}

export async function getVersions(): Promise<CompilersList> {
  try {
    // It would be better to query an etherscan API to get this list but there's no such API yet.
    const response = await sendGetRequest(new URL(COMPILERS_LIST_URL));

    if (!(response.statusCode >= 200 && response.statusCode <= 299)) {
      const responseText = await response.body.text();
      throw new HardhatEtherscanPluginError(
        pluginName,
        `HTTP response is not ok. Status code: ${response.statusCode} Response text: ${responseText}`
      );
    }

    return (await response.body.json()) as CompilersList;
  } catch (error: any) {
    throw new HardhatEtherscanPluginError(
      pluginName,
      `Failed to obtain list of solc versions. Reason: ${error.message}`,
      error
    );
  }
}