@ethereumjs/client / ConfigOptions
• Optional
accountCache: number
Size for the account cache (max number of accounts)
• Optional
accounts: [address: Address, privKey: Uint8Array][]
Unlocked accounts of form [address, privateKey] Currently only the first account is used to seal mined PoA blocks
Default: []
• Optional
bootnodes: Multiaddr
[]
Network bootnodes (e.g. abc@18.138.108.67 or /ip4/127.0.0.1/tcp/50505/p2p/QmABC)
• Optional
codeCache: number
Size for the code cache (max number of contracts)
• Optional
common: Common
Specify the chain by providing a Common instance, the common instance will not be modified by client
Default: ‘mainnet’ Common
• Optional
datadir: string
Root data directory for the blockchain
• Optional
debugCode: boolean
Generate code for local debugging, currently providing a code snippet which can be used to run blocks on the EthereumJS VM on execution errors
(meant to be used internally for the most part)
• Optional
discDns: boolean
Query EIP-1459 DNS TXT records for peer discovery
Default: true
for testnets, false for mainnet
• Optional
discV4: boolean
Use v4 (“findneighbour” node requests) for peer discovery
Default: false
for testnets, true for mainnet
• Optional
dnsAddr: string
DNS server to query DNS TXT records from for peer discovery
Default 8.8.8.8
(Google)
• Optional
dnsNetworks: string
[]
EIP-1459 ENR Tree urls to query via DNS for peer discovery
• Optional
enableSnapSync: boolean
Whether to enable and run snapSync, currently experimental
Default: false
• Optional
engineNewpayloadMaxExecute: number
Max blocks including unexecuted parents to be executed in engine’s newPayload
• Optional
engineNewpayloadMaxTxsExecute: number
Limit max transactions per block to execute in engine’s newPayload for responsive engine api
• Optional
engineParentLookupMaxDepth: number
Max depth for parent lookups in engine’s newPayload and forkchoiceUpdated
• Optional
execution: boolean
Start continuous VM execution (pre-Merge setting)
• Optional
extIP: string
RLPx external IP
• Optional
isSingleNode: boolean
Is a single node and doesn’t need peers for synchronization
Default: false
• Optional
key: Uint8Array
Private key for the client. Use return value of getClientKey. If left blank, a random key will be generated and used.
• Optional
lightserv: boolean
Serve light peer requests
Default: false
• Optional
logger: Logger
A custom winston logger can be provided if setting logging verbosity is not sufficient
Default: Logger with loglevel ‘info’
• Optional
maxAccountRange: bigint
• Optional
maxFetcherJobs: number
Max jobs to be enqueued in the fetcher at any given time
Default: 100
• Optional
maxFetcherRequests: number
Max outgoing multi-peer requests by the fetcher at any given time
• Optional
maxInvalidBlocksErrorCache: number
Cache size of invalid block hashes and their errors
• Optional
maxPeers: number
Maximum peers allowed
Default: 25
• Optional
maxPerRequest: number
Max items per block or header request
Default: 100
• Optional
maxRangeBytes: number
• Optional
maxStorageRange: bigint
• Optional
minPeers: number
Number of peers needed before syncing
Default: 1
• Optional
mine: boolean
Enable mining
Default: false
• Optional
minerCoinbase: Address
Address for mining rewards (etherbase) If not provided, defaults to the primary account.
• Optional
multiaddrs: Multiaddr
[]
Network multiaddrs for libp2p (e.g. /ip4/127.0.0.1/tcp/50505/p2p/QmABC)
• Optional
numBlocksPerIteration: number
Number of blocks to execute in batch mode and logged to console
• Optional
port: number
RLPx listening port
Default: 30303
• Optional
prefixStorageTrieKeys: boolean
A temporary option to offer backward compatibility with already-synced databases that are using non-prefixed keys for storage tries
Default: true
• Optional
pruneEngineCache: boolean
• Optional
safeReorgDistance: number
If there is a reorg, this is a safe distance from which to try to refetch and refeed the blocks.
• Optional
savePreimages: boolean
Save account keys preimages in the meta db (default: false)
• Optional
saveReceipts: boolean
Save tx receipts and logs in the meta db (default: false)
• Optional
server: RlpxServer
Transport servers (RLPx) Only used for testing purposes
• Optional
skeletonFillCanonicalBackStep: number
If there is a skeleton fillCanonicalChain block lookup errors because of closing chain conditions, this allows skeleton to backstep and fill again using reverse block fetcher.
• Optional
skeletonSubchainMergeMinimum: number
If skeleton subchains can be merged, what is the minimum tail gain, as subchain merge will lead to the ReverseBlockFetcher reset
• Optional
snapAvailabilityDepth: bigint
• Optional
snapTransitionSafeDepth: bigint
• Optional
statelessVerkle: boolean
Enables stateless verkle block execution (default: false)
• Optional
storageCache: number
Size for the storage cache (max number of contracts)
• Optional
syncedStateRemovalPeriod: number
The time after which synced state is downgraded to unsynced
• Optional
syncmode: SyncMode
Synchronization mode (‘full’, ‘light’, ‘none’)
Default: ‘full’
• Optional
trieCache: number
Size for the trie cache (max number of trie nodes)
• Optional
txLookupLimit: number
Number of recent blocks to maintain transactions index for (default = 2350000 = about one year, 0 = entire chain)
• Optional
useStringValueTrieDB: boolean
A temporary option to offer backward compatibility with already-synced databases that stores
trie items as string
, instead of the more performant Uint8Array
• Optional
vm: VM
Provide a custom VM instance to process blocks
Default: VM instance created by client
• Optional
vmProfileBlocks: boolean
Whether to profile VM blocks
• Optional
vmProfileTxs: boolean
Whether to profile VM txs