Packages named utils, common, or misc provide clients with no sense of what the package contains. This makes it harder for clients to use the package and makes it harder for maintainers to keep the package focused. Over time, they accumulate dependencies that can make compilation significantly and unnecessarily slower, especially in large programs. And since such package names are generic, they are more likely to collide with other packages imported by client code, forcing clients to invent names to distinguish them. cit. https://blog.golang.org/package-names
399 lines
13 KiB
Go
399 lines
13 KiB
Go
package cli
|
|
|
|
import (
|
|
"bufio"
|
|
"fmt"
|
|
"os"
|
|
"strings"
|
|
|
|
"github.com/spf13/cobra"
|
|
flag "github.com/spf13/pflag"
|
|
"github.com/spf13/viper"
|
|
|
|
cfg "github.com/tendermint/tendermint/config"
|
|
"github.com/tendermint/tendermint/crypto"
|
|
|
|
"github.com/cosmos/cosmos-sdk/client"
|
|
"github.com/cosmos/cosmos-sdk/client/context"
|
|
"github.com/cosmos/cosmos-sdk/client/flags"
|
|
"github.com/cosmos/cosmos-sdk/codec"
|
|
sdk "github.com/cosmos/cosmos-sdk/types"
|
|
"github.com/cosmos/cosmos-sdk/version"
|
|
"github.com/cosmos/cosmos-sdk/x/auth"
|
|
authclient "github.com/cosmos/cosmos-sdk/x/auth/client"
|
|
"github.com/cosmos/cosmos-sdk/x/staking/types"
|
|
)
|
|
|
|
// GetTxCmd returns the transaction commands for this module
|
|
func GetTxCmd(storeKey string, cdc *codec.Codec) *cobra.Command {
|
|
stakingTxCmd := &cobra.Command{
|
|
Use: types.ModuleName,
|
|
Short: "Staking transaction subcommands",
|
|
DisableFlagParsing: true,
|
|
SuggestionsMinimumDistance: 2,
|
|
RunE: client.ValidateCmd,
|
|
}
|
|
|
|
stakingTxCmd.AddCommand(flags.PostCommands(
|
|
GetCmdCreateValidator(cdc),
|
|
GetCmdEditValidator(cdc),
|
|
GetCmdDelegate(cdc),
|
|
GetCmdRedelegate(storeKey, cdc),
|
|
GetCmdUnbond(storeKey, cdc),
|
|
)...)
|
|
|
|
return stakingTxCmd
|
|
}
|
|
|
|
// GetCmdCreateValidator implements the create validator command handler.
|
|
func GetCmdCreateValidator(cdc *codec.Codec) *cobra.Command {
|
|
cmd := &cobra.Command{
|
|
Use: "create-validator",
|
|
Short: "create new validator initialized with a self-delegation to it",
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
inBuf := bufio.NewReader(cmd.InOrStdin())
|
|
txBldr := auth.NewTxBuilderFromCLI(inBuf).WithTxEncoder(authclient.GetTxEncoder(cdc))
|
|
cliCtx := context.NewCLIContextWithInput(inBuf).WithCodec(cdc)
|
|
|
|
txBldr, msg, err := BuildCreateValidatorMsg(cliCtx, txBldr)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
return authclient.GenerateOrBroadcastMsgs(cliCtx, txBldr, []sdk.Msg{msg})
|
|
},
|
|
}
|
|
|
|
cmd.Flags().AddFlagSet(FsPk)
|
|
cmd.Flags().AddFlagSet(FsAmount)
|
|
cmd.Flags().AddFlagSet(fsDescriptionCreate)
|
|
cmd.Flags().AddFlagSet(FsCommissionCreate)
|
|
cmd.Flags().AddFlagSet(FsMinSelfDelegation)
|
|
|
|
cmd.Flags().String(FlagIP, "", fmt.Sprintf("The node's public IP. It takes effect only when used in combination with --%s", flags.FlagGenerateOnly))
|
|
cmd.Flags().String(FlagNodeID, "", "The node's ID")
|
|
|
|
cmd.MarkFlagRequired(flags.FlagFrom)
|
|
cmd.MarkFlagRequired(FlagAmount)
|
|
cmd.MarkFlagRequired(FlagPubKey)
|
|
cmd.MarkFlagRequired(FlagMoniker)
|
|
|
|
return cmd
|
|
}
|
|
|
|
// GetCmdEditValidator implements the create edit validator command.
|
|
// TODO: add full description
|
|
func GetCmdEditValidator(cdc *codec.Codec) *cobra.Command {
|
|
cmd := &cobra.Command{
|
|
Use: "edit-validator",
|
|
Short: "edit an existing validator account",
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
inBuf := bufio.NewReader(cmd.InOrStdin())
|
|
txBldr := auth.NewTxBuilderFromCLI(inBuf).WithTxEncoder(auth.DefaultTxEncoder(cdc))
|
|
cliCtx := context.NewCLIContextWithInput(inBuf).WithCodec(cdc)
|
|
|
|
valAddr := cliCtx.GetFromAddress()
|
|
description := types.NewDescription(
|
|
viper.GetString(FlagMoniker),
|
|
viper.GetString(FlagIdentity),
|
|
viper.GetString(FlagWebsite),
|
|
viper.GetString(FlagSecurityContact),
|
|
viper.GetString(FlagDetails),
|
|
)
|
|
|
|
var newRate *sdk.Dec
|
|
|
|
commissionRate := viper.GetString(FlagCommissionRate)
|
|
if commissionRate != "" {
|
|
rate, err := sdk.NewDecFromStr(commissionRate)
|
|
if err != nil {
|
|
return fmt.Errorf("invalid new commission rate: %v", err)
|
|
}
|
|
|
|
newRate = &rate
|
|
}
|
|
|
|
var newMinSelfDelegation *sdk.Int
|
|
|
|
minSelfDelegationString := viper.GetString(FlagMinSelfDelegation)
|
|
if minSelfDelegationString != "" {
|
|
msb, ok := sdk.NewIntFromString(minSelfDelegationString)
|
|
if !ok {
|
|
return types.ErrMinSelfDelegationInvalid
|
|
}
|
|
|
|
newMinSelfDelegation = &msb
|
|
}
|
|
|
|
msg := types.NewMsgEditValidator(sdk.ValAddress(valAddr), description, newRate, newMinSelfDelegation)
|
|
|
|
// build and sign the transaction, then broadcast to Tendermint
|
|
return authclient.GenerateOrBroadcastMsgs(cliCtx, txBldr, []sdk.Msg{msg})
|
|
},
|
|
}
|
|
|
|
cmd.Flags().AddFlagSet(fsDescriptionEdit)
|
|
cmd.Flags().AddFlagSet(fsCommissionUpdate)
|
|
cmd.Flags().AddFlagSet(FsMinSelfDelegation)
|
|
|
|
return cmd
|
|
}
|
|
|
|
// GetCmdDelegate implements the delegate command.
|
|
func GetCmdDelegate(cdc *codec.Codec) *cobra.Command {
|
|
return &cobra.Command{
|
|
Use: "delegate [validator-addr] [amount]",
|
|
Args: cobra.ExactArgs(2),
|
|
Short: "Delegate liquid tokens to a validator",
|
|
Long: strings.TrimSpace(
|
|
fmt.Sprintf(`Delegate an amount of liquid coins to a validator from your wallet.
|
|
|
|
Example:
|
|
$ %s tx staking delegate cosmosvaloper1l2rsakp388kuv9k8qzq6lrm9taddae7fpx59wm 1000stake --from mykey
|
|
`,
|
|
version.ClientName,
|
|
),
|
|
),
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
inBuf := bufio.NewReader(cmd.InOrStdin())
|
|
txBldr := auth.NewTxBuilderFromCLI(inBuf).WithTxEncoder(auth.DefaultTxEncoder(cdc))
|
|
cliCtx := context.NewCLIContextWithInput(inBuf).WithCodec(cdc)
|
|
|
|
amount, err := sdk.ParseCoin(args[1])
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
delAddr := cliCtx.GetFromAddress()
|
|
valAddr, err := sdk.ValAddressFromBech32(args[0])
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
msg := types.NewMsgDelegate(delAddr, valAddr, amount)
|
|
return authclient.GenerateOrBroadcastMsgs(cliCtx, txBldr, []sdk.Msg{msg})
|
|
},
|
|
}
|
|
}
|
|
|
|
// GetCmdRedelegate the begin redelegation command.
|
|
func GetCmdRedelegate(storeName string, cdc *codec.Codec) *cobra.Command {
|
|
return &cobra.Command{
|
|
Use: "redelegate [src-validator-addr] [dst-validator-addr] [amount]",
|
|
Short: "Redelegate illiquid tokens from one validator to another",
|
|
Args: cobra.ExactArgs(3),
|
|
Long: strings.TrimSpace(
|
|
fmt.Sprintf(`Redelegate an amount of illiquid staking tokens from one validator to another.
|
|
|
|
Example:
|
|
$ %s tx staking redelegate cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj cosmosvaloper1l2rsakp388kuv9k8qzq6lrm9taddae7fpx59wm 100stake --from mykey
|
|
`,
|
|
version.ClientName,
|
|
),
|
|
),
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
inBuf := bufio.NewReader(cmd.InOrStdin())
|
|
txBldr := auth.NewTxBuilderFromCLI(inBuf).WithTxEncoder(auth.DefaultTxEncoder(cdc))
|
|
cliCtx := context.NewCLIContextWithInput(inBuf).WithCodec(cdc)
|
|
|
|
delAddr := cliCtx.GetFromAddress()
|
|
valSrcAddr, err := sdk.ValAddressFromBech32(args[0])
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
valDstAddr, err := sdk.ValAddressFromBech32(args[1])
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
amount, err := sdk.ParseCoin(args[2])
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
msg := types.NewMsgBeginRedelegate(delAddr, valSrcAddr, valDstAddr, amount)
|
|
return authclient.GenerateOrBroadcastMsgs(cliCtx, txBldr, []sdk.Msg{msg})
|
|
},
|
|
}
|
|
}
|
|
|
|
// GetCmdUnbond implements the unbond validator command.
|
|
func GetCmdUnbond(storeName string, cdc *codec.Codec) *cobra.Command {
|
|
return &cobra.Command{
|
|
Use: "unbond [validator-addr] [amount]",
|
|
Short: "Unbond shares from a validator",
|
|
Args: cobra.ExactArgs(2),
|
|
Long: strings.TrimSpace(
|
|
fmt.Sprintf(`Unbond an amount of bonded shares from a validator.
|
|
|
|
Example:
|
|
$ %s tx staking unbond cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj 100stake --from mykey
|
|
`,
|
|
version.ClientName,
|
|
),
|
|
),
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
inBuf := bufio.NewReader(cmd.InOrStdin())
|
|
txBldr := auth.NewTxBuilderFromCLI(inBuf).WithTxEncoder(auth.DefaultTxEncoder(cdc))
|
|
cliCtx := context.NewCLIContextWithInput(inBuf).WithCodec(cdc)
|
|
|
|
delAddr := cliCtx.GetFromAddress()
|
|
valAddr, err := sdk.ValAddressFromBech32(args[0])
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
amount, err := sdk.ParseCoin(args[1])
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
msg := types.NewMsgUndelegate(delAddr, valAddr, amount)
|
|
return authclient.GenerateOrBroadcastMsgs(cliCtx, txBldr, []sdk.Msg{msg})
|
|
},
|
|
}
|
|
}
|
|
|
|
//__________________________________________________________
|
|
|
|
var (
|
|
defaultTokens = sdk.TokensFromConsensusPower(100)
|
|
defaultAmount = defaultTokens.String() + sdk.DefaultBondDenom
|
|
defaultCommissionRate = "0.1"
|
|
defaultCommissionMaxRate = "0.2"
|
|
defaultCommissionMaxChangeRate = "0.01"
|
|
defaultMinSelfDelegation = "1"
|
|
)
|
|
|
|
// Return the flagset, particular flags, and a description of defaults
|
|
// this is anticipated to be used with the gen-tx
|
|
func CreateValidatorMsgHelpers(ipDefault string) (fs *flag.FlagSet, nodeIDFlag, pubkeyFlag, amountFlag, defaultsDesc string) {
|
|
|
|
fsCreateValidator := flag.NewFlagSet("", flag.ContinueOnError)
|
|
fsCreateValidator.String(FlagIP, ipDefault, "The node's public IP")
|
|
fsCreateValidator.String(FlagNodeID, "", "The node's NodeID")
|
|
fsCreateValidator.String(FlagWebsite, "", "The validator's (optional) website")
|
|
fsCreateValidator.String(FlagSecurityContact, "", "The validator's (optional) security contact email")
|
|
fsCreateValidator.String(FlagDetails, "", "The validator's (optional) details")
|
|
fsCreateValidator.String(FlagIdentity, "", "The (optional) identity signature (ex. UPort or Keybase)")
|
|
fsCreateValidator.AddFlagSet(FsCommissionCreate)
|
|
fsCreateValidator.AddFlagSet(FsMinSelfDelegation)
|
|
fsCreateValidator.AddFlagSet(FsAmount)
|
|
fsCreateValidator.AddFlagSet(FsPk)
|
|
|
|
defaultsDesc = fmt.Sprintf(`
|
|
delegation amount: %s
|
|
commission rate: %s
|
|
commission max rate: %s
|
|
commission max change rate: %s
|
|
minimum self delegation: %s
|
|
`, defaultAmount, defaultCommissionRate,
|
|
defaultCommissionMaxRate, defaultCommissionMaxChangeRate,
|
|
defaultMinSelfDelegation)
|
|
|
|
return fsCreateValidator, FlagNodeID, FlagPubKey, FlagAmount, defaultsDesc
|
|
}
|
|
|
|
// prepare flags in config
|
|
func PrepareFlagsForTxCreateValidator(
|
|
config *cfg.Config, nodeID, chainID string, valPubKey crypto.PubKey,
|
|
) {
|
|
|
|
ip := viper.GetString(FlagIP)
|
|
if ip == "" {
|
|
fmt.Fprintf(os.Stderr, "couldn't retrieve an external IP; "+
|
|
"the tx's memo field will be unset")
|
|
}
|
|
|
|
website := viper.GetString(FlagWebsite)
|
|
securityContact := viper.GetString(FlagSecurityContact)
|
|
details := viper.GetString(FlagDetails)
|
|
identity := viper.GetString(FlagIdentity)
|
|
|
|
viper.Set(flags.FlagChainID, chainID)
|
|
viper.Set(flags.FlagFrom, viper.GetString(flags.FlagName))
|
|
viper.Set(FlagNodeID, nodeID)
|
|
viper.Set(FlagIP, ip)
|
|
viper.Set(FlagPubKey, sdk.MustBech32ifyPubKey(sdk.Bech32PubKeyTypeConsPub, valPubKey))
|
|
viper.Set(FlagMoniker, config.Moniker)
|
|
viper.Set(FlagWebsite, website)
|
|
viper.Set(FlagSecurityContact, securityContact)
|
|
viper.Set(FlagDetails, details)
|
|
viper.Set(FlagIdentity, identity)
|
|
|
|
if config.Moniker == "" {
|
|
viper.Set(FlagMoniker, viper.GetString(flags.FlagName))
|
|
}
|
|
if viper.GetString(FlagAmount) == "" {
|
|
viper.Set(FlagAmount, defaultAmount)
|
|
}
|
|
if viper.GetString(FlagCommissionRate) == "" {
|
|
viper.Set(FlagCommissionRate, defaultCommissionRate)
|
|
}
|
|
if viper.GetString(FlagCommissionMaxRate) == "" {
|
|
viper.Set(FlagCommissionMaxRate, defaultCommissionMaxRate)
|
|
}
|
|
if viper.GetString(FlagCommissionMaxChangeRate) == "" {
|
|
viper.Set(FlagCommissionMaxChangeRate, defaultCommissionMaxChangeRate)
|
|
}
|
|
if viper.GetString(FlagMinSelfDelegation) == "" {
|
|
viper.Set(FlagMinSelfDelegation, defaultMinSelfDelegation)
|
|
}
|
|
}
|
|
|
|
// BuildCreateValidatorMsg makes a new MsgCreateValidator.
|
|
func BuildCreateValidatorMsg(cliCtx context.CLIContext, txBldr auth.TxBuilder) (auth.TxBuilder, sdk.Msg, error) {
|
|
amounstStr := viper.GetString(FlagAmount)
|
|
amount, err := sdk.ParseCoin(amounstStr)
|
|
if err != nil {
|
|
return txBldr, nil, err
|
|
}
|
|
|
|
valAddr := cliCtx.GetFromAddress()
|
|
pkStr := viper.GetString(FlagPubKey)
|
|
|
|
pk, err := sdk.GetPubKeyFromBech32(sdk.Bech32PubKeyTypeConsPub, pkStr)
|
|
if err != nil {
|
|
return txBldr, nil, err
|
|
}
|
|
|
|
description := types.NewDescription(
|
|
viper.GetString(FlagMoniker),
|
|
viper.GetString(FlagIdentity),
|
|
viper.GetString(FlagWebsite),
|
|
viper.GetString(FlagSecurityContact),
|
|
viper.GetString(FlagDetails),
|
|
)
|
|
|
|
// get the initial validator commission parameters
|
|
rateStr := viper.GetString(FlagCommissionRate)
|
|
maxRateStr := viper.GetString(FlagCommissionMaxRate)
|
|
maxChangeRateStr := viper.GetString(FlagCommissionMaxChangeRate)
|
|
commissionRates, err := buildCommissionRates(rateStr, maxRateStr, maxChangeRateStr)
|
|
if err != nil {
|
|
return txBldr, nil, err
|
|
}
|
|
|
|
// get the initial validator min self delegation
|
|
msbStr := viper.GetString(FlagMinSelfDelegation)
|
|
minSelfDelegation, ok := sdk.NewIntFromString(msbStr)
|
|
if !ok {
|
|
return txBldr, nil, types.ErrMinSelfDelegationInvalid
|
|
}
|
|
|
|
msg := types.NewMsgCreateValidator(
|
|
sdk.ValAddress(valAddr), pk, amount, description, commissionRates, minSelfDelegation,
|
|
)
|
|
|
|
if viper.GetBool(flags.FlagGenerateOnly) {
|
|
ip := viper.GetString(FlagIP)
|
|
nodeID := viper.GetString(FlagNodeID)
|
|
if nodeID != "" && ip != "" {
|
|
txBldr = txBldr.WithMemo(fmt.Sprintf("%s@%s:26656", nodeID, ip))
|
|
}
|
|
}
|
|
|
|
return txBldr, msg, nil
|
|
}
|