cosmos-sdk: Index | Files

package errors

import ""

Package errors implements custom error interfaces for cosmos-sdk.

Error declarations should be generic and cover broad range of cases. Each returned error instance can wrap a generic error declaration to provide more details.

This package provides a broad range of errors declared that fits all common cases. If an error is very specific for an extension it can be registered outside of the errors package. If it will be needed my many extensions, please consider registering it in the errors package. To create a new error instance use Register function. You must provide a unique, non zero error code and a short description, for example:

var ErrZeroDivision = errors.Register(9241, "zero division")

When returning an error, you can attach to it an additional context information by using Wrap function, for example:

   func safeDiv(val, div int) (int, err) {
	   if div == 0 {
		   return 0, errors.Wrapf(ErrZeroDivision, "cannot divide %d", val)
	   return val / div, nil

The first time an error instance is wrapped a stacktrace is attached as well. Stacktrace information can be printed using %+v and %v formats.

%s  is just the error message
%+v is the full stack trace
%v  appends a compressed [filename:line] where the error was created


Package Files

abci.go doc.go errors.go stacktrace.go


const RootCodespace = "sdk"

RootCodespace is the codespace for all errors defined in this package

const (
    // SuccessABCICode declares an ABCI response use 0 to signal that the
    // processing was successful and no error is returned.
    SuccessABCICode = 0
const UndefinedCodespace = "undefined"

UndefinedCodespace when we explicitly declare no codespace


var (

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

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

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

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

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

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

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

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

    // ErrInsufficientCoins to doc (what is the difference between ErrInsufficientFunds???)
    ErrInsufficientCoins = Register(RootCodespace, 10, "insufficient coins")

    // ErrInvalidCoins to doc
    ErrInvalidCoins = Register(RootCodespace, 11, "invalid coins")

    // ErrOutOfGas to doc
    ErrOutOfGas = Register(RootCodespace, 12, "out of gas")

    // ErrMemoTooLarge to doc
    ErrMemoTooLarge = Register(RootCodespace, 13, "memo too large")

    // ErrInsufficientFee to doc
    ErrInsufficientFee = Register(RootCodespace, 14, "insufficient fee")

    // ErrTooManySignatures to doc
    ErrTooManySignatures = Register(RootCodespace, 15, "maximum numer of signatures exceeded")

    // ErrNoSignatures to doc
    ErrNoSignatures = Register(RootCodespace, 16, "no signatures supplied")

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

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

    // ErrPanic is only set when we recover from a panic, so we know to
    // redact potentially sensitive system info
    ErrPanic = Register(UndefinedCodespace, 111222, "panic")

func ABCIError Uses

func ABCIError(codespace string, code uint32, log string) error

ABCIError will resolve an error code/log from an abci result into an error message. If the code is registered, it will map it back to the canonical error, so we can do eg. ErrNotFound.Is(err) on something we get back from an external API.

This should *only* be used in clients, not in the server side. The server (abci app / blockchain) should only refer to registered errors

func ABCIInfo Uses

func ABCIInfo(err error, debug bool) (codespace string, code uint32, log string)

ABCIInfo returns the ABCI error information as consumed by the tendermint client. Returned codespace, code, and log message should be used as a ABCI response. Any error that does not provide ABCICode information is categorized as error with code 1, codespace UndefinedCodespace When not running in a debug mode all messages of errors that do not provide ABCICode information are replaced with generic "internal error". Errors without an ABCICode information as considered internal.

func Recover Uses

func Recover(err *error)

Recover captures a panic and stop its propagation. If panic happens it is transformed into a ErrPanic instance and assigned to given error. Call this function using defer in order to work as expected.

func Redact Uses

func Redact(err error) error

Redact replace all errors that do not initialize with a weave error with a generic internal error instance. This function is supposed to hide implementation details errors and leave only those that weave framework originates.

func WithType Uses

func WithType(err error, obj interface{}) error

WithType is a helper to augment an error with a corresponding type message

func Wrap Uses

func Wrap(err error, description string) error

Wrap extends given error with an additional information.

If the wrapped error does not provide ABCICode method (ie. stdlib errors), it will be labeled as internal error.

If err is nil, this returns nil, avoiding the need for an if statement when wrapping a error returned at the end of a function

func Wrapf Uses

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

Wrapf extends given error with an additional information.

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

type Error Uses

type Error struct {
    // contains filtered or unexported fields

Error represents a root error.

Weave framework is using root error to categorize issues. Each instance created during the runtime should wrap one of the declared root errors. This allows error tests and returning all errors to the client in a safe manner.

All popular root errors are declared in this package. If an extension has to declare a custom root error, always use Register function to ensure error code uniqueness.

func New Uses

func New(codespace string, code uint32, desc string) *Error

func Register Uses

func Register(codespace string, code uint32, description string) *Error

Register returns an error instance that should be used as the base for creating error instances during runtime.

Popular root errors are declared in this package, but extensions may want to declare custom codes. This function ensures that no error code is used twice. Attempt to reuse an error code results in panic.

Use this function only during a program startup phase.

func (Error) ABCICode Uses

func (e Error) ABCICode() uint32

func (Error) Codespace Uses

func (e Error) Codespace() string

func (Error) Error Uses

func (e Error) Error() string

func (*Error) Is Uses

func (e *Error) Is(err error) bool

Is check if given error instance is of a given kind/type. This involves unwrapping given error using the Cause method if available.

Package errors imports 7 packages (graph) and is imported by 6 packages. Updated 2019-11-08. Refresh now. Tools for package owners.