When activated, adds endpoints for a client to be accessible via API. This may be deactivated to run a
client that only offers web endpoints or a console interface. Only applies to the
When activated, adds endpoints for a client to be accessible via web browser. This may be deactivated to
run a client that only offers API endpoints or a console interface. Only applies to the
When this is activated, out-of-cycle verifiers track the blockchain in a manner similar to the client. Using
block-with-votes requests, these verifiers attempt to loosely track the frozen edge of the blockchain at all
times. When this is not activated, out-of-cycle verifiers do not regularly track the blockchain. Instead,
they reinitialize the frozen edge every 20 minutes. Only applies to out-of-cycle
character string (enumeration)
Allows three values: consolidate, delete, and
disable. The original behavior is consolidate, which
bundles all individual files into combined files of up to 1000 blocks each, afterwards deleting the
individual files to save filesystem resources. The delete option skips
consolidation, but it deletes the individual files at the same time as they would be deleted with the
consolidate option. The disable option leaves the
individual files in place. For the client, default behavior is
consolidate. For the verifier and sentinel, default behavior is
64-bit floating-point number
The rate at which the sum of all concurrent connections beyond
concurrent_connection_throttle_threshold reduces the number of concurrent
connections permitted from each IP address.
The number of connections beyond this value reduces the number of connections permitted from each IP address
according to the rate specified by concurrent_connection_reduction_rate.
This is the minimum desired delay between when a connection is no longer needed and when it is forcibly
closed. This value is specified in milliseconds.
When storage space falls below this value, the ConsensusTracker process is
character string (URL)
The location referenced by the HistoricalChainFiller for consolidated block files.
This class is used by the verifier to quickly build the blockchain knowledge necessary to score blocks and
participate fully in block creation and consensus. Only applies to the verifier.
This option is for debugging purposes only, and few verifiers would have reasons to activate this. When
activated, a dummy block from a "new" verifier (private seed of
created and scored each time the verifier freezes a block. Only applies to the
character string (file path)
The directory where the documentation files are located for the documentation server. If using the
Nyzo documentation repository
, this is the
directory into which the repository is cloned. Only applies to the documentation
Activates the ConsensusTracker class. This class records every block and every
vote received by a verifier to help debug consensus issues. This class can consume significant memory and
significant storage. When activating, also consult
Use ASCII color codes to decorate console output.
The identifier of another verifier whose vote will be copied whenever this verifier cannot calculate the
vote independently. When a verifier is having trouble tracking the blockchain, this
setting can be used to allow the verifier to regularly cast votes and maintain its performance score.
The maximum number of Unicode units allowed in an input string, which is the value returned by the
length() method of the Java JSON input String object. If
the length of the input is greater than this value, the input is not parsed.
Controls whether a timestamp is added to every line logged with LogUtil.
The maximum number of concurrent connections allowed from all IP addresses combined. After this limit is
exceeded, all connections will be refused.
The maximum number of concurrent connections allowed from each source IP address. After this limit is
exceeded, all connections from the particular IP address will be refused.
Maximum number of nicknames to track locally. This limit was put into place
in version 500
to prevent attacks that attempt to spam the
verifier with an excessive number of names.
The maximum number of messages that the ScriptUtil.sendMessages() method will
allow to be in progress simultaneously. When this limit is reached, the method will wait for messages to
complete (fail or receive a response) before sending another message.
The maximum number of times that the ScriptUtil.sendMessages() method will attempt
to send each message before accepting failure.
character string (URL)
The base URL from which the verifier can download pre-signed seed transactions. The default value points to
a location provided by the Nyzo team.
Whether to start the background process in the HistoricalBlockManager class. This
background process builds the offset files that allow efficient retrieval of blocks from consolidated block
files. The HistoricalBlockManager is only used by the client. This setting has no
effect on other run modes.
true for documentation server and relay server, false for other run modes
When activated, a listener for HTTP connections is opened on the port specified by
web_port, and the endpoint map is built. Also, if
web_listener_keystore_password are specified, a listener for HTTPS connections is
opened on the port specified by web_port_https.
When activated, the client starts the TransactionIndexer. This background process
builds index files for use by the TransactionIndexedSearchCommand.
Only applies to the client.
When activated, the verifier adds µ1 transactions as appropriate when building blocks for
verification. Currently, the only two transactions added are: nickname, which
stores the current verifier's nickname on the blockchain, and top-new-verifier,
which stores the identifier of the top-voted new verifier on the blockchain.
The amount of time that a web listener socket will block to read a request.
When using SSL (HTTPS) for any of the modes using the web listener, this is the password for the keystore
character string (file path)
When using SSL (HTTPS) for any of the modes using the web listener, this is the path to the keystore file.
The maximum number of concurrent connections allowed by the web listener from each source IP address. After
this limit is exceeded, all connections from the particular IP address will be refused.
Port for the HTTP web listener. This value will apply to all run modes except those for which a value is
separately specified. The names for specific run modes are: web_port_client,
web_port_sentinel, and web_port_verifier.
Port for the HTTPS web listener. This value will apply to all run modes except those for which a value is
separately specified. The names for specific run modes are: web_port_https_client,