blob: ff13e885804fc12c06ea0290614406f6c2ade86c [file] [log] [blame]
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01001/*
Manuel Pégourié-Gonnard32b04c12013-12-02 15:49:09 +01002 * Elliptic curves over GF(p): generic functions
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01003 *
Manuel Pégourié-Gonnard6fb81872015-07-27 11:11:48 +02004 * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
Manuel Pégourié-Gonnard37ff1402015-09-04 14:21:07 +02005 * SPDX-License-Identifier: Apache-2.0
6 *
7 * Licensed under the Apache License, Version 2.0 (the "License"); you may
8 * not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
10 *
11 * http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
15 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +010018 *
Manuel Pégourié-Gonnardfe446432015-03-06 13:17:10 +000019 * This file is part of mbed TLS (https://tls.mbed.org)
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +010020 */
21
22/*
23 * References:
24 *
Manuel Pégourié-Gonnard883f3132012-11-02 09:40:25 +010025 * SEC1 http://www.secg.org/index.php?action=secg,docs_secg
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +010026 * GECC = Guide to Elliptic Curve Cryptography - Hankerson, Menezes, Vanstone
Manuel Pégourié-Gonnard62aad142012-11-10 00:27:12 +010027 * FIPS 186-3 http://csrc.nist.gov/publications/fips/fips186-3/fips_186-3.pdf
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +010028 * RFC 4492 for the related TLS structures and constants
Nicholas Wilson08f3ef12015-11-10 13:10:01 +000029 * RFC 7748 for the Curve448 and Curve25519 curve definitions
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +020030 *
Manuel Pégourié-Gonnard07894332015-06-23 00:18:41 +020031 * [Curve25519] http://cr.yp.to/ecdh/curve25519-20060209.pdf
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +010032 *
Manuel Pégourié-Gonnard998930a2015-04-03 13:48:06 +020033 * [2] CORON, Jean-S'ebastien. Resistance against differential power analysis
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +020034 * for elliptic curve cryptosystems. In : Cryptographic Hardware and
35 * Embedded Systems. Springer Berlin Heidelberg, 1999. p. 292-302.
36 * <http://link.springer.com/chapter/10.1007/3-540-48059-5_25>
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +010037 *
Manuel Pégourié-Gonnard998930a2015-04-03 13:48:06 +020038 * [3] HEDABOU, Mustapha, PINEL, Pierre, et B'EN'ETEAU, Lucien. A comb method to
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +010039 * render ECC resistant against Side Channel Attacks. IACR Cryptology
40 * ePrint Archive, 2004, vol. 2004, p. 342.
41 * <http://eprint.iacr.org/2004/342.pdf>
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +010042 */
43
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020044#if !defined(MBEDTLS_CONFIG_FILE)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000045#include "mbedtls/config.h"
Manuel Pégourié-Gonnardcef4ad22014-04-29 12:39:06 +020046#else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020047#include MBEDTLS_CONFIG_FILE
Manuel Pégourié-Gonnardcef4ad22014-04-29 12:39:06 +020048#endif
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +010049
Janos Follath683c5822018-12-07 12:09:25 +000050/**
51 * \brief Function level alternative implementation.
52 *
53 * The MBEDTLS_ECP_INTERNAL_ALT macro enables alternative implementations to
54 * replace certain functions in this module. The alternative implementations are
55 * typically hardware accelerators and need to activate the hardware before the
56 * computation starts and deactivate it after it finishes. The
57 * mbedtls_internal_ecp_init() and mbedtls_internal_ecp_free() functions serve
58 * this purpose.
59 *
60 * To preserve the correct functionality the following conditions must hold:
61 *
62 * - The alternative implementation must be activated by
63 * mbedtls_internal_ecp_init() before any of the replaceable functions is
64 * called.
65 * - mbedtls_internal_ecp_free() must \b only be called when the alternative
66 * implementation is activated.
67 * - mbedtls_internal_ecp_init() must \b not be called when the alternative
68 * implementation is activated.
69 * - Public functions must not return while the alternative implementation is
70 * activated.
71 * - Replaceable functions are guarded by \c MBEDTLS_ECP_XXX_ALT macros and
72 * before calling them an \code if( mbedtls_internal_ecp_grp_capable( grp ) )
73 * \endcode ensures that the alternative implementation supports the current
74 * group.
75 */
76#if defined(MBEDTLS_ECP_INTERNAL_ALT)
77#endif
78
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020079#if defined(MBEDTLS_ECP_C)
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +010080
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000081#include "mbedtls/ecp.h"
Janos Follath430d3372016-11-03 14:25:37 +000082#include "mbedtls/threading.h"
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050083#include "mbedtls/platform_util.h"
Paul Bakker6e339b52013-07-03 13:37:05 +020084
Kevin Braceya967a582020-11-04 16:28:48 +020085#include <stdint.h>
Rich Evans00ab4702015-02-06 13:43:58 +000086#include <string.h>
87
Janos Follathb0697532016-08-18 12:38:46 +010088#if !defined(MBEDTLS_ECP_ALT)
89
Hanno Becker4f8e8e52018-12-14 15:08:03 +000090/* Parameter validation macros based on platform_util.h */
91#define ECP_VALIDATE_RET( cond ) \
92 MBEDTLS_INTERNAL_VALIDATE_RET( cond, MBEDTLS_ERR_ECP_BAD_INPUT_DATA )
93#define ECP_VALIDATE( cond ) \
94 MBEDTLS_INTERNAL_VALIDATE( cond )
95
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020096#if defined(MBEDTLS_PLATFORM_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000097#include "mbedtls/platform.h"
Paul Bakker6e339b52013-07-03 13:37:05 +020098#else
Rich Evans00ab4702015-02-06 13:43:58 +000099#include <stdlib.h>
Manuel Pégourié-Gonnard981732b2015-02-17 15:46:45 +0000100#include <stdio.h>
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200101#define mbedtls_printf printf
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +0200102#define mbedtls_calloc calloc
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200103#define mbedtls_free free
Paul Bakker6e339b52013-07-03 13:37:05 +0200104#endif
105
Janos Follath47d28f02016-11-01 13:22:05 +0000106#include "mbedtls/ecp_internal.h"
Janos Follathb0697532016-08-18 12:38:46 +0100107
Manuel Pégourié-Gonnard0223ab92015-10-05 11:40:01 +0100108#if ( defined(__ARMCC_VERSION) || defined(_MSC_VER) ) && \
109 !defined(inline) && !defined(__cplusplus)
Paul Bakker6a6087e2013-10-28 18:53:08 +0100110#define inline __inline
Manuel Pégourié-Gonnard20af64d2015-07-07 18:33:39 +0200111#endif
Paul Bakker6a6087e2013-10-28 18:53:08 +0100112
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200113#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +0100114/*
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +0100115 * Counts of point addition and doubling, and field multiplications.
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +0200116 * Used to test resistance of point multiplication to simple timing attacks.
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +0100117 */
Manuel Pégourié-Gonnard43863ee2013-12-01 16:51:27 +0100118static unsigned long add_count, dbl_count, mul_count;
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +0100119#endif
120
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +0200121#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard054433c2017-03-22 11:18:33 +0100122/*
123 * Maximum number of "basic operations" to be done in a row.
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +0200124 *
125 * Default value 0 means that ECC operations will not yield.
126 * Note that regardless of the value of ecp_max_ops, always at
127 * least one step is performed before yielding.
128 *
129 * Setting ecp_max_ops=1 can be suitable for testing purposes
130 * as it will interrupt computation at all possible points.
Manuel Pégourié-Gonnard054433c2017-03-22 11:18:33 +0100131 */
132static unsigned ecp_max_ops = 0;
133
134/*
135 * Set ecp_max_ops
136 */
137void mbedtls_ecp_set_max_ops( unsigned max_ops )
138{
139 ecp_max_ops = max_ops;
140}
Manuel Pégourié-Gonnard510d5ca2017-03-08 11:41:47 +0100141
142/*
Manuel Pégourié-Gonnarda0c5bcc2017-04-21 11:33:57 +0200143 * Check if restart is enabled
144 */
Manuel Pégourié-Gonnardb843b152018-10-16 10:41:31 +0200145int mbedtls_ecp_restart_is_enabled( void )
Manuel Pégourié-Gonnarda0c5bcc2017-04-21 11:33:57 +0200146{
147 return( ecp_max_ops != 0 );
148}
149
150/*
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200151 * Restart sub-context for ecp_mul_comb()
Manuel Pégourié-Gonnard510d5ca2017-03-08 11:41:47 +0100152 */
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200153struct mbedtls_ecp_restart_mul
154{
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +0100155 mbedtls_ecp_point R; /* current intermediate result */
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +0100156 size_t i; /* current index in various loops, 0 outside */
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +0100157 mbedtls_ecp_point *T; /* table for precomputed points */
158 unsigned char T_size; /* number of points in table T */
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +0200159 enum { /* what were we doing last time we returned? */
160 ecp_rsm_init = 0, /* nothing so far, dummy initial state */
161 ecp_rsm_pre_dbl, /* precompute 2^n multiples */
Manuel Pégourié-Gonnard45fd0162017-03-22 08:24:42 +0100162 ecp_rsm_pre_norm_dbl, /* normalize precomputed 2^n multiples */
163 ecp_rsm_pre_add, /* precompute remaining points by adding */
164 ecp_rsm_pre_norm_add, /* normalize all precomputed points */
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +0200165 ecp_rsm_comb_core, /* ecp_mul_comb_core() */
Manuel Pégourié-Gonnard45fd0162017-03-22 08:24:42 +0100166 ecp_rsm_final_norm, /* do the final normalization */
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100167 } state;
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100168};
Manuel Pégourié-Gonnard510d5ca2017-03-08 11:41:47 +0100169
170/*
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200171 * Init restart_mul sub-context
Manuel Pégourié-Gonnard510d5ca2017-03-08 11:41:47 +0100172 */
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200173static void ecp_restart_rsm_init( mbedtls_ecp_restart_mul_ctx *ctx )
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100174{
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +0200175 mbedtls_ecp_point_init( &ctx->R );
176 ctx->i = 0;
177 ctx->T = NULL;
178 ctx->T_size = 0;
179 ctx->state = ecp_rsm_init;
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100180}
181
182/*
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200183 * Free the components of a restart_mul sub-context
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100184 */
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200185static void ecp_restart_rsm_free( mbedtls_ecp_restart_mul_ctx *ctx )
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100186{
Kevin Braceya967a582020-11-04 16:28:48 +0200187 uint_fast8_t i;
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +0100188
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100189 if( ctx == NULL )
190 return;
Manuel Pégourié-Gonnard78d564a2017-03-14 11:48:38 +0100191
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +0100192 mbedtls_ecp_point_free( &ctx->R );
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100193
Manuel Pégourié-Gonnard31f0ef72017-05-17 10:05:58 +0200194 if( ctx->T != NULL )
195 {
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +0100196 for( i = 0; i < ctx->T_size; i++ )
197 mbedtls_ecp_point_free( ctx->T + i );
198 mbedtls_free( ctx->T );
199 }
200
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200201 ecp_restart_rsm_init( ctx );
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100202}
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100203
204/*
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200205 * Restart context for ecp_muladd()
206 */
207struct mbedtls_ecp_restart_muladd
208{
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +0200209 mbedtls_ecp_point mP; /* mP value */
210 mbedtls_ecp_point R; /* R intermediate result */
211 enum { /* what should we do next? */
212 ecp_rsma_mul1 = 0, /* first multiplication */
213 ecp_rsma_mul2, /* second multiplication */
214 ecp_rsma_add, /* addition */
215 ecp_rsma_norm, /* normalization */
216 } state;
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200217};
218
219/*
220 * Init restart_muladd sub-context
221 */
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200222static void ecp_restart_ma_init( mbedtls_ecp_restart_muladd_ctx *ctx )
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200223{
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +0200224 mbedtls_ecp_point_init( &ctx->mP );
225 mbedtls_ecp_point_init( &ctx->R );
226 ctx->state = ecp_rsma_mul1;
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200227}
228
229/*
230 * Free the components of a restart_muladd sub-context
231 */
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200232static void ecp_restart_ma_free( mbedtls_ecp_restart_muladd_ctx *ctx )
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200233{
234 if( ctx == NULL )
235 return;
236
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +0200237 mbedtls_ecp_point_free( &ctx->mP );
238 mbedtls_ecp_point_free( &ctx->R );
239
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200240 ecp_restart_ma_init( ctx );
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200241}
242
243/*
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +0200244 * Initialize a restart context
245 */
246void mbedtls_ecp_restart_init( mbedtls_ecp_restart_ctx *ctx )
247{
Hanno Becker80f71682018-12-18 23:44:43 +0000248 ECP_VALIDATE( ctx != NULL );
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +0200249 ctx->ops_done = 0;
250 ctx->depth = 0;
251 ctx->rsm = NULL;
252 ctx->ma = NULL;
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +0200253}
254
255/*
256 * Free the components of a restart context
257 */
258void mbedtls_ecp_restart_free( mbedtls_ecp_restart_ctx *ctx )
259{
260 if( ctx == NULL )
261 return;
262
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200263 ecp_restart_rsm_free( ctx->rsm );
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +0200264 mbedtls_free( ctx->rsm );
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +0200265
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200266 ecp_restart_ma_free( ctx->ma );
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +0200267 mbedtls_free( ctx->ma );
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +0200268
269 mbedtls_ecp_restart_init( ctx );
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +0200270}
271
272/*
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100273 * Check if we can do the next step
274 */
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +0200275int mbedtls_ecp_check_budget( const mbedtls_ecp_group *grp,
276 mbedtls_ecp_restart_ctx *rs_ctx,
277 unsigned ops )
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100278{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000279 ECP_VALIDATE_RET( grp != NULL );
280
Manuel Pégourié-Gonnard646393b2017-04-20 10:03:45 +0200281 if( rs_ctx != NULL && ecp_max_ops != 0 )
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100282 {
Manuel Pégourié-Gonnarde6854492017-03-20 14:35:19 +0100283 /* scale depending on curve size: the chosen reference is 256-bit,
284 * and multiplication is quadratic. Round to the closest integer. */
285 if( grp->pbits >= 512 )
286 ops *= 4;
287 else if( grp->pbits >= 384 )
288 ops *= 2;
289
Hanno Beckerb10c6602018-10-26 13:50:13 +0100290 /* Avoid infinite loops: always allow first step.
291 * Because of that, however, it's not generally true
292 * that ops_done <= ecp_max_ops, so the check
293 * ops_done > ecp_max_ops below is mandatory. */
294 if( ( rs_ctx->ops_done != 0 ) &&
295 ( rs_ctx->ops_done > ecp_max_ops ||
296 ops > ecp_max_ops - rs_ctx->ops_done ) )
297 {
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100298 return( MBEDTLS_ERR_ECP_IN_PROGRESS );
Hanno Beckerb10c6602018-10-26 13:50:13 +0100299 }
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100300
Manuel Pégourié-Gonnarde6854492017-03-20 14:35:19 +0100301 /* update running count */
Manuel Pégourié-Gonnard646393b2017-04-20 10:03:45 +0200302 rs_ctx->ops_done += ops;
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100303 }
304
305 return( 0 );
306}
307
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200308/* Call this when entering a function that needs its own sub-context */
Manuel Pégourié-Gonnarda58e0112018-10-16 10:42:47 +0200309#define ECP_RS_ENTER( SUB ) do { \
310 /* reset ops count for this call if top-level */ \
311 if( rs_ctx != NULL && rs_ctx->depth++ == 0 ) \
312 rs_ctx->ops_done = 0; \
313 \
314 /* set up our own sub-context if needed */ \
315 if( mbedtls_ecp_restart_is_enabled() && \
316 rs_ctx != NULL && rs_ctx->SUB == NULL ) \
317 { \
318 rs_ctx->SUB = mbedtls_calloc( 1, sizeof( *rs_ctx->SUB ) ); \
319 if( rs_ctx->SUB == NULL ) \
320 return( MBEDTLS_ERR_ECP_ALLOC_FAILED ); \
321 \
322 ecp_restart_## SUB ##_init( rs_ctx->SUB ); \
323 } \
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200324} while( 0 )
325
326/* Call this when leaving a function that needs its own sub-context */
Manuel Pégourié-Gonnarda58e0112018-10-16 10:42:47 +0200327#define ECP_RS_LEAVE( SUB ) do { \
328 /* clear our sub-context when not in progress (done or error) */ \
329 if( rs_ctx != NULL && rs_ctx->SUB != NULL && \
330 ret != MBEDTLS_ERR_ECP_IN_PROGRESS ) \
331 { \
332 ecp_restart_## SUB ##_free( rs_ctx->SUB ); \
333 mbedtls_free( rs_ctx->SUB ); \
334 rs_ctx->SUB = NULL; \
335 } \
336 \
337 if( rs_ctx != NULL ) \
338 rs_ctx->depth--; \
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200339} while( 0 )
340
341#else /* MBEDTLS_ECP_RESTARTABLE */
342
343#define ECP_RS_ENTER( sub ) (void) rs_ctx;
344#define ECP_RS_LEAVE( sub ) (void) rs_ctx;
345
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +0200346#endif /* MBEDTLS_ECP_RESTARTABLE */
Manuel Pégourié-Gonnard054433c2017-03-22 11:18:33 +0100347
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200348#if defined(MBEDTLS_ECP_DP_SECP192R1_ENABLED) || \
349 defined(MBEDTLS_ECP_DP_SECP224R1_ENABLED) || \
350 defined(MBEDTLS_ECP_DP_SECP256R1_ENABLED) || \
351 defined(MBEDTLS_ECP_DP_SECP384R1_ENABLED) || \
352 defined(MBEDTLS_ECP_DP_SECP521R1_ENABLED) || \
353 defined(MBEDTLS_ECP_DP_BP256R1_ENABLED) || \
354 defined(MBEDTLS_ECP_DP_BP384R1_ENABLED) || \
355 defined(MBEDTLS_ECP_DP_BP512R1_ENABLED) || \
356 defined(MBEDTLS_ECP_DP_SECP192K1_ENABLED) || \
357 defined(MBEDTLS_ECP_DP_SECP224K1_ENABLED) || \
358 defined(MBEDTLS_ECP_DP_SECP256K1_ENABLED)
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200359#define ECP_SHORTWEIERSTRASS
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100360#endif
361
Nicholas Wilson08f3ef12015-11-10 13:10:01 +0000362#if defined(MBEDTLS_ECP_DP_CURVE25519_ENABLED) || \
363 defined(MBEDTLS_ECP_DP_CURVE448_ENABLED)
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200364#define ECP_MONTGOMERY
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100365#endif
366
367/*
368 * Curve types: internal for now, might be exposed later
369 */
370typedef enum
371{
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200372 ECP_TYPE_NONE = 0,
373 ECP_TYPE_SHORT_WEIERSTRASS, /* y^2 = x^3 + a x + b */
374 ECP_TYPE_MONTGOMERY, /* y^2 = x^3 + a x^2 + x */
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100375} ecp_curve_type;
376
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100377/*
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200378 * List of supported curves:
379 * - internal ID
Manuel Pégourié-Gonnard8195c1a2013-10-07 19:40:41 +0200380 * - TLS NamedCurve ID (RFC 4492 sec. 5.1.1, RFC 7071 sec. 2)
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200381 * - size in bits
Manuel Pégourié-Gonnard8195c1a2013-10-07 19:40:41 +0200382 * - readable name
Gergely Budaie40c4692014-01-22 11:22:20 +0100383 *
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100384 * Curves are listed in order: largest curves first, and for a given size,
385 * fastest curves first. This provides the default order for the SSL module.
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +0200386 *
387 * Reminder: update profiles in x509_crt.c when adding a new curves!
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200388 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200389static const mbedtls_ecp_curve_info ecp_supported_curves[] =
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200390{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200391#if defined(MBEDTLS_ECP_DP_SECP521R1_ENABLED)
392 { MBEDTLS_ECP_DP_SECP521R1, 25, 521, "secp521r1" },
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200393#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200394#if defined(MBEDTLS_ECP_DP_BP512R1_ENABLED)
395 { MBEDTLS_ECP_DP_BP512R1, 28, 512, "brainpoolP512r1" },
Gergely Budaie40c4692014-01-22 11:22:20 +0100396#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200397#if defined(MBEDTLS_ECP_DP_SECP384R1_ENABLED)
398 { MBEDTLS_ECP_DP_SECP384R1, 24, 384, "secp384r1" },
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200399#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200400#if defined(MBEDTLS_ECP_DP_BP384R1_ENABLED)
401 { MBEDTLS_ECP_DP_BP384R1, 27, 384, "brainpoolP384r1" },
Gergely Budaie40c4692014-01-22 11:22:20 +0100402#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200403#if defined(MBEDTLS_ECP_DP_SECP256R1_ENABLED)
404 { MBEDTLS_ECP_DP_SECP256R1, 23, 256, "secp256r1" },
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200405#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200406#if defined(MBEDTLS_ECP_DP_SECP256K1_ENABLED)
407 { MBEDTLS_ECP_DP_SECP256K1, 22, 256, "secp256k1" },
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100408#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200409#if defined(MBEDTLS_ECP_DP_BP256R1_ENABLED)
410 { MBEDTLS_ECP_DP_BP256R1, 26, 256, "brainpoolP256r1" },
Gergely Budaie40c4692014-01-22 11:22:20 +0100411#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200412#if defined(MBEDTLS_ECP_DP_SECP224R1_ENABLED)
413 { MBEDTLS_ECP_DP_SECP224R1, 21, 224, "secp224r1" },
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200414#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200415#if defined(MBEDTLS_ECP_DP_SECP224K1_ENABLED)
416 { MBEDTLS_ECP_DP_SECP224K1, 20, 224, "secp224k1" },
Manuel Pégourié-Gonnard9bcff392014-01-10 18:26:48 +0100417#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200418#if defined(MBEDTLS_ECP_DP_SECP192R1_ENABLED)
419 { MBEDTLS_ECP_DP_SECP192R1, 19, 192, "secp192r1" },
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100420#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200421#if defined(MBEDTLS_ECP_DP_SECP192K1_ENABLED)
422 { MBEDTLS_ECP_DP_SECP192K1, 18, 192, "secp192k1" },
Manuel Pégourié-Gonnard9bcff392014-01-10 18:26:48 +0100423#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200424 { MBEDTLS_ECP_DP_NONE, 0, 0, NULL },
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200425};
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100426
Manuel Pégourié-Gonnardba782bb2014-07-08 13:31:34 +0200427#define ECP_NB_CURVES sizeof( ecp_supported_curves ) / \
428 sizeof( ecp_supported_curves[0] )
429
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200430static mbedtls_ecp_group_id ecp_supported_grp_id[ECP_NB_CURVES];
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200431
432/*
Manuel Pégourié-Gonnardda179e42013-09-18 15:31:24 +0200433 * List of supported curves and associated info
434 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200435const mbedtls_ecp_curve_info *mbedtls_ecp_curve_list( void )
Manuel Pégourié-Gonnardda179e42013-09-18 15:31:24 +0200436{
Paul Bakkerd8bb8262014-06-17 14:06:49 +0200437 return( ecp_supported_curves );
Manuel Pégourié-Gonnardda179e42013-09-18 15:31:24 +0200438}
439
440/*
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100441 * List of supported curves, group ID only
442 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200443const mbedtls_ecp_group_id *mbedtls_ecp_grp_id_list( void )
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100444{
445 static int init_done = 0;
446
447 if( ! init_done )
448 {
449 size_t i = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200450 const mbedtls_ecp_curve_info *curve_info;
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100451
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200452 for( curve_info = mbedtls_ecp_curve_list();
453 curve_info->grp_id != MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100454 curve_info++ )
455 {
456 ecp_supported_grp_id[i++] = curve_info->grp_id;
457 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200458 ecp_supported_grp_id[i] = MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100459
460 init_done = 1;
461 }
462
Paul Bakkerd8bb8262014-06-17 14:06:49 +0200463 return( ecp_supported_grp_id );
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100464}
465
466/*
467 * Get the curve info for the internal identifier
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200468 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200469const mbedtls_ecp_curve_info *mbedtls_ecp_curve_info_from_grp_id( mbedtls_ecp_group_id grp_id )
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200470{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200471 const mbedtls_ecp_curve_info *curve_info;
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200472
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200473 for( curve_info = mbedtls_ecp_curve_list();
474 curve_info->grp_id != MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200475 curve_info++ )
476 {
477 if( curve_info->grp_id == grp_id )
478 return( curve_info );
479 }
480
481 return( NULL );
482}
483
484/*
485 * Get the curve info from the TLS identifier
486 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200487const mbedtls_ecp_curve_info *mbedtls_ecp_curve_info_from_tls_id( uint16_t tls_id )
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200488{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200489 const mbedtls_ecp_curve_info *curve_info;
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200490
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200491 for( curve_info = mbedtls_ecp_curve_list();
492 curve_info->grp_id != MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200493 curve_info++ )
494 {
495 if( curve_info->tls_id == tls_id )
496 return( curve_info );
497 }
498
499 return( NULL );
500}
501
502/*
Manuel Pégourié-Gonnard0267e3d2013-11-30 15:10:14 +0100503 * Get the curve info from the name
504 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200505const mbedtls_ecp_curve_info *mbedtls_ecp_curve_info_from_name( const char *name )
Manuel Pégourié-Gonnard0267e3d2013-11-30 15:10:14 +0100506{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200507 const mbedtls_ecp_curve_info *curve_info;
Manuel Pégourié-Gonnard0267e3d2013-11-30 15:10:14 +0100508
Hanno Beckerb7a04a72018-12-18 23:50:21 +0000509 if( name == NULL )
510 return( NULL );
511
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200512 for( curve_info = mbedtls_ecp_curve_list();
513 curve_info->grp_id != MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnard0267e3d2013-11-30 15:10:14 +0100514 curve_info++ )
515 {
Manuel Pégourié-Gonnardcb46fd82015-05-28 17:06:07 +0200516 if( strcmp( curve_info->name, name ) == 0 )
Manuel Pégourié-Gonnard0267e3d2013-11-30 15:10:14 +0100517 return( curve_info );
518 }
519
520 return( NULL );
521}
522
523/*
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100524 * Get the type of a curve
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +0100525 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200526static inline ecp_curve_type ecp_get_type( const mbedtls_ecp_group *grp )
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +0100527{
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100528 if( grp->G.X.p == NULL )
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200529 return( ECP_TYPE_NONE );
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100530
531 if( grp->G.Y.p == NULL )
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200532 return( ECP_TYPE_MONTGOMERY );
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100533 else
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200534 return( ECP_TYPE_SHORT_WEIERSTRASS );
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +0100535}
536
537/*
Manuel Pégourié-Gonnardb505c272012-11-05 17:27:54 +0100538 * Initialize (the components of) a point
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100539 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200540void mbedtls_ecp_point_init( mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100541{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000542 ECP_VALIDATE( pt != NULL );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100543
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200544 mbedtls_mpi_init( &pt->X );
545 mbedtls_mpi_init( &pt->Y );
546 mbedtls_mpi_init( &pt->Z );
Manuel Pégourié-Gonnardb505c272012-11-05 17:27:54 +0100547}
548
549/*
550 * Initialize (the components of) a group
551 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200552void mbedtls_ecp_group_init( mbedtls_ecp_group *grp )
Manuel Pégourié-Gonnardb505c272012-11-05 17:27:54 +0100553{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000554 ECP_VALIDATE( grp != NULL );
Manuel Pégourié-Gonnardb505c272012-11-05 17:27:54 +0100555
Manuel Pégourié-Gonnard95e2eca2018-06-20 10:29:47 +0200556 grp->id = MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +0200557 mbedtls_mpi_init( &grp->P );
558 mbedtls_mpi_init( &grp->A );
559 mbedtls_mpi_init( &grp->B );
560 mbedtls_ecp_point_init( &grp->G );
561 mbedtls_mpi_init( &grp->N );
562 grp->pbits = 0;
563 grp->nbits = 0;
564 grp->h = 0;
565 grp->modp = NULL;
566 grp->t_pre = NULL;
567 grp->t_post = NULL;
568 grp->t_data = NULL;
569 grp->T = NULL;
570 grp->T_size = 0;
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100571}
572
573/*
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200574 * Initialize (the components of) a key pair
575 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200576void mbedtls_ecp_keypair_init( mbedtls_ecp_keypair *key )
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200577{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000578 ECP_VALIDATE( key != NULL );
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200579
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200580 mbedtls_ecp_group_init( &key->grp );
581 mbedtls_mpi_init( &key->d );
582 mbedtls_ecp_point_init( &key->Q );
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200583}
584
585/*
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100586 * Unallocate (the components of) a point
587 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200588void mbedtls_ecp_point_free( mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100589{
590 if( pt == NULL )
591 return;
592
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200593 mbedtls_mpi_free( &( pt->X ) );
594 mbedtls_mpi_free( &( pt->Y ) );
595 mbedtls_mpi_free( &( pt->Z ) );
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100596}
597
598/*
599 * Unallocate (the components of) a group
600 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200601void mbedtls_ecp_group_free( mbedtls_ecp_group *grp )
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100602{
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +0200603 size_t i;
604
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100605 if( grp == NULL )
606 return;
607
Manuel Pégourié-Gonnard1f82b042013-12-06 12:51:50 +0100608 if( grp->h != 1 )
609 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200610 mbedtls_mpi_free( &grp->P );
611 mbedtls_mpi_free( &grp->A );
612 mbedtls_mpi_free( &grp->B );
613 mbedtls_ecp_point_free( &grp->G );
614 mbedtls_mpi_free( &grp->N );
Manuel Pégourié-Gonnard1f82b042013-12-06 12:51:50 +0100615 }
Manuel Pégourié-Gonnardc9727702013-09-16 18:56:28 +0200616
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +0200617 if( grp->T != NULL )
618 {
619 for( i = 0; i < grp->T_size; i++ )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200620 mbedtls_ecp_point_free( &grp->T[i] );
621 mbedtls_free( grp->T );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +0200622 }
623
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500624 mbedtls_platform_zeroize( grp, sizeof( mbedtls_ecp_group ) );
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100625}
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +0100626
Manuel Pégourié-Gonnard883f3132012-11-02 09:40:25 +0100627/*
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200628 * Unallocate (the components of) a key pair
629 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200630void mbedtls_ecp_keypair_free( mbedtls_ecp_keypair *key )
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200631{
Paul Bakker66d5d072014-06-17 16:39:18 +0200632 if( key == NULL )
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200633 return;
634
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200635 mbedtls_ecp_group_free( &key->grp );
636 mbedtls_mpi_free( &key->d );
637 mbedtls_ecp_point_free( &key->Q );
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200638}
639
640/*
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200641 * Copy the contents of a point
642 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200643int mbedtls_ecp_copy( mbedtls_ecp_point *P, const mbedtls_ecp_point *Q )
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200644{
645 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000646 ECP_VALIDATE_RET( P != NULL );
647 ECP_VALIDATE_RET( Q != NULL );
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200648
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200649 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &P->X, &Q->X ) );
650 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &P->Y, &Q->Y ) );
651 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &P->Z, &Q->Z ) );
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200652
653cleanup:
654 return( ret );
655}
656
657/*
658 * Copy the contents of a group object
659 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200660int mbedtls_ecp_group_copy( mbedtls_ecp_group *dst, const mbedtls_ecp_group *src )
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200661{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000662 ECP_VALIDATE_RET( dst != NULL );
663 ECP_VALIDATE_RET( src != NULL );
664
665 return( mbedtls_ecp_group_load( dst, src->id ) );
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200666}
667
668/*
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100669 * Set point to zero
670 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200671int mbedtls_ecp_set_zero( mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100672{
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +0100673 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000674 ECP_VALIDATE_RET( pt != NULL );
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +0100675
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200676 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &pt->X , 1 ) );
677 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &pt->Y , 1 ) );
678 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &pt->Z , 0 ) );
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +0100679
680cleanup:
681 return( ret );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100682}
683
684/*
Manuel Pégourié-Gonnard6545ca72013-01-26 16:05:22 +0100685 * Tell if a point is zero
686 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200687int mbedtls_ecp_is_zero( mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnard6545ca72013-01-26 16:05:22 +0100688{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000689 ECP_VALIDATE_RET( pt != NULL );
690
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200691 return( mbedtls_mpi_cmp_int( &pt->Z, 0 ) == 0 );
Manuel Pégourié-Gonnard6545ca72013-01-26 16:05:22 +0100692}
693
694/*
Brian J Murrayf343de12018-10-22 16:40:49 -0700695 * Compare two points lazily
Manuel Pégourié-Gonnard6029a852015-08-11 15:44:41 +0200696 */
697int mbedtls_ecp_point_cmp( const mbedtls_ecp_point *P,
698 const mbedtls_ecp_point *Q )
699{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000700 ECP_VALIDATE_RET( P != NULL );
701 ECP_VALIDATE_RET( Q != NULL );
702
Manuel Pégourié-Gonnard6029a852015-08-11 15:44:41 +0200703 if( mbedtls_mpi_cmp_mpi( &P->X, &Q->X ) == 0 &&
704 mbedtls_mpi_cmp_mpi( &P->Y, &Q->Y ) == 0 &&
705 mbedtls_mpi_cmp_mpi( &P->Z, &Q->Z ) == 0 )
706 {
707 return( 0 );
708 }
709
710 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
711}
712
713/*
Manuel Pégourié-Gonnard847395a2012-11-05 13:13:44 +0100714 * Import a non-zero point from ASCII strings
715 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200716int mbedtls_ecp_point_read_string( mbedtls_ecp_point *P, int radix,
Manuel Pégourié-Gonnard847395a2012-11-05 13:13:44 +0100717 const char *x, const char *y )
718{
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +0100719 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000720 ECP_VALIDATE_RET( P != NULL );
721 ECP_VALIDATE_RET( x != NULL );
722 ECP_VALIDATE_RET( y != NULL );
Manuel Pégourié-Gonnard847395a2012-11-05 13:13:44 +0100723
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200724 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &P->X, radix, x ) );
725 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &P->Y, radix, y ) );
726 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &P->Z, 1 ) );
Manuel Pégourié-Gonnard847395a2012-11-05 13:13:44 +0100727
728cleanup:
729 return( ret );
730}
731
732/*
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100733 * Export a point into unsigned binary data (SEC1 2.3.3)
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100734 */
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000735int mbedtls_ecp_point_write_binary( const mbedtls_ecp_group *grp,
736 const mbedtls_ecp_point *P,
737 int format, size_t *olen,
738 unsigned char *buf, size_t buflen )
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100739{
Paul Bakkera280d0f2013-04-08 13:40:17 +0200740 int ret = 0;
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100741 size_t plen;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000742 ECP_VALIDATE_RET( grp != NULL );
743 ECP_VALIDATE_RET( P != NULL );
744 ECP_VALIDATE_RET( olen != NULL );
745 ECP_VALIDATE_RET( buf != NULL );
746 ECP_VALIDATE_RET( format == MBEDTLS_ECP_PF_UNCOMPRESSED ||
747 format == MBEDTLS_ECP_PF_COMPRESSED );
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100748
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100749 /*
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100750 * Common case: P == 0
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100751 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200752 if( mbedtls_mpi_cmp_int( &P->Z, 0 ) == 0 )
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100753 {
754 if( buflen < 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200755 return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100756
757 buf[0] = 0x00;
758 *olen = 1;
759
760 return( 0 );
761 }
762
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200763 plen = mbedtls_mpi_size( &grp->P );
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100764
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200765 if( format == MBEDTLS_ECP_PF_UNCOMPRESSED )
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100766 {
767 *olen = 2 * plen + 1;
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100768
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100769 if( buflen < *olen )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200770 return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100771
772 buf[0] = 0x04;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200773 MBEDTLS_MPI_CHK( mbedtls_mpi_write_binary( &P->X, buf + 1, plen ) );
774 MBEDTLS_MPI_CHK( mbedtls_mpi_write_binary( &P->Y, buf + 1 + plen, plen ) );
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100775 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200776 else if( format == MBEDTLS_ECP_PF_COMPRESSED )
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100777 {
778 *olen = plen + 1;
779
780 if( buflen < *olen )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200781 return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100782
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200783 buf[0] = 0x02 + mbedtls_mpi_get_bit( &P->Y, 0 );
784 MBEDTLS_MPI_CHK( mbedtls_mpi_write_binary( &P->X, buf + 1, plen ) );
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100785 }
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100786
787cleanup:
788 return( ret );
789}
790
791/*
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100792 * Import a point from unsigned binary data (SEC1 2.3.4)
793 */
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000794int mbedtls_ecp_point_read_binary( const mbedtls_ecp_group *grp,
795 mbedtls_ecp_point *pt,
796 const unsigned char *buf, size_t ilen )
Manuel Pégourié-Gonnard5246ee52014-03-19 16:18:38 +0100797{
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100798 int ret;
799 size_t plen;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000800 ECP_VALIDATE_RET( grp != NULL );
801 ECP_VALIDATE_RET( pt != NULL );
802 ECP_VALIDATE_RET( buf != NULL );
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100803
Paul Bakker82788fb2014-10-20 13:59:19 +0200804 if( ilen < 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200805 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard67dbe1e2014-07-08 13:09:24 +0200806
Manuel Pégourié-Gonnardc042cf02014-03-26 14:12:20 +0100807 if( buf[0] == 0x00 )
808 {
809 if( ilen == 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200810 return( mbedtls_ecp_set_zero( pt ) );
Manuel Pégourié-Gonnardc042cf02014-03-26 14:12:20 +0100811 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200812 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardc042cf02014-03-26 14:12:20 +0100813 }
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100814
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200815 plen = mbedtls_mpi_size( &grp->P );
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100816
Manuel Pégourié-Gonnard5246ee52014-03-19 16:18:38 +0100817 if( buf[0] != 0x04 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200818 return( MBEDTLS_ERR_ECP_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnard5246ee52014-03-19 16:18:38 +0100819
820 if( ilen != 2 * plen + 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200821 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100822
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200823 MBEDTLS_MPI_CHK( mbedtls_mpi_read_binary( &pt->X, buf + 1, plen ) );
824 MBEDTLS_MPI_CHK( mbedtls_mpi_read_binary( &pt->Y, buf + 1 + plen, plen ) );
825 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &pt->Z, 1 ) );
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100826
827cleanup:
828 return( ret );
829}
830
831/*
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100832 * Import a point from a TLS ECPoint record (RFC 4492)
833 * struct {
834 * opaque point <1..2^8-1>;
835 * } ECPoint;
836 */
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000837int mbedtls_ecp_tls_read_point( const mbedtls_ecp_group *grp,
838 mbedtls_ecp_point *pt,
839 const unsigned char **buf, size_t buf_len )
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100840{
841 unsigned char data_len;
Manuel Pégourié-Gonnard98f51812013-02-10 13:38:29 +0100842 const unsigned char *buf_start;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000843 ECP_VALIDATE_RET( grp != NULL );
844 ECP_VALIDATE_RET( pt != NULL );
845 ECP_VALIDATE_RET( buf != NULL );
846 ECP_VALIDATE_RET( *buf != NULL );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100847
848 /*
Manuel Pégourié-Gonnard67dbe1e2014-07-08 13:09:24 +0200849 * We must have at least two bytes (1 for length, at least one for data)
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100850 */
851 if( buf_len < 2 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200852 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100853
Manuel Pégourié-Gonnard98f51812013-02-10 13:38:29 +0100854 data_len = *(*buf)++;
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100855 if( data_len < 1 || data_len > buf_len - 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200856 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100857
Manuel Pégourié-Gonnard98f51812013-02-10 13:38:29 +0100858 /*
859 * Save buffer start for read_binary and update buf
860 */
861 buf_start = *buf;
862 *buf += data_len;
863
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000864 return( mbedtls_ecp_point_read_binary( grp, pt, buf_start, data_len ) );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100865}
866
867/*
868 * Export a point as a TLS ECPoint record (RFC 4492)
869 * struct {
870 * opaque point <1..2^8-1>;
871 * } ECPoint;
872 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200873int mbedtls_ecp_tls_write_point( const mbedtls_ecp_group *grp, const mbedtls_ecp_point *pt,
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100874 int format, size_t *olen,
875 unsigned char *buf, size_t blen )
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100876{
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100877 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000878 ECP_VALIDATE_RET( grp != NULL );
879 ECP_VALIDATE_RET( pt != NULL );
880 ECP_VALIDATE_RET( olen != NULL );
881 ECP_VALIDATE_RET( buf != NULL );
882 ECP_VALIDATE_RET( format == MBEDTLS_ECP_PF_UNCOMPRESSED ||
883 format == MBEDTLS_ECP_PF_COMPRESSED );
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100884
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100885 /*
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100886 * buffer length must be at least one, for our length byte
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100887 */
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100888 if( blen < 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200889 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100890
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200891 if( ( ret = mbedtls_ecp_point_write_binary( grp, pt, format,
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100892 olen, buf + 1, blen - 1) ) != 0 )
893 return( ret );
894
895 /*
896 * write length to the first byte and update total length
897 */
Paul Bakkerb9cfaa02013-10-11 18:58:55 +0200898 buf[0] = (unsigned char) *olen;
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100899 ++*olen;
900
Paul Bakkerd8bb8262014-06-17 14:06:49 +0200901 return( 0 );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100902}
903
904/*
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100905 * Set a group from an ECParameters record (RFC 4492)
906 */
Janos Follath89ac8c92018-10-30 11:24:05 +0000907int mbedtls_ecp_tls_read_group( mbedtls_ecp_group *grp,
908 const unsigned char **buf, size_t len )
909{
910 int ret;
911 mbedtls_ecp_group_id grp_id;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000912 ECP_VALIDATE_RET( grp != NULL );
913 ECP_VALIDATE_RET( buf != NULL );
914 ECP_VALIDATE_RET( *buf != NULL );
Janos Follath89ac8c92018-10-30 11:24:05 +0000915
916 if( ( ret = mbedtls_ecp_tls_read_group_id( &grp_id, buf, len ) ) != 0 )
917 return( ret );
918
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000919 return( mbedtls_ecp_group_load( grp, grp_id ) );
Janos Follath89ac8c92018-10-30 11:24:05 +0000920}
921
922/*
923 * Read a group id from an ECParameters record (RFC 4492) and convert it to
924 * mbedtls_ecp_group_id.
925 */
926int mbedtls_ecp_tls_read_group_id( mbedtls_ecp_group_id *grp,
927 const unsigned char **buf, size_t len )
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100928{
Manuel Pégourié-Gonnardf24b4a72013-09-23 18:14:50 +0200929 uint16_t tls_id;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200930 const mbedtls_ecp_curve_info *curve_info;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000931 ECP_VALIDATE_RET( grp != NULL );
932 ECP_VALIDATE_RET( buf != NULL );
933 ECP_VALIDATE_RET( *buf != NULL );
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100934
935 /*
936 * We expect at least three bytes (see below)
937 */
938 if( len < 3 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200939 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100940
941 /*
942 * First byte is curve_type; only named_curve is handled
943 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200944 if( *(*buf)++ != MBEDTLS_ECP_TLS_NAMED_CURVE )
945 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100946
947 /*
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100948 * Next two bytes are the namedcurve value
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100949 */
Manuel Pégourié-Gonnardf24b4a72013-09-23 18:14:50 +0200950 tls_id = *(*buf)++;
951 tls_id <<= 8;
952 tls_id |= *(*buf)++;
953
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200954 if( ( curve_info = mbedtls_ecp_curve_info_from_tls_id( tls_id ) ) == NULL )
955 return( MBEDTLS_ERR_ECP_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnardf24b4a72013-09-23 18:14:50 +0200956
Janos Follath89ac8c92018-10-30 11:24:05 +0000957 *grp = curve_info->grp_id;
958
959 return( 0 );
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100960}
961
962/*
963 * Write the ECParameters record corresponding to a group (RFC 4492)
964 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200965int mbedtls_ecp_tls_write_group( const mbedtls_ecp_group *grp, size_t *olen,
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100966 unsigned char *buf, size_t blen )
967{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200968 const mbedtls_ecp_curve_info *curve_info;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000969 ECP_VALIDATE_RET( grp != NULL );
970 ECP_VALIDATE_RET( buf != NULL );
971 ECP_VALIDATE_RET( olen != NULL );
Manuel Pégourié-Gonnardf24b4a72013-09-23 18:14:50 +0200972
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200973 if( ( curve_info = mbedtls_ecp_curve_info_from_grp_id( grp->id ) ) == NULL )
974 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +0200975
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100976 /*
977 * We are going to write 3 bytes (see below)
978 */
979 *olen = 3;
980 if( blen < *olen )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200981 return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100982
983 /*
984 * First byte is curve_type, always named_curve
985 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200986 *buf++ = MBEDTLS_ECP_TLS_NAMED_CURVE;
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100987
988 /*
989 * Next two bytes are the namedcurve value
990 */
Manuel Pégourié-Gonnardf24b4a72013-09-23 18:14:50 +0200991 buf[0] = curve_info->tls_id >> 8;
992 buf[1] = curve_info->tls_id & 0xFF;
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100993
Paul Bakkerd8bb8262014-06-17 14:06:49 +0200994 return( 0 );
Manuel Pégourié-Gonnarda5402fe2012-11-07 20:24:05 +0100995}
Manuel Pégourié-Gonnardab38b702012-11-05 17:34:55 +0100996
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200997/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200998 * Wrapper around fast quasi-modp functions, with fall-back to mbedtls_mpi_mod_mpi.
999 * See the documentation of struct mbedtls_ecp_group.
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001000 *
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001001 * This function is in the critial loop for mbedtls_ecp_mul, so pay attention to perf.
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001002 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001003static int ecp_modp( mbedtls_mpi *N, const mbedtls_ecp_group *grp )
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +02001004{
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001005 int ret;
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001006
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001007 if( grp->modp == NULL )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001008 return( mbedtls_mpi_mod_mpi( N, N, &grp->P ) );
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001009
1010 /* N->s < 0 is a much faster test, which fails only if N is 0 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001011 if( ( N->s < 0 && mbedtls_mpi_cmp_int( N, 0 ) != 0 ) ||
Manuel Pégourié-Gonnardc0696c22015-06-18 16:47:17 +02001012 mbedtls_mpi_bitlen( N ) > 2 * grp->pbits )
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +02001013 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001014 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +02001015 }
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001016
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001017 MBEDTLS_MPI_CHK( grp->modp( N ) );
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +02001018
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001019 /* N->s < 0 is a much faster test, which fails only if N is 0 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001020 while( N->s < 0 && mbedtls_mpi_cmp_int( N, 0 ) != 0 )
1021 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( N, N, &grp->P ) );
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001022
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001023 while( mbedtls_mpi_cmp_mpi( N, &grp->P ) >= 0 )
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001024 /* we known P, N and the result are positive */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001025 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_abs( N, N, &grp->P ) );
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001026
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001027cleanup:
1028 return( ret );
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +02001029}
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001030
Manuel Pégourié-Gonnard847395a2012-11-05 13:13:44 +01001031/*
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +01001032 * Fast mod-p functions expect their argument to be in the 0..p^2 range.
Manuel Pégourié-Gonnarddada4da2012-11-10 14:23:17 +01001033 *
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +01001034 * In order to guarantee that, we need to ensure that operands of
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001035 * mbedtls_mpi_mul_mpi are in the 0..p range. So, after each operation we will
Manuel Pégourié-Gonnarddada4da2012-11-10 14:23:17 +01001036 * bring the result back to this range.
1037 *
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +01001038 * The following macros are shortcuts for doing that.
Manuel Pégourié-Gonnarddada4da2012-11-10 14:23:17 +01001039 */
1040
1041/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001042 * Reduce a mbedtls_mpi mod p in-place, general case, to use after mbedtls_mpi_mul_mpi
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001043 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001044#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01001045#define INC_MUL_COUNT mul_count++;
1046#else
1047#define INC_MUL_COUNT
1048#endif
1049
Hanno Beckerd6028a12018-10-15 12:01:35 +01001050#define MOD_MUL( N ) \
1051 do \
1052 { \
1053 MBEDTLS_MPI_CHK( ecp_modp( &(N), grp ) ); \
1054 INC_MUL_COUNT \
1055 } while( 0 )
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001056
1057/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001058 * Reduce a mbedtls_mpi mod p in-place, to use after mbedtls_mpi_sub_mpi
Manuel Pégourié-Gonnardc9e387c2013-10-17 17:15:35 +02001059 * N->s < 0 is a very fast test, which fails only if N is 0
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001060 */
Hanno Beckerd6028a12018-10-15 12:01:35 +01001061#define MOD_SUB( N ) \
1062 while( (N).s < 0 && mbedtls_mpi_cmp_int( &(N), 0 ) != 0 ) \
1063 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &(N), &(N), &grp->P ) )
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001064
1065/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001066 * Reduce a mbedtls_mpi mod p in-place, to use after mbedtls_mpi_add_mpi and mbedtls_mpi_mul_int.
Manuel Pégourié-Gonnardc9e387c2013-10-17 17:15:35 +02001067 * We known P, N and the result are positive, so sub_abs is correct, and
1068 * a bit faster.
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001069 */
Hanno Beckerd6028a12018-10-15 12:01:35 +01001070#define MOD_ADD( N ) \
1071 while( mbedtls_mpi_cmp_mpi( &(N), &grp->P ) >= 0 ) \
1072 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_abs( &(N), &(N), &grp->P ) )
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001073
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02001074#if defined(ECP_SHORTWEIERSTRASS)
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +01001075/*
1076 * For curves in short Weierstrass form, we do all the internal operations in
1077 * Jacobian coordinates.
1078 *
1079 * For multiplication, we'll use a comb method with coutermeasueres against
1080 * SPA, hence timing attacks.
1081 */
1082
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001083/*
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +01001084 * Normalize jacobian coordinates so that Z == 0 || Z == 1 (GECC 3.2.1)
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001085 * Cost: 1N := 1I + 3M + 1S
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001086 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001087static int ecp_normalize_jac( const mbedtls_ecp_group *grp, mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001088{
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +01001089 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001090 mbedtls_mpi Zi, ZZi;
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001091
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001092 if( mbedtls_mpi_cmp_int( &pt->Z, 0 ) == 0 )
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001093 return( 0 );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001094
Janos Follathb0697532016-08-18 12:38:46 +01001095#if defined(MBEDTLS_ECP_NORMALIZE_JAC_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001096 if( mbedtls_internal_ecp_grp_capable( grp ) )
1097 return( mbedtls_internal_ecp_normalize_jac( grp, pt ) );
Janos Follath372697b2016-10-28 16:53:11 +01001098#endif /* MBEDTLS_ECP_NORMALIZE_JAC_ALT */
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001099
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001100 mbedtls_mpi_init( &Zi ); mbedtls_mpi_init( &ZZi );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001101
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +01001102 /*
1103 * X = X / Z^2 mod p
1104 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001105 MBEDTLS_MPI_CHK( mbedtls_mpi_inv_mod( &Zi, &pt->Z, &grp->P ) );
1106 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &ZZi, &Zi, &Zi ) ); MOD_MUL( ZZi );
1107 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->X, &pt->X, &ZZi ) ); MOD_MUL( pt->X );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001108
1109 /*
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +01001110 * Y = Y / Z^3 mod p
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001111 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001112 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->Y, &pt->Y, &ZZi ) ); MOD_MUL( pt->Y );
1113 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->Y, &pt->Y, &Zi ) ); MOD_MUL( pt->Y );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001114
1115 /*
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +01001116 * Z = 1
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001117 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001118 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &pt->Z, 1 ) );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001119
1120cleanup:
1121
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001122 mbedtls_mpi_free( &Zi ); mbedtls_mpi_free( &ZZi );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001123
1124 return( ret );
1125}
1126
1127/*
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001128 * Normalize jacobian coordinates of an array of (pointers to) points,
Manuel Pégourié-Gonnard3680c822012-11-21 18:49:45 +01001129 * using Montgomery's trick to perform only one inversion mod P.
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001130 * (See for example Cohen's "A Course in Computational Algebraic Number
1131 * Theory", Algorithm 10.3.4.)
1132 *
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001133 * Warning: fails (returning an error) if one of the points is zero!
Manuel Pégourié-Gonnard7a949d32013-12-05 10:26:01 +01001134 * This should never happen, see choice of w in ecp_mul_comb().
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001135 *
1136 * Cost: 1N(t) := 1I + (6t - 3)M + 1S
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001137 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001138static int ecp_normalize_jac_many( const mbedtls_ecp_group *grp,
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001139 mbedtls_ecp_point *T[], size_t T_size )
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001140{
1141 int ret;
1142 size_t i;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001143 mbedtls_mpi *c, u, Zi, ZZi;
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001144
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001145 if( T_size < 2 )
Manuel Pégourié-Gonnard3c0b4ea2013-12-02 19:44:41 +01001146 return( ecp_normalize_jac( grp, *T ) );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001147
Janos Follathb0697532016-08-18 12:38:46 +01001148#if defined(MBEDTLS_ECP_NORMALIZE_JAC_MANY_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001149 if( mbedtls_internal_ecp_grp_capable( grp ) )
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001150 return( mbedtls_internal_ecp_normalize_jac_many( grp, T, T_size ) );
Janos Follathb0697532016-08-18 12:38:46 +01001151#endif
1152
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001153 if( ( c = mbedtls_calloc( T_size, sizeof( mbedtls_mpi ) ) ) == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02001154 return( MBEDTLS_ERR_ECP_ALLOC_FAILED );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001155
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +02001156 for( i = 0; i < T_size; i++ )
1157 mbedtls_mpi_init( &c[i] );
1158
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001159 mbedtls_mpi_init( &u ); mbedtls_mpi_init( &Zi ); mbedtls_mpi_init( &ZZi );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001160
1161 /*
1162 * c[i] = Z_0 * ... * Z_i
1163 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001164 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &c[0], &T[0]->Z ) );
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001165 for( i = 1; i < T_size; i++ )
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001166 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001167 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &c[i], &c[i-1], &T[i]->Z ) );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001168 MOD_MUL( c[i] );
1169 }
1170
1171 /*
1172 * u = 1 / (Z_0 * ... * Z_n) mod P
1173 */
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001174 MBEDTLS_MPI_CHK( mbedtls_mpi_inv_mod( &u, &c[T_size-1], &grp->P ) );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001175
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001176 for( i = T_size - 1; ; i-- )
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001177 {
1178 /*
1179 * Zi = 1 / Z_i mod p
1180 * u = 1 / (Z_0 * ... * Z_i) mod P
1181 */
1182 if( i == 0 ) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001183 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &Zi, &u ) );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001184 }
1185 else
1186 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001187 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &Zi, &u, &c[i-1] ) ); MOD_MUL( Zi );
1188 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &u, &u, &T[i]->Z ) ); MOD_MUL( u );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001189 }
1190
1191 /*
1192 * proceed as in normalize()
1193 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001194 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &ZZi, &Zi, &Zi ) ); MOD_MUL( ZZi );
1195 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T[i]->X, &T[i]->X, &ZZi ) ); MOD_MUL( T[i]->X );
1196 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T[i]->Y, &T[i]->Y, &ZZi ) ); MOD_MUL( T[i]->Y );
1197 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T[i]->Y, &T[i]->Y, &Zi ) ); MOD_MUL( T[i]->Y );
Manuel Pégourié-Gonnard1f789b82013-12-30 17:31:56 +01001198
1199 /*
1200 * Post-precessing: reclaim some memory by shrinking coordinates
1201 * - not storing Z (always 1)
1202 * - shrinking other coordinates, but still keeping the same number of
1203 * limbs as P, as otherwise it will too likely be regrown too fast.
1204 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001205 MBEDTLS_MPI_CHK( mbedtls_mpi_shrink( &T[i]->X, grp->P.n ) );
1206 MBEDTLS_MPI_CHK( mbedtls_mpi_shrink( &T[i]->Y, grp->P.n ) );
1207 mbedtls_mpi_free( &T[i]->Z );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001208
1209 if( i == 0 )
1210 break;
1211 }
1212
1213cleanup:
1214
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001215 mbedtls_mpi_free( &u ); mbedtls_mpi_free( &Zi ); mbedtls_mpi_free( &ZZi );
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001216 for( i = 0; i < T_size; i++ )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001217 mbedtls_mpi_free( &c[i] );
1218 mbedtls_free( c );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001219
1220 return( ret );
1221}
1222
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001223/*
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001224 * Conditional point inversion: Q -> -Q = (Q.X, -Q.Y, Q.Z) without leak.
1225 * "inv" must be 0 (don't invert) or 1 (invert) or the result will be invalid
1226 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001227static int ecp_safe_invert_jac( const mbedtls_ecp_group *grp,
1228 mbedtls_ecp_point *Q,
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001229 unsigned char inv )
1230{
1231 int ret;
1232 unsigned char nonzero;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001233 mbedtls_mpi mQY;
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001234
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001235 mbedtls_mpi_init( &mQY );
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001236
1237 /* Use the fact that -Q.Y mod P = P - Q.Y unless Q.Y == 0 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001238 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &mQY, &grp->P, &Q->Y ) );
1239 nonzero = mbedtls_mpi_cmp_int( &Q->Y, 0 ) != 0;
1240 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_assign( &Q->Y, &mQY, inv & nonzero ) );
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001241
1242cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001243 mbedtls_mpi_free( &mQY );
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001244
1245 return( ret );
1246}
1247
1248/*
Manuel Pégourié-Gonnard0cd6f982013-10-10 15:55:39 +02001249 * Point doubling R = 2 P, Jacobian coordinates
Manuel Pégourié-Gonnard0ace4b32013-10-10 12:44:27 +02001250 *
Peter Dettmance661b22015-02-07 14:43:51 +07001251 * Based on http://www.hyperelliptic.org/EFD/g1p/auto-shortw-jacobian.html#doubling-dbl-1998-cmo-2 .
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001252 *
Peter Dettmance661b22015-02-07 14:43:51 +07001253 * We follow the variable naming fairly closely. The formula variations that trade a MUL for a SQR
1254 * (plus a few ADDs) aren't useful as our bignum implementation doesn't distinguish squaring.
1255 *
1256 * Standard optimizations are applied when curve parameter A is one of { 0, -3 }.
1257 *
1258 * Cost: 1D := 3M + 4S (A == 0)
1259 * 4M + 4S (A == -3)
1260 * 3M + 6S + 1a otherwise
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001261 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001262static int ecp_double_jac( const mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
1263 const mbedtls_ecp_point *P )
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001264{
1265 int ret;
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001266 mbedtls_mpi M, S, T, U;
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001267
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001268#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnard0cd6f982013-10-10 15:55:39 +02001269 dbl_count++;
1270#endif
1271
Janos Follathb0697532016-08-18 12:38:46 +01001272#if defined(MBEDTLS_ECP_DOUBLE_JAC_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001273 if( mbedtls_internal_ecp_grp_capable( grp ) )
1274 return( mbedtls_internal_ecp_double_jac( grp, R, P ) );
Janos Follath372697b2016-10-28 16:53:11 +01001275#endif /* MBEDTLS_ECP_DOUBLE_JAC_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01001276
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001277 mbedtls_mpi_init( &M ); mbedtls_mpi_init( &S ); mbedtls_mpi_init( &T ); mbedtls_mpi_init( &U );
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01001278
1279 /* Special case for A = -3 */
1280 if( grp->A.p == NULL )
1281 {
Peter Dettmance661b22015-02-07 14:43:51 +07001282 /* M = 3(X + Z^2)(X - Z^2) */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001283 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &P->Z, &P->Z ) ); MOD_MUL( S );
1284 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &T, &P->X, &S ) ); MOD_ADD( T );
1285 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &U, &P->X, &S ) ); MOD_SUB( U );
1286 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &T, &U ) ); MOD_MUL( S );
1287 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_int( &M, &S, 3 ) ); MOD_ADD( M );
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01001288 }
1289 else
Peter Vaskovica676acf2014-08-06 00:48:39 +02001290 {
Peter Dettmance661b22015-02-07 14:43:51 +07001291 /* M = 3.X^2 */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001292 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &P->X, &P->X ) ); MOD_MUL( S );
1293 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_int( &M, &S, 3 ) ); MOD_ADD( M );
Peter Dettmance661b22015-02-07 14:43:51 +07001294
1295 /* Optimize away for "koblitz" curves with A = 0 */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001296 if( mbedtls_mpi_cmp_int( &grp->A, 0 ) != 0 )
Peter Dettmance661b22015-02-07 14:43:51 +07001297 {
1298 /* M += A.Z^4 */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001299 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &P->Z, &P->Z ) ); MOD_MUL( S );
1300 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T, &S, &S ) ); MOD_MUL( T );
1301 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &T, &grp->A ) ); MOD_MUL( S );
1302 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &M, &M, &S ) ); MOD_ADD( M );
Peter Dettmance661b22015-02-07 14:43:51 +07001303 }
Peter Vaskovica676acf2014-08-06 00:48:39 +02001304 }
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01001305
Peter Dettmance661b22015-02-07 14:43:51 +07001306 /* S = 4.X.Y^2 */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001307 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T, &P->Y, &P->Y ) ); MOD_MUL( T );
1308 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_l( &T, 1 ) ); MOD_ADD( T );
1309 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &P->X, &T ) ); MOD_MUL( S );
1310 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_l( &S, 1 ) ); MOD_ADD( S );
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001311
Peter Dettmance661b22015-02-07 14:43:51 +07001312 /* U = 8.Y^4 */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001313 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &U, &T, &T ) ); MOD_MUL( U );
1314 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_l( &U, 1 ) ); MOD_ADD( U );
Peter Dettmance661b22015-02-07 14:43:51 +07001315
1316 /* T = M^2 - 2.S */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001317 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T, &M, &M ) ); MOD_MUL( T );
1318 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &T, &T, &S ) ); MOD_SUB( T );
1319 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &T, &T, &S ) ); MOD_SUB( T );
Peter Dettmance661b22015-02-07 14:43:51 +07001320
1321 /* S = M(S - T) - U */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001322 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &S, &S, &T ) ); MOD_SUB( S );
1323 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &S, &M ) ); MOD_MUL( S );
1324 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &S, &S, &U ) ); MOD_SUB( S );
Peter Dettmance661b22015-02-07 14:43:51 +07001325
1326 /* U = 2.Y.Z */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001327 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &U, &P->Y, &P->Z ) ); MOD_MUL( U );
1328 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_l( &U, 1 ) ); MOD_ADD( U );
Peter Dettmance661b22015-02-07 14:43:51 +07001329
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001330 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->X, &T ) );
1331 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->Y, &S ) );
1332 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->Z, &U ) );
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001333
1334cleanup:
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001335 mbedtls_mpi_free( &M ); mbedtls_mpi_free( &S ); mbedtls_mpi_free( &T ); mbedtls_mpi_free( &U );
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001336
1337 return( ret );
1338}
1339
1340/*
Manuel Pégourié-Gonnard469a2092013-11-21 18:20:43 +01001341 * Addition: R = P + Q, mixed affine-Jacobian coordinates (GECC 3.22)
Manuel Pégourié-Gonnard9674fd02012-11-19 21:23:27 +01001342 *
1343 * The coordinates of Q must be normalized (= affine),
1344 * but those of P don't need to. R is not normalized.
1345 *
Manuel Pégourié-Gonnardaade42f2013-11-21 19:19:54 +01001346 * Special cases: (1) P or Q is zero, (2) R is zero, (3) P == Q.
Manuel Pégourié-Gonnard7a949d32013-12-05 10:26:01 +01001347 * None of these cases can happen as intermediate step in ecp_mul_comb():
Manuel Pégourié-Gonnardaade42f2013-11-21 19:19:54 +01001348 * - at each step, P, Q and R are multiples of the base point, the factor
1349 * being less than its order, so none of them is zero;
1350 * - Q is an odd multiple of the base point, P an even multiple,
1351 * due to the choice of precomputed points in the modified comb method.
1352 * So branches for these cases do not leak secret information.
1353 *
Manuel Pégourié-Gonnard72c172a2013-12-30 16:04:55 +01001354 * We accept Q->Z being unset (saving memory in tables) as meaning 1.
1355 *
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001356 * Cost: 1A := 8M + 3S
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001357 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001358static int ecp_add_mixed( const mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
1359 const mbedtls_ecp_point *P, const mbedtls_ecp_point *Q )
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001360{
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +01001361 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001362 mbedtls_mpi T1, T2, T3, T4, X, Y, Z;
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001363
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001364#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01001365 add_count++;
1366#endif
1367
Janos Follathb0697532016-08-18 12:38:46 +01001368#if defined(MBEDTLS_ECP_ADD_MIXED_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001369 if( mbedtls_internal_ecp_grp_capable( grp ) )
1370 return( mbedtls_internal_ecp_add_mixed( grp, R, P, Q ) );
Janos Follath372697b2016-10-28 16:53:11 +01001371#endif /* MBEDTLS_ECP_ADD_MIXED_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01001372
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001373 /*
Manuel Pégourié-Gonnardaade42f2013-11-21 19:19:54 +01001374 * Trivial cases: P == 0 or Q == 0 (case 1)
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001375 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001376 if( mbedtls_mpi_cmp_int( &P->Z, 0 ) == 0 )
1377 return( mbedtls_ecp_copy( R, Q ) );
Manuel Pégourié-Gonnard469a2092013-11-21 18:20:43 +01001378
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001379 if( Q->Z.p != NULL && mbedtls_mpi_cmp_int( &Q->Z, 0 ) == 0 )
1380 return( mbedtls_ecp_copy( R, P ) );
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +01001381
1382 /*
1383 * Make sure Q coordinates are normalized
1384 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001385 if( Q->Z.p != NULL && mbedtls_mpi_cmp_int( &Q->Z, 1 ) != 0 )
1386 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001387
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001388 mbedtls_mpi_init( &T1 ); mbedtls_mpi_init( &T2 ); mbedtls_mpi_init( &T3 ); mbedtls_mpi_init( &T4 );
1389 mbedtls_mpi_init( &X ); mbedtls_mpi_init( &Y ); mbedtls_mpi_init( &Z );
Manuel Pégourié-Gonnardab38b702012-11-05 17:34:55 +01001390
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001391 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T1, &P->Z, &P->Z ) ); MOD_MUL( T1 );
1392 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T2, &T1, &P->Z ) ); MOD_MUL( T2 );
1393 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T1, &T1, &Q->X ) ); MOD_MUL( T1 );
1394 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T2, &T2, &Q->Y ) ); MOD_MUL( T2 );
1395 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &T1, &T1, &P->X ) ); MOD_SUB( T1 );
1396 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &T2, &T2, &P->Y ) ); MOD_SUB( T2 );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001397
Manuel Pégourié-Gonnardaade42f2013-11-21 19:19:54 +01001398 /* Special cases (2) and (3) */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001399 if( mbedtls_mpi_cmp_int( &T1, 0 ) == 0 )
Manuel Pégourié-Gonnard7e0adfb2012-11-08 23:21:46 +01001400 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001401 if( mbedtls_mpi_cmp_int( &T2, 0 ) == 0 )
Manuel Pégourié-Gonnard7e0adfb2012-11-08 23:21:46 +01001402 {
1403 ret = ecp_double_jac( grp, R, P );
1404 goto cleanup;
1405 }
1406 else
1407 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001408 ret = mbedtls_ecp_set_zero( R );
Manuel Pégourié-Gonnard7e0adfb2012-11-08 23:21:46 +01001409 goto cleanup;
1410 }
1411 }
1412
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001413 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &Z, &P->Z, &T1 ) ); MOD_MUL( Z );
1414 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T3, &T1, &T1 ) ); MOD_MUL( T3 );
1415 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T4, &T3, &T1 ) ); MOD_MUL( T4 );
1416 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T3, &T3, &P->X ) ); MOD_MUL( T3 );
1417 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_int( &T1, &T3, 2 ) ); MOD_ADD( T1 );
1418 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &X, &T2, &T2 ) ); MOD_MUL( X );
1419 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &X, &X, &T1 ) ); MOD_SUB( X );
1420 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &X, &X, &T4 ) ); MOD_SUB( X );
1421 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &T3, &T3, &X ) ); MOD_SUB( T3 );
1422 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T3, &T3, &T2 ) ); MOD_MUL( T3 );
1423 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T4, &T4, &P->Y ) ); MOD_MUL( T4 );
1424 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &Y, &T3, &T4 ) ); MOD_SUB( Y );
Manuel Pégourié-Gonnard7e0adfb2012-11-08 23:21:46 +01001425
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001426 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->X, &X ) );
1427 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->Y, &Y ) );
1428 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->Z, &Z ) );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001429
1430cleanup:
1431
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001432 mbedtls_mpi_free( &T1 ); mbedtls_mpi_free( &T2 ); mbedtls_mpi_free( &T3 ); mbedtls_mpi_free( &T4 );
1433 mbedtls_mpi_free( &X ); mbedtls_mpi_free( &Y ); mbedtls_mpi_free( &Z );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001434
1435 return( ret );
1436}
1437
1438/*
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001439 * Randomize jacobian coordinates:
1440 * (X, Y, Z) -> (l^2 X, l^3 Y, l Z) for random l
Manuel Pégourié-Gonnard3c0b4ea2013-12-02 19:44:41 +01001441 * This is sort of the reverse operation of ecp_normalize_jac().
Manuel Pégourié-Gonnard44aab792013-11-21 10:53:59 +01001442 *
1443 * This countermeasure was first suggested in [2].
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001444 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001445static int ecp_randomize_jac( const mbedtls_ecp_group *grp, mbedtls_ecp_point *pt,
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001446 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
1447{
1448 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001449 mbedtls_mpi l, ll;
Janos Follathb0697532016-08-18 12:38:46 +01001450 size_t p_size;
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001451 int count = 0;
1452
Janos Follathb0697532016-08-18 12:38:46 +01001453#if defined(MBEDTLS_ECP_RANDOMIZE_JAC_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001454 if( mbedtls_internal_ecp_grp_capable( grp ) )
1455 return( mbedtls_internal_ecp_randomize_jac( grp, pt, f_rng, p_rng ) );
Janos Follath372697b2016-10-28 16:53:11 +01001456#endif /* MBEDTLS_ECP_RANDOMIZE_JAC_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01001457
1458 p_size = ( grp->pbits + 7 ) / 8;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001459 mbedtls_mpi_init( &l ); mbedtls_mpi_init( &ll );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001460
1461 /* Generate l such that 1 < l < p */
1462 do
1463 {
Ron Eldorca6ff582017-01-12 14:50:50 +02001464 MBEDTLS_MPI_CHK( mbedtls_mpi_fill_random( &l, p_size, f_rng, p_rng ) );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001465
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001466 while( mbedtls_mpi_cmp_mpi( &l, &grp->P ) >= 0 )
1467 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_r( &l, 1 ) );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001468
1469 if( count++ > 10 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001470 return( MBEDTLS_ERR_ECP_RANDOM_FAILED );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001471 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001472 while( mbedtls_mpi_cmp_int( &l, 1 ) <= 0 );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001473
1474 /* Z = l * Z */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001475 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->Z, &pt->Z, &l ) ); MOD_MUL( pt->Z );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001476
1477 /* X = l^2 * X */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001478 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &ll, &l, &l ) ); MOD_MUL( ll );
1479 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->X, &pt->X, &ll ) ); MOD_MUL( pt->X );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001480
1481 /* Y = l^3 * Y */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001482 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &ll, &ll, &l ) ); MOD_MUL( ll );
1483 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->Y, &pt->Y, &ll ) ); MOD_MUL( pt->Y );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001484
1485cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001486 mbedtls_mpi_free( &l ); mbedtls_mpi_free( &ll );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001487
1488 return( ret );
1489}
1490
1491/*
Manuel Pégourié-Gonnardc30200e2013-11-20 18:39:55 +01001492 * Check and define parameters used by the comb method (see below for details)
1493 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001494#if MBEDTLS_ECP_WINDOW_SIZE < 2 || MBEDTLS_ECP_WINDOW_SIZE > 7
1495#error "MBEDTLS_ECP_WINDOW_SIZE out of bounds"
Manuel Pégourié-Gonnardc30200e2013-11-20 18:39:55 +01001496#endif
1497
1498/* d = ceil( n / w ) */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001499#define COMB_MAX_D ( MBEDTLS_ECP_MAX_BITS + 1 ) / 2
Manuel Pégourié-Gonnardc30200e2013-11-20 18:39:55 +01001500
1501/* number of precomputed points */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001502#define COMB_MAX_PRE ( 1 << ( MBEDTLS_ECP_WINDOW_SIZE - 1 ) )
Manuel Pégourié-Gonnardc30200e2013-11-20 18:39:55 +01001503
1504/*
1505 * Compute the representation of m that will be used with our comb method.
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001506 *
1507 * The basic comb method is described in GECC 3.44 for example. We use a
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001508 * modified version that provides resistance to SPA by avoiding zero
1509 * digits in the representation as in [3]. We modify the method further by
1510 * requiring that all K_i be odd, which has the small cost that our
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001511 * representation uses one more K_i, due to carries, but saves on the size of
1512 * the precomputed table.
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001513 *
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001514 * Summary of the comb method and its modifications:
1515 *
1516 * - The goal is to compute m*P for some w*d-bit integer m.
1517 *
1518 * - The basic comb method splits m into the w-bit integers
1519 * x[0] .. x[d-1] where x[i] consists of the bits in m whose
1520 * index has residue i modulo d, and computes m * P as
1521 * S[x[0]] + 2 * S[x[1]] + .. + 2^(d-1) S[x[d-1]], where
1522 * S[i_{w-1} .. i_0] := i_{w-1} 2^{(w-1)d} P + ... + i_1 2^d P + i_0 P.
1523 *
1524 * - If it happens that, say, x[i+1]=0 (=> S[x[i+1]]=0), one can replace the sum by
1525 * .. + 2^{i-1} S[x[i-1]] - 2^i S[x[i]] + 2^{i+1} S[x[i]] + 2^{i+2} S[x[i+2]] ..,
1526 * thereby successively converting it into a form where all summands
1527 * are nonzero, at the cost of negative summands. This is the basic idea of [3].
1528 *
1529 * - More generally, even if x[i+1] != 0, we can first transform the sum as
1530 * .. - 2^i S[x[i]] + 2^{i+1} ( S[x[i]] + S[x[i+1]] ) + 2^{i+2} S[x[i+2]] ..,
1531 * and then replace S[x[i]] + S[x[i+1]] = S[x[i] ^ x[i+1]] + 2 S[x[i] & x[i+1]].
1532 * Performing and iterating this procedure for those x[i] that are even
1533 * (keeping track of carry), we can transform the original sum into one of the form
1534 * S[x'[0]] +- 2 S[x'[1]] +- .. +- 2^{d-1} S[x'[d-1]] + 2^d S[x'[d]]
1535 * with all x'[i] odd. It is therefore only necessary to know S at odd indices,
1536 * which is why we are only computing half of it in the first place in
1537 * ecp_precompute_comb and accessing it with index abs(i) / 2 in ecp_select_comb.
1538 *
1539 * - For the sake of compactness, only the seven low-order bits of x[i]
1540 * are used to represent its absolute value (K_i in the paper), and the msb
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001541 * of x[i] encodes the sign (s_i in the paper): it is set if and only if
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001542 * if s_i == -1;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001543 *
1544 * Calling conventions:
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001545 * - x is an array of size d + 1
Manuel Pégourié-Gonnardc30200e2013-11-20 18:39:55 +01001546 * - w is the size, ie number of teeth, of the comb, and must be between
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001547 * 2 and 7 (in practice, between 2 and MBEDTLS_ECP_WINDOW_SIZE)
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001548 * - m is the MPI, expected to be odd and such that bitlength(m) <= w * d
1549 * (the result will be incorrect if these assumptions are not satisfied)
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001550 */
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001551static void ecp_comb_recode_core( unsigned char x[], size_t d,
1552 unsigned char w, const mbedtls_mpi *m )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001553{
1554 size_t i, j;
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001555 unsigned char c, cc, adjust;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001556
Manuel Pégourié-Gonnard7a346b82019-10-02 14:47:01 +02001557 mbedtls_platform_memset( x, 0, d+1 );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001558
Manuel Pégourié-Gonnardedc1a1f2013-11-21 09:50:00 +01001559 /* First get the classical comb values (except for x_d = 0) */
1560 for( i = 0; i < d; i++ )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001561 for( j = 0; j < w; j++ )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001562 x[i] |= mbedtls_mpi_get_bit( m, i + d * j ) << j;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001563
Manuel Pégourié-Gonnardedc1a1f2013-11-21 09:50:00 +01001564 /* Now make sure x_1 .. x_d are odd */
1565 c = 0;
1566 for( i = 1; i <= d; i++ )
1567 {
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001568 /* Add carry and update it */
1569 cc = x[i] & c;
1570 x[i] = x[i] ^ c;
1571 c = cc;
1572
Manuel Pégourié-Gonnardedc1a1f2013-11-21 09:50:00 +01001573 /* Adjust if needed, avoiding branches */
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001574 adjust = 1 - ( x[i] & 0x01 );
1575 c |= x[i] & ( x[i-1] * adjust );
1576 x[i] = x[i] ^ ( x[i-1] * adjust );
1577 x[i-1] |= adjust << 7;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001578 }
1579}
1580
1581/*
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001582 * Precompute points for the adapted comb method
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001583 *
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001584 * Assumption: T must be able to hold 2^{w - 1} elements.
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001585 *
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001586 * Operation: If i = i_{w-1} ... i_1 is the binary representation of i,
1587 * sets T[i] = i_{w-1} 2^{(w-1)d} P + ... + i_1 2^d P + P.
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001588 *
1589 * Cost: d(w-1) D + (2^{w-1} - 1) A + 1 N(w-1) + 1 N(2^{w-1} - 1)
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001590 *
1591 * Note: Even comb values (those where P would be omitted from the
1592 * sum defining T[i] above) are not needed in our adaption
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001593 * the comb method. See ecp_comb_recode_core().
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001594 *
1595 * This function currently works in four steps:
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001596 * (1) [dbl] Computation of intermediate T[i] for 2-power values of i
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001597 * (2) [norm_dbl] Normalization of coordinates of these T[i]
1598 * (3) [add] Computation of all T[i]
1599 * (4) [norm_add] Normalization of all T[i]
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001600 *
1601 * Step 1 can be interrupted but not the others; together with the final
1602 * coordinate normalization they are the largest steps done at once, depending
1603 * on the window size. Here are operation counts for P-256:
1604 *
1605 * step (2) (3) (4)
1606 * w = 5 142 165 208
1607 * w = 4 136 77 160
1608 * w = 3 130 33 136
1609 * w = 2 124 11 124
1610 *
1611 * So if ECC operations are blocking for too long even with a low max_ops
1612 * value, it's useful to set MBEDTLS_ECP_WINDOW_SIZE to a lower value in order
1613 * to minimize maximum blocking time.
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001614 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001615static int ecp_precompute_comb( const mbedtls_ecp_group *grp,
1616 mbedtls_ecp_point T[], const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001617 unsigned char w, size_t d,
1618 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001619{
1620 int ret;
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001621 unsigned char i;
Manuel Pégourié-Gonnard213541a2017-03-20 12:50:41 +01001622 size_t j = 0;
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001623 const unsigned char T_size = 1U << ( w - 1 );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001624 mbedtls_ecp_point *cur, *TT[COMB_MAX_PRE - 1];
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001625
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001626#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001627 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01001628 {
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001629 if( rs_ctx->rsm->state == ecp_rsm_pre_dbl )
1630 goto dbl;
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001631 if( rs_ctx->rsm->state == ecp_rsm_pre_norm_dbl )
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001632 goto norm_dbl;
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001633 if( rs_ctx->rsm->state == ecp_rsm_pre_add )
1634 goto add;
1635 if( rs_ctx->rsm->state == ecp_rsm_pre_norm_add )
1636 goto norm_add;
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01001637 }
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001638#else
1639 (void) rs_ctx;
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01001640#endif
1641
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001642#if defined(MBEDTLS_ECP_RESTARTABLE)
1643 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1644 {
1645 rs_ctx->rsm->state = ecp_rsm_pre_dbl;
1646
1647 /* initial state for the loop */
1648 rs_ctx->rsm->i = 0;
1649 }
1650
1651dbl:
1652#endif
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001653 /*
1654 * Set T[0] = P and
1655 * T[2^{l-1}] = 2^{dl} P for l = 1 .. w-1 (this is not the final value)
1656 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001657 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( &T[0], P ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001658
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001659#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001660 if( rs_ctx != NULL && rs_ctx->rsm != NULL && rs_ctx->rsm->i != 0 )
1661 j = rs_ctx->rsm->i;
Manuel Pégourié-Gonnard213541a2017-03-20 12:50:41 +01001662 else
1663#endif
1664 j = 0;
1665
1666 for( ; j < d * ( w - 1 ); j++ )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001667 {
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02001668 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_DBL );
Manuel Pégourié-Gonnard213541a2017-03-20 12:50:41 +01001669
Manuel Pégourié-Gonnardae557072017-03-20 12:21:24 +01001670 i = 1U << ( j / d );
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001671 cur = T + i;
Manuel Pégourié-Gonnardae557072017-03-20 12:21:24 +01001672
1673 if( j % d == 0 )
1674 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( cur, T + ( i >> 1 ) ) );
1675
1676 MBEDTLS_MPI_CHK( ecp_double_jac( grp, cur, cur ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001677 }
1678
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001679#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001680 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1681 rs_ctx->rsm->state = ecp_rsm_pre_norm_dbl;
1682
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001683norm_dbl:
1684#endif
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001685 /*
1686 * Normalize current elements in T. As T has holes,
1687 * use an auxiliary array of pointers to elements in T.
1688 */
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001689 j = 0;
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001690 for( i = 1; i < T_size; i <<= 1 )
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001691 TT[j++] = T + i;
1692
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02001693 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_INV + 6 * j - 2 );
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001694
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001695 MBEDTLS_MPI_CHK( ecp_normalize_jac_many( grp, TT, j ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001696
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001697#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001698 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1699 rs_ctx->rsm->state = ecp_rsm_pre_add;
1700
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001701add:
1702#endif
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001703 /*
1704 * Compute the remaining ones using the minimal number of additions
1705 * Be careful to update T[2^l] only after using it!
1706 */
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001707 MBEDTLS_ECP_BUDGET( ( T_size - 1 ) * MBEDTLS_ECP_OPS_ADD );
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001708
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001709 for( i = 1; i < T_size; i <<= 1 )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001710 {
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001711 j = i;
1712 while( j-- )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001713 MBEDTLS_MPI_CHK( ecp_add_mixed( grp, &T[i + j], &T[j], &T[i] ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001714 }
1715
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001716#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001717 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1718 rs_ctx->rsm->state = ecp_rsm_pre_norm_add;
1719
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001720norm_add:
1721#endif
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001722 /*
Manuel Pégourié-Gonnarda966fde2018-10-23 10:41:11 +02001723 * Normalize final elements in T. Even though there are no holes now, we
1724 * still need the auxiliary array for homogeneity with the previous
1725 * call. Also, skip T[0] which is already normalised, being a copy of P.
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001726 */
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001727 for( j = 0; j + 1 < T_size; j++ )
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001728 TT[j] = T + j + 1;
1729
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02001730 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_INV + 6 * j - 2 );
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001731
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001732 MBEDTLS_MPI_CHK( ecp_normalize_jac_many( grp, TT, j ) );
Manuel Pégourié-Gonnarde2820122013-11-21 10:08:50 +01001733
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001734cleanup:
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001735#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001736 if( rs_ctx != NULL && rs_ctx->rsm != NULL &&
1737 ret == MBEDTLS_ERR_ECP_IN_PROGRESS )
Manuel Pégourié-Gonnard213541a2017-03-20 12:50:41 +01001738 {
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001739 if( rs_ctx->rsm->state == ecp_rsm_pre_dbl )
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001740 rs_ctx->rsm->i = j;
Manuel Pégourié-Gonnard213541a2017-03-20 12:50:41 +01001741 }
1742#endif
Janos Follathb0697532016-08-18 12:38:46 +01001743
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001744 return( ret );
1745}
1746
1747/*
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001748 * Select precomputed point: R = sign(i) * T[ abs(i) / 2 ]
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001749 *
1750 * See ecp_comb_recode_core() for background
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001751 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001752static int ecp_select_comb( const mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001753 const mbedtls_ecp_point T[], unsigned char T_size,
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001754 unsigned char i )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001755{
1756 int ret;
Kevin Braceya967a582020-11-04 16:28:48 +02001757 uint_fast8_t ii, j;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001758
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001759 /* Ignore the "sign" bit and scale down */
1760 ii = ( i & 0x7Fu ) >> 1;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001761
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001762 /* Read the whole table to thwart cache-based timing attacks */
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001763 for( j = 0; j < T_size; j++ )
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001764 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001765 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_assign( &R->X, &T[j].X, j == ii ) );
1766 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_assign( &R->Y, &T[j].Y, j == ii ) );
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001767 }
1768
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001769 /* Safely invert result if i is "negative" */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001770 MBEDTLS_MPI_CHK( ecp_safe_invert_jac( grp, R, i >> 7 ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001771
1772cleanup:
1773 return( ret );
1774}
1775
1776/*
1777 * Core multiplication algorithm for the (modified) comb method.
1778 * This part is actually common with the basic comb method (GECC 3.44)
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001779 *
1780 * Cost: d A + d D + 1 R
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001781 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001782static int ecp_mul_comb_core( const mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001783 const mbedtls_ecp_point T[], unsigned char T_size,
Manuel Pégourié-Gonnard70c14372013-11-20 20:07:26 +01001784 const unsigned char x[], size_t d,
1785 int (*f_rng)(void *, unsigned char *, size_t),
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001786 void *p_rng,
1787 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001788{
1789 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001790 mbedtls_ecp_point Txi;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001791 size_t i;
1792
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001793 mbedtls_ecp_point_init( &Txi );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001794
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001795#if !defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001796 (void) rs_ctx;
1797#endif
1798
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001799#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001800 if( rs_ctx != NULL && rs_ctx->rsm != NULL &&
1801 rs_ctx->rsm->state != ecp_rsm_comb_core )
1802 {
1803 rs_ctx->rsm->i = 0;
1804 rs_ctx->rsm->state = ecp_rsm_comb_core;
1805 }
1806
1807 /* new 'if' instead of nested for the sake of the 'else' branch */
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001808 if( rs_ctx != NULL && rs_ctx->rsm != NULL && rs_ctx->rsm->i != 0 )
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +01001809 {
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001810 /* restore current index (R already pointing to rs_ctx->rsm->R) */
1811 i = rs_ctx->rsm->i;
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +01001812 }
1813 else
1814#endif
1815 {
1816 /* Start with a non-zero point and randomize its coordinates */
1817 i = d;
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001818 MBEDTLS_MPI_CHK( ecp_select_comb( grp, R, T, T_size, x[i] ) );
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +01001819 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &R->Z, 1 ) );
1820 if( f_rng != 0 )
1821 MBEDTLS_MPI_CHK( ecp_randomize_jac( grp, R, f_rng, p_rng ) );
1822 }
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001823
Manuel Pégourié-Gonnard90f31b72018-10-16 10:45:24 +02001824 while( i != 0 )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001825 {
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02001826 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_DBL + MBEDTLS_ECP_OPS_ADD );
Manuel Pégourié-Gonnard90f31b72018-10-16 10:45:24 +02001827 --i;
1828
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001829 MBEDTLS_MPI_CHK( ecp_double_jac( grp, R, R ) );
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001830 MBEDTLS_MPI_CHK( ecp_select_comb( grp, &Txi, T, T_size, x[i] ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001831 MBEDTLS_MPI_CHK( ecp_add_mixed( grp, R, R, &Txi ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001832 }
1833
1834cleanup:
Janos Follathb0697532016-08-18 12:38:46 +01001835
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001836 mbedtls_ecp_point_free( &Txi );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001837
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001838#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001839 if( rs_ctx != NULL && rs_ctx->rsm != NULL &&
1840 ret == MBEDTLS_ERR_ECP_IN_PROGRESS )
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +01001841 {
Manuel Pégourié-Gonnard90f31b72018-10-16 10:45:24 +02001842 rs_ctx->rsm->i = i;
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001843 /* no need to save R, already pointing to rs_ctx->rsm->R */
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +01001844 }
1845#endif
1846
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001847 return( ret );
1848}
1849
1850/*
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001851 * Recode the scalar to get constant-time comb multiplication
1852 *
1853 * As the actual scalar recoding needs an odd scalar as a starting point,
1854 * this wrapper ensures that by replacing m by N - m if necessary, and
1855 * informs the caller that the result of multiplication will be negated.
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001856 *
Manuel Pégourié-Gonnardfd87e352017-08-24 14:21:05 +02001857 * This works because we only support large prime order for Short Weierstrass
1858 * curves, so N is always odd hence either m or N - m is.
1859 *
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001860 * See ecp_comb_recode_core() for background.
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001861 */
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001862static int ecp_comb_recode_scalar( const mbedtls_ecp_group *grp,
1863 const mbedtls_mpi *m,
1864 unsigned char k[COMB_MAX_D + 1],
1865 size_t d,
1866 unsigned char w,
1867 unsigned char *parity_trick )
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001868{
1869 int ret;
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001870 mbedtls_mpi M, mm;
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001871
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001872 mbedtls_mpi_init( &M );
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001873 mbedtls_mpi_init( &mm );
1874
Manuel Pégourié-Gonnardfd87e352017-08-24 14:21:05 +02001875 /* N is always odd (see above), just make extra sure */
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001876 if( mbedtls_mpi_get_bit( &grp->N, 0 ) != 1 )
1877 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
1878
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001879 /* do we need the parity trick? */
1880 *parity_trick = ( mbedtls_mpi_get_bit( m, 0 ) == 0 );
1881
1882 /* execute parity fix in constant time */
1883 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &M, m ) );
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001884 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &mm, &grp->N, m ) );
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001885 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_assign( &M, &mm, *parity_trick ) );
1886
1887 /* actual scalar recoding */
1888 ecp_comb_recode_core( k, d, w, &M );
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001889
1890cleanup:
1891 mbedtls_mpi_free( &mm );
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001892 mbedtls_mpi_free( &M );
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001893
1894 return( ret );
1895}
1896
1897/*
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001898 * Perform comb multiplication (for short Weierstrass curves)
1899 * once the auxiliary table has been pre-computed.
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001900 *
1901 * Scalar recoding may use a parity trick that makes us compute -m * P,
1902 * if that is the case we'll need to recover m * P at the end.
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001903 */
1904static int ecp_mul_comb_after_precomp( const mbedtls_ecp_group *grp,
1905 mbedtls_ecp_point *R,
1906 const mbedtls_mpi *m,
1907 const mbedtls_ecp_point *T,
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001908 unsigned char T_size,
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001909 unsigned char w,
1910 size_t d,
1911 int (*f_rng)(void *, unsigned char *, size_t),
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001912 void *p_rng,
1913 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001914{
1915 int ret;
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001916 unsigned char parity_trick;
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001917 unsigned char k[COMB_MAX_D + 1];
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +01001918 mbedtls_ecp_point *RR = R;
1919
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001920#if defined(MBEDTLS_ECP_RESTARTABLE)
1921 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1922 {
1923 RR = &rs_ctx->rsm->R;
1924
1925 if( rs_ctx->rsm->state == ecp_rsm_final_norm )
1926 goto final_norm;
1927 }
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +01001928#endif
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001929
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001930 MBEDTLS_MPI_CHK( ecp_comb_recode_scalar( grp, m, k, d, w,
1931 &parity_trick ) );
1932 MBEDTLS_MPI_CHK( ecp_mul_comb_core( grp, RR, T, T_size, k, d,
1933 f_rng, p_rng, rs_ctx ) );
1934 MBEDTLS_MPI_CHK( ecp_safe_invert_jac( grp, RR, parity_trick ) );
1935
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001936#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001937 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001938 rs_ctx->rsm->state = ecp_rsm_final_norm;
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001939
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001940final_norm:
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +01001941#endif
Andrzej Kurek825ebd42020-05-18 11:47:25 -04001942 /*
1943 * Knowledge of the jacobian coordinates may leak the last few bits of the
1944 * scalar [1], and since our MPI implementation isn't constant-flow,
1945 * inversion (used for coordinate normalization) may leak the full value
1946 * of its input via side-channels [2].
1947 *
1948 * [1] https://eprint.iacr.org/2003/191
1949 * [2] https://eprint.iacr.org/2020/055
1950 *
1951 * Avoid the leak by randomizing coordinates before we normalize them.
1952 */
1953 if( f_rng != 0 )
1954 MBEDTLS_MPI_CHK( ecp_randomize_jac( grp, RR, f_rng, p_rng ) );
1955
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02001956 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_INV );
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +01001957 MBEDTLS_MPI_CHK( ecp_normalize_jac( grp, RR ) );
1958
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001959#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard28d16282017-08-23 17:33:27 +02001960 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1961 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( R, RR ) );
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +01001962#endif
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001963
1964cleanup:
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001965 return( ret );
1966}
1967
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001968/*
Manuel Pégourié-Gonnard4b2336d2017-03-09 13:23:50 +01001969 * Pick window size based on curve size and whether we optimize for base point
1970 */
1971static unsigned char ecp_pick_window_size( const mbedtls_ecp_group *grp,
1972 unsigned char p_eq_g )
1973{
1974 unsigned char w;
1975
1976 /*
1977 * Minimize the number of multiplications, that is minimize
1978 * 10 * d * w + 18 * 2^(w-1) + 11 * d + 7 * w, with d = ceil( nbits / w )
1979 * (see costs of the various parts, with 1S = 1M)
1980 */
1981 w = grp->nbits >= 384 ? 5 : 4;
1982
1983 /*
1984 * If P == G, pre-compute a bit more, since this may be re-used later.
1985 * Just adding one avoids upping the cost of the first mul too much,
1986 * and the memory cost too.
1987 */
1988 if( p_eq_g )
1989 w++;
1990
1991 /*
1992 * Make sure w is within bounds.
1993 * (The last test is useful only for very small curves in the test suite.)
1994 */
1995 if( w > MBEDTLS_ECP_WINDOW_SIZE )
1996 w = MBEDTLS_ECP_WINDOW_SIZE;
1997 if( w >= grp->nbits )
1998 w = 2;
1999
2000 return( w );
2001}
2002
2003/*
Manuel Pégourié-Gonnard07bf6f52017-03-16 17:21:38 +01002004 * Multiplication using the comb method - for curves in short Weierstrass form
2005 *
2006 * This function is mainly responsible for administrative work:
2007 * - managing the restart context if enabled
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002008 * - managing the table of precomputed points (passed between the below two
Manuel Pégourié-Gonnard07bf6f52017-03-16 17:21:38 +01002009 * functions): allocation, computation, ownership tranfer, freeing.
2010 *
2011 * It delegates the actual arithmetic work to:
2012 * ecp_precompute_comb() and ecp_mul_comb_with_precomp()
2013 *
2014 * See comments on ecp_comb_recode_core() regarding the computation strategy.
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002015 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002016static int ecp_mul_comb( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
2017 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002018 int (*f_rng)(void *, unsigned char *, size_t),
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002019 void *p_rng,
2020 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002021{
2022 int ret;
Kevin Braceya967a582020-11-04 16:28:48 +02002023 unsigned char w, p_eq_g;
2024 uint_fast8_t i;
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01002025 size_t d;
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002026 unsigned char T_size, T_ok;
2027 mbedtls_ecp_point *T;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002028
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +02002029 ECP_RS_ENTER( rsm );
Manuel Pégourié-Gonnard510d5ca2017-03-08 11:41:47 +01002030
Manuel Pégourié-Gonnard22be6352017-03-09 13:02:35 +01002031 /* Is P the base point ? */
2032#if MBEDTLS_ECP_FIXED_POINT_OPTIM == 1
2033 p_eq_g = ( mbedtls_mpi_cmp_mpi( &P->Y, &grp->G.Y ) == 0 &&
2034 mbedtls_mpi_cmp_mpi( &P->X, &grp->G.X ) == 0 );
Manuel Pégourié-Gonnard196d1332017-08-28 13:14:27 +02002035#else
2036 p_eq_g = 0;
Manuel Pégourié-Gonnard22be6352017-03-09 13:02:35 +01002037#endif
2038
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01002039 /* Pick window size and deduce related sizes */
Manuel Pégourié-Gonnard4b2336d2017-03-09 13:23:50 +01002040 w = ecp_pick_window_size( grp, p_eq_g );
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002041 T_size = 1U << ( w - 1 );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002042 d = ( grp->nbits + w - 1 ) / w;
2043
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002044 /* Pre-computed table: do we have it already for the base point? */
2045 if( p_eq_g && grp->T != NULL )
2046 {
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02002047 /* second pointer to the same table, will be deleted on exit */
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002048 T = grp->T;
2049 T_ok = 1;
2050 }
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002051 else
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002052#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002053 /* Pre-computed table: do we have one in progress? complete? */
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002054 if( rs_ctx != NULL && rs_ctx->rsm != NULL && rs_ctx->rsm->T != NULL )
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +01002055 {
Manuel Pégourié-Gonnard45fd0162017-03-22 08:24:42 +01002056 /* transfer ownership of T from rsm to local function */
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002057 T = rs_ctx->rsm->T;
2058 rs_ctx->rsm->T = NULL;
2059 rs_ctx->rsm->T_size = 0;
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002060
Manuel Pégourié-Gonnardb25cb602018-10-16 11:48:09 +02002061 /* This effectively jumps to the call to mul_comb_after_precomp() */
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002062 T_ok = rs_ctx->rsm->state >= ecp_rsm_comb_core;
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +01002063 }
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002064 else
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +01002065#endif
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002066 /* Allocate table if we didn't have any */
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002067 {
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002068 T = mbedtls_calloc( T_size, sizeof( mbedtls_ecp_point ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002069 if( T == NULL )
2070 {
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02002071 ret = MBEDTLS_ERR_ECP_ALLOC_FAILED;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002072 goto cleanup;
2073 }
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +02002074
2075 for( i = 0; i < T_size; i++ )
2076 mbedtls_ecp_point_init( &T[i] );
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002077
2078 T_ok = 0;
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002079 }
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002080
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002081 /* Compute table (or finish computing it) if not done already */
2082 if( !T_ok )
2083 {
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002084 MBEDTLS_MPI_CHK( ecp_precompute_comb( grp, T, P, w, d, rs_ctx ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002085
2086 if( p_eq_g )
2087 {
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02002088 /* almost transfer ownership of T to the group, but keep a copy of
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02002089 * the pointer to use for calling the next function more easily */
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002090 grp->T = T;
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002091 grp->T_size = T_size;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002092 }
2093 }
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002094
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01002095 /* Actual comb multiplication using precomputed points */
2096 MBEDTLS_MPI_CHK( ecp_mul_comb_after_precomp( grp, R, m,
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002097 T, T_size, w, d,
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002098 f_rng, p_rng, rs_ctx ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002099
2100cleanup:
2101
Manuel Pégourié-Gonnard07bf6f52017-03-16 17:21:38 +01002102 /* does T belong to the group? */
2103 if( T == grp->T )
2104 T = NULL;
2105
2106 /* does T belong to the restart context? */
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002107#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002108 if( rs_ctx != NULL && rs_ctx->rsm != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS && T != NULL )
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +01002109 {
Manuel Pégourié-Gonnard45fd0162017-03-22 08:24:42 +01002110 /* transfer ownership of T from local function to rsm */
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002111 rs_ctx->rsm->T_size = T_size;
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002112 rs_ctx->rsm->T = T;
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +01002113 T = NULL;
2114 }
2115#endif
2116
Manuel Pégourié-Gonnard07bf6f52017-03-16 17:21:38 +01002117 /* did T belong to us? then let's destroy it! */
2118 if( T != NULL )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002119 {
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002120 for( i = 0; i < T_size; i++ )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002121 mbedtls_ecp_point_free( &T[i] );
2122 mbedtls_free( T );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002123 }
2124
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +01002125 /* don't free R while in progress in case R == P */
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002126#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +01002127 if( ret != MBEDTLS_ERR_ECP_IN_PROGRESS )
2128#endif
Manuel Pégourié-Gonnard07bf6f52017-03-16 17:21:38 +01002129 /* prevent caller from using invalid value */
Manuel Pégourié-Gonnardaade42f2013-11-21 19:19:54 +01002130 if( ret != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002131 mbedtls_ecp_point_free( R );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002132
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +02002133 ECP_RS_LEAVE( rsm );
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +01002134
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002135 return( ret );
2136}
2137
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002138#endif /* ECP_SHORTWEIERSTRASS */
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +01002139
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002140#if defined(ECP_MONTGOMERY)
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +01002141/*
2142 * For Montgomery curves, we do all the internal arithmetic in projective
2143 * coordinates. Import/export of points uses only the x coordinates, which is
2144 * internaly represented as X / Z.
2145 *
2146 * For scalar multiplication, we'll use a Montgomery ladder.
2147 */
2148
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002149/*
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002150 * Normalize Montgomery x/z coordinates: X = X/Z, Z = 1
2151 * Cost: 1M + 1I
2152 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002153static int ecp_normalize_mxz( const mbedtls_ecp_group *grp, mbedtls_ecp_point *P )
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002154{
2155 int ret;
2156
Janos Follathb0697532016-08-18 12:38:46 +01002157#if defined(MBEDTLS_ECP_NORMALIZE_MXZ_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002158 if( mbedtls_internal_ecp_grp_capable( grp ) )
2159 return( mbedtls_internal_ecp_normalize_mxz( grp, P ) );
Janos Follath372697b2016-10-28 16:53:11 +01002160#endif /* MBEDTLS_ECP_NORMALIZE_MXZ_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01002161
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002162 MBEDTLS_MPI_CHK( mbedtls_mpi_inv_mod( &P->Z, &P->Z, &grp->P ) );
2163 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &P->X, &P->X, &P->Z ) ); MOD_MUL( P->X );
2164 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &P->Z, 1 ) );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002165
2166cleanup:
2167 return( ret );
2168}
2169
2170/*
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002171 * Randomize projective x/z coordinates:
2172 * (X, Z) -> (l X, l Z) for random l
2173 * This is sort of the reverse operation of ecp_normalize_mxz().
2174 *
2175 * This countermeasure was first suggested in [2].
2176 * Cost: 2M
2177 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002178static int ecp_randomize_mxz( const mbedtls_ecp_group *grp, mbedtls_ecp_point *P,
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002179 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
2180{
2181 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002182 mbedtls_mpi l;
Janos Follathb0697532016-08-18 12:38:46 +01002183 size_t p_size;
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002184 int count = 0;
2185
Janos Follathb0697532016-08-18 12:38:46 +01002186#if defined(MBEDTLS_ECP_RANDOMIZE_MXZ_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002187 if( mbedtls_internal_ecp_grp_capable( grp ) )
2188 return( mbedtls_internal_ecp_randomize_mxz( grp, P, f_rng, p_rng );
Janos Follath372697b2016-10-28 16:53:11 +01002189#endif /* MBEDTLS_ECP_RANDOMIZE_MXZ_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01002190
2191 p_size = ( grp->pbits + 7 ) / 8;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002192 mbedtls_mpi_init( &l );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002193
2194 /* Generate l such that 1 < l < p */
2195 do
2196 {
Ron Eldorca6ff582017-01-12 14:50:50 +02002197 MBEDTLS_MPI_CHK( mbedtls_mpi_fill_random( &l, p_size, f_rng, p_rng ) );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002198
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002199 while( mbedtls_mpi_cmp_mpi( &l, &grp->P ) >= 0 )
2200 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_r( &l, 1 ) );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002201
2202 if( count++ > 10 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002203 return( MBEDTLS_ERR_ECP_RANDOM_FAILED );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002204 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002205 while( mbedtls_mpi_cmp_int( &l, 1 ) <= 0 );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002206
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002207 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &P->X, &P->X, &l ) ); MOD_MUL( P->X );
2208 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &P->Z, &P->Z, &l ) ); MOD_MUL( P->Z );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002209
2210cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002211 mbedtls_mpi_free( &l );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002212
2213 return( ret );
2214}
2215
2216/*
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002217 * Double-and-add: R = 2P, S = P + Q, with d = X(P - Q),
2218 * for Montgomery curves in x/z coordinates.
2219 *
2220 * http://www.hyperelliptic.org/EFD/g1p/auto-code/montgom/xz/ladder/mladd-1987-m.op3
2221 * with
2222 * d = X1
2223 * P = (X2, Z2)
2224 * Q = (X3, Z3)
2225 * R = (X4, Z4)
2226 * S = (X5, Z5)
2227 * and eliminating temporary variables tO, ..., t4.
2228 *
2229 * Cost: 5M + 4S
2230 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002231static int ecp_double_add_mxz( const mbedtls_ecp_group *grp,
2232 mbedtls_ecp_point *R, mbedtls_ecp_point *S,
2233 const mbedtls_ecp_point *P, const mbedtls_ecp_point *Q,
2234 const mbedtls_mpi *d )
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002235{
2236 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002237 mbedtls_mpi A, AA, B, BB, E, C, D, DA, CB;
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002238
Janos Follathb0697532016-08-18 12:38:46 +01002239#if defined(MBEDTLS_ECP_DOUBLE_ADD_MXZ_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002240 if( mbedtls_internal_ecp_grp_capable( grp ) )
2241 return( mbedtls_internal_ecp_double_add_mxz( grp, R, S, P, Q, d ) );
Janos Follath372697b2016-10-28 16:53:11 +01002242#endif /* MBEDTLS_ECP_DOUBLE_ADD_MXZ_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01002243
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002244 mbedtls_mpi_init( &A ); mbedtls_mpi_init( &AA ); mbedtls_mpi_init( &B );
2245 mbedtls_mpi_init( &BB ); mbedtls_mpi_init( &E ); mbedtls_mpi_init( &C );
2246 mbedtls_mpi_init( &D ); mbedtls_mpi_init( &DA ); mbedtls_mpi_init( &CB );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002247
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002248 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &A, &P->X, &P->Z ) ); MOD_ADD( A );
2249 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &AA, &A, &A ) ); MOD_MUL( AA );
2250 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &B, &P->X, &P->Z ) ); MOD_SUB( B );
2251 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &BB, &B, &B ) ); MOD_MUL( BB );
2252 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &E, &AA, &BB ) ); MOD_SUB( E );
2253 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &C, &Q->X, &Q->Z ) ); MOD_ADD( C );
2254 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &D, &Q->X, &Q->Z ) ); MOD_SUB( D );
2255 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &DA, &D, &A ) ); MOD_MUL( DA );
2256 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &CB, &C, &B ) ); MOD_MUL( CB );
2257 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &S->X, &DA, &CB ) ); MOD_MUL( S->X );
2258 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S->X, &S->X, &S->X ) ); MOD_MUL( S->X );
2259 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &S->Z, &DA, &CB ) ); MOD_SUB( S->Z );
2260 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S->Z, &S->Z, &S->Z ) ); MOD_MUL( S->Z );
2261 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S->Z, d, &S->Z ) ); MOD_MUL( S->Z );
2262 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &R->X, &AA, &BB ) ); MOD_MUL( R->X );
2263 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &R->Z, &grp->A, &E ) ); MOD_MUL( R->Z );
2264 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &R->Z, &BB, &R->Z ) ); MOD_ADD( R->Z );
2265 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &R->Z, &E, &R->Z ) ); MOD_MUL( R->Z );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002266
2267cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002268 mbedtls_mpi_free( &A ); mbedtls_mpi_free( &AA ); mbedtls_mpi_free( &B );
2269 mbedtls_mpi_free( &BB ); mbedtls_mpi_free( &E ); mbedtls_mpi_free( &C );
2270 mbedtls_mpi_free( &D ); mbedtls_mpi_free( &DA ); mbedtls_mpi_free( &CB );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002271
2272 return( ret );
2273}
2274
2275/*
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002276 * Multiplication with Montgomery ladder in x/z coordinates,
2277 * for curves in Montgomery form
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002278 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002279static int ecp_mul_mxz( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
2280 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002281 int (*f_rng)(void *, unsigned char *, size_t),
2282 void *p_rng )
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002283{
2284 int ret;
2285 size_t i;
Manuel Pégourié-Gonnardb6f45a62013-12-04 21:54:36 +01002286 unsigned char b;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002287 mbedtls_ecp_point RP;
2288 mbedtls_mpi PX;
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002289
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002290 mbedtls_ecp_point_init( &RP ); mbedtls_mpi_init( &PX );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002291
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002292 /* Save PX and read from P before writing to R, in case P == R */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002293 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &PX, &P->X ) );
2294 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( &RP, P ) );
Manuel Pégourié-Gonnard357ff652013-12-04 18:39:17 +01002295
2296 /* Set R to zero in modified x/z coordinates */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002297 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &R->X, 1 ) );
2298 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &R->Z, 0 ) );
2299 mbedtls_mpi_free( &R->Y );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002300
Manuel Pégourié-Gonnard93f41db2013-12-05 10:48:42 +01002301 /* RP.X might be sligtly larger than P, so reduce it */
2302 MOD_ADD( RP.X );
2303
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002304 /* Randomize coordinates of the starting point */
Manuel Pégourié-Gonnard357ff652013-12-04 18:39:17 +01002305 if( f_rng != NULL )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002306 MBEDTLS_MPI_CHK( ecp_randomize_mxz( grp, &RP, f_rng, p_rng ) );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002307
Manuel Pégourié-Gonnardb6f45a62013-12-04 21:54:36 +01002308 /* Loop invariant: R = result so far, RP = R + P */
Manuel Pégourié-Gonnardc0696c22015-06-18 16:47:17 +02002309 i = mbedtls_mpi_bitlen( m ); /* one past the (zero-based) most significant bit */
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002310 while( i-- > 0 )
2311 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002312 b = mbedtls_mpi_get_bit( m, i );
Manuel Pégourié-Gonnardb6f45a62013-12-04 21:54:36 +01002313 /*
2314 * if (b) R = 2R + P else R = 2R,
2315 * which is:
2316 * if (b) double_add( RP, R, RP, R )
2317 * else double_add( R, RP, R, RP )
2318 * but using safe conditional swaps to avoid leaks
2319 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002320 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_swap( &R->X, &RP.X, b ) );
2321 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_swap( &R->Z, &RP.Z, b ) );
2322 MBEDTLS_MPI_CHK( ecp_double_add_mxz( grp, R, &RP, R, &RP, &PX ) );
2323 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_swap( &R->X, &RP.X, b ) );
2324 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_swap( &R->Z, &RP.Z, b ) );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002325 }
2326
Andrzej Kurek825ebd42020-05-18 11:47:25 -04002327 /*
2328 * Knowledge of the projective coordinates may leak the last few bits of the
2329 * scalar [1], and since our MPI implementation isn't constant-flow,
2330 * inversion (used for coordinate normalization) may leak the full value
2331 * of its input via side-channels [2].
2332 *
2333 * [1] https://eprint.iacr.org/2003/191
2334 * [2] https://eprint.iacr.org/2020/055
2335 *
2336 * Avoid the leak by randomizing coordinates before we normalize them.
2337 */
2338 if( f_rng != NULL )
2339 MBEDTLS_MPI_CHK( ecp_randomize_mxz( grp, R, f_rng, p_rng ) );
2340
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002341 MBEDTLS_MPI_CHK( ecp_normalize_mxz( grp, R ) );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002342
2343cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002344 mbedtls_ecp_point_free( &RP ); mbedtls_mpi_free( &PX );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002345
2346 return( ret );
2347}
2348
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002349#endif /* ECP_MONTGOMERY */
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +01002350
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002351/*
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002352 * Restartable multiplication R = m * P
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002353 */
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002354int mbedtls_ecp_mul_restartable( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002355 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002356 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng,
2357 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002358{
Janos Follathb0697532016-08-18 12:38:46 +01002359 int ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
Janos Follathc44ab972016-11-18 16:38:23 +00002360#if defined(MBEDTLS_ECP_INTERNAL_ALT)
2361 char is_grp_capable = 0;
2362#endif
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002363 ECP_VALIDATE_RET( grp != NULL );
2364 ECP_VALIDATE_RET( R != NULL );
2365 ECP_VALIDATE_RET( m != NULL );
2366 ECP_VALIDATE_RET( P != NULL );
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002367
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002368#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002369 /* reset ops count for this call if top-level */
2370 if( rs_ctx != NULL && rs_ctx->depth++ == 0 )
2371 rs_ctx->ops_done = 0;
2372#endif
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002373
Janos Follathc44ab972016-11-18 16:38:23 +00002374#if defined(MBEDTLS_ECP_INTERNAL_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002375 if( ( is_grp_capable = mbedtls_internal_ecp_grp_capable( grp ) ) )
Janos Follathc44ab972016-11-18 16:38:23 +00002376 MBEDTLS_MPI_CHK( mbedtls_internal_ecp_init( grp ) );
Janos Follathc44ab972016-11-18 16:38:23 +00002377#endif /* MBEDTLS_ECP_INTERNAL_ALT */
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002378
Manuel Pégourié-Gonnard95aedfe2017-08-24 13:47:04 +02002379#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnarda08cd1a2017-04-20 11:29:43 +02002380 /* skip argument check when restarting */
Manuel Pégourié-Gonnard95aedfe2017-08-24 13:47:04 +02002381 if( rs_ctx == NULL || rs_ctx->rsm == NULL )
Manuel Pégourié-Gonnarda08cd1a2017-04-20 11:29:43 +02002382#endif
2383 {
Manuel Pégourié-Gonnard5314f232017-04-21 12:36:59 +02002384 /* check_privkey is free */
2385 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_CHK );
2386
Manuel Pégourié-Gonnarda08cd1a2017-04-20 11:29:43 +02002387 /* Common sanity checks */
2388 MBEDTLS_MPI_CHK( mbedtls_ecp_check_privkey( grp, m ) );
2389 MBEDTLS_MPI_CHK( mbedtls_ecp_check_pubkey( grp, P ) );
Manuel Pégourié-Gonnarda08cd1a2017-04-20 11:29:43 +02002390 }
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002391
2392 ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002393#if defined(ECP_MONTGOMERY)
2394 if( ecp_get_type( grp ) == ECP_TYPE_MONTGOMERY )
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002395 MBEDTLS_MPI_CHK( ecp_mul_mxz( grp, R, m, P, f_rng, p_rng ) );
Janos Follath430d3372016-11-03 14:25:37 +00002396#endif
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002397#if defined(ECP_SHORTWEIERSTRASS)
2398 if( ecp_get_type( grp ) == ECP_TYPE_SHORT_WEIERSTRASS )
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002399 MBEDTLS_MPI_CHK( ecp_mul_comb( grp, R, m, P, f_rng, p_rng, rs_ctx ) );
Janos Follath430d3372016-11-03 14:25:37 +00002400#endif
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002401
Janos Follath6c8ccd52016-11-29 15:37:09 +00002402cleanup:
Janos Follathb0697532016-08-18 12:38:46 +01002403
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002404#if defined(MBEDTLS_ECP_INTERNAL_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002405 if( is_grp_capable )
Janos Follathc44ab972016-11-18 16:38:23 +00002406 mbedtls_internal_ecp_free( grp );
Janos Follathc44ab972016-11-18 16:38:23 +00002407#endif /* MBEDTLS_ECP_INTERNAL_ALT */
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002408
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002409#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002410 if( rs_ctx != NULL )
2411 rs_ctx->depth--;
2412#endif
2413
Janos Follathb0697532016-08-18 12:38:46 +01002414 return( ret );
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002415}
2416
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002417/*
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002418 * Multiplication R = m * P
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002419 */
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002420int mbedtls_ecp_mul( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002421 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002422 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002423{
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002424 ECP_VALIDATE_RET( grp != NULL );
2425 ECP_VALIDATE_RET( R != NULL );
2426 ECP_VALIDATE_RET( m != NULL );
2427 ECP_VALIDATE_RET( P != NULL );
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002428 return( mbedtls_ecp_mul_restartable( grp, R, m, P, f_rng, p_rng, NULL ) );
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002429}
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002430
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002431#if defined(ECP_SHORTWEIERSTRASS)
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002432/*
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002433 * Check that an affine point is valid as a public key,
2434 * short weierstrass curves (SEC1 3.2.3.1)
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002435 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002436static int ecp_check_pubkey_sw( const mbedtls_ecp_group *grp, const mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002437{
2438 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002439 mbedtls_mpi YY, RHS;
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002440
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +01002441 /* pt coordinates must be normalized for our checks */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002442 if( mbedtls_mpi_cmp_int( &pt->X, 0 ) < 0 ||
2443 mbedtls_mpi_cmp_int( &pt->Y, 0 ) < 0 ||
2444 mbedtls_mpi_cmp_mpi( &pt->X, &grp->P ) >= 0 ||
2445 mbedtls_mpi_cmp_mpi( &pt->Y, &grp->P ) >= 0 )
2446 return( MBEDTLS_ERR_ECP_INVALID_KEY );
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002447
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002448 mbedtls_mpi_init( &YY ); mbedtls_mpi_init( &RHS );
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002449
2450 /*
2451 * YY = Y^2
Manuel Pégourié-Gonnardcd7458a2013-10-08 13:11:30 +02002452 * RHS = X (X^2 + A) + B = X^3 + A X + B
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002453 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002454 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &YY, &pt->Y, &pt->Y ) ); MOD_MUL( YY );
2455 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &RHS, &pt->X, &pt->X ) ); MOD_MUL( RHS );
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01002456
2457 /* Special case for A = -3 */
2458 if( grp->A.p == NULL )
2459 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002460 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_int( &RHS, &RHS, 3 ) ); MOD_SUB( RHS );
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01002461 }
2462 else
2463 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002464 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &RHS, &RHS, &grp->A ) ); MOD_ADD( RHS );
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01002465 }
2466
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002467 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &RHS, &RHS, &pt->X ) ); MOD_MUL( RHS );
2468 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &RHS, &RHS, &grp->B ) ); MOD_ADD( RHS );
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002469
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002470 if( mbedtls_mpi_cmp_mpi( &YY, &RHS ) != 0 )
2471 ret = MBEDTLS_ERR_ECP_INVALID_KEY;
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002472
2473cleanup:
2474
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002475 mbedtls_mpi_free( &YY ); mbedtls_mpi_free( &RHS );
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002476
2477 return( ret );
2478}
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002479#endif /* ECP_SHORTWEIERSTRASS */
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002480
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002481/*
Manuel Pégourié-Gonnardde9f9532015-10-23 15:50:37 +02002482 * R = m * P with shortcuts for m == 1 and m == -1
2483 * NOT constant-time - ONLY for short Weierstrass!
2484 */
2485static int mbedtls_ecp_mul_shortcuts( mbedtls_ecp_group *grp,
2486 mbedtls_ecp_point *R,
2487 const mbedtls_mpi *m,
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002488 const mbedtls_ecp_point *P,
2489 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnardde9f9532015-10-23 15:50:37 +02002490{
2491 int ret;
2492
2493 if( mbedtls_mpi_cmp_int( m, 1 ) == 0 )
2494 {
2495 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( R, P ) );
2496 }
2497 else if( mbedtls_mpi_cmp_int( m, -1 ) == 0 )
2498 {
2499 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( R, P ) );
2500 if( mbedtls_mpi_cmp_int( &R->Y, 0 ) != 0 )
2501 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &R->Y, &grp->P, &R->Y ) );
2502 }
2503 else
2504 {
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002505 MBEDTLS_MPI_CHK( mbedtls_ecp_mul_restartable( grp, R, m, P,
2506 NULL, NULL, rs_ctx ) );
Manuel Pégourié-Gonnardde9f9532015-10-23 15:50:37 +02002507 }
2508
2509cleanup:
2510 return( ret );
2511}
2512
2513/*
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002514 * Restartable linear combination
Manuel Pégourié-Gonnardde9f9532015-10-23 15:50:37 +02002515 * NOT constant-time
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002516 */
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002517int mbedtls_ecp_muladd_restartable(
2518 mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002519 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002520 const mbedtls_mpi *n, const mbedtls_ecp_point *Q,
2521 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002522{
2523 int ret;
2524 mbedtls_ecp_point mP;
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002525 mbedtls_ecp_point *pmP = &mP;
2526 mbedtls_ecp_point *pR = R;
Janos Follathc44ab972016-11-18 16:38:23 +00002527#if defined(MBEDTLS_ECP_INTERNAL_ALT)
2528 char is_grp_capable = 0;
2529#endif
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002530 ECP_VALIDATE_RET( grp != NULL );
2531 ECP_VALIDATE_RET( R != NULL );
2532 ECP_VALIDATE_RET( m != NULL );
2533 ECP_VALIDATE_RET( P != NULL );
2534 ECP_VALIDATE_RET( n != NULL );
2535 ECP_VALIDATE_RET( Q != NULL );
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002536
2537 if( ecp_get_type( grp ) != ECP_TYPE_SHORT_WEIERSTRASS )
2538 return( MBEDTLS_ERR_ECP_FEATURE_UNAVAILABLE );
2539
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002540 mbedtls_ecp_point_init( &mP );
2541
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +02002542 ECP_RS_ENTER( ma );
2543
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002544#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002545 if( rs_ctx != NULL && rs_ctx->ma != NULL )
2546 {
2547 /* redirect intermediate results to restart context */
2548 pmP = &rs_ctx->ma->mP;
2549 pR = &rs_ctx->ma->R;
2550
2551 /* jump to next operation */
2552 if( rs_ctx->ma->state == ecp_rsma_mul2 )
2553 goto mul2;
2554 if( rs_ctx->ma->state == ecp_rsma_add )
2555 goto add;
2556 if( rs_ctx->ma->state == ecp_rsma_norm )
2557 goto norm;
2558 }
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002559#endif /* MBEDTLS_ECP_RESTARTABLE */
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002560
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002561 MBEDTLS_MPI_CHK( mbedtls_ecp_mul_shortcuts( grp, pmP, m, P, rs_ctx ) );
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002562#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002563 if( rs_ctx != NULL && rs_ctx->ma != NULL )
Manuel Pégourié-Gonnardc9efa002017-08-24 10:25:06 +02002564 rs_ctx->ma->state = ecp_rsma_mul2;
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002565
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002566mul2:
2567#endif
2568 MBEDTLS_MPI_CHK( mbedtls_ecp_mul_shortcuts( grp, pR, n, Q, rs_ctx ) );
Janos Follathaf6f2692018-12-07 09:55:24 +00002569
2570#if defined(MBEDTLS_ECP_INTERNAL_ALT)
2571 if( ( is_grp_capable = mbedtls_internal_ecp_grp_capable( grp ) ) )
2572 MBEDTLS_MPI_CHK( mbedtls_internal_ecp_init( grp ) );
2573#endif /* MBEDTLS_ECP_INTERNAL_ALT */
2574
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002575#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002576 if( rs_ctx != NULL && rs_ctx->ma != NULL )
Manuel Pégourié-Gonnardc9efa002017-08-24 10:25:06 +02002577 rs_ctx->ma->state = ecp_rsma_add;
Manuel Pégourié-Gonnard1a7c5ef2015-08-13 10:19:09 +02002578
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002579add:
2580#endif
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02002581 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_ADD );
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002582 MBEDTLS_MPI_CHK( ecp_add_mixed( grp, pR, pmP, pR ) );
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002583#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002584 if( rs_ctx != NULL && rs_ctx->ma != NULL )
Manuel Pégourié-Gonnardc9efa002017-08-24 10:25:06 +02002585 rs_ctx->ma->state = ecp_rsma_norm;
Janos Follath430d3372016-11-03 14:25:37 +00002586
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002587norm:
2588#endif
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02002589 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_INV );
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002590 MBEDTLS_MPI_CHK( ecp_normalize_jac( grp, pR ) );
2591
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002592#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002593 if( rs_ctx != NULL && rs_ctx->ma != NULL )
2594 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( R, pR ) );
2595#endif
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002596
2597cleanup:
Janos Follathc44ab972016-11-18 16:38:23 +00002598#if defined(MBEDTLS_ECP_INTERNAL_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002599 if( is_grp_capable )
Janos Follathc44ab972016-11-18 16:38:23 +00002600 mbedtls_internal_ecp_free( grp );
Janos Follathc44ab972016-11-18 16:38:23 +00002601#endif /* MBEDTLS_ECP_INTERNAL_ALT */
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002602
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002603 mbedtls_ecp_point_free( &mP );
2604
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +02002605 ECP_RS_LEAVE( ma );
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002606
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002607 return( ret );
2608}
2609
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002610/*
2611 * Linear combination
2612 * NOT constant-time
2613 */
2614int mbedtls_ecp_muladd( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
2615 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
2616 const mbedtls_mpi *n, const mbedtls_ecp_point *Q )
2617{
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002618 ECP_VALIDATE_RET( grp != NULL );
2619 ECP_VALIDATE_RET( R != NULL );
2620 ECP_VALIDATE_RET( m != NULL );
2621 ECP_VALIDATE_RET( P != NULL );
2622 ECP_VALIDATE_RET( n != NULL );
2623 ECP_VALIDATE_RET( Q != NULL );
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002624 return( mbedtls_ecp_muladd_restartable( grp, R, m, P, n, Q, NULL ) );
2625}
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002626
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002627#if defined(ECP_MONTGOMERY)
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002628/*
2629 * Check validity of a public key for Montgomery curves with x-only schemes
2630 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002631static int ecp_check_pubkey_mx( const mbedtls_ecp_group *grp, const mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002632{
Manuel Pégourié-Gonnard07894332015-06-23 00:18:41 +02002633 /* [Curve25519 p. 5] Just check X is the correct number of bytes */
Nicholas Wilson08f3ef12015-11-10 13:10:01 +00002634 /* Allow any public value, if it's too big then we'll just reduce it mod p
2635 * (RFC 7748 sec. 5 para. 3). */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002636 if( mbedtls_mpi_size( &pt->X ) > ( grp->nbits + 7 ) / 8 )
2637 return( MBEDTLS_ERR_ECP_INVALID_KEY );
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002638
2639 return( 0 );
2640}
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002641#endif /* ECP_MONTGOMERY */
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002642
2643/*
2644 * Check that a point is valid as a public key
2645 */
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002646int mbedtls_ecp_check_pubkey( const mbedtls_ecp_group *grp,
2647 const mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002648{
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002649 ECP_VALIDATE_RET( grp != NULL );
2650 ECP_VALIDATE_RET( pt != NULL );
2651
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002652 /* Must use affine coordinates */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002653 if( mbedtls_mpi_cmp_int( &pt->Z, 1 ) != 0 )
2654 return( MBEDTLS_ERR_ECP_INVALID_KEY );
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002655
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002656#if defined(ECP_MONTGOMERY)
2657 if( ecp_get_type( grp ) == ECP_TYPE_MONTGOMERY )
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002658 return( ecp_check_pubkey_mx( grp, pt ) );
2659#endif
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002660#if defined(ECP_SHORTWEIERSTRASS)
2661 if( ecp_get_type( grp ) == ECP_TYPE_SHORT_WEIERSTRASS )
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002662 return( ecp_check_pubkey_sw( grp, pt ) );
2663#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002664 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002665}
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002666
2667/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002668 * Check that an mbedtls_mpi is valid as a private key
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002669 */
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002670int mbedtls_ecp_check_privkey( const mbedtls_ecp_group *grp,
2671 const mbedtls_mpi *d )
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002672{
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002673 ECP_VALIDATE_RET( grp != NULL );
2674 ECP_VALIDATE_RET( d != NULL );
2675
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002676#if defined(ECP_MONTGOMERY)
2677 if( ecp_get_type( grp ) == ECP_TYPE_MONTGOMERY )
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +01002678 {
Nicholas Wilson08f3ef12015-11-10 13:10:01 +00002679 /* see RFC 7748 sec. 5 para. 5 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002680 if( mbedtls_mpi_get_bit( d, 0 ) != 0 ||
2681 mbedtls_mpi_get_bit( d, 1 ) != 0 ||
Manuel Pégourié-Gonnardc0696c22015-06-18 16:47:17 +02002682 mbedtls_mpi_bitlen( d ) - 1 != grp->nbits ) /* mbedtls_mpi_bitlen is one-based! */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002683 return( MBEDTLS_ERR_ECP_INVALID_KEY );
Nicholas Wilson08f3ef12015-11-10 13:10:01 +00002684
2685 /* see [Curve25519] page 5 */
2686 if( grp->nbits == 254 && mbedtls_mpi_get_bit( d, 2 ) != 0 )
2687 return( MBEDTLS_ERR_ECP_INVALID_KEY );
2688
2689 return( 0 );
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +01002690 }
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002691#endif /* ECP_MONTGOMERY */
2692#if defined(ECP_SHORTWEIERSTRASS)
2693 if( ecp_get_type( grp ) == ECP_TYPE_SHORT_WEIERSTRASS )
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +01002694 {
2695 /* see SEC1 3.2 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002696 if( mbedtls_mpi_cmp_int( d, 1 ) < 0 ||
2697 mbedtls_mpi_cmp_mpi( d, &grp->N ) >= 0 )
2698 return( MBEDTLS_ERR_ECP_INVALID_KEY );
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002699 else
2700 return( 0 );
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +01002701 }
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002702#endif /* ECP_SHORTWEIERSTRASS */
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002703
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002704 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002705}
2706
2707/*
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002708 * Generate a private key
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002709 */
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002710int mbedtls_ecp_gen_privkey( const mbedtls_ecp_group *grp,
2711 mbedtls_mpi *d,
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002712 int (*f_rng)(void *, unsigned char *, size_t),
2713 void *p_rng )
2714{
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002715 int ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002716 size_t n_size;
2717
2718 ECP_VALIDATE_RET( grp != NULL );
2719 ECP_VALIDATE_RET( d != NULL );
2720 ECP_VALIDATE_RET( f_rng != NULL );
2721
2722 n_size = ( grp->nbits + 7 ) / 8;
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002723
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002724#if defined(ECP_MONTGOMERY)
2725 if( ecp_get_type( grp ) == ECP_TYPE_MONTGOMERY )
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002726 {
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002727 /* [M225] page 5 */
2728 size_t b;
2729
Janos Follath98e28a72016-05-31 14:03:54 +01002730 do {
2731 MBEDTLS_MPI_CHK( mbedtls_mpi_fill_random( d, n_size, f_rng, p_rng ) );
2732 } while( mbedtls_mpi_bitlen( d ) == 0);
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002733
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002734 /* Make sure the most significant bit is nbits */
Manuel Pégourié-Gonnardc0696c22015-06-18 16:47:17 +02002735 b = mbedtls_mpi_bitlen( d ) - 1; /* mbedtls_mpi_bitlen is one-based */
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002736 if( b > grp->nbits )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002737 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_r( d, b - grp->nbits ) );
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002738 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002739 MBEDTLS_MPI_CHK( mbedtls_mpi_set_bit( d, grp->nbits, 1 ) );
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002740
Nicholas Wilson08f3ef12015-11-10 13:10:01 +00002741 /* Make sure the last two bits are unset for Curve448, three bits for
2742 Curve25519 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002743 MBEDTLS_MPI_CHK( mbedtls_mpi_set_bit( d, 0, 0 ) );
2744 MBEDTLS_MPI_CHK( mbedtls_mpi_set_bit( d, 1, 0 ) );
Nicholas Wilson08f3ef12015-11-10 13:10:01 +00002745 if( grp->nbits == 254 )
2746 {
2747 MBEDTLS_MPI_CHK( mbedtls_mpi_set_bit( d, 2, 0 ) );
2748 }
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002749 }
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002750#endif /* ECP_MONTGOMERY */
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002751
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002752#if defined(ECP_SHORTWEIERSTRASS)
2753 if( ecp_get_type( grp ) == ECP_TYPE_SHORT_WEIERSTRASS )
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002754 {
2755 /* SEC1 3.2.1: Generate d such that 1 <= n < N */
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002756 int count = 0;
Janos Follath8faf1d62019-10-11 14:21:53 +01002757 unsigned cmp = 0;
Manuel Pégourié-Gonnard79f73b92014-01-03 12:35:05 +01002758
2759 /*
2760 * Match the procedure given in RFC 6979 (deterministic ECDSA):
2761 * - use the same byte ordering;
2762 * - keep the leftmost nbits bits of the generated octet string;
2763 * - try until result is in the desired range.
2764 * This also avoids any biais, which is especially important for ECDSA.
2765 */
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002766 do
2767 {
Hanno Becker7c8cb9c2017-10-17 15:19:38 +01002768 MBEDTLS_MPI_CHK( mbedtls_mpi_fill_random( d, n_size, f_rng, p_rng ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002769 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_r( d, 8 * n_size - grp->nbits ) );
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002770
Manuel Pégourié-Gonnard6e8e34d2014-01-28 19:30:56 +01002771 /*
2772 * Each try has at worst a probability 1/2 of failing (the msb has
2773 * a probability 1/2 of being 0, and then the result will be < N),
2774 * so after 30 tries failure probability is a most 2**(-30).
2775 *
2776 * For most curves, 1 try is enough with overwhelming probability,
2777 * since N starts with a lot of 1s in binary, but some curves
2778 * such as secp224k1 are actually very close to the worst case.
2779 */
Manuel Pégourié-Gonnard67543962017-04-21 13:19:43 +02002780 if( ++count > 30 )
2781 return( MBEDTLS_ERR_ECP_RANDOM_FAILED );
Janos Follathfc2a8262019-09-16 14:27:39 +01002782
Janos Follath8faf1d62019-10-11 14:21:53 +01002783 ret = mbedtls_mpi_lt_mpi_ct( d, &grp->N, &cmp );
Janos Follathfc2a8262019-09-16 14:27:39 +01002784 if( ret != 0 )
2785 {
2786 goto cleanup;
2787 }
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002788 }
Janos Follath8faf1d62019-10-11 14:21:53 +01002789 while( mbedtls_mpi_cmp_int( d, 1 ) < 0 || cmp != 1 );
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002790 }
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002791#endif /* ECP_SHORTWEIERSTRASS */
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002792
Manuel Pégourié-Gonnardc9573992014-01-03 12:54:00 +01002793cleanup:
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002794 return( ret );
2795}
Manuel Pégourié-Gonnardc9573992014-01-03 12:54:00 +01002796
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002797/*
2798 * Generate a keypair with configurable base point
2799 */
2800int mbedtls_ecp_gen_keypair_base( mbedtls_ecp_group *grp,
2801 const mbedtls_ecp_point *G,
2802 mbedtls_mpi *d, mbedtls_ecp_point *Q,
2803 int (*f_rng)(void *, unsigned char *, size_t),
2804 void *p_rng )
2805{
2806 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002807 ECP_VALIDATE_RET( grp != NULL );
2808 ECP_VALIDATE_RET( d != NULL );
2809 ECP_VALIDATE_RET( G != NULL );
2810 ECP_VALIDATE_RET( Q != NULL );
2811 ECP_VALIDATE_RET( f_rng != NULL );
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002812
2813 MBEDTLS_MPI_CHK( mbedtls_ecp_gen_privkey( grp, d, f_rng, p_rng ) );
2814 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( grp, Q, d, G, f_rng, p_rng ) );
2815
2816cleanup:
2817 return( ret );
Manuel Pégourié-Gonnardd9a3f472015-08-11 14:31:03 +02002818}
2819
2820/*
2821 * Generate key pair, wrapper for conventional base point
2822 */
2823int mbedtls_ecp_gen_keypair( mbedtls_ecp_group *grp,
2824 mbedtls_mpi *d, mbedtls_ecp_point *Q,
2825 int (*f_rng)(void *, unsigned char *, size_t),
2826 void *p_rng )
2827{
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002828 ECP_VALIDATE_RET( grp != NULL );
2829 ECP_VALIDATE_RET( d != NULL );
2830 ECP_VALIDATE_RET( Q != NULL );
2831 ECP_VALIDATE_RET( f_rng != NULL );
2832
Manuel Pégourié-Gonnardd9a3f472015-08-11 14:31:03 +02002833 return( mbedtls_ecp_gen_keypair_base( grp, &grp->G, d, Q, f_rng, p_rng ) );
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002834}
Manuel Pégourié-Gonnardefaa31e2012-11-06 21:34:35 +01002835
Manuel Pégourié-Gonnard104ee1d2013-11-30 14:13:16 +01002836/*
2837 * Generate a keypair, prettier wrapper
2838 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002839int mbedtls_ecp_gen_key( mbedtls_ecp_group_id grp_id, mbedtls_ecp_keypair *key,
Manuel Pégourié-Gonnard104ee1d2013-11-30 14:13:16 +01002840 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
2841{
2842 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002843 ECP_VALIDATE_RET( key != NULL );
2844 ECP_VALIDATE_RET( f_rng != NULL );
Manuel Pégourié-Gonnard104ee1d2013-11-30 14:13:16 +01002845
Manuel Pégourié-Gonnarde3a062b2015-05-11 18:46:47 +02002846 if( ( ret = mbedtls_ecp_group_load( &key->grp, grp_id ) ) != 0 )
Manuel Pégourié-Gonnard104ee1d2013-11-30 14:13:16 +01002847 return( ret );
2848
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002849 return( mbedtls_ecp_gen_keypair( &key->grp, &key->d, &key->Q, f_rng, p_rng ) );
Manuel Pégourié-Gonnard104ee1d2013-11-30 14:13:16 +01002850}
2851
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002852/*
2853 * Check a public-private key pair
2854 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002855int mbedtls_ecp_check_pub_priv( const mbedtls_ecp_keypair *pub, const mbedtls_ecp_keypair *prv )
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002856{
2857 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002858 mbedtls_ecp_point Q;
2859 mbedtls_ecp_group grp;
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002860 ECP_VALIDATE_RET( pub != NULL );
2861 ECP_VALIDATE_RET( prv != NULL );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002862
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002863 if( pub->grp.id == MBEDTLS_ECP_DP_NONE ||
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002864 pub->grp.id != prv->grp.id ||
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002865 mbedtls_mpi_cmp_mpi( &pub->Q.X, &prv->Q.X ) ||
2866 mbedtls_mpi_cmp_mpi( &pub->Q.Y, &prv->Q.Y ) ||
2867 mbedtls_mpi_cmp_mpi( &pub->Q.Z, &prv->Q.Z ) )
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002868 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002869 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002870 }
2871
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002872 mbedtls_ecp_point_init( &Q );
2873 mbedtls_ecp_group_init( &grp );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002874
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002875 /* mbedtls_ecp_mul() needs a non-const group... */
2876 mbedtls_ecp_group_copy( &grp, &prv->grp );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002877
2878 /* Also checks d is valid */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002879 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &Q, &prv->d, &prv->grp.G, NULL, NULL ) );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002880
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002881 if( mbedtls_mpi_cmp_mpi( &Q.X, &prv->Q.X ) ||
2882 mbedtls_mpi_cmp_mpi( &Q.Y, &prv->Q.Y ) ||
2883 mbedtls_mpi_cmp_mpi( &Q.Z, &prv->Q.Z ) )
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002884 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002885 ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002886 goto cleanup;
2887 }
2888
2889cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002890 mbedtls_ecp_point_free( &Q );
2891 mbedtls_ecp_group_free( &grp );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002892
2893 return( ret );
2894}
2895
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002896#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01002897
Manuel Pégourié-Gonnardb505c272012-11-05 17:27:54 +01002898/*
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01002899 * Checkup routine
2900 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002901int mbedtls_ecp_self_test( int verbose )
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01002902{
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002903 int ret;
2904 size_t i;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002905 mbedtls_ecp_group grp;
2906 mbedtls_ecp_point R, P;
2907 mbedtls_mpi m;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002908 unsigned long add_c_prev, dbl_c_prev, mul_c_prev;
Manuel Pégourié-Gonnardb8012fc2013-10-10 15:40:49 +02002909 /* exponents especially adapted for secp192r1 */
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02002910 const char *exponents[] =
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002911 {
Manuel Pégourié-Gonnardb63f9e92012-11-21 13:00:58 +01002912 "000000000000000000000000000000000000000000000001", /* one */
Manuel Pégourié-Gonnardff27b7c2013-11-21 09:28:03 +01002913 "FFFFFFFFFFFFFFFFFFFFFFFF99DEF836146BC9B1B4D22830", /* N - 1 */
Manuel Pégourié-Gonnardb63f9e92012-11-21 13:00:58 +01002914 "5EA6F389A38B8BC81E767753B15AA5569E1782E30ABE7D25", /* random */
Manuel Pégourié-Gonnardff27b7c2013-11-21 09:28:03 +01002915 "400000000000000000000000000000000000000000000000", /* one and zeros */
2916 "7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF", /* all ones */
2917 "555555555555555555555555555555555555555555555555", /* 101010... */
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002918 };
2919
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002920 mbedtls_ecp_group_init( &grp );
2921 mbedtls_ecp_point_init( &R );
2922 mbedtls_ecp_point_init( &P );
2923 mbedtls_mpi_init( &m );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002924
Manuel Pégourié-Gonnardb8012fc2013-10-10 15:40:49 +02002925 /* Use secp192r1 if available, or any available curve */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002926#if defined(MBEDTLS_ECP_DP_SECP192R1_ENABLED)
Manuel Pégourié-Gonnarde3a062b2015-05-11 18:46:47 +02002927 MBEDTLS_MPI_CHK( mbedtls_ecp_group_load( &grp, MBEDTLS_ECP_DP_SECP192R1 ) );
Paul Bakker5dc6b5f2013-06-29 23:26:34 +02002928#else
Manuel Pégourié-Gonnarde3a062b2015-05-11 18:46:47 +02002929 MBEDTLS_MPI_CHK( mbedtls_ecp_group_load( &grp, mbedtls_ecp_curve_list()->grp_id ) );
Manuel Pégourié-Gonnardb8012fc2013-10-10 15:40:49 +02002930#endif
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002931
2932 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002933 mbedtls_printf( " ECP test #1 (constant op_count, base point G): " );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002934
2935 /* Do a dummy multiplication first to trigger precomputation */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002936 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &m, 2 ) );
2937 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &P, &m, &grp.G, NULL, NULL ) );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002938
2939 add_count = 0;
2940 dbl_count = 0;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002941 mul_count = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002942 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &m, 16, exponents[0] ) );
2943 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &R, &m, &grp.G, NULL, NULL ) );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002944
2945 for( i = 1; i < sizeof( exponents ) / sizeof( exponents[0] ); i++ )
2946 {
2947 add_c_prev = add_count;
2948 dbl_c_prev = dbl_count;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002949 mul_c_prev = mul_count;
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002950 add_count = 0;
2951 dbl_count = 0;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002952 mul_count = 0;
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002953
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002954 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &m, 16, exponents[i] ) );
2955 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &R, &m, &grp.G, NULL, NULL ) );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002956
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002957 if( add_count != add_c_prev ||
2958 dbl_count != dbl_c_prev ||
2959 mul_count != mul_c_prev )
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002960 {
2961 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002962 mbedtls_printf( "failed (%u)\n", (unsigned int) i );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002963
2964 ret = 1;
2965 goto cleanup;
2966 }
2967 }
2968
2969 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002970 mbedtls_printf( "passed\n" );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002971
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002972 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002973 mbedtls_printf( " ECP test #2 (constant op_count, other point): " );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002974 /* We computed P = 2G last time, use it */
2975
2976 add_count = 0;
2977 dbl_count = 0;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002978 mul_count = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002979 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &m, 16, exponents[0] ) );
2980 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &R, &m, &P, NULL, NULL ) );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002981
2982 for( i = 1; i < sizeof( exponents ) / sizeof( exponents[0] ); i++ )
2983 {
2984 add_c_prev = add_count;
2985 dbl_c_prev = dbl_count;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002986 mul_c_prev = mul_count;
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002987 add_count = 0;
2988 dbl_count = 0;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002989 mul_count = 0;
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002990
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002991 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &m, 16, exponents[i] ) );
2992 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &R, &m, &P, NULL, NULL ) );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002993
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002994 if( add_count != add_c_prev ||
2995 dbl_count != dbl_c_prev ||
2996 mul_count != mul_c_prev )
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002997 {
2998 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002999 mbedtls_printf( "failed (%u)\n", (unsigned int) i );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02003000
3001 ret = 1;
3002 goto cleanup;
3003 }
3004 }
3005
3006 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003007 mbedtls_printf( "passed\n" );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02003008
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01003009cleanup:
3010
3011 if( ret < 0 && verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003012 mbedtls_printf( "Unexpected error, return code = %08X\n", ret );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01003013
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003014 mbedtls_ecp_group_free( &grp );
3015 mbedtls_ecp_point_free( &R );
3016 mbedtls_ecp_point_free( &P );
3017 mbedtls_mpi_free( &m );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01003018
3019 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003020 mbedtls_printf( "\n" );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01003021
3022 return( ret );
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01003023}
3024
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003025#endif /* MBEDTLS_SELF_TEST */
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01003026
Janos Follathb0697532016-08-18 12:38:46 +01003027#endif /* !MBEDTLS_ECP_ALT */
3028
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003029#endif /* MBEDTLS_ECP_C */