Documentation
¶
Index ¶
- Constants
- Variables
- func MSMError(codespace string, code uint32, log string) error
- func MSMInfo(err error, debug bool) (codespace string, code uint32, log string)
- func QueryResult(err error) msm.ResponseQuery
- func Recover(err *error)
- func Redact(err error) error
- func ResponseCheckTx(err error, gw, gu uint64, debug bool) msm.ResponseCheckTx
- func ResponseDeliverTx(err error, gw, gu uint64, debug bool) msm.ResponseDeliverTx
- func WithType(err error, obj interface{}) error
- func Wrap(err error, description string) error
- func Wrapf(err error, format string, args ...interface{}) error
- type Error
Examples ¶
Constants ¶
const RootCodespace = "sdk"
RootCodespace is the codespace for all errors defined in this package
const ( // SuccessMSMCode declares an MSM response use 0 to signal that the // processing was successful and no error is returned. SuccessMSMCode = 0 )
const UndefinedCodespace = "undefined"
UndefinedCodespace when we explicitly declare no codespace
Variables ¶
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") // 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") // ErrInvalidCoins to doc ErrInvalidCoins = Register(RootCodespace, 10, "invalid coins") // ErrOutOfGas to doc ErrOutOfGas = Register(RootCodespace, 11, "out of gas") // ErrMemoTooLarge to doc ErrMemoTooLarge = Register(RootCodespace, 12, "memo too large") // ErrInsufficientFee to doc ErrInsufficientFee = Register(RootCodespace, 13, "insufficient fee") // ErrTooManySignatures to doc ErrTooManySignatures = Register(RootCodespace, 14, "maximum number of signatures exceeded") // ErrNoSignatures to doc ErrNoSignatures = Register(RootCodespace, 15, "no signatures supplied") // ErrJSONMarshal defines an MSM typed JSON marshalling error ErrJSONMarshal = Register(RootCodespace, 16, "failed to marshal JSON bytes") // ErrJSONUnmarshal defines an MSM typed JSON unmarshalling error ErrJSONUnmarshal = Register(RootCodespace, 17, "failed to unmarshal JSON bytes") // ErrInvalidRequest defines an MSM typed error where the request contains // invalid data. ErrInvalidRequest = Register(RootCodespace, 18, "invalid request") // ErrTxInMempoolCache defines an MSM typed error where a tx already exists // in the mempool. ErrTxInMempoolCache = Register(RootCodespace, 19, "tx already in mempool") // ErrMempoolIsFull defines an MSM typed error where the mempool is full. ErrMempoolIsFull = Register(RootCodespace, 20, "mempool is full") // ErrTxTooLarge defines an MSM typed error where tx is too large. ErrTxTooLarge = Register(RootCodespace, 21, "tx too large") // ErrKeyNotFound defines an error when the key doesn't exist ErrKeyNotFound = Register(RootCodespace, 22, "key not found") // ErrWrongPassword defines an error when the key password is invalid. ErrWrongPassword = Register(RootCodespace, 23, "invalid account password") // ErrorInvalidSigner defines an error when the tx intended signer does not match the given signer. ErrorInvalidSigner = Register(RootCodespace, 24, "tx intended signer does not match the given signer") // ErrorInvalidGasAdjustment defines an error for an invalid gas adjustment ErrorInvalidGasAdjustment = Register(RootCodespace, 25, "invalid gas adjustment") // ErrInvalidHeight defines an error for an invalid height ErrInvalidHeight = Register(RootCodespace, 26, "invalid height") // ErrInvalidVersion defines a general error for an invalid version ErrInvalidVersion = Register(RootCodespace, 27, "invalid version") // ErrInvalidChainID defines an error when the chain-id is invalid. ErrInvalidChainID = Register(RootCodespace, 28, "invalid chain-id") // ErrInvalidType defines an error an invalid type. ErrInvalidType = Register(RootCodespace, 29, "invalid type") // ErrTxTimeoutHeight defines an error for when a tx is rejected out due to an // explicitly set timeout height. ErrTxTimeoutHeight = Register(RootCodespace, 30, "tx timeout height") // ErrUnknownExtensionOptions defines an error for unknown extension options. ErrUnknownExtensionOptions = Register(RootCodespace, 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(RootCodespace, 32, "incorrect account sequence") // ErrPackAny defines an error when packing a protobuf message to Any fails. ErrPackAny = Register(RootCodespace, 33, "failed packing protobuf message to Any") // ErrUnpackAny defines an error when unpacking a protobuf message from Any fails. ErrUnpackAny = Register(RootCodespace, 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(RootCodespace, 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(RootCodespace, 36, "conflict") // ErrNotSupported is returned when we call a branch of a code which is currently not // supported. ErrNotSupported = Register(RootCodespace, 37, "feature not supported") // ErrPanic is only set when we recover from a panic, so we know to // redact potentially sensitive system info ErrPanic = Register(UndefinedCodespace, 111222, "panic") )
Functions ¶
func MSMError ¶
MSMError will resolve an error code/log from an msm 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 (msm app / blockchain) should only refer to registered errors
func MSMInfo ¶
MSMInfo returns the MSM error information as consumed by the augusteum client. Returned codespace, code, and log message should be used as a MSM response. Any error that does not provide MSMCode 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 MSMCode information are replaced with generic "internal error". Errors without an MSMCode information as considered internal.
func QueryResult ¶
func QueryResult(err error) msm.ResponseQuery
QueryResult returns a ResponseQuery from an error. It will try to parse MSM info from the error.
func Recover ¶
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 ¶
Redact replaces an error that is not initialized as an MSM Error with a generic internal error instance. If the error is an MSM Error, that error is simply returned.
func ResponseCheckTx ¶
func ResponseCheckTx(err error, gw, gu uint64, debug bool) msm.ResponseCheckTx
ResponseCheckTx returns an MSM ResponseCheckTx object with fields filled in from the given error and gas values.
func ResponseDeliverTx ¶
func ResponseDeliverTx(err error, gw, gu uint64, debug bool) msm.ResponseDeliverTx
ResponseDeliverTx returns an MSM ResponseDeliverTx object with fields filled in from the given error and gas values.
func Wrap ¶
Wrap extends given error with an additional information.
If the wrapped error does not provide MSMCode 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
Example ¶
err1 := Wrap(ErrInsufficientFunds, "90 is smaller than 100") err2 := errors.Wrap(ErrInsufficientFunds, "90 is smaller than 100") fmt.Println(err1.Error()) fmt.Println(err2.Error())
Output: 90 is smaller than 100: insufficient funds 90 is smaller than 100: insufficient funds
func Wrapf ¶
Wrapf extends given error with an additional information.
This function works like Wrap function with additional functionality of formatting the input as specified.
Example ¶
err1 := Wrap(ErrInsufficientFunds, "90 is smaller than 100") err2 := errors.Wrap(ErrInsufficientFunds, "90 is smaller than 100") fmt.Println(err1.Error()) fmt.Println(err2.Error())
Output: 90 is smaller than 100: insufficient funds 90 is smaller than 100: insufficient funds
Types ¶
type Error ¶
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 Register ¶
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.
Source Files