Struct RpcResponse 

pub struct RpcResponse {
    pub jsonrpc: String,
    pub id: Option<String>,
    pub payload: RpcResponsePayload,
}

Response to a RpcRequest. Exactly one of result or error is populated — see RpcResponsePayload.

Modelled as a struct with a flattened payload enum (rather than two field options) so the type system enforces the spec’s “exactly one of” requirement: it’s impossible to construct a response that has both, or neither.

id is Option<String> because JSON-RPC 2.0 mandates null for errors that fire BEFORE the request id can be parsed — super::error::ErrorKind::ParseError (the body wasn’t valid JSON at all) and super::error::ErrorKind::InvalidRequest (envelope rejected). RpcResponse::err_anonymous is the dedicated constructor for that case; the happy-path Self::ok / Self::err keep the String ergonomic.

Fields

jsonrpc: String

id: Option<String>

payload: RpcResponsePayload

Implementations

impl RpcResponse

pub fn ok<R: Serialize>( id: impl Into<String>, result: &R, ) -> Result<Self, Error>

Build a success response for a given request id from a typed result. R = () is encoded as JSON null, matching SPEC §2.12.7’s {"result":null} for void method returns.

pub fn err(id: impl Into<String>, error: RpcError) -> Self

Build an error response correlated to a known request id.

pub fn err_anonymous(error: RpcError) -> Self

Build an error response with id: null — the JSON-RPC 2.0 shape for errors that fire before the request id can be parsed (ParseError on un-decodable JSON; InvalidRequest on an envelope missing required fields). Distinct from Self::err so the type system makes “I don’t have an id to correlate” an explicit choice.

Trait Implementations

impl Clone for RpcResponse

fn clone(&self) -> RpcResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RpcResponse

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RpcResponse

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for RpcResponse

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for RpcResponse

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

where __S: Serializer,

Serialize this value into the given Serde serializer.