Class EncapsulationPrivateKey

Represents a private key for key encapsulation.

Use this to decapsulate a shared secret from ciphertext.

Implements

ReferenceProvider
CborTaggedEncodable
CborTaggedDecodable<EncapsulationPrivateKey>
UREncodable

Methods

`Static`fromX25519PrivateKey

fromX25519PrivateKey(privateKey: X25519PrivateKey): EncapsulationPrivateKey
Create an EncapsulationPrivateKey from an X25519PrivateKey.
Parameters
- privateKey: X25519PrivateKey
Returns EncapsulationPrivateKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:73

`Static`fromX25519Data

fromX25519Data(data: Uint8Array): EncapsulationPrivateKey
Create an EncapsulationPrivateKey from raw X25519 private key bytes.
Parameters
- data: Uint8Array
Returns EncapsulationPrivateKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:80

`Static`new

new(): EncapsulationPrivateKey
Generate a new random X25519 encapsulation private key.

Returns EncapsulationPrivateKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:88

`Static`random

random(): EncapsulationPrivateKey
Generate a new random X25519 encapsulation private key.

Returns EncapsulationPrivateKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:95

`Static`newUsing

newUsing(rng: RandomNumberGenerator): EncapsulationPrivateKey
Generate a new random X25519 encapsulation private key using provided RNG.
Parameters
- rng: RandomNumberGenerator
Returns EncapsulationPrivateKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:103

`Static`keypair

keypair(): [EncapsulationPrivateKey, EncapsulationPublicKey]
Generate a new keypair.

Returns [EncapsulationPrivateKey, EncapsulationPublicKey]
- Defined in components/src/encapsulation/encapsulation-private-key.ts:111

`Static`keypairUsing

keypairUsing(
rng: RandomNumberGenerator,
): [EncapsulationPrivateKey, EncapsulationPublicKey]
Generate a new keypair using the given RNG.
Parameters
- rng: RandomNumberGenerator
Returns [EncapsulationPrivateKey, EncapsulationPublicKey]
- Defined in components/src/encapsulation/encapsulation-private-key.ts:120

encapsulationScheme

encapsulationScheme(): EncapsulationScheme
Returns the encapsulation scheme.

Returns EncapsulationScheme
- Defined in components/src/encapsulation/encapsulation-private-key.ts:135

isX25519

isX25519(): boolean
Returns true if this is an X25519 private key.

Returns boolean
- Defined in components/src/encapsulation/encapsulation-private-key.ts:142

x25519PrivateKey

x25519PrivateKey(): X25519PrivateKey
Returns the X25519 private key if this is an X25519 encapsulation key.

Returns X25519PrivateKey
Throws
Error if this is not an X25519 key
- Defined in components/src/encapsulation/encapsulation-private-key.ts:150

data

data(): Uint8Array
Returns the raw private key data.

Returns Uint8Array
- Defined in components/src/encapsulation/encapsulation-private-key.ts:160

publicKey

publicKey(): EncapsulationPublicKey
Get the public key corresponding to this private key.

Returns EncapsulationPublicKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:175

decapsulateSharedSecret

decapsulateSharedSecret(ciphertext: EncapsulationCiphertext): SymmetricKey
Decapsulate a shared secret from ciphertext.
Parameters
- ciphertext: EncapsulationCiphertext
  The ciphertext from encapsulation
Returns SymmetricKey
The decapsulated shared secret

Throws
CryptoError if the scheme doesn't match
- Defined in components/src/encapsulation/encapsulation-private-key.ts:195

equals

equals(other: EncapsulationPrivateKey): boolean
Compare with another EncapsulationPrivateKey.
Parameters
- other: EncapsulationPrivateKey
Returns boolean
- Defined in components/src/encapsulation/encapsulation-private-key.ts:221

toString

toString(): string
Get string representation.

Returns string
- Defined in components/src/encapsulation/encapsulation-private-key.ts:238

reference

reference(): Reference
Returns a unique reference to this EncapsulationPrivateKey instance.

The reference is derived from the SHA-256 hash of the tagged CBOR representation, providing a unique, content-addressable identifier.

Returns Reference
Implementation of ReferenceProvider.reference
- Defined in components/src/encapsulation/encapsulation-private-key.ts:257

cborTags

cborTags(): Tag[]
Returns the CBOR tags associated with this private key.

Returns Tag[]
Implementation of CborTaggedEncodable.cborTags
- Defined in components/src/encapsulation/encapsulation-private-key.ts:269

untaggedCbor

untaggedCbor(): Cbor
Returns the untagged CBOR encoding.

Returns Cbor
Implementation of CborTaggedEncodable.untaggedCbor
- Defined in components/src/encapsulation/encapsulation-private-key.ts:281

taggedCbor

taggedCbor(): Cbor
Returns the tagged CBOR encoding.

Returns Cbor
Implementation of CborTaggedEncodable.taggedCbor
- Defined in components/src/encapsulation/encapsulation-private-key.ts:296

taggedCborData

taggedCborData(): Uint8Array
Returns the tagged value in CBOR binary representation.

Returns Uint8Array
Implementation of CborTaggedEncodable.taggedCborData
- Defined in components/src/encapsulation/encapsulation-private-key.ts:303

fromUntaggedCbor

fromUntaggedCbor(cborValue: Cbor): EncapsulationPrivateKey
Creates an EncapsulationPrivateKey by decoding it from untagged CBOR. Note: Without tags, we assume X25519 scheme.
Parameters
- cborValue: Cbor
Returns EncapsulationPrivateKey
Implementation of CborTaggedDecodable.fromUntaggedCbor
- Defined in components/src/encapsulation/encapsulation-private-key.ts:315

fromTaggedCbor

fromTaggedCbor(cborValue: Cbor): EncapsulationPrivateKey
Creates an EncapsulationPrivateKey by decoding it from tagged CBOR.
Parameters
- cborValue: Cbor
Returns EncapsulationPrivateKey
Implementation of CborTaggedDecodable.fromTaggedCbor
- Defined in components/src/encapsulation/encapsulation-private-key.ts:324

`Static`fromTaggedCbor

fromTaggedCbor(cborValue: Cbor): EncapsulationPrivateKey
Static method to decode from tagged CBOR.
Parameters
- cborValue: Cbor
Returns EncapsulationPrivateKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:340

`Static`fromTaggedCborData

fromTaggedCborData(data: Uint8Array): EncapsulationPrivateKey
Static method to decode from tagged CBOR binary data.
Parameters
- data: Uint8Array
Returns EncapsulationPrivateKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:350

`Static`fromUntaggedCborData

fromUntaggedCborData(data: Uint8Array): EncapsulationPrivateKey
Static method to decode from untagged CBOR binary data.
Parameters
- data: Uint8Array
Returns EncapsulationPrivateKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:358

ur

ur(): UR
Returns the UR representation.

Returns UR
Implementation of UREncodable.ur
- Defined in components/src/encapsulation/encapsulation-private-key.ts:373

urString

urString(): string
Returns the UR string representation.

Returns string
Implementation of UREncodable.urString
- Defined in components/src/encapsulation/encapsulation-private-key.ts:388

`Static`fromUR

fromUR(ur: UR): EncapsulationPrivateKey
Creates an EncapsulationPrivateKey from a UR.
Parameters
- ur: UR
Returns EncapsulationPrivateKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:395

`Static`fromURString

fromURString(urString: string): EncapsulationPrivateKey
Creates an EncapsulationPrivateKey from a UR string.
Parameters
- urString: string
Returns EncapsulationPrivateKey
- Defined in components/src/encapsulation/encapsulation-private-key.ts:410