TypeScript icon, indicating that this package has built-in type declarations

0.1.0-pre.4 • Public • Published

hardhat CI Status


Allow loading network configs for Hardhat projects from external file.


This plugin allows you to specify a local configuration file to populate the Hardhat's networks config. This means users can keep critical information stored locally without risking it to the project's devs or users. For example, you can keep your providers keys or private keys in a secured directory without exposing them.


Install dependency from NPM:

npm install hardhat-local-networks-config-plugin hardhat

And add the following statement to your hardhat.config.js:


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

import 'hardhat-local-networks-config-plugin';

Required plugins

This plugin does not require any extra plugin.


This plugin creates no additional tasks.

Environment extensions

This plugin does not perform any environment extension.


This plugin extends the HardhatUserConfig object with an optional localNetworksConfig field.

This is an example of how to set it:

module.exports = {
  localNetworksConfig: '~/.hardhat/networks.ts'

In case a localNetworksConfig is not provided, the plugin will try to read it from ~/.hardhat/networks.json.

Note that both JS/TS and JSON formats are supported.


The local configuration file should support the following interface, any other field will be simply ignored:

export interface LocalNetworksConfig {
  networks?: NetworksUserConfig
  defaultConfig?: NetworkUserConfig

Where NetworksUserConfig and NetworkUserConfig are base types defined by Hardhat.

In case there is a conflict between any of the local network configs, the default one, or the ones defined in your project, the following list of priorities will be enforced:

  1. Local network specific configuration (localNetworksConfig).
  2. Project network specific configuration.
  3. Default local network configuration (~/.hardhat/networks.json).

A local configuration file could look as follows:

  "networks": {
    "rinkeby": {
      "gasMultiplier": 2,
      "accounts": ["0x12..56","0xab..cd"],
      "url": "https://rinkeby.infura.io/v3/<API_KEY>"
    "mainnet": {
      "accounts": ["0x12..56","0xab..cd"],
      "url": "https://mainnet.infura.io/v3/<API_KEY>"
  "defaultConfig": {
    "gasPrice": "auto"

Package Sidebar


npm i @keep-network/hardhat-local-networks-config

Weekly Downloads






Unpacked Size

21.2 kB

Total Files


Last publish


  • michalinacienciala
  • dimpar
  • lukasz-zimnoch
  • shadowfiend
  • nkuba8
  • thesis-heimdall
  • pdyraga