github.com/badrootd/nibiru-cometbft@v0.37.5-0.20240307173500-2a75559eee9b/proto/tendermint/types/params.proto (about)

     1  syntax = "proto3";
     2  package tendermint.types;
     3  
     4  option go_package = "github.com/cometbft/cometbft/proto/tendermint/types";
     5  
     6  import "gogoproto/gogo.proto";
     7  import "google/protobuf/duration.proto";
     8  
     9  option (gogoproto.equal_all) = true;
    10  
    11  // ConsensusParams contains consensus critical parameters that determine the
    12  // validity of blocks.
    13  message ConsensusParams {
    14    BlockParams     block     = 1;
    15    EvidenceParams  evidence  = 2;
    16    ValidatorParams validator = 3;
    17    VersionParams   version   = 4;
    18  }
    19  
    20  // BlockParams contains limits on the block size.
    21  message BlockParams {
    22    // Max block size, in bytes.
    23    // Note: must be greater than 0
    24    int64 max_bytes = 1;
    25    // Max gas per block.
    26    // Note: must be greater or equal to -1
    27    int64 max_gas = 2;
    28  
    29    reserved 3;  // was TimeIotaMs see https://github.com/cometbft/cometbft/pull/5792
    30  }
    31  
    32  // EvidenceParams determine how we handle evidence of malfeasance.
    33  message EvidenceParams {
    34    // Max age of evidence, in blocks.
    35    //
    36    // The basic formula for calculating this is: MaxAgeDuration / {average block
    37    // time}.
    38    int64 max_age_num_blocks = 1;
    39  
    40    // Max age of evidence, in time.
    41    //
    42    // It should correspond with an app's "unbonding period" or other similar
    43    // mechanism for handling [Nothing-At-Stake
    44    // attacks](https://github.com/ethereum/wiki/wiki/Proof-of-Stake-FAQ#what-is-the-nothing-at-stake-problem-and-how-can-it-be-fixed).
    45    google.protobuf.Duration max_age_duration = 2
    46        [(gogoproto.nullable) = false, (gogoproto.stdduration) = true];
    47  
    48    // This sets the maximum size of total evidence in bytes that can be committed in a single block.
    49    // and should fall comfortably under the max block bytes.
    50    // Default is 1048576 or 1MB
    51    int64 max_bytes = 3;
    52  }
    53  
    54  // ValidatorParams restrict the public key types validators can use.
    55  // NOTE: uses ABCI pubkey naming, not Amino names.
    56  message ValidatorParams {
    57    option (gogoproto.populate) = true;
    58    option (gogoproto.equal)    = true;
    59  
    60    repeated string pub_key_types = 1;
    61  }
    62  
    63  // VersionParams contains the ABCI application version.
    64  message VersionParams {
    65    option (gogoproto.populate) = true;
    66    option (gogoproto.equal)    = true;
    67  
    68    uint64 app = 1;
    69  }
    70  
    71  // HashedParams is a subset of ConsensusParams.
    72  //
    73  // It is hashed into the Header.ConsensusHash.
    74  message HashedParams {
    75    int64 block_max_bytes = 1;
    76    int64 block_max_gas   = 2;
    77  }