@aptos-labs/ts-sdk 6.3.1 → 7.0.0

package/dist/transactions/transactionBuilder/transactionBuilder.js

@@ -0,0 +1,586 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * This file handles the transaction creation lifecycle.
+ * It holds different operations to generate a transaction payload, a raw transaction,
+ * and a signed transaction that can be simulated, signed and submitted to chain.
+ */
+import { sha3_256 as sha3Hash } from "@noble/hashes/sha3.js";
+import { MAX_U64_BIG_INT } from "../../bcs/consts.js";
+import { AccountAddress, Hex } from "../../core/index.js";
+import { AnyPublicKey, AnySignature, Secp256k1PublicKey, MultiKey, MultiKeySignature, } from "../../core/crypto/index.js";
+import { AnyPublicKeyVariant } from "../../types/index.js";
+import { Ed25519PublicKey, Ed25519Signature } from "../../core/crypto/ed25519.js";
+import { getInfo } from "../../internal/utils/index.js";
+import { getLedgerInfo } from "../../internal/general.js";
+import { getGasPriceEstimation } from "../../internal/transaction.js";
+import { NetworkToChainId } from "../../utils/apiEndpoints.js";
+import { MIN_ENCRYPTED_TXN_GAS_UNIT_PRICE, MIN_MAX_GAS_AMOUNT, TEXT_ENCODER } from "../../utils/const.js";
+import { normalizeBundle } from "../../utils/normalizeBundle.js";
+import { AccountAuthenticator, AccountAuthenticatorEd25519, AccountAuthenticatorMultiEd25519, AccountAuthenticatorMultiKey, AccountAuthenticatorNoAccountAuthenticator, AccountAuthenticatorSingleKey, } from "../authenticator/account.js";
+import { TransactionAuthenticatorEd25519, TransactionAuthenticatorFeePayer, TransactionAuthenticatorMultiAgent, TransactionAuthenticatorMultiEd25519, TransactionAuthenticatorSingleSender, } from "../authenticator/transaction.js";
+import { ChainId, EntryFunction, FeePayerRawTransaction, MultiAgentRawTransaction, MultiSig, MultiSigTransactionPayload, RawTransaction, Script, TransactionPayloadEntryFunction, TransactionPayloadMultiSig, TransactionPayloadScript, } from "../instances/index.js";
+import { SignedTransaction } from "../instances/signedTransaction.js";
+import { convertArgument, fetchEntryFunctionAbi, fetchViewFunctionAbi, standardizeTypeTags } from "./remoteAbi.js";
+import { memoizeAsync } from "../../utils/memoize.js";
+import { isScriptDataInput } from "./helpers.js";
+import { SimpleTransaction } from "../instances/simpleTransaction.js";
+import { MultiAgentTransaction } from "../instances/multiAgentTransaction.js";
+import { getFunctionParts } from "../../utils/helpers.js";
+import { TransactionExecutableEmpty, TransactionExecutableEntryFunction, TransactionExecutableScript, TransactionExtraConfigV1, TransactionInnerPayloadV1, } from "../instances/transactionPayload.js";
+import { buildEncryptedPayload } from "./encryptPayload.js";
+/**
+ * Builds a transaction payload based on the data argument and returns
+ * a transaction payload - TransactionPayloadScript | TransactionPayloadMultiSig | TransactionPayloadEntryFunction
+ *
+ * This uses the RemoteABI by default, and the remote ABI can be skipped by using generateTransactionPayloadWithABI
+ *
+ * @param args.data GenerateTransactionPayloadData
+ *
+ * @return TransactionPayload
+ * @group Implementation
+ * @category Transactions
+ */
+export async function generateTransactionPayload(args) {
+    if (isScriptDataInput(args)) {
+        const scriptPayload = generateTransactionPayloadScript(args);
+        // If multisigAddress is present, wrap the script in a multisig payload
+        if ("multisigAddress" in args) {
+            const multisigAddress = AccountAddress.from(args.multisigAddress);
+            return new TransactionPayloadMultiSig(new MultiSig(multisigAddress, new MultiSigTransactionPayload(scriptPayload.script)));
+        }
+        return scriptPayload;
+    }
+    const { moduleAddress, moduleName, functionName } = getFunctionParts(args.function);
+    const functionAbi = await fetchAbi({
+        key: "entry-function",
+        moduleAddress,
+        moduleName,
+        functionName,
+        aptosConfig: args.aptosConfig,
+        abi: args.abi,
+        fetch: fetchEntryFunctionAbi,
+    });
+    // Fill in the ABI
+    return generateTransactionPayloadWithABI({ ...args, abi: functionAbi });
+}
+/**
+ * @group Implementation
+ * @category Transactions
+ */
+export function generateTransactionPayloadWithABI(args) {
+    const functionAbi = args.abi;
+    const { moduleAddress, moduleName, functionName } = getFunctionParts(args.function);
+    // Ensure that all type arguments are typed properly
+    const typeArguments = standardizeTypeTags(args.typeArguments);
+    // Check the type argument count against the ABI
+    if (typeArguments.length !== functionAbi.typeParameters.length) {
+        throw new Error(`Type argument count mismatch, expected ${functionAbi.typeParameters.length}, received ${typeArguments.length}`);
+    }
+    // Check all BCS types, and convert any non-BCS types
+    const functionArguments = args.functionArguments?.map((arg, i) => 
+    /**
+     * Converts the argument for a specified function using its ABI and type arguments.
+     * This function helps ensure that the correct number of arguments is provided for the function call.
+     *
+     * @param args - The arguments for the function call.
+     * @param args.function - The specific function to be invoked.
+     * @param functionAbi - The ABI (Application Binary Interface) of the function, which includes parameter details.
+     * @param arg - The argument to be converted.
+     * @param i - The index of the argument in the function call.
+     * @param typeArguments - Additional type arguments that may be required for the conversion.
+     * @group Implementation
+     * @category Transactions
+     */
+    // TODO: Fix JSDoc
+    convertArgument(args.function, functionAbi, arg, i, typeArguments));
+    // Check that all arguments are accounted for
+    if ((functionArguments?.length ?? 0) !== functionAbi.parameters.length) {
+        throw new Error(`Too few arguments for '${moduleAddress}::${moduleName}::${functionName}', expected ${functionAbi.parameters.length} but got ${functionArguments?.length ?? 0}`);
+    }
+    // Generate entry function payload
+    const entryFunctionPayload = EntryFunction.build(`${moduleAddress}::${moduleName}`, functionName, typeArguments, functionArguments ?? []);
+    // Send it as multi sig if it's a multisig payload
+    if ("multisigAddress" in args) {
+        const multisigAddress = AccountAddress.from(args.multisigAddress);
+        return new TransactionPayloadMultiSig(new MultiSig(multisigAddress, new MultiSigTransactionPayload(entryFunctionPayload)));
+    }
+    // Otherwise send as an entry function
+    return new TransactionPayloadEntryFunction(entryFunctionPayload);
+}
+/**
+ * Generates the payload for a view function call using the provided arguments.
+ * This function helps in preparing the necessary data to interact with a specific view function on the blockchain.
+ *
+ * @param args - The input data required to generate the view function payload.
+ * @param args.function - The function identifier in the format "moduleAddress::moduleName::functionName".
+ * @param args.aptosConfig - Configuration settings for the Aptos client.
+ * @param args.abi - The ABI (Application Binary Interface) of the module.
+ *
+ * @returns The generated payload for the view function call.
+ * @group Implementation
+ * @category Transactions
+ */
+export async function generateViewFunctionPayload(args) {
+    const { moduleAddress, moduleName, functionName } = getFunctionParts(args.function);
+    const functionAbi = await fetchAbi({
+        key: "view-function",
+        moduleAddress,
+        moduleName,
+        functionName,
+        aptosConfig: args.aptosConfig,
+        abi: args.abi,
+        fetch: fetchViewFunctionAbi,
+    });
+    // Fill in the ABI
+    return generateViewFunctionPayloadWithABI({ abi: functionAbi, ...args });
+}
+/**
+ * Generates a payload for a view function call using the provided ABI and arguments.
+ * This function is synchronous and works offline with pre-fetched ABIs (no network calls).
+ * Does NOT support struct/enum arguments.
+ *
+ * @param args - The input data for generating the view function payload.
+ * @param args.abi - The ABI of the function to be called.
+ * @param args.function - The full name of the function in the format "moduleAddress::moduleName::functionName".
+ * @param args.typeArguments - An array of type arguments to be used in the function call.
+ * @param args.functionArguments - An array of arguments to be passed to the function.
+ *
+ * @throws Error if the type argument count does not match the ABI or if the function arguments
+ * do not match the expected parameters defined in the ABI.
+ * @group Implementation
+ * @category Transactions
+ */
+export function generateViewFunctionPayloadWithABI(args) {
+    const functionAbi = args.abi;
+    const { moduleAddress, moduleName, functionName } = getFunctionParts(args.function);
+    // Ensure that all type arguments are typed properly
+    const typeArguments = standardizeTypeTags(args.typeArguments);
+    // Check the type argument count against the ABI
+    if (typeArguments.length !== functionAbi.typeParameters.length) {
+        throw new Error(`Type argument count mismatch, expected ${functionAbi.typeParameters.length}, received ${typeArguments.length}`);
+    }
+    // Check all BCS types, and convert any non-BCS types
+    const functionArguments = args?.functionArguments?.map((arg, i) => convertArgument(args.function, functionAbi, arg, i, typeArguments)) ?? [];
+    // Check that all arguments are accounted for
+    if (functionArguments.length !== functionAbi.parameters.length) {
+        throw new Error(`Too few arguments for '${moduleAddress}::${moduleName}::${functionName}', expected ${functionAbi.parameters.length} but got ${functionArguments.length}`);
+    }
+    // Generate entry function payload
+    return EntryFunction.build(`${moduleAddress}::${moduleName}`, functionName, typeArguments, functionArguments);
+}
+/**
+ * Generates a transaction payload script based on the provided input data.
+ * This function helps in creating a structured script for transaction processing.
+ *
+ * @param args - The input data required to generate the transaction payload script.
+ * @param args.bytecode - The bytecode to be converted into a Uint8Array.
+ * @param args.typeArguments - The type arguments that will be standardized.
+ * @param args.functionArguments - The arguments for the function being called.
+ * @returns A new instance of TransactionPayloadScript.
+ * @group Implementation
+ * @category Transactions
+ */
+function generateTransactionPayloadScript(args) {
+    return new TransactionPayloadScript(new Script(Hex.fromHexInput(args.bytecode).toUint8Array(), standardizeTypeTags(args.typeArguments), args.functionArguments));
+}
+/**
+ * Generates a raw transaction that can be sent to the Aptos network.
+ *
+ * @param args - The arguments for generating the raw transaction.
+ * @param args.aptosConfig - The configuration for the Aptos network.
+ * @param args.sender - The transaction's sender account address as a hex input.
+ * @param args.payload - The transaction payload, which can be created using generateTransactionPayload().
+ * @param args.options - Optional parameters for transaction generation.
+ * @param args.feePayerAddress - The address of the fee payer for sponsored transactions.
+ *
+ * @returns RawTransaction - The generated raw transaction.
+ * @group Implementation
+ * @category Transactions
+ */
+export async function generateRawTransaction(args) {
+    const { aptosConfig, sender, payload, options, feePayerAddress, secondarySignerAddresses } = args;
+    if (options?.replayProtectionNonce !== undefined && options?.accountSequenceNumber !== undefined) {
+        throw new Error("Cannot specify both replayProtectionNonce and accountSequenceNumber in options.");
+    }
+    const getChainId = async () => {
+        if (NetworkToChainId[aptosConfig.network]) {
+            return { chainId: NetworkToChainId[aptosConfig.network] };
+        }
+        const info = await getLedgerInfo({ aptosConfig });
+        return { chainId: info.chain_id };
+    };
+    const getGasUnitPrice = async () => {
+        if (options?.gasUnitPrice) {
+            return { gasEstimate: options.gasUnitPrice };
+        }
+        const estimation = await getGasPriceEstimation({ aptosConfig });
+        return { gasEstimate: estimation.gas_estimate };
+    };
+    const getSequenceNumberForAny = async () => {
+        const getSequenceNumber = async () => {
+            if (options?.accountSequenceNumber !== undefined) {
+                return options.accountSequenceNumber;
+            }
+            if (options?.replayProtectionNonce !== undefined) {
+                // Orderless: chain uses sequence_number = u64::MAX and replay protection via
+                // extra_config.replay_protection_nonce (see RawTransaction::replay_protector in aptos-core).
+                return MAX_U64_BIG_INT;
+            }
+            return (await getInfo({ aptosConfig, accountAddress: sender })).sequence_number;
+        };
+        /**
+         * Check if is sponsored transaction to honor AIP-52
+         * {@link https://github.com/aptos-foundation/AIPs/blob/main/aips/aip-52.md}
+         * @group Implementation
+         * @category Transactions
+         */
+        if (feePayerAddress && AccountAddress.from(feePayerAddress).equals(AccountAddress.ZERO)) {
+            // Handle sponsored transaction generation with the option that
+            // the main signer has not been created on chain
+            try {
+                // Check if main signer has been created on chain, if not assign sequence number 0
+                return await getSequenceNumber();
+            }
+            catch {
+                return 0;
+            }
+        }
+        else {
+            return getSequenceNumber();
+        }
+    };
+    const [{ chainId }, { gasEstimate }, sequenceNumber] = await Promise.all([
+        getChainId(),
+        getGasUnitPrice(),
+        getSequenceNumberForAny(),
+    ]);
+    const userMaxGas = options?.maxGasAmount
+        ? BigInt(options.maxGasAmount)
+        : BigInt(aptosConfig.getDefaultMaxGasAmount());
+    const maxGasAmount = userMaxGas < BigInt(MIN_MAX_GAS_AMOUNT) ? BigInt(MIN_MAX_GAS_AMOUNT) : userMaxGas;
+    let gasUnitPrice = BigInt(options?.gasUnitPrice ?? gasEstimate);
+    if (options?.encrypted && gasUnitPrice < BigInt(MIN_ENCRYPTED_TXN_GAS_UNIT_PRICE)) {
+        if (options.gasUnitPrice !== undefined) {
+            // Caller explicitly set a price below the encrypted-transaction floor — warn so they know it was overridden.
+            console.warn(`Encrypted transaction: gasUnitPrice ${gasUnitPrice} is below the minimum ${MIN_ENCRYPTED_TXN_GAS_UNIT_PRICE}; overriding to ${MIN_ENCRYPTED_TXN_GAS_UNIT_PRICE}.`);
+        }
+        gasUnitPrice = BigInt(MIN_ENCRYPTED_TXN_GAS_UNIT_PRICE);
+    }
+    const expireTimestamp = options?.expireTimestamp ?? BigInt(Math.floor(Date.now() / 1000) + aptosConfig.getDefaultTxnExpirySecFromNow());
+    const replayProtectionNonce = options?.replayProtectionNonce !== undefined ? BigInt(options.replayProtectionNonce) : undefined;
+    // If encryption was requested, the encrypted payload carries its own extra_config (with the
+    // replay nonce). Otherwise the orderless flow wraps the payload in an inner V1.
+    let txnPayload = payload;
+    if (options?.encrypted) {
+        txnPayload = await buildEncryptedPayload({
+            aptosConfig,
+            sender,
+            payload,
+            options,
+            feePayerAddress,
+            secondarySignerAddresses,
+            replayProtectionNonce,
+        });
+    }
+    else if (replayProtectionNonce !== undefined) {
+        txnPayload = convertPayloadToInnerPayload(payload, replayProtectionNonce);
+    }
+    return new RawTransaction(AccountAddress.from(sender), BigInt(sequenceNumber), txnPayload, BigInt(maxGasAmount), BigInt(gasUnitPrice), BigInt(expireTimestamp), new ChainId(chainId));
+}
+export function convertPayloadToInnerPayload(payload, replayProtectionNonce) {
+    if (payload instanceof TransactionPayloadScript) {
+        return new TransactionInnerPayloadV1(new TransactionExecutableScript(payload.script), new TransactionExtraConfigV1(undefined, replayProtectionNonce));
+    }
+    if (payload instanceof TransactionPayloadEntryFunction) {
+        return new TransactionInnerPayloadV1(new TransactionExecutableEntryFunction(payload.entryFunction), new TransactionExtraConfigV1(undefined, replayProtectionNonce));
+    }
+    if (payload instanceof TransactionPayloadMultiSig) {
+        const innerPayload = payload.multiSig.transaction_payload;
+        let executable;
+        if (innerPayload === undefined || innerPayload?.transaction_payload === undefined) {
+            executable = new TransactionExecutableEmpty();
+        }
+        else if (innerPayload.transaction_payload instanceof EntryFunction) {
+            executable = new TransactionExecutableEntryFunction(innerPayload.transaction_payload);
+        }
+        else if (innerPayload.transaction_payload instanceof Script) {
+            executable = new TransactionExecutableScript(innerPayload.transaction_payload);
+        }
+        else {
+            throw new Error("Unsupported multisig transaction payload type");
+        }
+        return new TransactionInnerPayloadV1(executable, new TransactionExtraConfigV1(payload.multiSig.multisig_address, replayProtectionNonce));
+    }
+    throw new Error(`Unsupported payload type: ${payload}`);
+}
+/**
+ * Generates a transaction based on the provided arguments
+ *
+ * Note: we can start with one function to support all different payload/transaction types,
+ * and if to complex to use, we could have function for each type
+ *
+ * @param args.aptosConfig AptosConfig
+ * @param args.sender The transaction's sender account address as a hex input
+ * @param args.payload The transaction payload - can create by using generateTransactionPayload()
+ * @param args.options optional. Transaction options object
+ * @param args.secondarySignerAddresses optional. For when want to create a multi signers transaction
+ * @param args.feePayerAddress optional. For when want to create a fee payer (aka sponsored) transaction
+ *
+ * @return An instance of a RawTransaction, plus optional secondary/fee payer addresses
+ * ```
+ * {
+ *  rawTransaction: RawTransaction,
+ *  secondarySignerAddresses?: Array<AccountAddress>,
+ *  feePayerAddress?: AccountAddress
+ * }
+ * ```
+ * @group Implementation
+ * @category Transactions
+ */
+export async function buildTransaction(args) {
+    const { aptosConfig, sender, payload, options, feePayerAddress } = args;
+    // generate raw transaction
+    const rawTxn = await generateRawTransaction({
+        aptosConfig,
+        sender,
+        payload,
+        options,
+        feePayerAddress,
+        secondarySignerAddresses: "secondarySignerAddresses" in args ? args.secondarySignerAddresses : undefined,
+    });
+    // if multi agent transaction
+    if ("secondarySignerAddresses" in args) {
+        const signers = args.secondarySignerAddresses?.map((signer) => AccountAddress.from(signer)) ?? [];
+        return new MultiAgentTransaction(rawTxn, signers, args.feePayerAddress ? AccountAddress.from(args.feePayerAddress) : undefined);
+    }
+    // return the raw transaction
+    return new SimpleTransaction(rawTxn, args.feePayerAddress ? AccountAddress.from(args.feePayerAddress) : undefined);
+}
+/**
+ * Generate a signed transaction for simulation before submitting it to the chain.
+ * This function helps in preparing a transaction that can be simulated, allowing users to verify its validity and expected behavior.
+ *
+ * @param args - The input data required to generate the signed transaction for simulation.
+ * @param args.transaction - An Aptos transaction type to sign.
+ * @param args.signerPublicKey - The public key of the signer.
+ * @param args.secondarySignersPublicKeys - Optional. The public keys of secondary signers if it is a multi-signer transaction.
+ * @param args.feePayerPublicKey - Optional. The public key of the fee payer in a sponsored transaction.
+ * @param args.options - Optional. Additional options for simulating the transaction.
+ *
+ * @returns A signed serialized transaction that can be simulated.
+ * @group Implementation
+ * @category Transactions
+ */
+export async function generateSignedTransactionForSimulation(args) {
+    const { signerPublicKey, transaction, secondarySignersPublicKeys, feePayerPublicKey } = args;
+    const accountAuthenticator = await getAuthenticatorForSimulation(signerPublicKey);
+    // fee payer transaction
+    if (transaction.feePayerAddress) {
+        const transactionToSign = new FeePayerRawTransaction(transaction.rawTransaction, transaction.secondarySignerAddresses ?? [], transaction.feePayerAddress);
+        let secondaryAccountAuthenticators = [];
+        if (transaction.secondarySignerAddresses) {
+            if (secondarySignersPublicKeys) {
+                secondaryAccountAuthenticators = await Promise.all(secondarySignersPublicKeys.map((publicKey) => getAuthenticatorForSimulation(publicKey)));
+            }
+            else {
+                secondaryAccountAuthenticators = await Promise.all(Array.from({ length: transaction.secondarySignerAddresses.length }, () => getAuthenticatorForSimulation(undefined)));
+            }
+        }
+        const feePayerAuthenticator = await getAuthenticatorForSimulation(feePayerPublicKey);
+        const transactionAuthenticator = new TransactionAuthenticatorFeePayer(accountAuthenticator, transaction.secondarySignerAddresses ?? [], secondaryAccountAuthenticators, {
+            address: transaction.feePayerAddress,
+            authenticator: feePayerAuthenticator,
+        });
+        return new SignedTransaction(transactionToSign.raw_txn, transactionAuthenticator).bcsToBytes();
+    }
+    // multi agent transaction
+    if (transaction.secondarySignerAddresses) {
+        const transactionToSign = new MultiAgentRawTransaction(transaction.rawTransaction, transaction.secondarySignerAddresses);
+        let secondaryAccountAuthenticators = [];
+        if (secondarySignersPublicKeys) {
+            secondaryAccountAuthenticators = await Promise.all(secondarySignersPublicKeys.map((publicKey) => getAuthenticatorForSimulation(publicKey)));
+        }
+        else {
+            secondaryAccountAuthenticators = await Promise.all(Array.from({ length: transaction.secondarySignerAddresses.length }, () => getAuthenticatorForSimulation(undefined)));
+        }
+        const transactionAuthenticator = new TransactionAuthenticatorMultiAgent(accountAuthenticator, transaction.secondarySignerAddresses, secondaryAccountAuthenticators);
+        return new SignedTransaction(transactionToSign.raw_txn, transactionAuthenticator).bcsToBytes();
+    }
+    // single signer raw transaction
+    let transactionAuthenticator;
+    if (accountAuthenticator instanceof AccountAuthenticatorEd25519) {
+        transactionAuthenticator = new TransactionAuthenticatorEd25519(accountAuthenticator.public_key, accountAuthenticator.signature);
+    }
+    else if (accountAuthenticator instanceof AccountAuthenticatorSingleKey ||
+        accountAuthenticator instanceof AccountAuthenticatorMultiKey) {
+        transactionAuthenticator = new TransactionAuthenticatorSingleSender(accountAuthenticator);
+    }
+    else if (accountAuthenticator instanceof AccountAuthenticatorNoAccountAuthenticator) {
+        transactionAuthenticator = new TransactionAuthenticatorSingleSender(accountAuthenticator);
+    }
+    else {
+        throw new Error("Invalid public key");
+    }
+    return new SignedTransaction(transaction.rawTransaction, transactionAuthenticator).bcsToBytes();
+}
+/**
+ * @group Implementation
+ * @category Transactions
+ */
+export async function getAuthenticatorForSimulation(publicKey) {
+    if (!publicKey) {
+        return new AccountAuthenticatorNoAccountAuthenticator();
+    }
+    // Wrap the public key types below with AnyPublicKey as they are only support through single sender.
+    // Learn more about AnyPublicKey here - https://github.com/aptos-foundation/AIPs/blob/main/aips/aip-55.md
+    // Detect keyless public keys by duck-typing to avoid importing poseidon-heavy modules
+    const detectKeylessVariant = (key) => {
+        if ("jwkAddress" in key && "keylessPublicKey" in key)
+            return AnyPublicKeyVariant.FederatedKeyless;
+        if ("iss" in key && typeof key.iss === "string" && "idCommitment" in key)
+            return AnyPublicKeyVariant.Keyless;
+        return undefined;
+    };
+    const keylessVariant = detectKeylessVariant(publicKey);
+    const convertToAnyPublicKey = keylessVariant !== undefined || Secp256k1PublicKey.isInstance(publicKey);
+    // Pass variant explicitly for keyless keys to avoid instanceof-based registry detection
+    const accountPublicKey = convertToAnyPublicKey ? new AnyPublicKey(publicKey, keylessVariant) : publicKey;
+    // No need to for the signature to be matching in scheme. All that matters for simulations is that it's not valid
+    const invalidSignature = new Ed25519Signature(new Uint8Array(64));
+    if (Ed25519PublicKey.isInstance(accountPublicKey)) {
+        return new AccountAuthenticatorEd25519(accountPublicKey, invalidSignature);
+    }
+    if (AnyPublicKey.isInstance(accountPublicKey)) {
+        if (accountPublicKey.variant === AnyPublicKeyVariant.Keyless ||
+            accountPublicKey.variant === AnyPublicKeyVariant.FederatedKeyless) {
+            // Dynamic import to avoid pulling poseidon-lite into the main bundle
+            const { KeylessSignature } = await import("../../core/crypto/keyless.js");
+            return new AccountAuthenticatorSingleKey(accountPublicKey, new AnySignature(KeylessSignature.getSimulationSignature()));
+        }
+        return new AccountAuthenticatorSingleKey(accountPublicKey, new AnySignature(invalidSignature));
+    }
+    if (MultiKey.isInstance(accountPublicKey)) {
+        let keylessSignatureModule;
+        return new AccountAuthenticatorMultiKey(accountPublicKey, new MultiKeySignature({
+            signatures: await Promise.all(accountPublicKey.publicKeys.map(async (pubKey) => {
+                if (pubKey.variant === AnyPublicKeyVariant.Keyless ||
+                    pubKey.variant === AnyPublicKeyVariant.FederatedKeyless) {
+                    keylessSignatureModule ??= await import("../../core/crypto/keyless.js");
+                    return new AnySignature(keylessSignatureModule.KeylessSignature.getSimulationSignature());
+                }
+                return new AnySignature(invalidSignature);
+            })),
+            bitmap: accountPublicKey.createBitmap({
+                bits: new Array(accountPublicKey.publicKeys.length).fill(0).map((_, i) => i),
+            }),
+        }));
+    }
+    throw new Error("Unsupported PublicKey used for simulations");
+}
+/**
+ * Generate a signed transaction ready for submission to the blockchain.
+ * This function prepares the transaction by authenticating the sender and any additional signers based on the provided arguments.
+ *
+ * @param args - The input data required to generate the signed transaction.
+ * @param args.transaction - An Aptos transaction type containing the details of the transaction.
+ * @param args.senderAuthenticator - The account authenticator of the transaction sender.
+ * @param args.feePayerAuthenticator - The authenticator for the fee payer, required if the transaction has a fee payer address.
+ * @param args.additionalSignersAuthenticators - Optional authenticators for additional signers in a multi-signer transaction.
+ *
+ * @returns A Uint8Array representing the signed transaction in bytes.
+ *
+ * @throws Error if the feePayerAuthenticator is not provided for a fee payer transaction.
+ * @throws Error if additionalSignersAuthenticators are not provided for a multi-signer transaction.
+ * @group Implementation
+ * @category Transactions
+ */
+export function generateSignedTransaction(args) {
+    const { transaction, feePayerAuthenticator, additionalSignersAuthenticators } = args;
+    const senderAuthenticator = normalizeBundle(AccountAuthenticator, args.senderAuthenticator);
+    let txnAuthenticator;
+    if (transaction.feePayerAddress) {
+        if (!feePayerAuthenticator) {
+            throw new Error("Must provide a feePayerAuthenticator argument to generate a signed fee payer transaction");
+        }
+        txnAuthenticator = new TransactionAuthenticatorFeePayer(senderAuthenticator, transaction.secondarySignerAddresses ?? [], additionalSignersAuthenticators ?? [], {
+            address: transaction.feePayerAddress,
+            authenticator: feePayerAuthenticator,
+        });
+    }
+    else if (transaction.secondarySignerAddresses) {
+        if (!additionalSignersAuthenticators) {
+            throw new Error("Must provide a additionalSignersAuthenticators argument to generate a signed multi agent transaction");
+        }
+        txnAuthenticator = new TransactionAuthenticatorMultiAgent(senderAuthenticator, transaction.secondarySignerAddresses, additionalSignersAuthenticators);
+    }
+    else if (senderAuthenticator instanceof AccountAuthenticatorEd25519) {
+        txnAuthenticator = new TransactionAuthenticatorEd25519(senderAuthenticator.public_key, senderAuthenticator.signature);
+    }
+    else if (senderAuthenticator instanceof AccountAuthenticatorMultiEd25519) {
+        txnAuthenticator = new TransactionAuthenticatorMultiEd25519(senderAuthenticator.public_key, senderAuthenticator.signature);
+    }
+    else {
+        txnAuthenticator = new TransactionAuthenticatorSingleSender(senderAuthenticator);
+    }
+    return new SignedTransaction(transaction.rawTransaction, txnAuthenticator).bcsToBytes();
+}
+/**
+ * Hashes the set of values using a SHA-3 256 hash algorithm.
+ * @param input - An array of UTF-8 strings or Uint8Array byte arrays to be hashed.
+ * @group Implementation
+ * @category Transactions
+ */
+export function hashValues(input) {
+    const hash = sha3Hash.create();
+    for (const item of input) {
+        hash.update(typeof item === "string" ? TEXT_ENCODER.encode(item) : item);
+    }
+    return hash.digest();
+}
+/**
+ * The domain separated prefix for hashing transactions
+ * @group Implementation
+ * @category Transactions
+ */
+const TRANSACTION_PREFIX = hashValues(["APTOS::Transaction"]);
+/**
+ * Generates a user transaction hash for the provided transaction payload, which must already have an authenticator.
+ * This function helps ensure the integrity and uniqueness of the transaction by producing a hash based on the signed transaction data.
+ *
+ * @param args - The input data required to submit the transaction.
+ * @param args.authenticator - The authenticator for the transaction.
+ * @param args.payload - The payload containing the transaction details.
+ * @param args.sender - The address of the sender initiating the transaction.
+ * @param args.sequenceNumber - The sequence number of the transaction for the sender.
+ * @group Implementation
+ * @category Transactions
+ */
+export function generateUserTransactionHash(args) {
+    const signedTransaction = generateSignedTransaction(args);
+    // Transaction signature is defined as, the domain separated prefix based on struct (Transaction)
+    // Then followed by the type of the transaction for the enum, UserTransaction is 0
+    // Then followed by BCS encoded bytes of the signed transaction
+    return new Hex(hashValues([TRANSACTION_PREFIX, new Uint8Array([0]), signedTransaction])).toString();
+}
+/**
+ * Fetches and caches ABIs while allowing for pass-through on provided ABIs.
+ *
+ * @param key - A unique identifier for the cached ABI.
+ * @param moduleAddress - The address of the module from which to fetch the ABI.
+ * @param moduleName - The name of the module containing the function.
+ * @param functionName - The name of the function whose ABI is being fetched.
+ * @param aptosConfig - Configuration settings for Aptos.
+ * @param abi - An optional ABI to use if already available.
+ * @param fetch - A function to fetch the ABI if it is not provided.
+ * @group Implementation
+ * @category Transactions
+ */
+async function fetchAbi({ key, moduleAddress, moduleName, functionName, aptosConfig, abi, fetch, }) {
+    if (abi !== undefined) {
+        return abi;
+    }
+    // We fetch the entry function ABI, and then pretend that we already had the ABI
+    return memoizeAsync(async () => fetch(moduleAddress, moduleName, functionName, aptosConfig), `${key}-${aptosConfig.network}-${moduleAddress}-${moduleName}-${functionName}`, 1000 * 60 * 5)();
+}
+//# sourceMappingURL=transactionBuilder.js.map

package/dist/transactions/transactionBuilder/transactionBuilder.js.map

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