@mysten/sui 2.23.1 → 2.24.0

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

@@ -1,16 +1,17 @@
 # @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.
 
-> **Note:** The Kiosk SDK requires `SuiJsonRpcClient` or `SuiGraphQLClient`. It does not work with
-> `SuiGrpcClient` because it uses event queries that are not available in gRPC.
+> **Note:** The Kiosk SDK accepts `SuiGrpcClient`, `SuiGraphQLClient`, and other clients that implement
+> `ClientWithCoreApi`. Use `SuiGrpcClient` for new Kiosk code. The gRPC object API returns Display
+> v2 metadata; use GraphQL or JSON-RPC for object types that still rely on legacy Display metadata.
 
 ```diff
 - import { SuiClient, getFullnodeUrl } from '@mysten/sui/client';
 - import { KioskClient, Network } from '@mysten/kiosk';
-+ import { SuiJsonRpcClient, getJsonRpcFullnodeUrl } from '@mysten/sui/jsonRpc'; // or SuiGraphQLClient
++ import { SuiGrpcClient } from '@mysten/sui/grpc';
 + import { kiosk } from '@mysten/kiosk';
 
 - const suiClient = new SuiClient({ url: getFullnodeUrl('mainnet') });
@@ -18,8 +19,8 @@ This package now exports a client extension that integrates with Sui clients.
 -   client: suiClient,
 -   network: Network.MAINNET,
 - });
-+ const client = new SuiJsonRpcClient({
-+   url: getJsonRpcFullnodeUrl('mainnet'),
++ const client = new SuiGrpcClient({
++   baseUrl: 'https://fullnode.mainnet.sui.io:443',
 +   network: 'mainnet',
 + }).$extend(kiosk());
 
@@ -100,14 +101,14 @@ The low-level helper functions have been removed in favor of the `KioskTransacti
 ```diff
 - import { createKiosk, shareKiosk, placeAndList } from '@mysten/kiosk';
 + import { kiosk, KioskTransaction } from '@mysten/kiosk';
-+ import { SuiJsonRpcClient, getJsonRpcFullnodeUrl } from '@mysten/sui/jsonRpc';
++ import { SuiGrpcClient } from '@mysten/sui/grpc';
 
 - const [kiosk, cap] = createKiosk(tx);
 - shareKiosk(tx, kiosk);
 - placeAndList(tx, itemType, kiosk, cap, item, price);
 
-+ const client = new SuiJsonRpcClient({
-+   url: getJsonRpcFullnodeUrl('mainnet'),
++ const client = new SuiGrpcClient({
++   baseUrl: 'https://fullnode.mainnet.sui.io:443',
 +   network: 'mainnet',
 + }).$extend(kiosk());
 +

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

@@ -1,6 +1,6 @@
 # SDK Maintainers
 
-> Migration guide for SDK maintainers and library authors upgrading to 2.0.
+> Migration guide for SDK maintainers and library authors upgrading to 2.0
 
 # Upgrading SDKs to @mysten/sui@2.0.0
 
@@ -10,8 +10,8 @@ For comprehensive SDK development patterns, see the [Building SDKs guide](/sui/s
 
 ## Use `ClientWithCoreApi`
 
-Accept `ClientWithCoreApi` instead of `SuiClient` to support all 3 Sui clients (JSON-RPC, GraphQL,
-gRPC):
+Accept `ClientWithCoreApi` instead of `SuiClient` so applications can pass a `SuiGrpcClient`,
+`SuiGraphQLClient`, or a legacy `SuiJsonRpcClient` during migration:
 
 ```diff
 - import { SuiClient } from '@mysten/sui/client';
@@ -24,7 +24,9 @@ gRPC):
 
 ## Access data through `client.core` methods
 
-All data access methods are namespaced under `client.core`:
+SDKs should access shared client methods through `client.core`. Application code can use the same
+methods at the top level of its concrete client, but `client.core` is the stable contract for
+libraries that should work across transports:
 
 ```diff
 - const result = await this.client.getObject({ objectId });
@@ -34,13 +36,17 @@ All data access methods are namespaced under `client.core`:
 + const result = await this.client.core.listOwnedObjects({ owner });
 ```
 
-| v1.x Method                      | v2.0 Method                       |
-| -------------------------------- | --------------------------------- |
-| `client.getObject()`             | `client.core.getObject()`         |
-| `client.getOwnedObjects()`       | `client.core.listOwnedObjects()`  |
-| `client.getDynamicFieldObject()` | `client.core.getDynamicField()`   |
-| `client.getDynamicFields()`      | `client.core.listDynamicFields()` |
-| `client.multiGetObjects()`       | `client.core.getObjects()`        |
+| v1.x Method                      | v2.0 Method                                                              |
+| -------------------------------- | ------------------------------------------------------------------------ |
+| `client.getObject()`             | `client.core.getObject()`                                                |
+| `client.getOwnedObjects()`       | `client.core.listOwnedObjects()`                                         |
+| `client.getDynamicFieldObject()` | `client.core.getDynamicField()` or `client.core.getDynamicObjectField()` |
+| `client.getDynamicFields()`      | `client.core.listDynamicFields()`                                        |
+| `client.multiGetObjects()`       | `client.core.getObjects()`                                               |
+
+Use `getDynamicField()` for regular dynamic fields and when you need the field entry or BCS-encoded
+value. Use `getDynamicObjectField()` only for dynamic object fields when you want the referenced
+child object returned directly.
 
 See the [Core API documentation](/sui/clients/core) for all available methods.
 

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

@@ -1,51 +1,63 @@
 # @mysten/sui
 
-> Migrate @mysten/sui from 1.x to 2.0 with new client APIs and BCS changes.
+> Migrate @mysten/sui from 1.x to 2.0 with gRPC clients, Core API, and BCS changes
 
 ## Removal of `SuiClient` exports
 
-The `@mysten/sui/client` export path has been removed. All JSON-RPC client functionality is now
-exported from `@mysten/sui/jsonRpc`.
+The old `SuiClient` export has been removed from `@mysten/sui/client`. For application code, migrate
+to [`SuiGrpcClient`](/sui/clients/grpc) and use top-level methods such as `client.getObject()`,
+`client.listCoins()`, and `client.signAndExecuteTransaction()`.
+
+Legacy JSON-RPC functionality moved to `@mysten/sui/jsonRpc`, but JSON-RPC APIs are deprecated in
+the Sui TypeScript SDK. Use the JSON-RPC exports only when maintaining code that still needs the old
+JSON-RPC method names or response shapes during migration.
 
 **Removed exports:**
 
-- `SuiClient` (use `SuiJsonRpcClient` instead)
-- `SuiClientOptions` (use `SuiJsonRpcClientOptions` instead)
-- `isSuiClient` (use `isSuiJsonRpcClient` instead)
-- `SuiTransport` (use `JsonRpcTransport` instead)
+- `SuiClient` (use `SuiGrpcClient`; legacy JSON-RPC code can use `SuiJsonRpcClient`)
+- `SuiClientOptions` (use `SuiGrpcClientOptions`; legacy JSON-RPC code can use
+  `SuiJsonRpcClientOptions`)
+- `isSuiClient` (use `isSuiGrpcClient`, `isSuiGraphQLClient`, or legacy `isSuiJsonRpcClient`)
+- `SuiTransport` (legacy JSON-RPC code can use `JsonRpcTransport`)
 - `SuiTransportRequestOptions` (use `JsonRpcTransportRequestOptions` instead)
-- `SuiTransportSubscribeOptions` (use `JsonRpcTransportSubscribeOptions` instead)
+- `SuiTransportSubscribeOptions` (removed; use the gRPC subscription service for streaming APIs)
 - `SuiHTTPTransportOptions` (use `JsonRpcHTTPTransportOptions` instead)
 - `SuiHTTPTransport` (use `JsonRpcHTTPTransport` instead)
-- `getFullnodeUrl` (use `getJsonRpcFullnodeUrl` instead)
+- `getFullnodeUrl` (pass the full node URL to `SuiGrpcClient.baseUrl`; legacy JSON-RPC code can use
+  `getJsonRpcFullnodeUrl`)
 - All JSON-RPC types (now exported from `@mysten/sui/jsonRpc`)
 
 **Migration:**
 
 ```diff
 - import { SuiClient, getFullnodeUrl } from '@mysten/sui/client';
-+ import { SuiJsonRpcClient, getJsonRpcFullnodeUrl } from '@mysten/sui/jsonRpc';
++ import { SuiGrpcClient } from '@mysten/sui/grpc';
 
 - const client = new SuiClient({
 -   url: getFullnodeUrl('devnet'),
-+ const client = new SuiJsonRpcClient({
-+   url: getJsonRpcFullnodeUrl('devnet'),
++ const client = new SuiGrpcClient({
++   baseUrl: 'https://fullnode.devnet.sui.io:443',
     network: 'devnet',
   });
 ```
 
 ## Network parameter required
 
-When creating a new `SuiGraphQLClient` or `SuiJsonRpcClient`, you must now provide a `network`
-parameter:
+When creating a new `SuiGrpcClient`, `SuiGraphQLClient`, or legacy `SuiJsonRpcClient`, provide a
+`network` parameter:
 
 ```ts
-const client = new SuiGraphQLClient({
+const grpcClient = new SuiGrpcClient({
+	baseUrl: 'https://...',
+	network: 'mainnet', // Required
+});
+
+const graphqlClient = new SuiGraphQLClient({
 	url: 'https://...',
 	network: 'mainnet', // Required
 });
 
-const client = new SuiJsonRpcClient({
+const jsonRpcClient = new SuiJsonRpcClient({
 	url: 'https://...',
 	network: 'mainnet', // Required
 });
@@ -66,11 +78,12 @@ objects.
 + effects.status.Failure.error
 ```
 
-**Core API** (gRPC and GraphQL responses): Uses a simplified structure with a `success` boolean:
+**Core API and top-level client methods** (gRPC and GraphQL responses): Use a simplified structure
+with a `success` boolean:
 
 ```typescript
-// Core API returns this structure
-const result = await client.core.getTransaction({ digest, include: { effects: true } });
+// Top-level gRPC and GraphQL methods return this structure.
+const result = await client.getTransaction({ digest, include: { effects: true } });
 const tx = result.Transaction ?? result.FailedTransaction;
 
 if (tx.effects.status.success) {
@@ -223,7 +236,7 @@ resolution is now built directly into the core client.
 **How it works now:**
 
 MVR name resolution happens automatically during transaction building. The SDK detects `.move` names
-(like `@org/package::module::Type`) and resolves them using the client's MVR resolver.
+like `@org/package::module::Type` and resolves them using the client's MVR resolver.
 
 **Migration:**
 
@@ -238,11 +251,10 @@ MVR name resolution happens automatically during transaction building. The SDK d
 -   })
 - );
 
-+ import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
-+ import type { NamedPackagesOverrides } from '@mysten/sui/client';
++ import { SuiGrpcClient } from '@mysten/sui/grpc';
 +
-+ const client = new SuiJsonRpcClient({
-+   url: 'https://fullnode.mainnet.sui.io:443',
++ const client = new SuiGrpcClient({
++   baseUrl: 'https://fullnode.mainnet.sui.io:443',
 +   network: 'mainnet',
 +   mvr: {
 +     overrides: myOverrides,
@@ -264,7 +276,8 @@ requiring `SuiJsonRpcClient` specifically.
 **Breaking changes:**
 
 - Constructor `client` parameter type changed from `SuiJsonRpcClient` to `ClientWithCoreApi`
-- Return type of `executeTransaction()`: `data` property renamed to `result`
+- Return type of `executeTransaction()` changed from the legacy `{ digest, effects, data }` wrapper
+  to a Core API `TransactionResult` discriminated union returned directly
 - The second parameter changed from JSON-RPC options to core API include options
 
 **Migration:**
@@ -272,7 +285,12 @@ requiring `SuiJsonRpcClient` specifically.
 ```diff
 
 - import { SuiJsonRpcClient } from '@mysten/sui/jsonRpc';
-+ // Works with any client: SuiJsonRpcClient, SuiGrpcClient, or SuiGraphQLClient
++ import { SuiGrpcClient } from '@mysten/sui/grpc';
+
++ const client = new SuiGrpcClient({
++   baseUrl: 'https://fullnode.devnet.sui.io:443',
++   network: 'devnet',
++ });
 
 const executor = new SerialTransactionExecutor({
 -   client: jsonRpcClient,
@@ -282,10 +300,10 @@ const executor = new SerialTransactionExecutor({
 
 const result = await executor.executeTransaction(tx);
 
-// Accessing the transaction result (changed)
+// Accessing the transaction result now returned directly
 - console.log(result.data.effects?.status.status);
-+ const tx = result.Transaction ?? result.FailedTransaction;
-+ console.log(tx.effects.status.success);
++ const transaction = result.Transaction ?? result.FailedTransaction;
++ console.log(transaction.effects.status.success);
 ```
 
 Include options have also changed:

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

@@ -1,13 +1,13 @@
 # @mysten/suins
 
-> Migrate @mysten/suins to 2.0 with client extension pattern.
+> Migrate @mysten/suins to 2.0 with client extension pattern
 
 This package now exports a client extension that integrates with Sui clients.
 
 ```diff
 - import { SuiClient, getFullnodeUrl } from '@mysten/sui/client';
 - import { SuinsClient } from '@mysten/suins';
-+ import { SuiGrpcClient } from '@mysten/sui/grpc'; // or SuiJsonRpcClient, SuiGraphQLClient
++ import { SuiGrpcClient } from '@mysten/sui/grpc';
 + import { suins } from '@mysten/suins';
 
 - const suiClient = new SuiClient({ url: getFullnodeUrl('mainnet') });

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

@@ -1,6 +1,6 @@
 # @mysten/walrus
 
-> Migrate @mysten/walrus to 2.0 with required client parameter and updated API.
+> Migrate @mysten/walrus to 2.0 with required client parameter and updated API
 
 ## Breaking changes
 
@@ -17,7 +17,7 @@ If you were creating `WalrusClient` directly:
 
 ```diff
 - import { WalrusClient } from '@mysten/walrus';
-+ import { SuiGrpcClient } from '@mysten/sui/grpc'; // or SuiJsonRpcClient, SuiGraphQLClient
++ import { SuiGrpcClient } from '@mysten/sui/grpc';
 + import { walrus } from '@mysten/walrus';
 
 - const walrusClient = new WalrusClient({
@@ -30,7 +30,7 @@ If you were creating `WalrusClient` directly:
 + }).$extend(walrus());
 
 - await walrusClient.getBlob(blobId);
-+ await client.walrus.getBlob(blobId);
++ await client.walrus.getBlob({ blobId });
 ```
 
 If you were passing `network` to `walrus()`, remove it:

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

@@ -1,9 +1,9 @@
 # @mysten/zksend
 
-> Migrate @mysten/zksend to 2.0 with client extension pattern and simplified API.
+> Migrate @mysten/zksend to 2.0 with client extension pattern and simplified API
 
-This package now exports a client extension that integrates with Sui clients, enabling compatibility
-with gRPC, GraphQL, and JSON RPC transports.
+This package now exports a client extension that integrates with Sui clients through the Core API.
+Use `SuiGrpcClient` for most applications.
 
 ## Breaking changes
 
@@ -23,7 +23,7 @@ Update your code to use the client extension:
 ```diff
 - import { ZkSendLinkBuilder, ZkSendLink } from '@mysten/zksend';
 + import { zksend } from '@mysten/zksend';
-+ import { SuiGrpcClient } from '@mysten/sui/grpc'; // or SuiJsonRpcClient, SuiGraphQLClient
++ import { SuiGrpcClient } from '@mysten/sui/grpc';
 
 + const client = new SuiGrpcClient({
 +   baseUrl: 'https://fullnode.testnet.sui.io:443',
@@ -84,12 +84,13 @@ const linkBuilder = client.zksend.linkBuilder({
 });
 
 // Add assets to the link
-linkBuilder.addSui(1_000_000_000n); // 1 SUI
+linkBuilder.addClaimableMist(1_000_000_000n); // 1 SUI
 
-// Create the transaction
-const { tx, link } = await linkBuilder.build();
+// Create the transaction and get the claim URL
+const tx = await linkBuilder.createSendTransaction();
+const linkUrl = linkBuilder.getLink();
 
 // Later, load an existing link
 const existingLink = await client.zksend.loadLinkFromUrl(linkUrl);
-const assets = await existingLink.getAssets();
+const assets = existingLink.assets;
 ```

package/docs/sdk-building.md

@@ -1,14 +1,16 @@
 # Building SDKs
 
-> Build custom SDKs on top of the Sui TypeScript SDK.
+> Build custom SDKs on top of the Sui TypeScript SDK
 
 This guide covers recommended patterns for building TypeScript SDKs that integrate with the Sui SDK.
-Following these patterns ensures your SDK integrates seamlessly with the ecosystem, works across
-different transports (JSON-RPC, GraphQL, gRPC), and composes well with other SDKs.
+Following these patterns ensures your SDK integrates seamlessly with the ecosystem, works with
+`SuiGrpcClient` and `SuiGraphQLClient` through the shared Core API, and composes well with other
+SDKs. Legacy JSON-RPC clients can also be supported during migration because they implement the same
+Core API contract.
 
 All SDKs should depend on [`ClientWithCoreApi`](./clients/core), which is the transport-agnostic
-interface implemented by all Sui clients. This ensures your SDK works with any client the user
-chooses.
+interface implemented by Sui clients. This lets application code choose one concrete client and use
+top-level methods, while SDK internals use `client.core` for portable reads, writes, and queries.
 
 ## Package setup
 

package/package.json

@@ -3,7 +3,7 @@
   "author": "Mysten Labs <build@mystenlabs.com>",
   "description": "Sui TypeScript API",
   "homepage": "https://sdk.mystenlabs.com",
-  "version": "2.23.1",
+  "version": "2.24.0",
   "license": "Apache-2.0",
   "sideEffects": false,
   "files": [

package/src/client/core.ts

@@ -134,6 +134,10 @@ export abstract class CoreClient extends BaseClient implements SuiClientTypes.Tr
 		options: SuiClientTypes.DefaultNameServiceNameOptions,
 	): Promise<SuiClientTypes.DefaultNameServiceNameResponse>;
 
+	abstract resolveNameServiceAddress(
+		options: SuiClientTypes.ResolveNameServiceAddressOptions,
+	): Promise<SuiClientTypes.ResolveNameServiceAddressResponse>;
+
 	async getDynamicField(
 		options: SuiClientTypes.GetDynamicFieldOptions,
 	): Promise<SuiClientTypes.GetDynamicFieldResponse> {

package/src/client/types.ts

@@ -757,6 +757,14 @@ export namespace SuiClientTypes {
 	}
 
 	/** Name service methods */
+	export interface ResolveNameServiceAddressOptions extends CoreClientMethodOptions {
+		name: string;
+	}
+
+	export interface ResolveNameServiceAddressResponse {
+		address: string | null;
+	}
+
 	export interface DefaultNameServiceNameOptions extends CoreClientMethodOptions {
 		address: string;
 	}
@@ -768,6 +776,9 @@ export namespace SuiClientTypes {
 	}
 
 	export interface TransportMethods {
+		resolveNameServiceAddress: (
+			options: ResolveNameServiceAddressOptions,
+		) => Promise<ResolveNameServiceAddressResponse>;
 		defaultNameServiceName: (
 			options: DefaultNameServiceNameOptions,
 		) => Promise<DefaultNameServiceNameResponse>;

package/src/graphql/client.ts

@@ -369,4 +369,10 @@ export class SuiGraphQLClient<Queries extends Record<string, GraphQLDocument> =
 	): Promise<SuiClientTypes.DefaultNameServiceNameResponse> {
 		return this.core.defaultNameServiceName(input);
 	}
+
+	resolveNameServiceAddress(
+		input: SuiClientTypes.ResolveNameServiceAddressOptions,
+	): Promise<SuiClientTypes.ResolveNameServiceAddressResponse> {
+		return this.core.resolveNameServiceAddress(input);
+	}
 }

package/src/graphql/core.ts

@@ -31,6 +31,7 @@ import {
 	ListEventsDocument,
 	ListTransactionsDocument,
 	MultiGetObjectsDocument,
+	ResolveNameServiceAddressDocument,
 	ResolveTransactionDocument,
 	SimulateTransactionDocument,
 	VerifyZkLoginSignatureDocument,
@@ -776,6 +777,20 @@ export class GraphQLCoreClient extends CoreClient {
 		};
 	}
 
+	async resolveNameServiceAddress(
+		options: SuiClientTypes.ResolveNameServiceAddressOptions,
+	): Promise<SuiClientTypes.ResolveNameServiceAddressResponse> {
+		const { data, errors } = await this.#graphqlClient.query({
+			query: ResolveNameServiceAddressDocument,
+			signal: options.signal,
+			variables: { name: options.name },
+		});
+
+		handleGraphQLErrors(errors);
+
+		return { address: data?.address?.address ?? null };
+	}
+
 	async getMoveFunction(
 		options: SuiClientTypes.GetMoveFunctionOptions,
 	): Promise<SuiClientTypes.GetMoveFunctionResponse> {

package/src/graphql/generated/queries.ts

@@ -286,6 +286,13 @@ export type DefaultSuinsNameQueryVariables = Exact<{
 
 export type DefaultSuinsNameQuery = { address: { defaultNameRecord: { domain: string } | null } | null };
 
+export type ResolveNameServiceAddressQueryVariables = Exact<{
+  name: string;
+}>;
+
+
+export type ResolveNameServiceAddressQuery = { address: { address: string } | null };
+
 export type GetOwnedObjectsQueryVariables = Exact<{
   owner: string;
   limit?: number | null | undefined;
@@ -904,6 +911,13 @@ export const DefaultSuinsNameDocument = new TypedDocumentString(`
   }
 }
     `) as unknown as TypedDocumentString<DefaultSuinsNameQuery, DefaultSuinsNameQueryVariables>;
+export const ResolveNameServiceAddressDocument = new TypedDocumentString(`
+    query resolveNameServiceAddress($name: String!) {
+  address(name: $name) {
+    address
+  }
+}
+    `) as unknown as TypedDocumentString<ResolveNameServiceAddressQuery, ResolveNameServiceAddressQueryVariables>;
 export const GetOwnedObjectsDocument = new TypedDocumentString(`
     query getOwnedObjects($owner: SuiAddress!, $limit: Int, $cursor: String, $filter: ObjectFilter, $includeContent: Boolean = false, $includePreviousTransaction: Boolean = false, $includeObjectBcs: Boolean = false, $includeJson: Boolean = false, $includeDisplay: Boolean = false) {
   address(address: $owner) {

package/src/graphql/queries/nameService.graphql

@@ -8,3 +8,9 @@ query defaultSuinsName($address: SuiAddress!) {
 		}
 	}
 }
+
+query resolveNameServiceAddress($name: String!) {
+	address(name: $name) {
+		address
+	}
+}

package/src/grpc/client.ts

@@ -336,4 +336,10 @@ export class SuiGrpcClient extends BaseClient implements SuiClientTypes.Transpor
 	): Promise<SuiClientTypes.DefaultNameServiceNameResponse> {
 		return this.core.defaultNameServiceName(input);
 	}
+
+	resolveNameServiceAddress(
+		input: SuiClientTypes.ResolveNameServiceAddressOptions,
+	): Promise<SuiClientTypes.ResolveNameServiceAddressResponse> {
+		return this.core.resolveNameServiceAddress(input);
+	}
 }

package/src/grpc/core.ts

@@ -54,6 +54,7 @@ import {
 import type { QueryEnd, QueryOptions } from './proto/sui/rpc/v2/query_options.js';
 import { Ordering, QueryEndReason } from './proto/sui/rpc/v2/query_options.js';
 import type { ResolvedPagination } from '../client/query-filters.js';
+import { RpcError } from '@protobuf-ts/runtime-rpc';
 import {
 	resolveEventFilter,
 	resolvePagination,
@@ -66,6 +67,21 @@ export interface GrpcCoreClientOptions extends CoreClientOptions {
 	client: SuiGrpcClient;
 }
 
+function isNameServiceResolutionMiss(error: unknown): boolean {
+	if (!(error instanceof RpcError)) return false;
+	if (error.code === 'NOT_FOUND') return true;
+	if (error.code !== 'RESOURCE_EXHAUSTED') return false;
+
+	try {
+		// The gRPC service currently reports expired names as RESOURCE_EXHAUSTED without a
+		// structured reason. grpc-web URI-encodes status messages, so decode before matching while
+		// preserving unrelated RESOURCE_EXHAUSTED failures such as capacity limits.
+		return decodeURIComponent(error.message) === 'name has expired';
+	} catch {
+		return false;
+	}
+}
+
 export class GrpcCoreClient extends CoreClient {
 	#client: SuiGrpcClient;
 	constructor({ client, ...options }: GrpcCoreClientOptions) {
@@ -797,6 +813,25 @@ export class GrpcCoreClient extends CoreClient {
 		};
 	}
 
+	async resolveNameServiceAddress(
+		options: SuiClientTypes.ResolveNameServiceAddressOptions,
+	): Promise<SuiClientTypes.ResolveNameServiceAddressResponse> {
+		try {
+			const { response } = await this.#client.nameService.lookupName(
+				{ name: options.name },
+				{ abort: options.signal },
+			);
+
+			return { address: response.record?.targetAddress ?? null };
+		} catch (error) {
+			if (isNameServiceResolutionMiss(error)) {
+				return { address: null };
+			}
+
+			throw error;
+		}
+	}
+
 	async getMoveFunction(
 		options: SuiClientTypes.GetMoveFunctionOptions,
 	): Promise<SuiClientTypes.GetMoveFunctionResponse> {
@@ -1392,18 +1427,22 @@ export function parseTransactionEffects({
 			nonRefundableStorageFee: effects.gasUsed?.nonRefundableStorageFee?.toString()!,
 		},
 		transactionDigest: effects.transactionDigest!,
-		gasObject: {
-			objectId: effects.gasObject?.objectId!,
-			inputState: mapInputObjectState(effects.gasObject?.inputState)!,
-			inputVersion: effects.gasObject?.inputVersion?.toString() ?? null,
-			inputDigest: effects.gasObject?.inputDigest ?? null,
-			inputOwner: mapOwner(effects.gasObject?.inputOwner),
-			outputState: mapOutputObjectState(effects.gasObject?.outputState)!,
-			outputVersion: effects.gasObject?.outputVersion?.toString() ?? null,
-			outputDigest: effects.gasObject?.outputDigest ?? null,
-			outputOwner: mapOwner(effects.gasObject?.outputOwner),
-			idOperation: mapIdOperation(effects.gasObject?.idOperation)!,
-		},
+		// gas_object is unset when the transaction has no gas object (system
+		// transactions, or gas paid from an address balance)
+		gasObject: effects.gasObject
+			? {
+					objectId: effects.gasObject.objectId!,
+					inputState: mapInputObjectState(effects.gasObject.inputState)!,
+					inputVersion: effects.gasObject.inputVersion?.toString() ?? null,
+					inputDigest: effects.gasObject.inputDigest ?? null,
+					inputOwner: mapOwner(effects.gasObject.inputOwner),
+					outputState: mapOutputObjectState(effects.gasObject.outputState)!,
+					outputVersion: effects.gasObject.outputVersion?.toString() ?? null,
+					outputDigest: effects.gasObject.outputDigest ?? null,
+					outputOwner: mapOwner(effects.gasObject.outputOwner),
+					idOperation: mapIdOperation(effects.gasObject.idOperation)!,
+				}
+			: null,
 		eventsDigest: effects.eventsDigest ?? null,
 		dependencies: effects.dependencies,
 		lamportVersion: effects.lamportVersion?.toString() ?? null,