MPHELL  5.0.0
mphell_tuto_jacobi_quartic.c
Go to the documentation of this file.
1 /*
2  MPHELL-5.0
3  Author(s): The MPHELL team
4 
5  (C) Copyright 2015-2021 - 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 4*block_SIZE = 4*64 = 256 on 64 bits architecture */
36 
37  field k;
38  field_alloc(k, FP, bits_to_nblock(256), NULL);
39 
40  /* Allocate a number of size 4*block_SIZE = 4*64 = 256 on 64 bits architecture */
41 
42  number p;
43  number_init(&p, bits_to_nblock(256));
44 
45  /* Set the number p from a string in base 16 */
46 
47  number_set_str(p, "be6dc5f3bca8726edc8d23dfc89f5922e12826336befbd97ef9ad755aed3ed6f", 16);
48 #if MPHELL_USE_AMNS == 1
49  amns AMNS;
50 #if MPHELL_USE_AMNS_32 == 0
51  amns_alloc_init_str(&AMNS,"[0, 5, [-6, 0, 0, 0, 0, 1], 57, 44134701894072756517992406439939382337596284345171970203125925716993129846274, [-1939549337373671, 708696650251603, 616446424117022, -270633066730404, -269473850007751], [14232251200044510573, 4260484453063696759, 4938517571905539303, 2477203899352903241, 3258824572076821322], [1880138338567364, -362418483091120, -2334430047399656, -961228302577878, -1161931871488864], [1012327336219117, -1831319554880961, -2182294994899370, -1583169082714144, -77840767700580]]", p);
52 #else
53  amns_alloc_init_str(&AMNS, "[0, 11, [-2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1], 27, 69317213738462846735478356472869330750901370837161460878148112172418640423363, [-5039301, -1520710, -682737, 4129377, -118479, 1256754, -165686, 1815325, 2205654, 691178, 3197604], [1642640743, 189102586, 3036257609, 684006625, 2212997898, 3596497786, 2141343760, 4249772178, 3100687204, 806414425, 3135734599], [9681601, 10211069, 6826356, 9674975, 8405458, 11101131, 9893709, 13350564, 5638277, 4060091, -490421], [1482320, 15811726, 4656409, 7974077, 9066791, 6298774, 9545427, 3237750, 6208594, -135406, 5934996]]", p);
54 #endif
55  field_set_amns(k, AMNS);
56 #endif
57 
58  /* Create the field of characteristic p */
59 
60  field_create(k, "", STACK_1, 1, p);
61 
62  /* Allocate curve */
63 
64  ec_curve E;
65  ec_alloc (E, k);
66  ec_init(E, k);
67 
68  /* Create curve */
69 
70  field_elt a, b;
71  ec_point G;
72  number h,n;
73 
74  field_elt_alloc(&a, k);
75  field_elt_init(a, k);
76  field_elt_alloc(&b, k);
77  field_elt_init(b, k);
78  ec_point_alloc(G, k);
79  ec_point_init(G, k);
80  number_init(&n, bits_to_nblock(256));
81  number_init(&h, bits_to_nblock(256));
82 
83  field_elt_set_str(a, "49f59d6eae84c3d20838901b12eb680503e0c84c9438b2343e7cd5f750b2ccdf", 16, false, k, STACK_1);
84  field_elt_set_one(b, k); /* Useless for Jacobi Quartic EC */
85 
86  ec_point_set_str(G, "27e09c4f00f1e6f7763e63e8cd0939c910b5cff8e9deecafe41b2933ab8adf27", "b18a89ba34ad9fee919d49cbf816a22be34778e54ac6498ba29a17db22732673", "78289546d596f34a9fc8e2fd46ebe745c354d1853183a42deac29ea956b114d0", "4c075c65a97f10ff49bc6c8a223957fc99eca98df4a998165d96d31b138a5a97", false, 16, k, STACK_1);
87  number_set_str(n, "2f9b717cef2a1c9bb72348f7f227d648e20a240c39f62f5f1cf3643f55d42cb1", 16);
88  number_set_str(h, "0000000000000000000000000000000000000000000000000000000000000004", 16);
89 
90  ec_create (E, "Jacobi_test", k, a, b, G, h, n, JACOBI_QUARTIC, PROJECTIVE, STACK_1);
91 
92  printf("E: \n"); ec_curve_print(E, 16, STACK_1); printf("\n");
93 
94  field_elt_free(&a, k);
95  field_elt_free(&b, k);
96  ec_point_free(G, k);
97  number_free(&n);
98  number_free(&h);
99 
100  /* Allocate element of the field k */
101 
102  ec_point x;
103  ec_point y;
104  ec_point res;
105  ec_point_alloc(x, k);
106  ec_point_init(x, k);
107  ec_point_alloc(y, k);
108  ec_point_init(y, k);
109  ec_point_alloc(res, k);
110  ec_point_init(res, k);
111 
112  /* Set field element from string in base 16, which are not under Montgomery form */
113 
114  ec_point_set_aff_str (x, "38255193717143657873171169431252446125914975555408103986804661333889508186792", "56879352098683955683913475804414516257891196368009685803867282765611829589550", false, 10, JACOBI_QUARTIC, k, STACK_1);
115  ec_point_set_aff_str (y, "6481597564264008301482198835779793377095770727839417835648754067898733644793", "72836348899108920838208922130674404413346456085043969930205677190313902908769", false, 10, JACOBI_QUARTIC, k, STACK_1);
116 
117  /* Addition */
118 
119  ec_point_add(res, x, y, E, STACK_1);
120  printf("x+y = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
121  printf("x+y belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
122 
123  /* Substraction */
124 
125  ec_point_sub(res, x, y, E, STACK_1);
126  printf("x-y = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
127  printf("x-y belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
128 
129  /* Doubling */
130 
131  ec_point_dbl(res, x, E, STACK_1);
132  printf("x*2 = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
133  printf("x*2 belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
134 
135  /* Negation */
136 
137  ec_point_neg(res, x, E);
138  printf("-x = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
139  printf("-x belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
140 
141  /* Scalar Multiplication */
142 
143  number n1;
144  number_init(&n1, 4);
145  number_set_str(n1, "6481597564264008301482198835779793377095770727839417835648754067898733644745", 10);
146  ec_point_mul(res, n1, x, E, STACK_1);
147  printf("x*6481597564264008301482198835779793377095770727839417835648754067898733644745 = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
148  printf("x*6481597564264008301482198835779793377095770727839417835648754067898733644745 belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
149  number_free(&n1);
150 
151  /* Random point */
152 
153  ec_point_random(res, E, STACK_1);
154  printf("random point, res = "); ec_point_print(res, 16, true, k, STACK_1); printf("\n");
155  printf("res belongs to E : %d\n\n", ec_belongs(res, E, STACK_1));
156 
157  /* Free allocated memory */
158 
159  ec_point_free(x, k);
160  ec_point_free(y, k);
161  ec_point_free(res, k);
162  number_free(&p);
163  field_free(k);
164 #if MPHELL_USE_AMNS == 1
165  amns_free(&AMNS);
166 #endif
167  ec_free(E);
168 
169  free_mphell();
170 
171  return 0;
172 }
void amns_free(amns_ptr *AMNS)
Free the amns system.
Definition: mphell-amns.c:444
void amns_alloc_init_str(amns_ptr *AMNS, char *str, number p)
Allocate and initialise the amns system from the string generated by the Sage AMNS generator from htt...
Definition: mphell-amns.c:1242
void ec_curve_print(ec_curve_srcptr E, const uint8_t base, uint8_t stack)
Print a description of E.
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.
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:65
void ec_point_set_str(ec_point_ptr P, const char *str_x, const char *str_y, const char *str_z, const char *str_t, const bool is_reduced, const uint8_t base, field_srcptr k, uint8_t stack)
Set a point from its coordinates under string format.
Definition: mphell-curve.c:882
bool ec_belongs(ec_point_srcptr P, ec_curve_srcptr E, uint8_t stack)
Test if P belongs to E.
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 ec_point_random(ec_point_ptr P, ec_curve_srcptr E, uint8_t stack)
Create a random point P on the elliptic curve E.
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 ec_free(ec_curve_ptr E)
Free the elliptic curve E.
Definition: mphell-curve.c:809
void ec_init(ec_curve_ptr E, field_srcptr k)
Initialise a curve.
Definition: mphell-curve.c:55
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_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:913
void ec_point_neg(ec_point_ptr P3, ec_point_srcptr P1, ec_curve_srcptr E)
Set P3 to -P1.
void ec_point_init(ec_point_ptr P, field_srcptr k)
Initialise an elliptic curve point.
Definition: mphell-curve.c:842
void ec_point_free(ec_point_ptr P, field_srcptr k)
Free the point P.
Definition: mphell-curve.c:858
void ec_point_alloc(ec_point_ptr P, field_srcptr k)
Allocate an elliptic curve point.
Definition: mphell-curve.c:834
void ec_alloc(ec_curve_ptr E, field_srcptr k)
Allocate a curve.
Definition: mphell-curve.c:37
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)
@ JACOBI_QUARTIC
Definition: mphell-curve.h:43
@ PROJECTIVE
Definition: mphell-curve.h:58
@ DEVURANDOM
void field_elt_free(fe_ptr *src, field_srcptr k)
Free space used by src.
Definition: mphell-field.c:348
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 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:516
void field_elt_init(fe_ptr dst, field_srcptr k)
Initialise the field element.
Definition: mphell-field.c:291
void field_elt_alloc(fe_ptr *dst, field_srcptr k)
Allocate space for a field element.
Definition: mphell-field.c:269
void field_free(field_ptr k)
Free the space of the field informations structure.
Definition: mphell-field.c:194
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:87
void field_elt_set_one(fe_ptr dst, field_srcptr k)
Set dst to one (or its Montgomery form if Montgomery arithmetic is used)
Definition: mphell-field.c:368
field_t field[1]
Address of a field structure.
Definition: mphell-field.h:86
fp_elt * field_elt
Generic field element.
Definition: mphell-field.h:37
@ FP
Definition: mphell-field.h:57
void free_mphell()
Free MPHELL memory, especially the big amount of temporary memory.
Definition: mphell-init.c:97
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
void number_free(number *dst)
Free a number_ptr allocated on the RAM memory (malloc)
Definition: mphell-number.c:75
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
@ RANDOM_AES256
Definition: mphell-random.h:39
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
Define a AMNS.
Definition: mphell-amns.h:81
Define an elliptic curve.
Definition: mphell-curve.h:141
Define an elliptic curve point.
Definition: mphell-curve.h:105