github.com/muhammedhassanm/blockchain@v0.0.0-20200120143007-697261defd4d/sawtooth-core-master/docs/source/cli/sawset.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  .. _sawset-reference-label:
    17  
    18  ******
    19  sawset
    20  ******
    21  
    22  The ``sawset`` command is used to work with settings proposals.
    23  
    24  Sawtooth supports storing settings on-chain. The ``sawset``
    25  subcommands can be used to view the current proposals, create
    26  proposals, vote on existing proposals, and produce setting values
    27  that will be set in the genesis block.
    28  
    29  .. literalinclude:: output/sawset_usage.out
    30     :language: console
    31  
    32  sawset genesis
    33  ==============
    34  
    35  The ``sawset genesis`` subcommand creates a Batch of settings
    36  proposals that can be consumed by ``sawadm genesis`` and used
    37  during genesis block construction.
    38  
    39  .. literalinclude:: output/sawset_genesis_usage.out
    40     :language: console
    41  
    42  sawset proposal
    43  ===============
    44  
    45  The Settings transaction family supports a
    46  simple voting mechanism for applying changes to on-chain settings.
    47  The ``sawset proposal`` subcommands provide tools to view,
    48  create and vote on proposed settings.
    49  
    50  .. literalinclude:: output/sawset_proposal_usage.out
    51     :language: console
    52  
    53  sawset proposal create
    54  ======================
    55  
    56  The ``sawset proposal create`` subcommand creates proposals
    57  for settings changes. The change may be applied immediately or after a
    58  series of votes, depending on the vote threshold setting.
    59  
    60  .. literalinclude:: output/sawset_proposal_create_usage.out
    61     :language: console
    62  
    63  sawset proposal list
    64  ====================
    65  
    66  The ``sawset proposal list`` subcommand displays the
    67  currently proposed settings that are not yet active. This list of
    68  proposals can be used to find proposals to vote on.
    69  
    70  .. literalinclude:: output/sawset_proposal_list_usage.out
    71     :language: console
    72  
    73  sawset proposal vote
    74  ====================
    75  
    76  The ``sawset proposal vote`` subcommand votes for a specific
    77  settings-change proposal. Use ``sawset proposal list`` to
    78  find the proposal id.
    79  
    80  .. literalinclude:: output/sawset_proposal_vote_usage.out
    81     :language: console
    82  
    83  .. Licensed under Creative Commons Attribution 4.0 International License
    84  .. https://creativecommons.org/licenses/by/4.0/