coordinator.crypto Namespace Reference

Functions
str	export_digest (bytes digest)
bytes	import_digest (str digest_s)
ecdsa.SigningKey	generate_signing_key ()
bytes	export_signing_key (ecdsa.SigningKey sk)
ecdsa.SigningKey	import_signing_key (bytes sk_b)
ecdsa.VerifyingKey	get_verification_key (ecdsa.SigningKey sk)
str	export_verification_key (ecdsa.VerifyingKey vk)
ecdsa.VerifyingKey	import_verification_key (str vk_s)
str	export_signature (bytes sig)
bytes	import_signature (str sig_s)
bytes	compute_file_digest (str file_name)
bytes	sign (ecdsa.SigningKey sk, bytes digest)
bool	verify (bytes sig, ecdsa.VerifyingKey vk, bytes digest)
Signature	create_key_evidence (ecdsa.SigningKey key)
bool	check_key_evidence (ecdsa.VerificationKey verification_key, Signature key_evidence)

Variables
	HASH = SHA512
int	HASH_BYTE_LENGTH = 64
	CURVE = ecdsa.NIST521p
	VerificationKey = ecdsa.VerifyingKey
	SigningKey = ecdsa.SigningKey
	Signature = bytes
int	HASH_FILE_BLOCK_SIZE = 4096

Function Documentation

check_key_evidence()

bool coordinator.crypto.check_key_evidence	(	ecdsa.VerificationKey	verification_key,
		Signature	key_evidence
	)

Definition at line 107 of file crypto.py.

def check_key_evidence(
        verification_key: ecdsa.VerificationKey,  # pylint: disable=no-member
        key_evidence: Signature) -> bool:
    return verify(key_evidence, verification_key, KEY_VALIDATION_CHECK_DIGEST)

Here is the call graph for this function:

Here is the caller graph for this function:

compute_file_digest()

bytes coordinator.crypto.compute_file_digest

(

str

file_name

)

Definition at line 82 of file crypto.py.

def compute_file_digest(file_name: str) -> bytes:
    h = HASH.new()
    with open(file_name, "rb") as file_f:
        while True:
            block = file_f.read(HASH_FILE_BLOCK_SIZE)
            if not block:
                return h.digest()
            h.update(block)
 
 

create_key_evidence()

Signature coordinator.crypto.create_key_evidence

(

ecdsa.SigningKey

key

)

Definition at line 103 of file crypto.py.

def create_key_evidence(key: ecdsa.SigningKey) -> Signature:
    return sign(key, KEY_VALIDATION_CHECK_DIGEST)
 
 

Here is the call graph for this function:

Here is the caller graph for this function:

export_digest()

str coordinator.crypto.export_digest

(

bytes

digest

)

Digest to string

Definition at line 32 of file crypto.py.

def export_digest(digest: bytes) -> str:
    """
    Digest to string
    """
    assert len(digest) == HASH_BYTE_LENGTH
    return digest.hex()
 
 

Here is the caller graph for this function:

export_signature()

str coordinator.crypto.export_signature

(

bytes

sig

)

Definition at line 74 of file crypto.py.

def export_signature(sig: bytes) -> str:
    return sig.hex()
 
 

Here is the caller graph for this function:

export_signing_key()

bytes coordinator.crypto.export_signing_key

(

ecdsa.SigningKey

sk

)

Definition at line 54 of file crypto.py.

def export_signing_key(sk: ecdsa.SigningKey) -> bytes:
    return sk.to_der()
 
 

export_verification_key()

str coordinator.crypto.export_verification_key

(

ecdsa.VerifyingKey

vk

)

Definition at line 66 of file crypto.py.

def export_verification_key(vk: ecdsa.VerifyingKey) -> str:
    return vk.to_der().hex()
 
 

Here is the caller graph for this function:

generate_signing_key()

ecdsa.SigningKey coordinator.crypto.generate_signing_key

(

)

Definition at line 50 of file crypto.py.

def generate_signing_key() -> ecdsa.SigningKey:
    return ecdsa.SigningKey.generate(curve=CURVE)
 
 

get_verification_key()

ecdsa.VerifyingKey coordinator.crypto.get_verification_key

(

ecdsa.SigningKey

sk

)

Definition at line 62 of file crypto.py.

def get_verification_key(sk: ecdsa.SigningKey) -> ecdsa.VerifyingKey:
    return sk.get_verifying_key()
 
 

import_digest()

bytes coordinator.crypto.import_digest

(

str

digest_s

)

Digest from string

Definition at line 40 of file crypto.py.

def import_digest(digest_s: str) -> bytes:
    """
    Digest from string
    """
    if len(digest_s) != 2 * HASH_BYTE_LENGTH:
        raise Exception(f"unexpected digest string length: {len(digest_s)}")
    assert len(digest_s) == 2 * HASH_BYTE_LENGTH
    return bytes.fromhex(digest_s)
 
 

Here is the caller graph for this function:

import_signature()

bytes coordinator.crypto.import_signature

(

str

sig_s

)

Definition at line 78 of file crypto.py.

def import_signature(sig_s: str) -> bytes:
    return bytes.fromhex(sig_s)
 
 

Here is the caller graph for this function:

import_signing_key()

ecdsa.SigningKey coordinator.crypto.import_signing_key

(

bytes

sk_b

)

Definition at line 58 of file crypto.py.

def import_signing_key(sk_b: bytes) -> ecdsa.SigningKey:
    return ecdsa.SigningKey.from_der(sk_b)
 
 

Here is the caller graph for this function:

import_verification_key()

ecdsa.VerifyingKey coordinator.crypto.import_verification_key

(

str

vk_s

)

Definition at line 70 of file crypto.py.

def import_verification_key(vk_s: str) -> ecdsa.VerifyingKey:
    return ecdsa.VerifyingKey.from_der(bytes.fromhex(vk_s))
 
 

Here is the caller graph for this function:

sign()

bytes coordinator.crypto.sign	(	ecdsa.SigningKey	sk,
		bytes	digest
	)

Definition at line 92 of file crypto.py.

def sign(sk: ecdsa.SigningKey, digest: bytes) -> bytes:
    return sk.sign_digest(digest)
 
 

Here is the caller graph for this function:

verify()

bool coordinator.crypto.verify	(	bytes	sig,
		ecdsa.VerifyingKey	vk,
		bytes	digest
	)

Definition at line 96 of file crypto.py.

def verify(sig: bytes, vk: ecdsa.VerifyingKey, digest: bytes) -> bool:
    try:
        return vk.verify_digest(sig, digest)
    except Exception:
        return False
 
 

Here is the caller graph for this function:

Variable Documentation

CURVE

coordinator.crypto.CURVE = ecdsa.NIST521p

Definition at line 14 of file crypto.py.

HASH

coordinator.crypto.HASH = SHA512

Definition at line 12 of file crypto.py.

HASH_BYTE_LENGTH

int coordinator.crypto.HASH_BYTE_LENGTH = 64

Definition at line 13 of file crypto.py.

HASH_FILE_BLOCK_SIZE

int coordinator.crypto.HASH_FILE_BLOCK_SIZE = 4096

Definition at line 19 of file crypto.py.

Signature

coordinator.crypto.Signature = bytes

Definition at line 17 of file crypto.py.

SigningKey

coordinator.crypto.SigningKey = ecdsa.SigningKey

Definition at line 16 of file crypto.py.

VerificationKey

coordinator.crypto.VerificationKey = ecdsa.VerifyingKey

Definition at line 15 of file crypto.py.