OLD | NEW |
1 // Copyright (c) 2013 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2013 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef CRYPTO_CURVE25519_H | 5 #ifndef CRYPTO_CURVE25519_H |
6 #define CRYPTO_CURVE25519_H | 6 #define CRYPTO_CURVE25519_H |
7 | 7 |
8 #include "base/basictypes.h" | 8 #include <stddef.h> |
| 9 #include <stdint.h> |
| 10 |
9 #include "crypto/crypto_export.h" | 11 #include "crypto/crypto_export.h" |
10 | 12 |
11 namespace crypto { | 13 namespace crypto { |
12 | 14 |
13 // Curve25519 implements the elliptic curve group known as Curve25519, as | 15 // Curve25519 implements the elliptic curve group known as Curve25519, as |
14 // described in "Curve 25519: new Diffie-Hellman Speed Records", | 16 // described in "Curve 25519: new Diffie-Hellman Speed Records", |
15 // by D.J. Bernstein. Additional information is available at | 17 // by D.J. Bernstein. Additional information is available at |
16 // http://cr.yp.to/ecdh.html. | 18 // http://cr.yp.to/ecdh.html. |
| 19 // |
| 20 // TODO(davidben): Once iOS is switched to BoringSSL (https://crbug.com/338886), |
| 21 // remove this file altogether and switch callers to using BoringSSL's |
| 22 // curve25519.h directly. |
17 namespace curve25519 { | 23 namespace curve25519 { |
18 | 24 |
19 // kBytes is the number of bytes in the result of the Diffie-Hellman operation, | 25 // kBytes is the number of bytes in the result of the Diffie-Hellman operation, |
20 // which is an element of GF(2^255-19). | 26 // which is an element of GF(2^255-19). |
21 static const size_t kBytes = 32; | 27 static const size_t kBytes = 32; |
22 | 28 |
23 // kScalarBytes is the number of bytes in an element of the scalar field: | 29 // kScalarBytes is the number of bytes in an element of the scalar field: |
24 // GF(2^252 + 27742317777372353535851937790883648493). | 30 // GF(2^252 + 27742317777372353535851937790883648493). |
25 static const size_t kScalarBytes = 32; | 31 static const size_t kScalarBytes = 32; |
26 | 32 |
27 // ScalarMult computes the |shared_key| from |private_key| and | 33 // ScalarMult computes the |shared_key| from |private_key| and |
28 // |peer_public_key|. This method is a wrapper for |curve25519_donna()|. It | 34 // |peer_public_key|. This method is a wrapper for |curve25519_donna()|. It |
29 // calls that function with |private_key| as |secret| and |peer_public_key| as | 35 // calls that function with |private_key| as |secret| and |peer_public_key| as |
30 // basepoint. |private_key| should be of length |kScalarBytes| and | 36 // basepoint. |private_key| should be of length |kScalarBytes| and |
31 // |peer_public_key| should be of length |kBytes|. | 37 // |peer_public_key| should be of length |kBytes|. It returns true on success |
32 // See "Computing shared secrets" section of/ http://cr.yp.to/ecdh.html. | 38 // and false if |peer_public_key| was invalid. |
33 CRYPTO_EXPORT void ScalarMult(const uint8* private_key, | 39 // See the "Computing shared secrets" section of http://cr.yp.to/ecdh.html. |
34 const uint8* peer_public_key, | 40 CRYPTO_EXPORT bool ScalarMult(const uint8_t* private_key, |
35 uint8* shared_key); | 41 const uint8_t* peer_public_key, |
| 42 uint8_t* shared_key); |
36 | 43 |
37 // ScalarBaseMult computes the |public_key| from |private_key|. This method is a | 44 // ScalarBaseMult computes the |public_key| from |private_key|. This method is a |
38 // wrapper for |curve25519_donna()|. It calls that function with |private_key| | 45 // wrapper for |curve25519_donna()|. It calls that function with |private_key| |
39 // as |secret| and |kBasePoint| as basepoint. |private_key| should be of length | 46 // as |secret| and |kBasePoint| as basepoint. |private_key| should be of length |
40 // |kScalarBytes|. See "Computing public keys" section of | 47 // |kScalarBytes|. See "Computing public keys" section of |
41 // http://cr.yp.to/ecdh.html. | 48 // http://cr.yp.to/ecdh.html. |
42 CRYPTO_EXPORT void ScalarBaseMult(const uint8* private_key, uint8* public_key); | 49 CRYPTO_EXPORT void ScalarBaseMult(const uint8_t* private_key, |
| 50 uint8_t* public_key); |
43 | 51 |
44 } // namespace curve25519 | 52 } // namespace curve25519 |
45 | 53 |
46 } // namespace crypto | 54 } // namespace crypto |
47 | 55 |
48 #endif // CRYPTO_CURVE25519_H | 56 #endif // CRYPTO_CURVE25519_H |
OLD | NEW |