ursa 0.1.1-dev-1

This is the shared crypto library for Hyperledger components.
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

macro_rules! impl_bytearray {
    ($thing:ident) => {
        #[cfg_attr(feature = "wasm", wasm_bindgen)]
        impl $thing {
            #[inline]
            /// Converts the object to a raw pointer for FFI interfacing
            pub fn as_ptr(&self) -> *const u8 {
                self.0.as_slice().as_ptr()
            }

            #[inline]
            /// Converts the object to a mutable raw pointer for FFI interfacing
            pub fn as_mut_ptr(&mut self) -> *mut u8 {
                self.0.as_mut_slice().as_mut_ptr()
            }

            #[inline]
            /// Returns the length of the object as an array
            pub fn len(&self) -> usize { self.0.len() }

            #[inline]
            pub fn is_empty(&self) -> bool { self.0.is_empty() }
        }

        impl PartialEq for $thing {
            #[inline]
            fn eq(&self, other: &$thing) -> bool {
                self.0 == other.0
            }
        }

        impl Eq for $thing {}

        impl Clone for $thing {
            #[inline]
            fn clone(&self) -> $thing {
                $thing(self.0.clone())
            }
        }

        impl ::std::ops::Index<usize> for $thing {
            type Output = u8;

            #[inline]
            fn index(&self, index: usize) -> &u8 {
               &self.0[index]
            }
        }

        impl ::std::ops::Index<::std::ops::Range<usize>> for $thing {
            type Output = [u8];

            #[inline]
            fn index(&self, index: ::std::ops::Range<usize>) -> &[u8] {
                &self.0[index]
            }
        }

        impl ::std::ops::Index<::std::ops::RangeTo<usize>> for $thing {
            type Output = [u8];

            #[inline]
            fn index(&self, index: ::std::ops::RangeTo<usize>) -> &[u8] {
                &self.0[index]
            }
        }

        impl ::std::ops::Index<::std::ops::RangeFrom<usize>> for $thing {
            type Output = [u8];

            #[inline]
            fn index(&self, index: ::std::ops::RangeFrom<usize>) -> &[u8] {
                &self.0[index]
            }
        }

        impl ::std::ops::Index<::std::ops::RangeFull> for $thing {
            type Output = [u8];

            #[inline]
            fn index(&self, _: ::std::ops::RangeFull) -> &[u8] {
                self.0.as_slice()
            }
        }
        impl ::std::fmt::Display for $thing {
            fn fmt(&self, formatter: &mut ::std::fmt::Formatter) -> ::std::fmt::Result {
                write!(formatter, "{} {{ {} }}", stringify!($thing), bin2hex(&self.0[..]))
            }
        }

        impl ::std::fmt::Debug for $thing {
            fn fmt(&self, formatter: &mut ::std::fmt::Formatter) -> ::std::fmt::Result {
                write!(formatter, "{} {{ {} }}", stringify!($thing), bin2hex(&self.0[..]))
            }
        }

        impl Zeroize for $thing {
            #[inline]
            fn zeroize(&mut self) {
                self.0.zeroize();
            }
        }

        impl ::std::ops::Drop for $thing {
            fn drop(&mut self) {
                self.0.zeroize();
            }
        }

        #[cfg(feature = "serialization")]
        impl serde::ser::Serialize for $thing {
            fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where S: ::serde::ser::Serializer {
                serializer.serialize_newtype_struct(stringify!($thing), &bin2hex(&self.0[..]))
            }
        }

        #[cfg(feature = "serialization")]
        impl<'a> serde::de::Deserialize<'a> for $thing {
            fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where D: ::serde::de::Deserializer<'a> {
                struct Thingvisitor;

                impl<'a> ::serde::de::Visitor<'a> for Thingvisitor {
                    type Value = $thing;

                    fn expecting(&self, formatter: &mut ::std::fmt::Formatter) -> ::std::fmt::Result {
                        write!(formatter, "expected {}", stringify!($thing))
                    }

                    fn visit_str<E>(self, value: &str) -> Result<$thing, E>
                        where E: ::serde::de::Error
                    {
                        Ok($thing(hex2bin(value).map_err(::serde::de::Error::custom)?))
                    }
                }

                deserializer.deserialize_str(Thingvisitor)
            }
        }
    }
}