@dynamic-labs/aptos 4.44.0 → 4.44.1

package/CHANGELOG.md

@@ -1,4 +1,11 @@
 
+### [4.44.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.44.0...v4.44.1) (2025-11-06)
+
+
+### Bug Fixes
+
+* better handling of null and undefined values in StorageService ([#9842](https://github.com/dynamic-labs/dynamic-auth/issues/9842)) ([f959943](https://github.com/dynamic-labs/dynamic-auth/commit/f95994337ea938e7e88d0126053b03ad69340a6a))
+
 ## [4.44.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.43.0...v4.44.0) (2025-11-05)
 
 

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.44.0";
+var version = "4.44.1";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.44.0";
+var version = "4.44.1";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/aptos",
-  "version": "4.44.0",
+  "version": "4.44.1",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -20,14 +20,14 @@
   "dependencies": {
     "@aptos-labs/ts-sdk": "5.1.1",
     "@aptos-labs/wallet-standard": "0.5.2",
-    "@dynamic-labs/assert-package-version": "4.44.0",
+    "@dynamic-labs/assert-package-version": "4.44.1",
     "@wallet-standard/core": "1.1.1",
     "@wallet-standard/features": "1.0.3",
-    "@dynamic-labs/logger": "4.44.0",
-    "@dynamic-labs/types": "4.44.0",
-    "@dynamic-labs/utils": "4.44.0",
-    "@dynamic-labs/wallet-book": "4.44.0",
-    "@dynamic-labs/wallet-connector-core": "4.44.0"
+    "@dynamic-labs/logger": "4.44.1",
+    "@dynamic-labs/types": "4.44.1",
+    "@dynamic-labs/utils": "4.44.1",
+    "@dynamic-labs/wallet-book": "4.44.1",
+    "@dynamic-labs/wallet-connector-core": "4.44.1"
   },
   "peerDependencies": {}
 }

package/src/connectors/AptosWalletConnector/AptosWalletConnector.cjs

@@ -12,6 +12,7 @@ var assertProvider = require('../../utils/assertProvider/assertProvider.cjs');
 var invokeWalletMethod = require('../../utils/invokeWalletMethod/invokeWalletMethod.cjs');
 var parseConnectionResult = require('../../utils/parseConnectionResult/parseConnectionResult.cjs');
 var parseTransactionResponse = require('../../utils/parseTransactionResponse/parseTransactionResponse.cjs');
+var AptosUiTransaction = require('../../utils/AptosUiTransaction/AptosUiTransaction.cjs');
 var AptosWallet = require('../../wallet/AptosWallet.cjs');
 
 /**
@@ -45,10 +46,10 @@ class AptosWalletConnector extends walletConnectorCore.WalletConnectorBase {
             assertProvider.assertProvider(provider);
             const network = yield invokeWalletMethod.invokeWalletMethod(provider, 'aptos:network', 'network');
             if (network === null || network === void 0 ? void 0 : network.chainId) {
-                return network.chainId;
+                return network.chainId.toString();
             }
             // default to mainnet
-            return 1;
+            return '1';
         });
     }
     /**
@@ -217,6 +218,32 @@ class AptosWalletConnector extends walletConnectorCore.WalletConnectorBase {
             }
         });
     }
+    /**
+     * Function used to create transactions in the SDK interface
+     *
+     * @param from - The sender's address
+     * @returns A new AptosUiTransaction instance
+     */
+    createUiTransaction(from) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            yield this.validateActiveWallet(from);
+            const aptosClient = yield this.getAptosClient();
+            if (!aptosClient) {
+                throw new utils.DynamicError('No Aptos client available');
+            }
+            return new AptosUiTransaction.AptosUiTransaction({
+                client: aptosClient,
+                from,
+                onSubmit: (transaction) => _tslib.__awaiter(this, void 0, void 0, function* () {
+                    if (!transaction) {
+                        throw new utils.DynamicError('Transaction must be provided');
+                    }
+                    const result = yield this.signAndSubmitTransaction(transaction);
+                    return result;
+                }),
+            });
+        });
+    }
 }
 
 exports.AptosWalletConnector = AptosWalletConnector;

package/src/connectors/AptosWalletConnector/AptosWalletConnector.d.ts

@@ -3,7 +3,7 @@ import { Aptos, InputGenerateTransactionPayloadData } from '@aptos-labs/ts-sdk';
 import type { AccountInfo, AptosSignMessageInput, AptosSignMessageOutput, NetworkInfo, UserResponse } from '@aptos-labs/wallet-standard';
 import { Logger } from '@dynamic-labs/logger';
 import { type Chain, WalletConnectorBase } from '@dynamic-labs/wallet-connector-core';
-import { GenericNetwork } from '@dynamic-labs/types';
+import { GenericNetwork, IUITransaction } from '@dynamic-labs/types';
 import type { AptosWalletConnectorProps, IAptosProvider } from '../../types';
 import { AptosWallet } from '../../wallet/AptosWallet';
 /**
@@ -33,7 +33,7 @@ export declare abstract class AptosWalletConnector extends WalletConnectorBase<t
      */
     abstract getProvider(): IAptosProvider | undefined;
     getEnabledNetworks(): GenericNetwork[];
-    getNetwork(): Promise<number | undefined>;
+    getNetwork(): Promise<string | undefined>;
     /**
      * Connects to the Aptos wallet.
      */
@@ -72,4 +72,11 @@ export declare abstract class AptosWalletConnector extends WalletConnectorBase<t
      * Gets the Aptos client instance configured for the current network.
      */
     getAptosClient(): Promise<Aptos | undefined>;
+    /**
+     * Function used to create transactions in the SDK interface
+     *
+     * @param from - The sender's address
+     * @returns A new AptosUiTransaction instance
+     */
+    createUiTransaction(from: string): Promise<IUITransaction>;
 }

package/src/connectors/AptosWalletConnector/AptosWalletConnector.js

@@ -8,6 +8,7 @@ import { assertProvider } from '../../utils/assertProvider/assertProvider.js';
 import { invokeWalletMethod } from '../../utils/invokeWalletMethod/invokeWalletMethod.js';
 import { parseConnectionResult } from '../../utils/parseConnectionResult/parseConnectionResult.js';
 import { parseTransactionResponse } from '../../utils/parseTransactionResponse/parseTransactionResponse.js';
+import { AptosUiTransaction } from '../../utils/AptosUiTransaction/AptosUiTransaction.js';
 import { AptosWallet } from '../../wallet/AptosWallet.js';
 
 /**
@@ -41,10 +42,10 @@ class AptosWalletConnector extends WalletConnectorBase {
             assertProvider(provider);
             const network = yield invokeWalletMethod(provider, 'aptos:network', 'network');
             if (network === null || network === void 0 ? void 0 : network.chainId) {
-                return network.chainId;
+                return network.chainId.toString();
             }
             // default to mainnet
-            return 1;
+            return '1';
         });
     }
     /**
@@ -213,6 +214,32 @@ class AptosWalletConnector extends WalletConnectorBase {
             }
         });
     }
+    /**
+     * Function used to create transactions in the SDK interface
+     *
+     * @param from - The sender's address
+     * @returns A new AptosUiTransaction instance
+     */
+    createUiTransaction(from) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.validateActiveWallet(from);
+            const aptosClient = yield this.getAptosClient();
+            if (!aptosClient) {
+                throw new DynamicError('No Aptos client available');
+            }
+            return new AptosUiTransaction({
+                client: aptosClient,
+                from,
+                onSubmit: (transaction) => __awaiter(this, void 0, void 0, function* () {
+                    if (!transaction) {
+                        throw new DynamicError('Transaction must be provided');
+                    }
+                    const result = yield this.signAndSubmitTransaction(transaction);
+                    return result;
+                }),
+            });
+        });
+    }
 }
 
 export { AptosWalletConnector };

package/src/index.cjs

@@ -14,6 +14,7 @@ var AptosWalletConnector = require('./connectors/AptosWalletConnector/AptosWalle
 var fetchInjectedWalletConnectors = require('./injected/fetchInjectedWalletConnectors.cjs');
 var AptosWallet = require('./wallet/AptosWallet.cjs');
 var assertProvider = require('./utils/assertProvider/assertProvider.cjs');
+var AptosUiTransaction = require('./utils/AptosUiTransaction/AptosUiTransaction.cjs');
 var getWalletStandardWallets = require('./utils/getWalletStandardWallets/getWalletStandardWallets.cjs');
 var invokeWalletMethod = require('./utils/invokeWalletMethod/invokeWalletMethod.cjs');
 var isWalletWithRequiredFeatureSet = require('./utils/isWalletWithRequiredFeatureSet/isWalletWithRequiredFeatureSet.cjs');
@@ -32,6 +33,7 @@ const AptosWalletConnectors = (props) => [
 exports.AptosWalletConnector = AptosWalletConnector.AptosWalletConnector;
 exports.AptosWallet = AptosWallet.AptosWallet;
 exports.assertProvider = assertProvider.assertProvider;
+exports.AptosUiTransaction = AptosUiTransaction.AptosUiTransaction;
 exports.getWalletStandardWallets = getWalletStandardWallets.getWalletStandardWallets;
 exports.invokeWalletMethod = invokeWalletMethod.invokeWalletMethod;
 exports.isWalletWithRequiredFeatureSet = isWalletWithRequiredFeatureSet.isWalletWithRequiredFeatureSet;

package/src/index.d.ts

@@ -2,6 +2,7 @@ export { AptosWallet } from './wallet';
 export { AptosWalletConnector } from './connectors/AptosWalletConnector';
 export type { IAptosProvider, AptosConnectionResult, AptosSendBalanceProps, AptosWalletConnectorProps, AptosFeatureName, AptosMethodName, } from './types';
 export { assertProvider } from './utils/assertProvider';
+export { AptosUiTransaction } from './utils/AptosUiTransaction';
 export { getWalletStandardWallets } from './utils/getWalletStandardWallets';
 export { invokeWalletMethod } from './utils/invokeWalletMethod';
 export { isWalletWithRequiredFeatureSet } from './utils/isWalletWithRequiredFeatureSet';

package/src/index.js

@@ -10,6 +10,7 @@ export { AptosWalletConnector } from './connectors/AptosWalletConnector/AptosWal
 import { fetchInjectedWalletConnectors } from './injected/fetchInjectedWalletConnectors.js';
 export { AptosWallet } from './wallet/AptosWallet.js';
 export { assertProvider } from './utils/assertProvider/assertProvider.js';
+export { AptosUiTransaction } from './utils/AptosUiTransaction/AptosUiTransaction.js';
 export { getWalletStandardWallets } from './utils/getWalletStandardWallets/getWalletStandardWallets.js';
 export { invokeWalletMethod } from './utils/invokeWalletMethod/invokeWalletMethod.js';
 export { isWalletWithRequiredFeatureSet } from './utils/isWalletWithRequiredFeatureSet/isWalletWithRequiredFeatureSet.js';

package/src/utils/AptosUiTransaction/AptosUiTransaction.cjs

@@ -0,0 +1,189 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../_virtual/_tslib.cjs');
+var utils = require('@dynamic-labs/utils');
+var constants = require('../constants/constants.cjs');
+
+/**
+ * Aptos UI Transaction class for managing Aptos transactions in the UI.
+ *
+ * This class implements the IUITransaction interface and provides Aptos-specific
+ * functionality for creating, formatting, and submitting transactions.
+ */
+class AptosUiTransaction {
+    constructor({ onSubmit, from, client }) {
+        this.chain = 'APTOS';
+        this.data = undefined;
+        this.fee = { gas: undefined };
+        /**
+         * Formats a non-native token value back to a string
+         *
+         * @param value - The value as bigint
+         * @param decimals - The number of decimals for the token
+         * @returns The formatted amount as string
+         */
+        this.formatNonNativeToken = (value, decimals) => (Number(value) / Number(Math.pow(10, decimals))).toString();
+        this.from = from;
+        this.onSubmit = onSubmit;
+        this.client = client;
+    }
+    /**
+     * Fetches the gas fee for the transaction.
+     *
+     * Note: Aptos gas fees are typically fixed or very low, so we set a default
+     * estimate. In the future, this could be enhanced with actual gas estimation.
+     *
+     * @returns The gas fee for the transaction
+     */
+    fetchFee() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (this.fee.gas)
+                return;
+            const transaction = yield this.createTransactionSafe();
+            if (!transaction) {
+                throw new Error('Could not create a valid Aptos transaction, check your address and value');
+            }
+            // Aptos has a simple gas model. For now, we'll use a default estimate.
+            // In the future, this could use the client to simulate the transaction.
+            // Typical Aptos transactions cost around 100-1000 octas (0.0000001 - 0.000001 APT)
+            // We'll use a conservative estimate of 1000 octas
+            this.fee.gas = BigInt(1000);
+        });
+    }
+    isGasSponsored() {
+        return false;
+    }
+    /**
+     * Parses a string amount into bigint octas (APT smallest unit, 1e8)
+     *
+     * @param input - The amount as a string (e.g., "1.5")
+     * @returns The amount in octas as bigint
+     */
+    parse(input) {
+        const floatValue = parseFloat(input);
+        const octas = Math.round(floatValue * constants.OCTAS_PER_APT);
+        return BigInt(octas);
+    }
+    /**
+     * Parses a non-native token amount with custom decimals
+     *
+     * @param input - The amount as a string
+     * @param decimals - The number of decimals for the token
+     * @returns The amount as bigint
+     */
+    parseNonNativeToken(input, decimals) {
+        return BigInt(Math.floor(Number(input) * Math.pow(10, decimals)));
+    }
+    /**
+     * Formats a bigint value (in octas) to a human-readable APT string
+     *
+     * @param value - The value in octas
+     * @param options - Formatting options including precision
+     * @returns The formatted amount as string
+     */
+    format(value, { precision } = {}) {
+        const aptValue = Number(value) / constants.OCTAS_PER_APT;
+        const decimalString = aptValue.toLocaleString('fullwide', {
+            maximumFractionDigits: 20,
+            minimumFractionDigits: 0,
+            useGrouping: false,
+        });
+        return utils.formatNumberText(decimalString, { precision });
+    }
+    /**
+     * Submits the transaction by creating it and calling onSubmit
+     *
+     * @returns The transaction hash from onSubmit
+     */
+    submit() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            const sendTransaction = (yield this.createTransaction());
+            return this.onSubmit(sendTransaction);
+        });
+    }
+    /**
+     * Gets the balance of the sender's account in octas
+     *
+     * @returns The balance as bigint in octas
+     */
+    getBalance() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            const balance = yield this.client.getBalance({
+                accountAddress: this.from,
+                // APT coin type
+                asset: '0x1::aptos_coin::AptosCoin',
+            });
+            // Balance comes back as a number in octas (1e8 octas = 1 APT)
+            return BigInt(Math.floor(balance));
+        });
+    }
+    /**
+     * Validates that an address is a valid Aptos address format
+     *
+     * Aptos addresses are 64-character hex strings prefixed with 0x (66 chars total)
+     *
+     * @param address - The address to validate
+     * @returns true if the address format is valid
+     */
+    validateAddressFormat(address) {
+        if (address === 'dyn_send_transaction.multiple_recipients') {
+            return true;
+        }
+        // Aptos addresses are 0x followed by 64 hex characters
+        return /^0x[0-9a-fA-F]{64}$/.test(address);
+    }
+    /**
+     * Creates a transaction payload for sending APT or tokens
+     *
+     * @returns The transaction payload or undefined if invalid
+     */
+    createTransaction() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            const { value, to, nonNativeAddress, nonNativeValue } = this;
+            if (!to) {
+                throw new Error('Destination is required');
+            }
+            if (!value && !nonNativeValue) {
+                return undefined;
+            }
+            // Create the transaction payload
+            if (nonNativeAddress && nonNativeValue) {
+                // Transfer non-native token
+                return {
+                    function: '0x1::coin::transfer',
+                    functionArguments: [to, nonNativeValue],
+                    typeArguments: [nonNativeAddress],
+                };
+            }
+            if (value) {
+                // Transfer native APT
+                return {
+                    function: '0x1::coin::transfer',
+                    functionArguments: [to, value],
+                    typeArguments: ['0x1::aptos_coin::AptosCoin'],
+                };
+            }
+            return undefined;
+        });
+    }
+    /**
+     * Safely creates a transaction, returning undefined on error
+     *
+     * @returns The transaction payload or undefined if creation fails
+     */
+    createTransactionSafe() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            try {
+                return yield this.createTransaction();
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+}
+
+exports.AptosUiTransaction = AptosUiTransaction;

package/src/utils/AptosUiTransaction/AptosUiTransaction.d.ts

@@ -0,0 +1,110 @@
+import type { InputGenerateTransactionPayloadData } from '@aptos-labs/ts-sdk';
+import { Aptos } from '@aptos-labs/ts-sdk';
+import { IUITransaction, IUITransactionFormatOptions } from '@dynamic-labs/types';
+type AptosUiTransactionProps = {
+    /** Aptos Address of the sender */
+    from: string;
+    /** The [Aptos] client instance, needed to estimate gas fees and get balance */
+    client: Aptos;
+    /** The function to call when the transaction is submitted */
+    onSubmit: (transaction?: InputGenerateTransactionPayloadData) => Promise<any>;
+};
+/**
+ * Aptos UI Transaction class for managing Aptos transactions in the UI.
+ *
+ * This class implements the IUITransaction interface and provides Aptos-specific
+ * functionality for creating, formatting, and submitting transactions.
+ */
+export declare class AptosUiTransaction implements IUITransaction {
+    to: string | undefined;
+    from: string;
+    value: bigint | undefined;
+    chain: string;
+    receipt: string | undefined;
+    data: undefined;
+    fee: {
+        gas: bigint | undefined;
+    };
+    nonNativeAddress?: string;
+    nonNativeDecimal?: number;
+    nonNativeValue?: bigint;
+    nativePrice?: number;
+    private onSubmit;
+    private client;
+    constructor({ onSubmit, from, client }: AptosUiTransactionProps);
+    /**
+     * Fetches the gas fee for the transaction.
+     *
+     * Note: Aptos gas fees are typically fixed or very low, so we set a default
+     * estimate. In the future, this could be enhanced with actual gas estimation.
+     *
+     * @returns The gas fee for the transaction
+     */
+    fetchFee(): Promise<void>;
+    isGasSponsored(): boolean;
+    /**
+     * Parses a string amount into bigint octas (APT smallest unit, 1e8)
+     *
+     * @param input - The amount as a string (e.g., "1.5")
+     * @returns The amount in octas as bigint
+     */
+    parse(input: string): bigint;
+    /**
+     * Parses a non-native token amount with custom decimals
+     *
+     * @param input - The amount as a string
+     * @param decimals - The number of decimals for the token
+     * @returns The amount as bigint
+     */
+    parseNonNativeToken(input: string, decimals: number): bigint;
+    /**
+     * Formats a non-native token value back to a string
+     *
+     * @param value - The value as bigint
+     * @param decimals - The number of decimals for the token
+     * @returns The formatted amount as string
+     */
+    formatNonNativeToken: (value: bigint, decimals: number) => string;
+    /**
+     * Formats a bigint value (in octas) to a human-readable APT string
+     *
+     * @param value - The value in octas
+     * @param options - Formatting options including precision
+     * @returns The formatted amount as string
+     */
+    format(value: bigint, { precision }?: IUITransactionFormatOptions): string;
+    /**
+     * Submits the transaction by creating it and calling onSubmit
+     *
+     * @returns The transaction hash from onSubmit
+     */
+    submit(): Promise<any>;
+    /**
+     * Gets the balance of the sender's account in octas
+     *
+     * @returns The balance as bigint in octas
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Validates that an address is a valid Aptos address format
+     *
+     * Aptos addresses are 64-character hex strings prefixed with 0x (66 chars total)
+     *
+     * @param address - The address to validate
+     * @returns true if the address format is valid
+     */
+    validateAddressFormat(address: string): boolean;
+    /**
+     * Creates a transaction payload for sending APT or tokens
+     *
+     * @returns The transaction payload or undefined if invalid
+     */
+    private createTransaction;
+    /**
+     * Safely creates a transaction, returning undefined on error
+     *
+     * @returns The transaction payload or undefined if creation fails
+     */
+    private createTransactionSafe;
+}
+export {};

package/src/utils/AptosUiTransaction/AptosUiTransaction.js

@@ -0,0 +1,185 @@
+'use client'
+import { __awaiter } from '../../../_virtual/_tslib.js';
+import { formatNumberText } from '@dynamic-labs/utils';
+import { OCTAS_PER_APT } from '../constants/constants.js';
+
+/**
+ * Aptos UI Transaction class for managing Aptos transactions in the UI.
+ *
+ * This class implements the IUITransaction interface and provides Aptos-specific
+ * functionality for creating, formatting, and submitting transactions.
+ */
+class AptosUiTransaction {
+    constructor({ onSubmit, from, client }) {
+        this.chain = 'APTOS';
+        this.data = undefined;
+        this.fee = { gas: undefined };
+        /**
+         * Formats a non-native token value back to a string
+         *
+         * @param value - The value as bigint
+         * @param decimals - The number of decimals for the token
+         * @returns The formatted amount as string
+         */
+        this.formatNonNativeToken = (value, decimals) => (Number(value) / Number(Math.pow(10, decimals))).toString();
+        this.from = from;
+        this.onSubmit = onSubmit;
+        this.client = client;
+    }
+    /**
+     * Fetches the gas fee for the transaction.
+     *
+     * Note: Aptos gas fees are typically fixed or very low, so we set a default
+     * estimate. In the future, this could be enhanced with actual gas estimation.
+     *
+     * @returns The gas fee for the transaction
+     */
+    fetchFee() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.fee.gas)
+                return;
+            const transaction = yield this.createTransactionSafe();
+            if (!transaction) {
+                throw new Error('Could not create a valid Aptos transaction, check your address and value');
+            }
+            // Aptos has a simple gas model. For now, we'll use a default estimate.
+            // In the future, this could use the client to simulate the transaction.
+            // Typical Aptos transactions cost around 100-1000 octas (0.0000001 - 0.000001 APT)
+            // We'll use a conservative estimate of 1000 octas
+            this.fee.gas = BigInt(1000);
+        });
+    }
+    isGasSponsored() {
+        return false;
+    }
+    /**
+     * Parses a string amount into bigint octas (APT smallest unit, 1e8)
+     *
+     * @param input - The amount as a string (e.g., "1.5")
+     * @returns The amount in octas as bigint
+     */
+    parse(input) {
+        const floatValue = parseFloat(input);
+        const octas = Math.round(floatValue * OCTAS_PER_APT);
+        return BigInt(octas);
+    }
+    /**
+     * Parses a non-native token amount with custom decimals
+     *
+     * @param input - The amount as a string
+     * @param decimals - The number of decimals for the token
+     * @returns The amount as bigint
+     */
+    parseNonNativeToken(input, decimals) {
+        return BigInt(Math.floor(Number(input) * Math.pow(10, decimals)));
+    }
+    /**
+     * Formats a bigint value (in octas) to a human-readable APT string
+     *
+     * @param value - The value in octas
+     * @param options - Formatting options including precision
+     * @returns The formatted amount as string
+     */
+    format(value, { precision } = {}) {
+        const aptValue = Number(value) / OCTAS_PER_APT;
+        const decimalString = aptValue.toLocaleString('fullwide', {
+            maximumFractionDigits: 20,
+            minimumFractionDigits: 0,
+            useGrouping: false,
+        });
+        return formatNumberText(decimalString, { precision });
+    }
+    /**
+     * Submits the transaction by creating it and calling onSubmit
+     *
+     * @returns The transaction hash from onSubmit
+     */
+    submit() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const sendTransaction = (yield this.createTransaction());
+            return this.onSubmit(sendTransaction);
+        });
+    }
+    /**
+     * Gets the balance of the sender's account in octas
+     *
+     * @returns The balance as bigint in octas
+     */
+    getBalance() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const balance = yield this.client.getBalance({
+                accountAddress: this.from,
+                // APT coin type
+                asset: '0x1::aptos_coin::AptosCoin',
+            });
+            // Balance comes back as a number in octas (1e8 octas = 1 APT)
+            return BigInt(Math.floor(balance));
+        });
+    }
+    /**
+     * Validates that an address is a valid Aptos address format
+     *
+     * Aptos addresses are 64-character hex strings prefixed with 0x (66 chars total)
+     *
+     * @param address - The address to validate
+     * @returns true if the address format is valid
+     */
+    validateAddressFormat(address) {
+        if (address === 'dyn_send_transaction.multiple_recipients') {
+            return true;
+        }
+        // Aptos addresses are 0x followed by 64 hex characters
+        return /^0x[0-9a-fA-F]{64}$/.test(address);
+    }
+    /**
+     * Creates a transaction payload for sending APT or tokens
+     *
+     * @returns The transaction payload or undefined if invalid
+     */
+    createTransaction() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { value, to, nonNativeAddress, nonNativeValue } = this;
+            if (!to) {
+                throw new Error('Destination is required');
+            }
+            if (!value && !nonNativeValue) {
+                return undefined;
+            }
+            // Create the transaction payload
+            if (nonNativeAddress && nonNativeValue) {
+                // Transfer non-native token
+                return {
+                    function: '0x1::coin::transfer',
+                    functionArguments: [to, nonNativeValue],
+                    typeArguments: [nonNativeAddress],
+                };
+            }
+            if (value) {
+                // Transfer native APT
+                return {
+                    function: '0x1::coin::transfer',
+                    functionArguments: [to, value],
+                    typeArguments: ['0x1::aptos_coin::AptosCoin'],
+                };
+            }
+            return undefined;
+        });
+    }
+    /**
+     * Safely creates a transaction, returning undefined on error
+     *
+     * @returns The transaction payload or undefined if creation fails
+     */
+    createTransactionSafe() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                return yield this.createTransaction();
+            }
+            catch (error) {
+                return undefined;
+            }
+        });
+    }
+}
+
+export { AptosUiTransaction };

package/src/utils/AptosUiTransaction/index.d.ts

@@ -0,0 +1 @@
+export { AptosUiTransaction } from './AptosUiTransaction';

package/src/utils/constants/constants.cjs

@@ -0,0 +1,8 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const OCTAS_PER_APT = 1e8;
+
+exports.OCTAS_PER_APT = OCTAS_PER_APT;

package/src/utils/constants/constants.d.ts

@@ -0,0 +1 @@
+export declare const OCTAS_PER_APT = 100000000;

package/src/utils/constants/constants.js

@@ -0,0 +1,4 @@
+'use client'
+const OCTAS_PER_APT = 1e8;
+
+export { OCTAS_PER_APT };

package/src/utils/constants/index.d.ts

@@ -0,0 +1 @@
+export { OCTAS_PER_APT } from './constants';