@aptos-labs/ts-sdk 7.3.0 → 7.4.0

package/package.json

@@ -4,7 +4,8 @@
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/aptos-labs/aptos-ts-sdk.git"
+    "url": "git+https://github.com/aptos-labs/aptos-ts-sdk.git",
+    "directory": "packages/ts-sdk"
   },
   "engines": {
     "node": ">=22.0.0"
@@ -100,37 +101,37 @@
   "dependencies": {
     "@aptos-labs/aptos-cli": "^3.0.0",
     "@aptos-labs/aptos-client": "^4.1.0",
-    "@noble/ciphers": "2.2.0",
-    "@noble/curves": "2.2.0",
-    "@noble/hashes": "2.2.0",
-    "@scure/bip32": "^2.0.1",
-    "@scure/bip39": "^2.0.1",
+    "@noble/ciphers": "2.4.0",
+    "@noble/curves": "2.4.0",
+    "@noble/hashes": "2.4.0",
+    "@scure/bip32": "^2.4.0",
+    "@scure/bip39": "^2.4.0",
     "eventemitter3": "^5.0.4",
     "jwt-decode": "^4.0.0",
     "poseidon-lite": "^0.3.0"
   },
   "devDependencies": {
-    "@babel/traverse": "^7.29.0",
-    "@biomejs/biome": "2.4.6",
-    "@cucumber/cucumber": "^12.8.1",
-    "@graphql-codegen/cli": "^6.3.0",
-    "@graphql-codegen/import-types-preset": "^4.0.0",
+    "@babel/traverse": "^7.29.8",
+    "@biomejs/biome": "2.5.12",
+    "@cucumber/cucumber": "^12.9.0",
+    "@graphql-codegen/cli": "^6.3.1",
+    "@graphql-codegen/import-types-preset": "^4.0.1",
     "@graphql-codegen/typescript": "^5.0.10",
-    "@graphql-codegen/typescript-graphql-request": "^7.0.0",
+    "@graphql-codegen/typescript-graphql-request": "^7.1.0",
     "@graphql-codegen/typescript-operations": "^5.1.0",
-    "@types/node": "^22.19.17",
-    "@vitest/coverage-v8": "^4.1.4",
-    "graphql": "^16.13.2",
+    "@types/node": "^22.20.1",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "@vitest/coverage-v8": "^4.1.11",
+    "graphql": "^16.14.2",
     "graphql-request": "^7.4.0",
     "tree-kill": "^1.2.2",
-    "typedoc": "^0.28.19",
-    "typedoc-plugin-missing-exports": "^4.1.3",
-    "@typescript/native": "npm:typescript@^7.0.2",
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-missing-exports": "^4.1.4",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "vite": "^7.3.5",
-    "vitest": "^4.1.4"
+    "vite": "^7.3.6",
+    "vitest": "^4.1.11"
   },
-  "version": "7.3.0",
+  "version": "7.4.0",
   "scripts": {
     "build:clean": "rm -rf dist",
     "build": "pnpm build:clean && tsc -p tsconfig.build.json",
@@ -147,10 +148,10 @@
     "e2e-test": "vitest run tests/e2e",
     "e2e-encrypted": "vitest run tests/e2e/transaction/encryptedTransaction.test.ts --config vitest.config.e2e-devnet.ts",
     "indexer-codegen": "graphql-codegen --config ./src/types/codegen.yaml && pnpm fmt",
-    "doc": "scripts/generateDocs.sh",
-    "check-version": "scripts/checkVersion.sh",
-    "check-license": "sh scripts/checkLicense.sh . && sh scripts/checkLicense.sh confidential-asset",
-    "update-version": "scripts/updateVersion.sh && pnpm doc",
+    "doc": "../../scripts/generateDocs.sh",
+    "check-version": "../../scripts/checkVersion.sh",
+    "check-license": "sh ../../scripts/checkLicense.sh .",
+    "update-version": "../../scripts/updateVersion.sh && pnpm doc",
     "spec": "pnpm build && pnpm _spec",
     "_spec": "cucumber-js -p default"
   }

package/src/api/account/abstraction.ts

@@ -29,19 +29,22 @@ export class AccountAbstraction {
    *
    * @param args.accountAddress - The account to add the authentication function to.
    * @param args.authenticationFunction - The authentication function info to add.
+   * @param args.withFeePayer - Whether the transaction should use a fee payer.
    * @param args.options - The options for the transaction.
    * @returns A transaction to add the authentication function to the account.
    */
   public async addAuthenticationFunctionTransaction(args: {
     accountAddress: AccountAddressInput;
     authenticationFunction: MoveFunctionId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
-    const { accountAddress, authenticationFunction, options } = args;
+    const { accountAddress, authenticationFunction, withFeePayer, options } = args;
     return addAuthenticationFunctionTransaction({
       aptosConfig: this.config,
       authenticationFunction,
       sender: accountAddress,
+      withFeePayer,
       options,
     });
   }
@@ -62,19 +65,22 @@ export class AccountAbstraction {
    *
    * @param args.accountAddress - The account to remove the authentication function from.
    * @param args.authenticationFunction - The authentication function info to remove.
+   * @param args.withFeePayer - Whether the transaction should use a fee payer.
    * @param args.options - The options for the transaction.
    * @returns A transaction to remove the authentication function from the account.
    */
   public async removeAuthenticationFunctionTransaction(args: {
     accountAddress: AccountAddressInput;
     authenticationFunction: MoveFunctionId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
-    const { accountAddress, authenticationFunction, options } = args;
+    const { accountAddress, authenticationFunction, withFeePayer, options } = args;
     return removeAuthenticationFunctionTransaction({
       aptosConfig: this.config,
       sender: accountAddress,
       authenticationFunction,
+      withFeePayer,
       options,
     });
   }
@@ -93,15 +99,22 @@ export class AccountAbstraction {
    * ```
    *
    * @param args.accountAddress - The account to remove the authenticator from.
+   * @param args.withFeePayer - Whether the transaction should use a fee payer.
    * @param args.options - The options for the transaction.
    * @returns A transaction to remove the authenticator from the account.
    */
   public async removeDispatchableAuthenticatorTransaction(args: {
     accountAddress: AccountAddressInput;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
-    const { accountAddress, options } = args;
-    return removeDispatchableAuthenticatorTransaction({ aptosConfig: this.config, sender: accountAddress, options });
+    const { accountAddress, withFeePayer, options } = args;
+    return removeDispatchableAuthenticatorTransaction({
+      aptosConfig: this.config,
+      sender: accountAddress,
+      withFeePayer,
+      options,
+    });
   }
 
   /**
@@ -196,6 +209,7 @@ export class AccountAbstraction {
    *
    * @param args.accountAddress - The account to enable account abstraction for.
    * @param args.authenticationFunction - The authentication function info to use.
+   * @param args.withFeePayer - Whether the transaction should use a fee payer.
    * @param args.options - The options for the transaction.
    * @returns A transaction to enable account abstraction for the account.
    */
@@ -218,22 +232,25 @@ export class AccountAbstraction {
    *
    * @param args.accountAddress - The account to disable account abstraction for.
    * @param args.authenticationFunction - The authentication function info to remove.
+   * @param args.withFeePayer - Whether the transaction should use a fee payer.
    * @param args.options - The options for the transaction.
    * @returns A transaction to disable account abstraction for the account.
    */
   public disableAccountAbstractionTransaction = async (args: {
     accountAddress: AccountAddressInput;
     authenticationFunction?: MoveFunctionId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) => {
-    const { accountAddress, authenticationFunction, options } = args;
+    const { accountAddress, authenticationFunction, withFeePayer, options } = args;
     if (authenticationFunction) {
       return this.removeAuthenticationFunctionTransaction({
         accountAddress,
         authenticationFunction,
+        withFeePayer,
         options,
       });
     }
-    return this.removeDispatchableAuthenticatorTransaction({ accountAddress, options });
+    return this.removeDispatchableAuthenticatorTransaction({ accountAddress, withFeePayer, options });
   };
 }

package/src/api/ans.ts

@@ -158,6 +158,7 @@ export class ANS {
    * @param args.sender - The account initiating the transaction.
    * @param args.name - A string representing the domain or subdomain name (e.g., "test.aptos").
    * @param args.address - The AccountAddressInput of the address to set the domain or subdomain to.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - Optional settings for generating the transaction.
    *
    * @returns An object containing the transaction and the InputEntryFunctionData
@@ -191,6 +192,7 @@ export class ANS {
     sender: AccountAddressInput;
     name: string;
     address: AccountAddressInput;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<{ transaction: SimpleTransaction; data: InputEntryFunctionData }> {
     return setTargetAddress({ aptosConfig: this.config, ...args });
@@ -203,6 +205,7 @@ export class ANS {
    * @param args - The arguments for clearing the target address.
    * @param args.sender - The account initiating the transaction.
    * @param args.name - A string representing the domain or subdomain name (e.g., "test.aptos").
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - Optional settings for generating the transaction.
    *
    * @returns An object containing the transaction and the InputEntryFunctionData
@@ -233,6 +236,7 @@ export class ANS {
   async clearTargetAddress(args: {
     sender: AccountAddressInput;
     name: string;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<{ transaction: SimpleTransaction; data: InputEntryFunctionData }> {
     return clearTargetAddress({ aptosConfig: this.config, ...args });
@@ -273,6 +277,7 @@ export class ANS {
    * @param args - The arguments for setting the primary name.
    * @param args.sender - The sender account.
    * @param args.name - A string representing the name to set as primary (e.g., "test.aptos").
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - Optional transaction options.
    *
    * @returns An object containing the transaction and the InputEntryFunctionData
@@ -299,6 +304,7 @@ export class ANS {
   async setPrimaryName(args: {
     sender: AccountAddressInput;
     name?: string;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<{ transaction: SimpleTransaction; data: InputEntryFunctionData }> {
     return setPrimaryName({ aptosConfig: this.config, ...args });
@@ -324,6 +330,7 @@ export class ANS {
    * be used.
    * @param args.toAddress optional - The address to send the domain name to. If not provided, the transaction will be sent to the
    * router.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    *
    * @returns An object containing the transaction and the InputEntryFunctionData
    *
@@ -365,6 +372,7 @@ export class ANS {
    * @param args.sender - The sender account, which must be the domain owner.
    * @param args.name - A string representing the domain to renew. Subdomains cannot be renewed.
    * @param args.years - The number of years to renew the name. Currently, only one year is permitted.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - Optional transaction options.
    *
    * @returns An object containing the transaction and the InputEntryFunctionData
@@ -393,6 +401,7 @@ export class ANS {
     sender: AccountAddressInput;
     name: string;
     years?: 1;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<{ transaction: SimpleTransaction; data: InputEntryFunctionData }> {
     return renewDomain({ aptosConfig: this.config, ...args });

package/src/api/coin.ts

@@ -46,6 +46,7 @@ export class Coin {
    * @param args.recipient The recipient account address.
    * @param args.amount The amount of coins to transfer.
    * @param args.coinType Optional. The coin struct type to transfer. Defaults to 0x1::aptos_coin::AptosCoin.
+   * @param args.withFeePayer Whether to build a fee-payer transaction.
    * @param args.options Optional. Additional options for generating the transaction.
    *
    * @returns SimpleTransaction
@@ -76,6 +77,7 @@ export class Coin {
     recipient: AccountAddressInput;
     amount: AnyNumber;
     coinType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<SimpleTransaction> {
     return transferCoinTransaction({ aptosConfig: this.config, ...args });

package/src/api/digitalAsset.ts

@@ -490,6 +490,7 @@ export class DigitalAsset {
    * @param args.description - The description of the collection.
    * @param args.name - The name of the collection.
    * @param args.uri - The URI to additional info about the collection.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - Optional parameters for generating the transaction.
    *
    * The parameters below are optional:
@@ -538,6 +539,7 @@ export class DigitalAsset {
       description: string;
       name: string;
       uri: string;
+      withFeePayer?: boolean;
       options?: InputGenerateTransactionOptions;
     } & CreateCollectionOptions,
   ): Promise<SimpleTransaction> {
@@ -556,6 +558,7 @@ export class DigitalAsset {
    * @param args.propertyKeys - Optional array of property keys for the digital asset.
    * @param args.propertyTypes - Optional array of property types for the digital asset.
    * @param args.propertyValues - Optional array of property values for the digital asset.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - Optional transaction generation options.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -592,6 +595,7 @@ export class DigitalAsset {
     propertyKeys?: Array<string>;
     propertyTypes?: Array<PropertyType>;
     propertyValues?: Array<PropertyValue>;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<SimpleTransaction> {
     return mintDigitalAssetTransaction({ aptosConfig: this.config, ...args });
@@ -606,6 +610,7 @@ export class DigitalAsset {
    * @param args.digitalAssetAddress The address of the digital asset being transferred.
    * @param args.recipient The account address of the recipient.
    * @param args.digitalAssetType Optional. The type of the digital asset, defaults to "0x4::token::Token".
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options Optional. Additional options for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -636,6 +641,7 @@ export class DigitalAsset {
     digitalAssetAddress: AccountAddressInput;
     recipient: AccountAddress;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<SimpleTransaction> {
     return transferDigitalAssetTransaction({ aptosConfig: this.config, ...args });
@@ -655,6 +661,7 @@ export class DigitalAsset {
    * @param args.propertyKeys - The property keys for storing on-chain properties.
    * @param args.propertyTypes - The type of property values.
    * @param args.propertyValues - The property values to be stored on-chain.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - Additional options for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -693,6 +700,7 @@ export class DigitalAsset {
     propertyKeys?: Array<string>;
     propertyTypes?: Array<PropertyType>;
     propertyValues?: Array<PropertyValue>;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<SimpleTransaction> {
     return mintSoulBoundTransaction({ aptosConfig: this.config, ...args });
@@ -705,6 +713,7 @@ export class DigitalAsset {
    * @param args.creator The creator account that is burning the digital asset.
    * @param args.digitalAssetAddress The address of the digital asset to be burned.
    * @param args.digitalAssetType Optional. The type of the digital asset being burned.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options Optional. Additional options for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -733,6 +742,7 @@ export class DigitalAsset {
     creator: Account;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return burnDigitalAssetTransaction({ aptosConfig: this.config, ...args });
@@ -746,6 +756,7 @@ export class DigitalAsset {
    * @param args.creator The creator account initiating the freeze.
    * @param args.digitalAssetAddress The address of the digital asset to be frozen.
    * @param args.digitalAssetType Optional. The type of the digital asset being frozen.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options Optional. Additional options for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -774,6 +785,7 @@ export class DigitalAsset {
     creator: Account;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return freezeDigitalAssetTransferTransaction({ aptosConfig: this.config, ...args });
@@ -787,6 +799,7 @@ export class DigitalAsset {
    * @param args.creator The creator account that is unfreezing the digital asset transfer.
    * @param args.digitalAssetAddress The address of the digital asset to unfreeze.
    * @param args.digitalAssetType Optional. The type of the digital asset being unfrozen.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options Optional. Additional options for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -816,6 +829,7 @@ export class DigitalAsset {
     creator: Account;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return unfreezeDigitalAssetTransferTransaction({ aptosConfig: this.config, ...args });
@@ -829,6 +843,7 @@ export class DigitalAsset {
    * @param args.description The digital asset description to be set.
    * @param args.digitalAssetAddress The address of the digital asset.
    * @param args.digitalAssetType Optional. The type of the digital asset.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options Optional. Additional options for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -859,6 +874,7 @@ export class DigitalAsset {
     description: string;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return setDigitalAssetDescriptionTransaction({ aptosConfig: this.config, ...args });
@@ -872,6 +888,7 @@ export class DigitalAsset {
    * @param args.name The desired name for the digital asset.
    * @param args.digitalAssetAddress The address of the digital asset.
    * @param args.digitalAssetType Optional. The type of the digital asset, represented as a Move struct ID.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options Optional. Additional options for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the blockchain.
@@ -905,6 +922,7 @@ export class DigitalAsset {
     name: string;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return setDigitalAssetNameTransaction({ aptosConfig: this.config, ...args });
@@ -918,6 +936,7 @@ export class DigitalAsset {
    * @param args.uri The digital asset URI to be set.
    * @param args.digitalAssetAddress The address of the digital asset.
    * @param args.digitalAssetType Optional. The type of the digital asset.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options Optional. Additional options for generating the transaction.
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
    *
@@ -947,6 +966,7 @@ export class DigitalAsset {
     uri: string;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return setDigitalAssetURITransaction({ aptosConfig: this.config, ...args });
@@ -963,6 +983,7 @@ export class DigitalAsset {
    * @param args.propertyValue - The property value to be stored on-chain.
    * @param args.digitalAssetAddress - The digital asset address.
    * @param args.digitalAssetType - (Optional) The type of the digital asset.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - (Optional) Options for generating the transaction.
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
    *
@@ -996,6 +1017,7 @@ export class DigitalAsset {
     propertyValue: PropertyValue;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return addDigitalAssetPropertyTransaction({ aptosConfig: this.config, ...args });
@@ -1012,6 +1034,7 @@ export class DigitalAsset {
    * @param args.propertyValue The property value to be stored on-chain.
    * @param args.digitalAssetAddress The digital asset address.
    * @param args.digitalAssetType Optional. The type of the digital asset.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options Optional. Additional options for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -1046,6 +1069,7 @@ export class DigitalAsset {
     propertyValue: PropertyValue;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return removeDigitalAssetPropertyTransaction({ aptosConfig: this.config, ...args });
@@ -1061,6 +1085,7 @@ export class DigitalAsset {
    * @param args.propertyType The type of property value.
    * @param args.propertyValue The property value to be stored on-chain.
    * @param args.digitalAssetType Optional. The type of the digital asset.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options Optional. Additional options for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -1095,6 +1120,7 @@ export class DigitalAsset {
     propertyValue: PropertyValue;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return updateDigitalAssetPropertyTransaction({ aptosConfig: this.config, ...args });
@@ -1112,6 +1138,7 @@ export class DigitalAsset {
    * @param args.propertyValue - The property value to be stored on-chain.
    * @param args.digitalAssetAddress - The digital asset address.
    * @param args.digitalAssetType - The optional type of the digital asset.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - Optional transaction generation options.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -1146,6 +1173,7 @@ export class DigitalAsset {
     propertyValue: PropertyValue;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return addDigitalAssetTypedPropertyTransaction({ aptosConfig: this.config, ...args });
@@ -1162,6 +1190,7 @@ export class DigitalAsset {
    * @param args.propertyValue - The property value to be stored on-chain.
    * @param args.digitalAssetAddress - The digital asset address.
    * @param args.digitalAssetType - (Optional) The type of the digital asset.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - (Optional) Additional options for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -1196,6 +1225,7 @@ export class DigitalAsset {
     propertyValue: PropertyValue;
     digitalAssetAddress: AccountAddressInput;
     digitalAssetType?: MoveStructId;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }) {
     return updateDigitalAssetTypedPropertyTransaction({ aptosConfig: this.config, ...args });

package/src/api/fungibleAsset.ts

@@ -281,6 +281,7 @@ export class FungibleAsset {
    * this would be the USDT address.
    * @param args.recipient - The recipient account address.
    * @param args.amount - The number of assets to transfer.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - Optional parameters for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -312,6 +313,7 @@ export class FungibleAsset {
     fungibleAssetMetadataAddress: AccountAddressInput;
     recipient: AccountAddressInput;
     amount: AnyNumber;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<SimpleTransaction> {
     return transferFungibleAsset({ aptosConfig: this.config, ...args });
@@ -326,6 +328,7 @@ export class FungibleAsset {
    * @param args.fromStore - The fungible store address initiating the transfer.
    * @param args.toStore - The fungible store address receiving the asset.
    * @param args.amount - The number of assets to transfer. Must be a positive number.
+   * @param args.withFeePayer - Whether to build a fee-payer transaction.
    * @param args.options - Optional parameters for generating the transaction.
    *
    * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -364,6 +367,7 @@ export class FungibleAsset {
     fromStore: AccountAddressInput;
     toStore: AccountAddressInput;
     amount: AnyNumber;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<SimpleTransaction> {
     return transferFungibleAssetBetweenStores({ aptosConfig: this.config, ...args });

package/src/api/keyless.ts

@@ -6,11 +6,12 @@ import { EphemeralKeyPair } from "../account/EphemeralKeyPair.js";
 import { KeylessAccount } from "../account/KeylessAccount.js";
 import { ProofFetchCallback } from "../account/AbstractKeylessAccount.js";
 import { FederatedKeylessAccount } from "../account/FederatedKeylessAccount.js";
-import { AccountAddressInput } from "../core/accountAddress.js";
+import { AccountAddress, AccountAddressInput } from "../core/accountAddress.js";
 import { ZeroKnowledgeSig } from "../core/crypto/keyless.js";
 import {
   deriveKeylessAccount,
   getPepper,
+  getPepperAndAddress,
   getPepperBase,
   getProof,
   updateFederatedKeylessJwkSetTransaction,
@@ -94,6 +95,40 @@ export class Keyless {
     return getPepper({ aptosConfig: this.config, ...args });
   }
 
+  /**
+   * Fetches pepper bytes and the initial Keyless account address from public
+   * ephemeral key components.
+   *
+   * `ephemeralPublicKey` must contain the BCS-serialized ephemeral public key.
+   * The returned address is the initial address derived by the pepper service
+   * and does not reflect later authentication-key rotation.
+   *
+   * This lookup validates the JWT-to-EPK association but does not prove
+   * possession of the corresponding ephemeral private key. An off-chain
+   * authentication flow must additionally verify the client's signature over a
+   * fresh, replay-protected challenge.
+   *
+   * @param args - Public ephemeral key data committed into the JWT nonce.
+   * @param args.jwt - JWT issued for the Keyless session.
+   * @param args.ephemeralPublicKey - BCS-serialized ephemeral public key.
+   * @param args.expiryDateSecs - EPK expiration as a Unix timestamp in seconds.
+   * @param args.blinder - Blinder committed with the EPK and expiration.
+   * @param args.uidKey - JWT claim containing the user ID. Defaults to `"sub"`.
+   * @param args.derivationPath - Optional SLIP-0010 derivation path.
+   * @returns Pepper bytes and the initial Keyless account address.
+   * @group Keyless
+   */
+  async getPepperAndAddress(args: {
+    jwt: string;
+    ephemeralPublicKey: HexInput;
+    expiryDateSecs: number;
+    blinder: HexInput;
+    uidKey?: string;
+    derivationPath?: string;
+  }): Promise<{ pepper: Uint8Array; address: AccountAddress }> {
+    return getPepperAndAddress({ aptosConfig: this.config, ...args });
+  }
+
   /**
    * Fetches the `pepper_base` from the Aptos pepper service API.
    *
@@ -245,6 +280,8 @@ export class Keyless {
    * @param args.sender The account that will install the JWKs
    * @param args.iss the iss claim of the federated OIDC provider.
    * @param args.jwksUrl the URL to find the corresponding JWKs. For supported IDP providers this parameter in not necessary.
+   * @param args.withFeePayer Whether to build a sponsored transaction.
+   * @param args.options Optional settings for generating the transaction.
    *
    * @returns The pending transaction that results from submission.
    * @group Keyless
@@ -253,6 +290,7 @@ export class Keyless {
     sender: Account;
     iss: string;
     jwksUrl?: string;
+    withFeePayer?: boolean;
     options?: InputGenerateTransactionOptions;
   }): Promise<SimpleTransaction> {
     return updateFederatedKeylessJwkSetTransaction({ aptosConfig: this.config, ...args });