import "github.com/cosmos/cosmos-sdk/x/auth/types"
nolint noalias
account.go account_retriever.go codec.go errors.go expected_keepers.go genesis.go keys.go params.go querier.go stdsignmsg.go stdtx.go test_utils.go txbuilder.go types.pb.go
const (
// module name
ModuleName = "auth"
// StoreKey is string representation of the store key for auth
StoreKey = "acc"
// FeeCollectorName the root string for the fee collector account address
FeeCollectorName = "fee_collector"
// QuerierRoute is the querier route for auth
QuerierRoute = ModuleName
)const (
DefaultMaxMemoCharacters uint64 = 256
DefaultTxSigLimit uint64 = 7
DefaultTxSizeCostPerByte uint64 = 10
DefaultSigVerifyCostED25519 uint64 = 590
DefaultSigVerifyCostSecp256k1 uint64 = 1000
)Default parameter values
const (
QueryAccount = "account"
QueryParams = "params"
)query endpoints supported by the auth Querier
const DefaultParamspace = ModuleName
DefaultParamspace defines the default auth module parameter subspace
var (
ErrorInvalidSigner = sdkerrors.Register(ModuleName, 2, "tx intended signer does not match the given signer")
ErrorInvalidGasAdjustment = sdkerrors.Register(ModuleName, 3, "invalid gas adjustment")
)var (
// AddressStoreKeyPrefix prefix for account-by-address store
AddressStoreKeyPrefix = []byte{0x01}
// param key for global account number
GlobalAccountNumberKey = []byte("globalAccountNumber")
)var (
KeyMaxMemoCharacters = []byte("MaxMemoCharacters")
KeyTxSigLimit = []byte("TxSigLimit")
KeyTxSizeCostPerByte = []byte("TxSizeCostPerByte")
KeySigVerifyCostED25519 = []byte("SigVerifyCostED25519")
KeySigVerifyCostSecp256k1 = []byte("SigVerifyCostSecp256k1")
)Parameter keys
var (
ErrInvalidLengthTypes = fmt.Errorf("proto: negative length found during unmarshaling")
ErrIntOverflowTypes = fmt.Errorf("proto: integer overflow")
ErrUnexpectedEndOfGroupTypes = fmt.Errorf("proto: unexpected end of group")
)var (
// ModuleCdc references the global x/auth module codec. Note, the codec should
// ONLY be used in certain instances of tests and for JSON encoding as Amino is
// still used for that purpose.
//
// The actual codec used for serialization should be provided to x/auth and
// defined at the application level.
ModuleCdc = codec.NewHybridCodec(amino)
)func AddressStoreKey(addr sdk.AccAddress) []byte
AddressStoreKey turn an address to key used to get it from the account store
CountSubKeys counts the total number of keys for a multi-sig public key.
DefaultTxDecoder logic for standard transaction decoding
DefaultTxEncoder logic for standard transaction encoding
coins to more than cover the fee
func NewTestMsg(addrs ...sdk.AccAddress) *sdk.TestMsg
func NewTestTx(ctx sdk.Context, msgs []sdk.Msg, privs []crypto.PrivKey, accNums []uint64, seqs []uint64, fee StdFee) sdk.Tx
func NewTestTxWithMemo(ctx sdk.Context, msgs []sdk.Msg, privs []crypto.PrivKey, accNums []uint64, seqs []uint64, fee StdFee, memo string) sdk.Tx
func NewTestTxWithSignBytes(msgs []sdk.Msg, privs []crypto.PrivKey, accNums []uint64, seqs []uint64, fee StdFee, signBytes []byte, memo string) sdk.Tx
func ParamKeyTable() paramtypes.KeyTable
ParamKeyTable for auth module
ProtoBaseAccount - a prototype function for BaseAccount
RegisterCodec registers the account interfaces and concrete types on the provided Amino codec.
func SanitizeGenesisAccounts(genAccs exported.GenesisAccounts) exported.GenesisAccounts
SanitizeGenesisAccounts sorts accounts and coin sets.
func StdSignBytes(chainID string, accnum uint64, sequence uint64, fee StdFee, msgs []sdk.Msg, memo string) []byte
StdSignBytes returns the bytes to sign for a transaction.
func ValidateGenAccounts(accounts exported.GenesisAccounts) error
ValidateGenAccounts validates an array of GenesisAccounts and checks for duplicates
func ValidateGenesis(data GenesisState) error
ValidateGenesis performs basic validation of auth genesis data returning an error for any failed validation criteria.
type AccountRetriever struct {
// contains filtered or unexported fields
}AccountRetriever defines the properties of a type that can be used to retrieve accounts.
func NewAccountRetriever(codec Codec, querier NodeQuerier) AccountRetriever
NewAccountRetriever initialises a new AccountRetriever instance.
func (ar AccountRetriever) EnsureExists(addr sdk.AccAddress) error
EnsureExists returns an error if no account exists for the given address else nil.
func (ar AccountRetriever) GetAccount(addr sdk.AccAddress) (exported.Account, error)
GetAccount queries for an account given an address and a block height. An error is returned if the query or decoding fails.
func (ar AccountRetriever) GetAccountNumberSequence(addr sdk.AccAddress) (uint64, uint64, error)
GetAccountNumberSequence returns sequence and account number for the given address. It returns an error if the account couldn't be retrieved from the state.
func (ar AccountRetriever) GetAccountWithHeight(addr sdk.AccAddress) (exported.Account, int64, error)
GetAccountWithHeight queries for an account given an address. Returns the height of the query with the account. An error is returned if the query or decoding fails.
type BaseAccount struct {
Address github_com_cosmos_cosmos_sdk_types.AccAddress `protobuf:"bytes,1,opt,name=address,proto3,casttype=github.com/cosmos/cosmos-sdk/types.AccAddress" json:"address,omitempty"`
PubKey []byte `protobuf:"bytes,2,opt,name=pub_key,json=pubKey,proto3" json:"public_key,omitempty" yaml:"public_key"`
AccountNumber uint64 `protobuf:"varint,3,opt,name=account_number,json=accountNumber,proto3" json:"account_number,omitempty" yaml:"account_number"`
Sequence uint64 `protobuf:"varint,4,opt,name=sequence,proto3" json:"sequence,omitempty"`
}BaseAccount defines a base account type. It contains all the necessary fields for basic account functionality. Any custom account type should extend this type for additional functionality (e.g. vesting).
func NewBaseAccount(address sdk.AccAddress, pubKey crypto.PubKey, accountNumber, sequence uint64) *BaseAccount
NewBaseAccount creates a new BaseAccount object
func NewBaseAccountWithAddress(addr sdk.AccAddress) *BaseAccount
NewBaseAccountWithAddress - returns a new base account with a given address
func (*BaseAccount) Descriptor() ([]byte, []int)
func (acc BaseAccount) GetAccountNumber() uint64
GetAccountNumber - Implements Account
func (acc BaseAccount) GetAddress() sdk.AccAddress
GetAddress - Implements sdk.Account.
func (acc BaseAccount) GetPubKey() (pk crypto.PubKey)
GetPubKey - Implements sdk.Account.
func (acc BaseAccount) GetSequence() uint64
GetSequence - Implements sdk.Account.
func (m *BaseAccount) Marshal() (dAtA []byte, err error)
func (acc BaseAccount) MarshalJSON() ([]byte, error)
MarshalJSON returns the JSON representation of a BaseAccount.
func (m *BaseAccount) MarshalTo(dAtA []byte) (int, error)
func (m *BaseAccount) MarshalToSizedBuffer(dAtA []byte) (int, error)
func (acc BaseAccount) MarshalYAML() (interface{}, error)
MarshalYAML returns the YAML representation of an account.
func (*BaseAccount) ProtoMessage()
func (m *BaseAccount) Reset()
func (acc *BaseAccount) SetAccountNumber(accNumber uint64) error
SetAccountNumber - Implements Account
func (acc *BaseAccount) SetAddress(addr sdk.AccAddress) error
SetAddress - Implements sdk.Account.
func (acc *BaseAccount) SetPubKey(pubKey crypto.PubKey) error
SetPubKey - Implements sdk.Account.
func (acc *BaseAccount) SetSequence(seq uint64) error
SetSequence - Implements sdk.Account.
func (m *BaseAccount) Size() (n int)
func (acc BaseAccount) String() string
func (m *BaseAccount) Unmarshal(dAtA []byte) error
func (acc *BaseAccount) UnmarshalJSON(bz []byte) error
UnmarshalJSON unmarshals raw JSON bytes into a BaseAccount.
func (acc BaseAccount) Validate() error
Validate checks for errors on the account fields
func (m *BaseAccount) XXX_DiscardUnknown()
func (m *BaseAccount) XXX_Merge(src proto.Message)
func (m *BaseAccount) XXX_Size() int
func (m *BaseAccount) XXX_Unmarshal(b []byte) error
type Codec interface {
codec.Marshaler
MarshalAccount(acc exported.Account) ([]byte, error)
UnmarshalAccount(bz []byte) (exported.Account, error)
MarshalAccountJSON(acc exported.Account) ([]byte, error)
UnmarshalAccountJSON(bz []byte) (exported.Account, error)
}Codec defines the interface needed to serialize x/auth state. It must be aware of all concrete account types.
type GenesisAccountIterator struct{}GenesisAccountIterator implements genesis account iteration.
func (GenesisAccountIterator) IterateGenesisAccounts( cdc Codec, appGenesis map[string]json.RawMessage, cb func(exported.Account) (stop bool), )
IterateGenesisAccounts iterates over all the genesis accounts found in appGenesis and invokes a callback on each genesis account. If any call returns true, iteration stops.
type GenesisState struct {
Params Params `json:"params" yaml:"params"`
Accounts exported.GenesisAccounts `json:"accounts" yaml:"accounts"`
}GenesisState - all auth state that must be provided at genesis
func DefaultGenesisState() GenesisState
DefaultGenesisState - Return a default genesis state
func GetGenesisStateFromAppState(cdc Codec, appState map[string]json.RawMessage) GenesisState
GetGenesisStateFromAppState returns x/auth GenesisState given raw application genesis state.
func NewGenesisState(params Params, accounts exported.GenesisAccounts) GenesisState
NewGenesisState - Create a new genesis state
type NodeQuerier interface {
// QueryWithData performs a query to a Tendermint node with the provided path
// and a data payload. It returns the result and height of the query upon success
// or an error if the query fails.
QueryWithData(path string, data []byte) ([]byte, int64, error)
}NodeQuerier is an interface that is satisfied by types that provide the QueryWithData method
type Params struct {
MaxMemoCharacters uint64 `protobuf:"varint,1,opt,name=max_memo_characters,json=maxMemoCharacters,proto3" json:"max_memo_characters,omitempty" yaml:"max_memo_characters"`
TxSigLimit uint64 `protobuf:"varint,2,opt,name=tx_sig_limit,json=txSigLimit,proto3" json:"tx_sig_limit,omitempty" yaml:"tx_sig_limit"`
TxSizeCostPerByte uint64 `protobuf:"varint,3,opt,name=tx_size_cost_per_byte,json=txSizeCostPerByte,proto3" json:"tx_size_cost_per_byte,omitempty" yaml:"tx_size_cost_per_byte"`
SigVerifyCostED25519 uint64 `protobuf:"varint,4,opt,name=sig_verify_cost_ed25519,json=sigVerifyCostEd25519,proto3" json:"sig_verify_cost_ed25519,omitempty" yaml:"sig_verify_cost_ed25519"`
SigVerifyCostSecp256k1 uint64 `protobuf:"varint,5,opt,name=sig_verify_cost_secp256k1,json=sigVerifyCostSecp256k1,proto3" json:"sig_verify_cost_secp256k1,omitempty" yaml:"sig_verify_cost_secp256k1"`
}Params defines the parameters for the auth module.
DefaultParams returns a default set of parameters.
func NewParams(
maxMemoCharacters, txSigLimit, txSizeCostPerByte, sigVerifyCostED25519, sigVerifyCostSecp256k1 uint64,
) ParamsNewParams creates a new Params object
func (p *Params) ParamSetPairs() paramtypes.ParamSetPairs
ParamSetPairs implements the ParamSet interface and returns all the key/value pairs pairs of auth module's parameters. nolint
String implements the stringer interface.
Validate checks that the parameters have valid values.
type QueryAccountParams struct {
Address sdk.AccAddress
}QueryAccountParams defines the params for querying accounts.
func NewQueryAccountParams(addr sdk.AccAddress) QueryAccountParams
NewQueryAccountParams creates a new instance of QueryAccountParams.
type StdFee struct {
Amount github_com_cosmos_cosmos_sdk_types.Coins `protobuf:"bytes,1,rep,name=amount,proto3,castrepeated=github.com/cosmos/cosmos-sdk/types.Coins" json:"amount"`
Gas uint64 `protobuf:"varint,2,opt,name=gas,proto3" json:"gas,omitempty"`
}StdFee includes the amount of coins paid in fees and the maximum gas to be used by the transaction. The ratio yields an effective "gasprice", which must be above some miminum to be accepted into the mempool.
NewStdFee returns a new instance of StdFee
Bytes for signing later
GasPrices returns the gas prices for a StdFee.
NOTE: The gas prices returned are not the true gas prices that were originally part of the submitted transaction because the fee is computed as fee = ceil(gasWanted * gasPrices).
func (m *StdFee) GetAmount() github_com_cosmos_cosmos_sdk_types.Coins
type StdSignDoc struct {
AccountNumber uint64 `json:"account_number" yaml:"account_number"`
ChainID string `json:"chain_id" yaml:"chain_id"`
Fee json.RawMessage `json:"fee" yaml:"fee"`
Memo string `json:"memo" yaml:"memo"`
Msgs []json.RawMessage `json:"msgs" yaml:"msgs"`
Sequence uint64 `json:"sequence" yaml:"sequence"`
}StdSignDoc is replay-prevention structure. It includes the result of msg.GetSignBytes(), as well as the ChainID (prevent cross chain replay) and the Sequence numbers for each signature (prevent inchain replay and enforce tx ordering per account).
type StdSignMsg struct {
ChainID string `json:"chain_id" yaml:"chain_id"`
AccountNumber uint64 `json:"account_number" yaml:"account_number"`
Sequence uint64 `json:"sequence" yaml:"sequence"`
Fee StdFee `json:"fee" yaml:"fee"`
Msgs []sdk.Msg `json:"msgs" yaml:"msgs"`
Memo string `json:"memo" yaml:"memo"`
}StdSignMsg is a convenience structure for passing along a Msg with the other requirements for a StdSignDoc before it is signed. For use in the CLI.
func (msg StdSignMsg) Bytes() []byte
get message bytes
type StdSignature struct {
crypto.PubKey `json:"pub_key" yaml:"pub_key"` // optional
Signature []byte `json:"signature" yaml:"signature"`
}StdSignature represents a sig
func MakeSignature(keybase keys.Keybase, name, passphrase string, msg StdSignMsg) (sig StdSignature, err error)
MakeSignature builds a StdSignature given keybase, key name, passphrase, and a StdSignMsg.
func (ss StdSignature) MarshalYAML() (interface{}, error)
MarshalYAML returns the YAML representation of the signature.
type StdTx struct {
Msgs []sdk.Msg `json:"msg" yaml:"msg"`
Fee StdFee `json:"fee" yaml:"fee"`
Signatures []StdSignature `json:"signatures" yaml:"signatures"`
Memo string `json:"memo" yaml:"memo"`
}StdTx is a standard way to wrap a Msg with Fee and Signatures. NOTE: the first signature is the fee payer (Signatures must not be nil).
func (tx StdTx) FeePayer() sdk.AccAddress
FeePayer returns the address that is responsible for paying fee StdTx returns the first signer as the fee payer If no signers for tx, return empty address
GetFee returns the FeeAmount in StdFee
GetGas returns the Gas in StdFee
GetMemo returns the memo
GetMsgs returns the all the transaction's messages.
GetPubkeys returns the pubkeys of signers if the pubkey is included in the signature If pubkey is not included in the signature, then nil is in the slice instead
GetSignBytes returns the signBytes of the tx for a given signer
GetSignatures returns the signature of signers who signed the Msg. CONTRACT: Length returned is same as length of pubkeys returned from MsgKeySigners, and the order matches. CONTRACT: If the signature is missing (ie the Msg is invalid), then the corresponding signature is .Empty().
func (tx StdTx) GetSigners() []sdk.AccAddress
GetSigners returns the addresses that must sign the transaction. Addresses are returned in a deterministic order. They are accumulated from the GetSigners method for each Msg in the order they appear in tx.GetMsgs(). Duplicate addresses will be omitted.
ValidateBasic does a simple and lightweight validation check that doesn't require access to any other information.
type SupplyKeeper interface {
SendCoinsFromAccountToModule(ctx sdk.Context, senderAddr sdk.AccAddress, recipientModule string, amt sdk.Coins) error
GetModuleAccount(ctx sdk.Context, moduleName string) exported.ModuleAccountI
GetModuleAddress(moduleName string) sdk.AccAddress
}SupplyKeeper defines the expected supply Keeper (noalias)
type TxBuilder struct {
// contains filtered or unexported fields
}TxBuilder implements a transaction context created in SDK modules.
func NewTxBuilder(
txEncoder sdk.TxEncoder, accNumber, seq, gas uint64, gasAdj float64,
simulateAndExecute bool, chainID, memo string, fees sdk.Coins, gasPrices sdk.DecCoins,
) TxBuilderNewTxBuilder returns a new initialized TxBuilder.
NewTxBuilderFromCLI returns a new initialized TxBuilder with parameters from the command line using Viper.
AccountNumber returns the account number
BuildAndSign builds a single message to be signed, and signs a transaction with the built message given a name, passphrase, and a set of messages.
BuildSignMsg builds a single message to be signed from a TxBuilder given a set of messages. It returns an error if a fee is supplied but cannot be parsed.
BuildTxForSim creates a StdSignMsg and encodes a transaction with the StdSignMsg with a single empty StdSignature for tx simulation.
ChainID returns the chain id
Fees returns the fees for the transaction
Gas returns the gas for the transaction
GasAdjustment returns the gas adjustment
GasPrices returns the gas prices set for the transaction, if any.
Keybase returns the keybase
Memo returns the memo message
Sequence returns the transaction sequence
Sign signs a transaction given a name, passphrase, and a single message to signed. An error is returned if signing fails.
func (bldr TxBuilder) SignStdTx(name, passphrase string, stdTx StdTx, appendSig bool) (signedStdTx StdTx, err error)
SignStdTx appends a signature to a StdTx and returns a copy of it. If append is false, it replaces the signatures already attached with the new signature.
SimulateAndExecute returns the option to simulate and then execute the transaction using the gas from the simulation results
TxEncoder returns the transaction encoder
WithAccountNumber returns a copy of the context with an account number.
WithChainID returns a copy of the context with an updated chainID.
WithFees returns a copy of the context with an updated fee.
WithGas returns a copy of the context with an updated gas.
WithGasPrices returns a copy of the context with updated gas prices.
WithKeybase returns a copy of the context with updated keybase.
WithMemo returns a copy of the context with an updated memo.
WithSequence returns a copy of the context with an updated sequence number.
WithTxEncoder returns a copy of the context with an updated codec.
Package types imports 25 packages (graph) and is imported by 37 packages. Updated 2020-02-28. Refresh now. Tools for package owners.