errors

Documentation

Overview

Package errors defines methods to handle specific error in cosmos blockchain like critical errors

Package errors aliases both the `cosmos-sdk/types/errors.go` and `cosmossdk.io/errors` packages to give access to cosmos-sdk error definitions and functions with a single import path.

Index

• Constants
• Variables
• func Critical(description string) error
• func Criticalf(format string, args ...interface{}) error
• type Error

Constants

const Codespace = "ignite"

Codespace is the codespace for all errors defined in this package

Variables

var (
	SuccessABCICode    = sdkerrors.SuccessABCICode
	ABCIInfo           = sdkerrors.ABCIInfo
	UndefinedCodespace = sdkerrors.UndefinedCodespace
	Register           = sdkerrors.Register
	ABCIError          = sdkerrors.ABCIError
	New                = sdkerrors.New
	Wrap               = sdkerrors.Wrap
	Wrapf              = sdkerrors.Wrapf
	Recover            = sdkerrors.Recover
	WithType           = sdkerrors.WithType
	IsOf               = sdkerrors.IsOf
	AssertNil          = sdkerrors.AssertNil
)

Type Aliases to sdk errors module

var (
	// ErrTxDecode is returned if we cannot parse a transaction
	ErrTxDecode = Register(Codespace, 2, "tx parse error")

	// ErrInvalidSequence is used the sequence number (nonce) is incorrect
	// for the signature
	ErrInvalidSequence = Register(Codespace, 3, "invalid sequence")

	// ErrUnauthorized is used whenever a request without sufficient
	// authorization is handled.
	ErrUnauthorized = Register(Codespace, 4, "unauthorized")

	// ErrInsufficientFunds is used when the account cannot pay requested amount.
	ErrInsufficientFunds = Register(Codespace, 5, "insufficient funds")

	// ErrUnknownRequest to doc
	ErrUnknownRequest = Register(Codespace, 6, "unknown request")

	// ErrInvalidAddress to doc
	ErrInvalidAddress = Register(Codespace, 7, "invalid address")

	// ErrInvalidPubKey to doc
	ErrInvalidPubKey = Register(Codespace, 8, "invalid pubkey")

	// ErrUnknownAddress to doc
	ErrUnknownAddress = Register(Codespace, 9, "unknown address")

	// ErrInvalidCoins to doc
	ErrInvalidCoins = Register(Codespace, 10, "invalid coins")

	// ErrOutOfGas to doc
	ErrOutOfGas = Register(Codespace, 11, "out of gas")

	// ErrMemoTooLarge to doc
	ErrMemoTooLarge = Register(Codespace, 12, "memo too large")

	// ErrInsufficientFee to doc
	ErrInsufficientFee = Register(Codespace, 13, "insufficient fee")

	// ErrTooManySignatures to doc
	ErrTooManySignatures = Register(Codespace, 14, "maximum number of signatures exceeded")

	// ErrNoSignatures to doc
	ErrNoSignatures = Register(Codespace, 15, "no signatures supplied")

	// ErrJSONMarshal defines an ABCI typed JSON marshalling error
	ErrJSONMarshal = Register(Codespace, 16, "failed to marshal JSON bytes")

	// ErrJSONUnmarshal defines an ABCI typed JSON unmarshalling error
	ErrJSONUnmarshal = Register(Codespace, 17, "failed to unmarshal JSON bytes")

	// ErrInvalidRequest defines an ABCI typed error where the request contains
	// invalid data.
	ErrInvalidRequest = Register(Codespace, 18, "invalid request")

	// ErrTxInMempoolCache defines an ABCI typed error where a tx already exists
	// in the mempool.
	ErrTxInMempoolCache = Register(Codespace, 19, "tx already in mempool")

	// ErrMempoolIsFull defines an ABCI typed error where the mempool is full.
	ErrMempoolIsFull = Register(Codespace, 20, "mempool is full")

	// ErrTxTooLarge defines an ABCI typed error where tx is too large.
	ErrTxTooLarge = Register(Codespace, 21, "tx too large")

	// ErrKeyNotFound defines an error when the key doesn't exist
	ErrKeyNotFound = Register(Codespace, 22, "key not found")

	// ErrWrongPassword defines an error when the key password is invalid.
	ErrWrongPassword = Register(Codespace, 23, "invalid account password")

	// ErrorInvalidSigner defines an error when the tx intended signer does not match the given signer.
	ErrorInvalidSigner = Register(Codespace, 24, "tx intended signer does not match the given signer")

	// ErrorInvalidGasAdjustment defines an error for an invalid gas adjustment
	ErrorInvalidGasAdjustment = Register(Codespace, 25, "invalid gas adjustment")

	// ErrInvalidHeight defines an error for an invalid height
	ErrInvalidHeight = Register(Codespace, 26, "invalid height")

	// ErrInvalidVersion defines a general error for an invalid version
	ErrInvalidVersion = Register(Codespace, 27, "invalid version")

	// ErrInvalidChainID defines an error when the chain-id is invalid.
	ErrInvalidChainID = Register(Codespace, 28, "invalid chain-id")

	// ErrInvalidType defines an error an invalid type.
	ErrInvalidType = Register(Codespace, 29, "invalid type")

	// ErrTxTimeoutHeight defines an error for when a tx is rejected out due to an
	// explicitly set timeout height.
	ErrTxTimeoutHeight = Register(Codespace, 30, "tx timeout height")

	// ErrUnknownExtensionOptions defines an error for unknown extension options.
	ErrUnknownExtensionOptions = Register(Codespace, 31, "unknown extension options")

	// ErrWrongSequence defines an error where the account sequence defined in
	// the signer info doesn't match the account's actual sequence number.
	ErrWrongSequence = Register(Codespace, 32, "incorrect account sequence")

	// ErrPackAny defines an error when packing a protobuf message to Any fails.
	ErrPackAny = Register(Codespace, 33, "failed packing protobuf message to Any")

	// ErrUnpackAny defines an error when unpacking a protobuf message from Any fails.
	ErrUnpackAny = Register(Codespace, 34, "failed unpacking protobuf message from Any")

	// ErrLogic defines an internal logic error, e.g. an invariant or assertion
	// that is violated. It is a programmer error, not a user-facing error.
	ErrLogic = Register(Codespace, 35, "internal logic error")

	// ErrConflict defines a conflict error, e.g. when two goroutines try to access
	// the same resource and one of them fails.
	ErrConflict = Register(Codespace, 36, "conflict")

	// ErrNotSupported is returned when we call a branch of a code which is currently not
	// supported.
	ErrNotSupported = Register(Codespace, 37, "feature not supported")

	// ErrNotFound defines an error when requested entity doesn't exist in the state.
	ErrNotFound = Register(Codespace, 38, "not found")

	// ErrIO should be used to wrap internal errors caused by external operation.
	// Examples: not DB domain error, file writing etc...
	ErrIO = Register(Codespace, 39, "Internal IO error")

	// ErrAppConfig defines an error occurred if min-gas-prices field in BaseConfig is empty.
	ErrAppConfig = Register(Codespace, 40, "error in app.toml")

	// ErrInvalidGasLimit defines an error when an invalid GasWanted value is
	// supplied.
	ErrInvalidGasLimit = Register(Codespace, 41, "invalid gas limit")

	// ErrPanic is only set when we recover from a panic, so we know to
	// redact potentially sensitive system info
	ErrPanic = sdkerrors.ErrPanic
)

var ErrCritical = Register(codespace, 2, "the state of the blockchain is inconsistent or an invariant is broken")

Functions

func Critical

func Critical(description string) error

Critical handles and/or returns an error in case a critical error has been encountered: - Inconsistent state - Broken invariant

func Criticalf

func Criticalf(format string, args ...interface{}) error

Criticalf extends a critical error with additional information.

This function works like the Critical function with additional functionality of formatting the input as specified.

Types

type Error

type Error = sdkerrors.Error

Error type alias for errorsmod.Error