0.4.1 • Published 9 months ago

hardhat-deploy-ethers v0.4.1

Weekly downloads
3,376
License
MIT
Repository
github
Last release
9 months ago

hardhat

hardhat-deploy-ethers

Hardhat plugin extension for @nomicfoundation/hardhat-ethers and its integration with ethers.js.

The extension add support for hardhat-deploy.

What

Installation

hardhat-deploy-ethers require the installation of hardhat-deploy and @nomicfoundation/hardhat-ethers

Note that you cannot use @nomicfoundation/hardhat-toolbox for installing @nomicfoundation/hardhat-ethers as this interfere with the typing extensions provided by hardhat-deploy-ethers

npm install --save-dev @nomicfoundation/hardhat-ethers ethers hardhat-deploy hardhat-deploy-ethers

Which means you then add the following statement to your hardhat.config.js:

require("@nomicfoundation/hardhat-ethers");
require("hardhat-deploy");
require("hardhat-deploy-ethers");

Or, if you are using TypeScript, add this to your hardhat.config.ts:

import '@nomicfoundation/hardhat-ethers';
import 'hardhat-deploy';
import 'hardhat-deploy-ethers';

Note that if you were using @nomicfoundation/hardhat-toolbox you can simply add the dependencies it added for you with

npm install --save-dev @nomicfoundation/hardhat-chai-matchers @nomicfoundation/hardhat-ethers @typechain/hardhat hardhat-gas-reporter solidity-coverage

and add them to your hardhat.config.js

require('@nomicfoundation/hardhat-chai-matchers');
require('@nomicfoundation/hardhat-ethers');
require('@typechain/hardhat');
require('hardhat-gas-reporter');
require('solidity-coverage');

or hardhat.config.ts (typescript)

import '@nomicfoundation/hardhat-chai-matchers';
import '@nomicfoundation/hardhat-ethers';
import '@typechain/hardhat';
import 'hardhat-gas-reporter';
import 'solidity-coverage';

Tasks

This plugin creates no additional tasks.

Environment extensions

This object has add some extra hardhat-deploy specific functionalities to the hre.ethers added already by @nomicfoundation/hardhat-ethers

Helpers

These helpers are added to the ethers object:

interface HardhatEthersHelpers {
  getContractAtWithSignerAddress: <ContractType extends ethers.BaseContract = ethers.BaseContract>(nameOrAbi: string | any[], address: string, signer: string) => Promise<ContractType>;
  getSignerOrNull: (address: string) => Promise<SignerWithAddress | null>;
  getNamedSigners: () => Promise<Record<string, SignerWithAddress>>;
  getNamedSigner: (name: string) => Promise<SignerWithAddress>;
  getNamedSignerOrNull: (name: string) => Promise<SignerWithAddress | null>;
  getUnnamedSigners: () => Promise<SignerWithAddress[]>;
  getContract: <ContractType extends ethers.BaseContract = ethers.BaseContract>(name: string, signer?: ethers.Signer | string) => Promise<ContractType>;
  getContractOrNull: <ContractType extends ethers.BaseContract = ethers.BaseContract>(name: string, signer?: ethers.Signer | string) => Promise<ContractType | null>;
}

Usage

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

It automatically integrate with the hardhat-deploy plugin if detected and let you do the following:

const contract = await hre.ethers.getContract('<deploymentName>');
@bojinovic/test-package@upshot-tech/upshot-contracts@sonicswap/contracts-devsolidity-examplesgeoracle@infinitebrahmanuniverse/nolb-hard@georacle/contractshumanwalletscw-contracts@bojinovic/filecoin-solidity@everything-registry/sub-chunk-1826@venusprotocol/governance-contracts@vporton/wrap-tokens@wallet3/account-abstractionaa-contracts@zerodao/common@zerodao/protocol@zerodao/token@aaiello/arkive-hardhat@aaiello/hardhat@accountjsxyz/contracts@connext/vector-contracts@dao-hub/contracts-v1@biconomy-devx/fallback-gastank@biconomy-devx/fallback-gastank-contracts@biconomy-devx/smart-account-contracts@biconomy-devx/wallet-contracts@biconomy-devx/account-contracts@biconomy/account-contracts@biconomy/fallback-gastank-contracts@biconomy/wallet-contracts@biconomy/smart-account-contractsbugscantea@candyboxdao/contracts-v1wesigvault-mantle-contractswrap-tokenstokenteasoulswap-hardhat-config@chanceprotocol/yield-source-interface@infini3/hardhat-ts@animoca/ethereum-migrations-core@animoca/ethereum-migrations-core_library@ansdomain/offchain-resolver-contracts@ensdomains/offchain-resolver-contracts@ensdomain/offchain-resolver-contracts@epoch-protocol/accountabstraction@etherspot/archanova-contracts-commondummy-npm-test-1dummy-npm-test-2dummy-npm-test-3dkg-evm-module@layerzerolabs/solidity-examplesfallback-gastank@jbx-protocol/contracts@lz-asia/stargate@normalfinance/contracts@moraswap/permit2@pooltogether/yield-source-interfacehumanaccount@sushiswap/hardhat-config@reserve-protocol/token-zapper@skyxexchange/permit2@recruiter.party/contracts@star2020/vector-contracts@test_art/mock_packagelayerzero-contractslayerzero-solidity-examples
0.4.1

9 months ago

0.4.0

9 months ago

0.4.0-next.0

1 year ago

0.4.0-next.1

1 year ago

0.3.0-beta.13

2 years ago

0.3.0-beta.12

2 years ago

0.3.0-beta.11

2 years ago

0.3.0-beta.8

3 years ago

0.3.0-beta.9

3 years ago

0.3.0-beta.10

3 years ago

0.3.0-beta.7

3 years ago

0.3.0-beta.6

3 years ago

0.3.0-beta.5

3 years ago

0.3.0-beta.4

3 years ago

0.3.0-beta.3

3 years ago