@aptos-labs/ts-sdk 6.3.0 → 7.0.0

package/dist/transactions/instances/encryptedPayload.js

@@ -0,0 +1,122 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+import { sha3_256 as sha3Hash } from "@noble/hashes/sha3.js";
+import { Serializable } from "../../bcs/serializer.js";
+import { AccountAddress } from "../../core/index.js";
+import { AuthenticationKey } from "../../core/authenticationKey.js";
+import { Identifier } from "./identifier.js";
+import { ModuleId } from "./moduleId.js";
+import { TransactionExecutable } from "./transactionPayload.js";
+/** 16-byte decryption nonce for encrypted payloads (aptos-core `DecryptionNonce`). */
+export const DECRYPTION_NONCE_LENGTH = 16;
+const DECRYPTED_PLAINTEXT_SALT = sha3Hash(new TextEncoder().encode("APTOS::DecryptedPlaintext"));
+/**
+ * Optional claim about the entry function inside an encrypted payload (`claimed_entry_fun` in aptos-core).
+ * Lets fee payers and multisig co-signers see module and optionally function name without decrypting.
+ *
+ * BCS: `module: ModuleId` then `function: Option<Identifier>`. The REST API renames the optional field to `name`.
+ */
+export class ClaimedEntryFunction extends Serializable {
+    moduleId;
+    /** BCS/Rust `function`; JSON API field is `name`. */
+    functionName;
+    constructor(moduleId, functionName) {
+        super();
+        this.moduleId = moduleId;
+        this.functionName = functionName;
+    }
+    serialize(serializer) {
+        this.moduleId.serialize(serializer);
+        serializer.serializeOption(this.functionName);
+    }
+    static deserialize(deserializer) {
+        const moduleId = ModuleId.deserialize(deserializer);
+        const functionName = deserializer.deserializeOption(Identifier);
+        return new ClaimedEntryFunction(moduleId, functionName);
+    }
+    /**
+     * @param includeFunctionName - When false, only the module is claimed (`Option::None` for function on wire).
+     */
+    static fromEntryFunction(entry, opts) {
+        const includeFunctionName = opts?.includeFunctionName !== false;
+        return new ClaimedEntryFunction(entry.module_name, includeFunctionName ? entry.function_name : undefined);
+    }
+}
+/**
+ * BCS-serializable `DecryptedPlaintext`. Built client-side before encrypting; its BCS hash becomes `payload_hash`.
+ * Matches Rust: `DecryptedPlaintext { executable, decryption_nonce: [u8; 16] }`.
+ */
+export class DecryptedPlaintext extends Serializable {
+    executable;
+    decryptionNonce;
+    constructor(executable, decryptionNonce) {
+        super();
+        if (decryptionNonce.length !== DECRYPTION_NONCE_LENGTH) {
+            throw new Error(`decryptionNonce must be ${DECRYPTION_NONCE_LENGTH} bytes`);
+        }
+        this.executable = executable;
+        this.decryptionNonce = decryptionNonce;
+    }
+    serialize(serializer) {
+        this.executable.serialize(serializer);
+        serializer.serializeFixedBytes(this.decryptionNonce);
+    }
+    static deserialize(deserializer) {
+        const executable = TransactionExecutable.deserialize(deserializer);
+        const decryptionNonce = deserializer.deserializeFixedBytes(DECRYPTION_NONCE_LENGTH);
+        return new DecryptedPlaintext(executable, decryptionNonce);
+    }
+    /**
+     * Domain-separated BCS crypto hash (`BCSCryptoHash` in aptos-core):
+     * SHA3-256( SHA3-256("APTOS::DecryptedPlaintext") || BCS(self) ).
+     */
+    hash() {
+        const h = sha3Hash.create();
+        h.update(DECRYPTED_PLAINTEXT_SALT);
+        h.update(this.bcsToBytes());
+        return h.digest();
+    }
+}
+const PAYLOAD_ASSOCIATED_DATA_V1 = 0;
+/**
+ * AAD for batch-encrypted transaction payloads. BCS matches Rust `PayloadAssociatedData::V1`:
+ * uleb128 variant | `sender` | `Vec<(AccountAddress, AuthenticationKey)>`.
+ */
+export class PayloadAssociatedData extends Serializable {
+    sender;
+    signerAuthKeys;
+    constructor(sender, signerAuthKeys) {
+        super();
+        this.sender = sender;
+        this.signerAuthKeys = signerAuthKeys;
+        if (signerAuthKeys.length === 0) {
+            throw new Error("PayloadAssociatedData requires at least one signer auth key pair");
+        }
+    }
+    serialize(serializer) {
+        serializer.serializeU32AsUleb128(PAYLOAD_ASSOCIATED_DATA_V1);
+        this.sender.serialize(serializer);
+        serializer.serializeU32AsUleb128(this.signerAuthKeys.length);
+        for (const { address, authenticationKey } of this.signerAuthKeys) {
+            address.serialize(serializer);
+            authenticationKey.serialize(serializer);
+        }
+    }
+    static deserialize(deserializer) {
+        const variant = deserializer.deserializeUleb128AsU32();
+        if (variant !== PAYLOAD_ASSOCIATED_DATA_V1) {
+            throw new Error(`Unknown PayloadAssociatedData variant: ${variant}`);
+        }
+        const sender = AccountAddress.deserialize(deserializer);
+        const len = deserializer.deserializeUleb128AsU32();
+        const signerAuthKeys = [];
+        for (let i = 0; i < len; i += 1) {
+            signerAuthKeys.push({
+                address: AccountAddress.deserialize(deserializer),
+                authenticationKey: AuthenticationKey.deserialize(deserializer),
+            });
+        }
+        return new PayloadAssociatedData(sender, signerAuthKeys);
+    }
+}
+//# sourceMappingURL=encryptedPayload.js.map

package/dist/transactions/instances/encryptedPayload.js.map

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

package/dist/transactions/instances/identifier.d.ts

@@ -0,0 +1,40 @@
+import { Deserializer } from "../../bcs/deserializer.js";
+import { Serializable, Serializer } from "../../bcs/serializer.js";
+/**
+ * Represents an Identifier that can be serialized and deserialized.
+ * This class is used to denote the module "name" in "ModuleId" and
+ * the "function name" in "EntryFunction".
+ *
+ * @extends Serializable
+ * @group Implementation
+ * @category Transactions
+ */
+export declare class Identifier extends Serializable {
+    identifier: string;
+    /**
+     * Creates an instance of the class with a specified identifier.
+     *
+     * @param identifier - The unique identifier for the instance.
+     * @group Implementation
+     * @category Transactions
+     */
+    constructor(identifier: string);
+    /**
+     * Serializes the identifier of the current instance using the provided serializer.
+     *
+     * @param serializer - The serializer instance used to perform the serialization.
+     * @group Implementation
+     * @category Transactions
+     */
+    serialize(serializer: Serializer): void;
+    /**
+     * Deserializes an identifier from the provided deserializer.
+     * This function is useful for reconstructing an Identifier object from a serialized format.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static deserialize(deserializer: Deserializer): Identifier;
+}
+//# sourceMappingURL=identifier.d.ts.map

package/dist/transactions/instances/identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../../src/transactions/instances/identifier.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;;;;;GAQG;AACH,qBAAa,UAAW,SAAQ,YAAY;IACnC,UAAU,EAAE,MAAM,CAAC;IAE1B;;;;;;OAMG;gBACS,UAAU,EAAE,MAAM;IAK9B;;;;;;OAMG;IACI,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAI9C;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,UAAU;CAI3D"}

package/dist/transactions/instances/identifier.js

@@ -0,0 +1,49 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+import { Serializable } from "../../bcs/serializer.js";
+/**
+ * Represents an Identifier that can be serialized and deserialized.
+ * This class is used to denote the module "name" in "ModuleId" and
+ * the "function name" in "EntryFunction".
+ *
+ * @extends Serializable
+ * @group Implementation
+ * @category Transactions
+ */
+export class Identifier extends Serializable {
+    identifier;
+    /**
+     * Creates an instance of the class with a specified identifier.
+     *
+     * @param identifier - The unique identifier for the instance.
+     * @group Implementation
+     * @category Transactions
+     */
+    constructor(identifier) {
+        super();
+        this.identifier = identifier;
+    }
+    /**
+     * Serializes the identifier of the current instance using the provided serializer.
+     *
+     * @param serializer - The serializer instance used to perform the serialization.
+     * @group Implementation
+     * @category Transactions
+     */
+    serialize(serializer) {
+        serializer.serializeStr(this.identifier);
+    }
+    /**
+     * Deserializes an identifier from the provided deserializer.
+     * This function is useful for reconstructing an Identifier object from a serialized format.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static deserialize(deserializer) {
+        const identifier = deserializer.deserializeStr();
+        return new Identifier(identifier);
+    }
+}
+//# sourceMappingURL=identifier.js.map

package/dist/transactions/instances/identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../../src/transactions/instances/identifier.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sCAAsC;AAGtC,OAAO,EAAE,YAAY,EAAc,MAAM,yBAAyB,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAW,SAAQ,YAAY;IACnC,UAAU,CAAS;IAE1B;;;;;;OAMG;IACH,YAAY,UAAkB;QAC5B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACI,SAAS,CAAC,UAAsB;QACrC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,YAA0B;QAC3C,MAAM,UAAU,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC;QACjD,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/transactions/instances/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./chainId.js";
+export * from "./identifier.js";
+export * from "./moduleId.js";
+export * from "./rawTransaction.js";
+export * from "./rotationProofChallenge.js";
+export * from "./signedTransaction.js";
+export * from "./transactionArgument.js";
+export * from "./transactionPayload.js";
+export * from "./encryptedPayload.js";
+export * from "./simpleTransaction.js";
+export * from "./multiAgentTransaction.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/transactions/instances/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transactions/instances/index.ts"],"names":[],"mappings":"AAGA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}

package/dist/transactions/instances/index.js

@@ -0,0 +1,14 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+export * from "./chainId.js";
+export * from "./identifier.js";
+export * from "./moduleId.js";
+export * from "./rawTransaction.js";
+export * from "./rotationProofChallenge.js";
+export * from "./signedTransaction.js";
+export * from "./transactionArgument.js";
+export * from "./transactionPayload.js";
+export * from "./encryptedPayload.js";
+export * from "./simpleTransaction.js";
+export * from "./multiAgentTransaction.js";
+//# sourceMappingURL=index.js.map

package/dist/transactions/instances/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transactions/instances/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sCAAsC;AAEtC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}

package/dist/transactions/instances/moduleId.d.ts

@@ -0,0 +1,52 @@
+import { Serializable, Serializer } from "../../bcs/serializer.js";
+import { Deserializer } from "../../bcs/deserializer.js";
+import { AccountAddress } from "../../core/index.js";
+import { Identifier } from "./identifier.js";
+import { MoveModuleId } from "../../types/index.js";
+/**
+ * Represents a ModuleId that can be serialized and deserialized.
+ * A ModuleId consists of a module address (e.g., "0x1") and a module name (e.g., "coin").
+ * @group Implementation
+ * @category Transactions
+ */
+export declare class ModuleId extends Serializable {
+    readonly address: AccountAddress;
+    readonly name: Identifier;
+    /**
+     * Initializes a new instance of the module with the specified account address and name.
+     *
+     * @param address - The account address, e.g., "0x1".
+     * @param name - The module name under the specified address, e.g., "coin".
+     * @group Implementation
+     * @category Transactions
+     */
+    constructor(address: AccountAddress, name: Identifier);
+    /**
+     * Converts a string literal in the format "account_address::module_name" to a ModuleId.
+     * @param moduleId - A string literal representing the module identifier.
+     * @throws Error if the provided moduleId is not in the correct format.
+     * @returns ModuleId - The corresponding ModuleId object.
+     * @group Implementation
+     * @category Transactions
+     */
+    static fromStr(moduleId: MoveModuleId): ModuleId;
+    /**
+     * Serializes the address and name properties using the provided serializer.
+     * This function is essential for converting the object's data into a format suitable for transmission or storage.
+     *
+     * @param serializer - The serializer instance used to perform the serialization.
+     * @group Implementation
+     * @category Transactions
+     */
+    serialize(serializer: Serializer): void;
+    /**
+     * Deserializes a ModuleId from the provided deserializer.
+     * This function retrieves the account address and identifier to construct a ModuleId instance.
+     *
+     * @param deserializer - The deserializer instance used to read the data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static deserialize(deserializer: Deserializer): ModuleId;
+}
+//# sourceMappingURL=moduleId.d.ts.map

package/dist/transactions/instances/moduleId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleId.d.ts","sourceRoot":"","sources":["../../../src/transactions/instances/moduleId.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,YAAY;IACxC,SAAgB,OAAO,EAAE,cAAc,CAAC;IAExC,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC;;;;;;;OAOG;gBACS,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU;IAMrD;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,QAAQ;IAQhD;;;;;;;OAOG;IACH,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKvC;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ;CAKzD"}

package/dist/transactions/instances/moduleId.js

@@ -0,0 +1,69 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+import { Serializable } from "../../bcs/serializer.js";
+import { AccountAddress } from "../../core/index.js";
+import { Identifier } from "./identifier.js";
+/**
+ * Represents a ModuleId that can be serialized and deserialized.
+ * A ModuleId consists of a module address (e.g., "0x1") and a module name (e.g., "coin").
+ * @group Implementation
+ * @category Transactions
+ */
+export class ModuleId extends Serializable {
+    address;
+    name;
+    /**
+     * Initializes a new instance of the module with the specified account address and name.
+     *
+     * @param address - The account address, e.g., "0x1".
+     * @param name - The module name under the specified address, e.g., "coin".
+     * @group Implementation
+     * @category Transactions
+     */
+    constructor(address, name) {
+        super();
+        this.address = address;
+        this.name = name;
+    }
+    /**
+     * Converts a string literal in the format "account_address::module_name" to a ModuleId.
+     * @param moduleId - A string literal representing the module identifier.
+     * @throws Error if the provided moduleId is not in the correct format.
+     * @returns ModuleId - The corresponding ModuleId object.
+     * @group Implementation
+     * @category Transactions
+     */
+    static fromStr(moduleId) {
+        const parts = moduleId.split("::");
+        if (parts.length !== 2) {
+            throw new Error("Invalid module id.");
+        }
+        return new ModuleId(AccountAddress.fromString(parts[0]), new Identifier(parts[1]));
+    }
+    /**
+     * Serializes the address and name properties using the provided serializer.
+     * This function is essential for converting the object's data into a format suitable for transmission or storage.
+     *
+     * @param serializer - The serializer instance used to perform the serialization.
+     * @group Implementation
+     * @category Transactions
+     */
+    serialize(serializer) {
+        this.address.serialize(serializer);
+        this.name.serialize(serializer);
+    }
+    /**
+     * Deserializes a ModuleId from the provided deserializer.
+     * This function retrieves the account address and identifier to construct a ModuleId instance.
+     *
+     * @param deserializer - The deserializer instance used to read the data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static deserialize(deserializer) {
+        const address = AccountAddress.deserialize(deserializer);
+        const name = Identifier.deserialize(deserializer);
+        return new ModuleId(address, name);
+    }
+}
+//# sourceMappingURL=moduleId.js.map

package/dist/transactions/instances/moduleId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleId.js","sourceRoot":"","sources":["../../../src/transactions/instances/moduleId.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sCAAsC;AAEtC,OAAO,EAAE,YAAY,EAAc,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,YAAY;IACxB,OAAO,CAAiB;IAExB,IAAI,CAAa;IAEjC;;;;;;;OAOG;IACH,YAAY,OAAuB,EAAE,IAAgB;QACnD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,QAAsB;QACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,UAAsB;QAC9B,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,YAA0B;QAC3C,MAAM,OAAO,GAAG,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAClD,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/transactions/instances/multiAgentTransaction.d.ts

@@ -0,0 +1,50 @@
+import { Deserializer } from "../../bcs/deserializer.js";
+import { Serializable, Serializer } from "../../bcs/serializer.js";
+import { AccountAddress } from "../../core/index.js";
+import { RawTransaction } from "./rawTransaction.js";
+/**
+ * Represents a multi-agent transaction that can be serialized and deserialized.
+ * This transaction includes a raw transaction, optional fee payer address, and multiple secondary signer addresses.
+ *
+ * @param rawTransaction The raw transaction to be executed.
+ * @param secondarySignerAddresses An array of secondary signer addresses involved in the transaction.
+ * @param feePayerAddress An optional account address that sponsors the transaction's gas fees.
+ * @group Implementation
+ * @category Transactions
+ */
+export declare class MultiAgentTransaction extends Serializable {
+    rawTransaction: RawTransaction;
+    feePayerAddress?: AccountAddress | undefined;
+    secondarySignerAddresses: AccountAddress[];
+    /**
+     * Represents a MultiAgentTransaction that can be submitted to the Aptos chain for execution.
+     * This class encapsulates the raw transaction data, the secondary signer addresses, and an optional fee payer address.
+     *
+     * @param rawTransaction The raw transaction data.
+     * @param secondarySignerAddresses An array of secondary signer addresses.
+     * @param feePayerAddress An optional account address that sponsors the gas fees.
+     * @group Implementation
+     * @category Transactions
+     */
+    constructor(rawTransaction: RawTransaction, secondarySignerAddresses: AccountAddress[], feePayerAddress?: AccountAddress);
+    /**
+     * Serializes the transaction data, including the raw transaction, secondary signer addresses, and fee payer address.
+     * This function is essential for preparing the transaction for transmission or storage in a serialized format.
+     *
+     * @param serializer - The serializer instance used to serialize the transaction data.
+     * @group Implementation
+     * @category Transactions
+     */
+    serialize(serializer: Serializer): void;
+    /**
+     * Deserializes a MultiAgentTransaction from the provided deserializer.
+     * This function allows you to reconstruct a MultiAgentTransaction object from its serialized form, including any secondary
+     * signer addresses and the fee payer address if present.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static deserialize(deserializer: Deserializer): MultiAgentTransaction;
+}
+//# sourceMappingURL=multiAgentTransaction.d.ts.map

package/dist/transactions/instances/multiAgentTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiAgentTransaction.d.ts","sourceRoot":"","sources":["../../../src/transactions/instances/multiAgentTransaction.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IAC9C,cAAc,EAAE,cAAc,CAAC;IAE/B,eAAe,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAE7C,wBAAwB,EAAE,cAAc,EAAE,CAAC;IAElD;;;;;;;;;OASG;gBAED,cAAc,EAAE,cAAc,EAC9B,wBAAwB,EAAE,cAAc,EAAE,EAC1C,eAAe,CAAC,EAAE,cAAc;IAQlC;;;;;;;OAOG;IACH,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAavC;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,qBAAqB;CAatE"}

package/dist/transactions/instances/multiAgentTransaction.js

@@ -0,0 +1,75 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+import { Serializable } from "../../bcs/serializer.js";
+import { AccountAddress } from "../../core/index.js";
+import { RawTransaction } from "./rawTransaction.js";
+/**
+ * Represents a multi-agent transaction that can be serialized and deserialized.
+ * This transaction includes a raw transaction, optional fee payer address, and multiple secondary signer addresses.
+ *
+ * @param rawTransaction The raw transaction to be executed.
+ * @param secondarySignerAddresses An array of secondary signer addresses involved in the transaction.
+ * @param feePayerAddress An optional account address that sponsors the transaction's gas fees.
+ * @group Implementation
+ * @category Transactions
+ */
+export class MultiAgentTransaction extends Serializable {
+    rawTransaction;
+    feePayerAddress;
+    secondarySignerAddresses;
+    /**
+     * Represents a MultiAgentTransaction that can be submitted to the Aptos chain for execution.
+     * This class encapsulates the raw transaction data, the secondary signer addresses, and an optional fee payer address.
+     *
+     * @param rawTransaction The raw transaction data.
+     * @param secondarySignerAddresses An array of secondary signer addresses.
+     * @param feePayerAddress An optional account address that sponsors the gas fees.
+     * @group Implementation
+     * @category Transactions
+     */
+    constructor(rawTransaction, secondarySignerAddresses, feePayerAddress) {
+        super();
+        this.rawTransaction = rawTransaction;
+        this.feePayerAddress = feePayerAddress;
+        this.secondarySignerAddresses = secondarySignerAddresses;
+    }
+    /**
+     * Serializes the transaction data, including the raw transaction, secondary signer addresses, and fee payer address.
+     * This function is essential for preparing the transaction for transmission or storage in a serialized format.
+     *
+     * @param serializer - The serializer instance used to serialize the transaction data.
+     * @group Implementation
+     * @category Transactions
+     */
+    serialize(serializer) {
+        this.rawTransaction.serialize(serializer);
+        serializer.serializeVector(this.secondarySignerAddresses);
+        if (this.feePayerAddress === undefined) {
+            serializer.serializeBool(false);
+        }
+        else {
+            serializer.serializeBool(true);
+            this.feePayerAddress.serialize(serializer);
+        }
+    }
+    /**
+     * Deserializes a MultiAgentTransaction from the provided deserializer.
+     * This function allows you to reconstruct a MultiAgentTransaction object from its serialized form, including any secondary
+     * signer addresses and the fee payer address if present.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static deserialize(deserializer) {
+        const rawTransaction = RawTransaction.deserialize(deserializer);
+        const secondarySignerAddresses = deserializer.deserializeVector(AccountAddress);
+        const feePayerPresent = deserializer.deserializeBool();
+        let feePayerAddress;
+        if (feePayerPresent) {
+            feePayerAddress = AccountAddress.deserialize(deserializer);
+        }
+        return new MultiAgentTransaction(rawTransaction, secondarySignerAddresses, feePayerAddress);
+    }
+}
+//# sourceMappingURL=multiAgentTransaction.js.map

package/dist/transactions/instances/multiAgentTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiAgentTransaction.js","sourceRoot":"","sources":["../../../src/transactions/instances/multiAgentTransaction.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sCAAsC;AAGtC,OAAO,EAAE,YAAY,EAAc,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IAC9C,cAAc,CAAiB;IAE/B,eAAe,CAA8B;IAE7C,wBAAwB,CAAmB;IAElD;;;;;;;;;OASG;IACH,YACE,cAA8B,EAC9B,wBAA0C,EAC1C,eAAgC;QAEhC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,wBAAwB,GAAG,wBAAwB,CAAC;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,UAAsB;QAC9B,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAE1C,UAAU,CAAC,eAAe,CAAiB,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAE1E,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACvC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,CAAC,YAA0B;QAC3C,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAEhE,MAAM,wBAAwB,GAAG,YAAY,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;QAEhF,MAAM,eAAe,GAAG,YAAY,CAAC,eAAe,EAAE,CAAC;QACvD,IAAI,eAAe,CAAC;QACpB,IAAI,eAAe,EAAE,CAAC;YACpB,eAAe,GAAG,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,qBAAqB,CAAC,cAAc,EAAE,wBAAwB,EAAE,eAAe,CAAC,CAAC;IAC9F,CAAC;CACF"}