@aptos-labs/ts-sdk 1.14.0-zeta.0 → 1.14.0-zeta.2

package/dist/esm/types/index.d.mts

@@ -111,9 +111,11 @@ declare enum EphemeralPublicKeyVariant {
 declare enum EphemeralSignatureVariant {
     Ed25519 = 0
 }
-declare enum EphemeralCertificate {
-    ZkProof = 0,
-    OpenIdSignature = 1
+declare enum EphemeralCertificateVariant {
+    ZkProof = 0
+}
+declare enum ZkpVariant {
+    Groth16 = 0
 }
 /**
  * BCS types
@@ -949,4 +951,4 @@ type GenerateAccountWithSingleSignerSecp256k1Key = {
 };
 type GenerateAccount = GenerateAccountWithEd25519 | GenerateAccountWithSingleSignerSecp256k1Key;
 
-export { AccountAuthenticatorVariant, type AccountData, type AccountSignature, type AnyNumber, AnyPublicKeyVariant, AnySignatureVariant, type AptosRequest, type AptosSettings, type AuthenticationKeyScheme, type Block, type BlockMetadataTransactionResponse, type Client, type ClientConfig, type ClientHeadersType, type ClientRequest, type ClientResponse, type CommittedTransactionResponse, type DecodedTableData, type DeletedTableData, DeriveScheme, type DirectWriteSet, type EntryFunctionPayloadResponse, EphemeralCertificate, EphemeralPublicKeyVariant, EphemeralSignatureVariant, type Event, type EventGuid, type FaucetConfig, type FullNodeConfig, type GasEstimation, type GenerateAccount, type GenerateAccountWithEd25519, type GenerateAccountWithSingleSignerSecp256k1Key, type GenesisPayload, type GenesisTransactionResponse, type HexInput, type IndexerConfig, type LedgerInfo, type LedgerVersionArg, MimeType, MoveAbility, type MoveAddressType, type MoveFunction, type MoveFunctionGenericTypeParam, type MoveFunctionId, MoveFunctionVisibility, type MoveModule, type MoveModuleBytecode, type MoveModuleId, type MoveObjectType, type MoveOptionType, type MoveResource, type MoveScriptBytecode, type MoveStruct, type MoveStructField, type MoveStructId, type MoveStructType, type MoveType, type MoveUint128Type, type MoveUint16Type, type MoveUint256Type, type MoveUint32Type, type MoveUint64Type, type MoveUint8Type, type MoveValue, type MultisigPayloadResponse, OrderBy, type OrderByArg, type PaginationArgs, type PendingTransactionResponse, RoleType, type ScriptPayloadResponse, ScriptTransactionArgumentVariants, type ScriptWriteSet, SigningScheme, SigningSchemeInput, type StateCheckpointTransactionResponse, type TableItemRequest, TokenStandard, type TokenStandardArg, TransactionAuthenticatorVariant, type TransactionEd25519Signature, type TransactionFeePayerSignature, type TransactionMultiAgentSignature, type TransactionMultiEd25519Signature, type TransactionPayloadResponse, TransactionPayloadVariants, type TransactionResponse, TransactionResponseType, type TransactionSecp256k1Signature, type TransactionSignature, TransactionVariants, TypeTagVariants, type Uint128, type Uint16, type Uint256, type Uint32, type Uint64, type Uint8, type UserTransactionResponse, type ValidatorTransactionResponse, type WaitForTransactionOptions, type WhereArg, type WriteSet, type WriteSetChange, type WriteSetChangeDeleteModule, type WriteSetChangeDeleteResource, type WriteSetChangeDeleteTableItem, type WriteSetChangeWriteModule, type WriteSetChangeWriteResource, type WriteSetChangeWriteTableItem, isBlockMetadataTransactionResponse, isEd25519Signature, isFeePayerSignature, isGenesisTransactionResponse, isMultiAgentSignature, isMultiEd25519Signature, isPendingTransactionResponse, isSecp256k1Signature, isStateCheckpointTransactionResponse, isUserTransactionResponse, isValidatorTransactionResponse };
+export { AccountAuthenticatorVariant, type AccountData, type AccountSignature, type AnyNumber, AnyPublicKeyVariant, AnySignatureVariant, type AptosRequest, type AptosSettings, type AuthenticationKeyScheme, type Block, type BlockMetadataTransactionResponse, type Client, type ClientConfig, type ClientHeadersType, type ClientRequest, type ClientResponse, type CommittedTransactionResponse, type DecodedTableData, type DeletedTableData, DeriveScheme, type DirectWriteSet, type EntryFunctionPayloadResponse, EphemeralCertificateVariant, EphemeralPublicKeyVariant, EphemeralSignatureVariant, type Event, type EventGuid, type FaucetConfig, type FullNodeConfig, type GasEstimation, type GenerateAccount, type GenerateAccountWithEd25519, type GenerateAccountWithSingleSignerSecp256k1Key, type GenesisPayload, type GenesisTransactionResponse, type HexInput, type IndexerConfig, type LedgerInfo, type LedgerVersionArg, MimeType, MoveAbility, type MoveAddressType, type MoveFunction, type MoveFunctionGenericTypeParam, type MoveFunctionId, MoveFunctionVisibility, type MoveModule, type MoveModuleBytecode, type MoveModuleId, type MoveObjectType, type MoveOptionType, type MoveResource, type MoveScriptBytecode, type MoveStruct, type MoveStructField, type MoveStructId, type MoveStructType, type MoveType, type MoveUint128Type, type MoveUint16Type, type MoveUint256Type, type MoveUint32Type, type MoveUint64Type, type MoveUint8Type, type MoveValue, type MultisigPayloadResponse, OrderBy, type OrderByArg, type PaginationArgs, type PendingTransactionResponse, RoleType, type ScriptPayloadResponse, ScriptTransactionArgumentVariants, type ScriptWriteSet, SigningScheme, SigningSchemeInput, type StateCheckpointTransactionResponse, type TableItemRequest, TokenStandard, type TokenStandardArg, TransactionAuthenticatorVariant, type TransactionEd25519Signature, type TransactionFeePayerSignature, type TransactionMultiAgentSignature, type TransactionMultiEd25519Signature, type TransactionPayloadResponse, TransactionPayloadVariants, type TransactionResponse, TransactionResponseType, type TransactionSecp256k1Signature, type TransactionSignature, TransactionVariants, TypeTagVariants, type Uint128, type Uint16, type Uint256, type Uint32, type Uint64, type Uint8, type UserTransactionResponse, type ValidatorTransactionResponse, type WaitForTransactionOptions, type WhereArg, type WriteSet, type WriteSetChange, type WriteSetChangeDeleteModule, type WriteSetChangeDeleteResource, type WriteSetChangeDeleteTableItem, type WriteSetChangeWriteModule, type WriteSetChangeWriteResource, type WriteSetChangeWriteTableItem, ZkpVariant, isBlockMetadataTransactionResponse, isEd25519Signature, isFeePayerSignature, isGenesisTransactionResponse, isMultiAgentSignature, isMultiEd25519Signature, isPendingTransactionResponse, isSecp256k1Signature, isStateCheckpointTransactionResponse, isUserTransactionResponse, isValidatorTransactionResponse };

package/dist/esm/types/index.mjs

@@ -1,2 +1,69 @@
-import{A,B,C,D,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}from"../chunk-OKRUEVF3.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-FVA2OPG4.mjs";export{g as AccountAuthenticatorVariant,h as AnyPublicKeyVariant,i as AnySignatureVariant,D as DeriveScheme,l as EphemeralCertificate,j as EphemeralPublicKeyVariant,k as EphemeralSignatureVariant,a as MimeType,z as MoveAbility,y as MoveFunctionVisibility,A as RoleType,c as ScriptTransactionArgumentVariants,B as SigningScheme,C as SigningSchemeInput,f as TransactionAuthenticatorVariant,d as TransactionPayloadVariants,m as TransactionResponseType,e as TransactionVariants,b as TypeTagVariants,q as isBlockMetadataTransactionResponse,t as isEd25519Signature,w as isFeePayerSignature,p as isGenesisTransactionResponse,v as isMultiAgentSignature,x as isMultiEd25519Signature,n as isPendingTransactionResponse,u as isSecp256k1Signature,r as isStateCheckpointTransactionResponse,o as isUserTransactionResponse,s as isValidatorTransactionResponse};
+import {
+  AccountAuthenticatorVariant,
+  AnyPublicKeyVariant,
+  AnySignatureVariant,
+  DeriveScheme,
+  EphemeralCertificateVariant,
+  EphemeralPublicKeyVariant,
+  EphemeralSignatureVariant,
+  MimeType,
+  MoveAbility,
+  MoveFunctionVisibility,
+  RoleType,
+  ScriptTransactionArgumentVariants,
+  SigningScheme,
+  SigningSchemeInput,
+  TransactionAuthenticatorVariant,
+  TransactionPayloadVariants,
+  TransactionResponseType,
+  TransactionVariants,
+  TypeTagVariants,
+  ZkpVariant,
+  isBlockMetadataTransactionResponse,
+  isEd25519Signature,
+  isFeePayerSignature,
+  isGenesisTransactionResponse,
+  isMultiAgentSignature,
+  isMultiEd25519Signature,
+  isPendingTransactionResponse,
+  isSecp256k1Signature,
+  isStateCheckpointTransactionResponse,
+  isUserTransactionResponse,
+  isValidatorTransactionResponse
+} from "../chunk-CX3NAVRD.mjs";
+import "../chunk-4WPQQPUF.mjs";
+import "../chunk-OR7TEZ25.mjs";
+export {
+  AccountAuthenticatorVariant,
+  AnyPublicKeyVariant,
+  AnySignatureVariant,
+  DeriveScheme,
+  EphemeralCertificateVariant,
+  EphemeralPublicKeyVariant,
+  EphemeralSignatureVariant,
+  MimeType,
+  MoveAbility,
+  MoveFunctionVisibility,
+  RoleType,
+  ScriptTransactionArgumentVariants,
+  SigningScheme,
+  SigningSchemeInput,
+  TransactionAuthenticatorVariant,
+  TransactionPayloadVariants,
+  TransactionResponseType,
+  TransactionVariants,
+  TypeTagVariants,
+  ZkpVariant,
+  isBlockMetadataTransactionResponse,
+  isEd25519Signature,
+  isFeePayerSignature,
+  isGenesisTransactionResponse,
+  isMultiAgentSignature,
+  isMultiEd25519Signature,
+  isPendingTransactionResponse,
+  isSecp256k1Signature,
+  isStateCheckpointTransactionResponse,
+  isUserTransactionResponse,
+  isValidatorTransactionResponse
+};
 //# sourceMappingURL=index.mjs.map

package/dist/esm/types/indexer.mjs

@@ -1,2 +1,2 @@
-import"../chunk-4WPQQPUF.mjs";
+import "../chunk-4WPQQPUF.mjs";
 //# sourceMappingURL=indexer.mjs.map

package/dist/esm/types/keyless.d.mts

@@ -1,3 +1,45 @@
+import { KeylessAccount } from '../account/KeylessAccount.mjs';
+import { AptosApiError } from '../client/types.mjs';
+import 'eventemitter3';
+import './index.mjs';
+import '../utils/apiEndpoints.mjs';
+import './indexer.mjs';
+import './generated/operations.mjs';
+import './generated/types.mjs';
+import '../core/accountAddress.mjs';
+import '../bcs/serializer.mjs';
+import '../core/hex.mjs';
+import '../core/common.mjs';
+import '../bcs/deserializer.mjs';
+import '../transactions/instances/transactionArgument.mjs';
+import '../core/crypto/signature.mjs';
+import '../core/crypto/keyless.mjs';
+import '../publicKey-lq5djCIY.mjs';
+import '../core/crypto/ephemeral.mjs';
+import '../core/crypto/proof.mjs';
+import '../Ed25519Account-9zBaZEnp.mjs';
+import '../transactions/authenticator/account.mjs';
+import '../core/crypto/ed25519.mjs';
+import '../core/crypto/privateKey.mjs';
+import '../core/crypto/multiEd25519.mjs';
+import '../core/crypto/multiKey.mjs';
+import '../core/crypto/singleKey.mjs';
+import '../transactions/types.mjs';
+import '../api/aptosConfig.mjs';
+import '../utils/const.mjs';
+import '../bcs/serializable/moveStructs.mjs';
+import '../bcs/serializable/movePrimitives.mjs';
+import '../bcs/serializable/fixedBytes.mjs';
+import '../transactions/instances/rawTransaction.mjs';
+import '../transactions/instances/chainId.mjs';
+import '../transactions/instances/transactionPayload.mjs';
+import '../transactions/instances/identifier.mjs';
+import '../transactions/instances/moduleId.mjs';
+import '../transactions/typeTag/index.mjs';
+import '../transactions/instances/simpleTransaction.mjs';
+import '../transactions/instances/multiAgentTransaction.mjs';
+import '../account/EphemeralKeyPair.mjs';
+
 type ProverResponse = {
     proof: {
         a: string;
@@ -12,5 +54,16 @@ type PepperFetchResponse = {
     pepper: string;
     address: string;
 };
+declare enum KeylessErrorType {
+    JWK_EXPIRED = 0,
+    EPK_EXPIRED = 1,
+    UNKNOWN_INVALID_SIGNATURE = 2,
+    UNKNOWN = 3
+}
+declare class KeylessError extends Error {
+    readonly type: KeylessErrorType;
+    private constructor();
+    static fromAptosApiError(error: AptosApiError, signer: KeylessAccount): Promise<KeylessError>;
+}
 
-export type { PepperFetchResponse, ProverResponse };
+export { KeylessError, KeylessErrorType, type PepperFetchResponse, type ProverResponse };

package/dist/esm/types/keyless.mjs

@@ -1 +1,10 @@
+import {
+  KeylessError,
+  KeylessErrorType
+} from "../chunk-2JOCR2VL.mjs";
+import "../chunk-OR7TEZ25.mjs";
+export {
+  KeylessError,
+  KeylessErrorType
+};
 //# sourceMappingURL=keyless.mjs.map

package/dist/esm/utils/apiEndpoints.mjs

@@ -1,2 +1,22 @@
-import{a,b,c,d,e,f,g,h}from"../chunk-32355KGV.mjs";import"../chunk-FVA2OPG4.mjs";export{f as Network,g as NetworkToChainId,c as NetworkToFaucetAPI,a as NetworkToIndexerAPI,h as NetworkToNetworkName,b as NetworkToNodeAPI,d as NetworkToPepperAPI,e as NetworkToProverAPI};
+import {
+  Network,
+  NetworkToChainId,
+  NetworkToFaucetAPI,
+  NetworkToIndexerAPI,
+  NetworkToNetworkName,
+  NetworkToNodeAPI,
+  NetworkToPepperAPI,
+  NetworkToProverAPI
+} from "../chunk-7REUIYF4.mjs";
+import "../chunk-OR7TEZ25.mjs";
+export {
+  Network,
+  NetworkToChainId,
+  NetworkToFaucetAPI,
+  NetworkToIndexerAPI,
+  NetworkToNetworkName,
+  NetworkToNodeAPI,
+  NetworkToPepperAPI,
+  NetworkToProverAPI
+};
 //# sourceMappingURL=apiEndpoints.mjs.map

package/dist/esm/utils/const.mjs

@@ -1,2 +1,22 @@
-import{a,b,c,d,e,f,g,h}from"../chunk-YE5B2S5L.mjs";import"../chunk-FVA2OPG4.mjs";export{e as APTOS_COIN,a as AptosApiType,b as DEFAULT_MAX_GAS_AMOUNT,c as DEFAULT_TXN_EXP_SEC_FROM_NOW,d as DEFAULT_TXN_TIMEOUT_SEC,h as ProcessorType,f as RAW_TRANSACTION_SALT,g as RAW_TRANSACTION_WITH_DATA_SALT};
+import {
+  APTOS_COIN,
+  AptosApiType,
+  DEFAULT_MAX_GAS_AMOUNT,
+  DEFAULT_TXN_EXP_SEC_FROM_NOW,
+  DEFAULT_TXN_TIMEOUT_SEC,
+  ProcessorType,
+  RAW_TRANSACTION_SALT,
+  RAW_TRANSACTION_WITH_DATA_SALT
+} from "../chunk-NFJCQRVK.mjs";
+import "../chunk-OR7TEZ25.mjs";
+export {
+  APTOS_COIN,
+  AptosApiType,
+  DEFAULT_MAX_GAS_AMOUNT,
+  DEFAULT_TXN_EXP_SEC_FROM_NOW,
+  DEFAULT_TXN_TIMEOUT_SEC,
+  ProcessorType,
+  RAW_TRANSACTION_SALT,
+  RAW_TRANSACTION_WITH_DATA_SALT
+};
 //# sourceMappingURL=const.mjs.map

package/dist/esm/utils/helpers.mjs

@@ -1,2 +1,8 @@
-import{a}from"../chunk-3JPVQHOR.mjs";import"../chunk-FVA2OPG4.mjs";export{a as sleep};
+import {
+  sleep
+} from "../chunk-GGMTQAQP.mjs";
+import "../chunk-OR7TEZ25.mjs";
+export {
+  sleep
+};
 //# sourceMappingURL=helpers.mjs.map

package/dist/esm/utils/index.mjs

@@ -1,2 +1,57 @@
-import"../chunk-GED6IT3S.mjs";import{a as q}from"../chunk-ROXFCLDT.mjs";import{a as i,b as j,c as k,d as l,e as m,f as n,g as o,h as p}from"../chunk-32355KGV.mjs";import{a,b,c,d,e,f,g,h}from"../chunk-YE5B2S5L.mjs";import"../chunk-FZY4PMEE.mjs";import"../chunk-EB7AI4B4.mjs";import"../chunk-6RBUXB5I.mjs";import"../chunk-C3L4ETUF.mjs";import"../chunk-3FVRXELT.mjs";import"../chunk-OKRUEVF3.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-6IFMQ5AS.mjs";import"../chunk-TVRJ3M7B.mjs";import"../chunk-AOCNYMMX.mjs";import"../chunk-FBPNHF54.mjs";import"../chunk-56CNRT2K.mjs";import"../chunk-FVA2OPG4.mjs";export{e as APTOS_COIN,a as AptosApiType,b as DEFAULT_MAX_GAS_AMOUNT,c as DEFAULT_TXN_EXP_SEC_FROM_NOW,d as DEFAULT_TXN_TIMEOUT_SEC,n as Network,o as NetworkToChainId,k as NetworkToFaucetAPI,i as NetworkToIndexerAPI,p as NetworkToNetworkName,j as NetworkToNodeAPI,l as NetworkToPepperAPI,m as NetworkToProverAPI,h as ProcessorType,f as RAW_TRANSACTION_SALT,g as RAW_TRANSACTION_WITH_DATA_SALT,q as normalizeBundle};
+import "../chunk-GED6IT3S.mjs";
+import {
+  normalizeBundle
+} from "../chunk-QBBTUC66.mjs";
+import {
+  Network,
+  NetworkToChainId,
+  NetworkToFaucetAPI,
+  NetworkToIndexerAPI,
+  NetworkToNetworkName,
+  NetworkToNodeAPI,
+  NetworkToPepperAPI,
+  NetworkToProverAPI
+} from "../chunk-7REUIYF4.mjs";
+import {
+  APTOS_COIN,
+  AptosApiType,
+  DEFAULT_MAX_GAS_AMOUNT,
+  DEFAULT_TXN_EXP_SEC_FROM_NOW,
+  DEFAULT_TXN_TIMEOUT_SEC,
+  ProcessorType,
+  RAW_TRANSACTION_SALT,
+  RAW_TRANSACTION_WITH_DATA_SALT
+} from "../chunk-NFJCQRVK.mjs";
+import "../chunk-FZY4PMEE.mjs";
+import "../chunk-PIMQHG2J.mjs";
+import "../chunk-KK2BSALW.mjs";
+import "../chunk-AR7X6GWQ.mjs";
+import "../chunk-WK5ZSNE2.mjs";
+import "../chunk-CX3NAVRD.mjs";
+import "../chunk-4WPQQPUF.mjs";
+import "../chunk-7JRMOHBP.mjs";
+import "../chunk-FQQW55X7.mjs";
+import "../chunk-YV7M4CFP.mjs";
+import "../chunk-QMM2KL6C.mjs";
+import "../chunk-SBB4YEPT.mjs";
+import "../chunk-OR7TEZ25.mjs";
+export {
+  APTOS_COIN,
+  AptosApiType,
+  DEFAULT_MAX_GAS_AMOUNT,
+  DEFAULT_TXN_EXP_SEC_FROM_NOW,
+  DEFAULT_TXN_TIMEOUT_SEC,
+  Network,
+  NetworkToChainId,
+  NetworkToFaucetAPI,
+  NetworkToIndexerAPI,
+  NetworkToNetworkName,
+  NetworkToNodeAPI,
+  NetworkToPepperAPI,
+  NetworkToProverAPI,
+  ProcessorType,
+  RAW_TRANSACTION_SALT,
+  RAW_TRANSACTION_WITH_DATA_SALT,
+  normalizeBundle
+};
 //# sourceMappingURL=index.mjs.map

package/dist/esm/utils/memoize.mjs

@@ -1,2 +1,10 @@
-import{a,b}from"../chunk-AH44UPM4.mjs";import"../chunk-FVA2OPG4.mjs";export{b as memoize,a as memoizeAsync};
+import {
+  memoize,
+  memoizeAsync
+} from "../chunk-EYHRMZPO.mjs";
+import "../chunk-OR7TEZ25.mjs";
+export {
+  memoize,
+  memoizeAsync
+};
 //# sourceMappingURL=memoize.mjs.map

package/dist/esm/utils/normalizeBundle.mjs

@@ -1,2 +1,20 @@
-import{a}from"../chunk-ROXFCLDT.mjs";import"../chunk-FZY4PMEE.mjs";import"../chunk-EB7AI4B4.mjs";import"../chunk-6RBUXB5I.mjs";import"../chunk-C3L4ETUF.mjs";import"../chunk-3FVRXELT.mjs";import"../chunk-OKRUEVF3.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-6IFMQ5AS.mjs";import"../chunk-TVRJ3M7B.mjs";import"../chunk-AOCNYMMX.mjs";import"../chunk-FBPNHF54.mjs";import"../chunk-56CNRT2K.mjs";import"../chunk-FVA2OPG4.mjs";export{a as normalizeBundle};
+import {
+  normalizeBundle
+} from "../chunk-QBBTUC66.mjs";
+import "../chunk-FZY4PMEE.mjs";
+import "../chunk-PIMQHG2J.mjs";
+import "../chunk-KK2BSALW.mjs";
+import "../chunk-AR7X6GWQ.mjs";
+import "../chunk-WK5ZSNE2.mjs";
+import "../chunk-CX3NAVRD.mjs";
+import "../chunk-4WPQQPUF.mjs";
+import "../chunk-7JRMOHBP.mjs";
+import "../chunk-FQQW55X7.mjs";
+import "../chunk-YV7M4CFP.mjs";
+import "../chunk-QMM2KL6C.mjs";
+import "../chunk-SBB4YEPT.mjs";
+import "../chunk-OR7TEZ25.mjs";
+export {
+  normalizeBundle
+};
 //# sourceMappingURL=normalizeBundle.mjs.map

package/dist/esm/version.d.mts

@@ -3,6 +3,6 @@
  *
  * hardcoded for now, we would want to have it injected dynamically
  */
-declare const VERSION = "1.14.0-zeta.0";
+declare const VERSION = "1.14.0-zeta.1";
 
 export { VERSION };

package/dist/esm/version.mjs

@@ -1,2 +1,8 @@
-import{a}from"./chunk-7PSX4LCV.mjs";import"./chunk-FVA2OPG4.mjs";export{a as VERSION};
+import {
+  VERSION
+} from "./chunk-D2BVBXWO.mjs";
+import "./chunk-OR7TEZ25.mjs";
+export {
+  VERSION
+};
 //# sourceMappingURL=version.mjs.map

package/package.json

@@ -47,8 +47,8 @@
     "update-version": "scripts/updateVersion.sh && pnpm doc"
   },
   "dependencies": {
-    "@aptos-labs/aptos-client": "^0.1.0",
     "@aptos-labs/aptos-cli": "^0.1.2",
+    "@aptos-labs/aptos-client": "^0.1.0",
     "@noble/curves": "^1.4.0",
     "@noble/hashes": "^1.4.0",
     "@scure/bip32": "^1.4.0",
@@ -57,6 +57,7 @@
     "eventemitter3": "^5.0.1",
     "form-data": "^4.0.0",
     "jose": "^5.1.3",
+    "jwks-rsa": "^3.1.0",
     "jwt-decode": "^4.0.0",
     "poseidon-lite": "^0.2.0"
   },
@@ -69,6 +70,7 @@
     "@graphql-codegen/typescript-operations": "^4.0.1",
     "@types/base-64": "^1.0.2",
     "@types/jest": "^29.5.11",
+    "@types/jsonwebtoken": "^9.0.6",
     "@types/node": "^20.10.4",
     "@typescript-eslint/eslint-plugin": "^6.14.0",
     "@typescript-eslint/parser": "^6.14.0",
@@ -81,6 +83,7 @@
     "graphql": "^16.8.1",
     "graphql-request": "^6.1.0",
     "jest": "^29.7.0",
+    "jsonwebtoken": "^9.0.2",
     "prettier": "^3.1.1",
     "tree-kill": "^1.2.2",
     "ts-jest": "^29.1.1",
@@ -90,5 +93,5 @@
     "typedoc": "^0.25.4",
     "typescript": "^5.3.3"
   },
-  "version": "1.14.0-zeta.0"
+  "version": "1.14.0-zeta.2"
 }

package/src/account/EphemeralKeyPair.ts

@@ -12,18 +12,40 @@ import {
 } from "../core/crypto";
 import { Hex } from "../core/hex";
 import { bytesToBigIntLE, padAndPackBytesWithLen, poseidonHash } from "../core/crypto/poseidon";
-import { EphemeralPublicKeyVariant, HexInput, SigningSchemeInput } from "../types";
+import { EphemeralPublicKeyVariant, HexInput } from "../types";
 import { Deserializer, Serializable, Serializer } from "../bcs";
 
 export class EphemeralKeyPair extends Serializable {
+  static readonly BLINDER_LENGTH: number = 31;
+
+  /**
+   * A byte array of length BLINDER_LENGTH used to obfuscate the public key from the IdP.
+   * Used in calculating the nonce passed to the IdP and as a secret witness in proof generation.
+   */
   readonly blinder: Uint8Array;
 
+  /**
+   * A timestamp in seconds indicating when the ephemeral key pair is expired.  After expiry, a new
+   * EphemeralKeyPair must be generated and a new JWT needs to be created.
+   */
   readonly expiryDateSecs: bigint | number;
 
+  /**
+   * The value passed to the IdP when the user authenticates.  It comprises of a hash of the
+   * ephermeral public key, expiry date, and blinder.
+   */
   readonly nonce: string;
 
+  /**
+   * A private key used to sign transactions.  This private key is not tied to any account on the chain as it
+   * is ephemeral in nature.
+   */
   private privateKey: PrivateKey;
 
+  /**
+   * A public key used to verify transactions.  This public key is not tied to any account on the chain as it
+   * is ephemeral in nature.
+   */
   private publicKey: EphemeralPublicKey;
 
   constructor(args: { privateKey: PrivateKey; expiryDateSecs?: bigint | number; blinder?: HexInput }) {
@@ -31,15 +53,26 @@ export class EphemeralKeyPair extends Serializable {
     const { privateKey, expiryDateSecs, blinder } = args;
     this.privateKey = privateKey;
     this.publicKey = new EphemeralPublicKey(privateKey.publicKey());
+    // We set the expiry date to be the nearest floored hour
     this.expiryDateSecs = expiryDateSecs || BigInt(floorToWholeHour(currentTimeInSeconds() + EPK_HORIZON_SECS));
+    // Generate the blinder if not provided
     this.blinder = blinder !== undefined ? Hex.fromHexInput(blinder).toUint8Array() : generateBlinder();
+    // Calculate the nonce
     this.nonce = this.generateNonce();
   }
 
+  /**
+   * Returns the public key of the key pair.
+   * @return EphemeralPublicKey
+   */
   getPublicKey(): EphemeralPublicKey {
     return this.publicKey;
   }
 
+  /**
+   * Returns the public key of the key pair.
+   * @return boolean
+   */
   isExpired(): boolean {
     const currentTimeSecs: number = Math.floor(Date.now() / 1000);
     return currentTimeSecs > this.expiryDateSecs;
@@ -71,11 +104,16 @@ export class EphemeralKeyPair extends Serializable {
     return EphemeralKeyPair.deserialize(new Deserializer(bytes));
   }
 
-  static generate(args?: { scheme: SigningSchemeInput }): EphemeralKeyPair {
+  /**
+   * Returns the public key of the key pair.
+   * @param scheme the type of keypair to use for the EphemeralKeyPair.  Only Ed25519 supported for now.
+   * @return boolean
+   */
+  static generate(args?: { scheme: EphemeralPublicKeyVariant }): EphemeralKeyPair {
     let privateKey: PrivateKey;
 
     switch (args?.scheme) {
-      case SigningSchemeInput.Ed25519:
+      case EphemeralPublicKeyVariant.Ed25519:
       default:
         privateKey = Ed25519PrivateKey.generate();
     }
@@ -83,7 +121,7 @@ export class EphemeralKeyPair extends Serializable {
     return new EphemeralKeyPair({ privateKey });
   }
 
-  generateNonce(): string {
+  private generateNonce(): string {
     const fields = padAndPackBytesWithLen(this.publicKey.bcsToBytes(), 93);
     fields.push(BigInt(this.expiryDateSecs));
     fields.push(bytesToBigIntLE(this.blinder));
@@ -93,20 +131,20 @@ export class EphemeralKeyPair extends Serializable {
 
   /**
    * Sign the given message with the private key.
-   *   *
+   *
    * @param data in HexInput format
    * @returns EphemeralSignature
    */
   sign(data: HexInput): EphemeralSignature {
     if (this.isExpired()) {
-      throw new Error("EphemeralKeyPair has expired")
+      throw new Error("EphemeralKeyPair has expired");
     }
     return new EphemeralSignature(this.privateKey.sign(data));
   }
 }
 
 function generateBlinder(): Uint8Array {
-  return randomBytes(31);
+  return randomBytes(EphemeralKeyPair.BLINDER_LENGTH);
 }
 
 function currentTimeInSeconds(): number {