node of the decentralized oracle network, bridging on and off-chain computation
length
and lessthan
tasks (pipeline).gasUnlimited
parameter to ethcall
task./keys
page in Operator UI now exposes several admin commands, namely:
GAS_ESTIMATOR_MODE
for Arbitrum to support Nitro's multi-dimensional gas model, with dynamic gas pricing and limits.
GAS_ESTIMATOR_MODE
as an env var if you have it set in order to use the new default.ETH_MAX_GAS_PRICE_WEI
, with 1000 gwei
default) as well as an estimated gas limit (up to ETH_GAS_LIMIT_MAX
, with 1,000,000,000
default).ETH_GAS_LIMIT_MAX
to put a maximum on the gas limit returned by the Arbitrum
estimator.hexencode
and base64encode
tasks (pipeline).forwardingAllowed
per job attribute to allow forwarding txs submitted by the job.Arbitrum
chains are no longer restricted to only FixedPrice
GAS_ESTIMATOR_MODE
Arbitrum Rinkeby & Mainnet
configurations for NitroArbitrum Goerli
configurationNODE_SELECTION_MODE
(EVM.NodePool.SelectionMode
) controls node picking strategy. Supported values: HighestHead
(default) and RoundRobin
:
RoundRobin
mode simply iterates among available alive nodes. This was the default behavior prior to this release.HighestHead
mode picks a node having the highest reported head number among other alive nodes. When several nodes have the same latest head number, the strategy sticks to the last used node.
For chains having NODE_NO_NEW_HEADS_THRESHOLD=0
(such as Arbitrum, Optimism), the implementation will fall back to RoundRobin
mode.keys eth chain
command
/v2/keys/evm/chain
.chainlink keys eth chain --address "0xEXAMPLE" --evmChainID 99 --setNextNonce 42
chainlink keys eth chain --address "0xEXAMPLE" --evmChainID 99 --enable
chainlink keys eth chain --address "0xEXAMPLE" --evmChainID 99 --disable
setnextnonce
local client command has been removed, and replaced by a more general key/chain client command.chainlink admin users update
command is replaced with chainlink admin users chrole
(only the role can be changed for a user)p2pv2Bootstrappers
has been added as a new optional property of OCR1 job specs; default may still be specified with P2PV2_BOOTSTRAPPERS config paramhexdecode
and base64decode
tasks (pipeline).admin
, edit
, run
, and view
.
chainlink admin users
. Be sure to run chainlink admin login
. For example, a readonly user can be created with: chainlink admin users create [email protected] --role=view
.gasLimit
overrides anything else when specified (e.g. ethtx
task has such a parameter).gasLimit
has the scope of the current job spec only.ETH_GAS_LIMIT_*_JOB_TYPE
affect any jobs of the corresponding type:ETH_GAS_LIMIT_OCR_JOB_TYPE # EVM.GasEstimator.LimitOCRJobType
ETH_GAS_LIMIT_DR_JOB_TYPE # EVM.GasEstimator.LimitDRJobType
ETH_GAS_LIMIT_VRF_JOB_TYPE # EVM.GasEstimator.LimitVRFJobType
ETH_GAS_LIMIT_FM_JOB_TYPE # EVM.GasEstimator.LimitFMJobType
ETH_GAS_LIMIT_KEEPER_JOB_TYPE # EVM.GasEstimator.LimitKeeperJobType
ETH_GAS_LIMIT_DEFAULT
(EVM.GasEstimator.LimitDefault
) value is the last resort.Must be longer than 12 characters
Must comprise at least 3 of:
lowercase characters
uppercase characters
numbers
symbols
Must not comprise:
More than three identical consecutive characters
Leading or trailing whitespace (note that a trailing newline in the password file, if present, will be ignored)
For backward compatibility all insecure passwords will continue to work, however in a future version of Chainlink insecure passwords will prevent application boot. To bypass this check at your own risk, you may set SKIP_DATABASE_PASSWORD_COMPLEXITY_CHECK=true
.
MIN_OUTGOING_CONFIRMATIONS
has been removed and no longer has any effect. EVM_FINALITY_DEPTH
is now used as the default for ethtx
confirmations instead. You may override this on a per-task basis by setting minConfirmations
in the task definition e.g. foo [type=ethtx minConfirmations=42 ...]
. NOTE: This may have a minor impact on performance on very high throughput chains. If you don't care about reporting task status in the UI, it is recommended to set minConfirmations=0
in your job specs. For more details, see the relevant section of the performance tuning guide.
The following ENV variables have been deprecated, and will be removed in a future release: INSECURE_SKIP_VERIFY
, CLIENT_NODE_URL
, ADMIN_CREDENTIALS_FILE
. These vars only applied to Chainlink when running in client mode and have been replaced by command line args, notably: --insecure-skip-verify
, --remote-node-url URL
and --admin-credentials-file FILE
respectively. More information can be found by running ./chainlink --help
.
The Optimism2
GAS_ESTIMATOR_MODE
has been renamed to L2Suggested
. The old name is still supported for now.
The p2pBootstrapPeers
property on OCR2 job specs has been renamed to p2pv2Bootstrappers
.
ETH_USE_FORWARDERS
config option to enable transactions forwarding contracts.$(jobRun.blockReceiptsRoot)
: the root of the receipts trie of the block (hash)$(jobRun.blockTransactionsRoot)
: the root of the transaction trie of the block (hash)$(jobRun.blockStateRoot)
: the root of the final state trie of the block (hash)ethtx
tasks can now be configured to error if the transaction reverts on-chain. You must set failOnRevert=true
on the task to enable this behavior, like so:foo [type=ethtx failOnRevert=true ...]
So the ethtx
task now works as follows:
If minConfirmations == 0, task always succeeds and nil is passed as output If minConfirmations > 0, the receipt is passed through as output If minConfirmations > 0 and failOnRevert=true then the ethtx task will error on revert
If minConfirmations
is not set on the task, the chain default will be used which is usually 12 and always greater than 0.
http
task now allows specification of request headers. Use like so: foo [type=http headers="[\\"X-Header-1\\", \\"value1\\", \\"X-Header-2\\", \\"value2\\"]"]
.max_unconfirmed_age
metric. Previously this would incorrectly report the max time since the last rebroadcast, capping the upper limit to the EthResender interval. This now reports the correct value of total time elapsed since the first broadcast.Optimism
OVM 1.0 GAS_ESTIMATOR_MODE
has been removed.Must be longer than 12 characters
Must comprise at least 3 of:
lowercase characters
uppercase characters
numbers
symbols
Must not comprise:
More than three identical consecutive characters
Leading or trailing whitespace
For backward compatibility all insecure passwords will continue to work, however in a future version of Chainlink insecure passwords will prevent application boot.
MIN_OUTGOING_CONFIRMATIONS
has been removed and no longer has any effect. EVM_FINALITY_DEPTH
is now used as the default for ethtx
confirmations instead. You may override this on a per-task basis by setting minConfirmations
in the task definition e.g. foo [type=ethtx minConfirmations=42 ...]
. NOTE: This may have a minor impact on performance on very high throughput chains. If you don't care about reporting task status in the UI, it is recommended to set minConfirmations=0
in your job specs. For more details, see the relevant section of the performance tuning guide.
The following ENV variables have been deprecated, and will be removed in a future release: INSECURE_SKIP_VERIFY
, CLIENT_NODE_URL
, ADMIN_CREDENTIALS_FILE
. These vars only applied to Chainlink when running in client mode and have been replaced by command line args, notably: --insecure-skip-verify
, --remote-node-url URL
and --admin-credentials-file FILE
respectively. More information can be found by running ./chainlink --help
.
The Optimism2
GAS_ESTIMATOR_MODE
has been renamed to L2Suggested
. The old name is still supported for now.
The p2pBootstrapPeers
property on OCR2 job specs has been renamed to p2pv2Bootstrappers
.
ETH_USE_FORWARDERS
config option to enable transactions forwarding contracts.$(jobRun.blockReceiptsRoot)
: the root of the receipts trie of the block (hash)$(jobRun.blockTransactionsRoot)
: the root of the transaction trie of the block (hash)$(jobRun.blockStateRoot)
: the root of the final state trie of the block (hash)ethtx
tasks can now be configured to error if the transaction reverts on-chain. You must set failOnRevert=true
on the task to enable this behavior, like so:foo [type=ethtx failOnRevert=true ...]
So the ethtx
task now works as follows:
If minConfirmations == 0, task always succeeds and nil is passed as output If minConfirmations > 0, the receipt is passed through as output If minConfirmations > 0 and failOnRevert=true then the ethtx task will error on revert
If minConfirmations
is not set on the task, the chain default will be used which is usually 12 and always greater than 0.
http
task now allows specification of request headers. Use like so: foo [type=http headers="[\\"X-Header-1\\", \\"value1\\", \\"X-Header-2\\", \\"value2\\"]"]
.max_unconfirmed_age
metric. Previously this would incorrectly report the max time since the last rebroadcast, capping the upper limit to the EthResender interval. This now reports the correct value of total time elapsed since the first broadcast.Optimism
OVM 1.0 GAS_ESTIMATOR_MODE
has been removed.