@mysten/sui 2.26.2 → 2.27.1

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/graphql/core.ts

@@ -65,6 +65,8 @@ import {
 	validateTransactionQuery,
 } from '../client/query-filters.js';
 
+const GRAPHQL_OBJECT_BATCH_SIZE = 40;
+
 export class GraphQLCoreClient extends CoreClient {
 	#graphqlClient: SuiGraphQLClient;
 
@@ -104,7 +106,7 @@ export class GraphQLCoreClient extends CoreClient {
 	async getObjects<Include extends SuiClientTypes.ObjectInclude = {}>(
 		options: SuiClientTypes.GetObjectsOptions<Include>,
 	): Promise<SuiClientTypes.GetObjectsResponse<Include>> {
-		const batches = chunk(options.objectIds, 50);
+		const batches = chunk(options.objectIds, GRAPHQL_OBJECT_BATCH_SIZE);
 		const results: SuiClientTypes.GetObjectsResponse<Include>['objects'] = [];
 
 		for (const batch of batches) {
@@ -1122,6 +1124,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!,
@@ -1130,6 +1135,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
@@ -1431,4 +1451,4 @@ export const VerifyZkLoginSignatureDocument = new TypedDocumentString(`
     success
   }
 }
-    `) as unknown as TypedDocumentString<VerifyZkLoginSignatureQuery, VerifyZkLoginSignatureQueryVariables>;
+    `) as unknown as TypedDocumentString<VerifyZkLoginSignatureQuery, VerifyZkLoginSignatureQueryVariables>;

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/core.ts

@@ -1040,7 +1040,14 @@ function transactionReadMaskPaths(
 	include: SuiClientTypes.TransactionInclude | undefined,
 	prefix = '',
 ): string[] {
-	const paths = ['digest', 'transaction.digest', 'signatures', 'effects.status'];
+	const paths = [
+		'digest',
+		'transaction.digest',
+		'signatures',
+		'effects.status',
+		'timestamp',
+		'checkpoint',
+	];
 
 	if (include?.transaction) {
 		paths.push(
@@ -1442,7 +1449,7 @@ export function parseTransactionEffects({
 	return {
 		bcs: effects.bcs?.value!,
 
-		version: 2,
+		version: effects.version ?? 2,
 		status: effects.status?.success
 			? {
 					success: true,
@@ -1555,6 +1562,11 @@ export function parseGrpcTransactionResponse<
 	const result: SuiClientTypes.Transaction<Include> = {
 		digest: transaction.digest!,
 		epoch: transaction.effects?.epoch?.toString() ?? null,
+		timestampMs: transaction.timestamp
+			? Number(transaction.timestamp.seconds) * 1000 +
+				Math.floor(transaction.timestamp.nanos / 1_000_000)
+			: null,
+		checkpoint: transaction.checkpoint?.toString() ?? null,
 		status,
 		effects: effects as SuiClientTypes.Transaction<Include>['effects'],
 		objectTypes: (include?.objectTypes

package/src/jsonRpc/core.ts

@@ -530,6 +530,8 @@ export class JSONRpcCoreClient extends CoreClient {
 		const transactionData: SuiClientTypes.Transaction<Include> = {
 			digest: TransactionDataBuilder.getDigestFromBytes(transactionBytes),
 			epoch: null,
+			timestampMs: null,
+			checkpoint: null,
 			status: effects.status,
 			effects: (options.include?.effects
 				? effects
@@ -1228,6 +1230,8 @@ function parseTransaction<Include extends SuiClientTypes.TransactionInclude = {}
 	const result: SuiClientTypes.Transaction<Include> = {
 		digest: transaction.digest,
 		epoch: transaction.effects?.executedEpoch ?? null,
+		timestampMs: transaction.timestampMs == null ? null : Number(transaction.timestampMs),
+		checkpoint: transaction.checkpoint ?? null,
 		status,
 		effects: (include?.effects && effectsBytes
 			? parseTransactionEffectsBcs(effectsBytes)

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.2';
+export const PACKAGE_VERSION = '2.27.1';