Enum Error 

#[non_exhaustive]
pub enum Error {
    Transport(Box<Error>),
    Connection(String),
    Status(Box<Status>),
    Http {
        status: u16,
        body: String,
    },
    Json(Box<Error>),
    CommandRejected {
        code: String,
        message: String,
    },
    Auth(String),
    InvalidRequest(String),
    UnexpectedResponse(String),
    Timeout,
}

The single error type for the whole Canton Rust SDK.

It is #[non_exhaustive] so new variants can be added without a breaking change. Large upstream error types are boxed so that Result<T, Error> stays cheap to move on the happy path.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Transport(Box<Error>)

gRPC transport failure (DNS, TCP, TLS, HTTP/2). Retriable.

Connection(String)

A non-gRPC connection failure (e.g. an HTTP/JSON or token-endpoint request that could not be sent). Retriable.

Status(Box<Status>)

The server returned a gRPC status. The full tonic::Status is kept so callers can inspect the code, message, and metadata; see Error::code.

Http

A non-success HTTP response from the JSON API or a token endpoint. Retriable for transient status codes (see Error::is_retriable).

Fields

status: u16

The HTTP status code.

body: String

The response body (truncated by the caller if large).

Json(Box<Error>)

JSON (de)serialization error.

CommandRejected

A command was rejected by the ledger for business/interpretation reasons (as opposed to a transport failure). Not retriable.

Fields

code: String

The rejection status code.

message: String

The rejection message.

Auth(String)

Authentication/authorization was rejected (bad or expired credentials). Not retriable — a token-transport failure surfaces as Error::Connection or Error::Http instead.

InvalidRequest(String)

A request precondition or configuration value was invalid before send.

UnexpectedResponse(String)

The server’s response was well-formed at the transport level but not what the protocol expects (e.g. a missing field, or a stream that ended unexpectedly). Not a caller-input error.

Timeout

The operation exceeded its configured deadline. Retriable.

Implementations

impl Error

pub fn code(&self) -> Option<Code>

The gRPC status code, if this error originates from a gRPC status.

pub fn is_retriable(&self) -> bool

Whether retrying the operation may succeed.

Transient conditions are retriable: timeouts, transport/connection failures, the transient gRPC codes (Unavailable, DeadlineExceeded, ResourceExhausted, Aborted), and transient HTTP status codes (408, 429, 5xx). Everything else — invalid input, auth rejection, command rejection, NotFound/AlreadyExists, deserialization — is not.

pub fn error_info(&self) -> Option<ErrorInfo>

The structured google.rpc.ErrorInfo carried by a gRPC status, when present. Canton populates this with the machine-readable error reason (e.g. DUPLICATE_COMMAND) plus context metadata — prefer it over string-matching Display output. Returns None for non-status errors or statuses without an ErrorInfo detail.

Trait Implementations

impl Debug for Error

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Error

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Status> for Error

fn from(status: Status) -> Self

Converts to this type from the input type.