| 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 |