Crypto.Paseto.Keys.V3

P384 ECDSA cryptographic keys.

Curve

curveP384 :: Curve

Elliptic curve SEC_p384r1.

Private key

data PrivateKeyP384 where

ECDSA private key for curve SEC_p384r1.

Note that this type's Eq instance performs a constant-time equality check.

Bundled Patterns

pattern PrivateKeyP384 :: PrivateKey -> PrivateKeyP384

Instances

Show PrivateKeyP384

Defined in Crypto.Paseto.Keys.V3

Methods

showsPrec :: Int -> PrivateKeyP384 -> ShowS

show :: PrivateKeyP384 -> String

showList :: [PrivateKeyP384] -> ShowS

Eq PrivateKeyP384

Defined in Crypto.Paseto.Keys.V3

Methods

(==) :: PrivateKeyP384 -> PrivateKeyP384 -> Bool

(/=) :: PrivateKeyP384 -> PrivateKeyP384 -> Bool

unPrivateKeyP384 :: PrivateKeyP384 -> PrivateKey

mkPrivateKeyP384 :: PrivateKey -> Maybe PrivateKeyP384

Construct a private key for curve SEC_p384r1.

generatePrivateKeyP384 :: IO PrivateKeyP384

Generate a private key for curve SEC_p384r1.

encodePrivateKeyP384 :: PrivateKeyP384 -> ScrubbedBytes

Encode a private key into its binary format as defined in RFC 5915, i.e. the privateKey field described in section 3.

data ScalarDecodingError

Error decoding a scalar value.

Constructors

ScalarDecodingInvalidLengthError

Invalid scalar length.

Fields

• !Int

  Expected length

• !Int

  Actual length

ScalarDecodingInvalidError

Decoded scalar is invalid for the curve.

Instances

Show ScalarDecodingError

Defined in Crypto.Paseto.Keys.V3.Internal

Methods

showsPrec :: Int -> ScalarDecodingError -> ShowS

show :: ScalarDecodingError -> String

showList :: [ScalarDecodingError] -> ShowS

Eq ScalarDecodingError

Defined in Crypto.Paseto.Keys.V3.Internal

Methods

(==) :: ScalarDecodingError -> ScalarDecodingError -> Bool

(/=) :: ScalarDecodingError -> ScalarDecodingError -> Bool

renderScalarDecodingError :: ScalarDecodingError -> Text

Render a ScalarDecodingError as Text.

decodePrivateKeyP384 :: ScrubbedBytes -> Either ScalarDecodingError PrivateKeyP384

Decode a private key from its binary format as defined in RFC 5915, i.e. the privateKey field described in section 3.

Helpers

generateScalarP384 :: IO Integer

Generate a random scalar on the curve SEC_p384r1.

isScalarValidP384 :: Integer -> Bool

Whether a scalar is valid on the curve SEC_p384r1.

Public key

data PublicKeyP384 where

ECDSA public key for curve SEC_p384r1.

Bundled Patterns

pattern PublicKeyP384 :: PublicKey -> PublicKeyP384

Instances

Show PublicKeyP384

Defined in Crypto.Paseto.Keys.V3

Methods

showsPrec :: Int -> PublicKeyP384 -> ShowS

show :: PublicKeyP384 -> String

showList :: [PublicKeyP384] -> ShowS

Eq PublicKeyP384

Defined in Crypto.Paseto.Keys.V3

Methods

(==) :: PublicKeyP384 -> PublicKeyP384 -> Bool

(/=) :: PublicKeyP384 -> PublicKeyP384 -> Bool

unPublicKeyP384 :: PublicKeyP384 -> PublicKey

mkPublicKeyP384 :: PublicKey -> Maybe PublicKeyP384

Construct a public key for curve SEC_p384r1.

fromPrivateKeyP384 :: PrivateKeyP384 -> PublicKeyP384

Construct the PublicKeyP384 which corresponds to a given PrivateKeyP384.

encodePublicKeyP384 :: PublicKeyP384 -> ByteString

Encode an elliptic curve point into its compressed binary format as defined by SEC 1 and RFC 5480 section 2.2.

data CompressedPointDecodingError

Error decoding a compressed elliptic curve point.

Constructors

CompressedPointDecodingInvalidPrefixError

Prefix is not either of the expected values (0x02 or 0x03).

Fields

• !Word8

  Invalid prefix which was encountered.

CompressedPointDecodingInvalidLengthError

Length of the provided compressed point is invalid.

Fields

• !Int

  Expected length

• !Int

  Actual length

CompressedPointDecodingModularSquareRootError

Failed to find the modular square root of a value.

CompressedPointDecodingInvalidPointError !Point

Point is invalid for the curve.

Instances

Show CompressedPointDecodingError

Defined in Crypto.Paseto.Keys.V3.Internal

Methods

showsPrec :: Int -> CompressedPointDecodingError -> ShowS

show :: CompressedPointDecodingError -> String

showList :: [CompressedPointDecodingError] -> ShowS

Eq CompressedPointDecodingError

Defined in Crypto.Paseto.Keys.V3.Internal

Methods

(==) :: CompressedPointDecodingError -> CompressedPointDecodingError -> Bool

(/=) :: CompressedPointDecodingError -> CompressedPointDecodingError -> Bool

data UncompressedPointDecodingError

Error decoding an uncompressed elliptic curve point.

Constructors

UncompressedPointDecodingInvalidPrefixError

Prefix is not the expected value (0x04).

Fields

• !Word8

  Invalid prefix which was encountered.

UncompressedPointDecodingInvalidLengthError

Length of the provided point is invalid.

Fields

• !Int

  Expected length

• !Int

  Actual length

UncompressedPointDecodingInvalidPointError !Point

Point is invalid for the curve.

Instances

Show UncompressedPointDecodingError

Defined in Crypto.Paseto.Keys.V3.Internal

Methods

showsPrec :: Int -> UncompressedPointDecodingError -> ShowS

show :: UncompressedPointDecodingError -> String

showList :: [UncompressedPointDecodingError] -> ShowS

Eq UncompressedPointDecodingError

Defined in Crypto.Paseto.Keys.V3.Internal

Methods

(==) :: UncompressedPointDecodingError -> UncompressedPointDecodingError -> Bool

(/=) :: UncompressedPointDecodingError -> UncompressedPointDecodingError -> Bool

data PublicKeyP384DecodingError

Error decoding a public key for curve SEC_p384r1.

Constructors

PublicKeyP384DecodingCompressedError !CompressedPointDecodingError

Error decoding a compressed public key.

PublicKeyP384DecodingUncompressedError !UncompressedPointDecodingError

Error decoding an uncompressed public key.

Instances

Show PublicKeyP384DecodingError

Defined in Crypto.Paseto.Keys.V3

Methods

showsPrec :: Int -> PublicKeyP384DecodingError -> ShowS

show :: PublicKeyP384DecodingError -> String

showList :: [PublicKeyP384DecodingError] -> ShowS

Eq PublicKeyP384DecodingError

Defined in Crypto.Paseto.Keys.V3

Methods

(==) :: PublicKeyP384DecodingError -> PublicKeyP384DecodingError -> Bool

(/=) :: PublicKeyP384DecodingError -> PublicKeyP384DecodingError -> Bool

renderPublicKeyP384DecodingError :: PublicKeyP384DecodingError -> Text

Render a PublicKeyP384DecodingError as Text.

decodePublicKeyP384 :: ByteString -> Either PublicKeyP384DecodingError PublicKeyP384

Decode a public key from either its compressed or uncompressed binary format as defined by SEC 1 and RFC 5480 section 2.2.