settings-tp command starts the Settings transaction processor,
which provides a methodology for storing on-chain configuration settings.
Note: This transaction processor is required in order to apply changes to on-chain settings.
The settings stored in state as a result of this transaction family play a
critical role in the operation of a validator. For example, the consensus module
uses these settings. In the case of PoET, one cross-network setting is target
wait time (which must be the same across validators), that is stored as
sawtooth.poet.target_wait_time. Other parts of the system use these settings
similarly; for example, the list of enabled transaction families is used by the
transaction processing platform. In addition, pluggable components such as
transaction family implementations can use the settings during their execution.
This design supports two authorization options: either a single authorized key
that can make changes or multiple authorized keys. In the case of multiple keys,
a percentage of votes signed by the keys is required to make a change. Note that
only the keys in
sawtooth.settings.vote.authorized_keys are allowed to
submit setting transactions.
1 2 3 4 5 6 7 8 9 10 11 12 13
usage: settings-tp [-h] [-C CONNECT] [-v] [-V] Starts a Settings transaction processor (settings-tp). optional arguments: -h, --help show this help message and exit -C CONNECT, --connect CONNECT specify the endpoint for the validator connection (default: tcp://localhost:4004) -v, --verbose enable more verbose output to stderr -V, --version display version information This process is required to apply any changes to on-chain settings used by the Sawtooth platform.