Struct Request

pub struct Request<Params> {
    pub meta: RequestMeta,
    pub params: Params,
}

A JSON-RPC 2.0 request object.

This is a generic type that can be used to represent any JSON-RPC request. The Params type parameter is used to represent the parameters of the request, and the method field is used to represent the method name.

Note

The value of method should be known at compile time.

Fields

meta: RequestMeta

The request metadata (ID and method).

params: Params

The request parameters.

Implementations

impl<Params> Request<Params>

pub fn new(method: impl Into<Cow<'static, str>>, id: Id, params: Params) -> Self

Create a new Request.

pub fn is_subscription(&self) -> bool

Returns true if the request is a subscription.

pub const fn set_is_subscription(&mut self)

Indicates that the request is a non-standard subscription (i.e. not “eth_subscribe”).

pub const fn set_subscription_status(&mut self, sub: bool)

Setter for is_subscription. Indicates to RPC clients that the request triggers a stream of notifications.

pub fn map_params<NewParams>( self, map: impl FnOnce(Params) -> NewParams, ) -> Request<NewParams>

Change type of the request parameters.

pub fn map_meta<F>(self, f: F) -> Self

where F: FnOnce(RequestMeta) -> RequestMeta,

Change the metadata of the request.

impl<Params> Request<Params>

where Params: RpcSend,

pub fn box_params(self) -> PartiallySerializedRequest

Serialize the request parameters as a boxed RawValue.

Panics

If serialization of the params fails.

pub fn serialize(self) -> Result<SerializedRequest>

Serialize the request, including the request parameters.

impl<Params> Request<&Params>

where Params: ToOwned, Params::Owned: RpcSend,

pub fn into_owned_params(self) -> Request<Params::Owned>

Clone the request, including the request parameters.

impl<'a, Params> Request<Params>

where Params: AsRef<RawValue> + 'a,

pub fn try_params_as<T: DeserializeOwned>(&self) -> Result<T>

Attempt to deserialize the params.

To borrow from the params via the deserializer, use Request::try_borrow_params_as.

Returns

• Ok(T) if the params can be deserialized as T
• Err(e) if the params cannot be deserialized as T

pub fn try_borrow_params_as<T: Deserialize<'a>>(&'a self) -> Result<T>

Attempt to deserialize the params, borrowing from the params

Returns

• Ok(T) if the params can be deserialized as T
• Err(e) if the params cannot be deserialized as T

Trait Implementations

impl<Params: Clone> Clone for Request<Params>

fn clone(&self) -> Request<Params>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Params: Debug> Debug for Request<Params>

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

Formats the value using the given formatter.

impl<'de, Params> Deserialize<'de> for Request<Params>

where Params: RpcBorrow<'de>,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<Params: PartialEq> PartialEq for Request<Params>

fn eq(&self, other: &Request<Params>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<Params> Serialize for Request<Params>

where Params: RpcSend,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<Params> TryFrom<Request<Params>> for SerializedRequest

where Params: RpcSend,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Request<Params>) -> Result<Self, Self::Error>

Performs the conversion.

impl<Params: Eq> Eq for Request<Params>

impl<Params> StructuralPartialEq for Request<Params>