Type Members

1.  final case class AsymmetricEncrypted[+M](ciphertext: ByteString, encryptionAlgorithmSpec: EncryptionAlgorithmSpec, encryptedFor: Fingerprint) extends NoCopy with HasVersionedWrapper[AsymmetricEncrypted[_]] with Product with Serializable

   Represents an asymmetric encrypted message.

   Represents an asymmetric encrypted message.

   ciphertext

   the encrypted message

   encryptionAlgorithmSpec

   the encryption algorithm specification (e.g. RSA OAEP)

   encryptedFor

   the public key of the recipient

2.  class Crypto extends NamedLogging with CloseableHealthElement with CompositeHealthElement[String, HealthQuasiComponent] with HealthComponent

   Wrapper class to simplify crypto dependency management

3.  trait CryptoKey extends Product with Serializable
4.  sealed trait CryptoKeyFormat extends Product with Serializable with PrettyPrinting
5.  trait CryptoKeyPair[+PK <: PublicKey, +SK <: PrivateKey] extends HasVersionedWrapper[CryptoKeyPair[PublicKey, PrivateKey]] with Product with Serializable
6.  trait CryptoKeyPairKey extends CryptoKey
7.  trait CryptoPrivateApi extends EncryptionPrivateOps with SigningPrivateOps with CloseableHealthComponent
8.  trait CryptoPrivateStoreApi extends CryptoPrivateApi with EncryptionPrivateStoreOps with SigningPrivateStoreOps
9.  trait CryptoPureApi extends EncryptionOps with SigningOps with HmacOps with HashOps with RandomOps with PasswordBasedEncryptionOps
10.  sealed trait CryptoPureApiError extends Product with Serializable with PrettyPrinting
11.  final case class CryptoScheme[S](default: S, allowed: NonEmpty[Set[S]]) extends Product with Serializable
12.  final case class CryptoSchemes(signingKeySpecs: CryptoScheme[SigningKeySpec], signingAlgoSpecs: CryptoScheme[SigningAlgorithmSpec], encryptionKeySpecs: CryptoScheme[EncryptionKeySpec], encryptionAlgoSpecs: CryptoScheme[EncryptionAlgorithmSpec], symmetricKeySchemes: CryptoScheme[SymmetricKeyScheme], hashAlgorithms: CryptoScheme[HashAlgorithm], pbkdfSchemes: Option[CryptoScheme[PbkdfScheme]]) extends Product with Serializable
13.  sealed trait DecryptionError extends Product with Serializable with PrettyPrinting
14.  trait EcKeySpec extends AnyRef

    Indicates that the key is based on elliptic curve cryptography.

15.  final case class Encrypted[+M] extends Product with Serializable

    A tag to denote encrypted data.

16.  sealed trait EncryptionAlgorithmSpec extends Product with Serializable with PrettyPrinting with UniformCantonConfigValidation

    Algorithm schemes for asymmetric/hybrid encryption.

17.  sealed trait EncryptionError extends Product with Serializable with PrettyPrinting
18.  sealed trait EncryptionKeyCreationError extends Product with Serializable with PrettyPrinting
19.  sealed trait EncryptionKeyGenerationError extends Product with Serializable with PrettyPrinting
20.  final case class EncryptionKeyPair(publicKey: EncryptionPublicKey, privateKey: EncryptionPrivateKey) extends CryptoKeyPair[EncryptionPublicKey, EncryptionPrivateKey] with Product with Serializable
21.  sealed trait EncryptionKeySpec extends Product with Serializable with PrettyPrinting with UniformCantonConfigValidation

    An encryption key specification.

22.  trait EncryptionOps extends AnyRef

    Encryption operations that do not require access to a private key store but operates with provided keys.

23.  final case class EncryptionPrivateKey extends PrivateKey with HasVersionedWrapper[EncryptionPrivateKey] with NoCopy with Product with Serializable
24.  trait EncryptionPrivateOps extends AnyRef

    Encryption operations that require access to stored private keys.

25.  trait EncryptionPrivateStoreOps extends EncryptionPrivateOps

    A default implementation with a private key store

26.  final case class EncryptionPublicKey extends PublicKey with PrettyPrinting with HasVersionedWrapper[EncryptionPublicKey] with Product with Serializable
27.  final case class EncryptionPublicKeyWithName(publicKey: EncryptionPublicKey, name: Option[KeyName]) extends PublicKeyWithName with PrettyPrinting with Product with Serializable
28.  final case class Fingerprint extends LengthLimitedStringWrapper with PrettyPrinting with Product with Serializable

    a human readable fingerprint of a key that serves as a unique identifier

29.  trait HasFingerprint extends AnyRef
30.  final case class Hash extends HasCryptographicEvidence with Ordered[Hash] with PrettyPrinting with Product with Serializable
31.  sealed abstract class HashAlgorithm extends PrettyPrinting with UniformCantonConfigValidation

    A Multi-hash compatible description of a hash algorithm

32.  trait HashBuilder extends AnyRef

    The methods of HashBuilder change its internal state and return this for convenience.

    The methods of HashBuilder change its internal state and return this for convenience.

    Requirements for all implementations:

    For any HashBuilder hb, it is computationally infeasible to find two sequences as1 and as2 of calls to add such that the concatenation of as1 differs from the concatenation as2, yet their computed hashes are the same, i.e., as1.foldLeft(hb)((hb, a) => hb.add(a)).finish is the same as as2.foldLeft(hb)((hb, a) => hb.add(a)).finish.

33.  class HashBuilderFromMessageDigest extends HashBuilder

    Constructs a HashBuilder from the specified java.security.MessageDigest ALWAYS use the apply method unless you know what you're doing.

34.  trait HashOps extends AnyRef

    Trait only needed if we want to make the default algorithm configurable

35.  final class HashPurpose extends AnyVal

    The purpose of a hash serves to avoid hash collisions due to equal encodings for different objects.

    The purpose of a hash serves to avoid hash collisions due to equal encodings for different objects. It is in general not possible to derive the purpose of the hash from the hash alone.

    Whenever a hash is computed using HashOps, a HashPurpose must be specified that gets included in the hash. To reliably prevent hash collisions, every HashPurpose object should be used only in a single place.

    All HashPurpose objects must be created through the HashPurpose$.apply method, which checks that the id is fresh.

36.  final case class Hmac extends PrettyPrinting with Product with Serializable
37.  sealed abstract class HmacAlgorithm extends PrettyPrinting
38.  sealed trait HmacError extends Product with Serializable with PrettyPrinting
39.  trait HmacOps extends AnyRef

    pure HMAC operations that do not require access to external keys.

40.  final case class HmacSecret extends PrettyPrinting with Product with Serializable
41.  final case class KeyName(str: String300) extends LengthLimitedStringWrapper with PrettyPrinting with Product with Serializable
42.  sealed trait KeyPurpose extends Product with Serializable with PrettyPrinting
43.  class LtHash16 extends AnyRef

    A running digest of a set of bytes, where elements can be added and removed.

    A running digest of a set of bytes, where elements can be added and removed.

    Note that it's the caller's responsibility to ensure that the collection defined by the sequence of additions/removals is really a set. In particular:

    1. the digest accepts a call to remove before the corresponding call to add
    2. the digest will change if the same element is added twice. Note, however, that the digest rolls over if you add an element 2^{16 times; i.e., taking a digest d, then adding the same element 2}16 times results in d again.
44.  final case class Nonce extends HasCryptographicEvidence with Product with Serializable
45.  final case class PasswordBasedEncrypted(ciphertext: ByteString, symmetricKeyScheme: SymmetricKeyScheme, pbkdfScheme: PbkdfScheme, salt: SecureRandomness) extends HasVersionedWrapper[PasswordBasedEncrypted] with Product with Serializable

    A password-based encrypted message

46.  sealed trait PasswordBasedEncryptionError extends Product with Serializable with PrettyPrinting
47.  final case class PasswordBasedEncryptionKey(key: SymmetricKey, salt: SecureRandomness) extends Product with Serializable

    A symmetric key derived from a password

48.  trait PasswordBasedEncryptionOps extends AnyRef

    Password-Based Encryption (PBE)

49.  sealed trait PbkdfScheme extends Product with Serializable with UniformCantonConfigValidation

    Schemes for Password-Based Key Derivation Functions

50.  trait PrivateKey extends CryptoKeyPairKey
51.  trait PublicKey extends CryptoKeyPairKey
52.  trait PublicKeyWithName extends Product with Serializable with HasVersionedWrapper[PublicKeyWithName]
53.  trait RandomOps extends AnyRef
54.  final case class RequiredEncryptionSpecs(algorithms: NonEmpty[Set[EncryptionAlgorithmSpec]], keys: NonEmpty[Set[EncryptionKeySpec]]) extends Product with Serializable with PrettyPrinting

    Required encryption algorithms and keys for asymmetric/hybrid encryption to be listed in the synchronizer.

    Required encryption algorithms and keys for asymmetric/hybrid encryption to be listed in the synchronizer.

    algorithms

    list of required encryption algorithm specifications

    keys

    list of required encryption key specifications

55.  final case class RequiredSigningSpecs(algorithms: NonEmpty[Set[SigningAlgorithmSpec]], keys: NonEmpty[Set[SigningKeySpec]]) extends Product with Serializable with PrettyPrinting

    Required signing algorithms and keys specifications to be supported by all synchronizer members.

    Required signing algorithms and keys specifications to be supported by all synchronizer members.

    algorithms

    list of required signing algorithm specifications

    keys

    list of required signing key specifications

56.  final case class Salt extends PrettyPrinting with Product with Serializable

    A (pseudo-)random salt used for hashing to prevent pre-computed hash attacks.

    A (pseudo-)random salt used for hashing to prevent pre-computed hash attacks.

    The algorithm that was used to generate/derive the salt is kept to support the verification of the salt generation.

57.  sealed trait SaltAlgorithm extends Product with Serializable with PrettyPrinting

    Indicates the algorithm used to generate and derive salts.

58.  sealed trait SaltError extends Product with Serializable with PrettyPrinting
59.  final case class SaltSeed extends Product with Serializable

    A seed to derive further salts from.

    A seed to derive further salts from.

    Unlike Salt this seed will not be shipped to another participant.

60.  final case class SecureRandomness extends HasCryptographicEvidence with HasToByteString with Product with Serializable

    The class is a tag that denotes a byte string as a securely generated random value.

    The class is a tag that denotes a byte string as a securely generated random value.

    Not an AnyVal as we also want it to be a serializable value such that we can encrypt it.

61.  final case class SessionKeyAndReference(randomness: SecureRandomness, key: SymmetricKey, reference: AnyRef) extends Product with Serializable

    The randomness and corresponding session key, as well as a temporary reference to it that lives as long as the cache lives.

62.  final case class SessionKeyInfo(sessionKeyAndReference: SessionKeyAndReference, encryptedBy: Option[AnyRef], encryptedSessionKeys: Seq[AsymmetricEncrypted[SecureRandomness]]) extends Product with Serializable

    Information that is cached for each view and is to be re-used if another view has the same recipients and transparency can be respected.

    Information that is cached for each view and is to be re-used if another view has the same recipients and transparency can be respected.

    sessionKeyAndReference

    the randomness, the corresponding symmetric key used to encrypt the view, and a symbolic reference to use in the 'encryptedBy' field.

    encryptedBy

    an optional symbolic reference for the parent session key (if it exists) that encrypts a view containing this session key’s randomness. This cache entry must be revoked if the reference no longer matches.

    encryptedSessionKeys

    the randomness of the session key encrypted for each recipient.

63.  final case class Signature extends HasVersionedWrapper[Signature] with PrettyPrinting with Product with Serializable

64.  sealed trait SignatureCheckError extends Product with Serializable with PrettyPrinting
65.  final case class SignatureDelegation extends Product with Serializable

    An extension to the signature to accommodate the necessary information to be able to use session signing keys for protocol messages.

66.  final case class SignatureDelegationValidityPeriod(fromInclusive: CantonTimestamp, periodLength: PositiveSeconds) extends PrettyPrinting with HasCryptographicEvidence with Product with Serializable

    Defines the validity period of a session signing key delegation within a specific synchronizer timeframe.

    Defines the validity period of a session signing key delegation within a specific synchronizer timeframe. This period starts at a creation 'from' timestamp and extends for a specified duration.

    fromInclusive

    the inclusive timestamp, indicating when a delegation to the session key was created

    periodLength

    the validity duration of the session key delegation in seconds

67.  sealed trait SignatureFormat extends Product with Serializable with PrettyPrinting
68.  sealed trait SigningAlgorithmSpec extends Product with Serializable with PrettyPrinting with UniformCantonConfigValidation

    Algorithm schemes for signing.

69.  sealed trait SigningError extends Product with Serializable with PrettyPrinting
70.  sealed trait SigningKeyGenerationError extends Product with Serializable with PrettyPrinting
71.  final case class SigningKeyPair(publicKey: SigningPublicKey, privateKey: SigningPrivateKey) extends CryptoKeyPair[SigningPublicKey, SigningPrivateKey] with Product with Serializable
72.  sealed trait SigningKeySpec extends Product with Serializable with PrettyPrinting with UniformCantonConfigValidation

    A signing key specification.

73.  sealed trait SigningKeyUsage extends Product with Serializable with PrettyPrinting

    Only intended to be used for signing keys to distinguish keys used for generating the namespace, for identity delegations, authenticate members to a sequencer and signing protocol messages.

74.  trait SigningOps extends AnyRef

    Signing operations that do not require access to a private key store but operates with provided keys.

75.  final case class SigningPrivateKey extends PrivateKey with HasVersionedWrapper[SigningPrivateKey] with Product with Serializable
76.  trait SigningPrivateOps extends AnyRef

    Signing operations that require access to stored private keys.

77.  trait SigningPrivateStoreOps extends SigningPrivateOps

    A default implementation with a private key store

78.  final case class SigningPublicKey extends PublicKey with PrettyPrinting with HasVersionedWrapper[SigningPublicKey] with Product with Serializable
79.  final case class SigningPublicKeyWithName(publicKey: SigningPublicKey, name: Option[KeyName]) extends PublicKeyWithName with PrettyPrinting with Product with Serializable
80.  final case class SymmetricKey(format: CryptoKeyFormat, key: ByteString, scheme: SymmetricKeyScheme) extends CryptoKey with HasVersionedWrapper[SymmetricKey] with NoCopy with Product with Serializable
81.  sealed trait SymmetricKeyScheme extends Product with Serializable with PrettyPrinting with UniformCantonConfigValidation

    Key schemes for symmetric encryption.

82.  trait SyncCryptoApi extends AnyRef

    impure part of the crypto api with access to private key store and knowledge about the current entity to key assoc

83.  class SyncCryptoApiParticipantProvider extends AnyRef

    Crypto API Provider class

    Crypto API Provider class

    The utility class combines the information provided by the IPSclient, the pure crypto functions and the signing and decryption operations on a private key vault in order to automatically resolve the right keys to use for signing / decryption based on synchronizer and timestamp. This API is intended only for participants and covers all usages of protocol signing keys, thus, session keys will be used if they are enabled.

    TODO(#23810): Reuse SyncCryptoApiParticipantProvider for all nodes and not only participants

84.  trait SyncCryptoClient[+T <: SyncCryptoApi] extends TopologyClientApi[T]
85.  sealed trait SyncCryptoError extends Product with Serializable with PrettyPrinting
86.  class SynchronizerCryptoClient extends SyncCryptoClient[SynchronizerSnapshotSyncCryptoApi] with HasFutureSupervision with NamedLogging with FlagCloseable

    Crypto operations on a particular synchronizer

87.  final class SynchronizerCryptoPureApi extends CryptoPureApi

    Wraps the CryptoPureApi to include static synchronizer parameters, ensuring that during signature verification and decryption (both asymmetric and symmetric), the static synchronizer parameters are explicitly checked.

    Wraps the CryptoPureApi to include static synchronizer parameters, ensuring that during signature verification and decryption (both asymmetric and symmetric), the static synchronizer parameters are explicitly checked. This is crucial because a malicious counter participant could potentially use a downgraded scheme. For other methods, such as key generation, signing, or encryption by this (honest) participant, we rely on the synchronizer handshake to ensure that only supported schemes within the synchronizer are used.

    TODO(#20714): decryption checks come in a separate PR

88.  class SynchronizerSnapshotSyncCryptoApi extends SyncCryptoApi with NamedLogging

    crypto operations for a (synchronizer,timestamp)

89.  final case class X509CertificateDer extends Product with Serializable

    A X509 Certificate serialized in DER format.

90.  sealed trait X509CertificateEncoder[Encoding] extends AnyRef
91.  final case class X509CertificatePem extends Product with Serializable

    A X509 Certificate serialized in PEM format.