github.com/Finschia/finschia-sdk@v0.49.1/proto/cosmos/upgrade/v1beta1/upgrade.proto (about)

     1  syntax = "proto3";
     2  package cosmos.upgrade.v1beta1;
     3  
     4  import "google/protobuf/any.proto";
     5  import "gogoproto/gogo.proto";
     6  import "google/protobuf/timestamp.proto";
     7  
     8  option go_package                      = "github.com/Finschia/finschia-sdk/x/upgrade/types";
     9  option (gogoproto.goproto_getters_all) = false;
    10  
    11  // Plan specifies information about a planned upgrade and when it should occur.
    12  message Plan {
    13    option (gogoproto.equal)            = true;
    14    option (gogoproto.goproto_stringer) = false;
    15  
    16    // Sets the name for the upgrade. This name will be used by the upgraded
    17    // version of the software to apply any special "on-upgrade" commands during
    18    // the first BeginBlock method after the upgrade is applied. It is also used
    19    // to detect whether a software version can handle a given upgrade. If no
    20    // upgrade handler with this name has been set in the software, it will be
    21    // assumed that the software is out-of-date when the upgrade Time or Height is
    22    // reached and the software will exit.
    23    string name = 1;
    24  
    25    // Deprecated: Time based upgrades have been deprecated. Time based upgrade logic
    26    // has been removed from the SDK.
    27    // If this field is not empty, an error will be thrown.
    28    google.protobuf.Timestamp time = 2 [deprecated = true, (gogoproto.stdtime) = true, (gogoproto.nullable) = false];
    29  
    30    // The height at which the upgrade must be performed.
    31    // Only used if Time is not set.
    32    int64 height = 3;
    33  
    34    // Any application specific upgrade info to be included on-chain
    35    // such as a git commit that validators could automatically upgrade to
    36    string info = 4;
    37  
    38    // Deprecated: UpgradedClientState field has been deprecated. IBC upgrade logic has been
    39    // moved to the IBC module in the sub module 02-client.
    40    // If this field is not empty, an error will be thrown.
    41    google.protobuf.Any upgraded_client_state = 5
    42        [deprecated = true, (gogoproto.moretags) = "yaml:\"upgraded_client_state\""];
    43  }
    44  
    45  // SoftwareUpgradeProposal is a gov Content type for initiating a software
    46  // upgrade.
    47  message SoftwareUpgradeProposal {
    48    option (gogoproto.equal)            = true;
    49    option (gogoproto.goproto_stringer) = false;
    50  
    51    string title       = 1;
    52    string description = 2;
    53    Plan   plan        = 3 [(gogoproto.nullable) = false];
    54  }
    55  
    56  // CancelSoftwareUpgradeProposal is a gov Content type for cancelling a software
    57  // upgrade.
    58  message CancelSoftwareUpgradeProposal {
    59    option (gogoproto.equal)            = true;
    60    option (gogoproto.goproto_stringer) = false;
    61  
    62    string title       = 1;
    63    string description = 2;
    64  }
    65  
    66  // ModuleVersion specifies a module and its consensus version.
    67  //
    68  // Since: cosmos-sdk 0.43
    69  message ModuleVersion {
    70    option (gogoproto.equal)            = true;
    71    option (gogoproto.goproto_stringer) = true;
    72  
    73    // name of the app module
    74    string name = 1;
    75  
    76    // consensus version of the app module
    77    uint64 version = 2;
    78  }