2024-01-24 15:28:03 +00:00
|
|
|
# Copyright (c) 2018-2024 Status Research & Development GmbH
|
2018-04-27 08:53:53 +00:00
|
|
|
# Licensed under either of
|
|
|
|
# * Apache License, version 2.0, ([LICENSE-APACHE](LICENSE-APACHE))
|
|
|
|
# * MIT license ([LICENSE-MIT](LICENSE-MIT))
|
|
|
|
# at your option.
|
|
|
|
# This file may not be copied, modified, or distributed except according to
|
|
|
|
# those terms.
|
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
{.push raises: [].}
|
|
|
|
|
2018-10-16 00:10:01 +00:00
|
|
|
import
|
2022-07-19 08:15:18 +00:00
|
|
|
std/[
|
|
|
|
options,
|
|
|
|
strutils,
|
|
|
|
times,
|
|
|
|
os,
|
2024-01-24 15:28:03 +00:00
|
|
|
uri,
|
|
|
|
net
|
2022-07-19 08:15:18 +00:00
|
|
|
],
|
2021-09-11 14:58:01 +00:00
|
|
|
pkg/[
|
2021-09-16 15:59:46 +00:00
|
|
|
chronicles,
|
2021-09-11 14:58:01 +00:00
|
|
|
confutils,
|
|
|
|
confutils/defs,
|
|
|
|
stew/byteutils,
|
|
|
|
confutils/std/net
|
|
|
|
],
|
2024-01-26 22:04:08 +00:00
|
|
|
eth/[common, net/utils, net/nat, p2p/bootnodes, p2p/enode, p2p/discoveryv5/enr],
|
2022-12-22 04:17:04 +00:00
|
|
|
"."/[db/select_backend,
|
2022-03-27 11:21:15 +00:00
|
|
|
constants, vm_compile_info, version
|
2022-12-02 04:39:12 +00:00
|
|
|
],
|
|
|
|
common/chain_config
|
2018-04-27 08:53:53 +00:00
|
|
|
|
2024-01-24 15:28:03 +00:00
|
|
|
export net
|
2021-09-16 15:59:46 +00:00
|
|
|
|
2019-01-15 15:25:14 +00:00
|
|
|
const
|
2021-09-16 15:59:46 +00:00
|
|
|
# TODO: fix this agent-string format to match other
|
|
|
|
# eth clients format
|
2021-09-11 14:58:01 +00:00
|
|
|
NimbusIdent* = "$# v$# [$#: $#, $#, $#, $#]" % [
|
|
|
|
NimbusName,
|
|
|
|
NimbusVersion,
|
|
|
|
hostOS,
|
|
|
|
hostCPU,
|
|
|
|
nimbus_db_backend,
|
|
|
|
VmName,
|
|
|
|
GitRevision
|
|
|
|
]
|
2019-01-15 15:25:14 +00:00
|
|
|
|
2019-11-10 17:44:40 +00:00
|
|
|
let
|
2021-09-11 14:58:01 +00:00
|
|
|
# e.g.: Copyright (c) 2018-2021 Status Research & Development GmbH
|
|
|
|
NimbusCopyright* = "Copyright (c) 2018-" &
|
|
|
|
$(now().utc.year) &
|
|
|
|
" Status Research & Development GmbH"
|
|
|
|
|
|
|
|
# e.g.:
|
|
|
|
# Nimbus v0.1.0 [windows: amd64, rocksdb, evmc, dda8914f]
|
|
|
|
# Copyright (c) 2018-2021 Status Research & Development GmbH
|
|
|
|
NimbusBuild* = "$#\p$#" % [
|
|
|
|
NimbusIdent,
|
|
|
|
NimbusCopyright,
|
|
|
|
]
|
|
|
|
|
|
|
|
NimbusHeader* = "$#\p\p$#" % [
|
|
|
|
NimbusBuild,
|
2022-03-27 11:21:15 +00:00
|
|
|
version.NimVersion
|
2021-09-11 14:58:01 +00:00
|
|
|
]
|
|
|
|
|
|
|
|
proc defaultDataDir*(): string =
|
|
|
|
when defined(windows):
|
|
|
|
getHomeDir() / "AppData" / "Roaming" / "Nimbus"
|
|
|
|
elif defined(macosx):
|
|
|
|
getHomeDir() / "Library" / "Application Support" / "Nimbus"
|
|
|
|
else:
|
|
|
|
getHomeDir() / ".cache" / "nimbus"
|
|
|
|
|
|
|
|
proc defaultKeystoreDir*(): string =
|
|
|
|
defaultDataDir() / "keystore"
|
|
|
|
|
|
|
|
proc getLogLevels(): string =
|
|
|
|
var logLevels: seq[string]
|
|
|
|
for level in LogLevel:
|
|
|
|
if level < enabledLogLevel:
|
|
|
|
continue
|
|
|
|
logLevels.add($level)
|
|
|
|
join(logLevels, ", ")
|
|
|
|
|
|
|
|
const
|
|
|
|
defaultDataDirDesc = defaultDataDir()
|
|
|
|
defaultPort = 30303
|
|
|
|
defaultMetricsServerPort = 9093
|
|
|
|
defaultEthRpcPort = 8545
|
|
|
|
defaultEthWsPort = 8546
|
|
|
|
defaultEthGraphqlPort = 8547
|
2021-10-05 23:31:35 +00:00
|
|
|
defaultEngineApiPort = 8550
|
2022-01-24 13:08:33 +00:00
|
|
|
defaultEngineApiWsPort = 8551
|
2023-11-10 18:38:11 +00:00
|
|
|
defaultListenAddress = (static parseIpAddress("0.0.0.0"))
|
|
|
|
defaultAdminListenAddress = (static parseIpAddress("127.0.0.1"))
|
2021-09-16 15:59:46 +00:00
|
|
|
defaultListenAddressDesc = $defaultListenAddress & ", meaning all network interfaces"
|
|
|
|
defaultAdminListenAddressDesc = $defaultAdminListenAddress & ", meaning local host only"
|
2021-09-11 14:58:01 +00:00
|
|
|
logLevelDesc = getLogLevels()
|
2018-06-20 17:27:32 +00:00
|
|
|
|
2021-12-05 11:20:27 +00:00
|
|
|
# `when` around an option doesn't work with confutils; it fails to compile.
|
|
|
|
# Workaround that by setting the `ignore` pragma on EVMC-specific options.
|
|
|
|
when defined(evmc_enabled):
|
|
|
|
{.pragma: includeIfEvmc.}
|
|
|
|
else:
|
|
|
|
{.pragma: includeIfEvmc, ignore.}
|
|
|
|
|
|
|
|
const sharedLibText = if defined(linux): " (*.so, *.so.N)"
|
|
|
|
elif defined(windows): " (*.dll)"
|
|
|
|
elif defined(macosx): " (*.dylib)"
|
|
|
|
else: ""
|
|
|
|
|
2018-04-27 08:53:53 +00:00
|
|
|
type
|
2021-09-11 14:58:01 +00:00
|
|
|
PruneMode* {.pure.} = enum
|
|
|
|
Full
|
|
|
|
Archive
|
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
NimbusCmd* {.pure.} = enum
|
2021-09-11 14:58:01 +00:00
|
|
|
noCommand
|
2021-09-16 15:59:46 +00:00
|
|
|
`import`
|
2018-04-27 08:53:53 +00:00
|
|
|
|
2021-09-11 14:58:01 +00:00
|
|
|
ProtocolFlag* {.pure.} = enum
|
2019-04-23 13:49:49 +00:00
|
|
|
## Protocol flags
|
|
|
|
Eth ## enable eth subprotocol
|
2023-01-20 15:01:29 +00:00
|
|
|
Snap ## enable snap sub-protocol
|
2019-04-23 13:49:49 +00:00
|
|
|
Les ## enable les subprotocol
|
|
|
|
|
2021-09-11 14:58:01 +00:00
|
|
|
RpcFlag* {.pure.} = enum
|
|
|
|
## RPC flags
|
|
|
|
Eth ## enable eth_ set of RPC API
|
|
|
|
Debug ## enable debug_ set of RPC API
|
2024-01-22 09:11:37 +00:00
|
|
|
Exp ## enable exp_ set of RPC API
|
2018-04-27 08:53:53 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
DiscoveryType* {.pure.} = enum
|
|
|
|
None
|
|
|
|
V4
|
|
|
|
V5
|
2018-11-30 03:03:30 +00:00
|
|
|
|
2022-07-21 12:14:41 +00:00
|
|
|
SyncMode* {.pure.} = enum
|
|
|
|
Default
|
|
|
|
Full ## Beware, experimental
|
|
|
|
Snap ## Beware, experimental
|
2023-03-13 18:18:30 +00:00
|
|
|
Stateless ## Beware, experimental
|
2022-07-21 12:14:41 +00:00
|
|
|
|
2021-09-11 14:58:01 +00:00
|
|
|
NimbusConf* = object of RootObj
|
2018-04-27 08:53:53 +00:00
|
|
|
## Main Nimbus configuration object
|
2020-01-13 18:35:40 +00:00
|
|
|
|
2021-09-11 14:58:01 +00:00
|
|
|
dataDir* {.
|
|
|
|
separator: "ETHEREUM OPTIONS:"
|
|
|
|
desc: "The directory where nimbus will store all blockchain data"
|
|
|
|
defaultValue: defaultDataDir()
|
|
|
|
defaultValueDesc: $defaultDataDirDesc
|
|
|
|
abbr: "d"
|
|
|
|
name: "data-dir" }: OutDir
|
|
|
|
|
|
|
|
keyStore* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
desc: "Load one or more keystore files from this directory"
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValue: defaultKeystoreDir()
|
|
|
|
defaultValueDesc: "inside datadir"
|
|
|
|
abbr: "k"
|
|
|
|
name: "key-store" }: OutDir
|
|
|
|
|
|
|
|
pruneMode* {.
|
|
|
|
desc: "Blockchain prune mode (Full or Archive)"
|
|
|
|
defaultValue: PruneMode.Full
|
|
|
|
defaultValueDesc: $PruneMode.Full
|
|
|
|
abbr : "p"
|
|
|
|
name: "prune-mode" }: PruneMode
|
|
|
|
|
2022-07-21 12:14:41 +00:00
|
|
|
syncMode* {.
|
|
|
|
desc: "Specify particular blockchain sync mode."
|
|
|
|
longDesc:
|
2023-03-13 18:18:30 +00:00
|
|
|
"- default -- legacy sync mode\n" &
|
|
|
|
"- full -- full blockchain archive\n" &
|
|
|
|
"- snap -- experimental snap mode (development only)\n" &
|
|
|
|
"- stateless -- experimental stateless mode (development only)"
|
2022-07-21 12:14:41 +00:00
|
|
|
defaultValue: SyncMode.Default
|
|
|
|
defaultValueDesc: $SyncMode.Default
|
|
|
|
abbr: "y"
|
|
|
|
name: "sync-mode" .}: SyncMode
|
2022-05-13 16:30:10 +00:00
|
|
|
|
2023-03-02 09:57:58 +00:00
|
|
|
syncCtrlFile* {.
|
2023-03-07 14:23:22 +00:00
|
|
|
desc: "Specify a file that is regularly checked for updates. If it " &
|
|
|
|
"exists it is checked for whether it contains extra information " &
|
|
|
|
"specific to the type of sync process. This option is primarily " &
|
|
|
|
"intended only for sync testing and debugging."
|
2023-03-02 09:57:58 +00:00
|
|
|
abbr: "z"
|
|
|
|
name: "sync-ctrl-file" }: Option[string]
|
|
|
|
|
2021-09-11 14:58:01 +00:00
|
|
|
importKey* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
desc: "Import unencrypted 32 bytes hex private key from a file"
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValue: ""
|
|
|
|
abbr: "e"
|
|
|
|
name: "import-key" }: InputFile
|
|
|
|
|
|
|
|
engineSigner* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
desc: "Set the signer address(as 20 bytes hex) and enable sealing engine to run and " &
|
|
|
|
"producing blocks at specified interval (only PoA/Clique supported)"
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValue: ZERO_ADDRESS
|
|
|
|
defaultValueDesc: ""
|
|
|
|
abbr: "s"
|
|
|
|
name: "engine-signer" }: EthAddress
|
|
|
|
|
|
|
|
verifyFrom* {.
|
|
|
|
desc: "Enable extra verification when current block number greater than verify-from"
|
|
|
|
defaultValueDesc: ""
|
|
|
|
name: "verify-from" }: Option[uint64]
|
|
|
|
|
EVMC: Option `--evm`, load third-party EVM as a shared library
This patch adds:
- Load and use a third-party EVM in a shared library, instead of Nimbus EVM.
- New option `--evm` to specify which library to load.
- The library and this loader conforms to the [EVMC]
(https://evmc.ethereum.org/) 9.x specification.
Any third-party EVM which is compatible with EVMC version 9.x and supports EVM1
contract code will be accepted. The operating system's shared library format
applies. These are `.so*` files on Linux, `.dll` files on Windows and `.dylib`
files on Mac.
The alternative EVM can be selected in two ways:
- Nimbus command line option `--evm:<path>`.
- Environment variable `NIMBUS_EVM=<path>`.
The reason for an environment variable is this allows all the test programs to
run with a third-party EVM as well. Some don't parse command line options.
There are some limitations to be aware of:
- The third-party EVM must use EVMC version 9.x, no other major version.
EVMC 9.x supports EIP-1559 / London fork and older transactions.
- Nested `*CALL` and `CREATE*` operations don't use the third-party EVM yet.
These call the built-in Nimbus EVM. This mixing of different EVMs between
levels is explicitly allowed in specs, so there is no problem doing it.
- The third-party EVM doesn't need to support precompiles, because those are
nested calls, which use the built-in Nimbus EVM.
- Third-party EVMs execute contracts correctly, but fail the final `rootHash`
match. The reason is that some account state changes, which are correct, are
currently inside the Nimbus EVM and need to be moved to EVMC host logic.
*This is a known work in progress*. The EVM execution itself is fine.
Test results using "evmone" third-party EVM:
- [evmone](https://github.com/ethereum/evmone) has been tested. Only on
Linux but it "should" work on Windows and Mac equally well.
- [Version 0.8.1](https://github.com/ethereum/evmone/releases/tag/v0.8.1) was
used because it is compatible with EVMC 9.x, which is required for the
EIP-1559 / London fork, which Nimbus supports. Version 0.8.0 could be used
but it looks like an important bug was fixed in 0.8.1.
- evmone runs fine and the trace output looks good. The calls and arguments
are the same as the built-in Nimbus EVM for tests that have been checked
manually, except evmone skips some calls that can be safely skipped.
- The final `rootHash` is incorrect, due to the *work in progress* mentioned
above which is not part of the evmone execution. Due to this, it's possible
to try evmone and verify expected behaviours, which also validates our own
EVMC implementation, but it can't be used as a full substitute yet.
Signed-off-by: Jamie Lokier <jamie@shareable.org>
2021-12-05 11:20:27 +00:00
|
|
|
evm* {.
|
2021-12-05 11:20:27 +00:00
|
|
|
desc: "Load alternative EVM from EVMC-compatible shared library" & sharedLibText
|
EVMC: Option `--evm`, load third-party EVM as a shared library
This patch adds:
- Load and use a third-party EVM in a shared library, instead of Nimbus EVM.
- New option `--evm` to specify which library to load.
- The library and this loader conforms to the [EVMC]
(https://evmc.ethereum.org/) 9.x specification.
Any third-party EVM which is compatible with EVMC version 9.x and supports EVM1
contract code will be accepted. The operating system's shared library format
applies. These are `.so*` files on Linux, `.dll` files on Windows and `.dylib`
files on Mac.
The alternative EVM can be selected in two ways:
- Nimbus command line option `--evm:<path>`.
- Environment variable `NIMBUS_EVM=<path>`.
The reason for an environment variable is this allows all the test programs to
run with a third-party EVM as well. Some don't parse command line options.
There are some limitations to be aware of:
- The third-party EVM must use EVMC version 9.x, no other major version.
EVMC 9.x supports EIP-1559 / London fork and older transactions.
- Nested `*CALL` and `CREATE*` operations don't use the third-party EVM yet.
These call the built-in Nimbus EVM. This mixing of different EVMs between
levels is explicitly allowed in specs, so there is no problem doing it.
- The third-party EVM doesn't need to support precompiles, because those are
nested calls, which use the built-in Nimbus EVM.
- Third-party EVMs execute contracts correctly, but fail the final `rootHash`
match. The reason is that some account state changes, which are correct, are
currently inside the Nimbus EVM and need to be moved to EVMC host logic.
*This is a known work in progress*. The EVM execution itself is fine.
Test results using "evmone" third-party EVM:
- [evmone](https://github.com/ethereum/evmone) has been tested. Only on
Linux but it "should" work on Windows and Mac equally well.
- [Version 0.8.1](https://github.com/ethereum/evmone/releases/tag/v0.8.1) was
used because it is compatible with EVMC 9.x, which is required for the
EIP-1559 / London fork, which Nimbus supports. Version 0.8.0 could be used
but it looks like an important bug was fixed in 0.8.1.
- evmone runs fine and the trace output looks good. The calls and arguments
are the same as the built-in Nimbus EVM for tests that have been checked
manually, except evmone skips some calls that can be safely skipped.
- The final `rootHash` is incorrect, due to the *work in progress* mentioned
above which is not part of the evmone execution. Due to this, it's possible
to try evmone and verify expected behaviours, which also validates our own
EVMC implementation, but it can't be used as a full substitute yet.
Signed-off-by: Jamie Lokier <jamie@shareable.org>
2021-12-05 11:20:27 +00:00
|
|
|
defaultValue: ""
|
2021-12-05 11:20:27 +00:00
|
|
|
name: "evm"
|
|
|
|
includeIfEvmc }: string
|
EVMC: Option `--evm`, load third-party EVM as a shared library
This patch adds:
- Load and use a third-party EVM in a shared library, instead of Nimbus EVM.
- New option `--evm` to specify which library to load.
- The library and this loader conforms to the [EVMC]
(https://evmc.ethereum.org/) 9.x specification.
Any third-party EVM which is compatible with EVMC version 9.x and supports EVM1
contract code will be accepted. The operating system's shared library format
applies. These are `.so*` files on Linux, `.dll` files on Windows and `.dylib`
files on Mac.
The alternative EVM can be selected in two ways:
- Nimbus command line option `--evm:<path>`.
- Environment variable `NIMBUS_EVM=<path>`.
The reason for an environment variable is this allows all the test programs to
run with a third-party EVM as well. Some don't parse command line options.
There are some limitations to be aware of:
- The third-party EVM must use EVMC version 9.x, no other major version.
EVMC 9.x supports EIP-1559 / London fork and older transactions.
- Nested `*CALL` and `CREATE*` operations don't use the third-party EVM yet.
These call the built-in Nimbus EVM. This mixing of different EVMs between
levels is explicitly allowed in specs, so there is no problem doing it.
- The third-party EVM doesn't need to support precompiles, because those are
nested calls, which use the built-in Nimbus EVM.
- Third-party EVMs execute contracts correctly, but fail the final `rootHash`
match. The reason is that some account state changes, which are correct, are
currently inside the Nimbus EVM and need to be moved to EVMC host logic.
*This is a known work in progress*. The EVM execution itself is fine.
Test results using "evmone" third-party EVM:
- [evmone](https://github.com/ethereum/evmone) has been tested. Only on
Linux but it "should" work on Windows and Mac equally well.
- [Version 0.8.1](https://github.com/ethereum/evmone/releases/tag/v0.8.1) was
used because it is compatible with EVMC 9.x, which is required for the
EIP-1559 / London fork, which Nimbus supports. Version 0.8.0 could be used
but it looks like an important bug was fixed in 0.8.1.
- evmone runs fine and the trace output looks good. The calls and arguments
are the same as the built-in Nimbus EVM for tests that have been checked
manually, except evmone skips some calls that can be safely skipped.
- The final `rootHash` is incorrect, due to the *work in progress* mentioned
above which is not part of the evmone execution. Due to this, it's possible
to try evmone and verify expected behaviours, which also validates our own
EVMC implementation, but it can't be used as a full substitute yet.
Signed-off-by: Jamie Lokier <jamie@shareable.org>
2021-12-05 11:20:27 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
network {.
|
|
|
|
separator: "\pETHEREUM NETWORK OPTIONS:"
|
2023-10-25 06:27:55 +00:00
|
|
|
desc: "Name or id number of Ethereum network(mainnet(1), goerli(5), sepolia(11155111), holesky(17000), other=custom)"
|
2021-12-12 09:45:58 +00:00
|
|
|
longDesc:
|
2021-09-16 15:59:46 +00:00
|
|
|
"- mainnet: Ethereum main network\n" &
|
2022-07-01 20:16:26 +00:00
|
|
|
"- goerli: Test network (proof-of-authority, works across all clients)\n" &
|
2023-10-25 06:27:55 +00:00
|
|
|
"- sepolia: Test network (proof-of-work)\n" &
|
|
|
|
"- holesky: The holesovice post-merge testnet"
|
2021-09-16 15:59:46 +00:00
|
|
|
defaultValue: "" # the default value is set in makeConfig
|
|
|
|
defaultValueDesc: "mainnet(1)"
|
|
|
|
abbr: "i"
|
|
|
|
name: "network" }: string
|
|
|
|
|
|
|
|
customNetwork {.
|
|
|
|
desc: "Use custom genesis block for private Ethereum Network (as /path/to/genesis.json)"
|
|
|
|
defaultValueDesc: ""
|
|
|
|
abbr: "c"
|
|
|
|
name: "custom-network" }: Option[NetworkParams]
|
|
|
|
|
|
|
|
networkId* {.
|
2021-12-12 09:45:58 +00:00
|
|
|
ignore # this field is not processed by confutils
|
|
|
|
defaultValue: MainNet # the defaultValue value is set by `makeConfig`
|
2021-09-16 15:59:46 +00:00
|
|
|
name: "network-id"}: NetworkId
|
|
|
|
|
|
|
|
networkParams* {.
|
2021-12-12 09:45:58 +00:00
|
|
|
ignore # this field is not processed by confutils
|
|
|
|
defaultValue: NetworkParams() # the defaultValue value is set by `makeConfig`
|
2021-09-16 15:59:46 +00:00
|
|
|
name: "network-params"}: NetworkParams
|
|
|
|
|
|
|
|
logLevel* {.
|
|
|
|
separator: "\pLOGGING AND DEBUGGING OPTIONS:"
|
|
|
|
desc: "Sets the log level for process and topics (" & logLevelDesc & ")"
|
|
|
|
defaultValue: LogLevel.INFO
|
|
|
|
defaultValueDesc: $LogLevel.INFO
|
|
|
|
name: "log-level" }: LogLevel
|
|
|
|
|
|
|
|
logFile* {.
|
|
|
|
desc: "Specifies a path for the written Json log file"
|
|
|
|
name: "log-file" }: Option[OutFile]
|
|
|
|
|
|
|
|
logMetricsEnabled* {.
|
|
|
|
desc: "Enable metrics logging"
|
|
|
|
defaultValue: false
|
|
|
|
name: "log-metrics" .}: bool
|
|
|
|
|
|
|
|
logMetricsInterval* {.
|
|
|
|
desc: "Interval at which to log metrics, in seconds"
|
|
|
|
defaultValue: 10
|
|
|
|
name: "log-metrics-interval" .}: int
|
|
|
|
|
|
|
|
bootstrapNodes {.
|
|
|
|
separator: "\pNETWORKING OPTIONS:"
|
|
|
|
desc: "Specifies one or more bootstrap nodes(as enode URL) to use when connecting to the network"
|
|
|
|
defaultValue: @[]
|
|
|
|
defaultValueDesc: ""
|
|
|
|
abbr: "b"
|
|
|
|
name: "bootstrap-node" }: seq[string]
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
bootstrapFile {.
|
|
|
|
desc: "Specifies a line-delimited file of bootstrap Ethereum network addresses(enode URL). " &
|
|
|
|
"By default, addresses will be added to bootstrap node list. " &
|
|
|
|
"But if the first line equals to `override` word, it will override built-in list"
|
|
|
|
defaultValue: ""
|
|
|
|
name: "bootstrap-file" }: InputFile
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2023-07-07 07:47:26 +00:00
|
|
|
bootstrapEnrs {.
|
|
|
|
desc: "ENR URI of node to bootstrap discovery from. Argument may be repeated"
|
|
|
|
defaultValue: @[]
|
|
|
|
defaultValueDesc: ""
|
|
|
|
name: "bootstrap-enr" }: seq[enr.Record]
|
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
staticPeers {.
|
|
|
|
desc: "Connect to one or more trusted peers(as enode URL)"
|
|
|
|
defaultValue: @[]
|
|
|
|
defaultValueDesc: ""
|
|
|
|
name: "static-peers" }: seq[string]
|
|
|
|
|
2022-02-11 16:28:39 +00:00
|
|
|
staticPeersFile {.
|
|
|
|
desc: "Specifies a line-delimited file of trusted peers addresses(enode URL)" &
|
2023-10-31 10:53:06 +00:00
|
|
|
"to be added to the --static-peers list. If the first line equals to the word `override`, "&
|
|
|
|
"the file contents will replace the --static-peers list"
|
2022-02-11 16:28:39 +00:00
|
|
|
defaultValue: ""
|
|
|
|
name: "static-peers-file" }: InputFile
|
|
|
|
|
2023-07-07 07:47:26 +00:00
|
|
|
staticPeersEnrs {.
|
|
|
|
desc: "ENR URI of node to connect to as trusted peer. Argument may be repeated"
|
|
|
|
defaultValue: @[]
|
|
|
|
defaultValueDesc: ""
|
|
|
|
name: "static-peer-enr" }: seq[enr.Record]
|
|
|
|
|
2022-08-26 09:36:04 +00:00
|
|
|
reconnectMaxRetry* {.
|
|
|
|
desc: "Specifies max number of retries if static peers disconnected/not connected. " &
|
|
|
|
"0 = infinite."
|
|
|
|
defaultValue: 0
|
|
|
|
name: "reconnect-max-retry" }: int
|
|
|
|
|
|
|
|
reconnectInterval* {.
|
|
|
|
desc: "Interval in seconds before next attempt to reconnect to static peers. Min 5 seconds."
|
|
|
|
defaultValue: 15
|
|
|
|
name: "reconnect-interval" }: int
|
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
listenAddress* {.
|
|
|
|
desc: "Listening IP address for Ethereum P2P and Discovery traffic"
|
|
|
|
defaultValue: defaultListenAddress
|
|
|
|
defaultValueDesc: $defaultListenAddressDesc
|
2023-11-10 18:38:11 +00:00
|
|
|
name: "listen-address" }: IpAddress
|
2021-09-16 15:59:46 +00:00
|
|
|
|
|
|
|
tcpPort* {.
|
|
|
|
desc: "Ethereum P2P network listening TCP port"
|
|
|
|
defaultValue: defaultPort
|
|
|
|
defaultValueDesc: $defaultPort
|
|
|
|
name: "tcp-port" }: Port
|
|
|
|
|
|
|
|
udpPort* {.
|
|
|
|
desc: "Ethereum P2P network listening UDP port"
|
|
|
|
defaultValue: 0 # set udpPort defaultValue in `makeConfig`
|
|
|
|
defaultValueDesc: "default to --tcp-port"
|
|
|
|
name: "udp-port" }: Port
|
|
|
|
|
|
|
|
maxPeers* {.
|
|
|
|
desc: "Maximum number of peers to connect to"
|
|
|
|
defaultValue: 25
|
|
|
|
name: "max-peers" }: int
|
|
|
|
|
|
|
|
nat* {.
|
|
|
|
desc: "Specify method to use for determining public address. " &
|
|
|
|
"Must be one of: any, none, upnp, pmp, extip:<IP>"
|
|
|
|
defaultValue: NatConfig(hasExtIp: false, nat: NatAny)
|
|
|
|
defaultValueDesc: "any"
|
|
|
|
name: "nat" .}: NatConfig
|
|
|
|
|
|
|
|
discovery* {.
|
|
|
|
desc: "Specify method to find suitable peer in an Ethereum network (None, V4, V5)"
|
2021-12-12 09:45:58 +00:00
|
|
|
longDesc:
|
2021-09-16 15:59:46 +00:00
|
|
|
"- None: Disables the peer discovery mechanism (manual peer addition)\n" &
|
|
|
|
"- V4 : Node Discovery Protocol v4(default)\n" &
|
2021-12-12 09:45:58 +00:00
|
|
|
"- V5 : Node Discovery Protocol v5"
|
2021-09-16 15:59:46 +00:00
|
|
|
defaultValue: DiscoveryType.V4
|
|
|
|
defaultValueDesc: $DiscoveryType.V4
|
|
|
|
name: "discovery" .}: DiscoveryType
|
|
|
|
|
2022-07-27 16:07:54 +00:00
|
|
|
netKey* {.
|
|
|
|
desc: "P2P ethereum node (secp256k1) private key (random, path, hex)"
|
|
|
|
longDesc:
|
|
|
|
"- random: generate random network key for this node instance\n" &
|
|
|
|
"- path : path to where the private key will be loaded or auto generated\n" &
|
|
|
|
"- hex : 32 bytes hex of network private key"
|
|
|
|
defaultValue: "random"
|
|
|
|
name: "net-key" .}: string
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
agentString* {.
|
|
|
|
desc: "Node agent string which is used as identifier in network"
|
|
|
|
defaultValue: NimbusIdent
|
|
|
|
defaultValueDesc: $NimbusIdent
|
|
|
|
name: "agent-string" .}: string
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
protocols {.
|
2023-01-20 15:01:29 +00:00
|
|
|
desc: "Enable specific set of server protocols (available: Eth, " &
|
|
|
|
" Snap, Les, None.) This will not affect the sync mode"
|
2021-09-16 15:59:46 +00:00
|
|
|
defaultValue: @[]
|
|
|
|
defaultValueDesc: $ProtocolFlag.Eth
|
|
|
|
name: "protocols" .}: seq[string]
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
case cmd* {.
|
|
|
|
command
|
|
|
|
defaultValue: NimbusCmd.noCommand }: NimbusCmd
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
of noCommand:
|
2021-09-11 14:58:01 +00:00
|
|
|
rpcEnabled* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
separator: "\pLOCAL SERVICE OPTIONS:"
|
2021-09-11 14:58:01 +00:00
|
|
|
desc: "Enable the JSON-RPC server"
|
|
|
|
defaultValue: false
|
|
|
|
name: "rpc" }: bool
|
|
|
|
|
|
|
|
rpcPort* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
desc: "Listening port of the JSON-RPC server"
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValue: defaultEthRpcPort
|
|
|
|
defaultValueDesc: $defaultEthRpcPort
|
|
|
|
name: "rpc-port" }: Port
|
|
|
|
|
|
|
|
rpcAddress* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
desc: "Listening IP address of the JSON-RPC server"
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValue: defaultAdminListenAddress
|
|
|
|
defaultValueDesc: $defaultAdminListenAddressDesc
|
2023-11-10 18:38:11 +00:00
|
|
|
name: "rpc-address" }: IpAddress
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
rpcApi {.
|
|
|
|
desc: "Enable specific set of RPC API (available: eth, debug)"
|
|
|
|
defaultValue: @[]
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValueDesc: $RpcFlag.Eth
|
2021-09-16 15:59:46 +00:00
|
|
|
name: "rpc-api" }: seq[string]
|
2021-09-11 14:58:01 +00:00
|
|
|
|
|
|
|
wsEnabled* {.
|
|
|
|
desc: "Enable the Websocket JSON-RPC server"
|
|
|
|
defaultValue: false
|
|
|
|
name: "ws" }: bool
|
|
|
|
|
|
|
|
wsPort* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
desc: "Listening port of the Websocket JSON-RPC server"
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValue: defaultEthWsPort
|
|
|
|
defaultValueDesc: $defaultEthWsPort
|
|
|
|
name: "ws-port" }: Port
|
|
|
|
|
|
|
|
wsAddress* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
desc: "Listening IP address of the Websocket JSON-RPC server"
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValue: defaultAdminListenAddress
|
|
|
|
defaultValueDesc: $defaultAdminListenAddressDesc
|
2023-11-10 18:38:11 +00:00
|
|
|
name: "ws-address" }: IpAddress
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
wsApi {.
|
|
|
|
desc: "Enable specific set of Websocket RPC API (available: eth, debug)"
|
|
|
|
defaultValue: @[]
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValueDesc: $RpcFlag.Eth
|
2021-09-16 15:59:46 +00:00
|
|
|
name: "ws-api" }: seq[string]
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2022-07-19 08:15:18 +00:00
|
|
|
engineApiEnabled* {.
|
|
|
|
desc: "Enable the Engine API"
|
|
|
|
defaultValue: false
|
|
|
|
name: "engine-api" .}: bool
|
|
|
|
|
|
|
|
engineApiPort* {.
|
|
|
|
desc: "Listening port for the Engine API"
|
|
|
|
defaultValue: defaultEngineApiPort
|
|
|
|
defaultValueDesc: $defaultEngineApiPort
|
|
|
|
name: "engine-api-port" .}: Port
|
|
|
|
|
|
|
|
engineApiAddress* {.
|
|
|
|
desc: "Listening address for the Engine API"
|
|
|
|
defaultValue: defaultAdminListenAddress
|
|
|
|
defaultValueDesc: $defaultAdminListenAddressDesc
|
2023-11-10 18:38:11 +00:00
|
|
|
name: "engine-api-address" .}: IpAddress
|
2022-07-19 08:15:18 +00:00
|
|
|
|
|
|
|
engineApiWsEnabled* {.
|
|
|
|
desc: "Enable the WebSocket Engine API"
|
|
|
|
defaultValue: false
|
|
|
|
name: "engine-api-ws" .}: bool
|
|
|
|
|
|
|
|
engineApiWsPort* {.
|
|
|
|
desc: "Listening port for the WebSocket Engine API"
|
|
|
|
defaultValue: defaultEngineApiWsPort
|
|
|
|
defaultValueDesc: $defaultEngineApiWsPort
|
|
|
|
name: "engine-api-ws-port" .}: Port
|
|
|
|
|
|
|
|
engineApiWsAddress* {.
|
|
|
|
desc: "Listening address for the WebSocket Engine API"
|
|
|
|
defaultValue: defaultAdminListenAddress
|
|
|
|
defaultValueDesc: $defaultAdminListenAddressDesc
|
2023-11-10 18:38:11 +00:00
|
|
|
name: "engine-api-ws-address" .}: IpAddress
|
2022-07-19 08:15:18 +00:00
|
|
|
|
|
|
|
terminalTotalDifficulty* {.
|
|
|
|
desc: "The terminal total difficulty of the eth2 merge transition block." &
|
|
|
|
" It takes precedence over terminalTotalDifficulty in config file."
|
|
|
|
name: "terminal-total-difficulty" .}: Option[UInt256]
|
|
|
|
|
|
|
|
allowedOrigins* {.
|
|
|
|
desc: "Comma separated list of domains from which to accept cross origin requests"
|
|
|
|
defaultValue: @[]
|
|
|
|
defaultValueDesc: "*"
|
|
|
|
name: "allowed-origins" .}: seq[string]
|
|
|
|
|
2022-04-06 14:11:13 +00:00
|
|
|
# github.com/ethereum/execution-apis/
|
|
|
|
# /blob/v1.0.0-alpha.8/src/engine/authentication.md#key-distribution
|
|
|
|
jwtSecret* {.
|
|
|
|
desc: "Path to a file containing a 32 byte hex-encoded shared secret" &
|
|
|
|
" needed for websocket authentication. By default, the secret key" &
|
|
|
|
" is auto-generated."
|
|
|
|
defaultValueDesc: "\"jwt.hex\" in the data directory (see --data-dir)"
|
|
|
|
name: "jwt-secret" .}: Option[InputFile]
|
|
|
|
|
2021-09-11 14:58:01 +00:00
|
|
|
graphqlEnabled* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
desc: "Enable the GraphQL HTTP server"
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValue: false
|
|
|
|
name: "graphql" }: bool
|
|
|
|
|
|
|
|
graphqlPort* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
desc: "Listening port of the GraphQL HTTP server"
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValue: defaultEthGraphqlPort
|
|
|
|
defaultValueDesc: $defaultEthGraphqlPort
|
|
|
|
name: "graphql-port" }: Port
|
|
|
|
|
|
|
|
graphqlAddress* {.
|
2021-09-16 15:59:46 +00:00
|
|
|
desc: "Listening IP address of the GraphQL HTTP server"
|
2021-09-11 14:58:01 +00:00
|
|
|
defaultValue: defaultAdminListenAddress
|
|
|
|
defaultValueDesc: $defaultAdminListenAddressDesc
|
2023-11-10 18:38:11 +00:00
|
|
|
name: "graphql-address" }: IpAddress
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
metricsEnabled* {.
|
|
|
|
desc: "Enable the built-in metrics HTTP server"
|
|
|
|
defaultValue: false
|
|
|
|
name: "metrics" }: bool
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
metricsPort* {.
|
|
|
|
desc: "Listening port of the built-in metrics HTTP server"
|
|
|
|
defaultValue: defaultMetricsServerPort
|
|
|
|
defaultValueDesc: $defaultMetricsServerPort
|
|
|
|
name: "metrics-port" }: Port
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
metricsAddress* {.
|
|
|
|
desc: "Listening IP address of the built-in metrics HTTP server"
|
|
|
|
defaultValue: defaultAdminListenAddress
|
|
|
|
defaultValueDesc: $defaultAdminListenAddressDesc
|
2023-11-10 18:38:11 +00:00
|
|
|
name: "metrics-address" }: IpAddress
|
2023-06-04 06:00:50 +00:00
|
|
|
|
2023-04-12 12:39:11 +00:00
|
|
|
statelessModeDataSourceUrl* {.
|
|
|
|
desc: "URL of the node to use as a data source for on-demand data fetching via the JSON-RPC API"
|
|
|
|
defaultValue: ""
|
|
|
|
name: "stateless-data-source-url" .}: string
|
2021-09-16 15:59:46 +00:00
|
|
|
|
2023-10-01 14:00:32 +00:00
|
|
|
trustedSetupFile* {.
|
|
|
|
desc: "Load EIP-4844 trusted setup file"
|
|
|
|
defaultValue: none(string)
|
|
|
|
defaultValueDesc: "Baked in trusted setup"
|
|
|
|
name: "trusted-setup-file" .}: Option[string]
|
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
of `import`:
|
|
|
|
|
|
|
|
blocksFile* {.
|
|
|
|
argument
|
|
|
|
desc: "Import RLP encoded block(s) from a file, validate, write to database and quit"
|
|
|
|
defaultValue: ""
|
|
|
|
name: "blocks-file" }: InputFile
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
proc parseCmdArg(T: type NetworkId, p: string): T
|
|
|
|
{.gcsafe, raises: [ValueError].} =
|
2023-01-31 12:38:08 +00:00
|
|
|
parseInt(p).T
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2023-01-31 12:38:08 +00:00
|
|
|
proc completeCmdArg(T: type NetworkId, val: string): seq[string] =
|
2021-09-11 14:58:01 +00:00
|
|
|
return @[]
|
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
proc parseCmdArg(T: type UInt256, p: string): T
|
|
|
|
{.gcsafe, raises: [ValueError].} =
|
2023-01-31 12:38:08 +00:00
|
|
|
parse(p, T)
|
2021-10-05 23:31:35 +00:00
|
|
|
|
2023-01-31 12:38:08 +00:00
|
|
|
proc completeCmdArg(T: type UInt256, val: string): seq[string] =
|
2021-10-05 23:31:35 +00:00
|
|
|
return @[]
|
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
proc parseCmdArg(T: type EthAddress, p: string): T
|
|
|
|
{.gcsafe, raises: [ValueError].}=
|
2021-09-11 14:58:01 +00:00
|
|
|
try:
|
2023-01-31 12:38:08 +00:00
|
|
|
result = hexToByteArray(p, 20)
|
2021-09-11 14:58:01 +00:00
|
|
|
except CatchableError:
|
|
|
|
raise newException(ValueError, "failed to parse EthAddress")
|
2021-05-20 06:01:57 +00:00
|
|
|
|
2023-01-31 12:38:08 +00:00
|
|
|
proc completeCmdArg(T: type EthAddress, val: string): seq[string] =
|
2021-09-11 14:58:01 +00:00
|
|
|
return @[]
|
2018-08-01 12:50:44 +00:00
|
|
|
|
2023-07-07 07:47:26 +00:00
|
|
|
proc parseCmdArg*(T: type enr.Record, p: string): T {.raises: [ValueError].} =
|
|
|
|
if not fromURI(result, p):
|
|
|
|
raise newException(ValueError, "Invalid ENR")
|
|
|
|
|
|
|
|
proc completeCmdArg*(T: type enr.Record, val: string): seq[string] =
|
|
|
|
return @[]
|
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
proc processList(v: string, o: var seq[string])
|
|
|
|
=
|
2018-05-01 00:47:35 +00:00
|
|
|
## Process comma-separated list of strings.
|
2018-04-27 08:53:53 +00:00
|
|
|
if len(v) > 0:
|
|
|
|
for n in v.split({' ', ','}):
|
|
|
|
if len(n) > 0:
|
|
|
|
o.add(n)
|
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
proc parseCmdArg(T: type NetworkParams, p: string): T
|
|
|
|
{.gcsafe, raises: [ValueError].} =
|
2021-09-11 14:58:01 +00:00
|
|
|
try:
|
2023-01-31 12:38:08 +00:00
|
|
|
if not loadNetworkParams(p, result):
|
2021-09-11 14:58:01 +00:00
|
|
|
raise newException(ValueError, "failed to load customNetwork")
|
2023-02-14 20:27:17 +00:00
|
|
|
except CatchableError:
|
2021-09-11 14:58:01 +00:00
|
|
|
raise newException(ValueError, "failed to load customNetwork")
|
|
|
|
|
2023-01-31 12:38:08 +00:00
|
|
|
proc completeCmdArg(T: type NetworkParams, val: string): seq[string] =
|
2021-09-11 14:58:01 +00:00
|
|
|
return @[]
|
|
|
|
|
2023-07-07 07:47:26 +00:00
|
|
|
proc setBootnodes(output: var seq[ENode], nodeUris: openArray[string]) =
|
2021-09-11 14:58:01 +00:00
|
|
|
output = newSeqOfCap[ENode](nodeUris.len)
|
2018-08-01 12:50:44 +00:00
|
|
|
for item in nodeUris:
|
2023-07-07 07:47:26 +00:00
|
|
|
output.add(ENode.fromString(item).expect("valid hardcoded ENode"))
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
iterator repeatingList(listOfList: openArray[string]): string
|
|
|
|
=
|
2021-09-16 15:59:46 +00:00
|
|
|
for strList in listOfList:
|
|
|
|
var list = newSeq[string]()
|
|
|
|
processList(strList, list)
|
|
|
|
for item in list:
|
|
|
|
yield item
|
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
proc append(output: var seq[ENode], nodeUris: openArray[string])
|
|
|
|
=
|
2021-09-16 15:59:46 +00:00
|
|
|
for item in repeatingList(nodeUris):
|
|
|
|
let res = ENode.fromString(item)
|
|
|
|
if res.isErr:
|
|
|
|
warn "Ignoring invalid bootstrap address", address=item
|
|
|
|
continue
|
|
|
|
output.add res.get()
|
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
iterator strippedLines(filename: string): (int, string)
|
|
|
|
{.gcsafe, raises: [IOError].} =
|
2021-09-16 15:59:46 +00:00
|
|
|
var i = 0
|
|
|
|
for line in lines(filename):
|
|
|
|
let stripped = strip(line)
|
|
|
|
if stripped.startsWith('#'): # Comments
|
|
|
|
continue
|
|
|
|
|
|
|
|
if stripped.len > 0:
|
|
|
|
yield (i, stripped)
|
|
|
|
inc i
|
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
proc loadEnodeFile(fileName: string; output: var seq[ENode]; info: string)
|
|
|
|
=
|
2021-09-16 15:59:46 +00:00
|
|
|
if fileName.len == 0:
|
|
|
|
return
|
|
|
|
|
|
|
|
try:
|
|
|
|
for i, ln in strippedLines(fileName):
|
|
|
|
if cmpIgnoreCase(ln, "override") == 0 and i == 0:
|
|
|
|
# override built-in list if the first line is 'override'
|
|
|
|
output = newSeq[ENode]()
|
|
|
|
continue
|
|
|
|
|
|
|
|
let res = ENode.fromString(ln)
|
|
|
|
if res.isErr:
|
2022-02-11 16:28:39 +00:00
|
|
|
warn "Ignoring invalid address", address=ln, line=i, file=fileName, purpose=info
|
2021-09-16 15:59:46 +00:00
|
|
|
continue
|
|
|
|
|
|
|
|
output.add res.get()
|
|
|
|
|
|
|
|
except IOError as e:
|
2022-02-11 16:28:39 +00:00
|
|
|
error "Could not read file", msg = e.msg, purpose = info
|
2021-09-16 15:59:46 +00:00
|
|
|
quit 1
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2022-04-08 04:54:11 +00:00
|
|
|
proc loadBootstrapFile(fileName: string, output: var seq[ENode]) =
|
2022-02-11 16:28:39 +00:00
|
|
|
fileName.loadEnodeFile(output, "bootstrap")
|
|
|
|
|
2022-04-08 04:54:11 +00:00
|
|
|
proc loadStaticPeersFile(fileName: string, output: var seq[ENode]) =
|
2022-02-11 16:28:39 +00:00
|
|
|
fileName.loadEnodeFile(output, "static peers")
|
|
|
|
|
2021-09-11 14:58:01 +00:00
|
|
|
proc getNetworkId(conf: NimbusConf): Option[NetworkId] =
|
2021-09-16 15:59:46 +00:00
|
|
|
if conf.network.len == 0:
|
|
|
|
return none NetworkId
|
|
|
|
|
|
|
|
let network = toLowerAscii(conf.network)
|
|
|
|
case network
|
|
|
|
of "mainnet": return some MainNet
|
|
|
|
of "goerli" : return some GoerliNet
|
2022-07-01 20:16:26 +00:00
|
|
|
of "sepolia": return some SepoliaNet
|
2023-10-25 06:27:55 +00:00
|
|
|
of "holesky": return some HoleskyNet
|
2018-06-20 17:27:32 +00:00
|
|
|
else:
|
2021-09-16 15:59:46 +00:00
|
|
|
try:
|
|
|
|
some parseInt(network).NetworkId
|
|
|
|
except CatchableError:
|
|
|
|
error "Failed to parse network name or id", network
|
|
|
|
quit QuitFailure
|
|
|
|
|
|
|
|
proc getProtocolFlags*(conf: NimbusConf): set[ProtocolFlag] =
|
|
|
|
if conf.protocols.len == 0:
|
|
|
|
return {ProtocolFlag.Eth}
|
|
|
|
|
2023-01-20 15:01:29 +00:00
|
|
|
var noneOk = false
|
2021-09-16 15:59:46 +00:00
|
|
|
for item in repeatingList(conf.protocols):
|
|
|
|
case item.toLowerAscii()
|
|
|
|
of "eth": result.incl ProtocolFlag.Eth
|
|
|
|
of "les": result.incl ProtocolFlag.Les
|
2023-01-20 15:01:29 +00:00
|
|
|
of "snap": result.incl ProtocolFlag.Snap
|
|
|
|
of "none": noneOk = true
|
2021-09-16 15:59:46 +00:00
|
|
|
else:
|
|
|
|
error "Unknown protocol", name=item
|
|
|
|
quit QuitFailure
|
2023-01-20 15:01:29 +00:00
|
|
|
if noneOk and 0 < result.len:
|
2023-04-19 15:01:01 +00:00
|
|
|
error "Setting none contradicts wire protocols", names = $result
|
2023-01-20 15:01:29 +00:00
|
|
|
quit QuitFailure
|
2021-09-16 15:59:46 +00:00
|
|
|
|
|
|
|
proc getRpcFlags(api: openArray[string]): set[RpcFlag] =
|
|
|
|
if api.len == 0:
|
|
|
|
return {RpcFlag.Eth}
|
|
|
|
|
|
|
|
for item in repeatingList(api):
|
|
|
|
case item.toLowerAscii()
|
|
|
|
of "eth": result.incl RpcFlag.Eth
|
|
|
|
of "debug": result.incl RpcFlag.Debug
|
2024-01-22 09:11:37 +00:00
|
|
|
of "exp": result.incl RpcFlag.Exp
|
2021-09-16 15:59:46 +00:00
|
|
|
else:
|
|
|
|
error "Unknown RPC API: ", name=item
|
|
|
|
quit QuitFailure
|
|
|
|
|
|
|
|
proc getRpcFlags*(conf: NimbusConf): set[RpcFlag] =
|
|
|
|
getRpcFlags(conf.rpcApi)
|
|
|
|
|
|
|
|
proc getWsFlags*(conf: NimbusConf): set[RpcFlag] =
|
|
|
|
getRpcFlags(conf.wsApi)
|
|
|
|
|
2023-07-07 07:47:26 +00:00
|
|
|
proc fromEnr*(T: type ENode, r: enr.Record): ENodeResult[ENode] =
|
|
|
|
let
|
|
|
|
# TODO: there must always be a public key, else no signature verification
|
|
|
|
# could have been done and no Record would exist here.
|
|
|
|
# TypedRecord should be reworked not to have public key as an option.
|
|
|
|
pk = r.get(PublicKey).get()
|
|
|
|
tr = r.toTypedRecord().expect("id in valid record")
|
|
|
|
|
|
|
|
if tr.ip.isNone():
|
|
|
|
return err(IncorrectIP)
|
|
|
|
if tr.udp.isNone():
|
|
|
|
return err(IncorrectDiscPort)
|
|
|
|
if tr.tcp.isNone():
|
|
|
|
return err(IncorrectPort)
|
|
|
|
|
|
|
|
ok(ENode(
|
|
|
|
pubkey: pk,
|
|
|
|
address: Address(
|
|
|
|
ip: ipv4(tr.ip.get()),
|
|
|
|
udpPort: Port(tr.udp.get()),
|
|
|
|
tcpPort: Port(tr.tcp.get())
|
|
|
|
)
|
|
|
|
))
|
|
|
|
|
|
|
|
proc getBootNodes*(conf: NimbusConf): seq[ENode] =
|
|
|
|
var bootstrapNodes: seq[ENode]
|
2021-09-16 15:59:46 +00:00
|
|
|
# Ignore standard bootnodes if customNetwork is loaded
|
|
|
|
if conf.customNetwork.isNone:
|
|
|
|
case conf.networkId
|
|
|
|
of MainNet:
|
2023-07-07 07:47:26 +00:00
|
|
|
bootstrapNodes.setBootnodes(MainnetBootnodes)
|
2021-09-16 15:59:46 +00:00
|
|
|
of GoerliNet:
|
2023-07-07 07:47:26 +00:00
|
|
|
bootstrapNodes.setBootnodes(GoerliBootnodes)
|
2022-07-01 20:16:26 +00:00
|
|
|
of SepoliaNet:
|
2023-07-07 07:47:26 +00:00
|
|
|
bootstrapNodes.setBootnodes(SepoliaBootnodes)
|
2023-10-25 06:27:55 +00:00
|
|
|
of HoleskyNet:
|
|
|
|
bootstrapNodes.setBootnodes(HoleskyBootnodes)
|
2021-09-16 15:59:46 +00:00
|
|
|
else:
|
|
|
|
# custom network id
|
|
|
|
discard
|
|
|
|
|
2023-07-07 07:47:26 +00:00
|
|
|
# always allow bootstrap nodes provided by the user
|
2021-09-16 15:59:46 +00:00
|
|
|
if conf.bootstrapNodes.len > 0:
|
2023-07-07 07:47:26 +00:00
|
|
|
bootstrapNodes.append(conf.bootstrapNodes)
|
2021-09-16 15:59:46 +00:00
|
|
|
|
|
|
|
# bootstrap nodes loaded from file might append or
|
|
|
|
# override built-in bootnodes
|
2023-07-07 07:47:26 +00:00
|
|
|
loadBootstrapFile(string conf.bootstrapFile, bootstrapNodes)
|
|
|
|
|
|
|
|
# Bootstrap nodes provided as ENRs
|
|
|
|
for enr in conf.bootstrapEnrs:
|
|
|
|
let enode = Enode.fromEnr(enr).valueOr:
|
|
|
|
fatal "Invalid bootstrap ENR provided", error
|
|
|
|
quit 1
|
|
|
|
|
|
|
|
bootstrapNodes.add(enode)
|
|
|
|
|
|
|
|
bootstrapNodes
|
2021-09-16 15:59:46 +00:00
|
|
|
|
2022-04-08 04:54:11 +00:00
|
|
|
proc getStaticPeers*(conf: NimbusConf): seq[ENode] =
|
2023-07-07 07:47:26 +00:00
|
|
|
var staticPeers: seq[ENode]
|
|
|
|
staticPeers.append(conf.staticPeers)
|
|
|
|
loadStaticPeersFile(string conf.staticPeersFile, staticPeers)
|
|
|
|
|
|
|
|
# Static peers provided as ENRs
|
|
|
|
for enr in conf.staticPeersEnrs:
|
|
|
|
let enode = Enode.fromEnr(enr).valueOr:
|
|
|
|
fatal "Invalid static peer ENR provided", error
|
|
|
|
quit 1
|
|
|
|
|
|
|
|
staticPeers.add(enode)
|
|
|
|
|
|
|
|
staticPeers
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2022-07-19 08:15:18 +00:00
|
|
|
proc getAllowedOrigins*(conf: NimbusConf): seq[Uri] =
|
|
|
|
for item in repeatingList(conf.allowedOrigins):
|
|
|
|
result.add parseUri(item)
|
|
|
|
|
2023-02-14 20:27:17 +00:00
|
|
|
# KLUDGE: The `load()` template does currently not work within any exception
|
|
|
|
# annotated environment.
|
|
|
|
{.pop.}
|
|
|
|
|
|
|
|
proc makeConfig*(cmdLine = commandLineParams()): NimbusConf
|
|
|
|
{.raises: [CatchableError].} =
|
|
|
|
## Note: this function is not gc-safe
|
|
|
|
|
|
|
|
# The try/catch clause can go away when `load()` is clean
|
|
|
|
try:
|
|
|
|
{.push warning[ProveInit]: off.}
|
|
|
|
result = NimbusConf.load(
|
|
|
|
cmdLine,
|
|
|
|
version = NimbusBuild,
|
|
|
|
copyrightBanner = NimbusHeader
|
|
|
|
)
|
|
|
|
{.pop.}
|
|
|
|
except CatchableError as e:
|
|
|
|
raise e
|
|
|
|
except Exception as e:
|
|
|
|
{.warning: "Kludge(BareExcept): `load()` template in vendor package needs to be updated"}
|
|
|
|
raiseAssert "Ooops makeConfig(): name=" & $e.name & " msg=" & e.msg
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
var networkId = result.getNetworkId()
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
if result.customNetwork.isSome:
|
|
|
|
result.networkParams = result.customNetwork.get()
|
|
|
|
if networkId.isNone:
|
|
|
|
# WARNING: networkId and chainId are two distinct things
|
|
|
|
# they usage should not be mixed in other places.
|
|
|
|
# We only set networkId to chainId if networkId not set in cli and
|
|
|
|
# --custom-network is set.
|
|
|
|
# If chainId is not defined in config file, it's ok because
|
|
|
|
# zero means CustomNet
|
|
|
|
networkId = some(NetworkId(result.networkParams.config.chainId))
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
if networkId.isNone:
|
2021-09-11 14:58:01 +00:00
|
|
|
# bootnodes is set via getBootNodes
|
2021-09-16 15:59:46 +00:00
|
|
|
networkId = some MainNet
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
result.networkId = networkId.get()
|
2021-09-11 14:58:01 +00:00
|
|
|
|
|
|
|
if result.customNetwork.isNone:
|
2021-09-16 15:59:46 +00:00
|
|
|
result.networkParams = networkParams(result.networkId)
|
|
|
|
|
|
|
|
if result.cmd == noCommand:
|
2022-07-19 08:15:18 +00:00
|
|
|
# ttd from cli takes precedence over ttd from config-file
|
|
|
|
if result.terminalTotalDifficulty.isSome:
|
|
|
|
result.networkParams.config.terminalTotalDifficulty =
|
|
|
|
result.terminalTotalDifficulty
|
|
|
|
|
2021-09-16 15:59:46 +00:00
|
|
|
if result.udpPort == Port(0):
|
|
|
|
# if udpPort not set in cli, then
|
|
|
|
result.udpPort = result.tcpPort
|
2021-09-11 14:58:01 +00:00
|
|
|
|
2022-06-13 10:20:12 +00:00
|
|
|
# enable rpc server or ws server if they share common port with engine api
|
2022-06-16 06:58:10 +00:00
|
|
|
let rpcMustEnabled = result.engineApiEnabled and (result.engineApiPort == result.rpcPort)
|
|
|
|
let wsMustEnabled = result.engineApiWsEnabled and (result.engineApiWsPort == result.wsPort)
|
|
|
|
|
|
|
|
result.rpcEnabled = result.rpcEnabled or rpcMustEnabled
|
|
|
|
result.wsEnabled = result.wsEnabled or wsMustEnabled
|
2022-06-13 10:20:12 +00:00
|
|
|
|
2022-12-22 04:17:04 +00:00
|
|
|
# see issue #1346
|
|
|
|
if result.keyStore.string == defaultKeystoreDir() and
|
|
|
|
result.dataDir.string != defaultDataDir():
|
|
|
|
result.keyStore = OutDir(result.dataDir.string / "keystore")
|
|
|
|
|
2023-03-02 09:57:58 +00:00
|
|
|
# For consistency
|
|
|
|
if result.syncCtrlFile.isSome and result.syncCtrlFile.unsafeGet == "":
|
|
|
|
error "Argument missing", option="sync-ctrl-file"
|
|
|
|
quit QuitFailure
|
|
|
|
|
2021-09-11 14:58:01 +00:00
|
|
|
when isMainModule:
|
|
|
|
# for testing purpose
|
|
|
|
discard makeConfig()
|