github.com/muhammedhassanm/blockchain@v0.0.0-20200120143007-697261defd4d/sawtooth-core-master/docs/source/cli/settings-tp.rst (about)

     1  ..
     2     Copyright 2017 Intel Corporation
     3  
     4     Licensed under the Apache License, Version 2.0 (the "License");
     5     you may not use this file except in compliance with the License.
     6     You may obtain a copy of the License at
     7  
     8         http://www.apache.org/licenses/LICENSE-2.0
     9  
    10     Unless required by applicable law or agreed to in writing, software
    11     distributed under the License is distributed on an "AS IS" BASIS,
    12     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13     See the License for the specific language governing permissions and
    14     limitations under the License.
    15  
    16  ***********
    17  settings-tp
    18  ***********
    19  
    20  The ``settings-tp`` command starts the Settings transaction processor,
    21  which provides a methodology for storing on-chain configuration settings.
    22  
    23  **Note:** This transaction processor is required in order to apply changes to
    24  on-chain settings.
    25  
    26  The settings stored in state as a result of this transaction family play a
    27  critical role in the operation of a validator. For example, the consensus module
    28  uses these settings. In the case of PoET, one cross-network setting is target
    29  wait time (which must be the same across validators), that is stored as
    30  ``sawtooth.poet.target_wait_time``. Other parts of the system use these settings
    31  similarly; for example, the list of enabled transaction families is used by the
    32  transaction processing platform. In addition, pluggable components such as
    33  transaction family implementations can use the settings during their execution.
    34  
    35  This design supports two authorization options: either a single authorized key
    36  that can make changes or multiple authorized keys. In the case of multiple keys,
    37  a percentage of votes signed by the keys is required to make a change. Note that
    38  only the keys in ``sawtooth.settings.vote.authorized_keys`` are allowed to
    39  submit setting transactions.
    40  
    41  .. literalinclude:: output/settings-tp_usage.out
    42     :language: console
    43  
    44  .. Licensed under Creative Commons Attribution 4.0 International License
    45  .. https://creativecommons.org/licenses/by/4.0/