250 lines
8.2 KiB
C
250 lines
8.2 KiB
C
|
/*
|
||
|
|
* Copyright (c) 2012-2020 MIRACL UK Ltd.
|
||
|
|
*
|
||
|
|
* This file is part of MIRACL Core
|
||
|
|
* (see https://github.com/miracl/core).
|
||
|
|
*
|
||
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
* you may not use this file except in compliance with the License.
|
||
|
|
* You may obtain a copy of the License at
|
||
|
|
*
|
||
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
*
|
||
|
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
* See the License for the specific language governing permissions and
|
||
|
|
* limitations under the License.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef ECP2_FP256BN_H
|
||
|
|
#define ECP2_FP256BN_H
|
||
|
|
|
||
|
|
#include "fp2_FP256BN.h"
|
||
|
|
#include "config_curve_FP256BN.h"
|
||
|
|
|
||
|
|
using namespace core;
|
||
|
|
|
||
|
|
|
||
|
|
namespace FP256BN {
|
||
|
|
|
||
|
|
extern const B256_28::BIG Fra; /**< real part of BN curve Frobenius Constant */
|
||
|
|
extern const B256_28::BIG Frb; /**< imaginary part of BN curve Frobenius Constant */
|
||
|
|
|
||
|
|
}
|
||
|
|
|
||
|
|
namespace FP256BN {
|
||
|
|
|
||
|
|
/**
|
||
|
|
@brief ECP2 Structure - Elliptic Curve Point over quadratic extension field
|
||
|
|
*/
|
||
|
|
|
||
|
|
typedef struct
|
||
|
|
{
|
||
|
|
// int inf; /**< Infinity Flag */
|
||
|
|
FP256BN::FP2 x; /**< x-coordinate of point */
|
||
|
|
FP256BN::FP2 y; /**< y-coordinate of point */
|
||
|
|
FP256BN::FP2 z; /**< z-coordinate of point */
|
||
|
|
} ECP2;
|
||
|
|
|
||
|
|
|
||
|
|
/* Curve Params - see rom*.cpp */
|
||
|
|
|
||
|
|
extern const int CURVE_B_I; /**< Elliptic curve B parameter */
|
||
|
|
extern const B256_28::BIG CURVE_B; /**< Elliptic curve B parameter */
|
||
|
|
extern const B256_28::BIG CURVE_Order; /**< Elliptic curve group order */
|
||
|
|
extern const B256_28::BIG CURVE_Cof; /**< Elliptic curve cofactor */
|
||
|
|
extern const B256_28::BIG CURVE_Bnx; /**< Elliptic curve parameter */
|
||
|
|
extern const B256_28::BIG CURVE_HTPC; /**< Hash to Point precomputation */
|
||
|
|
|
||
|
|
/* Generator point on G1 */
|
||
|
|
extern const B256_28::BIG CURVE_Gx; /**< x-coordinate of generator point in group G1 */
|
||
|
|
extern const B256_28::BIG CURVE_Gy; /**< y-coordinate of generator point in group G1 */
|
||
|
|
|
||
|
|
/* For Pairings only */
|
||
|
|
|
||
|
|
/* Generator point on G2 */
|
||
|
|
extern const B256_28::BIG CURVE_Pxa; /**< real part of x-coordinate of generator point in group G2 */
|
||
|
|
extern const B256_28::BIG CURVE_Pxb; /**< imaginary part of x-coordinate of generator point in group G2 */
|
||
|
|
extern const B256_28::BIG CURVE_Pya; /**< real part of y-coordinate of generator point in group G2 */
|
||
|
|
extern const B256_28::BIG CURVE_Pyb; /**< imaginary part of y-coordinate of generator point in group G2 */
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
/* ECP2 E(Fp2) prototypes */
|
||
|
|
/** @brief Tests for ECP2 point equal to infinity
|
||
|
|
*
|
||
|
|
@param P ECP2 point to be tested
|
||
|
|
@return 1 if infinity, else returns 0
|
||
|
|
*/
|
||
|
|
extern int ECP2_isinf(ECP2 *P);
|
||
|
|
/** @brief Copy ECP2 point to another ECP2 point
|
||
|
|
*
|
||
|
|
@param P ECP2 instance, on exit = Q
|
||
|
|
@param Q ECP2 instance to be copied
|
||
|
|
*/
|
||
|
|
extern void ECP2_copy(ECP2 *P, ECP2 *Q);
|
||
|
|
/** @brief Set ECP2 to point-at-infinity
|
||
|
|
*
|
||
|
|
@param P ECP2 instance to be set to infinity
|
||
|
|
*/
|
||
|
|
extern void ECP2_inf(ECP2 *P);
|
||
|
|
/** @brief Tests for equality of two ECP2s
|
||
|
|
*
|
||
|
|
@param P ECP2 instance to be compared
|
||
|
|
@param Q ECP2 instance to be compared
|
||
|
|
@return 1 if P=Q, else returns 0
|
||
|
|
*/
|
||
|
|
extern int ECP2_equals(ECP2 *P, ECP2 *Q);
|
||
|
|
/** @brief Converts an ECP2 point from Projective (x,y,z) coordinates to affine (x,y) coordinates
|
||
|
|
*
|
||
|
|
@param P ECP2 instance to be converted to affine form
|
||
|
|
*/
|
||
|
|
extern void ECP2_affine(ECP2 *P);
|
||
|
|
/** @brief Extract x and y coordinates of an ECP2 point P
|
||
|
|
*
|
||
|
|
If x=y, returns only x
|
||
|
|
@param x FP2 on exit = x coordinate of point
|
||
|
|
@param y FP2 on exit = y coordinate of point (unless x=y)
|
||
|
|
@param P ECP2 instance (x,y)
|
||
|
|
@return -1 if P is point-at-infinity, else 0
|
||
|
|
*/
|
||
|
|
extern int ECP2_get(FP256BN::FP2 *x, FP256BN::FP2 *y, ECP2 *P);
|
||
|
|
/** @brief Formats and outputs an ECP2 point to the console, converted to affine coordinates
|
||
|
|
*
|
||
|
|
@param P ECP2 instance to be printed
|
||
|
|
*/
|
||
|
|
extern void ECP2_output(ECP2 *P);
|
||
|
|
/** @brief Formats and outputs an ECP2 point to the console, in projective coordinates
|
||
|
|
*
|
||
|
|
@param P ECP2 instance to be printed
|
||
|
|
*/
|
||
|
|
extern void ECP2_outputxyz(ECP2 *P);
|
||
|
|
/** @brief Formats and outputs an ECP2 point to an octet string
|
||
|
|
*
|
||
|
|
The octet string is created in the form x|y or just x if compressed
|
||
|
|
Convert the real and imaginary parts of the x and y coordinates to big-endian base 256 form.
|
||
|
|
If c is true, only the x coordinate is provided as in 0x2|x if y is even, or 0x3|x if y is odd
|
||
|
|
@param S output octet string
|
||
|
|
@param P ECP2 instance to be converted to an octet string
|
||
|
|
@param c true for compression
|
||
|
|
*/
|
||
|
|
extern void ECP2_toOctet(octet *S, ECP2 *P, bool c);
|
||
|
|
/** @brief Creates an ECP2 point from an octet string
|
||
|
|
*
|
||
|
|
The octet string is in the form x|y
|
||
|
|
The real and imaginary parts of the x and y coordinates are in big-endian base 256 form.
|
||
|
|
If in compressed form only the x coordinate is provided as in 0x2|x if y is even, or 0x3|x if y is odd
|
||
|
|
@param P ECP2 instance to be created from the octet string
|
||
|
|
@param S input octet string
|
||
|
|
return 1 if octet string corresponds to a point on the curve, else 0
|
||
|
|
*/
|
||
|
|
extern int ECP2_fromOctet(ECP2 *P, octet *S);
|
||
|
|
/** @brief Calculate Right Hand Side of curve equation y^2=f(x)
|
||
|
|
*
|
||
|
|
Function f(x)=x^3+Ax+B
|
||
|
|
Used internally.
|
||
|
|
@param r FP2 value of f(x)
|
||
|
|
@param x FP2 instance
|
||
|
|
*/
|
||
|
|
extern void ECP2_rhs(FP256BN::FP2 *r, FP256BN::FP2 *x);
|
||
|
|
/** @brief Set ECP2 to point(x,y) given x and y
|
||
|
|
*
|
||
|
|
Point P set to infinity if no such point on the curve.
|
||
|
|
@param P ECP2 instance to be set (x,y)
|
||
|
|
@param x FP2 x coordinate of point
|
||
|
|
@param y FP2 y coordinate of point
|
||
|
|
@return 1 if point exists, else 0
|
||
|
|
*/
|
||
|
|
extern int ECP2_set(ECP2 *P, FP256BN::FP2 *x, FP256BN::FP2 *y);
|
||
|
|
/** @brief Set ECP to point(x,[y]) given x
|
||
|
|
*
|
||
|
|
Point P set to infinity if no such point on the curve. Otherwise y coordinate is calculated from x.
|
||
|
|
@param P ECP instance to be set (x,[y])
|
||
|
|
@param x BIG x coordinate of point
|
||
|
|
@param s sign of y
|
||
|
|
@return 1 if point exists, else 0
|
||
|
|
*/
|
||
|
|
extern int ECP2_setx(ECP2 *P, FP256BN::FP2 *x, int s);
|
||
|
|
/** @brief Negation of an ECP2 point
|
||
|
|
*
|
||
|
|
@param P ECP2 instance, on exit = -P
|
||
|
|
*/
|
||
|
|
extern void ECP2_neg(ECP2 *P);
|
||
|
|
/** @brief Doubles an ECP2 instance P
|
||
|
|
*
|
||
|
|
@param P ECP2 instance, on exit =2*P
|
||
|
|
*/
|
||
|
|
extern int ECP2_dbl(ECP2 *P);
|
||
|
|
/** @brief Adds ECP2 instance Q to ECP2 instance P
|
||
|
|
*
|
||
|
|
@param P ECP2 instance, on exit =P+Q
|
||
|
|
@param Q ECP2 instance to be added to P
|
||
|
|
*/
|
||
|
|
extern int ECP2_add(ECP2 *P, ECP2 *Q);
|
||
|
|
/** @brief Subtracts ECP instance Q from ECP2 instance P
|
||
|
|
*
|
||
|
|
@param P ECP2 instance, on exit =P-Q
|
||
|
|
@param Q ECP2 instance to be subtracted from P
|
||
|
|
*/
|
||
|
|
extern void ECP2_sub(ECP2 *P, ECP2 *Q);
|
||
|
|
/** @brief Multiplies an ECP2 instance P by a BIG, side-channel resistant
|
||
|
|
*
|
||
|
|
Uses fixed sized windows.
|
||
|
|
@param P ECP2 instance, on exit =b*P
|
||
|
|
@param b BIG number multiplier
|
||
|
|
|
||
|
|
*/
|
||
|
|
extern void ECP2_mul(ECP2 *P, B256_28::BIG b);
|
||
|
|
/** @brief Multiplies an ECP2 instance P by the internal modulus p, using precalculated Frobenius constant f
|
||
|
|
*
|
||
|
|
Fast point multiplication using Frobenius
|
||
|
|
@param P ECP2 instance, on exit = p*P
|
||
|
|
@param f FP2 precalculated Frobenius constant
|
||
|
|
|
||
|
|
*/
|
||
|
|
extern void ECP2_frob(ECP2 *P, FP256BN::FP2 *f);
|
||
|
|
/** @brief Calculates P=b[0]*Q[0]+b[1]*Q[1]+b[2]*Q[2]+b[3]*Q[3]
|
||
|
|
*
|
||
|
|
@param P ECP2 instance, on exit = b[0]*Q[0]+b[1]*Q[1]+b[2]*Q[2]+b[3]*Q[3]
|
||
|
|
@param Q ECP2 array of 4 points
|
||
|
|
@param b BIG array of 4 multipliers
|
||
|
|
*/
|
||
|
|
extern void ECP2_mul4(ECP2 *P, ECP2 *Q, B256_28::BIG *b);
|
||
|
|
|
||
|
|
/** @brief Multiplies random point by co-factor
|
||
|
|
*
|
||
|
|
@param Q ECP2 multiplied by co-factor
|
||
|
|
*/
|
||
|
|
extern void ECP2_cfp(ECP2 *Q);
|
||
|
|
|
||
|
|
/** @brief Maps random FP2 to curve point in constant time
|
||
|
|
*
|
||
|
|
@param Q ECP2 instance
|
||
|
|
@param x FP2 derived from hash
|
||
|
|
*/
|
||
|
|
extern void ECP2_map2point(ECP2 *Q, FP256BN::FP2 *x);
|
||
|
|
|
||
|
|
/** @brief Maps random BIG to curve point using hunt-and-peck
|
||
|
|
*
|
||
|
|
@param Q ECP2 instance
|
||
|
|
@param x Fp derived from hash
|
||
|
|
*/
|
||
|
|
extern void ECP2_hap2point(ECP2 *Q, B256_28::BIG x);
|
||
|
|
|
||
|
|
/** @brief Maps random octet to curve point of correct order
|
||
|
|
*
|
||
|
|
@param P ECP2 instance of correct order
|
||
|
|
@param W OCTET byte array to be mapped
|
||
|
|
*/
|
||
|
|
extern void ECP2_mapit(ECP2 *P, octet *w);
|
||
|
|
/** @brief Get Group Generator from ROM
|
||
|
|
*
|
||
|
|
@param G ECP2 instance
|
||
|
|
@return 1 if point exists, else 0
|
||
|
|
*/
|
||
|
|
extern int ECP2_generator(ECP2 *G);
|
||
|
|
}
|
||
|
|
|
||
|
|
#endif
|