This section contains a list of all the possible errors you may encounter when using Buidler and an explanation of each of them.
You are trying to run Buidler outside of a Buidler project.
You can learn hoy to use Buidler by reading the Getting Started guide.
Buidler doesn't support your Node.js version.
Please upgrade your version of Node.js and try again.
You are tying to perform an unsupported operation.
Unless you are creating a task or plugin, this is probably a bug.
Please report it to help us improve Buidler.
Buidler initialization was executed twice. This is a bug.
Please report it to help us improve Buidler.
Buidler initialization failed. This is a bug.
Please report it to help us improve Buidler.
Buidler initialization failed. This is a bug.
Please report it to help us improve Buidler.
The Buidler initialization process was executed twice. This is a bug.
Please report it to help us improve Buidler.
You have one or more errors in your config file.
Check the error message for details, or go to documentation to learn more.
There was an error while loading your config file.
The most common source of errors is trying to import @nomiclabs/buidler
instead of @nomiclabs/buidler/config
.
Please make sure your config file is correct.
An attempt to modify the user's config was made.
This is probably a bug in one of your plugins.
Please report it to help us improve Buidler.
The Buidler initialization process was incomplete. This is a bug.
Please report it to help us improve Buidler.
You are trying to run Buidler with a non-existent network.
Read the documentation to learn how to define custom networks.
Your config specifies a chain id for the network you are trying to used, but Buidler detected anotherone.
Please make sure you are setting your config correctly.
Buidler sent the chainId
field in a transaction.
Please report it to help us improve Buidler.
data
param when calling eth_sign.You called eth_sign
with incorrect parameters.
Please check that you are sending a data
parameter.
You are trying to send a transaction or sign some data with an account not managed by your Ethereum node nor Buidler.
Please double check your accounts and the from
parameter in your RPC calls.
You are trying to send a transaction with a locally managed account, and some parameters are missing.
Please double check your transactions' parameters.
No local account was set and there are accounts in the remote node.
Please make sure that your Ethereum node has unlocked accounts.
An invalid HD/BIP32 derivation path was provided in your config.
Read the documentation to learn how to define HD accounts correctly.
One of your transactions sent or received an invalid JSON-RPC QUANTITY value.
Please double check your calls' parameters and keep your Ethereum node up to date.
Cannot connect to the network.
Please make sure your node is running, and check your internet connection and networks config.
One of your JSON-RPC requests timed-out.
Please make sure your node is running, and check your internet connection and networks config.
One of your JSON-RPC requests received an invalid response.
Please make sure your node is running, and check your internet connection and networks config.
One of your HD keys could not be derived.
Try using another mnemonic or deriving less keys.
Could add a positional param to your task because there is already a variadic positional param and it has to be the last positional one.
Please double check your task definitions.
Could not add a param to your task because its name is already used.
Please double check your task definitions.
Could not add a param to your task because its name is used as a param for Buidler.
Please double check your task definitions.
Could not add param to your task because it is required and it was added after an optional positional param.
Please double check your task definitions.
You can't change param definitions in an overridden task.
Please, double check your task definitions.
You can't add mandatory (non optional) param definitions in an overridden task. The only supported param additions for overridden tasks are flags, and optional params.
Please, double check your task definitions.
You can't add positional param definitions in an overridden task. The only supported param additions for overridden tasks are flags, and optional params.
Please, double check your task definitions.
You can't add variadic param definitions in an overridden task. The only supported param additions for overridden tasks are flags, and optional params.
Please, double check your task definitions.
A task was run, but it has no action set.
Please double check your task definitions.
runSuper
not availableYou tried to call runSuper
from a non-overridden task.
Please use runSuper.isDefined
to make sure that you can call it.
One of your tasks has a parameter whose default value doesn't match the expected type.
Please double check your task definitions.
One of your tasks has a required parameter with a default value.
Please double check your task definitions.
Your parameter names must use camelCase.
Please double check your task definitions.
You are setting one of Buidler arguments using an environment variable, but it has an incorrect value.
Please double check your environment variables.
One of your Buidler or task's arguments has an invalid type.
Please double check your arguments.
One of your tasks expected a file as an argument, but you provided a non-existent or non-readable file.
Please double check your arguments.
Tried to run a non-existent task.
Please double check the name of the task you are trying to run.
Buidler couldn't recognize one of your command line arguments.
This may be because you are writing it before the task name. It should come after it.
Please double check how you invoked Buidler.
Buidler couldn't recognize one of your tasks' parameters.
Please double check how you invoked Buidler or run your task.
You tried to run a task, but one of its required arguments was missing.
Please double check how you invoked Buidler or run your task.
You tried to run a task, but one of its required arguments was missing.
Please double check how you invoked Buidler or run your task.
You tried to run a task with more positional arguments than needed.
Please double check how you invoked Buidler or run your task.
You tried to run a task with a repeated parameter.
Please double check how you invoked Buidler or run your task.
You tried to run buidler with a parameter with invalid casing. They must be lowercase.
Please double check how you invoked Buidler.
You tried to run a task with an invalid JSON parameter.
Please double check how you invoked Buidler or run your task.
Tried to resolve a non-existing Solidity file as an entry-point.
One of your projects tried to import a file that it's outside your Buidler project.
This is disabled for security reasons.
One of your libraries' files was treated as a local file. This is a bug.
Please report it to help us improve Buidler.
One of your Solidity sources imports a library that is not installed.
Please double check your imports or install the missing dependency.
One of your libraries' files was imported but doesn't exist.
Please double check your imports or update your libraries.
One of your libraries tried to use a relative import to import a file outside of its scope.
This is disabled for security reasons.
One of your libraries tried to use a relative import to import a file outside of its scope.
This is disabled for security reasons.
One of your source files imported a non-existing one.
Please double check your imports.
solc
versionThe Solidity version in your config is invalid or hasn't been released yet.
Please double check your solc
config.
solc
download failedCouldn't download solc
.
Please check your Internet connection.
solc
version listCouldn't download solc
's version list.
Please check your Internet connection.
solc
checksum verification failedDownloaded solc
verification failed..
Please check your Internet connection.
Your smart contracts failed to compile.
Please check Buidler's output for more details.
Tried to use buidler run
to execut a non-existing script.
Please double check your script's path
Running a script resulted in an error.
Please check Buidler's output for more details.
Buidler flatten doesn't support cyclic dependencies.
We recommend not using this kind of dependencies.
There was error while starting the JSON-RPC HTTP server.
Handling an incoming JSON-RPC request resulted in an error.
JSON-RPC server can only be started when running the BuidlerEVM network.
To start the JSON-RPC server, retry the command without the --network parameter.
Tried to import a non-existing artifact.
Please double check that your contracts have been compiled and your artifact's name.
You are trying to use a plugin that hasn't been installed.
Please follow Buidler's instructions to resolve this.
You are trying to use a plugin with unmet dependencies.
Please follow Buidler's instructions to resolve this.
You are trying to use a plugin that requires a different version of one of its dependencies.
Please follow Buidler's instructions to resolve this.
require
You are trying to load a plugin with a call to require
.
Please use usePlugin(npm-plugin-package)
instead.
An error message template contains an invalid variable name. This is a bug.
Please report it to help us improve Buidler.
Tried to replace an error message variable with a value that contains another variable name. This is a bug.
Please report it to help us improve Buidler.
An error message template is missing a replacement value. This is a bug.
Please report it to help us improve Buidler.