Struct JsonRpcError

pub struct JsonRpcError {
    pub code: i32,
    pub message: String,
    pub data: Option<HashMap<String, Value>>,
}

JSON-RPC Error

Represents an error in a JSON-RPC response.

Example

{
  "code": -32602,
  "message": "Invalid parameters",
  "data": {
    "details": "The 'id' parameter is required"
  }
}

Standard Error Codes

• -32700: Parse error - Invalid JSON payload
• -32600: Invalid Request - Request payload validation error
• -32601: Method Not Found - Requested method does not exist
• -32602: Invalid Parameters - Invalid method parameters
• -32603: Internal Error - Internal JSON-RPC error

Custom Error Codes

• -32001: Task Not Found - The requested task wasn’t found
• -32002: Task Cannot Be Canceled - The task cannot be canceled
• -32003: Push Notification Error - Push notification is not supported or error occurred
• -32004: Operation Not Supported - The requested operation is not supported

Fields

code: i32

message: String

data: Option<HashMap<String, Value>>

Implementations

impl JsonRpcError

pub fn parse_error<T: Display>(error: T) -> Self

Creates a parse error (code -32700) Use this for JSON parsing errors or other syntax errors

pub fn invalid_request<T: Display>(error: T) -> Self

Creates an invalid request error (code -32600) Use this when the JSON-RPC request doesn’t follow protocol requirements

pub fn method_not_found<T: Display>(method: T) -> Self

Creates a method not found error (code -32601) Use this when the requested method does not exist

pub fn invalid_parameters<T: Display>(error: T) -> Self

Creates an invalid parameters error (code -32602) Use this when method parameters are invalid

pub fn internal_error<T: Display>(error: T) -> Self

Creates an internal error (code -32603) Use this for general internal JSON-RPC errors

pub fn serialization<T: Display>(error: T) -> Self

Creates a serialization error (code -32603) Use this for errors during JSON serialization

pub fn task<T: Display>(error: T) -> Self

Creates a task error (code -32603) Use this for general task processing errors

pub fn task_not_found<T: Display>(task_id: T) -> Self

Creates a task not found error (code -32001) Use this when a requested task is not found

pub fn task_cannot_be_canceled<T: Display>(task_id: T) -> Self

Creates a task cannot be canceled error (code -32002) Use this when a task cannot be canceled

pub fn push_notification<T: Display>(error: T) -> Self

Creates a push notification error (code -32003) Use this for push notification errors

pub fn task_not_cancelable<T: Display>(error: T) -> Self

Creates a task not cancelable error (code -32002) Use this when a task is in a final state and cannot be canceled

pub fn unsupported_operation<T: Display>(error: T) -> Self

Creates an unsupported operation error (code -32004) Use this when the requested operation is not supported

pub fn content_type_not_supported<T: Display>(error: T) -> Self

Creates a content type not supported error (code -32005) Use this when there’s a mismatch in supported content types

pub fn operation_not_supported<T: Display>(operation: T) -> Self

Creates an operation not supported error (code -32004) Use this when a requested operation is not supported

Trait Implementations

impl Clone for JsonRpcError

fn clone(&self) -> JsonRpcError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JsonRpcError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JsonRpcError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Error> for JsonRpcError

Convert std::io::Error to JsonRpcError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for JsonRpcError

Convert hyper::Error to JsonRpcError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for JsonRpcError

Convert ClientError to JsonRpcError

fn from(err: ClientError) -> Self

Converts to this type from the input type.

impl From<Error> for JsonRpcError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<InvalidUri> for JsonRpcError

Convert InvalidUri to JsonRpcError

fn from(err: InvalidUri) -> Self

Converts to this type from the input type.

impl From<JsonRpcError> for Error

Convert JsonRpcError to ServerError

fn from(err: JsonRpcError) -> Self

Converts to this type from the input type.

impl From<JsonRpcError> for Error

Convert JsonRpcError to ClientError

fn from(err: JsonRpcError) -> Self

Converts to this type from the input type.

impl From<PushNotificationError> for JsonRpcError

Convert PushNotificationError to JsonRpcError

fn from(err: PushNotificationError) -> Self

Converts to this type from the input type.

impl From<TaskError> for JsonRpcError

Convert TaskError to JsonRpcError for server-side error handling

fn from(err: TaskError) -> Self

Converts to this type from the input type.

impl From<TaskManagerError> for JsonRpcError

fn from(error: TaskManagerError) -> Self

Converts to this type from the input type.

impl From<UrlValidationError> for JsonRpcError

Convert UrlValidationError to JsonRpcError

fn from(err: UrlValidationError) -> Self

Converts to this type from the input type.

impl Serialize for JsonRpcError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.