github.com/cosmos/cosmos-sdk@v0.50.10/x/staking/autocli.go (about)

     1  package staking
     2  
     3  import (
     4  	"fmt"
     5  
     6  	autocliv1 "cosmossdk.io/api/cosmos/autocli/v1"
     7  	_ "cosmossdk.io/api/cosmos/crypto/ed25519" // register to that it shows up in protoregistry.GlobalTypes
     8  	stakingv1beta "cosmossdk.io/api/cosmos/staking/v1beta1"
     9  
    10  	"github.com/cosmos/cosmos-sdk/version"
    11  )
    12  
    13  func (am AppModule) AutoCLIOptions() *autocliv1.ModuleOptions {
    14  	return &autocliv1.ModuleOptions{
    15  		Query: &autocliv1.ServiceCommandDescriptor{
    16  			Service: stakingv1beta.Query_ServiceDesc.ServiceName,
    17  			RpcCommandOptions: []*autocliv1.RpcCommandOptions{
    18  				{
    19  					RpcMethod: "Validators",
    20  					Short:     "Query for all validators",
    21  					Long:      "Query details about all validators on a network.",
    22  				},
    23  				{
    24  					RpcMethod: "Validator",
    25  					Use:       "validator [validator-addr]",
    26  					Short:     "Query a validator",
    27  					Long:      "Query details about an individual validator.",
    28  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
    29  						{ProtoField: "validator_addr"},
    30  					},
    31  				},
    32  				{
    33  					RpcMethod: "ValidatorDelegations",
    34  					Use:       "delegations-to [validator-addr]",
    35  					Short:     "Query all delegations made to one validator",
    36  					Long:      "Query delegations on an individual validator.",
    37  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
    38  						{
    39  							ProtoField: "validator_addr",
    40  						},
    41  					},
    42  				},
    43  				{
    44  					RpcMethod: "ValidatorUnbondingDelegations",
    45  					Use:       "unbonding-delegations-from [validator-addr]",
    46  					Short:     "Query all unbonding delegatations from a validator",
    47  					Long:      "Query delegations that are unbonding _from_ a validator.",
    48  					Example:   fmt.Sprintf("$ %s query staking unbonding-delegations-from [val-addr]", version.AppName),
    49  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
    50  						{ProtoField: "validator_addr"},
    51  					},
    52  				},
    53  				{
    54  					RpcMethod: "Delegation",
    55  					Use:       "delegation [delegator-addr] [validator-addr]",
    56  					Short:     "Query a delegation based on address and validator address",
    57  					Long:      "Query delegations for an individual delegator on an individual validator",
    58  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
    59  						{ProtoField: "delegator_addr"},
    60  						{ProtoField: "validator_addr"},
    61  					},
    62  				},
    63  				{
    64  					RpcMethod: "UnbondingDelegation",
    65  					Use:       "unbonding-delegation [delegator-addr] [validator-addr]",
    66  					Short:     "Query an unbonding-delegation record based on delegator and validator address",
    67  					Long:      "Query unbonding delegations for an individual delegator on an individual validator.",
    68  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
    69  						{ProtoField: "delegator_addr"},
    70  						{ProtoField: "validator_addr"},
    71  					},
    72  				},
    73  				{
    74  					RpcMethod: "DelegatorDelegations",
    75  					Use:       "delegations [delegator-addr]",
    76  					Short:     "Query all delegations made by one delegator",
    77  					Long:      "Query delegations for an individual delegator on all validators.",
    78  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
    79  						{ProtoField: "delegator_addr"},
    80  					},
    81  				},
    82  				{
    83  					RpcMethod: "DelegatorValidators",
    84  					Use:       "delegator-validators [delegator-addr]",
    85  					Short:     "Query all validators info for given delegator address",
    86  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
    87  						{ProtoField: "delegator_addr"},
    88  					},
    89  				},
    90  				{
    91  					RpcMethod: "DelegatorValidator",
    92  					Use:       "delegator-validator [delegator-addr] [validator-addr]",
    93  					Short:     "Query validator info for given delegator validator pair",
    94  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
    95  						{ProtoField: "delegator_addr"},
    96  						{ProtoField: "validator_addr"},
    97  					},
    98  				},
    99  				{
   100  					RpcMethod: "DelegatorUnbondingDelegations",
   101  					Use:       "unbonding-delegations [delegator-addr]",
   102  					Short:     "Query all unbonding-delegations records for one delegator",
   103  					Long:      "Query unbonding delegations for an individual delegator.",
   104  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
   105  						{ProtoField: "delegator_addr"},
   106  					},
   107  				},
   108  				{
   109  					RpcMethod: "Redelegations",
   110  					Use:       "redelegation [delegator-addr] [src-validator-addr] [dst-validator-addr]",
   111  					Short:     "Query a redelegation record based on delegator and a source and destination validator address",
   112  					Long:      "Query a redelegation record for an individual delegator between a source and destination validator.",
   113  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
   114  						{ProtoField: "delegator_addr"},
   115  						{ProtoField: "src_validator_addr"},
   116  						{ProtoField: "dst_validator_addr"},
   117  					},
   118  				},
   119  				{
   120  					RpcMethod: "HistoricalInfo",
   121  					Use:       "historical-info [height]",
   122  					Short:     "Query historical info at given height",
   123  					Example:   fmt.Sprintf("$ %s query staking historical-info 5", version.AppName),
   124  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{
   125  						{ProtoField: "height"},
   126  					},
   127  				},
   128  				{
   129  					RpcMethod: "Pool",
   130  					Use:       "pool",
   131  					Short:     "Query the current staking pool values",
   132  					Long:      "Query values for amounts stored in the staking pool.",
   133  				},
   134  				{
   135  					RpcMethod: "Params",
   136  					Use:       "params",
   137  					Short:     "Query the current staking parameters information",
   138  					Long:      "Query values set as staking parameters.",
   139  				},
   140  			},
   141  		},
   142  		Tx: &autocliv1.ServiceCommandDescriptor{
   143  			Service: stakingv1beta.Msg_ServiceDesc.ServiceName,
   144  			RpcCommandOptions: []*autocliv1.RpcCommandOptions{
   145  				{
   146  					RpcMethod:      "Delegate",
   147  					Use:            "delegate [validator-addr] [amount] --from [delegator_address]",
   148  					Short:          "Delegate liquid tokens to a validator",
   149  					Long:           "Delegate an amount of liquid coins to a validator from your wallet.",
   150  					Example:        fmt.Sprintf("%s tx staking delegate cosmosvaloper... 1000stake --from mykey", version.AppName),
   151  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{{ProtoField: "validator_address"}, {ProtoField: "amount"}},
   152  				},
   153  				{
   154  					RpcMethod:      "BeginRedelegate",
   155  					Use:            "redelegate [src-validator-addr] [dst-validator-addr] [amount] --from [delegator]",
   156  					Short:          "Generate multisig signatures for transactions generated offline",
   157  					Long:           "Redelegate an amount of illiquid staking tokens from one validator to another.",
   158  					Example:        fmt.Sprintf(`%s tx staking redelegate cosmosvaloper... cosmosvaloper... 100stake --from mykey`, version.AppName),
   159  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{{ProtoField: "validator_src_address"}, {ProtoField: "validator_dst_address"}, {ProtoField: "amount"}},
   160  				},
   161  				{
   162  					RpcMethod:      "Undelegate",
   163  					Use:            "unbond [validator-addr] [amount] --from [delegator_address]",
   164  					Short:          "Unbond shares from a validator",
   165  					Long:           "Unbond an amount of bonded shares from a validator.",
   166  					Example:        fmt.Sprintf(`%s tx staking unbond cosmosvaloper... 100stake --from mykey`, version.AppName),
   167  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{{ProtoField: "validator_address"}, {ProtoField: "amount"}},
   168  				},
   169  				{
   170  					RpcMethod:      "CancelUnbondingDelegation",
   171  					Use:            "cancel-unbond [validator-addr] [amount] [creation-height]",
   172  					Short:          "Cancel unbonding delegation and delegate back to the validator",
   173  					Example:        fmt.Sprintf(`%s tx staking cancel-unbond cosmosvaloper... 100stake 2 --from mykey`, version.AppName),
   174  					PositionalArgs: []*autocliv1.PositionalArgDescriptor{{ProtoField: "validator_address"}, {ProtoField: "amount"}, {ProtoField: "creation_height"}},
   175  				},
   176  				{
   177  					RpcMethod: "UpdateParams",
   178  					Skip:      true, // skipped because authority gated
   179  				},
   180  			},
   181  			EnhanceCustomCommand: false, // use custom commands only until v0.51
   182  		},
   183  	}
   184  }