# elliptic-curve: Elliptic curve library

[ cryptography, library, mit ] [ Propose Tags ]

An extensible library of elliptic curves used in cryptography research

Versions [faq] 0.1.0, 0.2.1, 0.2.2, 0.3.0 ChangeLog.md base (>=4.10 && <5), galois-field (==1.*), groups, MonadRandom, protolude (==0.2.*), tasty-quickcheck, text, wl-pprint-text [details] MIT Adjoint Inc (info@adjoint.io) Cryptography https://github.com/adjoint-io/elliptic-curve#readme https://github.com/adjoint-io/elliptic-curve/issues head: git clone https://github.com/adjoint-io/elliptic-curve by sdiehl at 2019-09-27T15:22:08Z NixOS:0.3.0 1333 total (31 in the last 30 days) (no votes yet) [estimated by Bayesian average] λ λ λ Docs available Last success reported on 2019-09-27

#### Maintainer's Corner

For package maintainers and hackage trustees

[back to package description]

# Elliptic Curve

An extensible library of elliptic curves used in cryptography research.

## Curve representations

An elliptic curve E(K) over a field K is a smooth projective plane algebraic cubic curve with a specified base point O, and the points on E(K) form an algebraic group with identity point O. By the Riemann-Roch theorem, any elliptic curve is isomorphic to a cubic curve of the form

E(K) = {(x, y) | y^2 + a1xy + a3y = x^3 + a2x^2 + a4x + a6} U {O}


where O is the point at infinity, and a1, a2, a3, a4, a6 are K-rational coefficients that satisfy a non-zero discriminant condition. For cryptographic computational purposes, elliptic curves are represented in several different forms.

### Weierstrass curves

A (short) Weierstrass curve is an elliptic curve over GF(p) for some prime p, and is of the form

E(GF(p)) = {(x, y) | y^2 = x^3 + Ax^2 + B} U {O}


where A and B are K-rational coefficients such that 4A^3 + 27B^2 is non-zero. Weierstrass curves are the most common representations of elliptic curves, as any elliptic curve over a field of characteristic greater than 3 is isomorphic to a Weierstrass curve.

### Binary curves

A (short Weierstrass) binary curve is an elliptic curve over GF(2^m) for some positive m, and is of the form

E(GF(2^m)) = {(x, y) | y^2 = x^3 + Ax + B} U {O}


where A and B are K-rational coefficients such that B is non-zero. Binary curves have field elements represented by binary integers for efficient arithmetic, and are special cases of long Weierstrass curves over a field of characteristic 2.

### Montgomery curves

A Montgomery curve is an elliptic curve over GF(p) for some prime p, and is of the form

E(GF(p)) = {(x, y) | By^2 = x^3 + Ax^2 + x} U {O}


where A and B are K-rational coefficients such that B(A^2 - 4) is non-zero. Montgomery curves only use the first affine coordinate for computations, and can utilise the Montgomery ladder for efficient multiplication.

### Edwards curves

A (twisted) Edwards curve is an elliptic curve over GF(p) for some prime p, and is of the form

E(GF(p)) = {(x, y) | Ax^2 + y^2 = 1 + Dx^2y^2}


where A and D are K-rational coefficients such that D(1 - D) is non-zero. Edwards curves have no point at infinity, and their addition and doubling formulae converge.

## Curve usage

This library is open for new curve representations and curve implementations through pull requests. These should ideally be executed by replicating and modifying existing curve files, for ease, quickcheck testing, and formatting consistency, but a short description of the file organisation is provided here for clarity. Note that it also has a dependency on the Galois field library and its required language extensions.

### Representing a new curve using the curve class

Import the following modules.

import Curve (Curve(..))
import GaloisField (GaloisField)


Create a phantom representation of Weierstrass curves.

data W


Create a synonym for the points on Weierstrass curves.

type WPoint = Point W


Create a class for Weierstrass curves and their parameters.

class Curve W c k => WCurve c k where
a_ :: c -> k
b_ :: c -> k
g_ :: WPoint c k


Create an instance of Weierstrass curves with their operations.

instance (GaloisField k, WCurve c k) => Curve W c k where

data instance Point W c k = A k k
| O
deriving (Eq, Show)

def O       = True
def (A x y) = y * y == x ^ 3 + a * x ^ 2 + b
where
a = a_ (undefined :: c)
b = b_ (undefined :: c)

...


Export the following data types.

module Weierstrass
( Point(..)
, WCurve(..)
, WPoint
) where


### Implementing a new curve using a curve representation

Import a curve representation and a suitable Galois field.

import Curve.Weierstrass (Point(..), WCurve(..), WPoint)
import PrimeField (PrimeField)


Create a phantom representation of the Anomalous curve.

data Anomalous


Create a synonym for the field of the Anomalous curve.

type Fp = PrimeField 0xb0000000000000000000000953000000000000000000001f9d7


Create a synonym for the points on the Anomalous curve.

type P = WPoint Anomalous Fp


Create constants for the parameters of the Anomalous curve.

_a :: Fp
_a = 0x98d0fac687d6343eb1a1f595283eb1a1f58d0fac687d635f5e4

_b :: Fp
_b = 0x4a1f58d0fac687d6343eb1a5e2d6343eb1a1f58d0fac688ab3f

_g :: P
_g = A
0x101efb35fd1963c4871a2d17edaafa7e249807f58f8705126c6
0x22389a3954375834304ba1d509a97de6c07148ea7f5951b20e7

...


Create an instance of the Anomalous curve with its parameters.

instance WCurve Anomalous Fp where
a_ = const _a
b_ = const _b
g_ = _g


Export the following data types and constants.

module Curve.Weierstrass.Anomalous
( Fp
, P
, _a
, _b
, _g
, ...
) where


### Using an implemented curve

Import the curve class and a curve implementation.

import Curve
import qualified Curve.Weierstrass.Anomalous as Anomalous


The data types and constants can then be accessed readily as Anomalous.P and Anomalous._g.

## Curve implementations

The following curves have already been implemented.

### Edwards curves

• Edwards curves

### Montgomery curves

• Montgomery curves