@aptos-labs/ts-sdk 7.3.0 → 7.5.0

package/dist/api/transaction.d.ts

@@ -58,7 +58,7 @@ import { SimpleTransaction } from "../transactions/instances/simpleTransaction.j
  *
  *   // Send a transaction from Alice's account to Bob's account
  *   const txn = await aptos.transaction.build.simple({
- *     sender: alice.accountAddress,
+ *     sender: alice,
  *     data: {
  *       // All transactions on Aptos are implemented via smart contracts.
  *       function: "0x1::aptos_account::transfer",
@@ -215,6 +215,38 @@ export declare class Transaction {
     getTransactionByHash(args: {
         transactionHash: HexInput;
     }): Promise<TransactionResponse>;
+    /**
+     * Populates missing decoded data on write and delete table-item changes in a
+     * committed transaction response.
+     *
+     * Fullnodes generally return `null` for table item `data`. This method queries
+     * the indexer for the decoded rows and table metadata, then mutates and returns
+     * the supplied transaction. Already-decoded changes are preserved.
+     *
+     * @param args - The arguments for enriching the transaction.
+     * @param args.transaction - The committed transaction response to enrich.
+     * @returns The supplied transaction with available table item data populated.
+     *
+     * @example
+     * ```typescript
+     * import { Aptos, AptosConfig, Network, isUserTransactionResponse } from "@aptos-labs/ts-sdk";
+     *
+     * const aptos = new Aptos(new AptosConfig({ network: Network.MAINNET }));
+     *
+     * async function runExample() {
+     *   const transaction = await aptos.getTransactionByVersion({ ledgerVersion: 563060087 });
+     *   if (isUserTransactionResponse(transaction)) {
+     *     await aptos.enrichTransactionWithTableItemData({ transaction });
+     *     console.log(transaction.changes);
+     *   }
+     * }
+     * runExample();
+     * ```
+     * @group Transaction
+     */
+    enrichTransactionWithTableItemData<T extends CommittedTransactionResponse>(args: {
+        transaction: T;
+    }): Promise<T>;
     /**
      * Defines if the specified transaction is currently in a pending state.
      * This function helps you determine the status of a transaction using its hash.
@@ -361,6 +393,7 @@ export declare class Transaction {
      * @param args.account The publisher account.
      * @param args.metadataBytes The package metadata bytes.
      * @param args.moduleBytecode An array of the bytecode of each module in the package in compiler output order.
+     * @param args.withFeePayer Whether to build a sponsored transaction.
      * @param args.options Optional settings for generating the transaction.
      *
      * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -394,6 +427,7 @@ export declare class Transaction {
         account: AccountAddressInput;
         metadataBytes: HexInput;
         moduleBytecode: Array<HexInput>;
+        withFeePayer?: boolean;
         options?: InputGenerateTransactionOptions;
     }): Promise<SimpleTransaction>;
     /**
@@ -404,6 +438,8 @@ export declare class Transaction {
      * @param args.fromAccount - The account from which the authentication key will be rotated.
      * @param args.toAccount - (Optional) The target account to rotate to. Required if not using toNewPrivateKey.
      * @param args.toNewPrivateKey - (Optional) The new private key to rotate to. Required if not using toAccount.
+     * @param args.withFeePayer - Whether to build a sponsored transaction.
+     * @param args.options - Optional settings for generating the transaction.
      *
      * @remarks
      * This function supports three modes of rotation:
@@ -434,6 +470,7 @@ export declare class Transaction {
      */
     rotateAuthKey(args: {
         fromAccount: Account;
+        withFeePayer?: boolean;
         options?: InputGenerateTransactionOptions;
     } & ({
         toAccount: Ed25519Account | MultiEd25519Account;
@@ -450,6 +487,8 @@ export declare class Transaction {
      * @param args - The arguments for rotating the authentication key.
      * @param args.fromAccount - The account from which the authentication key will be rotated.
      * @param args.toNewPublicKey - The new public key to rotate to.
+     * @param args.withFeePayer - Whether to build a sponsored transaction.
+     * @param args.options - Optional settings for generating the transaction.
      *
      * @returns A simple transaction object that can be submitted to the network.
      *
@@ -471,6 +510,7 @@ export declare class Transaction {
      */
     rotateAuthKeyUnverified(args: {
         fromAccount: Account;
+        withFeePayer?: boolean;
         options?: InputGenerateTransactionOptions;
         toNewPublicKey: AccountPublicKey;
     }): Promise<SimpleTransaction>;

package/dist/api/transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/api/transaction.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/api/transaction.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAU/C,OAAO,EACL,SAAS,EACT,4BAA4B,EAC5B,aAAa,EACb,QAAQ,EACR,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,wCAAwC,EAOzC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,+BAA+B,EAC/B,mCAAmC,EACnC,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAGnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAEtC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YAAY,MAAM,EAAE,WAAW,EAM9B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,eAAe,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAKzF;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,uBAAuB,CAAC,IAAI,EAAE;QAAE,aAAa,EAAE,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAK9F;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,oBAAoB,CAAC,IAAI,EAAE;QAAE,eAAe,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAK5F;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,kCAAkC,CAAC,CAAC,SAAS,4BAA4B,EAAE,IAAI,EAAE;QACrF,WAAW,EAAE,CAAC,CAAC;KAChB,GAAG,OAAO,CAAC,CAAC,CAAC,CAKb;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,oBAAoB,CAAC,IAAI,EAAE;QAAE,eAAe,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhF;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACG,kBAAkB,CAAC,IAAI,EAAE;QAC7B,eAAe,EAAE,QAAQ,CAAC;QAC1B,OAAO,CAAC,EAAE,yBAAyB,CAAC;KACrC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAKxC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,qBAAqB,IAAI,OAAO,CAAC,aAAa,CAAC,CAIpD;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IAEH,iBAAiB,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,iBAAiB,CAAA;KAAE,GAAG,UAAU,CAEtE;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACG,yBAAyB,CAAC,IAAI,EAAE;QACpC,OAAO,EAAE,mBAAmB,CAAC;QAC7B,aAAa,EAAE,QAAQ,CAAC;QACxB,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChC,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,OAAO,CAAC,EAAE,+BAA+B,CAAC;KAC3C,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE7B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACG,aAAa,CACjB,IAAI,EAAE;QACJ,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,OAAO,CAAC,EAAE,+BAA+B,CAAC;KAC3C,GAAG,CAAC;QAAE,SAAS,EAAE,cAAc,GAAG,mBAAmB,CAAA;KAAE,GAAG;QAAE,eAAe,EAAE,iBAAiB,CAAA;KAAE,CAAC,GACjG,OAAO,CAAC,iBAAiB,CAAC,CAE5B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,uBAAuB,CAAC,IAAI,EAAE;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,OAAO,CAAC,EAAE,+BAA+B,CAAC;QAC1C,cAAc,EAAE,gBAAgB,CAAC;KAClC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE7B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IAEH,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,iBAAiB,CAAA;KAAE,GAAG,oBAAoB,CAIpF;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IAEH,cAAc,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,iBAAiB,CAAA;KAAE,GAAG,oBAAoB,CAI9F;IAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACG,iCAAiC,CAAC,IAAI,EAAE;QAC5C,MAAM,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,mCAAmC,EAAE,CAAC;QAC5C,OAAO,CAAC,EAAE,IAAI,CAAC,+BAA+B,EAAE,uBAAuB,CAAC,CAAC;KAC1E,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACG,wBAAwB,CAC5B,IAAI,EAAE,wCAAwC,GAAG;QAC/C,MAAM,EAAE,OAAO,CAAC;QAChB,WAAW,EAAE,iBAAiB,CAAC;KAChC,GAAG,0BAA0B,GAC7B,OAAO,CAAC,0BAA0B,CAAC,CAKrC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACG,uBAAuB,CAC3B,IAAI,EAAE;QACJ,QAAQ,EAAE,OAAO,CAAC;QAClB,mBAAmB,EAAE,oBAAoB,CAAC;QAC1C,WAAW,EAAE,iBAAiB,CAAC;KAChC,GAAG,0BAA0B,GAC7B,OAAO,CAAC,0BAA0B,CAAC,CAKrC;CACF"}

package/dist/api/transaction.js

@@ -1,6 +1,6 @@
 // Copyright © Aptos Foundation
 // SPDX-License-Identifier: Apache-2.0
-import { getGasPriceEstimation, getTransactionByHash, getTransactionByVersion, getTransactions, isTransactionPending, waitForTransaction, } from "../internal/transaction.js";
+import { enrichTransactionWithTableItemData, getGasPriceEstimation, getTransactionByHash, getTransactionByVersion, getTransactions, isTransactionPending, waitForTransaction, } from "../internal/transaction.js";
 import { getSigningMessage, publicPackageTransaction, signAndSubmitAsFeePayer, signAndSubmitTransaction, signAsFeePayer, signTransaction, } from "../internal/transactionSubmission.js";
 import { Build } from "./transactionSubmission/build.js";
 import { Simulate } from "./transactionSubmission/simulate.js";
@@ -56,7 +56,7 @@ import { rotateAuthKey, rotateAuthKeyUnverified } from "../internal/account.js";
  *
  *   // Send a transaction from Alice's account to Bob's account
  *   const txn = await aptos.transaction.build.simple({
- *     sender: alice.accountAddress,
+ *     sender: alice,
  *     data: {
  *       // All transactions on Aptos are implemented via smart contracts.
  *       function: "0x1::aptos_account::transfer",
@@ -228,6 +228,41 @@ export class Transaction {
             ...args,
         });
     }
+    /**
+     * Populates missing decoded data on write and delete table-item changes in a
+     * committed transaction response.
+     *
+     * Fullnodes generally return `null` for table item `data`. This method queries
+     * the indexer for the decoded rows and table metadata, then mutates and returns
+     * the supplied transaction. Already-decoded changes are preserved.
+     *
+     * @param args - The arguments for enriching the transaction.
+     * @param args.transaction - The committed transaction response to enrich.
+     * @returns The supplied transaction with available table item data populated.
+     *
+     * @example
+     * ```typescript
+     * import { Aptos, AptosConfig, Network, isUserTransactionResponse } from "@aptos-labs/ts-sdk";
+     *
+     * const aptos = new Aptos(new AptosConfig({ network: Network.MAINNET }));
+     *
+     * async function runExample() {
+     *   const transaction = await aptos.getTransactionByVersion({ ledgerVersion: 563060087 });
+     *   if (isUserTransactionResponse(transaction)) {
+     *     await aptos.enrichTransactionWithTableItemData({ transaction });
+     *     console.log(transaction.changes);
+     *   }
+     * }
+     * runExample();
+     * ```
+     * @group Transaction
+     */
+    async enrichTransactionWithTableItemData(args) {
+        return enrichTransactionWithTableItemData({
+            aptosConfig: this.config,
+            ...args,
+        });
+    }
     /**
      * Defines if the specified transaction is currently in a pending state.
      * This function helps you determine the status of a transaction using its hash.
@@ -383,6 +418,7 @@ export class Transaction {
      * @param args.account The publisher account.
      * @param args.metadataBytes The package metadata bytes.
      * @param args.moduleBytecode An array of the bytecode of each module in the package in compiler output order.
+     * @param args.withFeePayer Whether to build a sponsored transaction.
      * @param args.options Optional settings for generating the transaction.
      *
      * @returns A SimpleTransaction that can be simulated or submitted to the chain.
@@ -423,6 +459,8 @@ export class Transaction {
      * @param args.fromAccount - The account from which the authentication key will be rotated.
      * @param args.toAccount - (Optional) The target account to rotate to. Required if not using toNewPrivateKey.
      * @param args.toNewPrivateKey - (Optional) The new private key to rotate to. Required if not using toAccount.
+     * @param args.withFeePayer - Whether to build a sponsored transaction.
+     * @param args.options - Optional settings for generating the transaction.
      *
      * @remarks
      * This function supports three modes of rotation:
@@ -464,6 +502,8 @@ export class Transaction {
      * @param args - The arguments for rotating the authentication key.
      * @param args.fromAccount - The account from which the authentication key will be rotated.
      * @param args.toNewPublicKey - The new public key to rotate to.
+     * @param args.withFeePayer - Whether to build a sponsored transaction.
+     * @param args.options - Optional settings for generating the transaction.
      *
      * @returns A simple transaction object that can be submitted to the network.
      *

package/dist/api/transaction.js.map

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

package/dist/api/transactionSubmission/build.d.ts

@@ -1,3 +1,4 @@
+import type { Account } from "../../account/index.js";
 import { AccountAddressInput } from "../../core/index.js";
 import { InputGenerateTransactionPayloadData, InputGenerateTransactionOptions } from "../../transactions/index.js";
 import { MultiAgentTransaction } from "../../transactions/instances/multiAgentTransaction.js";
@@ -44,7 +45,7 @@ export declare class Build {
      *
      * This function allows you to create a transaction with specified sender and data.
      *
-     * @param args.sender - The sender account address.
+     * @param args.sender - The sender account or account address.
      * @param args.data - The transaction data.
      * @param args.options - Optional transaction configurations.
      * @param args.withFeePayer - Whether there is a fee payer for the transaction.
@@ -53,15 +54,16 @@ export declare class Build {
      *
      * @example
      * ```typescript
-     * import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
+     * import { Account, Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
      *
      * const config = new AptosConfig({ network: Network.TESTNET });
      * const aptos = new Aptos(config);
+     * const sender = Account.generate();
      *
      * async function runExample() {
      *   // Build a simple transaction
-     *   const transaction = await aptos.transaction.simple({
-     *     sender: "0x1", // replace with a real sender account address
+     *   const transaction = await aptos.transaction.build.simple({
+     *     sender,
      *     data: {
      *       function: "0x1::aptos_account::transfer",
      *       functionArguments: ["0x2", 100], // replace with a real destination account address
@@ -79,7 +81,7 @@ export declare class Build {
      * @group Implementation
      */
     simple(args: {
-        sender: AccountAddressInput;
+        sender: Account | AccountAddressInput;
         data: InputGenerateTransactionPayloadData;
         options?: InputGenerateTransactionOptions;
         withFeePayer?: boolean;

package/dist/api/transactionSubmission/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/api/transactionSubmission/build.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,mCAAmC,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AACnH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uDAAuD,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,YAAY,MAAM,EAAE,WAAW,EAE9B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACG,MAAM,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,mBAAmB,CAAC;QAC5B,IAAI,EAAE,mCAAmC,CAAC;QAC1C,OAAO,CAAC,EAAE,+BAA+B,CAAC;QAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE7B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACG,UAAU,CAAC,IAAI,EAAE;QACrB,MAAM,EAAE,mBAAmB,CAAC;QAC5B,IAAI,EAAE,mCAAmC,CAAC;QAC1C,wBAAwB,EAAE,mBAAmB,EAAE,CAAC;QAChD,OAAO,CAAC,EAAE,+BAA+B,CAAC;QAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAEjC;CACF"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/api/transactionSubmission/build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,mCAAmC,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AACnH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uDAAuD,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD;;;GAGG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,YAAY,MAAM,EAAE,WAAW,EAE9B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACG,MAAM,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAAC;QACtC,IAAI,EAAE,mCAAmC,CAAC;QAC1C,OAAO,CAAC,EAAE,+BAA+B,CAAC;QAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAM7B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACG,UAAU,CAAC,IAAI,EAAE;QACrB,MAAM,EAAE,mBAAmB,CAAC;QAC5B,IAAI,EAAE,mCAAmC,CAAC;QAC1C,wBAAwB,EAAE,mBAAmB,EAAE,CAAC;QAChD,OAAO,CAAC,EAAE,+BAA+B,CAAC;QAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAEjC;CACF"}

package/dist/api/transactionSubmission/build.js

@@ -1,6 +1,9 @@
 // Copyright © Aptos Foundation
 // SPDX-License-Identifier: Apache-2.0
 import { generateTransaction } from "../../internal/transactionSubmission.js";
+function accountAddressInput(input) {
+    return typeof input === "object" && "accountAddress" in input ? input.accountAddress : input;
+}
 /**
  * A class to handle all `Build` transaction operations.
  * @group Implementation
@@ -44,7 +47,7 @@ export class Build {
      *
      * This function allows you to create a transaction with specified sender and data.
      *
-     * @param args.sender - The sender account address.
+     * @param args.sender - The sender account or account address.
      * @param args.data - The transaction data.
      * @param args.options - Optional transaction configurations.
      * @param args.withFeePayer - Whether there is a fee payer for the transaction.
@@ -53,15 +56,16 @@ export class Build {
      *
      * @example
      * ```typescript
-     * import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
+     * import { Account, Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";
      *
      * const config = new AptosConfig({ network: Network.TESTNET });
      * const aptos = new Aptos(config);
+     * const sender = Account.generate();
      *
      * async function runExample() {
      *   // Build a simple transaction
-     *   const transaction = await aptos.transaction.simple({
-     *     sender: "0x1", // replace with a real sender account address
+     *   const transaction = await aptos.transaction.build.simple({
+     *     sender,
      *     data: {
      *       function: "0x1::aptos_account::transfer",
      *       functionArguments: ["0x2", 100], // replace with a real destination account address
@@ -79,7 +83,11 @@ export class Build {
      * @group Implementation
      */
     async simple(args) {
-        return generateTransaction({ aptosConfig: this.config, ...args });
+        return generateTransaction({
+            aptosConfig: this.config,
+            ...args,
+            sender: accountAddressInput(args.sender),
+        });
     }
     /**
      * Build a multi-agent transaction that allows multiple signers to authorize a transaction.

package/dist/api/transactionSubmission/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/api/transactionSubmission/build.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sCAAsC;AAGtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAM9E;;;GAGG;AACH,MAAM,OAAO,KAAK;IACP,MAAM,CAAc;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,KAAK,CAAC,MAAM,CAAC,IAKZ;QACC,OAAO,mBAAmB,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,KAAK,CAAC,UAAU,CAAC,IAMhB;QACC,OAAO,mBAAmB,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;CACF"}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/api/transactionSubmission/build.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sCAAsC;AAItC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAM9E,SAAS,mBAAmB,CAAC,KAAoC;IAC/D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,gBAAgB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/F,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,KAAK;IACP,MAAM,CAAc;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACH,KAAK,CAAC,MAAM,CAAC,IAKZ;QACC,OAAO,mBAAmB,CAAC;YACzB,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,GAAG,IAAI;YACP,MAAM,EAAE,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,KAAK,CAAC,UAAU,CAAC,IAMhB;QACC,OAAO,mBAAmB,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/api/transactionSubmission/simulate.d.ts

@@ -38,8 +38,13 @@ export declare class Simulate {
      * Simulates a transaction based on the provided parameters and returns the result.
      * This function helps you understand the outcome of a transaction before executing it on the blockchain.
      *
+     * To pre-check a multisig proposal, build its entry function directly with the multisig address as sender and
+     * `withFeePayer: true`, then omit `signerPublicKey` and `feePayerPublicKey`. The simulation uses no-account
+     * authenticators to skip authentication-key validation, so the proposal does not need to exist on-chain.
+     *
      * @param args - The parameters for simulating the transaction.
-     * @param args.signerPublicKey - The public key of the signer for the transaction (optional).
+     * @param args.signerPublicKey - Optional public key used to validate the signer's authentication key.
+     * Omit it to simulate with the sender address already embedded in the transaction.
      * @param args.transaction - The raw transaction data to simulate.
      * @param args.feePayerPublicKey - The public key of the fee payer (optional).
      * @param args.options - Additional options for simulating the transaction (optional).
@@ -68,7 +73,7 @@ export declare class Simulate {
      *
      *     // 1. Build the transaction to preview the impact of it
      *     const transaction = await aptos.transaction.build.simple({
-     *         sender: sender.accountAddress,
+     *         sender,
      *         data: {
      *             // All transactions on Aptos are implemented via smart contracts.
      *             function: "0x1::aptos_account::transfer",
@@ -78,7 +83,6 @@ export declare class Simulate {
      *
      *     // 2. Simulate to see what would happen if we execute this transaction
      *     const [userTransactionResponse] = await aptos.transaction.simulate.simple({
-     *         signerPublicKey: sender.publicKey,
      *         transaction,
      *     });
      *     console.log(userTransactionResponse);

package/dist/api/transactionSubmission/simulate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../../src/api/transactionSubmission/simulate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;GAGG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,YAAY,MAAM,EAAE,WAAW,EAE9B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IAEG,MAAM,CAAC,IAAI,EAAE;QACjB,eAAe,CAAC,EAAE,SAAS,CAAC;QAC5B,WAAW,EAAE,iBAAiB,CAAC;QAC/B,iBAAiB,CAAC,EAAE,SAAS,CAAC;QAC9B,OAAO,CAAC,EAAE,+BAA+B,CAAC;KAC3C,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAE1C;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmEG;IAEG,UAAU,CAAC,IAAI,EAAE;QACrB,eAAe,CAAC,EAAE,SAAS,CAAC;QAC5B,WAAW,EAAE,iBAAiB,CAAC;QAC/B,0BAA0B,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;QAC1D,iBAAiB,CAAC,EAAE,SAAS,CAAC;QAC9B,OAAO,CAAC,EAAE,+BAA+B,CAAC;KAC3C,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAE1C;CACF"}
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../../src/api/transactionSubmission/simulate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;GAGG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,YAAY,MAAM,EAAE,WAAW,EAE9B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4DG;IAEG,MAAM,CAAC,IAAI,EAAE;QACjB,eAAe,CAAC,EAAE,SAAS,CAAC;QAC5B,WAAW,EAAE,iBAAiB,CAAC;QAC/B,iBAAiB,CAAC,EAAE,SAAS,CAAC;QAC9B,OAAO,CAAC,EAAE,+BAA+B,CAAC;KAC3C,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAE1C;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmEG;IAEG,UAAU,CAAC,IAAI,EAAE;QACrB,eAAe,CAAC,EAAE,SAAS,CAAC;QAC5B,WAAW,EAAE,iBAAiB,CAAC;QAC/B,0BAA0B,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;QAC1D,iBAAiB,CAAC,EAAE,SAAS,CAAC;QAC9B,OAAO,CAAC,EAAE,+BAA+B,CAAC;KAC3C,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAE1C;CACF"}

package/dist/api/transactionSubmission/simulate.js

@@ -46,8 +46,13 @@ export class Simulate {
      * Simulates a transaction based on the provided parameters and returns the result.
      * This function helps you understand the outcome of a transaction before executing it on the blockchain.
      *
+     * To pre-check a multisig proposal, build its entry function directly with the multisig address as sender and
+     * `withFeePayer: true`, then omit `signerPublicKey` and `feePayerPublicKey`. The simulation uses no-account
+     * authenticators to skip authentication-key validation, so the proposal does not need to exist on-chain.
+     *
      * @param args - The parameters for simulating the transaction.
-     * @param args.signerPublicKey - The public key of the signer for the transaction (optional).
+     * @param args.signerPublicKey - Optional public key used to validate the signer's authentication key.
+     * Omit it to simulate with the sender address already embedded in the transaction.
      * @param args.transaction - The raw transaction data to simulate.
      * @param args.feePayerPublicKey - The public key of the fee payer (optional).
      * @param args.options - Additional options for simulating the transaction (optional).
@@ -76,7 +81,7 @@ export class Simulate {
      *
      *     // 1. Build the transaction to preview the impact of it
      *     const transaction = await aptos.transaction.build.simple({
-     *         sender: sender.accountAddress,
+     *         sender,
      *         data: {
      *             // All transactions on Aptos are implemented via smart contracts.
      *             function: "0x1::aptos_account::transfer",
@@ -86,7 +91,6 @@ export class Simulate {
      *
      *     // 2. Simulate to see what would happen if we execute this transaction
      *     const [userTransactionResponse] = await aptos.transaction.simulate.simple({
-     *         signerPublicKey: sender.publicKey,
      *         transaction,
      *     });
      *     console.log(userTransactionResponse);

package/dist/api/transactionSubmission/simulate.js.map

@@ -1 +1 @@
-{"version":3,"file":"simulate.js","sourceRoot":"","sources":["../../../src/api/transactionSubmission/simulate.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sCAAsC;;;;;;;AAGtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAI9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAEhE;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACV,MAAM,CAAc;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IAEG,AAAN,KAAK,CAAC,MAAM,CAAC,IAKZ;QACC,OAAO,mBAAmB,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmEG;IAEG,AAAN,KAAK,CAAC,UAAU,CAAC,IAMhB;QACC,OAAO,mBAAmB,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;CACF;AAvFO;IADL,gCAAgC;sCAQhC;AAuEK;IADL,gCAAgC;0CAShC"}
+{"version":3,"file":"simulate.js","sourceRoot":"","sources":["../../../src/api/transactionSubmission/simulate.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sCAAsC;;;;;;;AAGtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAI9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,cAAc,CAAC;AAEhE;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACV,MAAM,CAAc;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4DG;IAEG,AAAN,KAAK,CAAC,MAAM,CAAC,IAKZ;QACC,OAAO,mBAAmB,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmEG;IAEG,AAAN,KAAK,CAAC,UAAU,CAAC,IAMhB;QACC,OAAO,mBAAmB,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;CACF;AAvFO;IADL,gCAAgC;sCAQhC;AAuEK;IADL,gCAAgC;0CAShC"}