@mysten/sui 2.26.1 → 2.26.2

package/docs/migrations/sui-2.0/dapp-kit.md

@@ -5,9 +5,8 @@
 This guide helps you migrate from the original `@mysten/dapp-kit` (legacy) to the new
 `@mysten/dapp-kit-react` package.
 
-> **Note:** The legacy `@mysten/dapp-kit` package will continue to work with the latest SDK, but it only
-> supports JSON-RPC and will not receive further updates. We recommend migrating to
-> `@mysten/dapp-kit-react` for new features and gRPC support.
+> **Note:** The legacy `@mysten/dapp-kit` package only supports the deprecated JSON RPC API and will not
+> receive further updates. Migrate to `@mysten/dapp-kit-react` for gRPC support and new features.
 
 ## Overview
 

package/docs/migrations/sui-2.0/kiosk.md

@@ -1,6 +1,6 @@
 # @mysten/kiosk
 
-> Migrate @mysten/kiosk to 2.0 with client extension pattern and KioskTransaction
+> >- Migrate @mysten/kiosk to 2.0 with client extension pattern and KioskTransaction
 
 This package now exports a client extension that integrates with Sui clients.
 

package/docs/migrations/sui-2.0/sui.md

@@ -1,6 +1,6 @@
 # @mysten/sui
 
-> Migrate @mysten/sui from 1.x to 2.0 with gRPC clients, Core API, and BCS changes
+> >- Migrate @mysten/sui from 1.x to 2.0 with gRPC clients, Core API, and BCS changes
 
 ## Removal of `SuiClient` exports
 

package/docs/transactions/signing-and-execution.md

@@ -75,29 +75,24 @@ Available keypair types:
 
 ## With dapp-kit (React frontend)
 
-In a React app, use the `useSignAndExecuteTransaction` hook. The user's connected wallet signs and
-submits the transaction:
+In a React app, use the `useDAppKit` hook. The user's connected wallet signs and submits the
+transaction:
 
 ```tsx
 
 function SendButton() {
-	const { mutate: signAndExecute } = useSignAndExecuteTransaction();
+	const dAppKit = useDAppKit();
 
-	function handleClick() {
+	async function handleClick() {
 		const tx = new Transaction();
 		// ... build your transaction ...
 
-		signAndExecute(
-			{ transaction: tx },
-			{
-				onSuccess: (result) => {
-					console.log('Transaction digest:', result.digest);
-				},
-				onError: (error) => {
-					console.error('Transaction failed:', error);
-				},
-			},
-		);
+		const result = await dAppKit.signAndExecuteTransaction({ transaction: tx });
+		if (result.FailedTransaction) {
+			throw new Error(`Transaction failed: ${result.FailedTransaction.status.error?.message}`);
+		}
+
+		console.log('Transaction digest:', result.Transaction.digest);
 	}
 
 	return <button onClick={handleClick}>Send</button>;
@@ -127,20 +122,14 @@ const { signature } = await keypair.signTransaction(bytes);
 ```tsx
 
 function SignButton() {
-	const { mutate: signTransaction } = useSignTransaction();
+	const dAppKit = useDAppKit();
 
-	function handleClick() {
+	async function handleClick() {
 		const tx = new Transaction();
 		// ... build your transaction ...
 
-		signTransaction(
-			{ transaction: tx },
-			{
-				onSuccess: ({ bytes, signature }) => {
-					// Send bytes + signature to your backend, sponsor, etc.
-				},
-			},
-		);
+		const { bytes, signature } = await dAppKit.signTransaction({ transaction: tx });
+		// Send bytes + signature to your backend, sponsor, etc.
 	}
 
 	return <button onClick={handleClick}>Sign</button>;

package/docs/utils/derived_objects.md

@@ -1,6 +1,6 @@
 # Derived Objects
 
-> Compute derived object IDs from parent objects for deterministic offline derivation.
+> >- Compute derived object IDs from parent objects for deterministic offline derivation.
 
 Derived objects enable deterministic IDs for objects, enabling offline derivation of object IDs.
 [Click here to read more.](https://docs.sui.io/concepts/sui-move-concepts/derived-objects)

package/docs/utils/index.md

@@ -1,6 +1,6 @@
 # The `@mysten/sui/utils` package
 
-> Utility functions for addresses, coins, and common operations in the Sui TypeScript SDK.
+> >- Utility functions for addresses, coins, and common operations in the Sui TypeScript SDK.
 
 This package contains some utilities that simplify common operations when working with the Sui
 TypeScript SDK.

package/package.json

@@ -3,7 +3,7 @@
   "author": "Mysten Labs <build@mystenlabs.com>",
   "description": "Sui TypeScript API",
   "homepage": "https://sdk.mystenlabs.com",
-  "version": "2.26.1",
+  "version": "2.26.2",
   "license": "Apache-2.0",
   "sideEffects": false,
   "files": [
@@ -131,45 +131,45 @@
     "access": "public"
   },
   "devDependencies": {
-    "@0no-co/graphqlsp": "^1.17.0",
-    "@graphql-codegen/add": "^7.0.1",
-    "@graphql-codegen/cli": "^7.1.2",
-    "@graphql-codegen/typed-document-node": "^7.0.3",
-    "@graphql-codegen/typescript": "6.0.2",
-    "@graphql-codegen/typescript-document-nodes": "6.0.1",
-    "@graphql-codegen/typescript-operations": "^6.0.3",
+    "@0no-co/graphqlsp": "^1.17.3",
+    "@graphql-codegen/add": "^7.1.0",
+    "@graphql-codegen/cli": "^7.2.0",
+    "@graphql-codegen/typed-document-node": "^7.1.0",
+    "@graphql-codegen/typescript": "6.1.0",
+    "@graphql-codegen/typescript-document-nodes": "6.1.0",
+    "@graphql-codegen/typescript-operations": "^6.1.6",
     "@grpc/grpc-js": ">=1.14.4",
-    "@parcel/watcher": "^2.5.4",
+    "@parcel/watcher": "^2.6.0",
     "@protobuf-ts/grpc-transport": "^2.11.1",
-    "@types/node": "^25.9.3",
+    "@types/node": "^26.2.0",
     "@types/tmp": "^0.2.6",
     "cross-env": "^10.1.0",
     "graphql-config": "^5.1.5",
-    "msw": "^2.14.6",
+    "msw": "^2.15.0",
     "tmp": "^0.2.7",
     "ts-retry-promise": "^0.8.1",
-    "typescript": "^6.0.3",
-    "vite": "^8.0.16",
+    "typescript": "^7.0.2",
+    "vite": "^8.2.1",
     "vite-tsconfig-paths": "^6.0.4",
-    "vitest": "^4.1.8",
-    "wait-on": "^9.0.10"
+    "vitest": "^4.1.10",
+    "wait-on": "^9.1.0"
   },
   "dependencies": {
     "@graphql-typed-document-node/core": "^3.2.0",
-    "@noble/curves": "^2.2.0",
-    "@noble/hashes": "^2.2.0",
+    "@noble/curves": "^2.3.0",
+    "@noble/hashes": "^2.3.0",
     "@protobuf-ts/grpcweb-transport": "^2.11.1",
     "@protobuf-ts/runtime": "^2.11.1",
     "@protobuf-ts/runtime-rpc": "^2.11.1",
-    "@scure/base": "^2.2.0",
-    "@scure/bip32": "^2.2.0",
-    "@scure/bip39": "^2.2.0",
-    "gql.tada": "^1.10.1",
-    "graphql": "^16.14.2",
-    "poseidon-lite": "0.2.1",
+    "@scure/base": "^2.3.0",
+    "@scure/bip32": "^2.3.0",
+    "@scure/bip39": "^2.3.0",
+    "gql.tada": "^1.11.3",
+    "graphql": "^17.0.2",
+    "poseidon-lite": "0.3.0",
     "valibot": "^1.4.2",
-    "@mysten/bcs": "^2.1.0",
-    "@mysten/utils": "^0.4.0"
+    "@mysten/bcs": "^2.1.1",
+    "@mysten/utils": "^0.4.1"
   },
   "scripts": {
     "clean": "rm -rf tsconfig.tsbuildinfo ./dist",

package/src/bcs/pure.ts

@@ -7,16 +7,7 @@ import type { BcsType } from '@mysten/bcs';
 import { Address } from './bcs.js';
 
 export type BasePureType =
-	| 'u8'
-	| 'u16'
-	| 'u32'
-	| 'u64'
-	| 'u128'
-	| 'u256'
-	| 'bool'
-	| 'id'
-	| 'string'
-	| 'address';
+	'u8' | 'u16' | 'u32' | 'u64' | 'u128' | 'u256' | 'bool' | 'id' | 'string' | 'address';
 
 interface PureShapeByType {
 	u8: number;

package/src/bcs/types.ts

@@ -132,6 +132,4 @@ type ValidDuring = {
  * Indications the expiration time for a transaction.
  */
 export type TransactionExpiration =
-	| { None: null }
-	| { Epoch: number }
-	| { ValidDuring: ValidDuring };
+	{ None: null } | { Epoch: number } | { ValidDuring: ValidDuring };

package/src/client/types.ts

@@ -411,8 +411,7 @@ export namespace SuiClientTypes {
 	}
 
 	export type WaitForTransactionOptions<Include extends TransactionInclude = {}> =
-		| WaitForTransactionByDigest<Include>
-		| WaitForTransactionByResult<Include>;
+		WaitForTransactionByDigest<Include> | WaitForTransactionByResult<Include>;
 
 	export interface WaitForTransactionByDigest<
 		Include extends TransactionInclude = {},

package/src/cryptography/signature-scheme.ts

@@ -27,11 +27,6 @@ export const SIGNATURE_FLAG_TO_SCHEME = {
 } as const;
 
 export type SignatureScheme =
-	| 'ED25519'
-	| 'Secp256k1'
-	| 'Secp256r1'
-	| 'MultiSig'
-	| 'ZkLogin'
-	| 'Passkey';
+	'ED25519' | 'Secp256k1' | 'Secp256r1' | 'MultiSig' | 'ZkLogin' | 'Passkey';
 
 export type SignatureFlag = keyof typeof SIGNATURE_FLAG_TO_SCHEME;

package/src/graphql/client.ts

@@ -15,10 +15,7 @@ import { normalizeStructTag } from '../utils/sui-types.js';
 import { deriveDynamicFieldID } from '../utils/dynamic-fields.js';
 import type { TransactionPlugin } from '../transactions/index.js';
 
-export type GraphQLDocument<
-	Result = Record<string, unknown>,
-	Variables = Record<string, unknown>,
-> =
+export type GraphQLDocument<Result = Record<string, unknown>, Variables = Record<string, unknown>> =
 	| string
 	| DocumentNode
 	| TypedDocumentString<Result, Variables>

package/src/graphql/core.ts

@@ -215,32 +215,30 @@ export class GraphQLCoreClient extends CoreClient {
 		);
 
 		return {
-			objects: objects.nodes.map(
-				(obj): SuiClientTypes.Object<Include> => ({
-					objectId: obj.address,
-					version: obj.version?.toString()!,
-					digest: obj.digest!,
-					owner: mapOwner(obj.owner!),
-					type: obj.contents?.type?.repr!,
-					content: (obj.contents?.bcs
-						? fromBase64(obj.contents.bcs)
-						: undefined) as SuiClientTypes.Object<Include>['content'],
-					previousTransaction: (obj.previousTransaction?.digest ??
-						undefined) as SuiClientTypes.Object<Include>['previousTransaction'],
-					objectBcs: (obj.objectBcs
-						? fromBase64(obj.objectBcs)
-						: undefined) as SuiClientTypes.Object<Include>['objectBcs'],
-					json: (options.include?.json
-						? obj.contents?.json
-							? (obj.contents.json as Record<string, unknown>)
-							: null
-						: undefined) as SuiClientTypes.Object<Include>['json'],
-					display: mapDisplay(
-						options.include?.display,
-						obj.contents?.display,
-					) as SuiClientTypes.Object<Include>['display'],
-				}),
-			),
+			objects: objects.nodes.map((obj): SuiClientTypes.Object<Include> => ({
+				objectId: obj.address,
+				version: obj.version?.toString()!,
+				digest: obj.digest!,
+				owner: mapOwner(obj.owner!),
+				type: obj.contents?.type?.repr!,
+				content: (obj.contents?.bcs
+					? fromBase64(obj.contents.bcs)
+					: undefined) as SuiClientTypes.Object<Include>['content'],
+				previousTransaction: (obj.previousTransaction?.digest ??
+					undefined) as SuiClientTypes.Object<Include>['previousTransaction'],
+				objectBcs: (obj.objectBcs
+					? fromBase64(obj.objectBcs)
+					: undefined) as SuiClientTypes.Object<Include>['objectBcs'],
+				json: (options.include?.json
+					? obj.contents?.json
+						? (obj.contents.json as Record<string, unknown>)
+						: null
+					: undefined) as SuiClientTypes.Object<Include>['json'],
+				display: mapDisplay(
+					options.include?.display,
+					obj.contents?.display,
+				) as SuiClientTypes.Object<Include>['display'],
+			})),
 			hasNextPage: objects.pageInfo.hasNextPage,
 			cursor: objects.pageInfo.endCursor ?? null,
 		};
@@ -266,16 +264,14 @@ export class GraphQLCoreClient extends CoreClient {
 		return {
 			cursor: coins.pageInfo.endCursor ?? null,
 			hasNextPage: coins.pageInfo.hasNextPage,
-			objects: coins.nodes.map(
-				(coin): SuiClientTypes.Coin => ({
-					objectId: coin.address,
-					version: coin.version?.toString()!,
-					digest: coin.digest!,
-					owner: mapOwner(coin.owner!),
-					type: coin.contents?.type?.repr!,
-					balance: (coin.contents?.json as { balance: string })?.balance,
-				}),
-			),
+			objects: coins.nodes.map((coin): SuiClientTypes.Coin => ({
+				objectId: coin.address,
+				version: coin.version?.toString()!,
+				digest: coin.digest!,
+				owner: mapOwner(coin.owner!),
+				type: coin.contents?.type?.repr!,
+				balance: (coin.contents?.json as { balance: string })?.balance,
+			})),
 		};
 	}
 

package/src/grpc/client.ts

@@ -108,8 +108,7 @@ export interface GrpcWaitForTransactionByResult<
 }
 
 export type GrpcWaitForTransactionOptions<Include extends GrpcTransactionInclude = {}> =
-	| GrpcWaitForTransactionByDigest<Include>
-	| GrpcWaitForTransactionByResult<Include>;
+	GrpcWaitForTransactionByDigest<Include> | GrpcWaitForTransactionByResult<Include>;
 
 export interface GrpcExecuteTransactionOptions<
 	Include extends GrpcTransactionInclude = {},

package/src/grpc/core.ts

@@ -240,28 +240,26 @@ export class GrpcCoreClient extends CoreClient {
 			{ abort: options.signal },
 		);
 
-		const objects = response.response.objects.map(
-			(object): SuiClientTypes.Object<Include> => ({
-				objectId: object.objectId!,
-				version: object.version?.toString()!,
-				digest: object.digest!,
-				content: object.contents?.value as SuiClientTypes.Object<Include>['content'],
-				owner: mapOwner(object.owner)!,
-				type: object.objectType!,
-				previousTransaction: (object.previousTransaction ??
-					undefined) as SuiClientTypes.Object<Include>['previousTransaction'],
-				objectBcs: object.bcs?.value as SuiClientTypes.Object<Include>['objectBcs'],
-				json: (options.include?.json
-					? object.json
-						? (Value.toJson(object.json) as Record<string, unknown>)
-						: null
-					: undefined) as SuiClientTypes.Object<Include>['json'],
-				display: mapDisplayProto(
-					options.include?.display,
-					object.display,
-				) as SuiClientTypes.Object<Include>['display'],
-			}),
-		);
+		const objects = response.response.objects.map((object): SuiClientTypes.Object<Include> => ({
+			objectId: object.objectId!,
+			version: object.version?.toString()!,
+			digest: object.digest!,
+			content: object.contents?.value as SuiClientTypes.Object<Include>['content'],
+			owner: mapOwner(object.owner)!,
+			type: object.objectType!,
+			previousTransaction: (object.previousTransaction ??
+				undefined) as SuiClientTypes.Object<Include>['previousTransaction'],
+			objectBcs: object.bcs?.value as SuiClientTypes.Object<Include>['objectBcs'],
+			json: (options.include?.json
+				? object.json
+					? (Value.toJson(object.json) as Record<string, unknown>)
+					: null
+				: undefined) as SuiClientTypes.Object<Include>['json'],
+			display: mapDisplayProto(
+				options.include?.display,
+				object.display,
+			) as SuiClientTypes.Object<Include>['display'],
+		}));
 
 		return {
 			objects,
@@ -289,16 +287,14 @@ export class GrpcCoreClient extends CoreClient {
 		);
 
 		return {
-			objects: response.response.objects.map(
-				(object): SuiClientTypes.Coin => ({
-					objectId: object.objectId!,
-					version: object.version?.toString()!,
-					digest: object.digest!,
-					owner: mapOwner(object.owner)!,
-					type: object.objectType!,
-					balance: object.balance?.toString()!,
-				}),
-			),
+			objects: response.response.objects.map((object): SuiClientTypes.Coin => ({
+				objectId: object.objectId!,
+				version: object.version?.toString()!,
+				digest: object.digest!,
+				owner: mapOwner(object.owner)!,
+				type: object.objectType!,
+				balance: object.balance?.toString()!,
+			})),
 			cursor: response.response.nextPageToken ? toBase64(response.response.nextPageToken) : null,
 			hasNextPage: response.response.nextPageToken !== undefined,
 		};

package/src/jsonRpc/core.ts

@@ -293,19 +293,17 @@ export class JSONRpcCoreClient extends CoreClient {
 		});
 
 		return {
-			objects: coins.data.map(
-				(coin): SuiClientTypes.Coin => ({
-					objectId: coin.coinObjectId,
-					version: coin.version,
-					digest: coin.digest,
-					balance: coin.balance,
-					type: normalizeStructTag(`0x2::coin::Coin<${coin.coinType}>`),
-					owner: {
-						$kind: 'AddressOwner' as const,
-						AddressOwner: options.owner,
-					},
-				}),
-			),
+			objects: coins.data.map((coin): SuiClientTypes.Coin => ({
+				objectId: coin.coinObjectId,
+				version: coin.version,
+				digest: coin.digest,
+				balance: coin.balance,
+				type: normalizeStructTag(`0x2::coin::Coin<${coin.coinType}>`),
+				owner: {
+					$kind: 'AddressOwner' as const,
+					AddressOwner: options.owner,
+				},
+			})),
 			hasNextPage: coins.hasNextPage,
 			cursor: coins.nextCursor ?? null,
 		};
@@ -815,20 +813,18 @@ export class JSONRpcCoreClient extends CoreClient {
 		});
 
 		return {
-			events: page.data.map(
-				(event): SuiClientTypes.EventEntry => ({
-					packageId: normalizeSuiAddress(event.packageId),
-					module: event.transactionModule,
-					sender: normalizeSuiAddress(event.sender),
-					eventType: normalizeStructTag(event.type),
-					bcs: event.bcsEncoding === 'base58' ? fromBase58(event.bcs) : fromBase64(event.bcs),
-					json: (event.parsedJson as Record<string, unknown>) ?? null,
-					// queryEvents responses do not include checkpoint information
-					checkpoint: null,
-					transactionDigest: event.id.txDigest,
-					eventIndex: Number(event.id.eventSeq),
-				}),
-			),
+			events: page.data.map((event): SuiClientTypes.EventEntry => ({
+				packageId: normalizeSuiAddress(event.packageId),
+				module: event.transactionModule,
+				sender: normalizeSuiAddress(event.sender),
+				eventType: normalizeStructTag(event.type),
+				bcs: event.bcsEncoding === 'base58' ? fromBase58(event.bcs) : fromBase64(event.bcs),
+				json: (event.parsedJson as Record<string, unknown>) ?? null,
+				// queryEvents responses do not include checkpoint information
+				checkpoint: null,
+				transactionDigest: event.id.txDigest,
+				eventIndex: Number(event.id.eventSeq),
+			})),
 			hasNextPage: page.hasNextPage,
 			startCursor: page.data.length ? JSON.stringify(page.data[0].id) : null,
 			endCursor:

package/src/transactions/Transaction.ts

@@ -50,8 +50,7 @@ export type TransactionResult = Extract<Argument, { Result: unknown }> &
 	Extract<Argument, { NestedResult: unknown }>[];
 
 export type TransactionResultArgument =
-	| Extract<Argument, { Result: unknown }>
-	| readonly Extract<Argument, { NestedResult: unknown }>[];
+	Extract<Argument, { Result: unknown }> | readonly Extract<Argument, { NestedResult: unknown }>[];
 
 export type AsyncTransactionThunk<
 	T extends TransactionResultArgument | void = TransactionResultArgument | void,

package/src/transactions/executor/parallel.ts

@@ -51,8 +51,7 @@ export interface ParallelTransactionExecutorAddressBalanceOptions extends Parall
 
 /** Options for ParallelTransactionExecutor - discriminated union based on gasMode */
 export type ParallelTransactionExecutorOptions =
-	| ParallelTransactionExecutorCoinOptions
-	| ParallelTransactionExecutorAddressBalanceOptions;
+	ParallelTransactionExecutorCoinOptions | ParallelTransactionExecutorAddressBalanceOptions;
 
 interface CoinWithBalance {
 	id: string;

package/src/transactions/executor/serial.ts

@@ -27,8 +27,7 @@ export interface SerialTransactionExecutorAddressBalanceOptions extends SerialTr
 }
 
 export type SerialTransactionExecutorOptions =
-	| SerialTransactionExecutorCoinOptions
-	| SerialTransactionExecutorAddressBalanceOptions;
+	SerialTransactionExecutorCoinOptions | SerialTransactionExecutorAddressBalanceOptions;
 
 export class SerialTransactionExecutor {
 	#queue = new SerialQueue();

package/src/version.ts

@@ -3,4 +3,4 @@
 
 // This file is generated by genversion.mjs. Do not edit it directly.
 
-export const PACKAGE_VERSION = '2.26.1';
+export const PACKAGE_VERSION = '2.26.2';