Struct ServiceError 

pub struct ServiceError {
    pub status: RpcStatus,
    pub code: u32,
    pub message: String,
}

Error type that maps to RPC response errors

Services can either use this directly or define their own error types that implement Into<ServiceError>.

Fields

status: RpcStatus

RPC status category

code: u32

Error code (maps to RpcStatus or custom service codes)

message: String

Human-readable error message

Implementations

impl ServiceError

pub fn new(status: RpcStatus, code: u32, message: impl Into<String>) -> Self

Create a new service error

pub fn invalid_request(message: impl Into<String>) -> Self

Invalid request (bad input, validation failed) - code 400

pub fn not_found(message: impl Into<String>) -> Self

Resource not found - code 404

pub fn unauthorized(message: impl Into<String>) -> Self

Unauthorized (authentication required) - code 401

pub fn forbidden(message: impl Into<String>) -> Self

Forbidden (authenticated but not allowed) - code 403

pub fn internal(message: impl Into<String>) -> Self

Internal error (something went wrong) - code 500

pub fn unavailable(message: impl Into<String>) -> Self

Service unavailable - code 503

pub fn timeout(message: impl Into<String>) -> Self

Timeout - code 504

pub fn custom(code: u32, message: impl Into<String>) -> Self

Custom service-specific error

Use codes starting from your service’s allocated range. See CLAUDE.md for error code ranges:

• 1000-1999: Gateway errors
• 2000-2999: Auth errors
• 3000-3999: User service errors
• 4000-4999: Payment service errors

pub fn to_proto(&self) -> RpcError

Convert to proto RpcError

Trait Implementations

impl Clone for ServiceError

fn clone(&self) -> ServiceError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServiceError

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

Formats the value using the given formatter.

impl Display for ServiceError

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

Formats the value using the given formatter.

impl Error for ServiceError

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 ServiceError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ServiceError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ServiceError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl IntoServiceError for ServiceError

fn into_service_error(self) -> ServiceError

Convert to ServiceError