"""Provides an implementation of ECDSA (Elliptic Curve Digital Signature Algorithm)."""
import hashlib
from typing import Optional, Any
from asn1crypto.core import Sequence, SequenceOf, Integer
from public import public
from .context import Action
from .formula import AdditionFormula
from .mod import Mod
from .mult import ScalarMultiplier
from .params import DomainParameters
from .point import Point
[docs]
@public
class SignatureResult:
"""ECDSA signature result (r, s)."""
r: int
s: int
def __init__(self, r: int, s: int):
self.r = r
self.s = s
[docs]
@staticmethod
def from_DER(data: bytes) -> "SignatureResult":
"""Load an ECDSA signature from ASN.1 DER data."""
r, s = Sequence.load(data).native.values()
return SignatureResult(r, s)
[docs]
def to_DER(self) -> bytes:
"""Output this signature into ASN.1 DER."""
obj = SequenceOf(spec=Integer)
obj.append(self.r)
obj.append(self.s)
return obj.dump()
def __eq__(self, other):
if not isinstance(other, SignatureResult):
return False
return self.r == other.r and self.s == other.s
def __hash__(self):
return hash((self.r, self.s))
def __str__(self):
return f"(r={self.r}, s={self.s})"
def __repr__(self):
return f"SignatureResult(r={self.r}, s={self.s})"
[docs]
@public
class ECDSAAction(Action):
"""An ECDSA action base class."""
params: DomainParameters
hash_algo: Optional[Any]
msg: bytes
def __init__(self, params: DomainParameters, hash_algo: Optional[Any], msg: bytes):
super().__init__()
self.params = params
self.hash_algo = hash_algo
self.msg = msg
def __repr__(self):
return f"{self.__class__.__name__}({self.params}, {self.hash_algo}, {self.msg!r})"
[docs]
@public
class ECDSASignAction(ECDSAAction):
"""ECDSA signing."""
# TODO: Make this a ResultAction
privkey: Mod
def __init__(
self,
params: DomainParameters,
hash_algo: Optional[Any],
msg: bytes,
privkey: Mod,
):
super().__init__(params, hash_algo, msg)
self.privkey = privkey
def __repr__(self):
return f"{self.__class__.__name__}({self.params}, {self.hash_algo}, {self.msg!r}, {self.privkey})"
[docs]
@public
class ECDSAVerifyAction(ECDSAAction):
"""ECDSA verification."""
# TODO: Make this a ResultAction
signature: SignatureResult
pubkey: Point
def __init__(
self,
params: DomainParameters,
hash_algo: Optional[Any],
msg: bytes,
signature: SignatureResult,
pubkey: Point,
):
super().__init__(params, hash_algo, msg)
self.signature = signature
self.pubkey = pubkey
def __repr__(self):
return f"{self.__class__.__name__}({self.params}, {self.hash_algo}, {self.msg!r}, {self.signature}, {self.pubkey})"
[docs]
@public
class Signature:
"""EC based signature primitive (ECDSA)."""
mult: ScalarMultiplier
params: DomainParameters
add: Optional[AdditionFormula]
pubkey: Optional[Point]
privkey: Optional[Mod]
hash_algo: Optional[Any]
def __init__(
self,
mult: ScalarMultiplier,
params: DomainParameters,
add: Optional[AdditionFormula] = None,
pubkey: Optional[Point] = None,
privkey: Optional[Mod] = None,
hash_algo: Optional[Any] = None,
):
if pubkey is None and privkey is None:
raise ValueError
if add is None:
if "add" not in mult.formulas:
raise ValueError
elif isinstance(mult.formulas["add"], AdditionFormula):
add = mult.formulas["add"]
self.mult = mult
self.params = params
self.add = add
self.pubkey = pubkey
self.privkey = privkey
self.hash_algo = hash_algo
@property
def can_sign(self) -> bool:
"""Whether this instance can sign (has a private key)."""
return self.privkey is not None
@property
def can_verify(self) -> bool:
"""Whether this instance can verify (has a public key and add formula)."""
return self.pubkey is not None and self.add is not None
def _get_nonce(self, nonce: Optional[int]) -> Mod:
if nonce is None:
return Mod.random(self.params.order)
else:
return Mod(nonce, self.params.order)
def _do_sign(self, nonce: Mod, digest: bytes) -> SignatureResult:
z = int.from_bytes(digest, byteorder="big")
if len(digest) * 8 > self.params.order.bit_length():
z >>= len(digest) * 8 - self.params.order.bit_length()
self.mult.init(self.params, self.params.generator)
point = self.mult.multiply(int(nonce))
affine_point = point.to_affine()
r = Mod(int(affine_point.x), self.params.order)
s = nonce.inverse() * (Mod(z, self.params.order) + r * self.privkey)
return SignatureResult(int(r), int(s))
[docs]
def sign_hash(self, digest: bytes, nonce: Optional[int] = None) -> SignatureResult:
"""Sign already hashed data."""
if not self.can_sign:
raise RuntimeError("This instance cannot sign.")
k = self._get_nonce(nonce)
return self._do_sign(k, digest)
[docs]
def sign_data(self, data: bytes, nonce: Optional[int] = None) -> SignatureResult:
"""Sign data."""
if not self.can_sign or self.privkey is None:
raise RuntimeError("This instance cannot sign.")
with ECDSASignAction(self.params, self.hash_algo, data, self.privkey):
k = self._get_nonce(nonce)
if self.hash_algo is None:
digest = data
else:
digest = self.hash_algo(data).digest()
return self._do_sign(k, digest)
def _do_verify(self, signature: SignatureResult, digest: bytes) -> bool:
if self.pubkey is None or self.add is None:
return False
z = int.from_bytes(digest, byteorder="big")
if len(digest) * 8 > self.params.order.bit_length():
z >>= len(digest) * 8 - self.params.order.bit_length()
c = Mod(signature.s, self.params.order).inverse()
u1 = Mod(z, self.params.order) * c
u2 = Mod(signature.r, self.params.order) * c
self.mult.init(self.params, self.params.generator)
p1 = self.mult.multiply(int(u1))
self.mult.init(self.params, self.pubkey)
p2 = self.mult.multiply(int(u2))
p = self.add(self.params.curve.prime, p1, p2, **self.params.curve.parameters)[0]
affine = p.to_affine()
v = Mod(int(affine.x), self.params.order)
return signature.r == int(v)
[docs]
def verify_hash(self, signature: SignatureResult, digest: bytes) -> bool:
"""Verify already hashed data."""
if not self.can_verify:
raise RuntimeError("This instance cannot verify.")
return self._do_verify(signature, digest)
[docs]
def verify_data(self, signature: SignatureResult, data: bytes) -> bool:
"""Verify data."""
if not self.can_verify or self.pubkey is None:
raise RuntimeError("This instance cannot verify.")
with ECDSAVerifyAction(
self.params, self.hash_algo, data, signature, self.pubkey
):
if self.hash_algo is None:
digest = data
else:
digest = self.hash_algo(data).digest()
return self._do_verify(signature, digest)
[docs]
@public
class ECDSA_NONE(Signature):
"""ECDSA with raw message input."""
def __init__(
self,
mult: ScalarMultiplier,
params: DomainParameters,
add: Optional[AdditionFormula] = None,
pubkey: Optional[Point] = None,
privkey: Optional[Mod] = None,
):
super().__init__(mult, params, add, pubkey, privkey)
[docs]
@public
class ECDSA_SHA1(Signature):
"""ECDSA with SHA1."""
def __init__(
self,
mult: ScalarMultiplier,
params: DomainParameters,
add: Optional[AdditionFormula] = None,
pubkey: Optional[Point] = None,
privkey: Optional[Mod] = None,
):
super().__init__(mult, params, add, pubkey, privkey, hashlib.sha1)
[docs]
@public
class ECDSA_SHA224(Signature):
"""ECDSA with SHA224."""
def __init__(
self,
mult: ScalarMultiplier,
params: DomainParameters,
add: Optional[AdditionFormula] = None,
pubkey: Optional[Point] = None,
privkey: Optional[Mod] = None,
):
super().__init__(mult, params, add, pubkey, privkey, hashlib.sha224)
[docs]
@public
class ECDSA_SHA256(Signature):
"""ECDSA with SHA256."""
def __init__(
self,
mult: ScalarMultiplier,
params: DomainParameters,
add: Optional[AdditionFormula] = None,
pubkey: Optional[Point] = None,
privkey: Optional[Mod] = None,
):
super().__init__(mult, params, add, pubkey, privkey, hashlib.sha256)
[docs]
@public
class ECDSA_SHA384(Signature):
"""ECDSA with SHA384."""
def __init__(
self,
mult: ScalarMultiplier,
params: DomainParameters,
add: Optional[AdditionFormula] = None,
pubkey: Optional[Point] = None,
privkey: Optional[Mod] = None,
):
super().__init__(mult, params, add, pubkey, privkey, hashlib.sha384)
[docs]
@public
class ECDSA_SHA512(Signature):
"""ECDSA with SHA512."""
def __init__(
self,
mult: ScalarMultiplier,
params: DomainParameters,
add: Optional[AdditionFormula] = None,
pubkey: Optional[Point] = None,
privkey: Optional[Mod] = None,
):
super().__init__(mult, params, add, pubkey, privkey, hashlib.sha512)