@mysten/docs 0.1.44 → 0.1.45

package/dist/dapp-kit/getting-started/react.md

@@ -1,6 +1,6 @@
 # React
 
-> Set up dApp Kit in a React application.
+> Set up dApp Kit in a React application
 
 This guide walks you through integrating dApp Kit into a React application.
 
@@ -147,7 +147,7 @@ function TransferButton() {
 | [`useCurrentAccount`](/dapp-kit/react/hooks/use-current-account)     | Currently selected account               |
 | [`useCurrentWallet`](/dapp-kit/react/hooks/use-current-wallet)       | Currently connected wallet               |
 | [`useCurrentNetwork`](/dapp-kit/react/hooks/use-current-network)     | Current network                          |
-| [`useCurrentClient`](/dapp-kit/react/hooks/use-current-client)       | SuiClient for current network            |
+| [`useCurrentClient`](/dapp-kit/react/hooks/use-current-client)       | Current Sui client instance              |
 | [`useWallets`](/dapp-kit/react/hooks/use-wallets)                    | List of available wallets                |
 
 ## Components

package/dist/dapp-kit/getting-started/vue.md

@@ -1,6 +1,6 @@
 # Vue
 
-> Set up dApp Kit in a Vue application.
+> Set up dApp Kit in a Vue application
 
 This guide walks you through integrating dApp Kit into a Vue application using Web Components and
 direct store access.
@@ -174,7 +174,7 @@ Access these stores through `dAppKit.stores`:
 | ----------------- | ------------------------------------------------- |
 | `$connection`     | Connection state with wallet, account, and status |
 | `$currentNetwork` | Current network string                            |
-| `$currentClient`  | SuiClient for current network                     |
+| `$currentClient`  | Current Sui client instance                       |
 | `$wallets`        | List of available wallets                         |
 
 See [State Management](/dapp-kit/state) for full documentation.

package/dist/dapp-kit/llms-index.md

@@ -3,11 +3,11 @@
 
 - [Sui dApp Kit](..md): Build Sui apps with framework-agnostic core and React bindings.
 - [@mysten/create-dapp](./getting-started/create-dapp.md): Create a Sui app with one command using the create-dapp CLI scaffolding tool.
-- [React](./getting-started/react.md): Set up dApp Kit in a React application.
+- [React](./getting-started/react.md): Set up dApp Kit in a React application
 - [Next.js](./getting-started/next-js.md): Set up dApp Kit in a Next.js application.
-- [Vue](./getting-started/vue.md): Set up dApp Kit in a Vue application.
+- [Vue](./getting-started/vue.md): Set up dApp Kit in a Vue application
 - [DApp Kit Instance](./dapp-kit-instance.md): Create and configure a DAppKit instance for wallet and client management
-- [State](./state.md): Access and subscribe to wallet connection state in dApp Kit.
+- [State](./state.md): Access and subscribe to wallet connection state in dApp Kit
 - [Connect Wallet](./actions/connect-wallet.md): Programmatically connect to a Sui wallet using the dApp Kit connectWallet action.
 - [Disconnect Wallet](./actions/disconnect-wallet.md): Programmatically disconnect from a Sui wallet using the dApp Kit disconnectWallet action.
 - [Sign and Execute Transaction](./actions/sign-and-execute-transaction.md): Sign and execute a transaction on the Sui network using the connected wallet.
@@ -19,7 +19,7 @@
 - [React Hooks](./react/hooks.md): React hooks for accessing dApp Kit state and actions in Sui applications.
 - [useDAppKit](./react/hooks/use-dapp-kit.md): React hook to access the full dApp Kit instance for calling actions directly.
 - [useCurrentAccount](./react/hooks/use-current-account.md): React hook to get the currently selected wallet account in a Sui dApp.
-- [useCurrentClient](./react/hooks/use-current-client.md): React hook to get the current Sui client instance for the active network.
+- [useCurrentClient](./react/hooks/use-current-client.md): React hook to get the current Sui client instance for the active network
 - [useCurrentNetwork](./react/hooks/use-current-network.md): React hook to get the currently selected Sui network in dApp Kit.
 - [useCurrentWallet](./react/hooks/use-current-wallet.md): React hook to get the currently connected wallet in a Sui dApp.
 - [useWalletConnection](./react/hooks/use-wallet-connection.md): React hook to manage wallet connection status and information in a Sui dApp.

package/dist/dapp-kit/react/hooks/use-current-client.md

@@ -1,13 +1,14 @@
 # useCurrentClient
 
-> React hook to get the current Sui client instance for the active network.
+> React hook to get the current Sui client instance for the active network
 
 The `useCurrentClient` hook provides access to the blockchain client instance for the current
 network.
 
-> **Note:** By default, this returns a `SuiClient` instance when using the standard setup. However, the dApp
-> Kit supports any client that implements the Sui core API, making it flexible for different
-> blockchain implementations.
+> **Note:** With the standard setup, this returns the `SuiGrpcClient` instance created by `createClient`. More
+> generally, it returns whatever client type your dApp Kit instance creates, as long as that client
+> implements the Sui Core API. Application code should call the concrete client's top-level methods
+> directly.
 
 > **Warning:** All dApp Kit hooks must be used within components that are descendants of
 > [`DAppKitProvider`](../dapp-kit-provider). Using them outside will result in an error.
@@ -32,5 +33,5 @@ network.
 ## Return value
 
 ```tsx
-SuiClient;
+ReturnType<typeof dAppKit.getClient>;
 ```

package/dist/dapp-kit/state.md

@@ -1,6 +1,6 @@
 # State
 
-> Access and subscribe to wallet connection state in dApp Kit.
+> Access and subscribe to wallet connection state in dApp Kit
 
 The Sui dApp Kit SDK uses [nanostores](https://github.com/nanostores/nanostores) for state
 management, providing a lightweight, framework-agnostic solution that works across React, Vue,
@@ -100,7 +100,7 @@ This store is read-only. Use `dAppKit.switchNetwork()` to change networks.
 
 ### Current client store (`$currentClient`)
 
-Contains the SuiClient instance for the current network:
+Contains the Sui client instance for the current network:
 
 ```typescript
 const client = dAppKit.stores.$currentClient.get();

package/dist/kiosk/advanced-examples.md

@@ -1,6 +1,6 @@
 # Advanced Examples
 
-> Advanced Kiosk SDK usage patterns and code examples for complex scenarios.
+> Advanced Kiosk SDK usage patterns and code examples for complex scenarios
 
 # Some extended examples
 
@@ -14,8 +14,8 @@ const bullsharkType = `${packageId}::suifrens::SuiFren<${packageId}::bullshark::
 const capyType = `${packageId}::suifrens::SuiFren<${packageId}::capy::Capy>`;
 
 // initialize the client with the kiosk extension.
-const client = new SuiJsonRpcClient({
-	url: getJsonRpcFullnodeUrl('mainnet'),
+const client = new SuiGrpcClient({
+	baseUrl: 'https://fullnode.mainnet.sui.io:443',
 	network: 'mainnet',
 }).$extend(kiosk());
 ```

package/dist/kiosk/from-v1.md

@@ -1,6 +1,6 @@
 # Migrating from Kiosk SDK V1
 
-> Migrate from Kiosk SDK v1 to the current version with the builder-pattern API.
+> Migrate from Kiosk SDK v1 to the current version with the builder-pattern API
 
 The original version of Kiosk SDK provided basic experimentation with the Kiosk API. The new version
 of the SDK (0.7+) provides a more robust experience for building kiosk/transfer policy transactions.
@@ -46,8 +46,8 @@ Using the new SDK, you can build the same transaction as follows:
 ```typescript
 
 // You need to do this only once and re-use it in the application.
-const client = new SuiJsonRpcClient({
-	url: getJsonRpcFullnodeUrl('mainnet'),
+const client = new SuiGrpcClient({
+	baseUrl: 'https://fullnode.mainnet.sui.io:443',
 	network: 'mainnet',
 }).$extend(kiosk());
 
@@ -98,8 +98,8 @@ Using the new SDK, you can build the same transaction as follows:
 ```typescript
 
 // You need to do this only once and re-use it in the application.
-const client = new SuiJsonRpcClient({
-	url: getJsonRpcFullnodeUrl('mainnet'),
+const client = new SuiGrpcClient({
+	baseUrl: 'https://fullnode.mainnet.sui.io:443',
 	network: 'mainnet',
 }).$extend(kiosk());
 
@@ -198,8 +198,8 @@ Using the new SDK, you can build the same transaction as follows:
 ```typescript
 
 // You need to do this only once and re-use it in the application.
-const client = new SuiJsonRpcClient({
-	url: getJsonRpcFullnodeUrl('mainnet'),
+const client = new SuiGrpcClient({
+	baseUrl: 'https://fullnode.mainnet.sui.io:443',
 	network: 'mainnet',
 }).$extend(kiosk());
 
@@ -296,8 +296,8 @@ On the new SDK, the same transaction can be built as follows:
 ```typescript
 
 // You need to do this only once and re-use it in the application.
-const client = new SuiJsonRpcClient({
-	url: getJsonRpcFullnodeUrl('mainnet'),
+const client = new SuiGrpcClient({
+	baseUrl: 'https://fullnode.mainnet.sui.io:443',
 	network: 'mainnet',
 }).$extend(kiosk());
 

package/dist/kiosk/index.md

@@ -1,6 +1,6 @@
 # Kiosk SDK
 
-> TypeScript SDK for interacting with Sui Kiosk onchain commerce.
+> TypeScript SDK for interacting with Sui Kiosk onchain commerce
 
 Kiosk SDK is a tool to interact with Sui and Mysten Kiosk. You can use it to query kiosk related
 data, build transactions to interact, and extend Kiosk to support custom rules.
@@ -16,7 +16,10 @@ npm i @mysten/kiosk
 The Kiosk SDK exports a client extension that integrates with Sui clients. Add it to your client
 using `$extend(kiosk())` to access kiosk functionality through `client.kiosk`.
 
-> The Kiosk SDK requires `SuiJsonRpcClient` or `SuiGraphQLClient`. It does not work with
-> `SuiGrpcClient` because it uses event queries that are not available in gRPC.
+The Kiosk extension accepts any Sui client that implements `ClientWithCoreApi`. Use `SuiGrpcClient`
+for new Kiosk code; `SuiGraphQLClient` and the deprecated `SuiJsonRpcClient` are also compatible.
+
+> **Note:** The gRPC object API returns Display v2 metadata. Use GraphQL or JSON-RPC when reading objects
+> whose types still rely on legacy Display metadata.
 
 - [Read more about setting up the Kiosk client extension](/kiosk/kiosk-client/introduction)

package/dist/kiosk/kiosk-client/introduction.md

@@ -1,14 +1,17 @@
 # Kiosk Client
 
-> Introduction to the KioskClient extension for querying and managing kiosks on Sui.
+> Introduction to the KioskClient extension for querying and managing kiosks on Sui
 
 The Kiosk SDK exports a client extension that provides all Kiosk functionality.
 
 > We recommend you keep only one client instance throughout your app or script. For example, in
 > React, you'd use a context to provide the client.
 
-> The Kiosk SDK requires `SuiJsonRpcClient` or `SuiGraphQLClient`. It does not work with
-> `SuiGrpcClient` because it uses event queries that are not available in gRPC.
+The Kiosk extension accepts any Sui client that implements `ClientWithCoreApi`. Use `SuiGrpcClient`
+for new Kiosk code; `SuiGraphQLClient` and the deprecated `SuiJsonRpcClient` are also compatible.
+
+> **Note:** The gRPC object API returns Display v2 metadata. Use GraphQL or JSON-RPC when reading objects
+> whose types still rely on legacy Display metadata.
 
 ## Setting up the kiosk extension
 
@@ -20,8 +23,8 @@ require constantly changing the package IDs).
 
 ```typescript
 
-const client = new SuiJsonRpcClient({
-	url: getJsonRpcFullnodeUrl('testnet'),
+const client = new SuiGrpcClient({
+	baseUrl: 'https://fullnode.testnet.sui.io:443',
 	network: 'testnet',
 }).$extend(kiosk());
 
@@ -36,8 +39,8 @@ for the rules and extensions you want to use.
 
 ```typescript
 
-const client = new SuiJsonRpcClient({
-	url: getJsonRpcFullnodeUrl('devnet'),
+const client = new SuiGrpcClient({
+	baseUrl: 'https://fullnode.devnet.sui.io:443',
 	network: 'devnet',
 }).$extend(
 	kiosk({

package/dist/kiosk/llms-index.md

@@ -1,8 +1,8 @@
 # Kiosk
 > Interact with on-chain commerce applications
 
-- [Kiosk SDK](..md): TypeScript SDK for interacting with Sui Kiosk onchain commerce.
-- [Kiosk Client](./kiosk-client/introduction.md): Introduction to the KioskClient extension for querying and managing kiosks on Sui.
+- [Kiosk SDK](..md): TypeScript SDK for interacting with Sui Kiosk onchain commerce
+- [Kiosk Client](./kiosk-client/introduction.md): Introduction to the KioskClient extension for querying and managing kiosks on Sui
 - [Querying](./kiosk-client/querying.md): Query kiosk contents, owned kiosks, items, and transfer policies using the Kiosk SDK.
 - [KioskTransaction](./kiosk-client/kiosk-transaction/kiosk-transaction.md): Build kiosk transactions for listing, purchasing, and managing items on Sui.
 - [Managing Owned Kiosk](./kiosk-client/kiosk-transaction/managing.md): Manage kiosk items by placing, listing, delisting, and withdrawing using the Kiosk SDK.
@@ -10,5 +10,5 @@
 - [Examples](./kiosk-client/kiosk-transaction/examples.md): Practical code examples for kiosk transactions including minting, listing, and purchasing.
 - [TransferPolicyTransaction](./kiosk-client/transfer-policy-transaction/introduction.md): Create and manage transfer policies for kiosk items using the Kiosk SDK.
 - [Using the manager](./kiosk-client/transfer-policy-transaction/using-the-manager.md): Use the TransferPolicyTransaction manager to add rules and withdraw profits.
-- [Advanced Examples](./advanced-examples.md): Advanced Kiosk SDK usage patterns and code examples for complex scenarios.
-- [Migrating from Kiosk SDK V1](./from-v1.md): Migrate from Kiosk SDK v1 to the current version with the builder-pattern API.
+- [Advanced Examples](./advanced-examples.md): Advanced Kiosk SDK usage patterns and code examples for complex scenarios
+- [Migrating from Kiosk SDK V1](./from-v1.md): Migrate from Kiosk SDK v1 to the current version with the builder-pattern API

package/dist/llms-index.md

@@ -16,11 +16,11 @@
 
 - [Sui dApp Kit](./dapp-kit.md): Build Sui apps with framework-agnostic core and React bindings.
 - [@mysten/create-dapp](./dapp-kit/getting-started/create-dapp.md): Create a Sui app with one command using the create-dapp CLI scaffolding tool.
-- [React](./dapp-kit/getting-started/react.md): Set up dApp Kit in a React application.
+- [React](./dapp-kit/getting-started/react.md): Set up dApp Kit in a React application
 - [Next.js](./dapp-kit/getting-started/next-js.md): Set up dApp Kit in a Next.js application.
-- [Vue](./dapp-kit/getting-started/vue.md): Set up dApp Kit in a Vue application.
+- [Vue](./dapp-kit/getting-started/vue.md): Set up dApp Kit in a Vue application
 - [DApp Kit Instance](./dapp-kit/dapp-kit-instance.md): Create and configure a DAppKit instance for wallet and client management
-- [State](./dapp-kit/state.md): Access and subscribe to wallet connection state in dApp Kit.
+- [State](./dapp-kit/state.md): Access and subscribe to wallet connection state in dApp Kit
 - [Connect Wallet](./dapp-kit/actions/connect-wallet.md): Programmatically connect to a Sui wallet using the dApp Kit connectWallet action.
 - [Disconnect Wallet](./dapp-kit/actions/disconnect-wallet.md): Programmatically disconnect from a Sui wallet using the dApp Kit disconnectWallet action.
 - [Sign and Execute Transaction](./dapp-kit/actions/sign-and-execute-transaction.md): Sign and execute a transaction on the Sui network using the connected wallet.
@@ -32,7 +32,7 @@
 - [React Hooks](./dapp-kit/react/hooks.md): React hooks for accessing dApp Kit state and actions in Sui applications.
 - [useDAppKit](./dapp-kit/react/hooks/use-dapp-kit.md): React hook to access the full dApp Kit instance for calling actions directly.
 - [useCurrentAccount](./dapp-kit/react/hooks/use-current-account.md): React hook to get the currently selected wallet account in a Sui dApp.
-- [useCurrentClient](./dapp-kit/react/hooks/use-current-client.md): React hook to get the current Sui client instance for the active network.
+- [useCurrentClient](./dapp-kit/react/hooks/use-current-client.md): React hook to get the current Sui client instance for the active network
 - [useCurrentNetwork](./dapp-kit/react/hooks/use-current-network.md): React hook to get the currently selected Sui network in dApp Kit.
 - [useCurrentWallet](./dapp-kit/react/hooks/use-current-wallet.md): React hook to get the currently connected wallet in a Sui dApp.
 - [useWalletConnection](./dapp-kit/react/hooks/use-wallet-connection.md): React hook to manage wallet connection status and information in a Sui dApp.
@@ -48,8 +48,8 @@
 ## Kiosk
 > Interact with on-chain commerce applications
 
-- [Kiosk SDK](./kiosk.md): TypeScript SDK for interacting with Sui Kiosk onchain commerce.
-- [Kiosk Client](./kiosk/kiosk-client/introduction.md): Introduction to the KioskClient extension for querying and managing kiosks on Sui.
+- [Kiosk SDK](./kiosk.md): TypeScript SDK for interacting with Sui Kiosk onchain commerce
+- [Kiosk Client](./kiosk/kiosk-client/introduction.md): Introduction to the KioskClient extension for querying and managing kiosks on Sui
 - [Querying](./kiosk/kiosk-client/querying.md): Query kiosk contents, owned kiosks, items, and transfer policies using the Kiosk SDK.
 - [KioskTransaction](./kiosk/kiosk-client/kiosk-transaction/kiosk-transaction.md): Build kiosk transactions for listing, purchasing, and managing items on Sui.
 - [Managing Owned Kiosk](./kiosk/kiosk-client/kiosk-transaction/managing.md): Manage kiosk items by placing, listing, delisting, and withdrawing using the Kiosk SDK.
@@ -57,8 +57,8 @@
 - [Examples](./kiosk/kiosk-client/kiosk-transaction/examples.md): Practical code examples for kiosk transactions including minting, listing, and purchasing.
 - [TransferPolicyTransaction](./kiosk/kiosk-client/transfer-policy-transaction/introduction.md): Create and manage transfer policies for kiosk items using the Kiosk SDK.
 - [Using the manager](./kiosk/kiosk-client/transfer-policy-transaction/using-the-manager.md): Use the TransferPolicyTransaction manager to add rules and withdraw profits.
-- [Advanced Examples](./kiosk/advanced-examples.md): Advanced Kiosk SDK usage patterns and code examples for complex scenarios.
-- [Migrating from Kiosk SDK V1](./kiosk/from-v1.md): Migrate from Kiosk SDK v1 to the current version with the builder-pattern API.
+- [Advanced Examples](./kiosk/advanced-examples.md): Advanced Kiosk SDK usage patterns and code examples for complex scenarios
+- [Migrating from Kiosk SDK V1](./kiosk/from-v1.md): Migrate from Kiosk SDK v1 to the current version with the builder-pattern API
 
 ## Payment Kit
 > Accept P2P and merchant payments in any coin type on Sui with @mysten/payment-kit
@@ -94,11 +94,11 @@
 
 - [Sui TypeScript SDK](./sui.md): TypeScript SDK for building on the Sui blockchain
 - [LLM Documentation](./sui/llm-docs.md): Give AI agents access to Sui SDK documentation in your project.
-- [Sui Clients](./sui/clients.md): Choose and configure gRPC, GraphQL, or JSON-RPC clients for the Sui network.
-- [Core API](./sui/clients/core.md): Transport-agnostic Core API shared by all Sui clients.
-- [SuiGrpcClient](./sui/clients/grpc.md): Connect to Sui through gRPC with SuiGrpcClient.
-- [SuiGraphQLClient](./sui/clients/graphql.md): Connect to Sui through GraphQL with SuiGraphQLClient.
-- [SuiJsonRpcClient](./sui/clients/json-rpc.md): Connect to Sui through JSON-RPC with SuiJsonRpcClient.
+- [Sui Clients](./sui/clients.md): Choose and configure SuiGrpcClient, SuiGraphQLClient, and legacy JSON-RPC clients
+- [Core API](./sui/clients/core.md): Transport-agnostic Core API shared by Sui clients
+- [SuiGrpcClient](./sui/clients/grpc.md): Connect to Sui through gRPC with the recommended SuiGrpcClient
+- [SuiGraphQLClient](./sui/clients/graphql.md): Connect to Sui through GraphQL with SuiGraphQLClient
+- [SuiJsonRpcClient](./sui/clients/json-rpc.md): Maintain legacy JSON-RPC code while migrating to SuiGrpcClient or SuiGraphQLClient
 - [Building Transactions](./sui/transactions/basics.md): Construct programmable transaction blocks with the Transaction API
 - [Signing and Execution](./sui/transactions/signing-and-execution.md): Sign transactions and execute them on the Sui network
 - [Coins and Balances](./sui/transactions/coins-and-balances.md): Work with coin objects and address balances in transactions
@@ -117,22 +117,22 @@
 - [Derived Objects](./sui/utils/derived_objects.md): Compute derived object IDs from parent objects for deterministic offline derivation.
 - [BCS](./sui/bcs.md): Binary Canonical Serialization for encoding Sui Move types.
 - [ZkLogin](./sui/zklogin.md): Zero-knowledge authentication with OAuth providers on Sui.
-- [Transaction Executors](./sui/executors.md): Manage transaction execution with queuing and parallel strategies.
+- [Transaction Executors](./sui/executors.md): Manage transaction execution with queuing and parallel strategies
 - [Transaction Plugins](./sui/plugins.md): Extend transaction building with reusable plugins.
-- [Building SDKs](./sui/sdk-building.md): Build custom SDKs on top of the Sui TypeScript SDK.
-- [Migrate to 2.0](./sui/migrations/sui-2.0.md): Migration guide for Sui TypeScript SDK 2.0 covering all @mysten packages.
+- [Building SDKs](./sui/sdk-building.md): Build custom SDKs on top of the Sui TypeScript SDK
+- [Migrate to 2.0](./sui/migrations/sui-2.0.md): Migration guide for Sui TypeScript SDK 2.0 covering all @mysten packages
 - [Agent Migration Prompt](./sui/migrations/sui-2.0/agent-prompt.md): AI agent prompt for automated SDK 2.0 migration of your codebase.
-- [@mysten/sui](./sui/migrations/sui-2.0/sui.md): Migrate @mysten/sui from 1.x to 2.0 with new client APIs and BCS changes.
-- [Migrating from JSON-RPC](./sui/migrations/sui-2.0/json-rpc-migration.md): Migrate from JSON-RPC to the new Core API using SuiGrpcClient or SuiGraphQLClient.
-- [@mysten/dapp-kit](./sui/migrations/sui-2.0/dapp-kit.md): Migrate @mysten/dapp-kit to the new dapp-kit-react package in 2.0.
-- [@mysten/kiosk](./sui/migrations/sui-2.0/kiosk.md): Migrate @mysten/kiosk to 2.0 with client extension pattern and KioskTransaction.
-- [@mysten/zksend](./sui/migrations/sui-2.0/zksend.md): Migrate @mysten/zksend to 2.0 with client extension pattern and simplified API.
-- [@mysten/suins](./sui/migrations/sui-2.0/suins.md): Migrate @mysten/suins to 2.0 with client extension pattern.
-- [@mysten/deepbook-v3](./sui/migrations/sui-2.0/deepbook-v3.md): Migrate @mysten/deepbook-v3 to 2.0 with client extension pattern.
-- [@mysten/walrus](./sui/migrations/sui-2.0/walrus.md): Migrate @mysten/walrus to 2.0 with required client parameter and updated API.
+- [@mysten/sui](./sui/migrations/sui-2.0/sui.md): Migrate @mysten/sui from 1.x to 2.0 with gRPC clients, Core API, and BCS changes
+- [Migrating from JSON-RPC](./sui/migrations/sui-2.0/json-rpc-migration.md): Migrate deprecated JSON-RPC code to shared gRPC and GraphQL top-level methods
+- [@mysten/dapp-kit](./sui/migrations/sui-2.0/dapp-kit.md): Migrate @mysten/dapp-kit to the new dapp-kit-react package in 2.0
+- [@mysten/kiosk](./sui/migrations/sui-2.0/kiosk.md): Migrate @mysten/kiosk to 2.0 with client extension pattern and KioskTransaction
+- [@mysten/zksend](./sui/migrations/sui-2.0/zksend.md): Migrate @mysten/zksend to 2.0 with client extension pattern and simplified API
+- [@mysten/suins](./sui/migrations/sui-2.0/suins.md): Migrate @mysten/suins to 2.0 with client extension pattern
+- [@mysten/deepbook-v3](./sui/migrations/sui-2.0/deepbook-v3.md): Migrate @mysten/deepbook-v3 to 2.0 with client extension pattern
+- [@mysten/walrus](./sui/migrations/sui-2.0/walrus.md): Migrate @mysten/walrus to 2.0 with required client parameter and updated API
 - [@mysten/seal](./sui/migrations/sui-2.0/seal.md): Migrate @mysten/seal to 2.0 with the new registration function pattern.
 - [Wallet Builders](./sui/migrations/sui-2.0/wallet-builders.md): Migration guide for wallet extension developers upgrading to 2.0.
-- [SDK Maintainers](./sui/migrations/sui-2.0/sdk-maintainers.md): Migration guide for SDK maintainers and library authors upgrading to 2.0.
+- [SDK Maintainers](./sui/migrations/sui-2.0/sdk-maintainers.md): Migration guide for SDK maintainers and library authors upgrading to 2.0
 - [Migrate to 1.0](./sui/migrations/sui-1.0.md): Migrate to Sui TypeScript SDK 1.0 with new features and API changes.
 - [Migrate to 0.38.0](./sui/migrations/0.38.md): Migrate from SDK version 0.37 to 0.38 with updated module structure and API changes.
 

package/dist/seal/index.md

@@ -46,6 +46,9 @@ The `seal()` function accepts the following options:
     authentication
 - **`verifyKeyServers`** (optional) - Whether to verify key server authenticity (default: `true`)
 - **`timeout`** (optional) - Timeout in milliseconds for network requests (default: `10000`)
+- **`fetch`** (optional) - Custom fetch implementation used for all key server requests (default:
+  the global `fetch`), for example to send cookies with `credentials: 'include'` or attach your own
+  headers
 
 ## Choosing key servers
 

package/dist/sui/clients/core.md

@@ -1,10 +1,15 @@
 # Core API
 
-> Transport-agnostic Core API shared by all Sui clients.
+> Transport-agnostic Core API shared by Sui clients
 
-The Core API is the transport-agnostic interface that all Sui clients implement. It provides a
-consistent set of methods for interacting with the Sui blockchain, regardless of whether you're
-using gRPC, GraphQL, or JSON-RPC.
+The Core API is the transport-agnostic interface shared by Sui clients. It provides a consistent set
+of methods for interacting with the Sui blockchain across `SuiGrpcClient`, `SuiGraphQLClient`, and
+the deprecated `SuiJsonRpcClient`.
+
+For application code, prefer the top-level methods on the concrete client you instantiate, such as
+`grpcClient.getObject()` or `graphqlClient.listTransactions()`. Those methods match the Core API for
+common operations and may expose transport-specific additions. Use `client.core` when writing SDKs,
+libraries, or helpers that accept any `ClientWithCoreApi`.
 
 ## `ClientWithCoreApi`
 
@@ -83,9 +88,7 @@ List objects owned by an address.
 ```typescript
 const result = await client.core.listOwnedObjects({
 	owner: '0xabc...',
-	filter: {
-		StructType: '0x2::coin::Coin<0x2::sui::SUI>',
-	},
+	type: '0x2::coin::Coin<0x2::sui::SUI>',
 	limit: 10,
 });
 
@@ -342,9 +345,12 @@ const result = await client.core.simulateTransaction({
 	},
 });
 
+const simulatedTransaction =
+	result.$kind === 'Transaction' ? result.Transaction : result.FailedTransaction;
+
 // Check simulated effects before signing
-console.log(result.effects);
-console.log(result.balanceChanges);
+console.log(simulatedTransaction.effects);
+console.log(simulatedTransaction.balanceChanges);
 ```
 
 #### Disabling checks
@@ -598,12 +604,27 @@ console.log(fn.typeParameters);
 
 ## Name service methods
 
+### `resolveNameServiceAddress`
+
+Resolve a SuiNS name to its target address. The address is `null` when the name does not exist, has
+expired, or does not have a target address.
+
+```typescript
+const { address } = await client.core.resolveNameServiceAddress({
+	name: 'example.sui',
+});
+
+console.log(address); // e.g., "0x..." or null
+```
+
 ### `defaultNameServiceName`
 
 Resolve an address to its default SuiNS name.
 
 ```typescript
-const { name } = await client.core.defaultNameServiceName({
+const {
+	data: { name },
+} = await client.core.defaultNameServiceName({
 	address: '0xabc...',
 });
 

package/dist/sui/clients/graphql.md

@@ -1,27 +1,60 @@
 # SuiGraphQLClient
 
-> Connect to Sui through GraphQL with SuiGraphQLClient.
+> Connect to Sui through GraphQL with SuiGraphQLClient
 
 The `SuiGraphQLClient` enables type-safe GraphQL queries against the Sui GraphQL API.
 
 For more details on the Sui GraphQL API, see the
 [GraphQL reference](https://docs.sui.io/references/sui-graphql).
 
-The `SuiGraphQLClient` implements all the the [Core API](/sui/clients/core) methods:
+Use `SuiGraphQLClient` when an app needs indexed GraphQL data, historical queries, or custom
+selection sets that are not exposed by the gRPC top-level API.
+
+## Using top-level methods
+
+`SuiGraphQLClient` exposes top-level methods for the same common operations as the
+[Core API](/sui/clients/core). Use them directly in application code:
 
 ```typescript
 
 const client = new SuiGraphQLClient({
-	url: 'https://sui-mainnet.mystenlabs.com/graphql',
+	url: 'https://graphql.mainnet.sui.io/graphql',
 	network: 'mainnet',
 });
 
-const { object } = await client.getObject({ objectId: '0x...' });
+const { object } = await client.getObject({
+	objectId: '0x...',
+	include: { content: true },
+});
+
+const txs = await client.listTransactions({
+	filter: { sender: '0x...' },
+	order: 'descending',
+	limit: 10,
+});
 ```
 
+The same methods are available through `client.core` when SDK code needs the transport-agnostic
+`ClientWithCoreApi` contract.
+
+Common top-level methods:
+
+| Category       | Methods                                                                                                           |
+| -------------- | ----------------------------------------------------------------------------------------------------------------- |
+| Objects        | `getObject`, `getObjects`, `listOwnedObjects`, `listDynamicFields`, `getDynamicField`                             |
+| Coins          | `listCoins`, `getBalance`, `listBalances`, `getCoinMetadata`                                                      |
+| Transactions   | `getTransaction`, `executeTransaction`, `signAndExecuteTransaction`, `waitForTransaction`                         |
+| Simulation     | `simulateTransaction`                                                                                             |
+| Queries        | `listTransactions`, `listEvents`                                                                                  |
+| Move and names | `getMoveFunction`, `resolveNameServiceAddress`, `defaultNameServiceName`, `mvr.resolvePackage`, `mvr.resolveType` |
+| Verification   | `verifyZkLoginSignature`                                                                                          |
+
+GraphQL-specific top-level options include `doGasSelection` on `simulateTransaction` and
+`include: { value: true }` on `listDynamicFields`.
+
 ## Custom GraphQL queries
 
-To query anything no in the Core API, you can use the `query` method to execute custom GraphQL
+To query anything not in the top-level API, use the `query` method to execute custom GraphQL
 queries.
 
 We'll start by creating our client, and executing a very basic query:
@@ -62,7 +95,9 @@ passed to your query are properly typed.
 const getSuinsName = graphql(`
 	query getSuiName($address: SuiAddress!) {
 		address(address: $address) {
-			defaultSuinsName
+			defaultNameRecord {
+				domain
+			}
 		}
 	}
 `);
@@ -75,7 +110,7 @@ async function getDefaultSuinsName(address: string) {
 		},
 	});
 
-	return result.data?.address?.defaultSuinsName;
+	return result.data?.address?.defaultNameRecord?.domain;
 }
 ```
 
@@ -94,7 +129,7 @@ const chainIdentifierQuery = graphql(`
 `);
 
 function ChainIdentifier() {
-	const { loading, error, data } = useQuery(getPokemonsQuery);
+	const { loading, error, data } = useQuery(chainIdentifierQuery);
 
 	return <div>{data?.chainIdentifier}</div>;
 }