@@ -41,7 +41,9 @@ pub struct Ecies {
41
41
impl Ecies {
42
42
/// Create a new, random, unestablished ECIES session.
43
43
///
44
- /// This method will use the `MATRIX_QR_CODE_LOGIN` info.
44
+ /// This method will use the
45
+ /// [`MATRIX_QR_CODE_LOGIN`](https://github.com/matrix-org/matrix-spec-proposals/pull/4108)
46
+ /// info for domain separation when creating the session.
45
47
#[ wasm_bindgen( constructor) ]
46
48
pub fn new ( ) -> Self {
47
49
let inner = ecies:: Ecies :: new ( ) ;
@@ -140,16 +142,16 @@ impl EstablishedEcies {
140
142
/// Get the [`CheckCode`] which uniquely identifies this
141
143
/// [`EstablishedEcies`] session.
142
144
///
143
- /// This check code can be used to check that both sides of the session are
144
- /// indeed using the same shared secret.
145
+ /// This check code can be used to verify and confirm that both sides of the
146
+ /// session are indeed using the same shared secret.
145
147
pub fn check_code ( & self ) -> CheckCode {
146
148
self . inner . lock ( ) . unwrap ( ) . check_code ( ) . into ( )
147
149
}
148
150
}
149
151
150
152
/// A check code that can be used to confirm that two [`EstablishedEcies`]
151
153
/// objects share the same secret. This is supposed to be shared out-of-band to
152
- /// protect against active MITM attacks.
154
+ /// protect against active Man-in-the-middle ( MITM) attacks.
153
155
///
154
156
/// Since the initiator device can always tell whether a MITM attack is in
155
157
/// progress after channel establishment, this code technically carries only a
0 commit comments