@aptos-labs/ts-sdk 6.3.1 → 7.0.0

package/dist/transactions/transactionBuilder/remoteAbi.js

@@ -0,0 +1,1088 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+import { parseTypeTag } from "../typeTag/parser.js";
+import { TypeTagAddress, TypeTagBool, TypeTagI128, TypeTagI16, TypeTagI256, TypeTagI32, TypeTagI64, TypeTagI8, TypeTagStruct, TypeTagU128, TypeTagU16, TypeTagU256, TypeTagU32, TypeTagU64, TypeTagU8, } from "../typeTag/index.js";
+import { Bool, FixedBytes, I128, I16, I256, I32, I64, I8, MoveOption, MoveString, MoveVector, U128, U16, U256, U32, U64, U8, } from "../../bcs/index.js";
+import { AccountAddress } from "../../core/index.js";
+import { getModule } from "../../internal/account.js";
+import { findFirstNonSignerArg, isBcsAddress, isBcsBool, isBcsString, isBcsU128, isBcsU16, isBcsU256, isBcsU32, isBcsU64, isBcsU8, isBool, isEncodedEntryFunctionArgument, isLargeNumber, isEmptyOption, isString, throwTypeMismatch, convertNumber, isBcsI8, isBcsI16, isBcsI32, isBcsI64, isBcsI128, isBcsI256, } from "./helpers.js";
+import { warnIfDevelopment } from "../../utils/helpers.js";
+import { memoizeAsync } from "../../utils/memoize.js";
+import { MoveEnumArgument, MoveStructArgument, StructEnumArgumentParser } from "./structEnumParser.js";
+import { TEXT_ENCODER } from "../../utils/index.js";
+/**
+ * Convert type arguments to only type tags, allowing for string representations of type tags.
+ *
+ * @param typeArguments - An optional array of type arguments that may include string representations.
+ * @returns An array of TypeTag objects derived from the provided type arguments.
+ * @group Implementation
+ * @category Transactions
+ */
+export function standardizeTypeTags(typeArguments) {
+    return (typeArguments?.map((typeArg) => {
+        // Convert to TypeTag if it's a string representation
+        if (isString(typeArg)) {
+            return parseTypeTag(typeArg);
+        }
+        return typeArg;
+    }) ?? []);
+}
+/**
+ * Cache TTL for module ABIs in milliseconds (5 minutes).
+ * ABIs rarely change, so a longer cache is acceptable.
+ */
+const MODULE_ABI_CACHE_TTL_MS = 5 * 60 * 1000;
+/**
+ * Extracts all struct type references from a module's struct fields and function parameters.
+ * Returns a set of unique module identifiers (address::moduleName) that need to be fetched.
+ *
+ * @param module - The module to extract struct references from
+ * @returns Set of module IDs referenced by this module (e.g., "0x1::string", "0x123::my_module")
+ */
+function extractReferencedStructModules(module) {
+    const referencedModules = new Set();
+    const moduleId = `${module.address}::${module.name}`;
+    // Helper to parse a type string and extract struct references
+    const parseTypeForStructs = (typeStr) => {
+        // Match patterns like: 0x1::module::Struct, address::module::Struct<T>
+        // Handles generic types and vectors: vector<0x1::module::Struct<T>>
+        const structPattern = /(0x[a-fA-F0-9]+)::([\w_]+)::([\w_]+)/g;
+        let match = structPattern.exec(typeStr);
+        while (match !== null) {
+            const [, address, modName] = match;
+            const refModuleId = `${address}::${modName}`;
+            // Don't include self-references or standard library types that don't need fetching
+            if (refModuleId !== moduleId && !refModuleId.startsWith("0x1::")) {
+                referencedModules.add(refModuleId);
+            }
+            match = structPattern.exec(typeStr);
+        }
+    };
+    // Extract from struct fields
+    for (const struct of module.structs) {
+        for (const field of struct.fields) {
+            parseTypeForStructs(field.type);
+        }
+    }
+    // Extract from function parameters and return types
+    for (const func of module.exposed_functions) {
+        for (const param of func.params) {
+            parseTypeForStructs(param);
+        }
+        for (const ret of func.return) {
+            parseTypeForStructs(ret);
+        }
+    }
+    return referencedModules;
+}
+/**
+ * Fetches the ABI of a specified module from the on-chain module ABI.
+ * Results are cached for 5 minutes to reduce redundant network calls.
+ *
+ * @param moduleAddress - The address of the module from which to fetch the ABI.
+ * @param moduleName - The name of the module containing the ABI.
+ * @param aptosConfig - The configuration settings for Aptos.
+ * @group Implementation
+ * @category Transactions
+ */
+export async function fetchModuleAbi(moduleAddress, moduleName, aptosConfig) {
+    const cacheKey = `module-abi-${aptosConfig.network}-${moduleAddress}-${moduleName}`;
+    return memoizeAsync(async () => {
+        const moduleBytecode = await getModule({ aptosConfig, accountAddress: moduleAddress, moduleName });
+        return moduleBytecode.abi;
+    }, cacheKey, MODULE_ABI_CACHE_TTL_MS)();
+}
+/**
+ * Fetches a module ABI along with all struct ABIs it references.
+ * This optimization minimizes nested network calls when encoding struct/enum arguments.
+ *
+ * Strategy:
+ * - Fetches the main module ABI
+ * - Parses all type references in struct fields and function parameters
+ * - Fetches ABIs for all referenced struct modules in parallel
+ * - Caches the complete bundle together
+ *
+ * @param moduleAddress - The address of the module from which to fetch the ABI.
+ * @param moduleName - The name of the module containing the ABI.
+ * @param aptosConfig - The configuration settings for Aptos.
+ * @returns ModuleAbiBundle containing the module and all referenced struct modules
+ * @group Implementation
+ * @category Transactions
+ */
+export async function fetchModuleAbiWithStructs(moduleAddress, moduleName, aptosConfig) {
+    const cacheKey = `module-abi-bundle-${aptosConfig.network}-${moduleAddress}-${moduleName}`;
+    return memoizeAsync(async () => {
+        // Fetch the main module ABI
+        const module = await fetchModuleAbi(moduleAddress, moduleName, aptosConfig);
+        if (!module) {
+            throw new Error(`Module not found: ${moduleAddress}::${moduleName}`);
+        }
+        // Extract all struct modules referenced by this module
+        const referencedModuleIds = extractReferencedStructModules(module);
+        const referencedStructModules = new Map();
+        // Fetch all referenced struct modules in parallel
+        if (referencedModuleIds.size > 0) {
+            const fetchPromises = Array.from(referencedModuleIds).map(async (moduleId) => {
+                const [addr, modName] = moduleId.split("::");
+                try {
+                    const structModule = await fetchModuleAbi(addr, modName, aptosConfig);
+                    if (structModule) {
+                        referencedStructModules.set(moduleId, structModule);
+                    }
+                }
+                catch {
+                    // Silently ignore fetch failures - the struct might not be used in this execution path
+                    // If it's actually needed, the error will surface during encoding
+                }
+            });
+            await Promise.all(fetchPromises);
+        }
+        return {
+            module,
+            referencedStructModules,
+        };
+    }, cacheKey, MODULE_ABI_CACHE_TTL_MS)();
+}
+/**
+ * Fetches the ABI of a specified function from the on-chain module ABI. This function allows you to access the details of a
+ * specific function within a module.
+ *
+ * @param moduleAddress - The address of the module from which to fetch the function ABI.
+ * @param moduleName - The name of the module containing the function.
+ * @param functionName - The name of the function whose ABI is to be fetched.
+ * @param aptosConfig - The configuration settings for Aptos.
+ * @group Implementation
+ * @category Transactions
+ */
+export async function fetchFunctionAbi(moduleAddress, moduleName, functionName, aptosConfig) {
+    const moduleAbi = await fetchModuleAbi(moduleAddress, moduleName, aptosConfig);
+    if (!moduleAbi)
+        throw new Error(`Could not find module ABI for '${moduleAddress}::${moduleName}'`);
+    return moduleAbi.exposed_functions.find((func) => func.name === functionName);
+}
+/**
+ * @deprecated Use `fetchFunctionAbi` instead and manually parse the type tags.
+ */
+export async function fetchMoveFunctionAbi(moduleAddress, moduleName, functionName, aptosConfig) {
+    const functionAbi = await fetchFunctionAbi(moduleAddress, moduleName, functionName, aptosConfig);
+    if (!functionAbi) {
+        throw new Error(`Could not find function ABI for '${moduleAddress}::${moduleName}::${functionName}'`);
+    }
+    const params = [];
+    for (let i = 0; i < functionAbi.params.length; i += 1) {
+        params.push(parseTypeTag(functionAbi.params[i], { allowGenerics: true }));
+    }
+    return {
+        typeParameters: functionAbi.generic_type_params,
+        parameters: params,
+    };
+}
+/**
+ * Fetches the ABI for an entry function from the specified module address.
+ * This function validates if the ABI corresponds to an entry function and retrieves its parameters.
+ *
+ * @param moduleAddress - The address of the module containing the entry function.
+ * @param moduleName - The name of the module containing the entry function.
+ * @param functionName - The name of the entry function to fetch the ABI for.
+ * @param aptosConfig - The configuration settings for Aptos.
+ * @returns An object containing the number of signers, type parameters, and function parameters.
+ * @throws Error if the ABI cannot be found or if the function is not an entry function.
+ * @group Implementation
+ * @category Transactions
+ */
+export async function fetchEntryFunctionAbi(moduleAddress, moduleName, functionName, aptosConfig) {
+    const functionAbi = await fetchFunctionAbi(moduleAddress, moduleName, functionName, aptosConfig);
+    // If there's no ABI, then the function is invalid
+    if (!functionAbi) {
+        throw new Error(`Could not find entry function ABI for '${moduleAddress}::${moduleName}::${functionName}'`);
+    }
+    // Non-entry functions also can't be used
+    if (!functionAbi.is_entry) {
+        throw new Error(`'${moduleAddress}::${moduleName}::${functionName}' is not an entry function`);
+    }
+    // Remove the signer arguments
+    const numSigners = findFirstNonSignerArg(functionAbi);
+    const params = [];
+    for (let i = numSigners; i < functionAbi.params.length; i += 1) {
+        params.push(parseTypeTag(functionAbi.params[i], { allowGenerics: true }));
+    }
+    return {
+        signers: numSigners,
+        typeParameters: functionAbi.generic_type_params,
+        parameters: params,
+    };
+}
+/**
+ * Fetches the ABI for a view function from the specified module address.
+ * This function ensures that the ABI is valid and retrieves the type parameters, parameters, and return types for the view function.
+ *
+ * @param moduleAddress - The address of the module containing the view function.
+ * @param moduleName - The name of the module containing the view function.
+ * @param functionName - The name of the view function for which to fetch the ABI.
+ * @param aptosConfig - The configuration settings for Aptos.
+ * @returns An object containing the type parameters, parameters, and return types of the view function.
+ * @throws Error if the ABI cannot be found or if the function is not a view function.
+ * @group Implementation
+ * @category Transactions
+ */
+export async function fetchViewFunctionAbi(moduleAddress, moduleName, functionName, aptosConfig) {
+    const functionAbi = await fetchFunctionAbi(moduleAddress, moduleName, functionName, aptosConfig);
+    // If there's no ABI, then the function is invalid
+    if (!functionAbi) {
+        throw new Error(`Could not find view function ABI for '${moduleAddress}::${moduleName}::${functionName}'`);
+    }
+    // Non-view functions can't be used
+    if (!functionAbi.is_view) {
+        throw new Error(`'${moduleAddress}::${moduleName}::${functionName}' is not an view function`);
+    }
+    // Type tag parameters for the function
+    const params = [];
+    for (let i = 0; i < functionAbi.params.length; i += 1) {
+        params.push(parseTypeTag(functionAbi.params[i], { allowGenerics: true }));
+    }
+    // The return types of the view function
+    const returnTypes = [];
+    for (let i = 0; i < functionAbi.return.length; i += 1) {
+        returnTypes.push(parseTypeTag(functionAbi.return[i], { allowGenerics: true }));
+    }
+    return {
+        typeParameters: functionAbi.generic_type_params,
+        parameters: params,
+        returnTypes,
+    };
+}
+/**
+ * Converts a non-BCS encoded argument into BCS encoded, if necessary.
+ * This is the synchronous version that works offline with pre-fetched ABIs.
+ * Does NOT support struct/enum arguments - use convertArgumentWithABI for those.
+ *
+ * @param functionName - The name of the function for which the argument is being converted.
+ * @param functionAbiOrModuleAbi - The ABI (Application Binary Interface) of the function, which defines its parameters.
+ * @param arg - The argument to be converted, which can be of various types.
+ * @param position - The index of the argument in the function's parameter list.
+ * @param genericTypeParams - An array of type tags for any generic type parameters.
+ * @param options - Options for the conversion process.
+ * @param options.allowUnknownStructs - If true, unknown structs will be allowed and converted to a `FixedBytes`.
+ * @group Implementation
+ * @category Transactions
+ */
+export function convertArgument(functionName, functionAbiOrModuleAbi, arg, position, genericTypeParams, options) {
+    let param;
+    if ("exposed_functions" in functionAbiOrModuleAbi) {
+        const functionAbi = functionAbiOrModuleAbi.exposed_functions.find((func) => func.name === functionName);
+        if (!functionAbi) {
+            throw new Error(`Could not find function ABI for '${functionAbiOrModuleAbi.address}::${functionAbiOrModuleAbi.name}::${functionName}'`);
+        }
+        if (position >= functionAbi.params.length) {
+            throw new Error(`Too many arguments for '${functionName}', expected ${functionAbi.params.length}`);
+        }
+        param = parseTypeTag(functionAbi.params[position], { allowGenerics: true });
+    }
+    else {
+        if (position >= functionAbiOrModuleAbi.parameters.length) {
+            throw new Error(`Too many arguments for '${functionName}', expected ${functionAbiOrModuleAbi.parameters.length}`);
+        }
+        param = functionAbiOrModuleAbi.parameters[position];
+    }
+    return checkOrConvertArgument(arg, param, position, genericTypeParams, "exposed_functions" in functionAbiOrModuleAbi ? functionAbiOrModuleAbi : undefined, options);
+}
+/**
+ * Converts a non-BCS encoded argument into BCS encoded, with support for struct/enum arguments.
+ * This is the asynchronous version that fetches module ABIs from the network as needed.
+ *
+ * @param functionName - The name of the function for which the argument is being converted.
+ * @param functionAbiOrModuleAbi - The ABI (Application Binary Interface) of the function, which defines its parameters.
+ * @param arg - The argument to be converted, which can be of various types.
+ * @param position - The index of the argument in the function's parameter list.
+ * @param genericTypeParams - An array of type tags for any generic type parameters.
+ * @param aptosConfig - Aptos configuration for fetching module ABIs (required for struct/enum arguments).
+ * @param options - Options for the conversion process.
+ * @param options.allowUnknownStructs - If true, unknown structs will be allowed and converted to a `FixedBytes`.
+ * @group Implementation
+ * @category Transactions
+ */
+export async function convertArgumentWithABI(functionName, functionAbiOrModuleAbi, arg, position, genericTypeParams, aptosConfig, options) {
+    let param;
+    if ("exposed_functions" in functionAbiOrModuleAbi) {
+        const functionAbi = functionAbiOrModuleAbi.exposed_functions.find((func) => func.name === functionName);
+        if (!functionAbi) {
+            throw new Error(`Could not find function ABI for '${functionAbiOrModuleAbi.address}::${functionAbiOrModuleAbi.name}::${functionName}'`);
+        }
+        if (position >= functionAbi.params.length) {
+            throw new Error(`Too many arguments for '${functionName}', expected ${functionAbi.params.length}`);
+        }
+        param = parseTypeTag(functionAbi.params[position], { allowGenerics: true });
+    }
+    else {
+        if (position >= functionAbiOrModuleAbi.parameters.length) {
+            throw new Error(`Too many arguments for '${functionName}', expected ${functionAbiOrModuleAbi.parameters.length}`);
+        }
+        param = functionAbiOrModuleAbi.parameters[position];
+    }
+    return checkOrConvertArgumentWithABI(arg, param, position, genericTypeParams, aptosConfig, "exposed_functions" in functionAbiOrModuleAbi ? functionAbiOrModuleAbi : undefined, options);
+}
+/**
+ * Checks if the provided argument is BCS encoded and converts it if necessary, ensuring type compatibility with the ABI.
+ * This is the synchronous version that works offline with pre-fetched ABIs.
+ * Does NOT support struct/enum arguments - use checkOrConvertArgumentWithABI for those.
+ *
+ * @param arg - The argument to check or convert, which can be either a simple or entry function argument type.
+ * @param param - The expected type tag for the argument.
+ * @param position - The position of the argument in the function call.
+ * @param genericTypeParams - An array of generic type parameters that may be used for conversion.
+ * @param moduleAbi - The ABI of the module containing the function, used for type checking.
+ * @param options - Options for the conversion process.
+ * @group Implementation
+ * @category Transactions
+ */
+export function checkOrConvertArgument(arg, param, position, genericTypeParams, moduleAbi, options) {
+    // If the argument is bcs encoded, we can just use it directly
+    if (isEncodedEntryFunctionArgument(arg)) {
+        // If the expected type is Option but the arg is not already a MoveOption,
+        // wrap it after validating it matches the Option's inner type.
+        // This handles cases like Vector<Option<address>> where elements may be
+        // passed as AccountAddress instead of MoveOption<AccountAddress>.
+        if (param.isStruct() && param.isOption() && !(arg instanceof MoveOption)) {
+            return new MoveOption(checkOrConvertArgument(arg, param.value.typeArgs[0], position, genericTypeParams, moduleAbi, options));
+        }
+        // Ensure the type matches the ABI
+        checkType(param, arg, position);
+        return arg;
+    }
+    // If it is not BCS encoded, we will need to convert it with the ABI
+    return parseArgSync(arg, param, position, genericTypeParams, moduleAbi, options);
+}
+/**
+ * Checks if the provided argument is BCS encoded and converts it if necessary, with support for struct/enum arguments.
+ * This is the asynchronous version that fetches module ABIs from the network as needed.
+ *
+ * @param arg - The argument to check or convert, which can be either a simple or entry function argument type.
+ * @param param - The expected type tag for the argument.
+ * @param position - The position of the argument in the function call.
+ * @param genericTypeParams - An array of generic type parameters that may be used for conversion.
+ * @param aptosConfig - Aptos configuration for fetching module ABIs (required for struct/enum arguments).
+ * @param moduleAbi - The ABI of the module containing the function, used for type checking.
+ * @param options - Options for the conversion process.
+ * @group Implementation
+ * @category Transactions
+ */
+export async function checkOrConvertArgumentWithABI(arg, param, position, genericTypeParams, aptosConfig, moduleAbi, options) {
+    // If the argument is bcs encoded, we can just use it directly
+    if (isEncodedEntryFunctionArgument(arg)) {
+        // If the expected type is Option but the arg is not already a MoveOption,
+        // wrap it after validating it matches the Option's inner type. This mirrors
+        // the behavior of the synchronous `checkOrConvertArgument` path so that
+        // pre-encoded inner values (e.g. AccountAddress inside Vector<Option<address>>)
+        // can be passed through the async path as well.
+        if (param.isStruct() && param.isOption() && !(arg instanceof MoveOption)) {
+            const inner = await checkOrConvertArgumentWithABI(arg, param.value.typeArgs[0], position, genericTypeParams, aptosConfig, moduleAbi, options);
+            return new MoveOption(inner);
+        }
+        // Ensure the type matches the ABI
+        checkType(param, arg, position);
+        return arg;
+    }
+    // If it is not BCS encoded, we will need to convert it with the ABI
+    return parseArgAsync(arg, param, position, genericTypeParams, aptosConfig, moduleAbi, options);
+}
+/**
+ * Parses a non-BCS encoded argument into a BCS encoded argument recursively.
+ * This is the synchronous version that works offline with pre-fetched ABIs.
+ * Does NOT support struct/enum arguments - throws error if encountered.
+ *
+ * @param arg - The argument to be parsed, which can be of various types.
+ * @param param - The type tag that defines the expected type of the argument.
+ * @param position - The position of the argument in the function call, used for error reporting.
+ * @param genericTypeParams - An array of type tags for generic type parameters, used when the parameter type is generic.
+ * @param moduleAbi - The ABI of the module containing the function, used for type checking.
+ * @param options - Options for the conversion process.
+ * @param options.allowUnknownStructs - If true, unknown structs will be allowed and converted to a `FixedBytes`.
+ * @group Implementation
+ * @category Transactions
+ */
+function parseArgSync(arg, param, position, genericTypeParams, moduleAbi, options) {
+    if (param.isBool()) {
+        if (isBool(arg)) {
+            return new Bool(arg);
+        }
+        if (isString(arg)) {
+            if (arg === "true")
+                return new Bool(true);
+            if (arg === "false")
+                return new Bool(false);
+        }
+        throwTypeMismatch("boolean", position);
+    }
+    if (param.isAddress()) {
+        if (isString(arg)) {
+            return AccountAddress.fromString(arg);
+        }
+        // Support for Uint8Array coming from external sources
+        if (arg && typeof arg === "object" && "data" in arg && arg.data instanceof Uint8Array) {
+            return new AccountAddress(arg.data);
+        }
+        throwTypeMismatch("string | AccountAddress", position);
+    }
+    if (param.isU8()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new U8(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isU16()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new U16(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isU32()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new U32(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isU64()) {
+        if (isLargeNumber(arg)) {
+            return new U64(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    if (param.isU128()) {
+        if (isLargeNumber(arg)) {
+            return new U128(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    if (param.isU256()) {
+        if (isLargeNumber(arg)) {
+            return new U256(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    if (param.isI8()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new I8(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isI16()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new I16(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isI32()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new I32(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isI64()) {
+        if (isLargeNumber(arg)) {
+            return new I64(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    if (param.isI128()) {
+        if (isLargeNumber(arg)) {
+            return new I128(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    if (param.isI256()) {
+        if (isLargeNumber(arg)) {
+            return new I256(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    // Generic needs to use the subtype
+    if (param.isGeneric()) {
+        const genericIndex = param.value;
+        if (genericIndex < 0 || genericIndex >= genericTypeParams.length) {
+            throw new Error(`Generic argument ${param.toString()} is invalid for argument ${position}`);
+        }
+        return checkOrConvertArgument(arg, genericTypeParams[genericIndex], position, genericTypeParams, moduleAbi, options);
+    }
+    // We have to special case some vectors for Vector<u8>
+    if (param.isVector()) {
+        // Check special case for Vector<u8>
+        if (param.value.isU8()) {
+            if (isString(arg)) {
+                return MoveVector.U8(TEXT_ENCODER.encode(arg));
+            }
+            if (arg instanceof Uint8Array) {
+                return MoveVector.U8(arg);
+            }
+            if (arg instanceof ArrayBuffer) {
+                return MoveVector.U8(new Uint8Array(arg));
+            }
+        }
+        if (isString(arg)) {
+            // In a web env, arguments are passing as strings
+            if (arg.startsWith("[")) {
+                return checkOrConvertArgument(JSON.parse(arg), param, position, genericTypeParams, moduleAbi, options);
+            }
+        }
+        if (Array.isArray(arg)) {
+            return new MoveVector(arg.map((item) => checkOrConvertArgument(item, param.value, position, genericTypeParams, moduleAbi, options)));
+        }
+        throw new Error(`Type mismatch for argument ${position}, type '${param.toString()}'`);
+    }
+    // Handle structs as they're more complex
+    if (param.isStruct()) {
+        if (param.isString()) {
+            if (isString(arg)) {
+                return new MoveString(arg);
+            }
+            throwTypeMismatch("string", position);
+        }
+        if (param.isObject()) {
+            // The inner type of Object doesn't matter, since it's just syntactic sugar
+            if (isString(arg)) {
+                return AccountAddress.fromString(arg);
+            }
+            // Support for Uint8Array coming from external sources
+            if (arg && typeof arg === "object" && "data" in arg && arg.data instanceof Uint8Array) {
+                return new AccountAddress(arg.data);
+            }
+            throwTypeMismatch("string | AccountAddress", position);
+        }
+        // Handle known enum types from Aptos framework
+        if (param.isDelegationKey() || param.isRateLimiter()) {
+            if (arg instanceof Uint8Array) {
+                return new FixedBytes(arg);
+            }
+            throwTypeMismatch("Uint8Array", position);
+        }
+        if (param.isOption()) {
+            if (isEmptyOption(arg)) {
+                // Here we attempt to reconstruct the underlying type
+                const innerParam = param.value.typeArgs[0];
+                if (innerParam instanceof TypeTagBool) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagAddress) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU8) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU16) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU32) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU64) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU128) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU256) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI8) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI16) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI32) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI64) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI128) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI256) {
+                    return new MoveOption(null);
+                }
+                // In all other cases, we will use a placeholder
+                return new MoveOption(null);
+            }
+            return new MoveOption(checkOrConvertArgument(arg, param.value.typeArgs[0], position, genericTypeParams, moduleAbi));
+        }
+        // Check if this looks like a custom struct/enum argument
+        if (typeof arg === "object" &&
+            arg !== null &&
+            !(arg instanceof Uint8Array) &&
+            !(arg instanceof ArrayBuffer) &&
+            !Array.isArray(arg)) {
+            // Struct/enum arguments require async conversion
+            throw new Error(`Struct/enum arguments require async conversion. ` +
+                `Use checkOrConvertArgumentWithABI() instead, or pre-encode the argument with StructEnumArgumentParser. ` +
+                `Type: '${param.toString()}', position: ${position}`);
+        }
+        // We are assuming that fieldless structs are enums
+        const structDefinition = moduleAbi?.structs.find((s) => s.name === param.value.name.identifier);
+        if (structDefinition?.fields.length === 0 && arg instanceof Uint8Array) {
+            return new FixedBytes(arg);
+        }
+        if (arg instanceof Uint8Array && options?.allowUnknownStructs) {
+            warnIfDevelopment(`[Aptos SDK] Unsupported struct input type for argument ${position}. Continuing since 'allowUnknownStructs' is enabled.`);
+            return new FixedBytes(arg);
+        }
+        throw new Error(`Unsupported struct input type for argument ${position}, type '${param.toString()}'`);
+    }
+    throw new Error(`Type mismatch for argument ${position}, type '${param.toString()}'`);
+}
+/**
+ * Parses a non-BCS encoded argument into a BCS encoded argument recursively.
+ * This is the asynchronous version that supports struct/enum arguments via network calls.
+ *
+ * @param arg - The argument to be parsed, which can be of various types.
+ * @param param - The type tag that defines the expected type of the argument.
+ * @param position - The position of the argument in the function call, used for error reporting.
+ * @param genericTypeParams - An array of type tags for generic type parameters, used when the parameter type is generic.
+ * @param aptosConfig - Aptos configuration for fetching module ABIs (required for struct/enum arguments).
+ * @param moduleAbi - The ABI of the module containing the function, used for type checking.
+ * @param options - Options for the conversion process.
+ * @param options.allowUnknownStructs - If true, unknown structs will be allowed and converted to a `FixedBytes`.
+ * @group Implementation
+ * @category Transactions
+ */
+async function parseArgAsync(arg, param, position, genericTypeParams, aptosConfig, moduleAbi, options) {
+    if (param.isBool()) {
+        if (isBool(arg)) {
+            return new Bool(arg);
+        }
+        if (isString(arg)) {
+            if (arg === "true")
+                return new Bool(true);
+            if (arg === "false")
+                return new Bool(false);
+        }
+        /**
+         * Throws a type mismatch error for the specified move option.
+         *
+         * @param moveOption - The name of the move option that caused the type mismatch.
+         * @param position - The position where the error occurred.
+         * @group Implementation
+         * @category Transactions
+         */
+        throwTypeMismatch("boolean", position);
+    }
+    if (param.isAddress()) {
+        if (isString(arg)) {
+            return AccountAddress.fromString(arg);
+        }
+        // Support for Uint8Array coming from external sources
+        // Usually, dapps will be getting the account address as a Uint8Array from the wallet (following
+        // the wallet standard).
+        if (arg && typeof arg === "object" && "data" in arg && arg.data instanceof Uint8Array) {
+            return new AccountAddress(arg.data);
+        }
+        throwTypeMismatch("string | AccountAddress", position);
+    }
+    if (param.isU8()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new U8(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isU16()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new U16(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isU32()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new U32(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isU64()) {
+        if (isLargeNumber(arg)) {
+            return new U64(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    if (param.isU128()) {
+        if (isLargeNumber(arg)) {
+            return new U128(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    if (param.isU256()) {
+        if (isLargeNumber(arg)) {
+            return new U256(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    if (param.isI8()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new I8(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isI16()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new I16(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isI32()) {
+        const num = convertNumber(arg);
+        if (num !== undefined) {
+            return new I32(num);
+        }
+        throwTypeMismatch("number | string", position);
+    }
+    if (param.isI64()) {
+        if (isLargeNumber(arg)) {
+            return new I64(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    if (param.isI128()) {
+        if (isLargeNumber(arg)) {
+            return new I128(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    if (param.isI256()) {
+        if (isLargeNumber(arg)) {
+            return new I256(BigInt(arg));
+        }
+        throwTypeMismatch("bigint | number | string", position);
+    }
+    // Generic needs to use the subtype
+    if (param.isGeneric()) {
+        const genericIndex = param.value;
+        if (genericIndex < 0 || genericIndex >= genericTypeParams.length) {
+            throw new Error(`Generic argument ${param.toString()} is invalid for argument ${position}`);
+        }
+        return checkOrConvertArgumentWithABI(arg, genericTypeParams[genericIndex], position, genericTypeParams, aptosConfig, moduleAbi, options);
+    }
+    // We have to special case some vectors for Vector<u8>
+    if (param.isVector()) {
+        // Check special case for Vector<u8>
+        if (param.value.isU8()) {
+            // We don't allow vector<u8>, but we convert strings to UTF8 Uint8Array
+            // This is legacy behavior from the original SDK
+            if (isString(arg)) {
+                return MoveVector.U8(TEXT_ENCODER.encode(arg));
+            }
+            if (arg instanceof Uint8Array) {
+                return MoveVector.U8(arg);
+            }
+            if (arg instanceof ArrayBuffer) {
+                return MoveVector.U8(new Uint8Array(arg));
+            }
+        }
+        if (isString(arg)) {
+            // In a web env, arguments are passing as strings
+            if (arg.startsWith("[")) {
+                return checkOrConvertArgumentWithABI(JSON.parse(arg), param, position, genericTypeParams, aptosConfig, moduleAbi, options);
+            }
+        }
+        // TODO: Support Uint16Array, Uint32Array, BigUint64Array?
+        if (Array.isArray(arg)) {
+            const elements = await Promise.all(arg.map((item) => checkOrConvertArgumentWithABI(item, param.value, position, genericTypeParams, aptosConfig, moduleAbi, options)));
+            return new MoveVector(elements);
+        }
+        throw new Error(`Type mismatch for argument ${position}, type '${param.toString()}'`);
+    }
+    // Handle structs as they're more complex
+    if (param.isStruct()) {
+        if (param.isString()) {
+            if (isString(arg)) {
+                return new MoveString(arg);
+            }
+            throwTypeMismatch("string", position);
+        }
+        if (param.isObject()) {
+            // The inner type of Object doesn't matter, since it's just syntactic sugar
+            if (isString(arg)) {
+                return AccountAddress.fromString(arg);
+            }
+            // Support for Uint8Array coming from external sources
+            if (arg && typeof arg === "object" && "data" in arg && arg.data instanceof Uint8Array) {
+                return new AccountAddress(arg.data);
+            }
+            throwTypeMismatch("string | AccountAddress", position);
+        }
+        // Handle known enum types from Aptos framework
+        if (param.isDelegationKey() || param.isRateLimiter()) {
+            if (arg instanceof Uint8Array) {
+                return new FixedBytes(arg);
+            }
+            throwTypeMismatch("Uint8Array", position);
+        }
+        if (param.isOption()) {
+            if (isEmptyOption(arg)) {
+                // Here we attempt to reconstruct the underlying type
+                // Note, for some reason the `isBool` etc. does not work with the compiler
+                const innerParam = param.value.typeArgs[0];
+                if (innerParam instanceof TypeTagBool) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagAddress) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU8) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU16) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU32) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU64) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU128) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagU256) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI8) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI16) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI32) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI64) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI128) {
+                    return new MoveOption(null);
+                }
+                if (innerParam instanceof TypeTagI256) {
+                    return new MoveOption(null);
+                }
+                // In all other cases, we will use a placeholder, it doesn't actually matter what the type is, but it will be obvious
+                // Note: This is a placeholder U8 type, and does not match the actual type, as that can't be dynamically grabbed
+                return new MoveOption(null);
+            }
+            const value = await checkOrConvertArgumentWithABI(arg, param.value.typeArgs[0], position, genericTypeParams, aptosConfig, moduleAbi);
+            return new MoveOption(value);
+        }
+        // Handle custom public copy structs and enums
+        if (typeof arg === "object" &&
+            arg !== null &&
+            !(arg instanceof Uint8Array) &&
+            !(arg instanceof ArrayBuffer) &&
+            !Array.isArray(arg)) {
+            // Check if aptosConfig is available for fetching module ABI
+            if (!aptosConfig) {
+                throw new Error(`AptosConfig required for struct/enum argument at position ${position}. ` +
+                    `Type: '${param.toString()}'. ` +
+                    `Either provide aptosConfig, or pre-encode the argument as a ` +
+                    `MoveStructArgument / MoveEnumArgument (preferred) or as FixedBytes ` +
+                    `containing the BCS-encoded value.`);
+            }
+            // Fetch the module ABI bundle with all referenced struct modules
+            // This optimization minimizes nested network calls
+            const moduleAddress = param.value.address.toString();
+            const moduleName = param.value.moduleName.identifier;
+            try {
+                const abiBundle = await fetchModuleAbiWithStructs(moduleAddress, moduleName, aptosConfig);
+                // Instantiate the parser and preload it with all referenced struct modules
+                const parser = new StructEnumArgumentParser(aptosConfig);
+                // Convert the bundle's modules to MoveModuleBytecode format for preloading
+                const modulesToPreload = new Map();
+                modulesToPreload.set(`${moduleAddress}::${moduleName}`, { abi: abiBundle.module });
+                for (const [moduleId, module] of abiBundle.referencedStructModules.entries()) {
+                    modulesToPreload.set(moduleId, { abi: module });
+                }
+                parser.preloadModules(modulesToPreload);
+                // Check the ABI to determine if this is an enum or struct
+                const structDef = abiBundle.module.structs.find((s) => s.name === param.value.name.identifier);
+                let isEnumType;
+                if (structDef !== undefined) {
+                    // Trust the ABI when available
+                    isEnumType = structDef.is_enum;
+                }
+                else {
+                    // Fallback heuristic when ABI is not available:
+                    // Enums typically have format: { "VariantName": {...} } with a single key
+                    const keys = Object.keys(arg);
+                    isEnumType = keys.length === 1 && typeof arg[keys[0]] === "object";
+                }
+                if (isEnumType) {
+                    // Encode as enum
+                    return await parser.encodeEnumArgument(param, arg);
+                }
+                // Encode as struct
+                return await parser.encodeStructArgument(param, arg);
+            }
+            catch (e) {
+                throw new Error(`Failed to encode struct/enum argument at position ${position}, type '${param.toString()}': ${e.message}`);
+            }
+        }
+        // We are assuming that fieldless structs are enums, and therefore we cannot typecheck any further due
+        // to limited information from the ABI. This does not work for structs on other modules.
+        const structDefinition = moduleAbi?.structs.find((s) => s.name === param.value.name.identifier);
+        if (structDefinition?.fields.length === 0 && arg instanceof Uint8Array) {
+            return new FixedBytes(arg);
+        }
+        if (arg instanceof Uint8Array && options?.allowUnknownStructs) {
+            warnIfDevelopment(`[Aptos SDK] Unsupported struct input type for argument ${position}. Continuing since 'allowUnknownStructs' is enabled.`);
+            return new FixedBytes(arg);
+        }
+        throw new Error(`Unsupported struct input type for argument ${position}, type '${param.toString()}'`);
+    }
+    throw new Error(`Type mismatch for argument ${position}, type '${param.toString()}'`);
+}
+/**
+ * Checks that the type of the BCS encoded argument matches the ABI
+ * @param param
+ * @param arg
+ * @param position
+ * @group Implementation
+ * @category Transactions
+ */
+function checkType(param, arg, position) {
+    if (param.isBool()) {
+        if (isBcsBool(arg)) {
+            return;
+        }
+        throwTypeMismatch("Bool", position);
+    }
+    if (param.isAddress()) {
+        if (isBcsAddress(arg)) {
+            return;
+        }
+        throwTypeMismatch("AccountAddress", position);
+    }
+    if (param.isU8()) {
+        if (isBcsU8(arg)) {
+            return;
+        }
+        throwTypeMismatch("U8", position);
+    }
+    if (param.isU16()) {
+        if (isBcsU16(arg)) {
+            return;
+        }
+        throwTypeMismatch("U16", position);
+    }
+    if (param.isU32()) {
+        if (isBcsU32(arg)) {
+            return;
+        }
+        throwTypeMismatch("U32", position);
+    }
+    if (param.isU64()) {
+        if (isBcsU64(arg)) {
+            return;
+        }
+        throwTypeMismatch("U64", position);
+    }
+    if (param.isU128()) {
+        if (isBcsU128(arg)) {
+            return;
+        }
+        throwTypeMismatch("U128", position);
+    }
+    if (param.isU256()) {
+        if (isBcsU256(arg)) {
+            return;
+        }
+        throwTypeMismatch("U256", position);
+    }
+    if (param.isI8()) {
+        if (isBcsI8(arg)) {
+            return;
+        }
+        throwTypeMismatch("I8", position);
+    }
+    if (param.isI16()) {
+        if (isBcsI16(arg)) {
+            return;
+        }
+        throwTypeMismatch("I16", position);
+    }
+    if (param.isI32()) {
+        if (isBcsI32(arg)) {
+            return;
+        }
+        throwTypeMismatch("I32", position);
+    }
+    if (param.isI64()) {
+        if (isBcsI64(arg)) {
+            return;
+        }
+        throwTypeMismatch("I64", position);
+    }
+    if (param.isI128()) {
+        if (isBcsI128(arg)) {
+            return;
+        }
+        throwTypeMismatch("I128", position);
+    }
+    if (param.isI256()) {
+        if (isBcsI256(arg)) {
+            return;
+        }
+        throwTypeMismatch("I256", position);
+    }
+    if (param.isVector()) {
+        if (arg instanceof MoveVector) {
+            // If there's anything in it, check that the inner types match
+            // Note that since it's typed, the first item should be the same as the rest
+            if (arg.values.length > 0) {
+                checkType(param.value, arg.values[0], position);
+            }
+            return;
+        }
+        throwTypeMismatch("MoveVector", position);
+    }
+    // Handle structs as they're more complex
+    if (param instanceof TypeTagStruct) {
+        if (param.isString()) {
+            if (isBcsString(arg)) {
+                return;
+            }
+            throwTypeMismatch("MoveString", position);
+        }
+        if (param.isObject()) {
+            if (isBcsAddress(arg)) {
+                return;
+            }
+            throwTypeMismatch("AccountAddress", position);
+        }
+        if (param.isOption()) {
+            if (arg instanceof MoveOption) {
+                // If there's a value, we can check the inner type (otherwise it doesn't really matter)
+                if (arg.value !== undefined) {
+                    checkType(param.value.typeArgs[0], arg.value, position);
+                }
+                return;
+            }
+            throwTypeMismatch("MoveOption", position);
+        }
+        // For custom (non-framework) struct/enum params, accept the pre-encoded
+        // argument types: MoveStructArgument, MoveEnumArgument, or FixedBytes.
+        // We cannot fully verify the inner BCS bytes without the ABI, but accepting
+        // these classes is safer than rejecting valid pre-encoded inputs and is
+        // required for documented "pre-encode and pass" flows.
+        if (arg instanceof MoveStructArgument || arg instanceof MoveEnumArgument || arg instanceof FixedBytes) {
+            return;
+        }
+        throwTypeMismatch("MoveStructArgument | MoveEnumArgument | FixedBytes", position);
+    }
+    throw new Error(`Type mismatch for argument ${position}, expected '${param.toString()}'`);
+}
+//# sourceMappingURL=remoteAbi.js.map