@mysten/docs 0.1.16 → 0.1.18

package/dist/bcs/llms-index.md

@@ -1,4 +1,4 @@
 # BCS
 > Encoding and decoding Sui objects
 
-- [BCS - Binary Canonical Serialization](./index.md): Encode and decode Sui Move types with Binary Canonical Serialization
+- [BCS - Binary Canonical Serialization](..md): Encode and decode Sui Move types with Binary Canonical Serialization

package/dist/codegen/llms-index.md

@@ -1,4 +1,4 @@
 # TypeScript Codegen
 > Generate type-safe TypeScript code from Sui Move packages
 
-- [Sui TypeScript Codegen](./index.md): Generate type-safe TypeScript bindings from on-chain Sui Move packages
+- [Sui TypeScript Codegen](..md): Generate type-safe TypeScript bindings from on-chain Sui Move packages

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

@@ -1,7 +1,7 @@
 # dApp Kit
 > Build Sui dApps with @mysten/dapp-kit-core and @mysten/dapp-kit-react
 
-- [Sui dApp Kit](./index.md): Build Sui dApps with framework-agnostic core and React bindings
+- [Sui dApp Kit](..md): Build Sui dApps with framework-agnostic core and React bindings
 - [@mysten/create-dapp](./getting-started/create-dapp.md): Create a Sui dApp with one command
 - [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
@@ -16,11 +16,12 @@
 - [Switch Account](./actions/switch-account.md): Switch the active account in the connected wallet
 - [Switch Network](./actions/switch-network.md): Switch the active network for the dApp Kit instance
 - [DAppKitProvider](./react/dapp-kit-provider.md): React context provider for dApp Kit configuration
-- [React Hooks](./react/hooks/index.md): React hooks for accessing dApp Kit state and actions
+- [React Hooks](./react/hooks.md): React hooks for accessing dApp Kit state and actions
 - [useDAppKit](./react/hooks/use-dapp-kit.md): React hook to access the full dApp Kit instance
-- [React Components](./react/components/index.md): Pre-built React UI components for wallet interaction
+- [React Components](./react/components.md): Pre-built React UI components for wallet interaction
 - [Connect Button](./react/components/connect-button.md): React button component for wallet connection
 - [Connect Modal](./react/components/connect-modal.md): React modal component for wallet selection
 - [Connect Button](./web-components/connect-button.md): Framework-agnostic web component for wallet connection
 - [Connect Modal](./web-components/connect-modal.md): Framework-agnostic web component for wallet selection
 - [Theming](./theming.md): Customize the appearance of dApp Kit UI components
+- [Sui dApp Kit (Legacy)](./legacy.md): dApp Kit API reference for @mysten/dapp-kit

package/dist/kiosk/llms-index.md

@@ -1,7 +1,7 @@
 # Kiosk
 > Interact with on-chain commerce applications
 
-- [Kiosk SDK](./index.md): TypeScript SDK for interacting with Sui Kiosk on-chain commerce
+- [Kiosk SDK](..md): TypeScript SDK for interacting with Sui Kiosk on-chain commerce
 - [Kiosk Client](./kiosk-client/introduction.md): Introduction to the KioskClient for querying and managing kiosks
 - [Querying](./kiosk-client/querying.md): Query kiosk contents, items, and transfer policies
 - [Advanced Examples](./advanced-examples.md): Advanced Kiosk SDK usage patterns and examples

package/dist/llms-index.md

@@ -4,17 +4,17 @@
 ## BCS
 > Encoding and decoding Sui objects
 
-- [BCS - Binary Canonical Serialization](./bcs/index.md): Encode and decode Sui Move types with Binary Canonical Serialization
+- [BCS - Binary Canonical Serialization](./bcs.md): Encode and decode Sui Move types with Binary Canonical Serialization
 
 ## TypeScript Codegen
 > Generate type-safe TypeScript code from Sui Move packages
 
-- [Sui TypeScript Codegen](./codegen/index.md): Generate type-safe TypeScript bindings from on-chain Sui Move packages
+- [Sui TypeScript Codegen](./codegen.md): Generate type-safe TypeScript bindings from on-chain Sui Move packages
 
 ## dApp Kit
 > Build Sui dApps with @mysten/dapp-kit-core and @mysten/dapp-kit-react
 
-- [Sui dApp Kit](./dapp-kit/index.md): Build Sui dApps with framework-agnostic core and React bindings
+- [Sui dApp Kit](./dapp-kit.md): Build Sui dApps with framework-agnostic core and React bindings
 - [@mysten/create-dapp](./dapp-kit/getting-started/create-dapp.md): Create a Sui dApp with one command
 - [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
@@ -29,19 +29,20 @@
 - [Switch Account](./dapp-kit/actions/switch-account.md): Switch the active account in the connected wallet
 - [Switch Network](./dapp-kit/actions/switch-network.md): Switch the active network for the dApp Kit instance
 - [DAppKitProvider](./dapp-kit/react/dapp-kit-provider.md): React context provider for dApp Kit configuration
-- [React Hooks](./dapp-kit/react/hooks/index.md): React hooks for accessing dApp Kit state and actions
+- [React Hooks](./dapp-kit/react/hooks.md): React hooks for accessing dApp Kit state and actions
 - [useDAppKit](./dapp-kit/react/hooks/use-dapp-kit.md): React hook to access the full dApp Kit instance
-- [React Components](./dapp-kit/react/components/index.md): Pre-built React UI components for wallet interaction
+- [React Components](./dapp-kit/react/components.md): Pre-built React UI components for wallet interaction
 - [Connect Button](./dapp-kit/react/components/connect-button.md): React button component for wallet connection
 - [Connect Modal](./dapp-kit/react/components/connect-modal.md): React modal component for wallet selection
 - [Connect Button](./dapp-kit/web-components/connect-button.md): Framework-agnostic web component for wallet connection
 - [Connect Modal](./dapp-kit/web-components/connect-modal.md): Framework-agnostic web component for wallet selection
 - [Theming](./dapp-kit/theming.md): Customize the appearance of dApp Kit UI components
+- [Sui dApp Kit (Legacy)](./dapp-kit/legacy.md): dApp Kit API reference for @mysten/dapp-kit
 
 ## Kiosk
 > Interact with on-chain commerce applications
 
-- [Kiosk SDK](./kiosk/index.md): TypeScript SDK for interacting with Sui Kiosk on-chain commerce
+- [Kiosk SDK](./kiosk.md): TypeScript SDK for interacting with Sui Kiosk on-chain commerce
 - [Kiosk Client](./kiosk/kiosk-client/introduction.md): Introduction to the KioskClient for querying and managing kiosks
 - [Querying](./kiosk/kiosk-client/querying.md): Query kiosk contents, items, and transfer policies
 - [Advanced Examples](./kiosk/advanced-examples.md): Advanced Kiosk SDK usage patterns and examples
@@ -50,7 +51,7 @@
 ## Payment Kit
 > Accept payments in any coin type on Sui
 
-- [Payment Kit](./payment-kit/index.md): Accept payments in any coin type on Sui
+- [Payment Kit](./payment-kit.md): Accept payments in any coin type on Sui
 - [Getting Started](./payment-kit/getting-started.md): Install and set up Payment Kit for your Sui dApp
 - [Payment Kit SDK](./payment-kit/payment-kit-sdk.md): Payment Kit SDK API reference and configuration
 - [Payment Processing](./payment-kit/payment-processing.md): Process payments and handle transaction results
@@ -59,24 +60,24 @@
 ## Seal
 > Use Seal, a decentralized secrets management service that secures your data using threshold encryption and on-chain access control.
 
-- [Seal SDK](./seal/index.md): Decentralized secrets management with threshold encryption on Sui
+- [Seal SDK](./seal.md): Decentralized secrets management with threshold encryption on Sui
 
 ## Slush Wallet
 > Slush Wallet Integration
 
-- [Slush Wallet Integration](./slush-wallet/index.md): Integrate Slush Wallet into your Sui dApp
+- [Slush Wallet Integration](./slush-wallet.md): Integrate Slush Wallet into your Sui dApp
 - [dApp Integration](./slush-wallet/dapp.md): Connect your dApp to Slush Wallet
 - [Deep Linking](./slush-wallet/deep-linking.md): Deep linking configuration for Slush Wallet
 
 ## Sui SDK
 > TypeScript interfaces for Sui
 
-- [Sui TypeScript SDK Quick Start](./sui/index.md): TypeScript SDK for building on the Sui blockchain
+- [Sui TypeScript SDK Quick Start](./sui.md): TypeScript SDK for building on the Sui blockchain
 - [Install Sui TypeScript SDK](./sui/install.md): Install the @mysten/sui package and configure your project
 - [LLM Documentation](./sui/llm-docs.md): Give AI agents access to Sui SDK documentation in your project
 - [Hello Sui](./sui/hello-sui.md): Build your first Sui application with the TypeScript SDK
 - [Faucet](./sui/faucet.md): Request test SUI tokens from the faucet
-- [Sui Clients](./sui/clients/index.md): Choose and configure gRPC, GraphQL, or JSON-RPC clients
+- [Sui Clients](./sui/clients.md): Choose and configure gRPC, GraphQL, or JSON-RPC clients
 - [Core API](./sui/clients/core.md): Transport-agnostic Core API shared by all Sui clients
 - [SuiGrpcClient](./sui/clients/grpc.md): Connect to Sui via gRPC with SuiGrpcClient
 - [SuiGraphQLClient](./sui/clients/graphql.md): Connect to Sui via GraphQL with SuiGraphQLClient
@@ -90,14 +91,14 @@
 - [Multi-Signature Transactions](./sui/cryptography/multisig.md): Create multi-signature transactions with multiple signers
 - [Passkey](./sui/cryptography/passkey.md): Use WebAuthn passkeys for Sui transaction signing
 - [Web Crypto Signer](./sui/cryptography/webcrypto-signer.md): Sign transactions using the Web Crypto API
-- [The `@mysten/sui/utils` package](./sui/utils/index.md): Utility functions for addresses, coins, and common operations
+- [The `@mysten/sui/utils` package](./sui/utils.md): Utility functions for addresses, coins, and common operations
 - [Derived Objects](./sui/utils/derived_objects.md): Compute derived object IDs from parent objects
 - [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 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/index.md): Migration guide for Sui TypeScript SDK 2.0
+- [Migrate to 2.0](./sui/migrations/sui-2.0.md): Migration guide for Sui TypeScript SDK 2.0
 - [Agent Migration Prompt](./sui/migrations/sui-2.0/agent-prompt.md): AI agent prompt for automated SDK 2.0 migration
 - [@mysten/sui](./sui/migrations/sui-2.0/sui.md): Migrate @mysten/sui from 1.x to 2.0
 - [Migrating from JSON-RPC](./sui/migrations/sui-2.0/json-rpc-migration.md): Migrate from JSON-RPC to the new Core API
@@ -116,10 +117,11 @@
 ## Walrus
 > Publish and Read blobs directly from walrus storage nodes
 
-- [Walrus SDK](./walrus/index.md): Store and retrieve blobs on Walrus decentralized storage
+- [Walrus SDK](./walrus.md): Store and retrieve blobs on Walrus decentralized storage
 
 ## ZkSend
 > Send Sui with a link
 
-- [zkSend SDK](./zksend/index.md): Send Sui assets via shareable links with zkSend
+- [zkSend SDK](./zksend.md): Send Sui assets via shareable links with zkSend
 - [Creating zkSend Links](./zksend/link-builder.md): Create and customize zkSend claim links
+- [Composable Claims](./zksend/composable-claim.md): Claim a zkSend link and use the assets in the same transaction

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

@@ -1,7 +1,7 @@
 # Payment Kit
 > Accept payments in any coin type on Sui
 
-- [Payment Kit](./index.md): Accept payments in any coin type on Sui
+- [Payment Kit](..md): Accept payments in any coin type on Sui
 - [Getting Started](./getting-started.md): Install and set up Payment Kit for your Sui dApp
 - [Payment Kit SDK](./payment-kit-sdk.md): Payment Kit SDK API reference and configuration
 - [Payment Processing](./payment-processing.md): Process payments and handle transaction results

package/dist/seal/llms-index.md

@@ -1,4 +1,4 @@
 # Seal
 > Use Seal, a decentralized secrets management service that secures your data using threshold encryption and on-chain access control.
 
-- [Seal SDK](./index.md): Decentralized secrets management with threshold encryption on Sui
+- [Seal SDK](..md): Decentralized secrets management with threshold encryption on Sui

package/dist/slush-wallet/llms-index.md

@@ -1,6 +1,6 @@
 # Slush Wallet
 > Slush Wallet Integration
 
-- [Slush Wallet Integration](./index.md): Integrate Slush Wallet into your Sui dApp
+- [Slush Wallet Integration](..md): Integrate Slush Wallet into your Sui dApp
 - [dApp Integration](./dapp.md): Connect your dApp to Slush Wallet
 - [Deep Linking](./deep-linking.md): Deep linking configuration for Slush Wallet

package/dist/sui/llms-index.md

@@ -1,12 +1,12 @@
 # Sui SDK
 > TypeScript interfaces for Sui
 
-- [Sui TypeScript SDK Quick Start](./index.md): TypeScript SDK for building on the Sui blockchain
+- [Sui TypeScript SDK Quick Start](..md): TypeScript SDK for building on the Sui blockchain
 - [Install Sui TypeScript SDK](./install.md): Install the @mysten/sui package and configure your project
 - [LLM Documentation](./llm-docs.md): Give AI agents access to Sui SDK documentation in your project
 - [Hello Sui](./hello-sui.md): Build your first Sui application with the TypeScript SDK
 - [Faucet](./faucet.md): Request test SUI tokens from the faucet
-- [Sui Clients](./clients/index.md): Choose and configure gRPC, GraphQL, or JSON-RPC clients
+- [Sui Clients](./clients.md): Choose and configure gRPC, GraphQL, or JSON-RPC clients
 - [Core API](./clients/core.md): Transport-agnostic Core API shared by all Sui clients
 - [SuiGrpcClient](./clients/grpc.md): Connect to Sui via gRPC with SuiGrpcClient
 - [SuiGraphQLClient](./clients/graphql.md): Connect to Sui via GraphQL with SuiGraphQLClient
@@ -20,14 +20,14 @@
 - [Multi-Signature Transactions](./cryptography/multisig.md): Create multi-signature transactions with multiple signers
 - [Passkey](./cryptography/passkey.md): Use WebAuthn passkeys for Sui transaction signing
 - [Web Crypto Signer](./cryptography/webcrypto-signer.md): Sign transactions using the Web Crypto API
-- [The `@mysten/sui/utils` package](./utils/index.md): Utility functions for addresses, coins, and common operations
+- [The `@mysten/sui/utils` package](./utils.md): Utility functions for addresses, coins, and common operations
 - [Derived Objects](./utils/derived_objects.md): Compute derived object IDs from parent objects
 - [BCS](./bcs.md): Binary Canonical Serialization for encoding Sui Move types
 - [ZkLogin](./zklogin.md): Zero-knowledge authentication with OAuth providers on Sui
 - [Transaction Executors](./executors.md): Manage transaction execution with queuing and parallel strategies
 - [Transaction Plugins](./plugins.md): Extend transaction building with reusable plugins
 - [Building SDKs](./sdk-building.md): Build custom SDKs on top of the Sui TypeScript SDK
-- [Migrate to 2.0](./migrations/sui-2.0/index.md): Migration guide for Sui TypeScript SDK 2.0
+- [Migrate to 2.0](./migrations/sui-2.0.md): Migration guide for Sui TypeScript SDK 2.0
 - [Agent Migration Prompt](./migrations/sui-2.0/agent-prompt.md): AI agent prompt for automated SDK 2.0 migration
 - [@mysten/sui](./migrations/sui-2.0/sui.md): Migrate @mysten/sui from 1.x to 2.0
 - [Migrating from JSON-RPC](./migrations/sui-2.0/json-rpc-migration.md): Migrate from JSON-RPC to the new Core API

package/dist/sui/utils/index.md

@@ -31,6 +31,13 @@ You can use the following helpers to format various values:
 - `normalizeSuiNSName`
 - `normalizeSuiNSName`
 
+## Parsers
+
+You can use the following helpers to parse decimal strings into smallest-unit bigints:
+
+- `parseToUnits`: Parse a decimal string into a `bigint`, given a coin's `decimals`
+- `parseToMist`: Parse a SUI decimal string into MIST (9 decimals)
+
 ## Validators
 
 You can use the following helpers to validate the format of various values (this only validates that

package/dist/walrus/llms-index.md

@@ -1,4 +1,4 @@
 # Walrus
 > Publish and Read blobs directly from walrus storage nodes
 
-- [Walrus SDK](./index.md): Store and retrieve blobs on Walrus decentralized storage
+- [Walrus SDK](..md): Store and retrieve blobs on Walrus decentralized storage

package/dist/zksend/composable-claim.md

@@ -0,0 +1,70 @@
+# Composable Claims
+
+> Claim a zkSend link and use the assets in the same transaction
+
+By default, `link.claimAssets(address)` builds a claim transaction that transfers every asset to the
+recipient and submits it via a Mysten-hosted sponsor. If you want to _use_ a claimed object in the
+same transaction — for example, inserting a claimed NFT into another on-chain object, staking a
+claimed coin, or depositing into a vault — use `link.claimFlow()` to compose the claim into your own
+transaction.
+
+## How it works
+
+`link.claimFlow()` returns three transaction thunks:
+
+- **`init`** — adds the `init_claim` (or `reclaim`) move call that creates the claim proof.
+- **`assets`** — an array of claimable assets. Each `asset.argument` is a lazy
+  `TransactionObjectArgument` that emits the backing `claim<T>` move call the first time it's used.
+- **`finalize`** — consumes the claim proof. Must be added after every asset is claimed.
+
+```ts
+
+const tx = new Transaction();
+tx.setSender(claimLink.keypair!.toSuiAddress());
+
+const { init, assets, finalize } = claimLink.claimFlow();
+
+tx.add(init);
+
+for (const asset of assets) {
+	if (asset.type === `${PACKAGE_ID}::record::Record`) {
+		// Insert the claimed record directly into the recipient's player object
+		tx.moveCall({
+			target: `${PACKAGE_ID}::player::add_record`,
+			arguments: [tx.object(playerId), asset.argument],
+		});
+	} else {
+		tx.transferObjects([asset.argument], recipient);
+	}
+}
+
+tx.add(finalize);
+```
+
+Every asset in the returned list must be claimed somewhere in the transaction — assets that are
+never used won't create a `claim<T>` command and the transaction will fail. If you only want the
+default claim-and-transfer behavior, use `link.createClaimTransaction(address)` instead.
+
+## Sponsorship
+
+`link.claimAssets(address)` uses a sponsorship flow so the claimer does not need gas to claim the
+assets, but it only accepts the standard `init_claim` → `claim<T>` → transfer → `finalize` shape.
+Transactions built with `claimFlow()` may include extra move calls, so the default sponsor may
+reject them.
+
+Apps using `claimFlow()` are responsible for their own gas and sponsorship. The ephemeral link
+keypair is still the transaction sender (it authorizes the claim), so the typical pattern is dual
+signing: the link keypair signs as sender and your app's sponsor signs for gas.
+
+```ts
+tx.setGasOwner(sponsorAddress);
+const txBytes = await tx.build({ client });
+
+const linkSig = await claimLink.keypair!.signTransaction(txBytes);
+const sponsorSig = await sponsor.signTransaction(txBytes);
+
+const result = await client.core.executeTransaction({
+	transaction: txBytes,
+	signatures: [linkSig.signature, sponsorSig.signature],
+});
+```

package/dist/zksend/llms-index.md

@@ -1,5 +1,6 @@
 # ZkSend
 > Send Sui with a link
 
-- [zkSend SDK](./index.md): Send Sui assets via shareable links with zkSend
+- [zkSend SDK](..md): Send Sui assets via shareable links with zkSend
 - [Creating zkSend Links](./link-builder.md): Create and customize zkSend claim links
+- [Composable Claims](./composable-claim.md): Claim a zkSend link and use the assets in the same transaction

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mysten/docs",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "LLM-friendly documentation for the Sui TypeScript SDK ecosystem",
   "license": "Apache-2.0",
   "repository": {
@@ -23,27 +23,27 @@
     "fumadocs-typescript": "^5.2.0",
     "fumadocs-ui": "16.4.7",
     "gray-matter": "^4.0.3",
-    "next": "^16.1.7",
+    "next": "^16.2.3",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
     "@mysten/bcs": "2.0.3",
     "@mysten/dapp-kit": "1.0.4",
     "@mysten/dapp-kit-core": "1.3.0",
     "@mysten/dapp-kit-react": "2.0.1",
-    "@mysten/deepbook-v3": "1.2.2",
+    "@mysten/deepbook-v3": "1.3.1",
     "@mysten/enoki": "1.0.4",
     "@mysten/enoki-connect": "1.0.2",
-    "@mysten/kiosk": "1.2.1",
-    "@mysten/payment-kit": "0.1.6",
+    "@mysten/kiosk": "1.2.2",
+    "@mysten/payment-kit": "0.1.7",
     "@mysten/seal": "1.1.1",
     "@mysten/signers": "1.0.2",
     "@mysten/slush-wallet": "1.0.3",
-    "@mysten/sui": "2.15.0",
-    "@mysten/suins": "1.0.3",
+    "@mysten/sui": "2.16.0",
+    "@mysten/suins": "1.0.5",
     "@mysten/utils": "0.3.1",
     "@mysten/wallet-standard": "0.20.1",
-    "@mysten/walrus": "1.1.1",
-    "@mysten/zksend": "1.0.3"
+    "@mysten/walrus": "1.1.2",
+    "@mysten/zksend": "1.1.0"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.18",