@mysten/sui 2.2.0 → 2.3.1

package/src/transactions/Transaction.ts

@@ -31,6 +31,7 @@ import { createPure } from './pure.js';
 import { TransactionDataBuilder } from './TransactionData.js';
 import { getIdFromCallArg } from './utils.js';
 import { namedPackagesPlugin } from './plugins/NamedPackagesPlugin.js';
+import { COIN_WITH_BALANCE, resolveCoinBalance } from './intents/CoinWithBalance.js';
 import type { ClientWithCoreApi } from '../client/core.js';
 
 export type TransactionObjectArgument =
@@ -189,6 +190,16 @@ export class Transaction {
 		newTransaction.#commandSection = newTransaction.#data.commands.slice();
 		newTransaction.#availableResults = new Set(newTransaction.#commandSection.map((_, i) => i));
 
+		if (!newTransaction.isPreparedForSerialization({ supportedIntents: [COIN_WITH_BALANCE] })) {
+			throw new Error(
+				'Transaction has unresolved intents or async thunks. Call `prepareForSerialization` before copying.',
+			);
+		}
+
+		if (newTransaction.#data.commands.some((cmd) => cmd.$Intent?.name === COIN_WITH_BALANCE)) {
+			newTransaction.addIntentResolver(COIN_WITH_BALANCE, resolveCoinBalance);
+		}
+
 		return newTransaction;
 	}
 
@@ -661,6 +672,31 @@ export class Transaction {
 		return signer.signTransaction(bytes);
 	}
 
+	/**
+	 * Checks if the transaction is prepared for serialization to JSON.
+	 * This means:
+	 *  - All async thunks have been fully resolved
+	 *  - All transaction intents have been resolved (unless in supportedIntents)
+	 *
+	 * Unlike `isFullyResolved()`, this does not require the sender, gas payment,
+	 * budget, or object versions to be set.
+	 */
+	isPreparedForSerialization(options: { supportedIntents?: string[] } = {}) {
+		if (this.#pendingPromises.size > 0) {
+			return false;
+		}
+
+		if (
+			this.#data.commands.some(
+				(cmd) => cmd.$Intent && !options.supportedIntents?.includes(cmd.$Intent.name),
+			)
+		) {
+			return false;
+		}
+
+		return true;
+	}
+
 	/**
 	 *  Ensures that:
 	 *  - All objects have been fully resolved to a specific version
@@ -673,15 +709,11 @@ export class Transaction {
 	 *  When true, the transaction will always be built to the same bytes and digest (unless the transaction is mutated)
 	 */
 	isFullyResolved() {
-		if (!this.#data.sender) {
-			return false;
-		}
-
-		if (this.#pendingPromises.size > 0) {
+		if (!this.isPreparedForSerialization()) {
 			return false;
 		}
 
-		if (this.#data.commands.some((cmd) => cmd.$Intent)) {
+		if (!this.#data.sender) {
 			return false;
 		}
 

package/src/transactions/executor/serial.ts

@@ -79,6 +79,10 @@ export class SerialTransactionExecutor {
 	}
 
 	#buildTransaction = async (transaction: Transaction) => {
+		await transaction.prepareForSerialization({
+			client: this.#client,
+			supportedIntents: ['CoinWithBalance'],
+		});
 		const copy = Transaction.from(transaction);
 
 		if (this.#gasMode === 'addressBalance') {

package/src/transactions/intents/CoinWithBalance.ts

@@ -14,7 +14,7 @@ import type { Transaction, TransactionResult } from '../Transaction.js';
 import type { TransactionDataBuilder } from '../TransactionData.js';
 import type { ClientWithCoreApi, SuiClientTypes } from '../../client/index.js';
 
-const COIN_WITH_BALANCE = 'CoinWithBalance';
+export const COIN_WITH_BALANCE = 'CoinWithBalance';
 const SUI_TYPE = normalizeStructTag('0x2::sui::SUI');
 
 export function coinWithBalance({
@@ -56,7 +56,7 @@ const CoinWithBalanceData = object({
 	balance: bigint(),
 });
 
-async function resolveCoinBalance(
+export async function resolveCoinBalance(
 	transactionData: TransactionDataBuilder,
 	buildOptions: BuildTransactionOptions,
 	next: () => Promise<void>,

package/src/version.ts

@@ -3,5 +3,5 @@
 
 // This file is generated by genversion.mjs. Do not edit it directly.
 
-export const PACKAGE_VERSION = '2.2.0';
+export const PACKAGE_VERSION = '2.3.1';
 export const TARGETED_RPC_VERSION = '1.66.0';