iaik.security.ec.math.curve

Class BinaryWeierstrassCurveFactory

java.lang.Object

iaik.security.ec.math.curve.BinaryWeierstrassCurveFactory

public final class BinaryWeierstrassCurveFactory
extends Object

This general-purpose factory generates binary Weierstrass-type elliptic curves for given parameters.

The user can choose between various coordinate systems, which are listed in BinaryCurveCoordinateTypes. By default a curve using the fastest coordindate type available will be returned.

Author:

Christian Hanser

Method Summary

Modifier and Type	Method and Description
static EllipticCurve	getCurve(BinaryCurveCoordinateTypes type, BinaryField field, BigInteger a, BigInteger b) The factory method.
static EllipticCurve	getCurve(BinaryCurveCoordinateTypes type, BinaryField field, BigInteger a, BigInteger b, BigInteger order) The factory method.
static EllipticCurve	getCurve(BinaryCurveCoordinateTypes type, BinaryField field, BigInteger a, BigInteger b, BigInteger order, BigInteger s0, BigInteger s1) The factory method.
static EllipticCurve	getCurve(BinaryField field, BigInteger a, BigInteger b) The factory method.
static EllipticCurve	getCurve(BinaryField field, BigInteger a, BigInteger b, BigInteger order) The factory method.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getCurve

public static EllipticCurve getCurve(BinaryField field,
                                     BigInteger a,
                                     BigInteger b)
                              throws InvalidCurveException

The factory method. Returns the curve with the fastest arithmetic for a given coordinate type and given curve parameters.

Parameters:

field - the underlying binary field

a - the first curve parameter

b - the second curve parameter

Returns:

a curve of given type and parameters over the binary field field

Throws:

InvalidCurveException - if the curve is singular

getCurve

public static EllipticCurve getCurve(BinaryCurveCoordinateTypes type,
                                     BinaryField field,
                                     BigInteger a,
                                     BigInteger b)
                              throws InvalidCurveException

The factory method. Returns the curve with the fastest arithmetic for a given coordinate type and given curve parameters.

Parameters:

type - the coordinate type

field - the underlying binary field

a - the first curve parameter

b - the second curve parameter

Returns:

a curve of given type and parameters over the binary field field

Throws:

InvalidCurveException - if the curve is singular

getCurve

public static EllipticCurve getCurve(BinaryCurveCoordinateTypes type,
                                     BinaryField field,
                                     BigInteger a,
                                     BigInteger b,
                                     BigInteger order)
                              throws InvalidCurveException

The factory method. Returns the curve with the fastest arithmetic for a given coordinate type and given curve parameters.

Parameters:

type - the coordinate type

field - the underlying binary field

a - the first curve parameter

b - the second curve parameter

order - the order of the curve group

Returns:

a curve of given type and parameters over the binary field field

Throws:

InvalidCurveException - if the curve is singular

getCurve

public static EllipticCurve getCurve(BinaryCurveCoordinateTypes type,
                                     BinaryField field,
                                     BigInteger a,
                                     BigInteger b,
                                     BigInteger order,
                                     BigInteger s0,
                                     BigInteger s1)
                              throws InvalidCurveException

The factory method. Returns the curve with the fastest arithmetic for a given coordinate type and given curve parameters.

Parameters:

type - the coordinate type

field - the underlying binary field

a - the first curve parameter

b - the second curve parameter

order - the order of the curve group

s0 - auxiliary value s0 for Koblitz curve

s1 - auxiliary value s1 for Koblitz curve

Returns:

a curve of given type and parameters over the binary field field

Throws:

InvalidCurveException - if the curve is singular

getCurve

public static EllipticCurve getCurve(BinaryField field,
                                     BigInteger a,
                                     BigInteger b,
                                     BigInteger order)
                              throws InvalidCurveException

The factory method. Returns the curve with the fastest arithmetic for given curve parameters.

Parameters:

field - the underlying binary field

a - the first curve parameter

b - the second curve parameter

order - the order of the associated curve group

Returns:

a curve of given type and parameters over the binary field field

Throws:

InvalidCurveException - if the curve is singular