@aptos-labs/ts-sdk 2.0.1 → 3.1.0

package/dist/esm/types/types.mjs

@@ -1,2 +1,2 @@
-import{A,B,C,D,E,F,G,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-ODAAZLPK.mjs";import"../chunk-KDMSOCZY.mjs";export{g as AccountAuthenticatorVariant,i as AnyPublicKeyVariant,j as AnySignatureVariant,G as DeriveScheme,m as EphemeralCertificateVariant,k as EphemeralPublicKeyVariant,l as EphemeralSignatureVariant,a as MimeType,C as MoveAbility,B as MoveFunctionVisibility,h as PrivateKeyVariants,D as RoleType,c as ScriptTransactionArgumentVariants,E as SigningScheme,F as SigningSchemeInput,f as TransactionAuthenticatorVariant,d as TransactionPayloadVariants,o as TransactionResponseType,e as TransactionVariants,b as TypeTagVariants,n as ZkpVariant,v as isBlockEpilogueTransactionResponse,s as isBlockMetadataTransactionResponse,w as isEd25519Signature,z as isFeePayerSignature,r as isGenesisTransactionResponse,y as isMultiAgentSignature,A as isMultiEd25519Signature,p as isPendingTransactionResponse,x as isSecp256k1Signature,t as isStateCheckpointTransactionResponse,q as isUserTransactionResponse,u as isValidatorTransactionResponse};
+import{A,B,C,D,E,F,G,H,I,J,K,L,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-IJE2LVZG.mjs";import"../chunk-KDMSOCZY.mjs";export{j as AccountAuthenticatorVariant,l as AnyPublicKeyVariant,n as AnySignatureVariant,L as DeriveScheme,q as EphemeralCertificateVariant,o as EphemeralPublicKeyVariant,p as EphemeralSignatureVariant,a as MimeType,H as MoveAbility,G as MoveFunctionVisibility,k as PrivateKeyVariants,I as RoleType,c as ScriptTransactionArgumentVariants,J as SigningScheme,K as SigningSchemeInput,i as TransactionAuthenticatorVariant,f as TransactionExecutableVariants,g as TransactionExtraConfigVariants,e as TransactionInnerPayloadVariants,d as TransactionPayloadVariants,s as TransactionResponseType,h as TransactionVariants,b as TypeTagVariants,r as ZkpVariant,m as anyPublicKeyVariantToString,z as isBlockEpilogueTransactionResponse,w as isBlockMetadataTransactionResponse,A as isEd25519Signature,D as isFeePayerSignature,v as isGenesisTransactionResponse,C as isMultiAgentSignature,E as isMultiEd25519Signature,t as isPendingTransactionResponse,B as isSecp256k1Signature,F as isSingleSenderSignature,x as isStateCheckpointTransactionResponse,u as isUserTransactionResponse,y as isValidatorTransactionResponse};
 //# sourceMappingURL=types.mjs.map

package/dist/esm/utils/const.d.mts

@@ -69,6 +69,7 @@ declare const RAW_TRANSACTION_WITH_DATA_SALT = "APTOS::RawTransactionWithData";
  * @category Utils
  */
 declare enum ProcessorType {
+    ACCOUNT_RESTORATION_PROCESSOR = "account_restoration_processor",
     ACCOUNT_TRANSACTION_PROCESSOR = "account_transactions_processor",
     DEFAULT = "default_processor",
     EVENTS_PROCESSOR = "events_processor",

package/dist/esm/utils/const.mjs

@@ -1,2 +1,2 @@
-import{a,b,c,d,e,f,g,h,i,j}from"../chunk-RJ7F4JDV.mjs";import"../chunk-KDMSOCZY.mjs";export{e as APTOS_COIN,f as APTOS_FA,a as AptosApiType,b as DEFAULT_MAX_GAS_AMOUNT,c as DEFAULT_TXN_EXP_SEC_FROM_NOW,d as DEFAULT_TXN_TIMEOUT_SEC,j as FIREBASE_AUTH_ISS_PATTERN,i as ProcessorType,g as RAW_TRANSACTION_SALT,h as RAW_TRANSACTION_WITH_DATA_SALT};
+import{a,b,c,d,e,f,g,h,i,j}from"../chunk-JCFTAG5Z.mjs";import"../chunk-KDMSOCZY.mjs";export{e as APTOS_COIN,f as APTOS_FA,a as AptosApiType,b as DEFAULT_MAX_GAS_AMOUNT,c as DEFAULT_TXN_EXP_SEC_FROM_NOW,d as DEFAULT_TXN_TIMEOUT_SEC,j as FIREBASE_AUTH_ISS_PATTERN,i as ProcessorType,g as RAW_TRANSACTION_SALT,h as RAW_TRANSACTION_WITH_DATA_SALT};
 //# sourceMappingURL=const.mjs.map

package/dist/esm/utils/helpers.d.mts

@@ -1,14 +1,10 @@
-import { MoveStructId, MoveFunctionId } from '../types/types.mjs';
-import { AccountAddress } from '../core/accountAddress.mjs';
+import { d7 as MoveStructId, d8 as MoveFunctionId, n as AccountAddress } from '../account--Q9z_xMN.mjs';
 import '../types/indexer.mjs';
 import '../types/generated/operations.mjs';
 import '../types/generated/types.mjs';
 import './apiEndpoints.mjs';
-import '../bcs/serializer.mjs';
-import '../core/hex.mjs';
+import './const.mjs';
 import '../core/common.mjs';
-import '../bcs/deserializer.mjs';
-import '../transactions/instances/transactionArgument.mjs';
 
 /**
  * Sleep for the specified amount of time in milliseconds.

package/dist/esm/utils/helpers.mjs

@@ -1,2 +1,2 @@
-import{a,b,c,d,e,f,g,h,i,j,k,l,m,n}from"../chunk-7DQDJ2SA.mjs";import"../chunk-HNBVYE3N.mjs";import"../chunk-RGKRCZ36.mjs";import"../chunk-FD6FGKYY.mjs";import"../chunk-ODAAZLPK.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-EBMEXURY.mjs";import"../chunk-STY74NUA.mjs";import"../chunk-IF4UU2MT.mjs";import"../chunk-56CNRT2K.mjs";import"../chunk-KDMSOCZY.mjs";export{e as base64UrlDecode,f as base64UrlToBytes,g as convertAmountFromHumanReadableToOnChain,h as convertAmountFromOnChainToHumanReadable,d as floorToWholeHour,b as getErrorMessage,k as getFunctionParts,j as isEncodedStruct,l as isValidFunctionInfo,c as nowInSeconds,n as pairedFaMetadataAddress,i as parseEncodedStruct,a as sleep,m as truncateAddress};
+import{a,b,c,d,e,f,g,h,i,j,k,l,m,n}from"../chunk-7DQDJ2SA.mjs";import"../chunk-HNBVYE3N.mjs";import"../chunk-RGKRCZ36.mjs";import"../chunk-FD6FGKYY.mjs";import"../chunk-IJE2LVZG.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-EBMEXURY.mjs";import"../chunk-STY74NUA.mjs";import"../chunk-IF4UU2MT.mjs";import"../chunk-56CNRT2K.mjs";import"../chunk-KDMSOCZY.mjs";export{e as base64UrlDecode,f as base64UrlToBytes,g as convertAmountFromHumanReadableToOnChain,h as convertAmountFromOnChainToHumanReadable,d as floorToWholeHour,b as getErrorMessage,k as getFunctionParts,j as isEncodedStruct,l as isValidFunctionInfo,c as nowInSeconds,n as pairedFaMetadataAddress,i as parseEncodedStruct,a as sleep,m as truncateAddress};
 //# sourceMappingURL=helpers.mjs.map

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

@@ -2,13 +2,8 @@ export { Network, NetworkToChainId, NetworkToFaucetAPI, NetworkToIndexerAPI, Net
 export { APTOS_COIN, APTOS_FA, AptosApiType, DEFAULT_MAX_GAS_AMOUNT, DEFAULT_TXN_EXP_SEC_FROM_NOW, DEFAULT_TXN_TIMEOUT_SEC, FIREBASE_AUTH_ISS_PATTERN, ProcessorType, RAW_TRANSACTION_SALT, RAW_TRANSACTION_WITH_DATA_SALT } from './const.mjs';
 export { DeserializableClass, normalizeBundle } from './normalizeBundle.mjs';
 export { base64UrlDecode, base64UrlToBytes, convertAmountFromHumanReadableToOnChain, convertAmountFromOnChainToHumanReadable, floorToWholeHour, getErrorMessage, getFunctionParts, isEncodedStruct, isValidFunctionInfo, nowInSeconds, pairedFaMetadataAddress, parseEncodedStruct, sleep, truncateAddress } from './helpers.mjs';
-import '../bcs/deserializer.mjs';
-import '../types/types.mjs';
+import '../account--Q9z_xMN.mjs';
 import '../types/indexer.mjs';
 import '../types/generated/operations.mjs';
 import '../types/generated/types.mjs';
-import '../bcs/serializer.mjs';
-import '../core/hex.mjs';
 import '../core/common.mjs';
-import '../core/accountAddress.mjs';
-import '../transactions/instances/transactionArgument.mjs';

package/dist/esm/utils/index.mjs

@@ -1,2 +1,2 @@
-import"../chunk-HGLO5LDS.mjs";import{a as s}from"../chunk-CW35YAMN.mjs";import{a,b,c,d,e,f,g,h}from"../chunk-4RXKALLC.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,i as q,j as r}from"../chunk-RJ7F4JDV.mjs";import"../chunk-FZY4PMEE.mjs";import"../chunk-Q4W3WJ2U.mjs";import"../chunk-ORMOQWWH.mjs";import"../chunk-TOBQ5UE6.mjs";import"../chunk-MT2RJ7H3.mjs";import"../chunk-FLZPUYXQ.mjs";import{a as t,b as u,c as v,d as w,e as x,f as y,g as z,h as A,i as B,j as C,k as D,l as E,m as F,n as G}from"../chunk-7DQDJ2SA.mjs";import"../chunk-HNBVYE3N.mjs";import"../chunk-RGKRCZ36.mjs";import"../chunk-FD6FGKYY.mjs";import"../chunk-ODAAZLPK.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-EBMEXURY.mjs";import"../chunk-STY74NUA.mjs";import"../chunk-IF4UU2MT.mjs";import"../chunk-56CNRT2K.mjs";import"../chunk-KDMSOCZY.mjs";export{m as APTOS_COIN,n as APTOS_FA,i as AptosApiType,j as DEFAULT_MAX_GAS_AMOUNT,k as DEFAULT_TXN_EXP_SEC_FROM_NOW,l as DEFAULT_TXN_TIMEOUT_SEC,r as FIREBASE_AUTH_ISS_PATTERN,f as Network,g as NetworkToChainId,c as NetworkToFaucetAPI,a as NetworkToIndexerAPI,h as NetworkToNetworkName,b as NetworkToNodeAPI,d as NetworkToPepperAPI,e as NetworkToProverAPI,q as ProcessorType,o as RAW_TRANSACTION_SALT,p as RAW_TRANSACTION_WITH_DATA_SALT,x as base64UrlDecode,y as base64UrlToBytes,z as convertAmountFromHumanReadableToOnChain,A as convertAmountFromOnChainToHumanReadable,w as floorToWholeHour,u as getErrorMessage,D as getFunctionParts,C as isEncodedStruct,E as isValidFunctionInfo,s as normalizeBundle,v as nowInSeconds,G as pairedFaMetadataAddress,B as parseEncodedStruct,t as sleep,F as truncateAddress};
+import"../chunk-HGLO5LDS.mjs";import{a as s}from"../chunk-CW35YAMN.mjs";import{a as t,b as u,c as v,d as w,e as x,f as y,g as z,h as A,i as B,j as C,k as D,l as E,m as F,n as G}from"../chunk-7DQDJ2SA.mjs";import"../chunk-HNBVYE3N.mjs";import"../chunk-RGKRCZ36.mjs";import"../chunk-FZY4PMEE.mjs";import"../chunk-2BOHKN33.mjs";import"../chunk-ORMOQWWH.mjs";import"../chunk-TOBQ5UE6.mjs";import"../chunk-MT2RJ7H3.mjs";import"../chunk-FD6FGKYY.mjs";import"../chunk-IJE2LVZG.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-EBMEXURY.mjs";import"../chunk-FLZPUYXQ.mjs";import"../chunk-STY74NUA.mjs";import"../chunk-IF4UU2MT.mjs";import"../chunk-56CNRT2K.mjs";import{a,b,c,d,e,f,g,h}from"../chunk-4RXKALLC.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,i as q,j as r}from"../chunk-JCFTAG5Z.mjs";import"../chunk-KDMSOCZY.mjs";export{m as APTOS_COIN,n as APTOS_FA,i as AptosApiType,j as DEFAULT_MAX_GAS_AMOUNT,k as DEFAULT_TXN_EXP_SEC_FROM_NOW,l as DEFAULT_TXN_TIMEOUT_SEC,r as FIREBASE_AUTH_ISS_PATTERN,f as Network,g as NetworkToChainId,c as NetworkToFaucetAPI,a as NetworkToIndexerAPI,h as NetworkToNetworkName,b as NetworkToNodeAPI,d as NetworkToPepperAPI,e as NetworkToProverAPI,q as ProcessorType,o as RAW_TRANSACTION_SALT,p as RAW_TRANSACTION_WITH_DATA_SALT,x as base64UrlDecode,y as base64UrlToBytes,z as convertAmountFromHumanReadableToOnChain,A as convertAmountFromOnChainToHumanReadable,w as floorToWholeHour,u as getErrorMessage,D as getFunctionParts,C as isEncodedStruct,E as isValidFunctionInfo,s as normalizeBundle,v as nowInSeconds,G as pairedFaMetadataAddress,B as parseEncodedStruct,t as sleep,F as truncateAddress};
 //# sourceMappingURL=index.mjs.map

package/dist/esm/utils/normalizeBundle.d.mts

@@ -1,11 +1,9 @@
-import { Deserializer } from '../bcs/deserializer.mjs';
-import { Serializable } from '../bcs/serializer.mjs';
-import '../types/types.mjs';
+import { S as Serializable, a as Deserializer } from '../account--Q9z_xMN.mjs';
 import '../types/indexer.mjs';
 import '../types/generated/operations.mjs';
 import '../types/generated/types.mjs';
 import './apiEndpoints.mjs';
-import '../core/hex.mjs';
+import './const.mjs';
 import '../core/common.mjs';
 
 /**

package/dist/esm/utils/normalizeBundle.mjs

@@ -1,2 +1,2 @@
-import{a}from"../chunk-CW35YAMN.mjs";import"../chunk-FZY4PMEE.mjs";import"../chunk-Q4W3WJ2U.mjs";import"../chunk-ORMOQWWH.mjs";import"../chunk-TOBQ5UE6.mjs";import"../chunk-MT2RJ7H3.mjs";import"../chunk-FLZPUYXQ.mjs";import"../chunk-FD6FGKYY.mjs";import"../chunk-ODAAZLPK.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-EBMEXURY.mjs";import"../chunk-STY74NUA.mjs";import"../chunk-IF4UU2MT.mjs";import"../chunk-56CNRT2K.mjs";import"../chunk-KDMSOCZY.mjs";export{a as normalizeBundle};
+import{a}from"../chunk-CW35YAMN.mjs";import"../chunk-FZY4PMEE.mjs";import"../chunk-2BOHKN33.mjs";import"../chunk-ORMOQWWH.mjs";import"../chunk-TOBQ5UE6.mjs";import"../chunk-MT2RJ7H3.mjs";import"../chunk-FD6FGKYY.mjs";import"../chunk-IJE2LVZG.mjs";import"../chunk-4WPQQPUF.mjs";import"../chunk-EBMEXURY.mjs";import"../chunk-FLZPUYXQ.mjs";import"../chunk-STY74NUA.mjs";import"../chunk-IF4UU2MT.mjs";import"../chunk-56CNRT2K.mjs";import"../chunk-KDMSOCZY.mjs";export{a as 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 = "2.0.1";
+declare const VERSION = "3.1.0";
 
 export { VERSION };

package/dist/esm/version.mjs

@@ -1,2 +1,2 @@
-import{a}from"./chunk-VEGW6HP5.mjs";import"./chunk-KDMSOCZY.mjs";export{a as VERSION};
+import{a}from"./chunk-HUWKPKPQ.mjs";import"./chunk-KDMSOCZY.mjs";export{a as VERSION};
 //# sourceMappingURL=version.mjs.map

package/package.json

@@ -97,5 +97,5 @@
     "typedoc-plugin-missing-exports": "^4.0.0",
     "typescript": "^5.8.2"
   },
-  "version": "2.0.1"
+  "version": "3.1.0"
 }

package/src/account/FederatedKeylessAccount.ts

@@ -140,6 +140,7 @@ export class FederatedKeylessAccount extends AbstractKeylessAccount {
     uidKey?: string;
     proofFetchCallback?: ProofFetchCallback;
     verificationKey?: Groth16VerificationKey;
+    verificationKeyHash?: Uint8Array;
   }): FederatedKeylessAccount {
     const {
       address,
@@ -151,8 +152,13 @@ export class FederatedKeylessAccount extends AbstractKeylessAccount {
       uidKey = "sub",
       proofFetchCallback,
       verificationKey,
+      verificationKeyHash,
     } = args;
 
+    if (verificationKeyHash && verificationKey) {
+      throw new Error("Cannot provide both verificationKey and verificationKeyHash");
+    }
+
     const { iss, aud, uidVal } = getIssAudAndUidVal({ jwt, uidKey });
     return new FederatedKeylessAccount({
       address,
@@ -166,7 +172,7 @@ export class FederatedKeylessAccount extends AbstractKeylessAccount {
       jwkAddress: AccountAddress.from(jwkAddress),
       jwt,
       proofFetchCallback,
-      verificationKeyHash: verificationKey ? verificationKey.hash() : undefined,
+      verificationKeyHash: verificationKeyHash ?? (verificationKey ? verificationKey.hash() : undefined),
     });
   }
 }

package/src/account/KeylessAccount.ts

@@ -143,8 +143,23 @@ export class KeylessAccount extends AbstractKeylessAccount {
     uidKey?: string;
     proofFetchCallback?: ProofFetchCallback;
     verificationKey?: Groth16VerificationKey;
+    verificationKeyHash?: Uint8Array;
   }): KeylessAccount {
-    const { address, proof, jwt, ephemeralKeyPair, pepper, uidKey = "sub", proofFetchCallback, verificationKey } = args;
+    const {
+      address,
+      proof,
+      jwt,
+      ephemeralKeyPair,
+      pepper,
+      uidKey = "sub",
+      proofFetchCallback,
+      verificationKey,
+      verificationKeyHash,
+    } = args;
+
+    if (verificationKeyHash && verificationKey) {
+      throw new Error("Cannot provide both verificationKey and verificationKeyHash");
+    }
 
     const { iss, aud, uidVal } = getIssAudAndUidVal({ jwt, uidKey });
     return new KeylessAccount({
@@ -158,7 +173,7 @@ export class KeylessAccount extends AbstractKeylessAccount {
       pepper,
       jwt,
       proofFetchCallback,
-      verificationKeyHash: verificationKey ? verificationKey.hash() : undefined,
+      verificationKeyHash: verificationKeyHash ?? (verificationKey ? verificationKey.hash() : undefined),
     });
   }
 }

package/src/api/account.ts

@@ -2,7 +2,13 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import { Account as AccountModule } from "../account";
-import { AccountAddress, PrivateKey, AccountAddressInput, createObjectAddress } from "../core";
+import {
+  AccountAddress,
+  AccountAddressInput,
+  createObjectAddress,
+  BaseAccountPublicKey,
+  PrivateKeyInput,
+} from "../core";
 import {
   AccountData,
   AnyNumber,
@@ -31,6 +37,7 @@ import {
   getAccountOwnedObjects,
   getAccountOwnedTokens,
   getAccountOwnedTokensFromCollectionAddress,
+  getAccountsForPublicKey,
   getAccountTokensCount,
   getAccountTransactionsCount,
   getInfo,
@@ -42,6 +49,8 @@ import {
   getResourcesPage,
   getTransactions,
   lookupOriginalAccountAddress,
+  deriveOwnedAccountsFromSigner,
+  AccountInfo,
 } from "../internal/account";
 import { APTOS_COIN, APTOS_FA, ProcessorType } from "../utils/const";
 import { AptosConfig } from "./aptosConfig";
@@ -977,7 +986,131 @@ export class Account {
    * @group Account
    * @deprecated Note that more inspection is needed by the user to determine which account exists on-chain
    */
-  async deriveAccountFromPrivateKey(args: { privateKey: PrivateKey }): Promise<AccountModule> {
+  async deriveAccountFromPrivateKey(args: {
+    privateKey: PrivateKeyInput;
+    minimumLedgerVersion?: AnyNumber;
+    options?: {
+      throwIfNoAccountFound?: boolean;
+    };
+  }): Promise<AccountModule> {
+    await waitForIndexerOnVersion({
+      config: this.config,
+      minimumLedgerVersion: args.minimumLedgerVersion,
+      processorType: ProcessorType.ACCOUNT_RESTORATION_PROCESSOR,
+    });
+    await waitForIndexerOnVersion({
+      config: this.config,
+      minimumLedgerVersion: args.minimumLedgerVersion,
+      processorType: ProcessorType.OBJECT_PROCESSOR,
+    });
     return deriveAccountFromPrivateKey({ aptosConfig: this.config, ...args });
   }
+
+  /**
+   * Derives all accounts owned by a signer. This function takes a signer (either an Account or PrivateKey)
+   * and returns all accounts that can be derived from it, ordered by the most recently used account first.
+   *
+   * Note, this function will not return accounts that require more than one signer to be used.
+   *
+   * @param args - The arguments for deriving owned accounts
+   * @param args.signer - The signer to derive accounts from (Account or PrivateKey)
+   * @param args.minimumLedgerVersion - The minimum ledger version to wait for before querying
+   * @param args.options.includeUnverified - Whether to include unverified accounts in the results. Unverified accounts
+   * are accounts that can be authenticated with the signer, but there is no history of the signer using the account.
+   * Default is false.
+   * @param args.options.noMultiKey - If true, do not include multi-key accounts in the results. Default is false.
+   * @returns Promise resolving to an array of derived Account objects
+   *
+   * @example
+   * ```typescript
+   * import { Aptos, AptosConfig, Network, Ed25519Account } from "@aptos-labs/ts-sdk";
+   *
+   * const config = new AptosConfig({ network: Network.TESTNET });
+   * const aptos = new Aptos(config);
+   *
+   * async function getOwnedAccounts() {
+   *   const signer = Ed25519Account.generate();
+   *   const accounts = await aptos.deriveOwnedAccountsFromSigner({
+   *     signer
+   *   });
+   *   const account = accounts[0];
+   *   console.log(account);
+   * }
+   * ```
+   * @group Account
+   */
+  async deriveOwnedAccountsFromSigner(args: {
+    signer: AccountModule | PrivateKeyInput;
+    minimumLedgerVersion?: AnyNumber;
+    options?: { includeUnverified?: boolean; noMultiKey?: boolean };
+  }): Promise<AccountModule[]> {
+    await waitForIndexerOnVersion({
+      config: this.config,
+      minimumLedgerVersion: args.minimumLedgerVersion,
+      processorType: ProcessorType.ACCOUNT_RESTORATION_PROCESSOR,
+    });
+    await waitForIndexerOnVersion({
+      config: this.config,
+      minimumLedgerVersion: args.minimumLedgerVersion,
+      processorType: ProcessorType.OBJECT_PROCESSOR,
+    });
+    return deriveOwnedAccountsFromSigner({ aptosConfig: this.config, ...args });
+  }
+
+  /**
+   * Gets all account info (address, account public key, last transaction version) that have are associated with a public key and **related public keys**
+   *
+   * For a given public key, it will query all multikeys that the public key is part of.  Then for the provided public key and
+   * any multikeys found in the previous step, it will query for any accounts that have an auth key that matches any of the
+   * public keys.
+   *
+   * Note: If an Ed25519PublicKey or an AnyPublicKey that wraps Ed25519PublicKey is passed in, it will query for both legacy and single singer cases.
+   *
+   * @param args - The arguments for getting accounts for a public key
+   * @param args.publicKey - The public key to look up accounts for
+   * @param args.minimumLedgerVersion - The minimum ledger version to wait for before querying
+   * @param args.options.includeUnverified - Whether to include unverified accounts in the results. Unverified accounts
+   * are accounts that can be authenticated with the signer, but there is no history of the signer using the account. Default
+   * is false.
+   * @param args.options.noMultiKey - Whether to exclude multi-key accounts in the results. Default is false.
+   * @returns Promise resolving to an array of account addresses and their associated public keys
+   *
+   * @example
+   * ```typescript
+   * import { Aptos, AptosConfig, Network, Ed25519PrivateKey } from "@aptos-labs/ts-sdk";
+   *
+   * const config = new AptosConfig({ network: Network.TESTNET });
+   * const aptos = new Aptos(config);
+   *
+   * async function getAccounts() {
+   *   const privateKey = Ed25519PrivateKey.generate();
+   *   const publicKey = privateKey.publicKey();
+   *   const accounts = await aptos.getAccountsForPublicKey({
+   *     publicKey
+   *   });
+   *   console.log(accounts);
+   * }
+   * ```
+   * @group Account
+   */
+  async getAccountsForPublicKey(args: {
+    publicKey: BaseAccountPublicKey;
+    minimumLedgerVersion?: AnyNumber;
+    options?: { includeUnverified?: boolean; noMultiKey?: boolean };
+  }): Promise<AccountInfo[]> {
+    await waitForIndexerOnVersion({
+      config: this.config,
+      minimumLedgerVersion: args.minimumLedgerVersion,
+      processorType: ProcessorType.ACCOUNT_RESTORATION_PROCESSOR,
+    });
+    await waitForIndexerOnVersion({
+      config: this.config,
+      minimumLedgerVersion: args.minimumLedgerVersion,
+      processorType: ProcessorType.OBJECT_PROCESSOR,
+    });
+    return getAccountsForPublicKey({
+      aptosConfig: this.config,
+      ...args,
+    });
+  }
 }

package/src/api/aptos.ts

@@ -92,8 +92,8 @@ export class Aptos {
    * ```
    * @group Client
    */
-  constructor(settings?: AptosConfig) {
-    this.config = new AptosConfig(settings);
+  constructor(config?: AptosConfig) {
+    this.config = config ?? new AptosConfig();
     this.account = new Account(this.config);
     this.abstraction = new AccountAbstraction(this.config);
     this.ans = new ANS(this.config);
@@ -109,6 +109,10 @@ export class Aptos {
     this.keyless = new Keyless(this.config);
     this.object = new AptosObject(this.config);
   }
+
+  setIgnoreTransactionSubmitter(ignore: boolean) {
+    this.config.setIgnoreTransactionSubmitter(ignore);
+  }
 }
 
 // extends Aptos interface so all the methods and properties

package/src/api/aptosConfig.ts

@@ -2,7 +2,17 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import aptosClient from "@aptos-labs/aptos-client";
-import { AptosSettings, ClientConfig, Client, FullNodeConfig, IndexerConfig, FaucetConfig } from "../types";
+import {
+  AptosSettings,
+  ClientConfig,
+  Client,
+  FullNodeConfig,
+  IndexerConfig,
+  FaucetConfig,
+  TransactionGenerationConfig,
+  PluginConfig,
+  TransactionSubmitter,
+} from "../types";
 import {
   NetworkToNodeAPI,
   NetworkToFaucetAPI,
@@ -11,7 +21,7 @@ import {
   NetworkToPepperAPI,
   NetworkToProverAPI,
 } from "../utils/apiEndpoints";
-import { AptosApiType } from "../utils/const";
+import { AptosApiType, DEFAULT_MAX_GAS_AMOUNT, DEFAULT_TXN_EXP_SEC_FROM_NOW } from "../utils/const";
 
 /**
  * Represents the configuration settings for an Aptos SDK client instance.
@@ -101,6 +111,18 @@ export class AptosConfig {
    */
   readonly faucetConfig?: FaucetConfig;
 
+  /**
+   * Optional specific Transaction Generation configurations
+   * @group Client
+   */
+  readonly transactionGenerationConfig?: TransactionGenerationConfig;
+
+  /**
+   * Optional plugin config to override client behavior.
+   * @group Client
+   */
+  private pluginConfig?: PluginConfig;
+
   /**
    * Initializes an instance of the Aptos client with the specified settings.
    * This allows users to configure various aspects of the client, such as network and endpoints.
@@ -154,6 +176,13 @@ export class AptosConfig {
     this.fullnodeConfig = settings?.fullnodeConfig ?? {};
     this.indexerConfig = settings?.indexerConfig ?? {};
     this.faucetConfig = settings?.faucetConfig ?? {};
+    this.transactionGenerationConfig = settings?.transactionGenerationConfig ?? {};
+    this.pluginConfig = settings?.pluginSettings
+      ? {
+          ...settings.pluginSettings,
+          IGNORE_TRANSACTION_SUBMITTER: false,
+        }
+      : undefined;
   }
 
   /**
@@ -265,4 +294,46 @@ export class AptosConfig {
   isProverServiceRequest(url: string): boolean {
     return NetworkToProverAPI[this.network] === url;
   }
+
+  getDefaultMaxGasAmount(): number {
+    return this.transactionGenerationConfig?.defaultMaxGasAmount ?? DEFAULT_MAX_GAS_AMOUNT;
+  }
+
+  getDefaultTxnExpirySecFromNow(): number {
+    return this.transactionGenerationConfig?.defaultTxnExpirySecFromNow ?? DEFAULT_TXN_EXP_SEC_FROM_NOW;
+  }
+
+  /**
+   * If you have set a custom transaction submitter, you can use this to determine
+   * whether to use it or not. For example, to stop using the transaction submitter:
+   *
+   * @example
+   * ```
+   * aptos.config.setIgnoreTransactionSubmitter(true);
+   * ```
+   *
+   * @group Client
+   */
+  setIgnoreTransactionSubmitter(ignore: boolean) {
+    if (this.pluginConfig) {
+      this.pluginConfig.IGNORE_TRANSACTION_SUBMITTER = ignore;
+    }
+  }
+
+  /**
+   * If a custom transaction submitter has been specified in the PluginConfig and
+   * IGNORE_TRANSACTION_SUBMITTER is false, this will return a transaction submitter
+   * that should be used instead of the default transaction submission behavior.
+   */
+  getTransactionSubmitter(): TransactionSubmitter | undefined {
+    if (this.pluginConfig === undefined) {
+      return undefined;
+    }
+
+    if (this.pluginConfig.IGNORE_TRANSACTION_SUBMITTER === true) {
+      return undefined;
+    }
+
+    return this.pluginConfig.TRANSACTION_SUBMITTER;
+  }
 }

package/src/api/transaction.ts

@@ -34,6 +34,7 @@ import {
   AnyRawTransaction,
   InputGenerateTransactionOptions,
   InputGenerateTransactionPayloadData,
+  InputTransactionPluginData,
 } from "../transactions";
 import { AccountAddressInput, AuthenticationKey, Ed25519PrivateKey } from "../core";
 import { Account } from "../account";
@@ -522,6 +523,7 @@ export class Transaction {
   async rotateAuthKey(
     args: {
       fromAccount: Account;
+      options?: InputGenerateTransactionOptions;
     } & (
       | { toAccount: Account; dangerouslySkipVerification?: never }
       | { toNewPrivateKey: Ed25519PrivateKey; dangerouslySkipVerification?: never }
@@ -717,7 +719,7 @@ export class Transaction {
     args: FeePayerOrFeePayerAuthenticatorOrNeither & {
       signer: Account;
       transaction: AnyRawTransaction;
-    },
+    } & InputTransactionPluginData,
   ): Promise<PendingTransactionResponse> {
     return signAndSubmitTransaction({
       aptosConfig: this.config,
@@ -744,11 +746,13 @@ export class Transaction {
    * @return PendingTransactionResponse
    * @group Transaction
    */
-  async signAndSubmitAsFeePayer(args: {
-    feePayer: Account;
-    senderAuthenticator: AccountAuthenticator;
-    transaction: AnyRawTransaction;
-  }): Promise<PendingTransactionResponse> {
+  async signAndSubmitAsFeePayer(
+    args: {
+      feePayer: Account;
+      senderAuthenticator: AccountAuthenticator;
+      transaction: AnyRawTransaction;
+    } & InputTransactionPluginData,
+  ): Promise<PendingTransactionResponse> {
     return signAndSubmitAsFeePayer({
       aptosConfig: this.config,
       ...args,

package/src/api/transactionSubmission/build.ts

@@ -3,7 +3,11 @@
 
 import { AccountAddressInput } from "../../core";
 import { generateTransaction } from "../../internal/transactionSubmission";
-import { InputGenerateTransactionPayloadData, InputGenerateTransactionOptions } from "../../transactions";
+import {
+  InputGenerateTransactionPayloadData,
+  InputGenerateTransactionOptions,
+  InputGenerateOrderlessTransactionOptions,
+} from "../../transactions";
 import { MultiAgentTransaction } from "../../transactions/instances/multiAgentTransaction";
 import { SimpleTransaction } from "../../transactions/instances/simpleTransaction";
 import { AptosConfig } from "../aptosConfig";

package/src/api/transactionSubmission/submit.ts

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import { submitTransaction } from "../../internal/transactionSubmission";
-import { AccountAuthenticator, AnyRawTransaction } from "../../transactions";
+import { AccountAuthenticator, AnyRawTransaction, InputTransactionPluginData } from "../../transactions";
 import { PendingTransactionResponse } from "../../types";
 import { AptosConfig } from "../aptosConfig";
 import { ValidateFeePayerDataOnSubmission } from "./helpers";
@@ -87,11 +87,13 @@ export class Submit {
    * @group Implementation
    */
   @ValidateFeePayerDataOnSubmission
-  async simple(args: {
-    transaction: AnyRawTransaction;
-    senderAuthenticator: AccountAuthenticator;
-    feePayerAuthenticator?: AccountAuthenticator;
-  }): Promise<PendingTransactionResponse> {
+  async simple(
+    args: {
+      transaction: AnyRawTransaction;
+      senderAuthenticator: AccountAuthenticator;
+      feePayerAuthenticator?: AccountAuthenticator;
+    } & InputTransactionPluginData,
+  ): Promise<PendingTransactionResponse> {
     return submitTransaction({ aptosConfig: this.config, ...args });
   }
 
@@ -141,12 +143,14 @@ export class Submit {
    * @group Implementation
    */
   @ValidateFeePayerDataOnSubmission
-  async multiAgent(args: {
-    transaction: AnyRawTransaction;
-    senderAuthenticator: AccountAuthenticator;
-    additionalSignersAuthenticators: Array<AccountAuthenticator>;
-    feePayerAuthenticator?: AccountAuthenticator;
-  }): Promise<PendingTransactionResponse> {
+  async multiAgent(
+    args: {
+      transaction: AnyRawTransaction;
+      senderAuthenticator: AccountAuthenticator;
+      additionalSignersAuthenticators: Array<AccountAuthenticator>;
+      feePayerAuthenticator?: AccountAuthenticator;
+    } & InputTransactionPluginData,
+  ): Promise<PendingTransactionResponse> {
     return submitTransaction({ aptosConfig: this.config, ...args });
   }
 }

package/src/core/crypto/index.ts

@@ -15,4 +15,5 @@ export * from "./publicKey";
 export * from "./secp256k1";
 export * from "./signature";
 export * from "./singleKey";
+export * from "./types";
 export * from "./deserializationUtils";

package/src/core/crypto/multiEd25519.ts

@@ -92,6 +92,10 @@ export class MultiEd25519PublicKey extends AbstractMultiKey {
     this.threshold = threshold;
   }
 
+  getSignaturesRequired(): number {
+    return this.threshold;
+  }
+
   // region AccountPublicKey
 
   /**
@@ -217,6 +221,28 @@ export class MultiEd25519PublicKey extends AbstractMultiKey {
     return new MultiEd25519PublicKey({ publicKeys: keys, threshold });
   }
 
+  /**
+   * Deserializes a MultiEd25519Signature from the provided deserializer.
+   * This function helps in reconstructing a MultiEd25519Signature object from its serialized byte representation.
+   *
+   * @param deserializer - The deserializer instance used to read the serialized data.
+   * @group Implementation
+   * @category Serialization
+   */
+  static deserializeWithoutLength(deserializer: Deserializer): MultiEd25519PublicKey {
+    const length = deserializer.remaining();
+    const bytes = deserializer.deserializeFixedBytes(length);
+    const threshold = bytes[bytes.length - 1];
+
+    const keys: Ed25519PublicKey[] = [];
+
+    for (let i = 0; i < bytes.length - 1; i += Ed25519PublicKey.LENGTH) {
+      const begin = i;
+      keys.push(new Ed25519PublicKey(bytes.subarray(begin, begin + Ed25519PublicKey.LENGTH)));
+    }
+    return new MultiEd25519PublicKey({ publicKeys: keys, threshold });
+  }
+
   // endregion
 
   /**