@aptos-labs/ts-sdk 6.3.1 → 7.0.0

package/dist/account/AccountUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountUtils.js","sourceRoot":"","sources":["../../src/account/AccountUtils.ts"],"names":[],"mappings":"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"}

package/dist/account/DerivableAbstractedAccount.d.ts

@@ -0,0 +1,51 @@
+import { AccountAuthenticatorAbstraction } from "../transactions/authenticator/account.js";
+import { HexInput, MoveFunctionId } from "../types/index.js";
+import { AbstractedAccount } from "./AbstractedAccount.js";
+type DerivableAbstractedAccountArgs = {
+    /**
+     * The signer function signs transactions and returns the `authenticator` bytes in the `AbstractionAuthData`.
+     *
+     * @param digest - The SHA256 hash of the transaction signing message
+     * @returns The `authenticator` bytes that can be used to verify the signature.
+     */
+    signer: (digest: HexInput) => Uint8Array;
+    /**
+     * The authentication function that will be used to verify the signature.
+     *
+     * @example
+     * ```ts
+     * const authenticationFunction = `${accountAddress}::permissioned_delegation::authenticate`;
+     * ```
+     */
+    authenticationFunction: MoveFunctionId;
+    /**
+     * The abstract public key that is used to identify the account.
+     * Depends on the use cases, most of the time it is the public key of the source wallet
+     */
+    abstractPublicKey: Uint8Array;
+};
+export declare class DerivableAbstractedAccount extends AbstractedAccount {
+    /**
+     * The abstract public key that is used to identify the account.
+     * Depends on the use cases, most of the time it is the public key of the source wallet
+     */
+    readonly abstractPublicKey: Uint8Array;
+    /**
+     * The domain separator used to calculate the DAA account address.
+     */
+    static readonly ADDRESS_DOMAIN_SEPERATOR: number;
+    constructor({ signer, authenticationFunction, abstractPublicKey }: DerivableAbstractedAccountArgs);
+    /**
+     * Compute the account address of the DAA
+     * The DAA account address is computed by hashing the function info and the account identity
+     * and appending the domain separator (5)
+     *
+     * @param functionInfo - The authentication function
+     * @param accountIdentifier - The account identity
+     * @returns The account address
+     */
+    static computeAccountAddress(functionInfo: string, accountIdentifier: Uint8Array): Uint8Array;
+    signWithAuthenticator(message: HexInput): AccountAuthenticatorAbstraction;
+}
+export {};
+//# sourceMappingURL=DerivableAbstractedAccount.d.ts.map

package/dist/account/DerivableAbstractedAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DerivableAbstractedAccount.d.ts","sourceRoot":"","sources":["../../src/account/DerivableAbstractedAccount.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAC3F,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,KAAK,8BAA8B,GAAG;IACpC;;;;;OAKG;IACH,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,UAAU,CAAC;IAEzC;;;;;;;OAOG;IACH,sBAAsB,EAAE,cAAc,CAAC;IAEvC;;;OAGG;IACH,iBAAiB,EAAE,UAAU,CAAC;CAC/B,CAAC;AAEF,qBAAa,0BAA2B,SAAQ,iBAAiB;IAC/D;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IAEvC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAK;gBAEzC,EAAE,MAAM,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,EAAE,8BAA8B;IAYjG;;;;;;;;OAQG;IACH,MAAM,CAAC,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,UAAU,GAAG,UAAU;IAyB7F,qBAAqB,CAAC,OAAO,EAAE,QAAQ,GAAG,+BAA+B;CAS1E"}

package/dist/account/DerivableAbstractedAccount.js

@@ -0,0 +1,61 @@
+import { sha3_256 } from "@noble/hashes/sha3.js";
+import { Serializer } from "../bcs/serializer.js";
+import { AccountAddress } from "../core/accountAddress.js";
+import { Hex } from "../core/hex.js";
+import { AccountAuthenticatorAbstraction } from "../transactions/authenticator/account.js";
+import { isValidFunctionInfo } from "../utils/helpers.js";
+import { AbstractedAccount } from "./AbstractedAccount.js";
+export class DerivableAbstractedAccount extends AbstractedAccount {
+    /**
+     * The abstract public key that is used to identify the account.
+     * Depends on the use cases, most of the time it is the public key of the source wallet
+     */
+    abstractPublicKey;
+    /**
+     * The domain separator used to calculate the DAA account address.
+     */
+    static ADDRESS_DOMAIN_SEPERATOR = 5;
+    constructor({ signer, authenticationFunction, abstractPublicKey }) {
+        const daaAccountAddress = new AccountAddress(DerivableAbstractedAccount.computeAccountAddress(authenticationFunction, abstractPublicKey));
+        super({
+            accountAddress: daaAccountAddress,
+            signer,
+            authenticationFunction,
+        });
+        this.abstractPublicKey = abstractPublicKey;
+    }
+    /**
+     * Compute the account address of the DAA
+     * The DAA account address is computed by hashing the function info and the account identity
+     * and appending the domain separator (5)
+     *
+     * @param functionInfo - The authentication function
+     * @param accountIdentifier - The account identity
+     * @returns The account address
+     */
+    static computeAccountAddress(functionInfo, accountIdentifier) {
+        if (!isValidFunctionInfo(functionInfo)) {
+            throw new Error(`Invalid authentication function ${functionInfo} passed into DerivableAbstractedAccount`);
+        }
+        const [moduleAddress, moduleName, functionName] = functionInfo.split("::");
+        const hash = sha3_256.create();
+        // Serialize and append the function info
+        const serializer = new Serializer();
+        AccountAddress.fromString(moduleAddress).serialize(serializer);
+        serializer.serializeStr(moduleName);
+        serializer.serializeStr(functionName);
+        hash.update(serializer.toUint8Array());
+        // Serialize and append the account identity
+        const s2 = new Serializer();
+        s2.serializeBytes(accountIdentifier);
+        hash.update(s2.toUint8Array());
+        // Append the domain separator
+        hash.update(new Uint8Array([DerivableAbstractedAccount.ADDRESS_DOMAIN_SEPERATOR]));
+        return hash.digest();
+    }
+    signWithAuthenticator(message) {
+        const messageBytes = Hex.fromHexInput(message).toUint8Array();
+        return new AccountAuthenticatorAbstraction(this.authenticationFunction, sha3_256(messageBytes), this.sign(sha3_256(messageBytes)).value, this.abstractPublicKey);
+    }
+}
+//# sourceMappingURL=DerivableAbstractedAccount.js.map

package/dist/account/DerivableAbstractedAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DerivableAbstractedAccount.js","sourceRoot":"","sources":["../../src/account/DerivableAbstractedAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAE3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA4B3D,MAAM,OAAO,0BAA2B,SAAQ,iBAAiB;IAC/D;;;OAGG;IACM,iBAAiB,CAAa;IAEvC;;OAEG;IACH,MAAM,CAAU,wBAAwB,GAAW,CAAC,CAAC;IAErD,YAAY,EAAE,MAAM,EAAE,sBAAsB,EAAE,iBAAiB,EAAkC;QAC/F,MAAM,iBAAiB,GAAG,IAAI,cAAc,CAC1C,0BAA0B,CAAC,qBAAqB,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAC5F,CAAC;QACF,KAAK,CAAC;YACJ,cAAc,EAAE,iBAAiB;YACjC,MAAM;YACN,sBAAsB;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,qBAAqB,CAAC,YAAoB,EAAE,iBAA6B;QAC9E,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,mCAAmC,YAAY,yCAAyC,CAAC,CAAC;QAC5G,CAAC;QACD,MAAM,CAAC,aAAa,EAAE,UAAU,EAAE,YAAY,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3E,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC/B,yCAAyC;QACzC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;QACpC,cAAc,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC/D,UAAU,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACpC,UAAU,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;QAEvC,4CAA4C;QAC5C,MAAM,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;QAC5B,EAAE,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;QAE/B,8BAA8B;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,0BAA0B,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;QAEnF,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,qBAAqB,CAAC,OAAiB;QACrC,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,CAAC;QAC9D,OAAO,IAAI,+BAA+B,CACxC,IAAI,CAAC,sBAAsB,EAC3B,QAAQ,CAAC,YAAY,CAAC,EACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,EACvC,IAAI,CAAC,iBAAiB,CACvB,CAAC;IACJ,CAAC"}

package/dist/account/Ed25519Account.d.ts

@@ -0,0 +1,161 @@
+import { AccountAuthenticatorEd25519 } from "../transactions/authenticator/account.js";
+import { HexInput, SigningScheme } from "../types/index.js";
+import { AccountAddress, AccountAddressInput } from "../core/accountAddress.js";
+import { Ed25519PrivateKey, Ed25519PublicKey, Ed25519Signature, Signature } from "../core/crypto/index.js";
+import type { Account } from "./Account.js";
+import { AnyRawTransaction } from "../transactions/types.js";
+import { AptosConfig } from "../api/aptosConfig.js";
+/**
+ * Arguments required to create an instance of an Ed25519 signer.
+ *
+ * @param privateKey - The private key used for signing.
+ * @param address - Optional account address associated with the signer.
+ * @group Implementation
+ * @category Account (On-Chain Model)
+ */
+export interface Ed25519SignerConstructorArgs {
+    privateKey: Ed25519PrivateKey;
+    address?: AccountAddressInput;
+}
+/**
+ * Arguments for creating an Ed25519 signer from a derivation path.
+ *
+ * @param path - The derivation path for the Ed25519 key.
+ * @param mnemonic - The mnemonic phrase used to generate the key.
+ * @group Implementation
+ * @category Account (On-Chain Model)
+ */
+export interface Ed25519SignerFromDerivationPathArgs {
+    path: string;
+    mnemonic: string;
+}
+/**
+ * Arguments required to verify an Ed25519 signature against a given message.
+ *
+ * @param message - The message to be verified, represented in hexadecimal format.
+ * @param signature - The Ed25519 signature to validate.
+ * @group Implementation
+ * @category Account (On-Chain Model)
+ */
+export interface VerifyEd25519SignatureArgs {
+    message: HexInput;
+    signature: Ed25519Signature;
+}
+/**
+ * Represents an Ed25519 account that provides signing capabilities through an Ed25519 private key.
+ * This class allows for the creation of accounts, signing messages and transactions, and verifying signatures.
+ *
+ * Note: Generating an instance of this class does not create the account on-chain.
+ * @group Implementation
+ * @category Account (On-Chain Model)
+ */
+export declare class Ed25519Account implements Account {
+    /**
+     * Private key associated with the account
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    readonly privateKey: Ed25519PrivateKey;
+    readonly publicKey: Ed25519PublicKey;
+    readonly accountAddress: AccountAddress;
+    readonly signingScheme = SigningScheme.Ed25519;
+    /**
+     * Creates an instance of the Ed25519Signer with the specified parameters.
+     * This constructor initializes the private key, public key, and account address for the signer.
+     *
+     * @param args - The constructor arguments for the Ed25519Signer.
+     * @param args.privateKey - The private key used for signing.
+     * @param args.address - The optional account address; if not provided, it will derive the address from the public key.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    constructor(args: Ed25519SignerConstructorArgs);
+    /**
+     * Generates a new Ed25519 account using a randomly generated private key.
+     * This function is useful for creating a signer that can be used for cryptographic operations.
+     *
+     * @returns {Ed25519Account} The newly generated Ed25519 account.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    static generate(): Ed25519Account;
+    /**
+     * Derives an Ed25519 account using a specified BIP44 path and mnemonic seed phrase.
+     *
+     * @param args - The arguments for deriving the account.
+     * @param args.path - The BIP44 derive hardened path, e.g., m/44'/637'/0'/0'/0'.
+     * Detailed description: {@link https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki}
+     * @param args.mnemonic - The mnemonic seed phrase of the account.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    static fromDerivationPath(args: Ed25519SignerFromDerivationPathArgs): Ed25519Account;
+    /**
+     * Verify the given message and signature with the public key.
+     *
+     * @param args - The arguments for verifying the signature.
+     * @param args.message - Raw message data in HexInput format.
+     * @param args.signature - Signed message signature.
+     * @returns A boolean indicating whether the signature is valid.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    verifySignature(args: VerifyEd25519SignatureArgs): boolean;
+    /**
+     * Verify the given message and signature with the public key.
+     *
+     * Ed25519 signatures do not depend on chain state, so this function is equivalent to the synchronous verifySignature method.
+     *
+     * @param args - The arguments for verifying the signature.
+     * @param args.aptosConfig - The configuration object for connecting to the Aptos network
+     * @param args.message - Raw message data in HexInput format.
+     * @param args.signature - Signed message signature.
+     * @returns A boolean indicating whether the signature is valid.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    verifySignatureAsync(args: {
+        aptosConfig: AptosConfig;
+        message: HexInput;
+        signature: Signature;
+    }): Promise<boolean>;
+    /**
+     * Sign a message using the account's Ed25519 private key.
+     * This function returns an AccountAuthenticator containing the signature along with the account's public key.
+     *
+     * @param message - The signing message, represented as hexadecimal input.
+     * @returns An AccountAuthenticator containing the signature and the account's public key.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    signWithAuthenticator(message: HexInput): AccountAuthenticatorEd25519;
+    /**
+     * Sign a transaction using the account's Ed25519 private key.
+     * This function returns an AccountAuthenticator that contains the signature of the transaction along with the account's public key.
+     *
+     * @param transaction - The raw transaction to be signed.
+     * @returns An AccountAuthenticator containing the signature and the public key.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    signTransactionWithAuthenticator(transaction: AnyRawTransaction): AccountAuthenticatorEd25519;
+    /**
+     * Sign the given message using the account's Ed25519 private key.
+     * @param message - The message to be signed in HexInput format.
+     * @returns Signature - The resulting signature of the signed message.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    sign(message: HexInput): Ed25519Signature;
+    /**
+     * Sign the given transaction using the available signing capabilities.
+     * This function helps ensure that the transaction is properly authenticated before submission.
+     *
+     * @param transaction - The transaction to be signed.
+     * @returns Signature - The resulting signature for the transaction.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    signTransaction(transaction: AnyRawTransaction): Ed25519Signature;
+}
+//# sourceMappingURL=Ed25519Account.d.ts.map

package/dist/account/Ed25519Account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ed25519Account.d.ts","sourceRoot":"","sources":["../../src/account/Ed25519Account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC3G,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,QAAQ,CAAC;IAClB,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,qBAAa,cAAe,YAAW,OAAO;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAEvC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAErC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC,QAAQ,CAAC,aAAa,yBAAyB;IAI/C;;;;;;;;;OASG;gBACS,IAAI,EAAE,4BAA4B;IAO9C;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,IAAI,cAAc;IAKjC;;;;;;;;;OASG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,mCAAmC;IAQnE;;;;;;;;;OASG;IACH,eAAe,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO;IAI1D;;;;;;;;;;;;OAYG;IACG,oBAAoB,CAAC,IAAI,EAAE;QAC/B,WAAW,EAAE,WAAW,CAAC;QACzB,OAAO,EAAE,QAAQ,CAAC;QAClB,SAAS,EAAE,SAAS,CAAC;KACtB,GAAG,OAAO,CAAC,OAAO,CAAC;IAOpB;;;;;;;;OAQG;IACH,qBAAqB,CAAC,OAAO,EAAE,QAAQ,GAAG,2BAA2B;IAIrE;;;;;;;;OAQG;IACH,gCAAgC,CAAC,WAAW,EAAE,iBAAiB,GAAG,2BAA2B;IAI7F;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,gBAAgB;IAIzC;;;;;;;;OAQG;IACH,eAAe,CAAC,WAAW,EAAE,iBAAiB,GAAG,gBAAgB;CAKlE"}

package/dist/account/Ed25519Account.js

@@ -0,0 +1,149 @@
+import { AccountAuthenticatorEd25519 } from "../transactions/authenticator/account.js";
+import { SigningScheme } from "../types/index.js";
+import { AccountAddress } from "../core/accountAddress.js";
+import { Ed25519PrivateKey } from "../core/crypto/index.js";
+import { generateSigningMessageForTransaction } from "../transactions/transactionBuilder/signingMessage.js";
+/**
+ * Represents an Ed25519 account that provides signing capabilities through an Ed25519 private key.
+ * This class allows for the creation of accounts, signing messages and transactions, and verifying signatures.
+ *
+ * Note: Generating an instance of this class does not create the account on-chain.
+ * @group Implementation
+ * @category Account (On-Chain Model)
+ */
+export class Ed25519Account {
+    /**
+     * Private key associated with the account
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    privateKey;
+    publicKey;
+    accountAddress;
+    signingScheme = SigningScheme.Ed25519;
+    // region Constructors
+    /**
+     * Creates an instance of the Ed25519Signer with the specified parameters.
+     * This constructor initializes the private key, public key, and account address for the signer.
+     *
+     * @param args - The constructor arguments for the Ed25519Signer.
+     * @param args.privateKey - The private key used for signing.
+     * @param args.address - The optional account address; if not provided, it will derive the address from the public key.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    constructor(args) {
+        const { privateKey, address } = args;
+        this.privateKey = privateKey;
+        this.publicKey = privateKey.publicKey();
+        this.accountAddress = address ? AccountAddress.from(address) : this.publicKey.authKey().derivedAddress();
+    }
+    /**
+     * Generates a new Ed25519 account using a randomly generated private key.
+     * This function is useful for creating a signer that can be used for cryptographic operations.
+     *
+     * @returns {Ed25519Account} The newly generated Ed25519 account.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    static generate() {
+        const privateKey = Ed25519PrivateKey.generate();
+        return new Ed25519Account({ privateKey });
+    }
+    /**
+     * Derives an Ed25519 account using a specified BIP44 path and mnemonic seed phrase.
+     *
+     * @param args - The arguments for deriving the account.
+     * @param args.path - The BIP44 derive hardened path, e.g., m/44'/637'/0'/0'/0'.
+     * Detailed description: {@link https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki}
+     * @param args.mnemonic - The mnemonic seed phrase of the account.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    static fromDerivationPath(args) {
+        const { path, mnemonic } = args;
+        const privateKey = Ed25519PrivateKey.fromDerivationPath(path, mnemonic);
+        return new Ed25519Account({ privateKey });
+    }
+    // endregion
+    // region Account
+    /**
+     * Verify the given message and signature with the public key.
+     *
+     * @param args - The arguments for verifying the signature.
+     * @param args.message - Raw message data in HexInput format.
+     * @param args.signature - Signed message signature.
+     * @returns A boolean indicating whether the signature is valid.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    verifySignature(args) {
+        return this.publicKey.verifySignature(args);
+    }
+    /**
+     * Verify the given message and signature with the public key.
+     *
+     * Ed25519 signatures do not depend on chain state, so this function is equivalent to the synchronous verifySignature method.
+     *
+     * @param args - The arguments for verifying the signature.
+     * @param args.aptosConfig - The configuration object for connecting to the Aptos network
+     * @param args.message - Raw message data in HexInput format.
+     * @param args.signature - Signed message signature.
+     * @returns A boolean indicating whether the signature is valid.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    async verifySignatureAsync(args) {
+        return this.publicKey.verifySignatureAsync({
+            ...args,
+            signature: args.signature,
+        });
+    }
+    /**
+     * Sign a message using the account's Ed25519 private key.
+     * This function returns an AccountAuthenticator containing the signature along with the account's public key.
+     *
+     * @param message - The signing message, represented as hexadecimal input.
+     * @returns An AccountAuthenticator containing the signature and the account's public key.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    signWithAuthenticator(message) {
+        return new AccountAuthenticatorEd25519(this.publicKey, this.privateKey.sign(message));
+    }
+    /**
+     * Sign a transaction using the account's Ed25519 private key.
+     * This function returns an AccountAuthenticator that contains the signature of the transaction along with the account's public key.
+     *
+     * @param transaction - The raw transaction to be signed.
+     * @returns An AccountAuthenticator containing the signature and the public key.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    signTransactionWithAuthenticator(transaction) {
+        return new AccountAuthenticatorEd25519(this.publicKey, this.signTransaction(transaction));
+    }
+    /**
+     * Sign the given message using the account's Ed25519 private key.
+     * @param message - The message to be signed in HexInput format.
+     * @returns Signature - The resulting signature of the signed message.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    sign(message) {
+        return this.privateKey.sign(message);
+    }
+    /**
+     * Sign the given transaction using the available signing capabilities.
+     * This function helps ensure that the transaction is properly authenticated before submission.
+     *
+     * @param transaction - The transaction to be signed.
+     * @returns Signature - The resulting signature for the transaction.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    signTransaction(transaction) {
+        return this.sign(generateSigningMessageForTransaction(transaction));
+    }
+}
+//# sourceMappingURL=Ed25519Account.js.map

package/dist/account/Ed25519Account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ed25519Account.js","sourceRoot":"","sources":["../../src/account/Ed25519Account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAY,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAuB,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAiD,MAAM,yBAAyB,CAAC;AAG3G,OAAO,EAAE,oCAAoC,EAAE,MAAM,sDAAsD,CAAC;AA0C5G;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IACzB;;;;OAIG;IACM,UAAU,CAAoB;IAE9B,SAAS,CAAmB;IAE5B,cAAc,CAAiB;IAE/B,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC;IAE/C,sBAAsB;IAEtB;;;;;;;;;OASG;IACH,YAAY,IAAkC;QAC5C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;QACxC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,CAAC;IAC3G,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ;QACb,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAyC;QACjE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,UAAU,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACxE,OAAO,IAAI,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,YAAY;IAEZ,iBAAiB;IACjB;;;;;;;;;OASG;IACH,eAAe,CAAC,IAAgC;QAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,oBAAoB,CAAC,IAI1B;QACC,OAAO,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;YACzC,GAAG,IAAI;YACP,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,qBAAqB,CAAC,OAAiB;QACrC,OAAO,IAAI,2BAA2B,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;OAQG;IACH,gCAAgC,CAAC,WAA8B;QAC7D,OAAO,IAAI,2BAA2B,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,OAAiB;QACpB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;OAQG;IACH,eAAe,CAAC,WAA8B;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,oCAAoC,CAAC,WAAW,CAAC,CAAC,CAAC;IACtE,CAAC;CAGF"}

package/dist/account/EphemeralKeyPair.d.ts

@@ -0,0 +1,159 @@
+import { EphemeralPublicKey, EphemeralSignature } from "../core/crypto/ephemeral.js";
+import { PrivateKey } from "../core/crypto/privateKey.js";
+import { EphemeralPublicKeyVariant, HexInput } from "../types/index.js";
+import { Deserializer, Serializable, Serializer } from "../bcs/index.js";
+/**
+ * Represents an ephemeral key pair used for signing transactions via the Keyless authentication scheme.
+ * This key pair is temporary and includes an expiration time.
+ * For more details on how this class is used, refer to the documentation:
+ * https://aptos.dev/guides/keyless-accounts/#1-present-the-user-with-a-sign-in-with-idp-button-on-the-ui
+ * @group Implementation
+ * @category Account (On-Chain Model)
+ */
+export declare class EphemeralKeyPair extends Serializable {
+    static readonly BLINDER_LENGTH: number;
+    /**
+     * 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.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    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.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    readonly expiryDateSecs: number;
+    /**
+     * The value passed to the IdP when the user authenticates.  It consists of a hash of the
+     * ephemeral public key, expiry date, and blinder.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    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 (not permanent) in nature.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    private privateKey;
+    /**
+     * A public key used to verify transactions.  This public key is not tied to any account on the chain as it
+     * is ephemeral (not permanent) in nature.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    private publicKey;
+    /**
+     * Whether the ephemeral key pair has been cleared from memory.
+     * @private
+     */
+    private cleared;
+    /**
+     * Creates an instance of the class with a specified private key, optional expiry date, and optional blinder.
+     * This constructor initializes the public key, sets the expiry date to a default value if not provided,
+     * generates a blinder if not supplied, and calculates the nonce based on the public key, expiry date, and blinder.
+     *
+     * @param args - The parameters for constructing the instance.
+     * @param args.privateKey - The private key used for creating the instance.
+     * @param args.expiryDateSecs - Optional expiry date in seconds from the current time. Defaults to two weeks from now.
+     * @param args.blinder - Optional blinder value. If not provided, a new blinder will be generated.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    constructor(args: {
+        privateKey: PrivateKey;
+        expiryDateSecs?: number;
+        blinder?: HexInput;
+    });
+    /**
+     * Returns the public key of the key pair.
+     * @return EphemeralPublicKey
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    getPublicKey(): EphemeralPublicKey;
+    /**
+     * Checks if the current time has surpassed the expiry date of the key pair.
+     * @return boolean - Returns true if the key pair is expired, otherwise false.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    isExpired(): boolean;
+    /**
+     * Clears the ephemeral private key from memory by overwriting it with random bytes.
+     * After calling this method, the ephemeral key pair can no longer be used for signing.
+     *
+     * Note: Due to JavaScript's memory management, this cannot guarantee complete removal of
+     * sensitive data from memory, but it significantly reduces the window of exposure.
+     *
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    clear(): void;
+    /**
+     * Returns whether the ephemeral key pair has been cleared from memory.
+     *
+     * @returns true if the key pair has been cleared, false otherwise
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    isCleared(): boolean;
+    /**
+     * Serializes the object's properties into a format suitable for transmission or storage.
+     * This function is essential for preparing the object data for serialization processes.
+     *
+     * @param serializer - The serializer instance used to serialize the object's properties.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    serialize(serializer: Serializer): void;
+    /**
+     * Deserializes an ephemeral key pair from the provided deserializer.
+     * This function helps in reconstructing an ephemeral key pair, which is essential for cryptographic operations.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    static deserialize(deserializer: Deserializer): EphemeralKeyPair;
+    /**
+     * Deserialize a byte array into an EphemeralKeyPair object.
+     * This function allows you to reconstruct an EphemeralKeyPair from its serialized byte representation.
+     *
+     * @param bytes - The byte array representing the serialized EphemeralKeyPair.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    static fromBytes(bytes: Uint8Array): EphemeralKeyPair;
+    /**
+     * Generates a new ephemeral key pair with an optional expiry date.
+     * This function allows you to create a temporary key pair for secure operations.
+     *
+     * @param args - Optional parameters for key pair generation.
+     * @param args.scheme - The type of key pair to use for the EphemeralKeyPair. Only Ed25519 is supported for now.
+     * @param args.expiryDateSecs - The date of expiry for the key pair in seconds.
+     * @returns An instance of EphemeralKeyPair containing the generated private key and expiry date.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    static generate(args?: {
+        scheme?: EphemeralPublicKeyVariant;
+        expiryDateSecs?: number;
+    }): EphemeralKeyPair;
+    /**
+     * Sign the given data using the private key, returning an ephemeral signature.
+     * This function is essential for creating a secure signature that can be used for authentication or verification purposes.
+     *
+     * @param data - The data to be signed, provided in HexInput format.
+     * @returns EphemeralSignature - The resulting ephemeral signature.
+     * @throws Error - Throws an error if the EphemeralKeyPair has expired or been cleared from memory.
+     * @group Implementation
+     * @category Account (On-Chain Model)
+     */
+    sign(data: HexInput): EphemeralSignature;
+}
+//# sourceMappingURL=EphemeralKeyPair.d.ts.map

package/dist/account/EphemeralKeyPair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EphemeralKeyPair.d.ts","sourceRoot":"","sources":["../../src/account/EphemeralKeyPair.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAErF,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,OAAO,EAAE,yBAAyB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKzE;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAM;IAE5C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,OAAO,CAAC,UAAU,CAAa;IAE/B;;;;;OAKG;IACH,OAAO,CAAC,SAAS,CAAqB;IAEtC;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAkB;IAEjC;;;;;;;;;;;OAWG;gBACS,IAAI,EAAE;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;KAAE;IAiBzF;;;;;OAKG;IACH,YAAY,IAAI,kBAAkB;IAIlC;;;;;OAKG;IACH,SAAS,IAAI,OAAO;IAKpB;;;;;;;;;OASG;IACH,KAAK,IAAI,IAAI;IAsBb;;;;;;OAMG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;;;OAOG;IACH,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAOvC;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,gBAAgB;IAehE;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB;IAIrD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,yBAAyB,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB;IAWzG;;;;;;;;;OASG;IACH,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB;CASzC"}