93 lines
3.2 KiB
Plaintext
93 lines
3.2 KiB
Plaintext
|
_title: Logger
|
||
|
|
|
||
|
|
_section: Logger @<logger>
|
||
|
|
|
||
|
|
_subsection: Errors @<logger-errors>
|
||
|
|
|
||
|
|
_property: Logger.errors.UNKNOWN_ERROR
|
||
|
|
A generic unknown error.
|
||
|
|
|
||
|
|
_property: Logger.errors.NOT_IMPLEMENTED
|
||
|
|
The operation is not implemented.
|
||
|
|
|
||
|
|
_property: Logger.errors.UNSUPPORTED_OPERATION
|
||
|
|
The operation is not supported.
|
||
|
|
|
||
|
|
_property: Logger.errors.NETWORK_ERROR
|
||
|
|
An Ethereum network validation error, such as an invalid chain ID.
|
||
|
|
|
||
|
|
_property: Logger.errors.SERVER_ERROR
|
||
|
|
There was an error communicating with a server.
|
||
|
|
|
||
|
|
_property: Logger.errors.TIMEOUT
|
||
|
|
A timeout occurred.
|
||
|
|
|
||
|
|
_property: Logger.errors.BUFFER_OVERRUN
|
||
|
|
The amount of data needed is more than the amount of data required,
|
||
|
|
which would cause the data buffer to read past its end.
|
||
|
|
|
||
|
|
_property: Logger.errors.NUMERIC_FAULT
|
||
|
|
There was an invalid operation done on numeric values.
|
||
|
|
|
||
|
|
Common cases of this occur when there is [[link-wiki-overflow]],
|
||
|
|
[[link-wiki-underflow]] in fixed numeric types or division by zero.
|
||
|
|
|
||
|
|
_property: Logger.errors.MISSING_NEW
|
||
|
|
An object is a Class, but is now being called with ``new``.
|
||
|
|
|
||
|
|
_property: Logger.errors.INVALID_ARGUMENT
|
||
|
|
The type or value of an argument is invalid. This will generally also
|
||
|
|
include the ``name`` and ``value`` of the argument. Any function which
|
||
|
|
accepts sensitive data (such as a private key) will include the string
|
||
|
|
``[REDACTED]]`` instead of the value passed in.
|
||
|
|
|
||
|
|
_property: Logger.errors.MISSING_ARGUMENT
|
||
|
|
An expected parameter was not specified.
|
||
|
|
|
||
|
|
_property: Logger.errors.UNEXPECTED_ARGUMENT
|
||
|
|
Too many parameters we passed into a function.
|
||
|
|
|
||
|
|
_property: Logger.errors.CALL_EXCEPTION
|
||
|
|
An attempt to call a blockchain contract (getter) resulted in a
|
||
|
|
revert or other error.
|
||
|
|
|
||
|
|
_property: Logger.errors.INSUFFICIENT_FUNDS
|
||
|
|
The account is attempting to make a transaction which costs more than is
|
||
|
|
available.
|
||
|
|
|
||
|
|
A sending account must have enough ether to pay for the value, the gas limit
|
||
|
|
(at the gas price) as well as the intrinsic cost of data. The intrinsic cost
|
||
|
|
of data is 4 gas for each zero byte and 68 gas for each non-zero byte.
|
||
|
|
|
||
|
|
_property: Logger.errors.NONCE_EXPIRED
|
||
|
|
The nonce being specified has already been used in a mined transaction.
|
||
|
|
|
||
|
|
_property: Logger.errors.REPLACEMENT_UNDERPRICED
|
||
|
|
When replacing a transaction, by using a nonce which has already been sent to
|
||
|
|
the network, but which has not been mined yet the new transaction must specify
|
||
|
|
a higher gas price.
|
||
|
|
|
||
|
|
This error occurs when the gas price is insufficient to //bribe// the transaction
|
||
|
|
pool to prefer the new transaction over the old one. Generally, the new gas price
|
||
|
|
should be about 50% + 1 wei more, so if a gas price of 10 gwei was used, the
|
||
|
|
replacement should be 15.000000001 gwei.
|
||
|
|
|
||
|
|
_property: Logger.errors.UNPREDICTABLE_GAS_LIMIT
|
||
|
|
When estimating the required amount of gas for a transaction, a node is queried for
|
||
|
|
its best guess.
|
||
|
|
|
||
|
|
If a node is unable (or unwilling) to predict the cost, this error occurs.
|
||
|
|
|
||
|
|
The best remedy for this situation is to specify a gas limit in the transaction
|
||
|
|
manually.
|
||
|
|
|
||
|
|
This error can also indicate that the transaction is expected to fail regardless,
|
||
|
|
if for example an account with no tokens is attempting to send a token.
|
||
|
|
|
||
|
|
|
||
|
|
_subsection: Creating instances
|
||
|
|
|
||
|
|
_property: new ethers.utils.Logger(version)
|
||
|
|
Create a new logger which will include //version// in all errors thrown.
|
||
|
|
|