This document describes the main sections and fields of the Ergo node configuration file for the Test Network. This configuration serves the need for non-breaking changes testing.
Ergo Configuration Section#
ergo.networkType = "testnet"
This setting defines the network type. For testing purposes, it's set to "testnet".
This section contains parameters related to the node settings.
headerChainDiffdefines the maximum allowed number of blocks difference between the current local chain and the network. If the difference exceeds this value, the node is considered unsynchronized.
internalMinersCountsets the number of internal miner threads. This helps reproduce real-world scenarios like having multiple GPU miners.
internalMinerPollingIntervalis the polling interval for GPU miners.
maxTransactionCostsets the maximum cost for a transaction to be propagated across the network.
adProofsSuffixLengthdetermines the size of the suffix for dumping ADProofs during bootstrapping.
checkpointis a mandatory checkpoint introduced due to some violations in the PaiNet.
This section includes parameters related to the blockchain.
protocolVersionsets the protocol version.
addressPrefixis the prefix for network addresses. Reserved values include 0 (for mainnet) and 16 (for testnet).
initialDifficultyHexsets the initial difficulty for the network.
epochLengthdefines the length of an epoch in difficulty recalculation. A value of 1 means difficulty is recalculated every block.
blockIntervalis the desired time interval between blocks.
monetary.minerRewardDelaysets the delay between when a block is mined and when the reward can be spent.
votingcontains parameters related to the voting mechanism, such as the length of a voting epoch, the number of epochs for soft-fork voting, and activation epochs for a soft-fork after acceptance.
reemissionincludes parameters related to the emission process.
genesisStateDigestHexis the Base16 representation of the genesis state roothash.
This section allows configuration of voting parameters.
Sets the directory for the wallet's secret storage.
Scorex Configuration Section#
This section includes parameters related to the network settings.
magicBytesis a unique identifier for the network protocol.
bindAddresssets the IP address and port number where the node will accept incoming connections. By default, it listens on all available network adapters.
nodeNameassigns a visible name to your node for other participants in the P2P network.
knownPeersis a list of bootstrap nodes that your node will connect to upon initialization.
REST API Configuration#
This section allows the setting of the node's REST API parameters.
apiKeyHashis the hash of your API key. The API key protects the invocation of critical API methods.
Note: Ensure to secure the transmission of the API key as it is transmitted as plain text in the HTTP header and can be intercepted during network transit!