sui-rpc 0.3.1

RPC interface definitions and client for the Sui Sdk
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

/// Interceptor used to add additional headers to a Request
#[derive(Clone, Debug, Default)]
pub struct HeadersInterceptor {
    headers: tonic::metadata::MetadataMap,
}

impl HeadersInterceptor {
    /// Create a new, empty `HeadersInterceptor`.
    pub fn new() -> Self {
        Self::default()
    }

    /// Return reference to the internal `MetadataMap`.
    pub fn headers(&self) -> &tonic::metadata::MetadataMap {
        &self.headers
    }

    /// Get mutable access to the internal `MetadataMap` for modification.
    pub fn headers_mut(&mut self) -> &mut tonic::metadata::MetadataMap {
        &mut self.headers
    }

    /// Enable HTTP basic authentication with a username and optional password.
    pub fn basic_auth<U, P>(&mut self, username: U, password: Option<P>)
    where
        U: std::fmt::Display,
        P: std::fmt::Display,
    {
        use base64::prelude::BASE64_STANDARD;
        use base64::write::EncoderWriter;
        use std::io::Write;

        let mut buf = b"Basic ".to_vec();
        {
            let mut encoder = EncoderWriter::new(&mut buf, &BASE64_STANDARD);
            let _ = write!(encoder, "{username}:");
            if let Some(password) = password {
                let _ = write!(encoder, "{password}");
            }
        }
        let mut header = tonic::metadata::MetadataValue::try_from(buf)
            .expect("base64 is always valid HeaderValue");
        header.set_sensitive(true);

        self.headers
            .insert(http::header::AUTHORIZATION.as_str(), header);
    }

    /// Enable HTTP bearer authentication.
    pub fn bearer_auth<T>(&mut self, token: T)
    where
        T: std::fmt::Display,
    {
        let header_value = format!("Bearer {token}");
        let mut header = tonic::metadata::MetadataValue::try_from(header_value)
            .expect("token is always valid HeaderValue");
        header.set_sensitive(true);

        self.headers
            .insert(http::header::AUTHORIZATION.as_str(), header);
    }
}

impl tonic::service::Interceptor for &HeadersInterceptor {
    fn call(
        &mut self,
        mut request: tonic::Request<()>,
    ) -> std::result::Result<tonic::Request<()>, tonic::Status> {
        if !self.headers.is_empty() {
            request
                .metadata_mut()
                .as_mut()
                .extend(self.headers.clone().into_headers());
        }
        Ok(request)
    }
}

impl tonic::service::Interceptor for HeadersInterceptor {
    fn call(
        &mut self,
        request: tonic::Request<()>,
    ) -> std::result::Result<tonic::Request<()>, tonic::Status> {
        (&*self).call(request)
    }
}