hardhat-finder

Hardhat plugin to find compiler outputs of contracts.

What

This plugin will help you with reviews and implementations by giving compiler outputs of contracts.

Installation

Install the plugin via npm:

npm install hardhat-finder

Install the plugin via yarn:

yarn add hardhat-finder

---

Import the plugin in your hardhat.config.js:

require("hardhat-finder");

Or if you are using TypeScript, in your hardhat.config.ts:

import "hardhat-finder";

Tasks

This plugin adds the finder task to Hardhat:

Usage: hardhat [GLOBAL OPTIONS] finder [--colorify] [--compact] [--depth <INT>] [--include-dependencies] [--max-string-length <INT>] [--name <STRING>] [--no-compile] [--path <INPUTFILE>] [--prettify] [...outputs]
$ hardhat finder --prettify --colorify contracts/Example.sol Example abi bytecode

@@@@@@@ contracts/Example.sol:Example @@@@@@@
======= Abi ======= (contracts/Example.sol:Example)
[
  {
    inputs: [],
    name: 'foo',
    outputs: [
      {
        internalType: 'uint256',
        name: '',
        type: 'uint256'
      }
    ],
    stateMutability: 'pure',
    type: 'function'
  }
]
======= Bytecode ======= (contracts/Example.sol:Example)
'0x608060405234801561001057600080fd5b5060b68061001f6000396000f3fe6080604052348015600f57600080fd5b506004361060285760003560e01c8063c298557814602d575b600080fd5b60336047565b604051603e9190605d565b60405180910390f35b60006005905090565b6057816076565b82525050565b6000602082019050607060008301846050565b92915050565b600081905091905056fea264697066735822122086e7e92f8524c3c79ce92e0551a14a908c36694cb02510ce7a32d137d929e93764736f6c63430008040033'

Environment extensions

This plugin extends the Hardhat Runtime Environment by adding an finder field whose type is Finder.

Configuration

This plugin extends the HardhatUserConfig's FinderUserConfig object with the finder field.

This is an example of how to set it:

module.exports = {
  finder: {
    contract: {
      path: "contracts/Example.sol",
      name: "Example",
    },
    outputs: [
      "metadata",
      "storage-layout",
      "dependencies-info",
      "source-code",
      "fully-qualified-name",
      "method-identifiers",
    ],
    depth: Infinity,
    maxStringLength: Infinity,
    includeDependencies: false,
    colorify: false,
    prettify: false,
    compact: false,
    noCompile: false,
    runOnCompile: false,
  },
};

Option	Type	Default	Description
outputs	String[]	["artifact", "build-info", "abi", "metadata", "bytecode", "bytecode-runtime", "link-references", "link-references-runtime", "immutable-references", "immutable-references-runtime", "source-code", "dependencies-source-code", "dependencies-info", "settings", "solc-version", "ast", "method-identifiers", "opcodes", "opcodes-runtime", "storage-layout", "fully-qualified-name", "developer-document", "user-document", "generated-sources", "generated-sources-runtime", "source-map", "source-map-runtime"]	Types of output the contract wants to print.
depth	Number	Infinity	The maximum number of nested JSON objects to be printed in outputs.
maxStringLength	Number	Infinity	The maximum number of string lengths to be printed in outputs.
includeDependencies	Boolean	false	Include contract dependencies in outputs.
colorify	Boolean	false	Colorize the outputs.
prettify	Boolean	false	Beautify the outputs.
compact	Boolean	false	Compact the outputs.
noCompile	Boolean	false	Don't compile before running this task.
runOnCompile	Boolean	false	Run finder task during compile task.

Usage

There are no additional steps you need to take for this plugin to work.

Install it and access finder through the Hardhat Runtime Environment anywhere you need it (tasks, scripts, tests, etc).

import { finder } from "hardhat";

async function main() {
  const contractPath = "contracts/ExampleLibrary.sol";
  const contractName = "ExampleLibrary";
  await finder.setFor({
    contractPath,
    contractName,
  });

  console.log(finder.getUserDocument());
  console.log(finder.getDeveloperDocument());
}