Documentation ¶
Index ¶
- func ErrInvalidAccount(addr sdk.CUAddress) error
- func ErrVerifyCommit(height int64) error
- func GetFromFields(from string, genOnly bool) (sdk.CUAddress, string, error)
- type CLIContext
- func (ctx CLIContext) BroadcastTx(txBytes []byte) (res sdk.TxResponse, err error)
- func (ctx CLIContext) BroadcastTxAsync(txBytes []byte) (sdk.TxResponse, error)
- func (ctx CLIContext) BroadcastTxCommit(txBytes []byte) (sdk.TxResponse, error)
- func (ctx CLIContext) BroadcastTxSync(txBytes []byte) (sdk.TxResponse, error)
- func (ctx CLIContext) GetFromAddress() sdk.CUAddress
- func (ctx CLIContext) GetFromName() string
- func (ctx CLIContext) GetNode() (rpcclient.Client, error)
- func (ctx CLIContext) PrintOutput(toPrint fmt.Stringer) (err error)
- func (ctx CLIContext) Query(path string) ([]byte, int64, error)
- func (ctx CLIContext) QueryStore(key cmn.HexBytes, storeName string) ([]byte, int64, error)
- func (ctx CLIContext) QuerySubspace(subspace []byte, storeName string) (res []sdk.KVPair, height int64, err error)
- func (ctx CLIContext) QueryWithData(path string, data []byte) ([]byte, int64, error)
- func (ctx CLIContext) Verify(height int64) (tmtypes.SignedHeader, error)
- func (ctx CLIContext) WithBroadcastMode(mode string) CLIContext
- func (ctx CLIContext) WithClient(client rpcclient.Client) CLIContext
- func (ctx CLIContext) WithCodec(cdc *codec.Codec) CLIContext
- func (ctx CLIContext) WithFrom(from string) CLIContext
- func (ctx CLIContext) WithFromAddress(addr sdk.CUAddress) CLIContext
- func (ctx CLIContext) WithFromName(name string) CLIContext
- func (ctx CLIContext) WithGenerateOnly(generateOnly bool) CLIContext
- func (ctx CLIContext) WithHeight(height int64) CLIContext
- func (ctx CLIContext) WithNodeURI(nodeURI string) CLIContext
- func (ctx CLIContext) WithOutput(w io.Writer) CLIContext
- func (ctx CLIContext) WithSimulation(simulate bool) CLIContext
- func (ctx CLIContext) WithTrustNode(trustNode bool) CLIContext
- func (ctx CLIContext) WithUseLedger(useLedger bool) CLIContext
- func (ctx CLIContext) WithVerifier(verifier tmlite.Verifier) CLIContext
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func ErrInvalidAccount ¶
ErrInvalidAccount returns a standardized error reflecting that a given CU address does not exist.
func ErrVerifyCommit ¶
ErrVerifyCommit returns a common error reflecting that the blockchain commit at a given height can't be verified. The reason is that the base checkpoint of the certifier is newer than the given height
Types ¶
type CLIContext ¶
type CLIContext struct { Codec *codec.Codec Client rpcclient.Client Keybase cryptokeys.Keybase Output io.Writer OutputFormat string Height int64 NodeURI string From string TrustNode bool UseLedger bool BroadcastMode string Verifier tmlite.Verifier VerifierHome string Simulate bool GenerateOnly bool FromAddress sdk.CUAddress FromName string Indent bool SkipConfirm bool }
CLIContext implements a typical CLI context created in SDK modules for transaction handling and queries.
func NewCLIContext ¶
func NewCLIContext() CLIContext
NewCLIContext returns a new initialized CLIContext with parameters from the command line using Viper.
func NewCLIContextWithFrom ¶
func NewCLIContextWithFrom(from string) CLIContext
NewCLIContextWithFrom returns a new initialized CLIContext with parameters from the command line using Viper. It takes a key name or address and populates the FromName and FromAddress field accordingly.
func (CLIContext) BroadcastTx ¶
func (ctx CLIContext) BroadcastTx(txBytes []byte) (res sdk.TxResponse, err error)
BroadcastTx broadcasts a transactions either synchronously or asynchronously based on the context parameters. The result of the broadcast is parsed into an intermediate structure which is logged if the context has a logger defined.
func (CLIContext) BroadcastTxAsync ¶
func (ctx CLIContext) BroadcastTxAsync(txBytes []byte) (sdk.TxResponse, error)
BroadcastTxAsync broadcasts transaction bytes to a Tendermint node asynchronously (i.e. returns immediately).
func (CLIContext) BroadcastTxCommit ¶
func (ctx CLIContext) BroadcastTxCommit(txBytes []byte) (sdk.TxResponse, error)
BroadcastTxCommit broadcasts transaction bytes to a Tendermint node and waits for a commit. An error is only returned if there is no RPC node connection or if broadcasting fails.
NOTE: This should ideally not be used as the request may timeout but the tx may still be included in a block. Use BroadcastTxAsync or BroadcastTxSync instead.
func (CLIContext) BroadcastTxSync ¶
func (ctx CLIContext) BroadcastTxSync(txBytes []byte) (sdk.TxResponse, error)
BroadcastTxSync broadcasts transaction bytes to a Tendermint node synchronously (i.e. returns after CheckTx execution).
func (CLIContext) GetFromAddress ¶
func (ctx CLIContext) GetFromAddress() sdk.CUAddress
GetFromAddress returns the from address from the context's name.
func (CLIContext) GetFromName ¶
func (ctx CLIContext) GetFromName() string
GetFromName returns the key name for the current context.
func (CLIContext) GetNode ¶
func (ctx CLIContext) GetNode() (rpcclient.Client, error)
GetNode returns an RPC client. If the context's client is not defined, an error is returned.
func (CLIContext) PrintOutput ¶
func (ctx CLIContext) PrintOutput(toPrint fmt.Stringer) (err error)
PrintOutput prints output while respecting output and indent flags NOTE: pass in marshalled structs that have been unmarshaled because this function will panic on marshaling errors
func (CLIContext) Query ¶
func (ctx CLIContext) Query(path string) ([]byte, int64, error)
Query performs a query to a Tendermint node with the provided path. It returns the result and height of the query upon success or an error if the query fails.
func (CLIContext) QueryStore ¶
QueryStore performs a query to a Tendermint node with the provided key and store name. It returns the result and height of the query upon success or an error if the query fails.
func (CLIContext) QuerySubspace ¶
func (ctx CLIContext) QuerySubspace(subspace []byte, storeName string) (res []sdk.KVPair, height int64, err error)
QuerySubspace performs a query to a Tendermint node with the provided store name and subspace. It returns key value pair and height of the query upon success or an error if the query fails.
func (CLIContext) QueryWithData ¶
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.
func (CLIContext) Verify ¶
func (ctx CLIContext) Verify(height int64) (tmtypes.SignedHeader, error)
Verify verifies the consensus proof at given height.
func (CLIContext) WithBroadcastMode ¶
func (ctx CLIContext) WithBroadcastMode(mode string) CLIContext
WithBroadcastMode returns a copy of the context with an updated broadcast mode.
func (CLIContext) WithClient ¶
func (ctx CLIContext) WithClient(client rpcclient.Client) CLIContext
WithClient returns a copy of the context with an updated RPC client instance.
func (CLIContext) WithCodec ¶
func (ctx CLIContext) WithCodec(cdc *codec.Codec) CLIContext
WithCodec returns a copy of the context with an updated codec.
func (CLIContext) WithFrom ¶
func (ctx CLIContext) WithFrom(from string) CLIContext
WithFrom returns a copy of the context with an updated from address or name.
func (CLIContext) WithFromAddress ¶
func (ctx CLIContext) WithFromAddress(addr sdk.CUAddress) CLIContext
WithFromAddress returns a copy of the context with an updated from CU address.
func (CLIContext) WithFromName ¶
func (ctx CLIContext) WithFromName(name string) CLIContext
WithFromName returns a copy of the context with an updated from CU name.
func (CLIContext) WithGenerateOnly ¶
func (ctx CLIContext) WithGenerateOnly(generateOnly bool) CLIContext
WithGenerateOnly returns a copy of the context with updated GenerateOnly value
func (CLIContext) WithHeight ¶
func (ctx CLIContext) WithHeight(height int64) CLIContext
WithHeight returns a copy of the context with an updated height.
func (CLIContext) WithNodeURI ¶
func (ctx CLIContext) WithNodeURI(nodeURI string) CLIContext
WithNodeURI returns a copy of the context with an updated node URI.
func (CLIContext) WithOutput ¶
func (ctx CLIContext) WithOutput(w io.Writer) CLIContext
WithOutput returns a copy of the context with an updated output writer (e.g. stdout).
func (CLIContext) WithSimulation ¶
func (ctx CLIContext) WithSimulation(simulate bool) CLIContext
WithSimulation returns a copy of the context with updated Simulate value
func (CLIContext) WithTrustNode ¶
func (ctx CLIContext) WithTrustNode(trustNode bool) CLIContext
WithTrustNode returns a copy of the context with an updated TrustNode flag.
func (CLIContext) WithUseLedger ¶
func (ctx CLIContext) WithUseLedger(useLedger bool) CLIContext
WithUseLedger returns a copy of the context with an updated UseLedger flag.
func (CLIContext) WithVerifier ¶
func (ctx CLIContext) WithVerifier(verifier tmlite.Verifier) CLIContext
WithVerifier - return a copy of the context with an updated Verifier