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.