ECDSA test vectors

Test vectors for ECDSA.

exception crypto_condor.vectors.ECDSA.EcdsaParametersError

Bases: Exception

Exception for parameter errors.

exception crypto_condor.vectors.ECDSA.EcdsaVectorsError

Bases: Exception

Exception for errors when loading or parsing vectors.

enum crypto_condor.vectors.ECDSA.Curve(value)

Bases: StrEnum

Defines all supported curves.

Member Type:

str

Valid values are as follows:

SECP192R1 = <Curve.SECP192R1: 'secp192r1'>

SECP224R1 = <Curve.SECP224R1: 'secp224r1'>

SECP256R1 = <Curve.SECP256R1: 'secp256r1'>

SECP384R1 = <Curve.SECP384R1: 'secp384r1'>

SECP521R1 = <Curve.SECP521R1: 'secp521r1'>

SECP256K1 = <Curve.SECP256K1: 'secp256k1'>

BRAINPOOLP224R1 = <Curve.BRAINPOOLP224R1: 'brainpoolP224r1'>

BRAINPOOLP256R1 = <Curve.BRAINPOOLP256R1: 'brainpoolP256r1'>

SECT283R1 = <Curve.SECT283R1: 'sect283r1'>

SECT409R1 = <Curve.SECT409R1: 'sect409r1'>

SECT571R1 = <Curve.SECT571R1: 'sect571r1'>

The Enum and its members also have the following methods:

classmethod from_name(name)

Matches a curve name to its corresponding enum.

Parameters:

name (str) – The name of the curve.

Returns:

The corresponding EcdsaCurve.

Raises:

ValueError – If the curve is not supported or the name not recognized.

get_nist_name()

Returns the curve name used in NIST test vectors.

None is returned if there are no NIST vectors that use this curve.

get_wycheproof_name()

Returns the curve name used in Wycheproof test vectors.

None is returned if there are no Wycheproof vectors that use this curve.

get_curve_instance()

Returns an instance of the corresponding curve.

Curves come from the cryptography.hazmat.primitives.asymmetric.ec module.

class crypto_condor.vectors.ECDSA.EcdsaSigGenVectors(curve, hash_function, nist)

Bases: object

ECDSA signature generation test vectors.

Do not instantiate directly, use load() to get test vectors for a given curve and hash function.

Parameters:

• curve (Curve) – The elliptic curve to use.

• hash_function (Hash) – The hash function used to generate signatures.

• nist (EcdsaNistSigGenVectors | None) – The NIST test vectors for the given parameters, None if there are no test vectors for those parameters.

classmethod load(curve, hash_function)

Loads ECDSA SigGen test vectors.

Parameters:

• curve (Curve) – The elliptic curve to get test vectors for.

• hash_function (Hash) – The hash function to get test vectors for.

Returns:

An EcdsaSigGenVectors instance with the corresponding test vectors.

class crypto_condor.vectors.ECDSA.EcdsaSigVerVectors(curve, hash_function, nist, wycheproof)

Bases: object

A class to group ECDSA test vectors for signature verification.

Do not instantiate directly, use load() to load the corresponding test vectors.

Parameters:

• parameters – The parameters to get test vectors for.

• nist_vectors – An instance of loaded NIST vectors if they exist for the given parameters, None otherwise.

• wycheproof_vectors – An instance of loaded Wycheproof vectors if they exist for the given parameters, None otherwise.

classmethod load(

curve,

hash_function,

*,

compliance=True,

resilience=True,

)

Loads ECDSA SigVer test vectors.

Parameters:

• curve (Curve) – The elliptic curve to get test vectors for.

• hash_function (Hash) – The hash function to get test vectors for.

Keyword Arguments:

• compliance – Whether to load compliance test vectors.

• resilience – Whether to load resilience test vectors.

Returns:

An EcdsaSigVerVectors instance with the corresponding test vectors.

enum crypto_condor.vectors.ECDSA.EcdsaVectorType(value)

Bases: StrEnum

Defines the different types of test vectors available.

Member Type:

str

Valid values are as follows:

SIGVER = <EcdsaVectorType.SIGVER: 'sigver'>

SIGGEN = <EcdsaVectorType.SIGGEN: 'siggen'>

class crypto_condor.vectors.ECDSA.EcdsaWycheproofGroup

Bases: TypedDict

Represents a Wycheproof ECDSA test group.

class crypto_condor.vectors.ECDSA.EcdsaWycheproofKey

Bases: TypedDict

Represents a Wycheproof ECDSA key.

ECDSA test groups share a key which is provided in different formats. This format contains the curve used and the coordinates.

class crypto_condor.vectors.ECDSA.EcdsaWycheproofTest

Bases: TypedDict

Represents a single Wycheproof ECDSA test.

class crypto_condor.vectors.ECDSA.EcdsaWycheproofVectors

Bases: TypedDict

Represents a Wycheproof file of ECDSA test vectors.

Note that some fields are missing as they are not used by crypto-condor.

enum crypto_condor.vectors.ECDSA.Hash(value)

Bases: StrEnum

Defines all supported hash functions.

Member Type:

str

Valid values are as follows:

SHA_256 = <Hash.SHA_256: 'SHA-256'>

SHA_384 = <Hash.SHA_384: 'SHA-384'>

SHA_512 = <Hash.SHA_512: 'SHA-512'>

SHA3_256 = <Hash.SHA3_256: 'SHA3-256'>

SHA3_384 = <Hash.SHA3_384: 'SHA3-384'>

SHA3_512 = <Hash.SHA3_512: 'SHA3-512'>

The Enum and its members also have the following methods:

classmethod from_name(name)

Matches a hash function name to its corresponding enum.

Parameters:

name (str) – The name of the hash function.

Returns:

The corresponding EcdsaHash.

Raises:

ValueError – If the hash function is not supported or the name not recognized.

get_nist_name()

Returns the hash function name used in NIST test vectors.

None is returned if there are no NIST vectors that use this hash function.

get_wycheproof_name()

Returns the hash function name used in Wycheproof test vectors.

None is returned if there are no Wycheproof vectors that use this hash function.

get_hash_instance()

Returns an instance of the corresponding hash function.

Hash functions come from cryptography.hazmat.primitives.hashes module.