Struct JsonRpcRequest 

pub struct JsonRpcRequest {
    pub jsonrpc: Cow<'static, str>,
    pub method: String,
    pub params: Option<Value>,
    pub id: Option<RequestId>,
}

JSON-RPC 2.0 request.

Fields

jsonrpc: Cow<'static, str>

Protocol version (always “2.0”).

method: String

Method name.

params: Option<Value>

Request parameters.

id: Option<RequestId>

Request ID (absent for notifications).

An explicit JSON null is rejected instead of being conflated with an absent member. Notifications omit id entirely.

Implementations

impl JsonRpcRequest

pub fn decode_strict_with_raw_params( bytes: &[u8], document_byte_limit: usize, ) -> Result<(Self, Option<String>), JsonRpcAdmissionError>

Strictly decodes one request while retaining an exact parameter-source sidecar for method-specific ingress decoding.

The returned String, when present, is the exact JSON source of the request’s params member. It is deliberately separate from JsonRpcRequest so existing public struct literals and ordinary typed request APIs retain their established shape. A consumer may only attach this source to the returned request after comparing its materialized params value; final core dispatch performs that equality check before it uses the raw source.

This applies the same bounded raw-document admission as decode_strict_jsonrpc_message, including duplicate-member rejection, before producing either the typed request or its sidecar.

impl JsonRpcRequest

pub fn new( method: impl Into<String>, params: Option<Value>, id: impl Into<RequestId>, ) -> Self

Creates a new request with the given method and parameters.

pub fn notification(method: impl Into<String>, params: Option<Value>) -> Self

Creates a notification (request without ID).

pub fn initialized_notification() -> Self

Creates the MCP lifecycle notifications/initialized notification.

Uses the spec-correct method name (notifications/initialized), avoiding the bare initialized spelling that compliant servers do not route as the lifecycle ack.

pub fn is_notification(&self) -> bool

Returns true if this is a notification (no ID).

pub fn validate(&self) -> Result<(), &'static str>

Verifies invariants that can otherwise be bypassed by constructing or mutating this public protocol type directly.

Errors

Returns an error for a non-standard protocol version or invalid ID.

Trait Implementations

impl Clone for JsonRpcRequest

fn clone(&self) -> JsonRpcRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JsonRpcRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JsonRpcRequest

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for JsonRpcRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.