Module: PQCrypto::Signature

Defined in:
lib/pq_crypto/signature.rb

Defined Under Namespace

Classes: Keypair, PublicKey, SecretKey

Constant Summary collapse

CANONICAL_ALGORITHM = 
:ml_dsa_65
DETAILS = 
AlgorithmRegistry.details_for_family(:ml_dsa).freeze
NATIVE_DISPATCH = 
{
  ml_dsa_44: {
    keypair: :native_ml_dsa_44_keypair,
    sign: :native_ml_dsa_44_sign,
    verify: :native_ml_dsa_44_verify,
    keypair_from_seed: :native_ml_dsa_44_keypair_from_seed,
  }.freeze,
  ml_dsa_65: {
    keypair: :native_sign_keypair,
    sign: :native_sign,
    verify: :native_verify,
    keypair_from_seed: :native_ml_dsa_keypair_from_seed,
  }.freeze,
  ml_dsa_87: {
    keypair: :native_ml_dsa_87_keypair,
    sign: :native_ml_dsa_87_sign,
    verify: :native_ml_dsa_87_verify,
    keypair_from_seed: :native_ml_dsa_87_keypair_from_seed,
  }.freeze,
}.freeze

Class Method Summary collapse

Class Method Details

.details(algorithm) ⇒ Object 



93
94
95
 
# File 'lib/pq_crypto/signature.rb', line 93

def details(algorithm)
  DETAILS.fetch(resolve_algorithm!(algorithm)).dup
end

.generate(algorithm = CANONICAL_ALGORITHM) ⇒ Object 



33
34
35
36
37
 
# File 'lib/pq_crypto/signature.rb', line 33

def generate(algorithm = CANONICAL_ALGORITHM)
  algorithm = resolve_algorithm!(algorithm)
  public_key, secret_key = PQCrypto.__send__(native_method_for(algorithm, :keypair))
  Keypair.new(PublicKey.new(algorithm, public_key), SecretKey.new(algorithm, secret_key))
end

.public_key_from_bytes(algorithm, bytes) ⇒ Object 



39
40
41
42
 
# File 'lib/pq_crypto/signature.rb', line 39

def public_key_from_bytes(algorithm, bytes)
  resolve_algorithm!(algorithm)
  PublicKey.new(algorithm, bytes)
end

.public_key_from_pqc_container_der(der, algorithm = nil) ⇒ Object 



49
50
51
52
53
 
# File 'lib/pq_crypto/signature.rb', line 49

def public_key_from_pqc_container_der(der, algorithm = nil)
  resolved_algorithm, bytes = Serialization.public_key_from_pqc_container_der(algorithm, der)
  resolve_algorithm!(resolved_algorithm)
  PublicKey.new(resolved_algorithm, bytes)
end

.public_key_from_pqc_container_pem(pem, algorithm = nil) ⇒ Object 



55
56
57
58
59
 
# File 'lib/pq_crypto/signature.rb', line 55

def public_key_from_pqc_container_pem(pem, algorithm = nil)
  resolved_algorithm, bytes = Serialization.public_key_from_pqc_container_pem(algorithm, pem)
  resolve_algorithm!(resolved_algorithm)
  PublicKey.new(resolved_algorithm, bytes)
end

.public_key_from_spki_der(der, algorithm: nil) ⇒ Object 



73
74
75
76
77
 
# File 'lib/pq_crypto/signature.rb', line 73

def public_key_from_spki_der(der, algorithm: nil)
  resolved_algorithm, bytes = SPKI.decode_der(der)
  validate_algorithm_match!(algorithm, resolved_algorithm) if algorithm
  PublicKey.new(resolve_algorithm!(resolved_algorithm), bytes)
end

.public_key_from_spki_pem(pem, algorithm: nil) ⇒ Object 



79
80
81
82
83
 
# File 'lib/pq_crypto/signature.rb', line 79

def public_key_from_spki_pem(pem, algorithm: nil)
  resolved_algorithm, bytes = SPKI.decode_pem(pem)
  validate_algorithm_match!(algorithm, resolved_algorithm) if algorithm
  PublicKey.new(resolve_algorithm!(resolved_algorithm), bytes)
end

.secret_key_from_bytes(algorithm, bytes) ⇒ Object 



44
45
46
47
 
# File 'lib/pq_crypto/signature.rb', line 44

def secret_key_from_bytes(algorithm, bytes)
  resolve_algorithm!(algorithm)
  SecretKey.new(algorithm, bytes)
end

.secret_key_from_pkcs8_der(der) ⇒ Object 



85
86
87
 
# File 'lib/pq_crypto/signature.rb', line 85

def secret_key_from_pkcs8_der(der)
  secret_key_from_decoded_pkcs8(*PKCS8.decode_der(der))
end

.secret_key_from_pkcs8_pem(pem) ⇒ Object 



89
90
91
 
# File 'lib/pq_crypto/signature.rb', line 89

def secret_key_from_pkcs8_pem(pem)
  secret_key_from_decoded_pkcs8(*PKCS8.decode_pem(pem))
end

.secret_key_from_pqc_container_der(der, algorithm = nil) ⇒ Object 



61
62
63
64
65
 
# File 'lib/pq_crypto/signature.rb', line 61

def secret_key_from_pqc_container_der(der, algorithm = nil)
  resolved_algorithm, bytes = Serialization.secret_key_from_pqc_container_der(algorithm, der)
  resolve_algorithm!(resolved_algorithm)
  SecretKey.new(resolved_algorithm, bytes)
end

.secret_key_from_pqc_container_pem(pem, algorithm = nil) ⇒ Object 



67
68
69
70
71
 
# File 'lib/pq_crypto/signature.rb', line 67

def secret_key_from_pqc_container_pem(pem, algorithm = nil)
  resolved_algorithm, bytes = Serialization.secret_key_from_pqc_container_pem(algorithm, pem)
  resolve_algorithm!(resolved_algorithm)
  SecretKey.new(resolved_algorithm, bytes)
end

.supported ⇒ Object 



97
98
99
 
# File 'lib/pq_crypto/signature.rb', line 97

def supported
  DETAILS.keys.dup
end