@mysten/dapp-kit-react 2.0.1 → 2.0.3

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import * as _mysten_dapp_kit_core0 from "@mysten/dapp-kit-core";
+import * as _mysten_dapp_kit_core4 from "@mysten/dapp-kit-core";
 import { DAppKit, DefaultExpectedDppKit, RegisteredDAppKit } from "@mysten/dapp-kit-core";
 import * as react0 from "react";
 import { PropsWithChildren } from "react";
@@ -7,7 +7,7 @@ import * as nanostores0 from "nanostores";
 export * from "@mysten/dapp-kit-core";
 
 //#region src/components/DAppKitProvider.d.ts
-declare const DAppKitContext: react0.Context<_mysten_dapp_kit_core0.DAppKit<any, _mysten_dapp_kit_core0.ClientWithCoreApi> | null>;
+declare const DAppKitContext: react0.Context<_mysten_dapp_kit_core4.DAppKit<any, _mysten_dapp_kit_core4.ClientWithCoreApi> | null>;
 type DAppKitProviderProps = PropsWithChildren<{
   dAppKit: DefaultExpectedDppKit;
 }>;
@@ -25,7 +25,7 @@ type UseWalletsOptions<TDAppKit extends DAppKit> = {
 };
 declare function useWallets<TDAppKit extends DAppKit<any> = RegisteredDAppKit>({
   dAppKit
-}?: UseWalletsOptions<TDAppKit>): _mysten_dapp_kit_core0.UiWallet[];
+}?: UseWalletsOptions<TDAppKit>): _mysten_dapp_kit_core4.UiWallet[];
 //#endregion
 //#region src/hooks/useWalletConnection.d.ts
 type UseWalletConnectionOptions<TDAppKit extends DAppKit<any>> = {
@@ -43,8 +43,8 @@ declare function useWalletConnection<TDAppKit extends DAppKit = RegisteredDAppKi
   readonly isReconnecting: false;
   readonly isDisconnected: true;
 } | {
-  readonly wallet: _mysten_dapp_kit_core0.UiWallet;
-  readonly account: _mysten_dapp_kit_core0.UiWalletAccount;
+  readonly wallet: _mysten_dapp_kit_core4.UiWallet;
+  readonly account: _mysten_dapp_kit_core4.UiWalletAccount;
   readonly status: "connected";
   readonly supportedIntents: string[];
   readonly isConnected: true;
@@ -61,8 +61,8 @@ declare function useWalletConnection<TDAppKit extends DAppKit = RegisteredDAppKi
   readonly isReconnecting: false;
   readonly isDisconnected: false;
 } | {
-  readonly wallet: _mysten_dapp_kit_core0.UiWallet;
-  readonly account: _mysten_dapp_kit_core0.UiWalletAccount;
+  readonly wallet: _mysten_dapp_kit_core4.UiWallet;
+  readonly account: _mysten_dapp_kit_core4.UiWalletAccount;
   readonly status: "reconnecting";
   readonly supportedIntents: string[];
   readonly isConnected: false;
@@ -77,7 +77,7 @@ type UseCurrentAccountOptions<TDAppKit extends DAppKit> = {
 };
 declare function useCurrentAccount<TDAppKit extends DAppKit<any> = RegisteredDAppKit>({
   dAppKit
-}?: UseCurrentAccountOptions<TDAppKit>): _mysten_dapp_kit_core0.UiWalletAccount | null;
+}?: UseCurrentAccountOptions<TDAppKit>): _mysten_dapp_kit_core4.UiWalletAccount | null;
 //#endregion
 //#region src/hooks/useCurrentWallet.d.ts
 type UseCurrentWalletOptions<TDAppKit extends DAppKit> = {
@@ -85,7 +85,7 @@ type UseCurrentWalletOptions<TDAppKit extends DAppKit> = {
 };
 declare function useCurrentWallet<TDAppKit extends DAppKit<any> = RegisteredDAppKit>({
   dAppKit
-}?: UseCurrentWalletOptions<TDAppKit>): _mysten_dapp_kit_core0.UiWallet | null;
+}?: UseCurrentWalletOptions<TDAppKit>): _mysten_dapp_kit_core4.UiWallet | null;
 //#endregion
 //#region src/hooks/useCurrentClient.d.ts
 type UseCurrentClientOptions<TDAppKit extends DAppKit<any>> = {

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/components/DAppKitProvider.tsx","../src/hooks/useDAppKit.ts","../src/hooks/useWallets.ts","../src/hooks/useWalletConnection.ts","../src/hooks/useCurrentAccount.ts","../src/hooks/useCurrentWallet.ts","../src/hooks/useCurrentClient.ts","../src/hooks/useCurrentNetwork.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAOa,gBAAc,MAAA,CAAA,QAAA,sBAAA,CAAA,aAAoD,sBAAA,CAApD,iBAAA;KAEf,oBAAA,GAAuB;WACzB;;iBAGM,eAAA;;;GAAuC,uBAAoB,kBAAA,CAAA,GAAA,CAAA;;;iBCN3D,4BAA4B,eAAe,6BAA6B,WAAQ;;;KCApF,mCAAmC;YACpC;;iBAGK,4BAA4B,eAAe;;IAExD,kBAAkB,YAAD,sBAAA,CAAe,QAAA;;;KCNvB,4CAA4C;YAC7C;;iBAGK,qCAAqC,UAAU;;IAE5D,2BAA2B;;;;;;EHNjB,SAAA,YAAkE,EAAA,KAAA;EAAA,SAAA,cAApD,EAAA,KAAA;EAAA,SAAA,cAAA,EAAA,IAAA;CAAA,GAAA;EAAA,SAAA,MAAA,EGME,sBAAA,CAAA,QHNF;EAEf,SAAA,OAAA,wCAAuB;EAInB,SAAA,MAAA,EAAA,WAAe;EAAG,SAAA,gBAAA,EAAA,MAAA,EAAA;EAAS,SAAA,WAAA,EAAA,IAAA;EAAY,SAAA,YAAA,EAAA,KAAA;EAAoB,SAAA,cAAA,EAAA,KAAA;EAAA,SAAA,cAAA,EAAA,KAAA;;;;ECN3D,SAAA,MAAU,EAAA,YAAA;EAAkB,SAAA,gBAAA,EAAA,SAAA,EAAA;EAAe,SAAA,WAAA,EAAA,KAAA;EAA6B,SAAA,YAAA,EAAA,IAAA;EAAQ,SAAA,cAAA,EAAA,KAAA;EAAA,SAAA,cAAA,EAAA,KAAA;;;;ECApF,SAAA,MAAA,EAAA,cAAiB;EAIb,SAAA,gBAAU,EAAA,MAAA,EAAA;EAAkB,SAAA,WAAA,EAAA,KAAA;EAAe,SAAA,YAAA,EAAA,KAAA;EAC1D,SAAA,cAAA,EAAA,IAAA;EACoB,SAAA,cAAA,EAAA,KAAA;CAAlB;;;KEPS,0CAA0C;YAC3C;;iBAGK,mCAAmC,eAAe;;IAE/D,yBAAyB,YAAD,sBAAA,CAAe,eAAA;;;KCN9B,yCAAyC;YAC1C;;iBAGK,kCAAkC,eAAe;;IAE9D,wBAAwB,YAAD,sBAAA,CAAe,QAAA;;;KCL7B,yCAAyC;YAC1C;;iBAGK,kCAAkC,eAAe;;IAE9D,wBAAwB,YAEyB,WAAW;;;KCRnD,0CAA0C;YAC3C;;iBAGK,mCAAmC,eAAe;;IAE/D,yBAAyB,YAAc,WAAA,CAAA,WAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/components/DAppKitProvider.tsx","../src/hooks/useDAppKit.ts","../src/hooks/useWallets.ts","../src/hooks/useWalletConnection.ts","../src/hooks/useCurrentAccount.ts","../src/hooks/useCurrentWallet.ts","../src/hooks/useCurrentClient.ts","../src/hooks/useCurrentNetwork.ts"],"mappings":";;;;;;;;;cAOa,cAAA,EAAc,MAAA,CAAA,OAAA,CAAA,sBAAA,CAAA,OAAA,MAAoD,sBAAA,CAApD,iBAAA;AAAA,KAEf,oBAAA,GAAuB,iBAAA;EAClC,OAAA,EAAS,qBAAA;AAAA;AAAA,iBAGM,eAAA,CAAA;EAAkB,OAAA;EAAS;AAAA,GAAY,oBAAA,GAAoB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;iBCN3D,UAAA,kBAA4B,OAAA,QAAe,iBAAA,CAAA,CAAmB,OAAA,GAAU,QAAA,GAAQ,QAAA;;;KCApF,iBAAA,kBAAmC,OAAA;EAC9C,OAAA,GAAU,QAAA;AAAA;AAAA,iBAGK,UAAA,kBAA4B,OAAA,QAAe,iBAAA,CAAA,CAAA;EAC1D;AAAA,IACE,iBAAA,CAAkB,QAAA,IAAD,sBAAA,CAAe,QAAA;;;KCNvB,0BAAA,kBAA4C,OAAA;EACvD,OAAA,GAAU,QAAA;AAAA;AAAA,iBAGK,mBAAA,kBAAqC,OAAA,GAAU,iBAAA,CAAA,CAAA;EAC9D;AAAA,IACE,0BAAA,CAA2B,QAAA;EAAA;;;;;;;;;mBAAD,sBAAA,CAAA,QAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;KCPjB,wBAAA,kBAA0C,OAAA;EACrD,OAAA,GAAU,QAAA;AAAA;AAAA,iBAGK,iBAAA,kBAAmC,OAAA,QAAe,iBAAA,CAAA,CAAA;EACjE;AAAA,IACE,wBAAA,CAAyB,QAAA,IAAD,sBAAA,CAAe,eAAA;;;KCN9B,uBAAA,kBAAyC,OAAA;EACpD,OAAA,GAAU,QAAA;AAAA;AAAA,iBAGK,gBAAA,kBAAkC,OAAA,QAAe,iBAAA,CAAA,CAAA;EAChE;AAAA,IACE,uBAAA,CAAwB,QAAA,IAAD,sBAAA,CAAe,QAAA;;;KCL7B,uBAAA,kBAAyC,OAAA;EACpD,OAAA,GAAU,QAAA;AAAA;AAAA,iBAGK,gBAAA,kBAAkC,OAAA,QAAe,iBAAA,CAAA,CAAA;EAChE;AAAA,IACE,uBAAA,CAAwB,QAAA,IAEyB,UAAA,CAAW,QAAA;;;KCRnD,wBAAA,kBAA0C,OAAA;EACrD,OAAA,GAAU,QAAA;AAAA;AAAA,iBAGK,iBAAA,kBAAmC,OAAA,QAAe,iBAAA,CAAA,CAAA;EACjE;AAAA,IACE,wBAAA,CAAyB,QAAA,IAAc,WAAA,CAAA,UAAA,CAAA,QAAA"}

package/dist/ui.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.mts","names":[],"sources":["../src/components/ConnectButton.tsx","../src/components/ConnectModal.tsx"],"sourcesContent":[],"mappings":";;;;;;KASY,kBAAA,GAAqB,sBAAsB;cAEjD,wBAAsB,WAAA,CAAA,kBAAA;iBAMZ,aAAA;;;GAAsC,qBAAkB,kBAAA,CAAA,GAAA,CAAA;;;KCR5D,iBAAA,GAAoB,sBAAsB;cAEhD,uBAAqB,WAAA,CAAA,kBAAA;iBAMX,YAAA;;;GAAqC,oBAAiB,kBAAA,CAAA,GAAA,CAAA"}
+{"version":3,"file":"ui.d.mts","names":[],"sources":["../src/components/ConnectButton.tsx","../src/components/ConnectModal.tsx"],"mappings":";;;;;;KASY,kBAAA,GAAqB,cAAA,QAAsB,sBAAA;AAAA,cAEjD,sBAAA,EAAsB,WAAA,CAAA,iBAAA,CAAA,oBAAA;AAAA,iBAMZ,aAAA,CAAA;EAAgB,QAAA;EAAA,GAAa;AAAA,GAAS,kBAAA,GAAkB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;KCR5D,iBAAA,GAAoB,cAAA,QAAsB,qBAAA;AAAA,cAEhD,qBAAA,EAAqB,WAAA,CAAA,iBAAA,CAAA,mBAAA;AAAA,iBAMX,YAAA,CAAA;EAAe,QAAA;EAAA,GAAa;AAAA,GAAS,iBAAA,GAAiB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/docs/actions/connect-wallet.md

@@ -1,6 +1,6 @@
 # Connect Wallet
 
-> Programmatically connect to a Sui wallet
+> Programmatically connect to a Sui wallet using the dApp Kit connectWallet action.
 
 The dApp Kit SDK provides an action for wallet connection, allowing users to connect, disconnect,
 and switch between wallets and accounts.
@@ -17,6 +17,7 @@ and switch between wallets and accounts.
 The `connectWallet` action prompts a wallet to connect and authorize accounts for your application:
 
 ```typescript
+
 const dAppKit = createDAppKit({
 	/* config */
 });
@@ -32,15 +33,15 @@ console.log('Connected accounts:', result.accounts);
 
 ## Parameters
 
-- **`wallet`** - The `UiWallet` instance to connect to
+- **`wallet`:** The `UiWallet` instance to connect to
 - **`account`** (optional) - A specific `UiWalletAccount` to set as the selected account. Defaults
   to the first authorized account
 
-## Return Value
+## Return value
 
 Returns a `Promise` that resolves to an object containing:
 
-- **`accounts`** - Array of authorized `UiWalletAccount` instances
+- **`accounts`:** Array of authorized `UiWalletAccount` instances
 
 ## Example
 
@@ -65,4 +66,4 @@ if (wallets.length > 0) {
 		console.error('Connection failed:', error);
 	}
 }
-```
+```

package/docs/actions/disconnect-wallet.md

@@ -1,6 +1,6 @@
 # Disconnect Wallet
 
-> Programmatically disconnect from a Sui wallet
+> Programmatically disconnect from a Sui wallet using the dApp Kit disconnectWallet action.
 
 The `disconnectWallet` action terminates the connection with the currently connected wallet.
 
@@ -9,15 +9,16 @@ The `disconnectWallet` action terminates the connection with the currently conne
 
 ## Usage
 
-> **Note:** The disconnect action clears the connection state locally and attempts to notify the
-> wallet. Even if the wallet notification fails, the local state is always cleared to ensure a clean
+> **Note:** The disconnect action clears the connection state locally and attempts to notify the wallet. Even
+> if the wallet notification fails, the local state is always cleared to ensure a clean
 > disconnection.
->
-> Note that wallets may or may not implement the `disconnect` feature. Calling `disconnectWallet`
-> doesn't necessarily mean that the wallet accounts will be disconnected from the dApp within the
-> wallet itself - this is determined by each wallet's implementation.
+> 
+> Wallets might or might not implement the `disconnect` feature. Calling `disconnectWallet`
+> does not necessarily mean that the wallet accounts are disconnected from the app within the
+> wallet itself. This is determined by each wallet's implementation.
 
 ```typescript
+
 const dAppKit = createDAppKit({
 	/* config */
 });
@@ -29,9 +30,10 @@ await dAppKit.disconnectWallet();
 
 None.
 
-## Return Value
+## Return value
 
 Returns a `Promise` that resolves to `void` when the disconnection is complete.
 
-> The action may throw `WalletNotConnectedError` if no wallet is connected. However, wallet-specific
-> disconnect failures are logged but don't prevent the local connection state from being cleared.
+> The action might throw `WalletNotConnectedError` if no wallet is connected. However,
+> wallet-specific disconnect failures are logged but don't prevent the local connection state from
+> being cleared.

package/docs/actions/sign-and-execute-transaction.md

@@ -1,13 +1,14 @@
 # Sign and Execute Transaction
 
-> Sign and execute a transaction using the connected wallet
+> Sign and execute a transaction on the Sui network using the connected wallet.
 
 The `signAndExecuteTransaction` action prompts the connected wallet to sign and immediately execute
-a transaction on the Sui network. This is the most common way to execute transactions in your dApp.
+a transaction on the Sui network. This is the most common way to execute transactions in your app.
 
 ## Usage
 
 ```typescript
+
 const dAppKit = createDAppKit({
 	/* config */
 });
@@ -29,11 +30,11 @@ console.log('Transaction digest:', result.Transaction.digest);
 
 ## Parameters
 
-- **`transaction`** - `Transaction | string` - The transaction to sign and execute. Can be either a
+- **`transaction`:** `Transaction | string`: The transaction to sign and execute. Can be either a
   Transaction instance or base64-encoded bcs bytes for the transaction.
-- **`signal`** (optional) - `AbortSignal` - An abort signal to cancel the transaction request.
+- **`signal`** (optional): `AbortSignal`: An abort signal to cancel the transaction request.
 
-## Return Value
+## Return value
 
 Returns a `Promise` that resolves to a `TransactionResult` discriminated union:
 
@@ -45,14 +46,14 @@ type TransactionResult =
 
 The `Transaction` object contains:
 
-- **`digest`** - `string` - The transaction digest (unique identifier for the executed transaction)
-- **`signatures`** - `string[]` - The signatures as base64-encoded strings
-- **`epoch`** - `string | null` - The epoch in which the transaction was executed
-- **`status`** - `ExecutionStatus` - The execution status with `success: boolean` and
+- **`digest`:** `string`: The transaction digest (unique identifier for the executed transaction)
+- **`signatures`:** `string[]`: The signatures as base64-encoded strings
+- **`epoch`:** `string | null`: The epoch in which the transaction was executed
+- **`status`:** `ExecutionStatus`: The execution status with `success: boolean` and
   `error: string | null`
-- **`effects`** - `TransactionEffects | null` - The parsed transaction effects (may be `null` if
+- **`effects`:** `TransactionEffects | null`: The parsed transaction effects (may be `null` if
   effects parsing fails for unknown effect versions)
-- **`transaction`** - `TransactionData` - The parsed transaction data
+- **`transaction`:** `TransactionData`: The parsed transaction data
 
 ```typescript
 const result = await dAppKit.signAndExecuteTransaction({ transaction });
@@ -69,7 +70,7 @@ console.log('Signatures:', tx.signatures);
 console.log('Epoch:', tx.epoch);
 ```
 
-## Transaction Building
+## Transaction building
 
 When passing a Transaction instance, the action automatically:
 
@@ -78,12 +79,12 @@ When passing a Transaction instance, the action automatically:
 3. Converts it to the appropriate format for the wallet
 4. Submits the transaction to the network
 
-## Wallet Compatibility
+## Wallet compatibility
 
 - The action transparently handles both `sui:signAndExecuteTransaction` and
   `sui:signAndExecuteTransactionBlock` wallet-standard features
 - The wallet handles network submission and response
-- Some wallets (Enoki, Enoki Connect, WalletConnect) may use the dApp Kit client and execute
+- Some wallets (Enoki, Enoki Connect, and WalletConnect) might use the dApp Kit client and execute
   transactions within the application as an implementation detail
 
 ```typescript
@@ -92,4 +93,4 @@ When passing a Transaction instance, the action automatically:
 const result = await dAppKit.signAndExecuteTransaction({
 	transaction: tx,
 });
-```
+```

package/docs/actions/sign-personal-message.md

@@ -1,6 +1,6 @@
 # Sign Personal Message
 
-> Sign an arbitrary message with the connected wallet
+> Sign an arbitrary message with the connected wallet for authentication or proof of ownership.
 
 The `signPersonalMessage` action prompts the connected wallet to sign a personal message. This is
 useful for authentication, proof of ownership, or other scenarios where you need cryptographic proof
@@ -9,6 +9,7 @@ that a user controls a specific account.
 ## Usage
 
 ```typescript
+
 const dAppKit = createDAppKit({
 	/* config */
 });
@@ -24,16 +25,16 @@ console.log('Signature:', result.signature);
 
 ## Parameters
 
-- **`message`** - `Uint8Array` - The message to sign as a byte array
+- **`message`:** `Uint8Array` - The message to sign as a byte array
 
-## Return Value
+## Return value
 
 Returns a `Promise` that resolves to an object containing:
 
-- **`bytes`** - `string` - Base64 encoded message bytes
-- **`signature`** - `string` - Base64 encoded signature
+- **`bytes`:** `string` - Base64 encoded message bytes
+- **`signature`:** `string` - Base64 encoded signature
 
-## Message Format
+## Message format
 
 The message parameter must be a `Uint8Array`. Common patterns for creating byte arrays:
 
@@ -47,11 +48,11 @@ const jsonMessage = new TextEncoder().encode(
 await dAppKit.signPersonalMessage({ message: jsonMessage });
 ```
 
-## Security Considerations
+## Security considerations
 
-### Message Content
+### Message content
 
 - Always display the message content clearly to users before signing
 - Avoid signing opaque or encoded data that users cannot understand
 - Include human-readable prefixes for different message types
-- Consider adding timestamps to prevent replay attacks
+- Consider adding timestamps to prevent replay attacks

package/docs/actions/sign-transaction.md

@@ -1,6 +1,6 @@
 # Sign Transaction
 
-> Sign a transaction without executing it
+> Sign a Sui transaction without executing it for deferred or multi-signature scenarios.
 
 The `signTransaction` action prompts the connected wallet to sign a transaction without executing
 it. This is useful when you need a signed transaction for later execution or for multi-signature
@@ -9,6 +9,7 @@ scenarios.
 ## Usage
 
 ```typescript
+
 const dAppKit = createDAppKit({
 	/* config */
 });
@@ -25,16 +26,16 @@ const { bytes, signature } = await dAppKit.signTransaction({
 
 ## Parameters
 
-- **`transaction`** - `Transaction | string` - The transaction to sign. Can be either a Transaction
+- **`transaction`:** `Transaction | string` - The transaction to sign. Can be either a Transaction
   instance or base64-encoded bcs bytes for the transaction.
 - **`signal`** (optional) - `AbortSignal` - An abort signal to cancel the signing request.
 
-## Return Value
+## Return value
 
 Returns a `Promise` that resolves to an object containing:
 
-- **`bytes`** - `string` - The signed transaction as a base64-encoded BCS string
-- **`signature`** - `string` - The signature as a base64-encoded string
+- **`bytes`:** `string` - The signed transaction as a base64-encoded BCS string
+- **`signature`:** `string` - The signature as a base64-encoded string
 
 ```typescript
 const result = await dAppKit.signTransaction({ transaction });
@@ -42,7 +43,7 @@ console.log('Signed transaction bytes:', result.bytes);
 console.log('Signature:', result.signature);
 ```
 
-## Transaction Building
+## Transaction building
 
 When passing a Transaction instance, the action automatically:
 
@@ -50,7 +51,7 @@ When passing a Transaction instance, the action automatically:
 2. Builds the transaction using the current network's client
 3. Converts it to the appropriate format for the wallet
 
-## Wallet Compatibility
+## Wallet compatibility
 
 - The action transparently handles both `sui:signTransaction` and `sui:signTransactionBlock`
   wallet-standard features
@@ -61,4 +62,4 @@ When passing a Transaction instance, the action automatically:
 const result = await dAppKit.signTransaction({
 	transaction: tx,
 });
-```
+```

package/docs/actions/switch-account.md

@@ -1,13 +1,13 @@
 # Switch Account
 
-> Switch the active account in the connected wallet
+> Switch the active account in the connected wallet using the dApp Kit switchAccount action.
 
 The `switchAccount` action changes the currently selected account to a different account from the
 connected wallet.
 
-> **Note:** The "current account" is a dApp Kit concept that tracks which account is active within
-> your application. Changing the active account in the dApp does not affect the wallet itself, and
-> wallets are not notified when the active account changes.
+> **Note:** The current account is a dApp Kit concept that tracks which account is active within your
+> application. Changing the active account in the app does not affect the wallet itself, and wallets
+> are not notified when the active account changes.
 
 > Account switching is integrated into the [Connect Button](../web-components/connect-button) Web
 > Component. When a wallet is connected with multiple accounts, the button provides an account
@@ -16,6 +16,7 @@ connected wallet.
 ## Usage
 
 ```typescript
+
 const dAppKit = createDAppKit({
 	/* config */
 });
@@ -28,9 +29,9 @@ dAppKit.switchAccount({
 
 ## Parameters
 
-- **`account`** - `UiWalletAccount` - The account to switch to. Must be an account that belongs to
+- **`account`:** `UiWalletAccount` - The account to switch to. Must be an account that belongs to
   the currently connected wallet.
 
-## Return Value
+## Return value
 
-Returns `void`. The action completes synchronously and updates the connection state immediately.
+Returns `void`. The action completes synchronously and updates the connection state immediately.

package/docs/actions/switch-network.md

@@ -1,16 +1,17 @@
 # Switch Network
 
-> Switch the active network for the dApp Kit instance
+> Switch the active network for the dApp Kit instance between mainnet, testnet, and other networks.
 
 The `switchNetwork` action changes the currently selected network that the dApp Kit client is
 configured to use.
 
-> **Note:** Network switching only affects your dApp's client connection. The wallet itself is not
-> affected by this change, and wallets are not notified when the network changes in the dApp.
+> **Note:** Network switching only affects your app's client connection. The wallet itself is not affected by
+> this change, and wallets are not notified when the network changes in the app.
 
 ## Usage
 
 ```typescript
+
 const GRPC_URLS = {
 	mainnet: 'https://fullnode.mainnet.sui.io:443',
 	testnet: 'https://fullnode.testnet.sui.io:443',
@@ -28,9 +29,9 @@ dAppKit.switchNetwork('testnet');
 
 ## Parameters
 
-- **`network`** - `TNetworks[number]` - The network to switch to. Must be one of the networks
+- **`network`:** `TNetworks[number]`: The network to switch to. Must be one of the networks
   configured when creating the dApp Kit instance.
 
-## Return Value
+## Return value
 
-Returns `void`. The action completes synchronously and updates the network state immediately.
+Returns `void`. The action completes synchronously and updates the network state immediately.

package/docs/dapp-kit-instance.md

@@ -2,13 +2,13 @@
 
 > Create and configure a DAppKit instance for wallet and client management
 
-The `createDAppKit` function is the foundation of your Sui dApp. It creates an instance that manages
+The `createDAppKit` function is the foundation of your Sui app. It creates an instance that manages
 wallet connections, network configuration, and provides access to the Sui client.
 
-## Creating a dApp Kit Instance
+## Creating a dApp Kit instance
 
 The core of the dApp Kit SDK is the `createDAppKit` function, which creates an instance that manages
-all dApp functionality:
+all app functionality:
 
 ```typescript
 
@@ -22,9 +22,8 @@ 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#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:
@@ -36,22 +35,23 @@ This instance provides:
 
 ## Parameters
 
-- **autoConnect** (optional) - Enables automatically connecting to the most recently used wallet
+- **autoConnect** (optional): Enables automatically connecting to the most recently used wallet
   account (default: `true`)
-- **networks** - A list of networks supported by the application (e.g. `['mainnet', 'testnet']`)
-- **defaultNetwork** (optional) - Initial network to use (default: first network in the array)
-- **createClient** - Creates a new client instance for the given network
-- **enableBurnerWallet** (optional) - Enable development-only burner wallet (default: `false`)
-- **storage** (optional) - Configures how the most recently connected to wallet account is stored
+- **networks:** A list of networks supported by the application (for example,
+  `['mainnet', 'testnet']`)
+- **defaultNetwork** (optional): Initial network to use (default: first network in the array)
+- **createClient:** Creates a new client instance for the given network
+- **enableBurnerWallet** (optional): Enable development-only burner wallet (default: `false`)
+- **storage** (optional): Configures how the most recently connected to wallet account is stored
   (default: `localStorage`, set to `null` to disable)
-- **storageKey** (optional) - The key to use to store the most recently connected wallet account
+- **storageKey** (optional): The key to use to store the most recently connected wallet account
   (default: `'mysten-dapp-kit:selected-wallet-and-address'`)
-- **walletInitializers** (optional) - A list of wallet initializers used for registering additional
+- **walletInitializers** (optional): A list of wallet initializers used for registering additional
   wallet standard wallets.
-- **slushWalletConfig** (optional) - Configuration for Slush wallet (set to `null` to disable the
+- **slushWalletConfig** (optional): Configuration for Slush wallet (set to `null` to disable the
   wallet)
 
-## Return Value
+## Return value
 
 ```ts
 {
@@ -78,7 +78,7 @@ This instance provides:
 
 Read more about [actions](./actions/connect-wallet) and [stores](./state).
 
-## Basic Usage
+## Basic usage
 
 ```ts
 // dapp-kit.ts
@@ -112,7 +112,7 @@ const GRPC_URLS = {
 > If you use the React bindings, see [Getting Started in React](./getting-started/react) and
 > [DAppKitProvider](./react/dapp-kit-provider).
 
-## Development Configuration
+## Development configuration
 
 For development environments, enable the burner wallet:
 
@@ -125,11 +125,11 @@ For development environments, enable the burner wallet:
 });
 ```
 
-## Auto-Connect Behavior
+## Auto-connect behavior
 
 By default, dApp Kit automatically reconnects to the previously connected wallet.
 
-### Disabling Auto-Connect
+### Disabling auto-connect
 
 ```typescript
 
@@ -140,7 +140,7 @@ By default, dApp Kit automatically reconnects to the previously connected wallet
 });
 ```
 
-## Custom Wallet Integration
+## Custom wallet integration
 
 Add support for custom wallets using wallet initializers:
 
@@ -160,4 +160,4 @@ Add support for custom wallets using wallet initializers:
 		},
 	],
 });
-```
+```

package/docs/getting-started/create-dapp.md

@@ -1,11 +1,11 @@
 # @mysten/create-dapp
 
-> Create a Sui dApp with one command
+> Create a Sui app with one command using the create-dapp CLI scaffolding tool.
 
-`@mysten/create-dapp` is a CLI tool that scaffolds a complete Sui dApp project with best practices
+`@mysten/create-dapp` is a CLI tool that scaffolds a complete Sui app project with best practices
 built in.
 
-## Quick Start
+## Quick start
 
 ```sh npm2yarn
 npm create @mysten/dapp
@@ -17,7 +17,7 @@ The CLI prompts you to choose a template and project name, then creates a ready-
 
 ### react-client-dapp
 
-A basic React dApp that demonstrates wallet connection and fetching owned objects:
+A basic React app that demonstrates wallet connection and fetching owned objects:
 
 - Wallet connection with `ConnectButton`
 - Display connected wallet address
@@ -34,7 +34,7 @@ A complete end-to-end example with Move smart contract integration:
 - MVR (Move Registry) name resolution for package IDs
 - Full transaction signing and execution
 
-## Tech Stack
+## Tech stack
 
 Both templates include:
 
@@ -50,7 +50,7 @@ The e2e-counter template also includes:
 
 - [`@mysten/codegen`](/codegen) - Generate TypeScript from Move code
 
-## Project Structure
+## Project structure
 
 ### react-client-dapp
 
@@ -82,9 +82,9 @@ move/
 └── counter/           # Move smart contract
 ```
 
-## Using the e2e-counter Template
+## Using the e2e-counter template
 
-### 1. Deploy the Move Contract
+### Step 1: Deploy the Move contract
 
 First, install the [Sui CLI](https://docs.sui.io/build/install) and set up testnet:
 
@@ -100,7 +100,7 @@ cd move
 sui client publish --gas-budget 100000000 counter
 ```
 
-### 2. Configure the Package ID
+### Step 2: Configure the package ID
 
 Copy the `packageId` from the publish output to `src/constants.ts`:
 
@@ -108,7 +108,7 @@ Copy the `packageId` from the publish output to `src/constants.ts`:
 
 ```
 
-### 3. Generate TypeScript Bindings
+### Step 3: Generate TypeScript bindings
 
 ```bash
 pnpm codegen
@@ -116,7 +116,7 @@ pnpm codegen
 
 This generates type-safe functions in `src/contracts/` for interacting with your Move modules.
 
-### 4. Start Development
+### Step 4: Start development
 
 ```bash
 pnpm install
@@ -135,7 +135,7 @@ project.
 
 Theme variables are defined in `src/index.css` using Tailwind's `@theme` directive.
 
-## CLI Options
+## CLI options
 
 You can skip prompts with command-line flags:
 
@@ -148,4 +148,4 @@ npm create @mysten/dapp -- -n my-app
 
 # Create with both
 npm create @mysten/dapp -- -t react-client-dapp -n my-app
-```
+```