@mysten/docs 0.1.27 → 0.1.29

package/dist/bcs/index.md

@@ -11,7 +11,7 @@ available in both Browser and NodeJS environments in a type-safe way.`
 To install, add the [`@mysten/bcs`](https://www.npmjs.com/package/@mysten/bcs) package to your
 project:
 
-```sh npm2yarn
+```npm
 npm i @mysten/bcs
 ```
 

package/dist/codegen/index.md

@@ -19,7 +19,7 @@ packages, enabling seamless interaction with your smart contracts from TypeScrip
 
 Install the codegen package as a dev dependency:
 
-```sh npm2yarn
+```npm
 npm install -D @mysten/codegen
 ```
 
@@ -296,8 +296,9 @@ they don't affect serialization. The generated type is a constant rather than a
 This works correctly for parsing onchain data because phantom types don't change the binary layout.
 
 > **Note:** With the default behavior, phantom parameters appear as literals in the type name (for example,
-> `Balance<phantom T>`). These names are useful for debugging but are not valid onchain type tags. If
-> you need valid type names with resolved phantom parameters, enable `includePhantomTypeParameters`.
+> `Balance<phantom T>`). These names are useful for debugging but are not valid onchain type tags. Use
+> the [`typeTag` method](#getting-type-tags) to build valid type tags with the phantom parameters
+> filled in.
 
 ### Including phantom type parameters
 
@@ -372,6 +373,69 @@ async function readCounter(client: ClientWithCoreApi, id: string) {
 > contains a full object envelope with additional metadata that will cause parsing to fail. See the
 > [Core API docs](/sui/clients/core#objectbcs) for details.
 
+### Getting type tags
+
+Generated types build their own type tag strings with the `typeTag` method, so you don't hand-write
+strings like `` `${packageId}::module::Name<${coinType}>` ``. By default the tag uses the package
+the type was generated from — a real address for framework types, or the configured name for a local
+or MVR package:
+
+```typescript
+
+Balance.typeTag({ typeArguments: ['0x2::sui::SUI'] });
+// '0x2::balance::Balance<0x2::sui::SUI>'
+
+Counter.typeTag();
+// '@local-pkg/counter::counter::Counter'
+```
+
+Types with phantom type parameters require `typeArguments`; types without them take none. This is
+enforced at compile time:
+
+```typescript
+Counter.typeTag(); // ok — no type parameters
+Balance.typeTag({ typeArguments: ['0x2::sui::SUI'] }); // ok
+
+// @ts-expect-error — Balance has a phantom parameter, typeArguments is required
+Balance.typeTag();
+```
+
+`typeArguments` is the full positional list, in Move declaration order. Each entry is a type tag
+string, another `typeTag()` result, or a BCS type (its `name` is used):
+
+```typescript
+
+Balance.typeTag({ typeArguments: [bcs.u64()] });
+// '0x2::balance::Balance<u64>'
+```
+
+To override the package identifier — for example, to pin a specific published address — pass
+`package`:
+
+```typescript
+Counter.typeTag({ package: '0xPACKAGE_ID' });
+// '0xPACKAGE_ID::counter::Counter'
+```
+
+### Resolving type tags
+
+For a local or MVR package, `typeTag` returns the configured name (`@local-pkg/counter::…`). That is
+valid in transaction `typeArguments` — it resolves automatically when the transaction is built — but
+query filters and comparisons against onchain data need a resolved, address-only tag.
+`resolveTypeTag` takes the same options as `typeTag` plus a `client`, resolves any names through it,
+and normalizes the result:
+
+```typescript
+const counterType = await Counter.resolveTypeTag({ client });
+// '0x0000…0123::counter::Counter'
+
+const balanceType = await Balance.resolveTypeTag({
+	client,
+	typeArguments: ['0x2::sui::SUI'],
+});
+// '0x0000…0002::balance::Balance<0x0000…0002::sui::SUI>'
+```
+
 ## Client configuration
 
 ### Using with MVR (Move Version Registry)
@@ -437,5 +501,5 @@ const dAppKit = createDAppKit({
   already configured
 - [Sui Move documentation](https://docs.sui.io/concepts/sui-move-concepts)
 - [BCS documentation](/bcs)
-- [Transaction building](/sui/transaction-building/basics)
+- [Transaction building](/sui/transactions/basics)
 - [dApp Kit](/dapp-kit)

package/dist/dapp-kit/dapp-kit-instance.md

@@ -23,7 +23,7 @@ const GRPC_URLS = {
 
 > **Note:** If you use the React bindings, there are two ways to ensure type safety with hooks:
 > 
-> 1. [Register the global dAppKit type](./getting-started/react#1-create-a-dapp-kit-instance) once, and all hooks will be properly typed
+> 1. [Register the global dAppKit type](./getting-started/react#step-1-create-a-dapp-kit-instance) once, and all hooks will be properly typed
 > 2. Pass the dAppKit instance explicitly to each hook: `useWalletConnection({ dAppKit })`
 
 This instance provides:

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

@@ -7,7 +7,7 @@ built in.
 
 ## Quick start
 
-```sh npm2yarn
+```npm
 npm create @mysten/dapp
 ```
 

package/dist/dapp-kit/getting-started/next-js.md

@@ -7,7 +7,7 @@ rendering (SSR).
 
 ## Installation
 
-```sh npm2yarn
+```npm
 npm i @mysten/dapp-kit-react @mysten/sui
 ```
 

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

@@ -8,7 +8,7 @@ This guide walks you through integrating dApp Kit into a React application.
 
 The fastest way to get started is using our CLI tool:
 
-```sh npm2yarn
+```npm
 npm create @mysten/dapp
 ```
 
@@ -30,7 +30,7 @@ See the [create-dapp guide](/dapp-kit/getting-started/create-dapp) for more deta
 
 ## Manual installation
 
-```sh npm2yarn
+```npm
 npm i @mysten/dapp-kit-react @mysten/sui
 ```
 

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

@@ -7,7 +7,7 @@ direct store access.
 
 ## Installation
 
-```sh npm2yarn
+```npm
 npm i @mysten/dapp-kit-core @mysten/sui @nanostores/vue
 ```
 

package/dist/dapp-kit/index.md

@@ -34,13 +34,13 @@ Choose the installation method based on your framework:
 
 ### For React applications
 
-```sh npm2yarn
+```npm
 npm i @mysten/dapp-kit-react @mysten/sui
 ```
 
 ### Vanilla JavaScript and other frameworks
 
-```sh npm2yarn
+```npm
 npm i @mysten/dapp-kit-core @mysten/sui
 ```
 

package/dist/kiosk/index.md

@@ -7,7 +7,7 @@ data, build transactions to interact, and extend Kiosk to support custom rules.
 
 ## Installation
 
-```sh npm2yarn
+```npm
 npm i @mysten/kiosk
 ```
 

package/dist/kiosk/kiosk-client/kiosk-transaction/managing.md

@@ -4,7 +4,7 @@
 
 The kiosk extension (`client.kiosk`) helps in managing a kiosk.
 
-You need to follow the steps explained in the [Kiosk Transaction section](#kiosk-transaction) to
+You need to follow the steps explained in the [Kiosk Transaction section](./kiosk-transaction) to
 create a `KioskTransaction`.
 
 ## Available functions

package/dist/kiosk/kiosk-client/kiosk-transaction/purchasing.md

@@ -4,8 +4,8 @@
 
 One of the base functionalities of the SDK is a seamless purchasing flow, allowing for ease of rules
 resolving (hiding away the calls). The SDK supports all four rules by default, and works for
-`TESTNET` and `MAINNET`. To support other networks,
-[follow the instructions in the Introduction](../introduction#using-kioskclient-on-devnet-or-localnet).
+`TESTNET` and `MAINNET`. For other networks, see the
+[kiosk extension setup section](../introduction) of the introduction.
 
 ## How to purchase
 

package/dist/llms-index.md

@@ -84,21 +84,18 @@
 ## Sui SDK
 > TypeScript interfaces for Sui
 
-- [Sui TypeScript SDK Quick Start](./sui.md): The Sui TypeScript SDK is a modular library of tools for interacting with the Sui blockchain.
-- [Install Sui TypeScript SDK](./sui/install.md): Install the @mysten/sui package and configure your project.
+- [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.
-- [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 on Devnet, Testnet, or local networks.
 - [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 Programmable Transaction Basics](./sui/transaction-building/basics.md): Construct programmable transaction blocks with the Transaction API.
-- [Paying for Sui Transactions with Gas Coins](./sui/transaction-building/gas.md): Configure gas budget, price, and coin selection for Sui transactions.
-- [Sponsored Transactions](./sui/transaction-building/sponsored-transactions.md): Pay gas fees on behalf of other users with sponsored transactions.
-- [Building Offline](./sui/transaction-building/offline.md): Build transactions without a network connection.
-- [Transaction Intents](./sui/transaction-building/intents.md): Use high-level intents to simplify transaction building.
+- [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
+- [Commands and Inputs Reference](./sui/transactions/reference.md): Complete reference for transaction commands and input types
+- [Building Offline](./sui/transactions/offline.md): Build transactions without a network connection
 - [Key pairs](./sui/cryptography/keypairs.md): Create and manage Ed25519, Secp256k1, and Secp256r1 keypairs for Sui transaction signing.
 - [Multi-Signature Transactions](./sui/cryptography/multisig.md): Create multi-signature transactions with multiple signers on Sui.
 - [Passkey](./sui/cryptography/passkey.md): Use WebAuthn passkeys for Sui transaction signing.

package/dist/sui/bcs.md

@@ -35,7 +35,6 @@ the following pre-defined schemes:
 - `SharedObjectRef`
 - `StructTag`
 - `SuiObjectRef`
-- `Transaction`
 - `TransactionData`
 - `TransactionDataV1`
 - `TransactionExpiration`
@@ -85,12 +84,18 @@ object response, so you typically only need `content`.
 
 ```typescript
 
-// Parse a full object envelope (from objectBcs include option)
-const envelope = bcs.Object.parse(object.objectBcs);
-console.log('Owner:', envelope.owner);
-console.log('Inner struct bytes:', envelope.data.Move.contents);
+// Parse a BCS-encoded object
+const { objects } = await grpcClient.getObjects({
+	objectIds: [objectId],
+	include: { objectBcs: true },
+});
+
+const parsed = bcs.Object.parse(objects[0].objectBcs);
+console.log('Owner:', parsed.owner);
+console.log('Previous Transaction:', parsed.previousTransaction);
+console.log('Storage Rebate:', parsed.storageRebate);
 
-// Serialize a full object envelope
+// Serialize an object
 const serialized = bcs.Object.serialize({
 	data: {
 		Move: {

package/dist/sui/clients/core.md

@@ -178,13 +178,14 @@ The `display` field is `null` when the object's type has no registered Display t
 Get the balance of a specific coin type for an owner.
 
 ```typescript
-const balance = await client.core.getBalance({
+const { balance } = await client.core.getBalance({
 	owner: '0xabc...',
 	coinType: '0x2::sui::SUI', // Optional, defaults to SUI
 });
 
-console.log(balance.totalBalance); // Total balance as bigint
-console.log(balance.coinObjectCount); // Number of coin objects
+console.log(balance.balance); // Total balance (coin objects + address balance)
+console.log(balance.coinBalance); // Balance from coin objects only
+console.log(balance.addressBalance); // Balance from address balance only
 ```
 
 ### `listBalances`
@@ -197,7 +198,7 @@ const { balances } = await client.core.listBalances({
 });
 
 for (const balance of balances) {
-	console.log(balance.coinType, balance.totalBalance);
+	console.log(balance.coinType, balance.balance);
 }
 ```
 
@@ -212,7 +213,7 @@ const result = await client.core.listCoins({
 	limit: 10,
 });
 
-for (const coin of result.coins) {
+for (const coin of result.objects) {
 	console.log(coin.objectId, coin.balance);
 }
 ```
@@ -454,7 +455,7 @@ console.log(referenceGasPrice); // bigint
 Get the current system state including epoch information.
 
 ```typescript
-const systemState = await client.core.getCurrentSystemState();
+const { systemState } = await client.core.getCurrentSystemState();
 console.log(systemState.epoch);
 console.log(systemState.systemStateVersion);
 ```
@@ -478,7 +479,7 @@ Get information about a Move function.
 const { function: fn } = await client.core.getMoveFunction({
 	packageId: '0x2',
 	moduleName: 'coin',
-	name: 'transfer',
+	name: 'value',
 });
 
 console.log(fn.name);
@@ -566,7 +567,7 @@ function processObject(obj: SuiClientTypes.Object<{ content: true }>) {
 async function fetchBalance(
 	client: ClientWithCoreApi,
 	owner: string,
-): Promise<SuiClientTypes.CoinBalance> {
+): Promise<SuiClientTypes.Balance> {
 	const { balance } = await client.core.getBalance({ owner });
 	return balance;
 }
@@ -584,7 +585,7 @@ const options: SuiClientTypes.GetObjectOptions<{ content: true }> = {
 | ---------------------- | ------------------------------------------- |
 | `Object<Include>`      | Fetched object with optional included data  |
 | `Coin`                 | Coin object with balance                    |
-| `CoinBalance`          | Balance summary for a coin type             |
+| `Balance`              | Balance summary for a coin type             |
 | `CoinMetadata`         | Metadata for a coin type                    |
 | `Transaction<Include>` | Executed transaction with optional data     |
 | `TransactionResult`    | Success or failure result from execution    |

package/dist/sui/clients/grpc.md

@@ -179,7 +179,7 @@ const { response: fields } = await grpcClient.stateService.listDynamicFields({
 const { response } = await grpcClient.movePackageService.getFunction({
 	packageId: '0x2',
 	moduleName: 'coin',
-	name: 'transfer',
+	name: 'value',
 });
 ```
 

package/dist/sui/index.md

@@ -1,22 +1,55 @@
-# Sui TypeScript SDK Quick Start
+# Sui TypeScript SDK
 
-> The Sui TypeScript SDK is a modular library of tools for interacting with the Sui blockchain.
+> TypeScript SDK for building on the Sui blockchain
 
 The Sui TypeScript SDK is a modular library of tools for interacting with the Sui blockchain. Use it
 to send queries to RPC nodes, build and sign transactions, and interact with a Sui or local network.
 
 ## Installation
 
-```sh npm2yarn
+```npm
 npm i @mysten/sui
 ```
 
+The SDK is published as an ESM only package. Make sure your `package.json` includes
+`"type": "module"`:
+
+```json
+{
+	"type": "module"
+}
+```
+
+If you are using TypeScript, your `tsconfig.json` should use a compatible `moduleResolution` setting
+such as `"NodeNext"`, `"Node16"`, or `"Bundler"`.
+
+## Module packages
+
+The SDK contains a set of modular packages that you can use independently or together. Import just
+what you need to keep your code light and compact.
+
+- [`@mysten/sui/client`](/sui/clients): A client for interacting with Sui RPC nodes.
+- [`@mysten/sui/bcs`](/sui/bcs): A BCS builder with pre-defined types for Sui.
+- [`@mysten/sui/transactions`](/sui/transactions/basics): Utilities for building and interacting
+  with transactions.
+- [`@mysten/sui/keypairs/*`](/sui/cryptography/keypairs): Modular exports for specific KeyPair
+  implementations.
+- [`@mysten/sui/verify`](/sui/cryptography/keypairs#verifying-signatures-without-a-key-pair):
+  Methods for verifying transactions and messages.
+- [`@mysten/sui/cryptography`](/sui/cryptography/keypairs): Shared types and classes for
+  cryptography.
+- [`@mysten/sui/multisig`](/sui/cryptography/multisig): Utilities for working with multisig
+  signatures.
+- [`@mysten/sui/utils`](/sui/utils): Utilities for formatting and parsing various Sui types.
+- [`@mysten/sui/faucet`](#faucet): Methods for requesting SUI from a faucet.
+- [`@mysten/sui/zklogin`](/sui/zklogin): Utilities for working with zkLogin.
+
 ## Network locations
 
 The following table lists the locations for Sui networks.
 
 | Network | Full node                             | faucet                                   |
-| :------ | :------------------------------------ | :--------------------------------------- |
+| ------- | ------------------------------------- | ---------------------------------------- |
 | local   | `http://127.0.0.1:9000` (default)     | `http://127.0.0.1:9123/v2/gas` (default) |
 | Devnet  | `https://fullnode.devnet.sui.io:443`  | `https://faucet.devnet.sui.io/v2/gas`    |
 | Testnet | `https://fullnode.testnet.sui.io:443` | `https://faucet.testnet.sui.io/v2/gas`   |
@@ -31,23 +64,144 @@ The following table lists the locations for Sui networks.
 > (preferred for apps that have high traffic). You can find a list of reliable RPC endpoint providers
 > for Sui on the [Sui Dev Portal](https://sui.io/developers#dev-tools) using the **Node Service** tab.
 
-## Module packages
+## Quick start
 
-The SDK contains a set of modular packages that you can use independently or together. Import just
-what you need to keep your code light and compact.
+Get started in a few minutes. This guide walks you through creating a keypair, funding it from a
+faucet, and checking your balance.
 
-- [`@mysten/sui/client`](/sui/clients): A client for interacting with Sui RPC nodes.
-- [`@mysten/sui/bcs`](/sui/bcs): A BCS builder with pre-defined types for Sui.
-- [`@mysten/sui/transactions`](/sui/transaction-building/basics): Utilities for building and
-  interacting with transactions.
-- [`@mysten/sui/keypairs/*`](/sui/cryptography/keypairs): Modular exports for specific KeyPair
-  implementations.
-- [`@mysten/sui/verify`](/sui/cryptography/keypairs#verifying-signatures-without-a-key-pair):
-  Methods for verifying transactions and messages.
-- [`@mysten/sui/cryptography`](/sui/cryptography/keypairs): Shared types and classes for
-  cryptography.
-- [`@mysten/sui/multisig`](/sui/cryptography/multisig): Utilities for working with multisig
-  signatures.
-- [`@mysten/sui/utils`](/sui/utils): Utilities for formatting and parsing various Sui types.
-- [`@mysten/sui/faucet`](/sui/faucet): Methods for requesting SUI from a faucet.
-- [`@mysten/sui/zklogin`](/sui/zklogin): Utilities for working with zkLogin.
+### Create a project
+
+```sh
+mkdir hello-sui
+cd hello-sui
+npm init -y
+npm pkg set type=module
+npm i @mysten/sui
+```
+
+### Step 1: Create a keypair and get SUI
+
+Create a `setup.ts` file that generates a new keypair, requests SUI from the faucet, and prints your
+secret key for later use:
+
+```typescript
+
+// Generate a new keypair
+const keypair = new Ed25519Keypair();
+
+console.log('Address:', keypair.toSuiAddress());
+console.log('Secret key:', keypair.getSecretKey());
+
+// Request SUI from the devnet faucet
+await requestSuiFromFaucetV2({
+	host: getFaucetHost('devnet'),
+	recipient: keypair.toSuiAddress(),
+});
+
+console.log('Faucet request sent! Save the secret key above for the next step.');
+```
+
+Run it:
+
+```sh
+node setup.ts
+```
+
+Save the secret key that gets printed; you'll use it in the next step.
+
+> **Warning:** Logging secret keys to the console is only appropriate for quick demos like this. In real
+> applications, never log or expose secret keys. Store them securely using environment variables,
+> encrypted keystores, or a secrets manager.
+
+### Step 2: Check your balance
+
+Create a `balance.ts` file that imports your keypair from the secret key and checks the balance:
+
+```typescript
+
+// Import the keypair using the secret key from step 1
+const keypair = Ed25519Keypair.fromSecretKey('suiprivkey1...'); // paste your secret key here
+
+const grpcClient = new SuiGrpcClient({
+	network: 'devnet',
+	baseUrl: 'https://fullnode.devnet.sui.io:443',
+});
+
+const { balance } = await grpcClient.core.getBalance({
+	owner: keypair.toSuiAddress(),
+});
+
+const sui = Number(balance.balance) / Number(MIST_PER_SUI);
+console.log(`Address: ${keypair.toSuiAddress()}`);
+console.log(`Balance: ${sui} SUI`);
+```
+
+Run it:
+
+```sh
+node balance.ts
+```
+
+### Step 3: Transfer SUI
+
+Create a `transfer.ts` file that sends SUI to another address and logs the transaction effects:
+
+```typescript
+
+const keypair = Ed25519Keypair.fromSecretKey('suiprivkey1...'); // paste your secret key here
+const grpcClient = new SuiGrpcClient({
+	network: 'devnet',
+	baseUrl: 'https://fullnode.devnet.sui.io:443',
+});
+
+const tx = new Transaction();
+
+tx.transferObjects(
+	[coinWithBalance({ balance: BigInt(0.1 * Number(MIST_PER_SUI)) })],
+	'0xRecipientAddress', // replace with the recipient's address
+);
+
+const result = await keypair.signAndExecuteTransaction({
+	transaction: tx,
+	client: grpcClient,
+	include: { effects: true, balanceChanges: true },
+});
+
+if (result.$kind === 'FailedTransaction') {
+	console.error('Transaction failed:', result.FailedTransaction.status.error?.message);
+} else {
+	console.log('Transaction digest:', result.Transaction.digest);
+	console.log('Effects:', JSON.stringify(result.Transaction.effects, null, 2));
+	console.log('Balance changes:', JSON.stringify(result.Transaction.balanceChanges, null, 2));
+}
+```
+
+Run it:
+
+```sh
+node transfer.ts
+```
+
+### Faucet
+
+Devnet, Testnet, and local networks include faucets that mint SUI. Use `requestSuiFromFaucetV2` to
+request SUI programmatically:
+
+```typescript
+
+await requestSuiFromFaucetV2({
+	host: getFaucetHost('testnet'),
+	recipient: '0xYourAddress',
+});
+```
+
+> **Note:** Faucets on Devnet and Testnet are rate limited. If you hit the limit, wait before trying again.
+> For Testnet, you can also get SUI through the web UI at `faucet.sui.io` or through the [Sui
+> Discord](https://discord.gg/sui) faucet channels.
+
+## Next steps
+
+- [Building Transactions](/sui/transactions/basics): create and compose transactions
+- [Signing and Execution](/sui/transactions/signing-and-execution): sign and submit transactions
+- [Coins and Balances](/sui/transactions/coins-and-balances): work with tokens
+- [Client Setup](/sui/clients): configure clients for different networks

package/dist/sui/llms-index.md

@@ -1,21 +1,18 @@
 # Sui SDK
 > TypeScript interfaces for Sui
 
-- [Sui TypeScript SDK Quick Start](..md): The Sui TypeScript SDK is a modular library of tools for interacting with the Sui blockchain.
-- [Install Sui TypeScript SDK](./install.md): Install the @mysten/sui package and configure your project.
+- [Sui TypeScript SDK](..md): TypeScript SDK for building on the Sui blockchain
 - [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 on Devnet, Testnet, or local networks.
 - [Sui Clients](./clients.md): Choose and configure gRPC, GraphQL, or JSON-RPC clients for the Sui network.
 - [Core API](./clients/core.md): Transport-agnostic Core API shared by all Sui clients.
 - [SuiGrpcClient](./clients/grpc.md): Connect to Sui through gRPC with SuiGrpcClient.
 - [SuiGraphQLClient](./clients/graphql.md): Connect to Sui through GraphQL with SuiGraphQLClient.
 - [SuiJsonRpcClient](./clients/json-rpc.md): Connect to Sui through JSON-RPC with SuiJsonRpcClient.
-- [Sui Programmable Transaction Basics](./transaction-building/basics.md): Construct programmable transaction blocks with the Transaction API.
-- [Paying for Sui Transactions with Gas Coins](./transaction-building/gas.md): Configure gas budget, price, and coin selection for Sui transactions.
-- [Sponsored Transactions](./transaction-building/sponsored-transactions.md): Pay gas fees on behalf of other users with sponsored transactions.
-- [Building Offline](./transaction-building/offline.md): Build transactions without a network connection.
-- [Transaction Intents](./transaction-building/intents.md): Use high-level intents to simplify transaction building.
+- [Building Transactions](./transactions/basics.md): Construct programmable transaction blocks with the Transaction API
+- [Signing and Execution](./transactions/signing-and-execution.md): Sign transactions and execute them on the Sui network
+- [Coins and Balances](./transactions/coins-and-balances.md): Work with coin objects and address balances in transactions
+- [Commands and Inputs Reference](./transactions/reference.md): Complete reference for transaction commands and input types
+- [Building Offline](./transactions/offline.md): Build transactions without a network connection
 - [Key pairs](./cryptography/keypairs.md): Create and manage Ed25519, Secp256k1, and Secp256r1 keypairs for Sui transaction signing.
 - [Multi-Signature Transactions](./cryptography/multisig.md): Create multi-signature transactions with multiple signers on Sui.
 - [Passkey](./cryptography/passkey.md): Use WebAuthn passkeys for Sui transaction signing.

package/dist/sui/migrations/0.38.md

@@ -13,7 +13,7 @@ earlier version of the SDK, there are some changes you should consider when upda
 
 The Sui TypeScript SDK is now divided into modular components. Before version 0.38.0, you imported
 the complete SDK module. Now, you upload the individual packages of the SDK module instead. See the
-[Module Packages section](#module-packages) for the list of packages.
+[Module Structure section](#module-structure) for the list of packages.
 
 ### Deprecated classes
 
@@ -40,7 +40,7 @@ The Sui TypeScript SDK deprecates the following classes with version 0.38.0:
 
 Signing and sending transactions changes slightly with the deprecation of the `Signer` pattern. For
 an example of transaction signing, see the
-[Sui Programmable Transaction Blocks Basics](/sui/transaction-building/basics) topic.
+[Sui Programmable Transaction Block Basics](/sui/transactions/basics) topic.
 
 ### Faucet requests
 

package/dist/sui/migrations/sui-1.0.md

@@ -11,7 +11,7 @@ highlights:
 
 - [A new GraphQL Client for the newly released Sui GraphQL API](/sui/clients/graphql)
 - [New Transaction Executor classes for efficient Transaction execution](../executors)
-- [New Transaction Intents to simplify common transaction patterns](../transaction-building/intents)
+- [New Transaction Intents to simplify common transaction patterns](../transactions/coins-and-balances)
 - [A new Plugin system for Extending Transaction Building](../plugins)
 
 The majority of changes in this release are in the `@mysten/sui` package, but the changes to API
@@ -24,7 +24,7 @@ As part of the 1.0 release the `@mysten/sui.js` package has been renamed to `@my
 
 To upgrade to the new version, uninstall the old package and install the new one:
 
-```sh npm2yarn
+```npm
 npm uninstall @mysten/sui.js
 npm install @mysten/sui
 ```