@mysten/sui 2.26.1 → 2.27.0

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.27.0",
   "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

@@ -326,6 +326,16 @@ export namespace SuiClientTypes {
 		digest: string;
 		signatures: string[];
 		epoch: string | null;
+		/**
+		 * Timestamp of the checkpoint containing this transaction, in milliseconds since Unix epoch.
+		 * `null` for transactions that have not been checkpointed, including execution and simulation results.
+		 */
+		timestampMs: number | null;
+		/**
+		 * Sequence number of the checkpoint containing this transaction.
+		 * `null` for transactions that have not been checkpointed, including execution and simulation results.
+		 */
+		checkpoint: string | null;
 		status: ExecutionStatus;
 		balanceChanges: Include extends { balanceChanges: true } ? BalanceChange[] : undefined;
 		effects: Include extends { effects: true } ? TransactionEffects : undefined;
@@ -411,8 +421,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/client/utils.ts

@@ -478,11 +478,108 @@ export function parseTransactionEffectsBcs(effects: Uint8Array): SuiClientTypes.
 	}
 }
 
-function parseTransactionEffectsV1(_: {
+function parseTransactionEffectsV1({
+	bytes,
+	effects,
+}: {
 	bytes: Uint8Array;
 	effects: NonNullable<(typeof bcs.TransactionEffects.$inferType)['V1']>;
 }): SuiClientTypes.TransactionEffects {
-	throw new Error('V1 effects are not supported yet');
+	const modifiedAtVersions = new Map(effects.modifiedAtVersions);
+	const sharedObjects = new Map(effects.sharedObjects.map((object) => [object.objectId, object]));
+	const mapChangedObject = (
+		reference: (typeof effects.deleted)[number],
+		change: Pick<
+			SuiClientTypes.ChangedObject,
+			'inputState' | 'outputState' | 'outputOwner' | 'idOperation'
+		>,
+	): SuiClientTypes.ChangedObject => {
+		const sharedInput = sharedObjects.get(reference.objectId);
+		return {
+			objectId: reference.objectId,
+			inputState: change.inputState,
+			inputVersion:
+				change.inputState === 'Exists'
+					? (sharedInput?.version ?? modifiedAtVersions.get(reference.objectId) ?? null)
+					: null,
+			inputDigest: change.inputState === 'Exists' ? (sharedInput?.digest ?? null) : null,
+			inputOwner: null,
+			outputState: change.outputState,
+			outputVersion: change.outputState === 'DoesNotExist' ? null : reference.version,
+			outputDigest: change.outputState === 'DoesNotExist' ? null : reference.digest,
+			outputOwner: change.outputOwner,
+			idOperation: change.idOperation,
+		};
+	};
+
+	const written = (
+		changes: typeof effects.created,
+		inputState: 'DoesNotExist' | 'Exists',
+		idOperation: 'Created' | 'None',
+	): SuiClientTypes.ChangedObject[] =>
+		changes.map(([reference, owner]) =>
+			mapChangedObject(reference, {
+				inputState,
+				outputState: 'ObjectWrite',
+				outputOwner: owner,
+				idOperation,
+			}),
+		);
+
+	const removed = (
+		changes: typeof effects.deleted,
+		inputState: 'DoesNotExist' | 'Exists',
+		idOperation: 'Deleted' | 'None',
+	): SuiClientTypes.ChangedObject[] =>
+		changes.map((reference) =>
+			mapChangedObject(reference, {
+				inputState,
+				outputState: 'DoesNotExist',
+				outputOwner: null,
+				idOperation,
+			}),
+		);
+
+	const changedObjects = [
+		...written(effects.created, 'DoesNotExist', 'Created'),
+		...written(effects.mutated, 'Exists', 'None'),
+		...written(effects.unwrapped, 'DoesNotExist', 'None'),
+		...removed(effects.deleted, 'Exists', 'Deleted'),
+		...removed(effects.unwrappedThenDeleted, 'DoesNotExist', 'Deleted'),
+		...removed(effects.wrapped, 'Exists', 'None'),
+	];
+	const gasObjectId = effects.gasObject[0].objectId;
+	const gasObject = changedObjects.find((object) => object.objectId === gasObjectId) ?? null;
+	const changedObjectIds = new Set(changedObjects.map((object) => object.objectId));
+	const lamportVersion = effects.modifiedAtVersions.reduce(
+		(max, [, version]) => (BigInt(version) > max ? BigInt(version) : max),
+		0n,
+	);
+
+	return {
+		bcs: bytes,
+		version: 1,
+		status:
+			effects.status.$kind === 'Success'
+				? { success: true, error: null }
+				: { success: false, error: parseBcsExecutionError(effects.status.Failure) },
+		gasUsed: effects.gasUsed,
+		transactionDigest: effects.transactionDigest,
+		gasObject,
+		eventsDigest: effects.eventsDigest,
+		dependencies: effects.dependencies,
+		lamportVersion: (lamportVersion + 1n).toString(),
+		changedObjects,
+		unchangedConsensusObjects: effects.sharedObjects
+			.filter((object) => !changedObjectIds.has(object.objectId))
+			.map((object) => ({
+				kind: 'ReadOnlyRoot',
+				objectId: object.objectId,
+				version: object.version,
+				digest: object.digest,
+			})),
+		auxiliaryDataDigest: null,
+	};
 }
 
 function parseTransactionEffectsV2({

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,
+			})),
 		};
 	}
 
@@ -1126,6 +1122,9 @@ function parseTransaction<Include extends SuiClientTypes.TransactionInclude = {}
 
 	const bcsBytes =
 		include?.bcs && transaction.transactionBcs ? fromBase64(transaction.transactionBcs) : undefined;
+	const timestampMs = transaction.effects?.timestamp
+		? Date.parse(transaction.effects.timestamp)
+		: null;
 
 	const result: SuiClientTypes.Transaction<Include> = {
 		digest: transaction.digest!,
@@ -1134,6 +1133,8 @@ function parseTransaction<Include extends SuiClientTypes.TransactionInclude = {}
 			? parseTransactionEffectsBcs(fromBase64(transaction.effects?.effectsBcs!))
 			: undefined) as SuiClientTypes.Transaction<Include>['effects'],
 		epoch: transaction.effects?.epoch?.epochId?.toString() ?? null,
+		timestampMs: timestampMs !== null && !Number.isNaN(timestampMs) ? timestampMs : null,
+		checkpoint: transaction.effects?.checkpoint?.sequenceNumber?.toString() ?? null,
 		objectTypes: (include?.objectTypes
 			? objectTypes
 			: undefined) as SuiClientTypes.Transaction<Include>['objectTypes'],

package/src/graphql/generated/queries.ts

@@ -380,7 +380,7 @@ export type SimulateTransactionQueryVariables = Exact<{
 }>;
 
 
-export type SimulateTransactionQuery = { simulateTransaction: { effects: { transaction: { digest: string, transactionJson?: unknown, transactionBcs?: string | null, signatures: Array<{ signatureBytes: string | null }>, effects: { status: ExecutionStatus | null, effectsBcs?: string | null, effectsJson?: unknown, balanceChangesJson?: unknown, executionError: { message: string, abortCode: string | null, identifier: string | null, constant: string | null, sourceLineNumber: number | null, instructionOffset: number | null, module: { name: string, package: { address: string } | null } | null, function: { name: string } | null } | null, epoch: { epochId: number } | null, objectChanges?: { nodes: Array<{ address: string, outputState: { asMoveObject: { contents: { type: { repr: string } | null } | null } | null } | null }> } | null, events?: { pageInfo: { hasNextPage: boolean }, nodes: Array<{ transactionModule: { name: string, package: { address: string } | null } | null, sender: { address: string } | null, contents: { bcs: string | null, json: unknown, type: { repr: string } | null } | null }> } | null } | null } | null } | null, outputs?: Array<{ returnValues: Array<{ value: { bcs: string | null } | null }> | null, mutatedReferences: Array<{ value: { bcs: string | null } | null }> | null }> | null } };
+export type SimulateTransactionQuery = { simulateTransaction: { effects: { transaction: { digest: string, transactionJson?: unknown, transactionBcs?: string | null, signatures: Array<{ signatureBytes: string | null }>, effects: { status: ExecutionStatus | null, timestamp: string | null, effectsBcs?: string | null, effectsJson?: unknown, balanceChangesJson?: unknown, checkpoint: { sequenceNumber: number } | null, executionError: { message: string, abortCode: string | null, identifier: string | null, constant: string | null, sourceLineNumber: number | null, instructionOffset: number | null, module: { name: string, package: { address: string } | null } | null, function: { name: string } | null } | null, epoch: { epochId: number } | null, objectChanges?: { nodes: Array<{ address: string, outputState: { asMoveObject: { contents: { type: { repr: string } | null } | null } | null } | null }> } | null, events?: { pageInfo: { hasNextPage: boolean }, nodes: Array<{ transactionModule: { name: string, package: { address: string } | null } | null, sender: { address: string } | null, contents: { bcs: string | null, json: unknown, type: { repr: string } | null } | null }> } | null } | null } | null } | null, outputs?: Array<{ returnValues: Array<{ value: { bcs: string | null } | null }> | null, mutatedReferences: Array<{ value: { bcs: string | null } | null }> | null }> | null } };
 
 export type ExecuteTransactionMutationVariables = Exact<{
   transactionDataBcs: string;
@@ -394,7 +394,7 @@ export type ExecuteTransactionMutationVariables = Exact<{
 }>;
 
 
-export type ExecuteTransactionMutation = { executeTransaction: { effects: { transaction: { digest: string, transactionJson?: unknown, transactionBcs?: string | null, signatures: Array<{ signatureBytes: string | null }>, effects: { status: ExecutionStatus | null, effectsBcs?: string | null, effectsJson?: unknown, balanceChangesJson?: unknown, executionError: { message: string, abortCode: string | null, identifier: string | null, constant: string | null, sourceLineNumber: number | null, instructionOffset: number | null, module: { name: string, package: { address: string } | null } | null, function: { name: string } | null } | null, epoch: { epochId: number } | null, objectChanges?: { nodes: Array<{ address: string, outputState: { asMoveObject: { contents: { type: { repr: string } | null } | null } | null } | null }> } | null, events?: { pageInfo: { hasNextPage: boolean }, nodes: Array<{ transactionModule: { name: string, package: { address: string } | null } | null, sender: { address: string } | null, contents: { bcs: string | null, json: unknown, type: { repr: string } | null } | null }> } | null } | null } | null } | null } };
+export type ExecuteTransactionMutation = { executeTransaction: { effects: { transaction: { digest: string, transactionJson?: unknown, transactionBcs?: string | null, signatures: Array<{ signatureBytes: string | null }>, effects: { status: ExecutionStatus | null, timestamp: string | null, effectsBcs?: string | null, effectsJson?: unknown, balanceChangesJson?: unknown, checkpoint: { sequenceNumber: number } | null, executionError: { message: string, abortCode: string | null, identifier: string | null, constant: string | null, sourceLineNumber: number | null, instructionOffset: number | null, module: { name: string, package: { address: string } | null } | null, function: { name: string } | null } | null, epoch: { epochId: number } | null, objectChanges?: { nodes: Array<{ address: string, outputState: { asMoveObject: { contents: { type: { repr: string } | null } | null } | null } | null }> } | null, events?: { pageInfo: { hasNextPage: boolean }, nodes: Array<{ transactionModule: { name: string, package: { address: string } | null } | null, sender: { address: string } | null, contents: { bcs: string | null, json: unknown, type: { repr: string } | null } | null }> } | null } | null } | null } | null } };
 
 export type GetTransactionBlockQueryVariables = Exact<{
   digest: string;
@@ -407,7 +407,7 @@ export type GetTransactionBlockQueryVariables = Exact<{
 }>;
 
 
-export type GetTransactionBlockQuery = { transaction: { digest: string, transactionJson?: unknown, transactionBcs?: string | null, signatures: Array<{ signatureBytes: string | null }>, effects: { status: ExecutionStatus | null, effectsBcs?: string | null, effectsJson?: unknown, balanceChangesJson?: unknown, executionError: { message: string, abortCode: string | null, identifier: string | null, constant: string | null, sourceLineNumber: number | null, instructionOffset: number | null, module: { name: string, package: { address: string } | null } | null, function: { name: string } | null } | null, epoch: { epochId: number } | null, objectChanges?: { nodes: Array<{ address: string, outputState: { asMoveObject: { contents: { type: { repr: string } | null } | null } | null } | null }> } | null, events?: { pageInfo: { hasNextPage: boolean }, nodes: Array<{ transactionModule: { name: string, package: { address: string } | null } | null, sender: { address: string } | null, contents: { bcs: string | null, json: unknown, type: { repr: string } | null } | null }> } | null } | null } | null };
+export type GetTransactionBlockQuery = { transaction: { digest: string, transactionJson?: unknown, transactionBcs?: string | null, signatures: Array<{ signatureBytes: string | null }>, effects: { status: ExecutionStatus | null, timestamp: string | null, effectsBcs?: string | null, effectsJson?: unknown, balanceChangesJson?: unknown, checkpoint: { sequenceNumber: number } | null, executionError: { message: string, abortCode: string | null, identifier: string | null, constant: string | null, sourceLineNumber: number | null, instructionOffset: number | null, module: { name: string, package: { address: string } | null } | null, function: { name: string } | null } | null, epoch: { epochId: number } | null, objectChanges?: { nodes: Array<{ address: string, outputState: { asMoveObject: { contents: { type: { repr: string } | null } | null } | null } | null }> } | null, events?: { pageInfo: { hasNextPage: boolean }, nodes: Array<{ transactionModule: { name: string, package: { address: string } | null } | null, sender: { address: string } | null, contents: { bcs: string | null, json: unknown, type: { repr: string } | null } | null }> } | null } | null } | null };
 
 export type ListTransactionsQueryVariables = Exact<{
   filter?: TransactionFilter | null | undefined;
@@ -424,9 +424,9 @@ export type ListTransactionsQueryVariables = Exact<{
 }>;
 
 
-export type ListTransactionsQuery = { transactions: { pageInfo: { hasNextPage: boolean, hasPreviousPage: boolean, startCursor: string | null, endCursor: string | null }, nodes: Array<{ digest: string, transactionJson?: unknown, transactionBcs?: string | null, signatures: Array<{ signatureBytes: string | null }>, effects: { status: ExecutionStatus | null, effectsBcs?: string | null, effectsJson?: unknown, balanceChangesJson?: unknown, executionError: { message: string, abortCode: string | null, identifier: string | null, constant: string | null, sourceLineNumber: number | null, instructionOffset: number | null, module: { name: string, package: { address: string } | null } | null, function: { name: string } | null } | null, epoch: { epochId: number } | null, objectChanges?: { nodes: Array<{ address: string, outputState: { asMoveObject: { contents: { type: { repr: string } | null } | null } | null } | null }> } | null, events?: { pageInfo: { hasNextPage: boolean }, nodes: Array<{ transactionModule: { name: string, package: { address: string } | null } | null, sender: { address: string } | null, contents: { bcs: string | null, json: unknown, type: { repr: string } | null } | null }> } | null } | null }> } | null };
+export type ListTransactionsQuery = { transactions: { pageInfo: { hasNextPage: boolean, hasPreviousPage: boolean, startCursor: string | null, endCursor: string | null }, nodes: Array<{ digest: string, transactionJson?: unknown, transactionBcs?: string | null, signatures: Array<{ signatureBytes: string | null }>, effects: { status: ExecutionStatus | null, timestamp: string | null, effectsBcs?: string | null, effectsJson?: unknown, balanceChangesJson?: unknown, checkpoint: { sequenceNumber: number } | null, executionError: { message: string, abortCode: string | null, identifier: string | null, constant: string | null, sourceLineNumber: number | null, instructionOffset: number | null, module: { name: string, package: { address: string } | null } | null, function: { name: string } | null } | null, epoch: { epochId: number } | null, objectChanges?: { nodes: Array<{ address: string, outputState: { asMoveObject: { contents: { type: { repr: string } | null } | null } | null } | null }> } | null, events?: { pageInfo: { hasNextPage: boolean }, nodes: Array<{ transactionModule: { name: string, package: { address: string } | null } | null, sender: { address: string } | null, contents: { bcs: string | null, json: unknown, type: { repr: string } | null } | null }> } | null } | null }> } | null };
 
-export type Transaction_FieldsFragment = { digest: string, transactionJson?: unknown, transactionBcs?: string | null, signatures: Array<{ signatureBytes: string | null }>, effects: { status: ExecutionStatus | null, effectsBcs?: string | null, effectsJson?: unknown, balanceChangesJson?: unknown, executionError: { message: string, abortCode: string | null, identifier: string | null, constant: string | null, sourceLineNumber: number | null, instructionOffset: number | null, module: { name: string, package: { address: string } | null } | null, function: { name: string } | null } | null, epoch: { epochId: number } | null, objectChanges?: { nodes: Array<{ address: string, outputState: { asMoveObject: { contents: { type: { repr: string } | null } | null } | null } | null }> } | null, events?: { pageInfo: { hasNextPage: boolean }, nodes: Array<{ transactionModule: { name: string, package: { address: string } | null } | null, sender: { address: string } | null, contents: { bcs: string | null, json: unknown, type: { repr: string } | null } | null }> } | null } | null };
+export type Transaction_FieldsFragment = { digest: string, transactionJson?: unknown, transactionBcs?: string | null, signatures: Array<{ signatureBytes: string | null }>, effects: { status: ExecutionStatus | null, timestamp: string | null, effectsBcs?: string | null, effectsJson?: unknown, balanceChangesJson?: unknown, checkpoint: { sequenceNumber: number } | null, executionError: { message: string, abortCode: string | null, identifier: string | null, constant: string | null, sourceLineNumber: number | null, instructionOffset: number | null, module: { name: string, package: { address: string } | null } | null, function: { name: string } | null } | null, epoch: { epochId: number } | null, objectChanges?: { nodes: Array<{ address: string, outputState: { asMoveObject: { contents: { type: { repr: string } | null } | null } | null } | null }> } | null, events?: { pageInfo: { hasNextPage: boolean }, nodes: Array<{ transactionModule: { name: string, package: { address: string } | null } | null, sender: { address: string } | null, contents: { bcs: string | null, json: unknown, type: { repr: string } | null } | null }> } | null } | null };
 
 export type ResolveTransactionQueryVariables = Exact<{
   transaction: unknown;
@@ -596,6 +596,10 @@ export const Transaction_FieldsFragmentDoc = new TypedDocumentString(`
   }
   effects {
     status
+    timestamp
+    checkpoint {
+      sequenceNumber
+    }
     executionError {
       message
       abortCode
@@ -1068,6 +1072,10 @@ export const SimulateTransactionDocument = new TypedDocumentString(`
   }
   effects {
     status
+    timestamp
+    checkpoint {
+      sequenceNumber
+    }
     executionError {
       message
       abortCode
@@ -1152,6 +1160,10 @@ export const ExecuteTransactionDocument = new TypedDocumentString(`
   }
   effects {
     status
+    timestamp
+    checkpoint {
+      sequenceNumber
+    }
     executionError {
       message
       abortCode
@@ -1229,6 +1241,10 @@ export const GetTransactionBlockDocument = new TypedDocumentString(`
   }
   effects {
     status
+    timestamp
+    checkpoint {
+      sequenceNumber
+    }
     executionError {
       message
       abortCode
@@ -1320,6 +1336,10 @@ export const ListTransactionsDocument = new TypedDocumentString(`
   }
   effects {
     status
+    timestamp
+    checkpoint {
+      sequenceNumber
+    }
     executionError {
       message
       abortCode

package/src/graphql/queries/transactions.graphql

@@ -106,6 +106,10 @@ fragment TRANSACTION_FIELDS on Transaction {
 	}
 	effects {
 		status
+		timestamp
+		checkpoint {
+			sequenceNumber
+		}
 		executionError {
 			message
 			abortCode

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 = {},