MPHELL  4.0.0
mphell_tuto_weierstrass.c
Go to the documentation of this file.
1 /*
2  MPHELL-4.0
3  Author(s): The MPHELL team
4 
5  (C) Copyright 2015-2018 - Institut Fourier / Univ. Grenoble Alpes (France)
6 
7  This file is part of the MPHELL Library.
8  MPHELL is free software: you can redistribute it and/or modify
9  it under the terms of the GNU Lesser General Public License as published by
10  the Free Software Foundation, version 3 of the License.
11 
12  MPHELL is distributed in the hope that it will be useful,
13  but WITHOUT ANY WARRANTY; without even the implied warranty of
14  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  GNU Lesser General Public License for more details.
16 
17  You should have received a copy of the GNU Lesser General Public License
18  along with MPHELL. If not, see <http://www.gnu.org/licenses/>.
19 */
20 
26 #include <stdio.h>
27 #include "mphell/mphell.h"
28 
29 int main()
30 {
31  /* Initialise MPHELL with 256 bits of security strength for the entropy, RANDOM_AES256 as DRBG and DEVURANDOM as entropy source */
32 
34 
35  /* Allocate a field of size 3*block_SIZE = 3*64 = 192 on 64 bits architecture */
36 
37  field k;
38  field_alloc(k, FP, bits_to_nblock(192), NULL);
39 
40  /* Allocate a number of size 3*block_SIZE = 3*64 = 192 on 64 bits architecture */
41 
42  number p;
43  number_init(&p, bits_to_nblock(192));
44 
45  /* Set the number p from a string in base 16 */
46 
47  number_set_str(p, "fffffffffffffffffffffffffffffffeffffffffffffffff", 16);
48 
49  /* Create the field of characteristic p */
50 
51  field_create(k, "", STACK_1, 1, p);
52 
53  /* Allocate curve */
54 
55  ec_curve E;
56  ec_alloc(E, k);
57  ec_init(E, k);
58 
59  /* Create curve */
60 
61  field_elt a, b;
62  ec_point G;
63  number h, n;
64 
65  field_elt_alloc(&a, k);
66  field_elt_init(a, k);
67  field_elt_alloc(&b, k);
68  field_elt_init(b, k);
69  ec_point_alloc(G, k);
70  ec_point_init(G, k);
71  number_init(&h, bits_to_nblock(192));
72  number_init(&n, bits_to_nblock(192));
73 
74  field_elt_set_str(a, "fffffffffffffffffffffffffffffffefffffffffffffffc", 16, false, k, STACK_1);
75  field_elt_set_str(b, "64210519e59c80e70fa7e9ab72243049feb8deecc146b9b1", 16, false, k, STACK_1);
76  ec_point_set_aff_str(G, "188da80eb03090f67cbf20eb43a18800f4ff0afd82ff1012", "07192b95ffc8da78631011ed6b24cdd573f977a11e794811", false, 16, WEIERSTRASS, k, STACK_1);
77  number_set_str(h, "000000000000000000000000000000000000000000000001", 16);
78  number_set_str(n, "ffffffffffffffffffffffff99def836146bc9b1b4d22831", 16);
79 
80  ec_create(E, "Weierstrass_test", k, a, b, G, h, n, WEIERSTRASS, PROJECTIVE, STACK_1);
81 
82  printf("E: \n"); ec_curve_print(E, 16, STACK_1); printf("\n");
83 
84  field_elt_free(&a, k);
85  field_elt_free(&b, k);
86  ec_point_free(G, k);
87  number_free(&n);
88  number_free(&h);
89 
90  /* Allocate element of the field k */
91 
92  ec_point x;
93  ec_point y;
94  ec_point res;
95  ec_point_alloc(x, k);
96  ec_point_init(x, k);
97  ec_point_alloc(y, k);
98  ec_point_init(y, k);
99  ec_point_alloc(res, k);
100  ec_point_init(res, k);
101 
102  /* Set field element from string in base 16, which are not under Montgomery form */
103 
104  ec_point_set_aff_str(x, "3a6e0e0135079698f34344bb2261a5fa0730419b639b45ca", "52c86dc001c77804f6a1e9ab8e5ac4627727919a68993692", false, 16, WEIERSTRASS, k, STACK_1);
105  ec_point_set_aff_str(y, "8cf9058484386d660331a5ef852002360c00d5c940010c33", "2ec3235f6b5eeec13bc3c206b47e60cf715966c67c6e292a", false, 16, WEIERSTRASS, k, STACK_1);
106 
107  /* Addition */
108 
109  ec_point_add(res, x, y, E, STACK_1);
110  printf("x+y = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
111  printf("x+y belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
112 
113  /* Substraction */
114 
115  ec_point_sub(res, x, y, E, STACK_1);
116  printf("x-y = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
117  printf("x-y belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
118 
119  /* Doubling */
120 
121  ec_point_dbl(res, x, E, STACK_1);
122  printf("x*2 = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
123  printf("x*2 belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
124 
125  /* Negation */
126 
127  ec_point_neg(res, x, E);
128  printf("-x = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
129  printf("-x belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
130 
131  /* Scalar Multiplication */
132 
133  number m;
134  number_init(&m, 3);
135  number_set_str(m, "3a6e0e0135079698f34344bb2261a5fa0730419b639b45ca", 16);
136  ec_point_mul(res, m, x, E, STACK_1);
137  printf("x*3a6e0e0135079698f34344bb2261a5fa0730419b639b45ca = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
138  printf("x*3a6e0e0135079698f34344bb2261a5fa0730419b639b45ca belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
139  number_free(&m);
140 
141 
142  /* Random point */
143 
144  ec_point_random(res, E, STACK_1);
145  printf("random point, res = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
146  printf("res belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
147 
148  ec_point_free(res, k);
149  number_free(&p);
150  ec_point_free(x, k);
151  ec_point_free(y, k);
152  field_free(k);
153  ec_free(E);
154  free_mphell();
155 
156  return 0;
157 }
bool ec_belongs(ec_point_srcptr P, ec_curve_srcptr E, uint8_t stack)
Test if P belongs to E.
Definition: mphell-curve.c:865
fp_elt * field_elt
Generic field element.
Definition: mphell-field.h:39
void free_mphell()
Free MPHELL memory, especially the big amount of temporary memory.
Definition: mphell-init.c:97
void ec_create(ec_curve_ptr E, const char *id_curve, field_srcptr k, fe_srcptr a, fe_srcptr b, ec_point_srcptr G, number_srcptr h, number_srcptr n, const ec_type type, const ec_formula f, uint8_t stack)
Create an elliptic curve E, the curve must be allocated and initialised (ec_alloc & ec_init)
Definition: mphell-curve.c:62
void field_elt_free(fe_ptr *src, field_srcptr k)
Free space used by src.
Definition: mphell-field.c:356
void init_mphell(const uint16_t security_strength, const random_type type, const entropy_type entropy)
Initialise MPHELL with security_strength bits of security (for random number only).
Definition: mphell-init.c:35
Define an elliptic curve point.
Definition: mphell-curve.h:103
void ec_point_alloc(ec_point_ptr P, field_srcptr k)
Allocate an elliptic curve point.
Definition: mphell-curve.c:673
void ec_point_neg(ec_point_ptr P3, ec_point_srcptr P1, ec_curve_srcptr E)
Set P3 to -P1.
void ec_init(ec_curve_ptr E, field_srcptr k)
Initialise a curve.
Definition: mphell-curve.c:52
void ec_point_print(ec_point_srcptr P, const uint8_t base, const bool lift, field_srcptr k, uint8_t stack)
Print a description of P.
uint8_t bits_to_nblock(const uint16_t nbits)
Return the number of blocks required to store a nbits number.
Definition: mphell-util.c:29
void field_elt_alloc(fe_ptr *dst, field_srcptr k)
Allocate space for a field element.
Definition: mphell-field.c:277
void ec_point_init(ec_point_ptr P, field_srcptr k)
Initialise an elliptic curve point.
Definition: mphell-curve.c:682
field_t field[1]
Address of a field structure.
Definition: mphell-field.h:110
void ec_point_add(ec_point_ptr P3, ec_point_srcptr P1, ec_point_srcptr P2, ec_curve_srcptr E, uint8_t stack)
Set P3 to P1 + P2, using dedicated formulae (not protected against SPA, but faster)
void number_free(number *dst)
Free a number_ptr allocated on the RAM memory (malloc)
Definition: mphell-number.c:75
void ec_point_free(ec_point_ptr P, field_srcptr k)
Free the point P.
Definition: mphell-curve.c:700
void ec_free(ec_curve_ptr E)
Free the elliptic curve E.
Definition: mphell-curve.c:655
void field_create(field_ptr k, const char *id, uint8_t stack, const uint32_t n,...)
Initialize the different fields of the structure pointed by k.
Definition: mphell-field.c:76
void ec_point_set_aff_str(ec_point_ptr P, const char *str_x, const char *str_y, const bool is_reduced, const uint8_t base, const ec_type type, field_srcptr k, uint8_t stack)
Set a point from its affine coordinates under string format.
Definition: mphell-curve.c:759
void ec_point_dbl(ec_point_ptr P3, ec_point_srcptr P1, ec_curve_srcptr E, uint8_t stack)
Set P3 to 2*P1, using dedicated formulae (not protected against SPA, but faster)
void ec_alloc(ec_curve_ptr E, field_srcptr k)
Allocate a curve.
Definition: mphell-curve.c:37
void field_alloc(field_ptr k, const field_type type, const uint8_t size, field_ptr base)
Allocates space for the different fields of the structure pointed by k.
Definition: mphell-field.c:37
void ec_point_mul(ec_point_ptr P3, number_srcptr n, ec_point_srcptr P1, ec_curve_srcptr E, uint8_t stack)
Set P3 to n * P1 using Montgomery for Weierstrass elliptic curve, and naive method for other elliptic...
void field_elt_init(fe_ptr dst, field_srcptr k)
Initialise the field element.
Definition: mphell-field.c:299
void ec_curve_print(ec_curve_srcptr E, const uint8_t base, uint8_t stack)
Print a description of E.
void number_set_str(number_ptr dst, const char *str, const uint8_t base)
Set dst to str.
void number_init(number *dst, const uint8_t n)
Allocate a number_ptr on the RAM memory (malloc)
Definition: mphell-number.c:59
void field_free(field_ptr k)
Free the space of the field informations structure.
Definition: mphell-field.c:183
void ec_point_random(ec_point_ptr P, ec_curve_srcptr E, uint8_t stack)
Create a random point P on the elliptic curve E.
Definition: mphell-curve.c:885
Define an elliptic curve.
Definition: mphell-curve.h:139
void field_elt_set_str(fe_ptr dst, const char *str, const uint8_t base, const bool isreduced, field_srcptr k, uint8_t stack)
Set dst to str, if Montgomery arithmetic is used, is_reduced == false -> transform dst into its Montg...
Definition: mphell-field.c:505
void ec_point_sub(ec_point_ptr P3, ec_point_srcptr P1, ec_point_srcptr P2, ec_curve_srcptr E, uint8_t stack)
Set P3 to P1 - P2, using dedicated formulae (not protected against SPA, but faster)