Struct RemoteQueryFailure 

pub struct RemoteQueryFailure { /* private fields */ }

One structured remote failure bound to its request.

Implementations

impl RemoteQueryFailure

pub fn new(nonce: Option<String>, diagnostic: &Diagnostic) -> Self

Bind one structured diagnostic to the request nonce.

pub fn bound( nonce: impl Into<String>, request: &RemoteRequestFingerprint, diagnostic: &Diagnostic, ) -> Self

Bind one structured diagnostic to the nonce and the exact request.

pub fn verify_binding( &self, expected_nonce: &str, expected_request: &RemoteRequestFingerprint, ) -> Result<(), Diagnostic>

Verify this failure’s binding to the request the caller sent.

Both the nonce and whole-request digest are mandatory on a reply to a valid request. Pre-decode transport failures use a separate channel; an unbound envelope is never treated as request-correlated evidence.

pub fn encode_signed( &self, advertisement: &RemoteCapabilitiesFingerprint, signer: &impl RemoteReplySigner, ) -> Result<Vec<u8>, Diagnostic>

Encode one authenticated outer reply using the exact trusted advertisement.

pub fn encode_signed_or_fallback( &self, advertisement: &RemoteCapabilitiesFingerprint, signer: &impl RemoteReplySigner, ) -> Vec<u8>

Encode an authenticated failure, replacing an unencodable diagnostic with a fixed bounded internal failure while preserving safe bindings.

Server transports use this path so production failures can never collapse to empty or unsigned bytes merely because an upstream error message exceeded a codec ceiling.

pub fn decode_payload(bytes: &[u8]) -> Result<Self, Diagnostic>

Decode an already authenticated failure payload.

pub fn diagnostic(&self) -> Result<Diagnostic, Diagnostic>

Rebuild the structured diagnostic.

pub fn nonce(&self) -> Option<&str>

Return the echoed request nonce, when the request decoded far enough.

Trait Implementations

impl Clone for RemoteQueryFailure

fn clone(&self) -> RemoteQueryFailure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RemoteQueryFailure

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RemoteQueryFailure

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for RemoteQueryFailure

impl PartialEq for RemoteQueryFailure

fn eq(&self, other: &RemoteQueryFailure) -> bool

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RemoteQueryFailure

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RemoteQueryFailure