@aptos-labs/ts-sdk 6.3.1 → 7.0.1

package/dist/transactions/authenticator/transaction.d.ts

@@ -0,0 +1,148 @@
+import { AccountAuthenticator } from "./account.js";
+import { Deserializer, Serializable, Serializer } from "../../bcs/index.js";
+import { AccountAddress } from "../../core/index.js";
+import { Ed25519PublicKey, Ed25519Signature } from "../../core/crypto/ed25519.js";
+import { MultiEd25519PublicKey, MultiEd25519Signature } from "../../core/crypto/multiEd25519.js";
+/**
+ * Represents an abstract base class for transaction authenticators.
+ * This class provides methods for serializing and deserializing different types of transaction authenticators.
+ *
+ * @extends Serializable
+ * @group Implementation
+ * @category Transactions
+ */
+export declare abstract class TransactionAuthenticator extends Serializable {
+    abstract serialize(serializer: Serializer): void;
+    /**
+     * Deserializes a TransactionAuthenticator from the provided deserializer.
+     * This function helps in reconstructing the TransactionAuthenticator based on the variant index found in the serialized data.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static deserialize(deserializer: Deserializer): TransactionAuthenticator;
+    isEd25519(): this is TransactionAuthenticatorEd25519;
+    isMultiEd25519(): this is TransactionAuthenticatorMultiEd25519;
+    isMultiAgent(): this is TransactionAuthenticatorMultiAgent;
+    isFeePayer(): this is TransactionAuthenticatorFeePayer;
+    isSingleSender(): this is TransactionAuthenticatorSingleSender;
+}
+/**
+ * Represents a transaction authenticator using Ed25519 for a single signer transaction.
+ * This class encapsulates the client's public key and the Ed25519 signature of a raw transaction.
+ *
+ * @param public_key - The client's public key.
+ * @param signature - The Ed25519 signature of a raw transaction.
+ * @see {@link https://aptos.dev/integration/creating-a-signed-transaction | Creating a Signed Transaction}
+ * for details about generating a signature.
+ * @group Implementation
+ * @category Transactions
+ */
+export declare class TransactionAuthenticatorEd25519 extends TransactionAuthenticator {
+    readonly public_key: Ed25519PublicKey;
+    readonly signature: Ed25519Signature;
+    /**
+     * Creates an instance of the class with the specified account authenticator.
+     *
+     * @param public_key - The Ed25519PublicKey that will be used for authentication.
+     * @param signature - The Ed25519Signature that will be used for authentication.
+     * @group Implementation
+     * @category Transactions
+     */
+    constructor(public_key: Ed25519PublicKey, signature: Ed25519Signature);
+    /**
+     * Serializes the transaction authenticator by encoding the sender information.
+     *
+     * @param serializer - The serializer instance used to perform the serialization.
+     * @group Implementation
+     * @category Transactions
+     */
+    serialize(serializer: Serializer): void;
+    /**
+     * Loads a TransactionAuthenticatorSingleSender instance from the provided deserializer.
+     * This function helps in deserializing the sender information to create a transaction authenticator.
+     *
+     * @param deserializer - The deserializer used to extract the sender data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static load(deserializer: Deserializer): TransactionAuthenticatorEd25519;
+}
+/**
+ * Represents a transaction authenticator for multi-signature transactions using Ed25519.
+ * This class is used to validate transactions that require multiple signatures from different signers.
+ *
+ * @param public_key - The public key of the client involved in the transaction.
+ * @param signature - The multi-signature of the raw transaction.
+ * @group Implementation
+ * @category Transactions
+ */
+export declare class TransactionAuthenticatorMultiEd25519 extends TransactionAuthenticator {
+    readonly public_key: MultiEd25519PublicKey;
+    readonly signature: MultiEd25519Signature;
+    constructor(public_key: MultiEd25519PublicKey, signature: MultiEd25519Signature);
+    serialize(serializer: Serializer): void;
+    static load(deserializer: Deserializer): TransactionAuthenticatorMultiEd25519;
+}
+/**
+ * Represents a transaction authenticator for a multi-agent transaction.
+ *
+ * This class manages the authentication process involving a primary sender and multiple secondary signers.
+ *
+ * @param sender - The authenticator for the sender account.
+ * @param secondary_signer_addresses - An array of addresses for the secondary signers.
+ * @param secondary_signers - An array of authenticators for the secondary signer accounts.
+ * @group Implementation
+ * @category Transactions
+ */
+export declare class TransactionAuthenticatorMultiAgent extends TransactionAuthenticator {
+    readonly sender: AccountAuthenticator;
+    readonly secondary_signer_addresses: Array<AccountAddress>;
+    readonly secondary_signers: Array<AccountAuthenticator>;
+    constructor(sender: AccountAuthenticator, secondary_signer_addresses: Array<AccountAddress>, secondary_signers: Array<AccountAuthenticator>);
+    serialize(serializer: Serializer): void;
+    static load(deserializer: Deserializer): TransactionAuthenticatorMultiAgent;
+}
+/**
+ * Represents a transaction authenticator specifically for fee payer transactions.
+ * It encapsulates the sender's account authenticator, addresses of secondary signers,
+ * their respective authenticators, and the fee payer's account information.
+ *
+ * @param sender - The authenticator for the sender's account.
+ * @param secondary_signer_addresses - An array of addresses for secondary signers.
+ * @param secondary_signers - An array of authenticators for secondary signers' accounts.
+ * @param fee_payer - An object containing the fee payer's account address and authenticator.
+ * @group Implementation
+ * @category Transactions
+ */
+export declare class TransactionAuthenticatorFeePayer extends TransactionAuthenticator {
+    readonly sender: AccountAuthenticator;
+    readonly secondary_signer_addresses: Array<AccountAddress>;
+    readonly secondary_signers: Array<AccountAuthenticator>;
+    readonly fee_payer: {
+        address: AccountAddress;
+        authenticator: AccountAuthenticator;
+    };
+    constructor(sender: AccountAuthenticator, secondary_signer_addresses: Array<AccountAddress>, secondary_signers: Array<AccountAuthenticator>, fee_payer: {
+        address: AccountAddress;
+        authenticator: AccountAuthenticator;
+    });
+    serialize(serializer: Serializer): void;
+    static load(deserializer: Deserializer): TransactionAuthenticatorMultiAgent;
+}
+/**
+ * Represents a single sender authenticator for transactions that require a single signer.
+ * This class is responsible for managing the authentication of a transaction initiated by a single sender.
+ *
+ * @param sender - An instance of AccountAuthenticator that represents the account of the sender.
+ * @group Implementation
+ * @category Transactions
+ */
+export declare class TransactionAuthenticatorSingleSender extends TransactionAuthenticator {
+    readonly sender: AccountAuthenticator;
+    constructor(sender: AccountAuthenticator);
+    serialize(serializer: Serializer): void;
+    static load(deserializer: Deserializer): TransactionAuthenticatorSingleSender;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/dist/transactions/authenticator/transaction.d.ts.map

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

package/dist/transactions/authenticator/transaction.js

@@ -0,0 +1,239 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+import { AccountAuthenticator } from "./account.js";
+import { Serializable } from "../../bcs/index.js";
+import { AccountAddress } from "../../core/index.js";
+import { Ed25519PublicKey, Ed25519Signature } from "../../core/crypto/ed25519.js";
+import { MultiEd25519PublicKey, MultiEd25519Signature } from "../../core/crypto/multiEd25519.js";
+import { TransactionAuthenticatorVariant } from "../../types/index.js";
+/**
+ * Represents an abstract base class for transaction authenticators.
+ * This class provides methods for serializing and deserializing different types of transaction authenticators.
+ *
+ * @extends Serializable
+ * @group Implementation
+ * @category Transactions
+ */
+export class TransactionAuthenticator extends Serializable {
+    /**
+     * Deserializes a TransactionAuthenticator from the provided deserializer.
+     * This function helps in reconstructing the TransactionAuthenticator based on the variant index found in the serialized data.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static deserialize(deserializer) {
+        const index = deserializer.deserializeUleb128AsU32();
+        switch (index) {
+            case TransactionAuthenticatorVariant.Ed25519:
+                return TransactionAuthenticatorEd25519.load(deserializer);
+            case TransactionAuthenticatorVariant.MultiEd25519:
+                return TransactionAuthenticatorMultiEd25519.load(deserializer);
+            case TransactionAuthenticatorVariant.MultiAgent:
+                return TransactionAuthenticatorMultiAgent.load(deserializer);
+            case TransactionAuthenticatorVariant.FeePayer:
+                return TransactionAuthenticatorFeePayer.load(deserializer);
+            case TransactionAuthenticatorVariant.SingleSender:
+                return TransactionAuthenticatorSingleSender.load(deserializer);
+            default:
+                throw new Error(`Unknown variant index for TransactionAuthenticator: ${index}`);
+        }
+    }
+    isEd25519() {
+        return this instanceof TransactionAuthenticatorEd25519;
+    }
+    isMultiEd25519() {
+        return this instanceof TransactionAuthenticatorMultiEd25519;
+    }
+    isMultiAgent() {
+        return this instanceof TransactionAuthenticatorMultiAgent;
+    }
+    isFeePayer() {
+        return this instanceof TransactionAuthenticatorFeePayer;
+    }
+    isSingleSender() {
+        return this instanceof TransactionAuthenticatorSingleSender;
+    }
+}
+/**
+ * Represents a transaction authenticator using Ed25519 for a single signer transaction.
+ * This class encapsulates the client's public key and the Ed25519 signature of a raw transaction.
+ *
+ * @param public_key - The client's public key.
+ * @param signature - The Ed25519 signature of a raw transaction.
+ * @see {@link https://aptos.dev/integration/creating-a-signed-transaction | Creating a Signed Transaction}
+ * for details about generating a signature.
+ * @group Implementation
+ * @category Transactions
+ */
+export class TransactionAuthenticatorEd25519 extends TransactionAuthenticator {
+    public_key;
+    signature;
+    /**
+     * Creates an instance of the class with the specified account authenticator.
+     *
+     * @param public_key - The Ed25519PublicKey that will be used for authentication.
+     * @param signature - The Ed25519Signature that will be used for authentication.
+     * @group Implementation
+     * @category Transactions
+     */
+    constructor(public_key, signature) {
+        super();
+        this.public_key = public_key;
+        this.signature = signature;
+    }
+    /**
+     * Serializes the transaction authenticator by encoding the sender information.
+     *
+     * @param serializer - The serializer instance used to perform the serialization.
+     * @group Implementation
+     * @category Transactions
+     */
+    serialize(serializer) {
+        serializer.serializeU32AsUleb128(TransactionAuthenticatorVariant.Ed25519);
+        this.public_key.serialize(serializer);
+        this.signature.serialize(serializer);
+    }
+    /**
+     * Loads a TransactionAuthenticatorSingleSender instance from the provided deserializer.
+     * This function helps in deserializing the sender information to create a transaction authenticator.
+     *
+     * @param deserializer - The deserializer used to extract the sender data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static load(deserializer) {
+        const public_key = Ed25519PublicKey.deserialize(deserializer);
+        const signature = Ed25519Signature.deserialize(deserializer);
+        return new TransactionAuthenticatorEd25519(public_key, signature);
+    }
+}
+/**
+ * Represents a transaction authenticator for multi-signature transactions using Ed25519.
+ * This class is used to validate transactions that require multiple signatures from different signers.
+ *
+ * @param public_key - The public key of the client involved in the transaction.
+ * @param signature - The multi-signature of the raw transaction.
+ * @group Implementation
+ * @category Transactions
+ */
+export class TransactionAuthenticatorMultiEd25519 extends TransactionAuthenticator {
+    public_key;
+    signature;
+    constructor(public_key, signature) {
+        super();
+        this.public_key = public_key;
+        this.signature = signature;
+    }
+    serialize(serializer) {
+        serializer.serializeU32AsUleb128(TransactionAuthenticatorVariant.MultiEd25519);
+        this.public_key.serialize(serializer);
+        this.signature.serialize(serializer);
+    }
+    static load(deserializer) {
+        const public_key = MultiEd25519PublicKey.deserialize(deserializer);
+        const signature = MultiEd25519Signature.deserialize(deserializer);
+        return new TransactionAuthenticatorMultiEd25519(public_key, signature);
+    }
+}
+/**
+ * Represents a transaction authenticator for a multi-agent transaction.
+ *
+ * This class manages the authentication process involving a primary sender and multiple secondary signers.
+ *
+ * @param sender - The authenticator for the sender account.
+ * @param secondary_signer_addresses - An array of addresses for the secondary signers.
+ * @param secondary_signers - An array of authenticators for the secondary signer accounts.
+ * @group Implementation
+ * @category Transactions
+ */
+export class TransactionAuthenticatorMultiAgent extends TransactionAuthenticator {
+    sender;
+    secondary_signer_addresses;
+    secondary_signers;
+    constructor(sender, secondary_signer_addresses, secondary_signers) {
+        super();
+        this.sender = sender;
+        this.secondary_signer_addresses = secondary_signer_addresses;
+        this.secondary_signers = secondary_signers;
+    }
+    serialize(serializer) {
+        serializer.serializeU32AsUleb128(TransactionAuthenticatorVariant.MultiAgent);
+        this.sender.serialize(serializer);
+        serializer.serializeVector(this.secondary_signer_addresses);
+        serializer.serializeVector(this.secondary_signers);
+    }
+    static load(deserializer) {
+        const sender = AccountAuthenticator.deserialize(deserializer);
+        const secondary_signer_addresses = deserializer.deserializeVector(AccountAddress);
+        const secondary_signers = deserializer.deserializeVector(AccountAuthenticator);
+        return new TransactionAuthenticatorMultiAgent(sender, secondary_signer_addresses, secondary_signers);
+    }
+}
+/**
+ * Represents a transaction authenticator specifically for fee payer transactions.
+ * It encapsulates the sender's account authenticator, addresses of secondary signers,
+ * their respective authenticators, and the fee payer's account information.
+ *
+ * @param sender - The authenticator for the sender's account.
+ * @param secondary_signer_addresses - An array of addresses for secondary signers.
+ * @param secondary_signers - An array of authenticators for secondary signers' accounts.
+ * @param fee_payer - An object containing the fee payer's account address and authenticator.
+ * @group Implementation
+ * @category Transactions
+ */
+export class TransactionAuthenticatorFeePayer extends TransactionAuthenticator {
+    sender;
+    secondary_signer_addresses;
+    secondary_signers;
+    fee_payer;
+    constructor(sender, secondary_signer_addresses, secondary_signers, fee_payer) {
+        super();
+        this.sender = sender;
+        this.secondary_signer_addresses = secondary_signer_addresses;
+        this.secondary_signers = secondary_signers;
+        this.fee_payer = fee_payer;
+    }
+    serialize(serializer) {
+        serializer.serializeU32AsUleb128(TransactionAuthenticatorVariant.FeePayer);
+        this.sender.serialize(serializer);
+        serializer.serializeVector(this.secondary_signer_addresses);
+        serializer.serializeVector(this.secondary_signers);
+        this.fee_payer.address.serialize(serializer);
+        this.fee_payer.authenticator.serialize(serializer);
+    }
+    static load(deserializer) {
+        const sender = AccountAuthenticator.deserialize(deserializer);
+        const secondary_signer_addresses = deserializer.deserializeVector(AccountAddress);
+        const secondary_signers = deserializer.deserializeVector(AccountAuthenticator);
+        const address = AccountAddress.deserialize(deserializer);
+        const authenticator = AccountAuthenticator.deserialize(deserializer);
+        const fee_payer = { address, authenticator };
+        return new TransactionAuthenticatorFeePayer(sender, secondary_signer_addresses, secondary_signers, fee_payer);
+    }
+}
+/**
+ * Represents a single sender authenticator for transactions that require a single signer.
+ * This class is responsible for managing the authentication of a transaction initiated by a single sender.
+ *
+ * @param sender - An instance of AccountAuthenticator that represents the account of the sender.
+ * @group Implementation
+ * @category Transactions
+ */
+export class TransactionAuthenticatorSingleSender extends TransactionAuthenticator {
+    sender;
+    constructor(sender) {
+        super();
+        this.sender = sender;
+    }
+    serialize(serializer) {
+        serializer.serializeU32AsUleb128(TransactionAuthenticatorVariant.SingleSender);
+        this.sender.serialize(serializer);
+    }
+    static load(deserializer) {
+        const sender = AccountAuthenticator.deserialize(deserializer);
+        return new TransactionAuthenticatorSingleSender(sender);
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/transactions/authenticator/transaction.js.map

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

package/dist/transactions/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./authenticator/index.js";
+export * from "./instances/index.js";
+export * from "./transactionBuilder/index.js";
+export * from "./typeTag/index.js";
+export * from "./typeTag/parser.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transactions/index.ts"],"names":[],"mappings":"AAGA,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}

package/dist/transactions/index.js

@@ -0,0 +1,9 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+export * from "./authenticator/index.js";
+export * from "./instances/index.js";
+export * from "./transactionBuilder/index.js";
+export * from "./typeTag/index.js";
+export * from "./typeTag/parser.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/transactions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transactions/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sCAAsC;AAEtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,39 @@
+import { Serializer, Serializable } from "../../bcs/serializer.js";
+import { Deserializer } from "../../bcs/deserializer.js";
+/**
+ * Represents a ChainId that can be serialized and deserialized.
+ *
+ * @extends Serializable
+ * @group Implementation
+ * @category Transactions
+ */
+export declare class ChainId extends Serializable {
+    readonly chainId: number;
+    /**
+     * Initializes a new instance of the class with the specified chain ID.
+     *
+     * @param chainId - The ID of the blockchain network to be used.
+     * @group Implementation
+     * @category Transactions
+     */
+    constructor(chainId: number);
+    /**
+     * Serializes the current object using the provided serializer.
+     * This function helps in converting the object 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 ChainId from the provided deserializer.
+     * This function allows you to reconstruct a ChainId object from serialized data.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static deserialize(deserializer: Deserializer): ChainId;
+}
+//# sourceMappingURL=chainId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chainId.d.ts","sourceRoot":"","sources":["../../../src/transactions/instances/chainId.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;;;;GAMG;AACH,qBAAa,OAAQ,SAAQ,YAAY;IACvC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM;IAK3B;;;;;;;OAOG;IACH,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIvC;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO;CAIxD"}

package/dist/transactions/instances/chainId.js

@@ -0,0 +1,48 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+import { Serializable } from "../../bcs/serializer.js";
+/**
+ * Represents a ChainId that can be serialized and deserialized.
+ *
+ * @extends Serializable
+ * @group Implementation
+ * @category Transactions
+ */
+export class ChainId extends Serializable {
+    chainId;
+    /**
+     * Initializes a new instance of the class with the specified chain ID.
+     *
+     * @param chainId - The ID of the blockchain network to be used.
+     * @group Implementation
+     * @category Transactions
+     */
+    constructor(chainId) {
+        super();
+        this.chainId = chainId;
+    }
+    /**
+     * Serializes the current object using the provided serializer.
+     * This function helps in converting the object 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.serializeU8(this.chainId);
+    }
+    /**
+     * Deserializes a ChainId from the provided deserializer.
+     * This function allows you to reconstruct a ChainId object from serialized data.
+     *
+     * @param deserializer - The deserializer instance used to read the serialized data.
+     * @group Implementation
+     * @category Transactions
+     */
+    static deserialize(deserializer) {
+        const chainId = deserializer.deserializeU8();
+        return new ChainId(chainId);
+    }
+}
+//# sourceMappingURL=chainId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chainId.js","sourceRoot":"","sources":["../../../src/transactions/instances/chainId.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,sCAAsC;AAEtC,OAAO,EAAc,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGnE;;;;;;GAMG;AACH,MAAM,OAAO,OAAQ,SAAQ,YAAY;IACvB,OAAO,CAAS;IAEhC;;;;;;OAMG;IACH,YAAY,OAAe;QACzB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,UAAsB;QAC9B,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,CAAC,YAA0B;QAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,EAAE,CAAC;QAC7C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;CACF"}

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

@@ -0,0 +1,65 @@
+import { Deserializer } from "../../bcs/deserializer.js";
+import { Serializable, Serializer } 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 { EntryFunction, TransactionExecutable } from "./transactionPayload.js";
+/** 16-byte decryption nonce for encrypted payloads (aptos-core `DecryptionNonce`). */
+export declare const DECRYPTION_NONCE_LENGTH = 16;
+/**
+ * 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 declare class ClaimedEntryFunction extends Serializable {
+    readonly moduleId: ModuleId;
+    /** BCS/Rust `function`; JSON API field is `name`. */
+    readonly functionName?: Identifier;
+    constructor(moduleId: ModuleId, functionName?: Identifier);
+    serialize(serializer: Serializer): void;
+    static deserialize(deserializer: Deserializer): ClaimedEntryFunction;
+    /**
+     * @param includeFunctionName - When false, only the module is claimed (`Option::None` for function on wire).
+     */
+    static fromEntryFunction(entry: EntryFunction, opts?: {
+        includeFunctionName?: boolean;
+    }): ClaimedEntryFunction;
+}
+/**
+ * BCS-serializable `DecryptedPlaintext`. Built client-side before encrypting; its BCS hash becomes `payload_hash`.
+ * Matches Rust: `DecryptedPlaintext { executable, decryption_nonce: [u8; 16] }`.
+ */
+export declare class DecryptedPlaintext extends Serializable {
+    executable: TransactionExecutable;
+    decryptionNonce: Uint8Array;
+    constructor(executable: TransactionExecutable, decryptionNonce: Uint8Array);
+    serialize(serializer: Serializer): void;
+    static deserialize(deserializer: Deserializer): DecryptedPlaintext;
+    /**
+     * Domain-separated BCS crypto hash (`BCSCryptoHash` in aptos-core):
+     * SHA3-256( SHA3-256("APTOS::DecryptedPlaintext") || BCS(self) ).
+     */
+    hash(): Uint8Array;
+}
+/**
+ * One `(AccountAddress, AuthenticationKey)` entry in `PayloadAssociatedData::V1.signer_auth_keys` (aptos-core).
+ * @internal
+ */
+export type SignerAuthKeyPair = {
+    address: AccountAddress;
+    authenticationKey: AuthenticationKey;
+};
+/**
+ * AAD for batch-encrypted transaction payloads. BCS matches Rust `PayloadAssociatedData::V1`:
+ * uleb128 variant | `sender` | `Vec<(AccountAddress, AuthenticationKey)>`.
+ */
+export declare class PayloadAssociatedData extends Serializable {
+    readonly sender: AccountAddress;
+    readonly signerAuthKeys: readonly SignerAuthKeyPair[];
+    constructor(sender: AccountAddress, signerAuthKeys: readonly SignerAuthKeyPair[]);
+    serialize(serializer: Serializer): void;
+    static deserialize(deserializer: Deserializer): PayloadAssociatedData;
+}
+//# sourceMappingURL=encryptedPayload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encryptedPayload.d.ts","sourceRoot":"","sources":["../../../src/transactions/instances/encryptedPayload.ts"],"names":[],"mappings":"AAIA,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,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAE/E,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAI1C;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAEnC,qDAAqD;IACrD,SAAgB,YAAY,CAAC,EAAE,UAAU,CAAC;gBAE9B,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,UAAU;IAMzD,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKvC,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,oBAAoB;IAMpE;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;QAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,oBAAoB;CAI/G;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,UAAU,EAAE,qBAAqB,CAAC;IAElC,eAAe,EAAE,UAAU,CAAC;gBAEhB,UAAU,EAAE,qBAAqB,EAAE,eAAe,EAAE,UAAU;IAS1E,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKvC,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,kBAAkB;IAMlE;;;OAGG;IACH,IAAI,IAAI,UAAU;CAMnB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,iBAAiB,EAAE,iBAAiB,CAAC;CACtC,CAAC;AAIF;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;aAEnC,MAAM,EAAE,cAAc;aACtB,cAAc,EAAE,SAAS,iBAAiB,EAAE;gBAD5C,MAAM,EAAE,cAAc,EACtB,cAAc,EAAE,SAAS,iBAAiB,EAAE;IAQ9D,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAUvC,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,qBAAqB;CAgBtE"}