pyecsca.sca.target.ectester module

Provides an ECTester target class.

class KeypairEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: ShiftableFlag

ECTester’s KeyPair type.

KEYPAIR_LOCAL = 1

KEYPAIR_REMOTE = 2

KEYPAIR_BOTH = 3

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class InstructionEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: IntEnum

ECTester’s instruction (INS).

INS_ALLOCATE = 90

INS_CLEAR = 91

INS_SET = 92

INS_TRANSFORM = 93

INS_GENERATE = 94

INS_EXPORT = 95

INS_ECDH = 112

INS_ECDH_DIRECT = 113

INS_ECDSA = 114

INS_ECDSA_SIGN = 115

INS_ECDSA_VERIFY = 116

INS_CLEANUP = 117

INS_ALLOCATE_KA = 118

INS_ALLOCATE_SIG = 119

INS_GET_INFO = 120

INS_SET_DRY_RUN_MODE = 121

INS_BUFFER = 122

INS_PERFORM = 123

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class KeyBuildEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: IntEnum

ECTester’s key builder type.

BUILD_KEYPAIR = 1

BUILD_KEYBUILDER = 2

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class ExportEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: IntEnum

ECTester’s export boolean.

EXPORT_TRUE = 255

EXPORT_FALSE = 0

classmethod from_bool(val)

Construct an ExportEnum from a boolean.

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class RunModeEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: IntEnum

ECTester’s run mode.

MODE_NORMAL = 170

MODE_DRY_RUN = 187

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class KeyEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: ShiftableFlag

ECTester’s key enum.

PUBLIC = 1

PRIVATE = 2

BOTH = 3

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class AppletBaseEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: IntEnum

ECTester’s JavaCard applet base version.

BASE_221 = 545

BASE_222 = 546

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class KeyClassEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: IntEnum

JavaCard EC-based key class.

ALG_EC_F2M = 4

ALG_EC_FP = 5

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class KeyAgreementEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: IntEnum

JavaCard KeyAgreement type values.

ALG_EC_SVDP_DH = 1

ALG_EC_SVDP_DH_KDF = 1

ALG_EC_SVDP_DHC = 2

ALG_EC_SVDP_DHC_KDF = 2

ALG_EC_SVDP_DH_PLAIN = 3

ALG_EC_SVDP_DHC_PLAIN = 4

ALG_EC_PACE_GM = 5

ALG_EC_SVDP_DH_PLAIN_XY = 6

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class SignatureEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: IntEnum

JavaCard Signature type values.

ALG_ECDSA_SHA = 17

ALG_ECDSA_SHA_224 = 37

ALG_ECDSA_SHA_256 = 33

ALG_ECDSA_SHA_384 = 34

ALG_ECDSA_SHA_512 = 38

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class TransformationEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: ShiftableFlag

ECTester’s point/value transformation types.

NONE = 0

FIXED = 1

FULLRANDOM = 2

ONEBYTERANDOM = 4

ZERO = 8

ONE = 16

MAX = 32

INCREMENT = 64

INFINITY = 128

COMPRESS = 256

COMPRESS_HYBRID = 512

MASK_04 = 1024

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class FormatEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: IntEnum

ECTester’s point format types.

UNCOMPRESSED = 0

COMPRESSED = 1

HYBRID = 2

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class CurveEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: IntEnum

ECTester’s curve constants.

default = 0

external = 255

secp112r1 = 1

secp128r1 = 2

secp160r1 = 3

secp192r1 = 4

secp224r1 = 5

secp256r1 = 6

secp384r1 = 7

secp521r1 = 8

sect163r1 = 9

sect233r1 = 10

sect283r1 = 11

sect409r1 = 12

sect571r1 = 13

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

class ParameterEnum(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: ShiftableFlag

ECTester’s parameter ids.

NONE = 0

FP = 1

F2M = 2

A = 4

B = 8

G = 16

R = 32

K = 64

W = 128

S = 256

DOMAIN_FP = 125

DOMAIN_F2M = 126

KEYPAIR = 384

ALL = 511

conjugate()

Returns self, the complex conjugate of any int.

bit_length()

Number of bits necessary to represent self in binary.

>>> bin(37)
'0b100101'
>>> (37).bit_length()
6

bit_count()

Number of ones in the binary representation of the absolute value of self.

Also known as the population count.

>>> bin(13)
'0b1101'
>>> (13).bit_count()
3

to_bytes(length=1, byteorder='big', *, signed=False)

Return an array of bytes representing an integer.

length

Length of bytes object to use. An OverflowError is raised if the integer is not representable with the given number of bytes. Default is length 1.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Determines whether two’s complement is used to represent the integer. If signed is False and a negative integer is given, an OverflowError is raised.

from_bytes(byteorder='big', *, signed=False)

Return the integer represented by the given array of bytes.

bytes

Holds the array of bytes to convert. The argument must either support the buffer protocol or be an iterable object producing bytes. Bytes and bytearray are examples of built-in objects that support the buffer protocol.

byteorder

The byte order used to represent the integer. If byteorder is ‘big’, the most significant byte is at the beginning of the byte array. If byteorder is ‘little’, the most significant byte is at the end of the byte array. To request the native byte order of the host system, use `sys.byteorder’ as the byte order value. Default is to use ‘big’.

signed

Indicates whether two’s complement is used to represent the integer.

as_integer_ratio()

Return integer ratio.

Return a pair of integers, whose ratio is exactly equal to the original int and with a positive denominator.

>>> (10).as_integer_ratio()
(10, 1)
>>> (-10).as_integer_ratio()
(-10, 1)
>>> (0).as_integer_ratio()
(0, 1)

real

the real part of a complex number

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

denominator

the denominator of a rational number in lowest terms

exception ChunkingException

Bases: Exception

An exception that is raised if an error happened during the chunking process of a large APDU.

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

class AllocateKaResponse(resp)

Bases: Response

A response to the KeyAgreement allocation command.

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class AllocateSigResponse(resp)

Bases: Response

A response to the Signature allocation command.

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class AllocateResponse(resp, keypair)

Bases: Response

A response to the KeyPair allocation command.

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class ClearResponse(resp, keypair)

Bases: Response

A response to the Clear key command.

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class SetResponse(resp, keypair)

Bases: Response

A response to the Set command.

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class TransformResponse(resp, keypair)

Bases: Response

A response to the Transform command.

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class GenerateResponse(resp, keypair)

Bases: Response

A response to the Generate command.

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class ExportResponse(resp, keypair, key, params)

Bases: Response

A response to the Export command, contains the exported parameters/values.

keypair: KeypairEnum

key: KeyEnum

parameters: ParameterEnum

get_index(keypair, param)

Return type:

Optional[int]

get_param(keypair, param)

Return type:

Optional[bytes]

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class ECDHResponse(resp, export)

Bases: Response

A response to the ECDH and ECDH_direct KeyAgreement commands.

property secret

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class ECDSAResponse(resp, export)

Bases: Response

A response to the ECDSA and ECDSA sign and ECDSA verify commands.

property signature

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class CleanupResponse(resp)

Bases: Response

A response to the Cleanup command.

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class RunModeResponse(resp)

Bases: Response

A response to the Set run mode command.

error: bool = False

success: bool = True

resp: ResponseAPDU

sws: List[int]

params: List[bytes]

class ECTesterTarget

Bases: ISO7816Target, ABC

Smartcard target which communicates with the ECTester sapplet on smartcards of the JavaCard platform using PCSC.

CLA_ECTESTER = 176

AID_PREFIX = b'ECTester'

AID_CURRENT_VERSION = b'033'

AID_SUFFIX_221 = b'b'

AID_SUFFIX_222 = b'x'

AID_SUFFIX_304 = b'\x94'

chunking: bool

connect(protocol=None)

Connect to the card.

Parameters:

protocol (Optional[CardProtocol]) – CardProtocol to use.

abstract property atr: bytes

Return the ATR (Answer To Reset) of the target.

abstract disconnect()

Disconnect from the target device.

abstract select(aid)

Select an applet with aid.

Parameters:

aid (bytes) – The AID of the applet to select.

Return type:

bool

Returns:

Whether the selection was successful.

send(apdu)

Return type:

ResponseAPDU

abstract send_apdu(apdu)

Send an APDU to the selected applet.

Parameters:

apdu (CommandAPDU) – The APDU to send.

Return type:

ResponseAPDU

Returns:

The response.

select_applet(latest_version=b'033', count_back=10)

Select the ECTester applet, with a specified version or older.

Parameters:

• latest_version (bytes) – The latest version to try.

• count_back (int) – How many versions back to try.

Return type:

bool

Returns:

Whether an applet was successfully selected.

static encode_parameters(params, obj)

Encode values from obj into the byte parameters that the ECTester applet expects.

Return type:

Mapping[ParameterEnum, bytes]

allocate_ka(ka_type)

Send the Allocate KeyAgreement command.

Parameters:

ka_type (KeyAgreementEnum) – Which KeyAgreement type to allocate.

Return type:

AllocateKaResponse

Returns:

The response.

allocate_sig(sig_type)

Send the Allocate Signature command.

Parameters:

sig_type (SignatureEnum) – Which Signature type to allocate.

Return type:

AllocateSigResponse

Returns:

The response.

allocate(keypair, builder, key_length, key_class)

Send the Allocate KeyPair command.

Parameters:

• keypair (KeypairEnum) – Which keypair to allocate.

• builder (KeyBuildEnum) – Which builder to use to allocate the keypair.

• key_length (int) – Bit-size of the allocated keypair.

• key_class (KeyClassEnum) – Type of the allocated keypair.

Return type:

AllocateResponse

Returns:

The response.

clear(keypair)

Send the Clear key command.

Parameters:

keypair (KeypairEnum) – Which keypair to clear.

Return type:

ClearResponse

Returns:

The response.

set(keypair, curve, params, values=None)

Send the Set command.

Parameters:

• keypair (KeypairEnum) – Which keypair to set values on.

• curve (CurveEnum) – Which pre-set curve to use to set values, or default or external.

• params (ParameterEnum) – Which parameters to set on the keypair.

• values (Optional[Mapping[ParameterEnum, bytes]]) – External values to set on the keypair.

Return type:

SetResponse

Returns:

The response.

transform(keypair, key, params, transformation)

Send the Transform command.

Parameters:

• keypair (KeypairEnum) – Which keypair to transform.

• key (KeyEnum) – Which key to apply the transform to.

• params (ParameterEnum) – Which parameters to transform.

• transformation (TransformationEnum) – What transformation to apply.

Return type:

TransformResponse

Returns:

The response.

generate(keypair)

Send the Generate command.

Parameters:

keypair (KeypairEnum) – Which keypair to generate.

Return type:

GenerateResponse

Returns:

The response.

export(keypair, key, params)

Send the Export command.

Parameters:

• keypair (KeypairEnum) – Which keypair to export from.

• key (KeyEnum) – Which key to export from.

• params (ParameterEnum) – Which parameters to export.

Return type:

ExportResponse

Returns:

The response, containing the exported parameters.

ecdh(pubkey, privkey, export, transformation, ka_type)

Send the ECDH command.

Parameters:

• pubkey (KeypairEnum) – Which keypair to use the pubkey from, in the key-agreement.

• privkey (KeypairEnum) – Which keypair to use the privkey from, in the key-agreement.

• export (bool) – Whether to export the shared secret.

• transformation (TransformationEnum) – The transformation to apply to the pubkey before key-agreement.

• ka_type (KeyAgreementEnum) – The key-agreement type to use.

Return type:

ECDHResponse

Returns:

The response.

ecdh_direct(privkey, export, transformation, ka_type, pubkey)

Send the ECDH direct command.

Parameters:

• privkey (KeypairEnum) – Which keypair to use the privkey from, in the key-agreement.

• export (bool) – Whether to export the shared secret.

• transformation (TransformationEnum) – The transformation to apply to the pubkey before key-agreement.

• ka_type (KeyAgreementEnum) – The key-agreement type to use.

• pubkey (bytes) – The raw bytes that will be used as a pubkey in the key-agreement.

Return type:

ECDHResponse

Returns:

The response.

ecdsa(keypair, export, sig_type, data)

Send the ECDSA command.

Parameters:

• keypair (KeypairEnum) – The keypair to use.

• export (bool) – Whether to export the signature.

• sig_type (SignatureEnum) – The Signature type to use.

• data (bytes) – The data to sign and verify.

Return type:

ECDSAResponse

Returns:

The response.

ecdsa_sign(keypair, export, sig_type, data)

Send the ECDSA sign command.

Parameters:

• keypair (KeypairEnum) – The keypair to use to sign.

• export (bool) – Whether to export the signature.

• sig_type (SignatureEnum) – The Signature type to use.

• data (bytes) – The data to sign.

Return type:

ECDSAResponse

Returns:

The response.

ecdsa_verify(keypair, sig_type, sig, data)

Send the ECDSA verify command.

Parameters:

• keypair (KeypairEnum) – The keypair to use to verify.

• sig_type (SignatureEnum) – The Signature type to use.

• sig (bytes) – The signature to verify.

• data (bytes) – The data.

Return type:

ECDSAResponse

Returns:

The response.

cleanup()

Send the Cleanup command.

Return type:

CleanupResponse

Returns:

The response.

info()

Send the Info command.

Return type:

InfoResponse

Returns:

The response.

run_mode(run_mode)

Send the Run mode command.

Return type:

RunModeResponse

Returns:

The response.

class ECTesterTargetPCSC(reader)

Bases: ECTesterTarget, PCSCTarget

An ECTester-applet-based target that is connected via a PCSC-compatible reader.

AID_CURRENT_VERSION = b'033'

AID_PREFIX = b'ECTester'

AID_SUFFIX_221 = b'b'

AID_SUFFIX_222 = b'x'

AID_SUFFIX_304 = b'\x94'

CLA_ECTESTER = 176

allocate(keypair, builder, key_length, key_class)

Send the Allocate KeyPair command.

Parameters:

• keypair (KeypairEnum) – Which keypair to allocate.

• builder (KeyBuildEnum) – Which builder to use to allocate the keypair.

• key_length (int) – Bit-size of the allocated keypair.

• key_class (KeyClassEnum) – Type of the allocated keypair.

Return type:

AllocateResponse

Returns:

The response.

allocate_ka(ka_type)

Send the Allocate KeyAgreement command.

Parameters:

ka_type (KeyAgreementEnum) – Which KeyAgreement type to allocate.

Return type:

AllocateKaResponse

Returns:

The response.

allocate_sig(sig_type)

Send the Allocate Signature command.

Parameters:

sig_type (SignatureEnum) – Which Signature type to allocate.

Return type:

AllocateSigResponse

Returns:

The response.

property atr: bytes

Return the ATR (Answer To Reset) of the target.

cleanup()

Send the Cleanup command.

Return type:

CleanupResponse

Returns:

The response.

clear(keypair)

Send the Clear key command.

Parameters:

keypair (KeypairEnum) – Which keypair to clear.

Return type:

ClearResponse

Returns:

The response.

connect(protocol=None)

Connect to the card.

Parameters:

protocol (Optional[CardProtocol]) – CardProtocol to use.

disconnect()

Disconnect from the target device.

ecdh(pubkey, privkey, export, transformation, ka_type)

Send the ECDH command.

Parameters:

• pubkey (KeypairEnum) – Which keypair to use the pubkey from, in the key-agreement.

• privkey (KeypairEnum) – Which keypair to use the privkey from, in the key-agreement.

• export (bool) – Whether to export the shared secret.

• transformation (TransformationEnum) – The transformation to apply to the pubkey before key-agreement.

• ka_type (KeyAgreementEnum) – The key-agreement type to use.

Return type:

ECDHResponse

Returns:

The response.

ecdh_direct(privkey, export, transformation, ka_type, pubkey)

Send the ECDH direct command.

Parameters:

• privkey (KeypairEnum) – Which keypair to use the privkey from, in the key-agreement.

• export (bool) – Whether to export the shared secret.

• transformation (TransformationEnum) – The transformation to apply to the pubkey before key-agreement.

• ka_type (KeyAgreementEnum) – The key-agreement type to use.

• pubkey (bytes) – The raw bytes that will be used as a pubkey in the key-agreement.

Return type:

ECDHResponse

Returns:

The response.

ecdsa(keypair, export, sig_type, data)

Send the ECDSA command.

Parameters:

• keypair (KeypairEnum) – The keypair to use.

• export (bool) – Whether to export the signature.

• sig_type (SignatureEnum) – The Signature type to use.

• data (bytes) – The data to sign and verify.

Return type:

ECDSAResponse

Returns:

The response.

ecdsa_sign(keypair, export, sig_type, data)

Send the ECDSA sign command.

Parameters:

• keypair (KeypairEnum) – The keypair to use to sign.

• export (bool) – Whether to export the signature.

• sig_type (SignatureEnum) – The Signature type to use.

• data (bytes) – The data to sign.

Return type:

ECDSAResponse

Returns:

The response.

ecdsa_verify(keypair, sig_type, sig, data)

Send the ECDSA verify command.

Parameters:

• keypair (KeypairEnum) – The keypair to use to verify.

• sig_type (SignatureEnum) – The Signature type to use.

• sig (bytes) – The signature to verify.

• data (bytes) – The data.

Return type:

ECDSAResponse

Returns:

The response.

static encode_parameters(params, obj)

Encode values from obj into the byte parameters that the ECTester applet expects.

Return type:

Mapping[ParameterEnum, bytes]

export(keypair, key, params)

Send the Export command.

Parameters:

• keypair (KeypairEnum) – Which keypair to export from.

• key (KeyEnum) – Which key to export from.

• params (ParameterEnum) – Which parameters to export.

Return type:

ExportResponse

Returns:

The response, containing the exported parameters.

generate(keypair)

Send the Generate command.

Parameters:

keypair (KeypairEnum) – Which keypair to generate.

Return type:

GenerateResponse

Returns:

The response.

info()

Send the Info command.

Return type:

InfoResponse

Returns:

The response.

run_mode(run_mode)

Send the Run mode command.

Return type:

RunModeResponse

Returns:

The response.

select(aid)

Select an applet with aid.

Parameters:

aid (bytes) – The AID of the applet to select.

Return type:

bool

Returns:

Whether the selection was successful.

select_applet(latest_version=b'033', count_back=10)

Select the ECTester applet, with a specified version or older.

Parameters:

• latest_version (bytes) – The latest version to try.

• count_back (int) – How many versions back to try.

Return type:

bool

Returns:

Whether an applet was successfully selected.

send(apdu)

Return type:

ResponseAPDU

send_apdu(apdu)

Send an APDU to the selected applet.

Parameters:

apdu (CommandAPDU) – The APDU to send.

Return type:

ResponseAPDU

Returns:

The response.

set(keypair, curve, params, values=None)

Send the Set command.

Parameters:

• keypair (KeypairEnum) – Which keypair to set values on.

• curve (CurveEnum) – Which pre-set curve to use to set values, or default or external.

• params (ParameterEnum) – Which parameters to set on the keypair.

• values (Optional[Mapping[ParameterEnum, bytes]]) – External values to set on the keypair.

Return type:

SetResponse

Returns:

The response.

transform(keypair, key, params, transformation)

Send the Transform command.

Parameters:

• keypair (KeypairEnum) – Which keypair to transform.

• key (KeyEnum) – Which key to apply the transform to.

• params (ParameterEnum) – Which parameters to transform.

• transformation (TransformationEnum) – What transformation to apply.

Return type:

TransformResponse

Returns:

The response.

chunking: bool

class ECTesterTargetLEIA(leia)

Bases: ECTesterTarget, LEIATarget

An ECTester-applet-based target that is connected via the LEIA board.

AID_CURRENT_VERSION = b'033'

AID_PREFIX = b'ECTester'

AID_SUFFIX_221 = b'b'

AID_SUFFIX_222 = b'x'

AID_SUFFIX_304 = b'\x94'

CLA_ECTESTER = 176

allocate(keypair, builder, key_length, key_class)

Send the Allocate KeyPair command.

Parameters:

• keypair (KeypairEnum) – Which keypair to allocate.

• builder (KeyBuildEnum) – Which builder to use to allocate the keypair.

• key_length (int) – Bit-size of the allocated keypair.

• key_class (KeyClassEnum) – Type of the allocated keypair.

Return type:

AllocateResponse

Returns:

The response.

allocate_ka(ka_type)

Send the Allocate KeyAgreement command.

Parameters:

ka_type (KeyAgreementEnum) – Which KeyAgreement type to allocate.

Return type:

AllocateKaResponse

Returns:

The response.

allocate_sig(sig_type)

Send the Allocate Signature command.

Parameters:

sig_type (SignatureEnum) – Which Signature type to allocate.

Return type:

AllocateSigResponse

Returns:

The response.

property atr: bytes

Return the ATR (Answer To Reset) of the target.

property card_present: bool

cleanup()

Send the Cleanup command.

Return type:

CleanupResponse

Returns:

The response.

clear(keypair)

Send the Clear key command.

Parameters:

keypair (KeypairEnum) – Which keypair to clear.

Return type:

ClearResponse

Returns:

The response.

connect(protocol=None)

Connect to the card.

Parameters:

protocol (Optional[CardProtocol]) – CardProtocol to use.

disconnect()

Disconnect from the target device.

ecdh(pubkey, privkey, export, transformation, ka_type)

Send the ECDH command.

Parameters:

• pubkey (KeypairEnum) – Which keypair to use the pubkey from, in the key-agreement.

• privkey (KeypairEnum) – Which keypair to use the privkey from, in the key-agreement.

• export (bool) – Whether to export the shared secret.

• transformation (TransformationEnum) – The transformation to apply to the pubkey before key-agreement.

• ka_type (KeyAgreementEnum) – The key-agreement type to use.

Return type:

ECDHResponse

Returns:

The response.

ecdh_direct(privkey, export, transformation, ka_type, pubkey)

Send the ECDH direct command.

Parameters:

• privkey (KeypairEnum) – Which keypair to use the privkey from, in the key-agreement.

• export (bool) – Whether to export the shared secret.

• transformation (TransformationEnum) – The transformation to apply to the pubkey before key-agreement.

• ka_type (KeyAgreementEnum) – The key-agreement type to use.

• pubkey (bytes) – The raw bytes that will be used as a pubkey in the key-agreement.

Return type:

ECDHResponse

Returns:

The response.

ecdsa(keypair, export, sig_type, data)

Send the ECDSA command.

Parameters:

• keypair (KeypairEnum) – The keypair to use.

• export (bool) – Whether to export the signature.

• sig_type (SignatureEnum) – The Signature type to use.

• data (bytes) – The data to sign and verify.

Return type:

ECDSAResponse

Returns:

The response.

ecdsa_sign(keypair, export, sig_type, data)

Send the ECDSA sign command.

Parameters:

• keypair (KeypairEnum) – The keypair to use to sign.

• export (bool) – Whether to export the signature.

• sig_type (SignatureEnum) – The Signature type to use.

• data (bytes) – The data to sign.

Return type:

ECDSAResponse

Returns:

The response.

ecdsa_verify(keypair, sig_type, sig, data)

Send the ECDSA verify command.

Parameters:

• keypair (KeypairEnum) – The keypair to use to verify.

• sig_type (SignatureEnum) – The Signature type to use.

• sig (bytes) – The signature to verify.

• data (bytes) – The data.

Return type:

ECDSAResponse

Returns:

The response.

static encode_parameters(params, obj)

Encode values from obj into the byte parameters that the ECTester applet expects.

Return type:

Mapping[ParameterEnum, bytes]

export(keypair, key, params)

Send the Export command.

Parameters:

• keypair (KeypairEnum) – Which keypair to export from.

• key (KeyEnum) – Which key to export from.

• params (ParameterEnum) – Which parameters to export.

Return type:

ExportResponse

Returns:

The response, containing the exported parameters.

generate(keypair)

Send the Generate command.

Parameters:

keypair (KeypairEnum) – Which keypair to generate.

Return type:

GenerateResponse

Returns:

The response.

info()

Send the Info command.

Return type:

InfoResponse

Returns:

The response.

run_mode(run_mode)

Send the Run mode command.

Return type:

RunModeResponse

Returns:

The response.

select(aid)

Select an applet with aid.

Parameters:

aid (bytes) – The AID of the applet to select.

Return type:

bool

Returns:

Whether the selection was successful.

select_applet(latest_version=b'033', count_back=10)

Select the ECTester applet, with a specified version or older.

Parameters:

• latest_version (bytes) – The latest version to try.

• count_back (int) – How many versions back to try.

Return type:

bool

Returns:

Whether an applet was successfully selected.

send(apdu)

Return type:

ResponseAPDU

send_apdu(apdu)

Send an APDU to the selected applet.

Parameters:

apdu (CommandAPDU) – The APDU to send.

Return type:

ResponseAPDU

Returns:

The response.

set(keypair, curve, params, values=None)

Send the Set command.

Parameters:

• keypair (KeypairEnum) – Which keypair to set values on.

• curve (CurveEnum) – Which pre-set curve to use to set values, or default or external.

• params (ParameterEnum) – Which parameters to set on the keypair.

• values (Optional[Mapping[ParameterEnum, bytes]]) – External values to set on the keypair.

Return type:

SetResponse

Returns:

The response.

transform(keypair, key, params, transformation)

Send the Transform command.

Parameters:

• keypair (KeypairEnum) – Which keypair to transform.

• key (KeyEnum) – Which key to apply the transform to.

• params (ParameterEnum) – Which parameters to transform.

• transformation (TransformationEnum) – What transformation to apply.

Return type:

TransformResponse

Returns:

The response.

chunking: bool