rpc-router 0.2.0

JSON RPC Router Library
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
48
49
50
51
52
53
54
55
56

use crate::RpcId;
use serde::Serialize;
use serde_json::Value;
use serde_with::{serde_as, DisplayFromStr};

/// Error type for failures during `RpcResponse` parsing or validation.
#[serde_as]
#[derive(Debug, Serialize)]
pub enum RpcResponseParsingError {
	InvalidJsonRpcVersion {
		id: Option<RpcId>,
		expected: &'static str,
		actual: Option<Value>,
	},
	MissingJsonRpcVersion {
		id: Option<RpcId>,
	},
	MissingId,
	InvalidId(#[serde_as(as = "DisplayFromStr")] crate::RpcRequestParsingError),
	MissingResultAndError {
		id: RpcId,
	},
	BothResultAndError {
		id: RpcId,
	},
	InvalidErrorObject(#[serde_as(as = "DisplayFromStr")] serde_json::Error),
	Serde(#[serde_as(as = "DisplayFromStr")] serde_json::Error),
}

// region:    --- Error Boilerplate

impl core::fmt::Display for RpcResponseParsingError {
	fn fmt(&self, fmt: &mut core::fmt::Formatter) -> core::result::Result<(), core::fmt::Error> {
		write!(fmt, "{self:?}")
	}
}

impl std::error::Error for RpcResponseParsingError {}

// endregion: --- Error Boilerplate

// region:    --- Froms

impl From<serde_json::Error> for RpcResponseParsingError {
	fn from(e: serde_json::Error) -> Self {
		RpcResponseParsingError::Serde(e)
	}
}

impl From<crate::RpcRequestParsingError> for RpcResponseParsingError {
	fn from(e: crate::RpcRequestParsingError) -> Self {
		RpcResponseParsingError::InvalidId(e)
	}
}

// endregion: --- Froms