Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ItsNickBarry/hardhat-abi-exporter
🧰 Export Ethereum contract ABIs on compilation ⚙️
https://github.com/ItsNickBarry/hardhat-abi-exporter
abi blockchain buidler dapps eth ether ethereum hardhat smart-contracts solc solidity version-control wow
Last synced: about 1 month ago
JSON representation
🧰 Export Ethereum contract ABIs on compilation ⚙️
- Host: GitHub
- URL: https://github.com/ItsNickBarry/hardhat-abi-exporter
- Owner: ItsNickBarry
- License: mit
- Created: 2020-08-01T22:36:20.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-23T13:41:03.000Z (about 2 months ago)
- Last Synced: 2024-11-07T04:47:06.707Z (about 1 month ago)
- Topics: abi, blockchain, buidler, dapps, eth, ether, ethereum, hardhat, smart-contracts, solc, solidity, version-control, wow
- Language: TypeScript
- Homepage:
- Size: 392 KB
- Stars: 76
- Watchers: 4
- Forks: 20
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-solidity - ItsNickBarry/hardhat-abi-exporter - Export contract ABIs on compilation via Hardhat. (Libraries)
- awesome-solidity - ItsNickBarry/hardhat-abi-exporter - Export contract ABIs on compilation via Hardhat. (Libraries)
- awesome-solidity - ItsNickBarry/hardhat-abi-exporter - Export contract ABIs on compilation via Hardhat. (Libraries)
README
# Hardhat ABI Exporter
Export Ethereum smart contract ABIs on compilation via Hardhat.
> Versions of this plugin prior to `2.0.0` were released as `buidler-abi-exporter`.
## Installation
```bash
npm install --save-dev hardhat-abi-exporter
# or
yarn add --dev hardhat-abi-exporter
```
## Usage
Load plugin in Hardhat config:
```javascript
require('hardhat-abi-exporter');
```
Add configuration under the `abiExporter` key:
| option | description | default |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------ |
| `path` | path to ABI export directory (relative to Hardhat root) | `'./abi'` |
| `runOnCompile` | whether to automatically export ABIs during compilation | `false` |
| `clear` | whether to delete old ABI files in `path` on compilation | `false` |
| `flat` | whether to flatten output directory (may cause name collisions) | `false` |
| `only` | `Array` of `String` matchers used to select included contracts, defaults to all contracts if `length` is 0 | `[]` |
| `except` | `Array` of `String` matchers used to exclude contracts | `[]` |
| `spacing` | number of spaces per indentation level of formatted output | `2` |
| `pretty` | whether to use interface-style formatting of output for better readability | `false` |
| `format` | format type ("json", "minimal", "fullName"). Alternative to `pretty` | `json` |
| `filter` | `Function` with signature `(abiElement: any, index: number, abi: any, fullyQualifiedName: string) => boolean` used to filter elements from each exported ABI | `() => true` |
| `rename` | `Function` with signature `(sourceName: string, contractName: string) => string` used to rename an exported ABI (incompatible with `flat` option) | `undefined` |
Note that the configuration formatted as either a single `Object`, or an `Array` of objects. An `Array` may be used to specify multiple outputs.
```javascript
abiExporter: {
path: './data/abi',
runOnCompile: true,
clear: true,
flat: true,
only: [':ERC20$'],
spacing: 2,
pretty: true,
format: "minimal",
}
// or
abiExporter: [
{
path: './abi/pretty',
pretty: true,
},
{
path: './abi/ugly',
pretty: false,
},
]
// or
abiExporter: [
{
path: './abi/json',
format: "json",
},
{
path: './abi/minimal',
format: "minimal",
},
{
path: './abi/fullName',
format: "fullName",
},
]
```
The included Hardhat tasks may be run manually:
```bash
npx hardhat export-abi
npx hardhat clear-abi
# or
yarn run hardhat export-abi
yarn run hardhat clear-abi
```
By default, the hardhat `compile` task is run before exporting ABIs. This behavior can be disabled with the `--no-compile` flag:
```bash
npx hardhat export-abi --no-compile
# or
yarn run hardhat export-abi --no-compile
```
The `path` directory will be created if it does not exist.
The `clear` option is set to `false` by default because it represents a destructive action, but should be set to `true` in most cases.
ABIs files are saved in the format `[CONTRACT_NAME].json`.
## Development
Install dependencies via Yarn:
```bash
yarn install
```
Setup Husky to format code on commit:
```bash
yarn prepare
```