Class KeylessPublicKey

Represents a Keyless Public Key used for authentication.

This class encapsulates the public key functionality for keyless authentication, including methods for generating and verifying signatures, as well as serialization and deserialization of the key. The KeylessPublicKey is represented in the SDK as AnyPublicKey.

Hierarchy (view full)

AccountPublicKey
- KeylessPublicKey

Index

Constructors

constructor

new KeylessPublicKey(iss, idCommitment): KeylessPublicKey
Constructs an instance with the specified parameters for cryptographic operations.
Parameters
- iss: string
- idCommitment: HexInput
Returns KeylessPublicKey
Overrides AccountPublicKey.constructor
- Defined in src/core/crypto/keyless.ts:84

Methods

authKey

authKey(): AuthenticationKey
Get the authentication key for the keyless public key.

Returns AuthenticationKey
AuthenticationKey - The authentication key derived from the keyless public key.
Overrides AccountPublicKey.authKey
- Defined in src/core/crypto/keyless.ts:99

bcsToBytes

bcsToBytes(): Uint8Array
Serializes a Serializable value to its BCS representation. This function is the TypeScript SDK equivalent of bcs::to_bytes in Move.

Returns Uint8Array
the BCS representation of the Serializable instance as a byte buffer.
Inherited from AccountPublicKey.bcsToBytes
- Defined in src/bcs/serializer.ts:29

bcsToHex

bcsToHex(): Hex
Converts the BCS-serialized bytes of a value into a Hex instance. This function provides a Hex representation of the BCS-serialized data for easier handling and manipulation.

Returns Hex
A Hex instance with the BCS-serialized bytes loaded into its underlying Uint8Array.
Inherited from AccountPublicKey.bcsToHex
- Defined in src/bcs/serializer.ts:40

serialize

serialize(serializer): void
Serializes the current instance into a format suitable for transmission or storage. This function ensures that all relevant fields are properly serialized, including the proof and optional fields.
Parameters
- serializer: Serializer
  The serializer instance used to perform the serialization.
Returns void
Overrides AccountPublicKey.serialize
- Defined in src/core/crypto/keyless.ts:133

toString

toString(): string
Get the public key as a hex string with a 0x prefix.

Returns string
The public key in hex format.
Inherited from AccountPublicKey.toString
- Defined in src/core/crypto/publicKey.ts:44

toStringWithoutPrefix

toStringWithoutPrefix(): string
Returns the hex string representation of the Serializable value without the 0x prefix.

Returns string
the hex format as a string without 0x prefix.
Inherited from AccountPublicKey.toStringWithoutPrefix
- Defined in src/bcs/serializer.ts:49

toUint8Array

toUint8Array(): Uint8Array
Get the raw public key bytes

Returns Uint8Array
Inherited from AccountPublicKey.toUint8Array
- Defined in src/core/crypto/publicKey.ts:35

verifySignature

verifySignature(args): boolean
Verifies the validity of a signature for a given message.
Parameters
- args: {
  message: HexInput;
  signature: KeylessSignature;
  }
  The arguments for signature verification.
  - message: HexInput
    The message that was signed.
  - signature: KeylessSignature
    The signature to verify against the message.
Returns boolean
true if the signature is valid; otherwise, false.
Overrides AccountPublicKey.verifySignature
- Defined in src/core/crypto/keyless.ts:118

`Static`create

create(args): KeylessPublicKey
Creates a KeylessPublicKey from the JWT components plus pepper
Parameters
- args: {
      aud: string;
      iss: string;
      pepper: HexInput;
      uidKey: string;
      uidVal: string;
  }
  - aud: string
    the client ID of the application
  - iss: string
    the iss of the identity
  - pepper: HexInput
    The pepper used to maintain privacy of the account
  - uidKey: string
    the key to use to get the uidVal in the JWT token
  - uidVal: string
    the value of the uidKey in the JWT token
Returns KeylessPublicKey
KeylessPublicKey
- Defined in src/core/crypto/keyless.ts:186

`Static`deserialize

deserialize(deserializer): KeylessPublicKey
Deserializes a ZeroKnowledgeSig object from the provided deserializer. This function allows you to reconstruct a ZeroKnowledgeSig instance from its serialized form.
Parameters
- deserializer: Deserializer
  The deserializer instance used to read the serialized data.
Returns KeylessPublicKey
A new instance of ZeroKnowledgeSig.
- Defined in src/core/crypto/keyless.ts:145

`Static`fromJwtAndPepper

fromJwtAndPepper(args): KeylessPublicKey
Creates a KeylessPublicKey instance from a JWT and a pepper value. This function is useful for generating a public key that can be used for authentication based on the provided JWT claims and pepper.
Parameters
- args: {
      jwt: string;
      pepper: HexInput;
      uidKey?: string;
  }
  The arguments for creating the KeylessPublicKey.
  - jwt: string
    The JSON Web Token to decode.
  - pepper: HexInput
    The pepper value used in the key creation process.
  - OptionaluidKey?: string
    An optional key to retrieve the unique identifier from the JWT payload, defaults to "sub".
Returns KeylessPublicKey
A KeylessPublicKey instance created from the provided JWT and pepper.
- Defined in src/core/crypto/keyless.ts:207

`Static`isInstance

isInstance(publicKey): boolean
Checks if the provided public key is a valid instance by verifying its structure and types.
Parameters
- publicKey: PublicKey
  The public key to validate.
Returns boolean
A boolean indicating whether the public key is a valid instance.
- Defined in src/core/crypto/keyless.ts:226

`Static`isPublicKey

isPublicKey(publicKey): publicKey is KeylessPublicKey
Determines if the provided public key is an instance of KeylessPublicKey.
Parameters
- publicKey: PublicKey
  The public key to check.
Returns publicKey is KeylessPublicKey
A boolean indicating whether the public key is a KeylessPublicKey instance.
- Defined in src/core/crypto/keyless.ts:172

`Static`load

load(deserializer): KeylessPublicKey
Loads a KeylessPublicKey instance from the provided deserializer. This function is used to deserialize the necessary components to create a KeylessPublicKey.
Parameters
- deserializer: Deserializer
  The deserializer used to extract the string and byte data.
Returns KeylessPublicKey
A new instance of KeylessPublicKey.
- Defined in src/core/crypto/keyless.ts:160

Properties

`Readonly`idCommitment

idCommitment: Uint8Array

A value representing a cryptographic commitment to a user identity.

It is calculated from the aud, uidKey, uidVal, pepper.

`Readonly`iss

iss: string

The value of the 'iss' claim on the JWT which identifies the OIDC provider.

`Static` `Readonly`ID_COMMITMENT_LENGTH

ID_COMMITMENT_LENGTH: number = 32

The number of bytes that idCommitment should be

Class KeylessPublicKey

Hierarchy (view full)

Index

Constructors

Methods

Properties

Constructors

constructor

Parameters

Returns KeylessPublicKey

Methods

authKey

Returns AuthenticationKey

bcsToBytes

Returns Uint8Array

bcsToHex

Returns Hex

serialize

Parameters

Returns void

toString

Returns string

toStringWithoutPrefix

Returns string

toUint8Array

Returns Uint8Array

verifySignature

Parameters

message: HexInput

signature: KeylessSignature

Returns boolean

Staticcreate

Parameters

aud: string

iss: string

pepper: HexInput

uidKey: string

uidVal: string

Returns KeylessPublicKey

Staticdeserialize

Parameters

Returns KeylessPublicKey

StaticfromJwtAndPepper

Parameters

jwt: string

pepper: HexInput

OptionaluidKey?: string

Returns KeylessPublicKey

StaticisInstance

Parameters

Returns boolean

StaticisPublicKey

Parameters

Returns publicKey is KeylessPublicKey

Staticload

Parameters

Returns KeylessPublicKey

Properties

ReadonlyidCommitment

Readonlyiss

Static ReadonlyID_COMMITMENT_LENGTH

Settings

On This Page

`Static`create

`Static`deserialize

`Static`fromJwtAndPepper

`Optional`uidKey?: string

`Static`isInstance

`Static`isPublicKey

`Static`load

`Readonly`idCommitment

`Readonly`iss

`Static` `Readonly`ID_COMMITMENT_LENGTH