kyber-rs 0.1.0-alpha.9

A toolbox of advanced cryptographic primitives for Rust
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
141

use core::fmt::{Display, Formatter};
use core::ops::{Deref, DerefMut};

use serde::Deserialize;
use serde::Serialize;
use sha2::Sha256;

use crate::cipher::Stream;
use crate::group::edwards25519::curve::Curve;
use crate::group::edwards25519::scalar::Scalar;
use crate::group::Group;
use crate::group::HashFactory;
use crate::share::vss::suite::Suite;
use crate::sign::dss;
use crate::util;
use crate::util::key::Generator;
use crate::util::key::KeyError;
use crate::util::key::Suite as KeySuite;
use crate::{xof, Random, XOFFactory};

use super::Point;

/// [`SuiteEd25519`] implements some basic functionalities such as [`Group`], [`HashFactory`],
/// and [`XOFFactory`].
#[derive(Clone, Copy, Debug, Default, Serialize, Deserialize)]
pub struct SuiteEd25519 {
    // TODO: find a way to implement an embedded Stream without breaking everything
    // r: Box<dyn Stream>,
    curve: Curve,
}

impl SuiteEd25519 {
    /// [`new_blake3_sha256_ed25519()`] returns a cipher suite based on `blake3`,
    /// `SHA-256`, and the `Ed25519 curve`.It produces cryptographically random
    /// numbers via crate [`rand`].
    pub fn new_blake3_sha256_ed25519() -> SuiteEd25519 {
        SuiteEd25519::default()
    }

    // TODO: find a way to provide this extended flexibility
    // func (s *SuiteEd25519) Read(r io.Reader, objs ...interface{}) error {
    // return fixbuf.Read(r, s, objs...)
    // }
    //
    // func (s *SuiteEd25519) Write(w io.Writer, objs ...interface{}) error {
    // return fixbuf.Write(w, objs)
    // }
    //
    // /// New implements the kyber.Encoding interface
    // func (s *SuiteEd25519) New(t reflect.Type) interface{} {
    // return marshalling.GroupNew(s, t)
    // }

    // /// NewBlakeSHA256Ed25519WithRand returns a cipher suite based on package
    // /// go.dedis.ch/kyber/v3/xof/blake2xb, SHA-256, and the Ed25519 curve.
    // /// It produces cryptographically random numbers via the provided stream r.
    // func NewBlakeSHA256Ed25519WithRand(r cipher.Stream) *SuiteEd25519 {
    // suite := new(SuiteEd25519)
    // suite.r = r
    // return suite
    // }
}

impl Deref for SuiteEd25519 {
    type Target = Curve;

    fn deref(&self) -> &Self::Target {
        &self.curve
    }
}

impl DerefMut for SuiteEd25519 {
    fn deref_mut(&mut self) -> &mut Self::Target {
        &mut self.curve
    }
}

impl Generator<Scalar> for SuiteEd25519 {
    fn new_key<S: crate::cipher::Stream>(
        &self,
        stream: &mut S,
    ) -> Result<Option<Scalar>, KeyError> {
        self.curve.new_key(stream)
    }
}

impl Display for SuiteEd25519 {
    fn fmt(&self, f: &mut Formatter<'_>) -> core::fmt::Result {
        write!(f, "{}", self.curve)
    }
}

impl Group for SuiteEd25519 {
    type POINT = Point;

    fn scalar(&self) -> Scalar {
        self.curve.scalar()
    }

    fn scalar_len(&self) -> usize {
        self.curve.scalar_len()
    }

    fn point(&self) -> Point {
        self.curve.point()
    }

    fn point_len(&self) -> usize {
        self.curve.point_len()
    }

    fn is_prime_order(&self) -> Option<bool> {
        self.curve.is_prime_order()
    }
}

impl Random for SuiteEd25519 {
    /// [`random_stream()`] returns a [`Box<Stream>`] that contains a [`Stream`]
    fn random_stream(&self) -> Box<dyn Stream> {
        // TODO: add this when the embedded r is added
        // if self.r != nil {
        //     return s.r;
        // }
        Box::<util::random::random_stream::RandStream>::default()
    }
}

impl XOFFactory for SuiteEd25519 {
    /// [`xof()`] returns an [`XOF`] which is implemented via the `blake3` hash.
    fn xof(&self, key: Option<&[u8]>) -> Box<dyn crate::XOF> {
        Box::new(xof::blake3::Xof::new(key))
    }
}

impl HashFactory for SuiteEd25519 {
    type T = Sha256;
}

impl Suite for SuiteEd25519 {}
impl dss::Suite for SuiteEd25519 {}
impl KeySuite for SuiteEd25519 {}