json-rpc-rs 0.3.0

A framework-agnostic JSON-RPC 2.0 handler for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

//! Error types for the JSON-RPC implementation.
//!
//! This module defines internal errors that can occur during JSON-RPC processing,
//! distinct from the JSON-RPC wire format errors defined in the `types` module.

/// Internal errors that can occur during JSON-RPC processing.
///
/// These are implementation-level errors, separate from the JSON-RPC protocol
/// error objects that are sent over the wire (defined in `types::Error`).
#[derive(Debug, thiserror::Error)]
pub enum Error {
    /// Protocol-level error, such as invalid method or parameters.
    #[error("Protocol error: {0}")]
    ProtocolError(String),

    /// JSON-RPC error with specific code and message.
    #[error("JSON-RPC error: code={code}, message={message}")]
    RpcError { code: i32, message: String },

    /// JSON parsing error.
    #[error("Protocol error: {0}")]
    ParseError(#[from] serde_json::Error),

    /// Invalid JSON-RPC request error.
    #[error("Invalid Request: {0}")]
    InvalidRequest(String),
}

impl Error {
    /// Create a new protocol error.
    pub fn protocol(message: impl Into<String>) -> Self {
        Self::ProtocolError(message.into())
    }

    /// Create a new JSON-RPC error with a specific code and message.
    pub fn rpc(code: i32, message: impl Into<String>) -> Self {
        Self::RpcError {
            code,
            message: message.into(),
        }
    }

    /// Create a new Invalid Request error.
    pub fn invalid_request(message: impl Into<String>) -> Self {
        Self::InvalidRequest(message.into())
    }
}