@tonconnect/ui 2.3.1 → 2.4.0-beta.1

package/README.md

@@ -317,6 +317,18 @@ try {
 }
 ```
 
+### Trace ID for analytics
+
+You can pass a custom trace ID to track the transaction through your analytics:
+
+```ts
+const result = await tonConnectUI.sendTransaction(transaction, {
+    traceId: '019a2a92-a884-7cfc-b1bc-caab18644b6f' // optional, UUIDv7 auto-generated if not provided
+});
+
+console.log(result.traceId); // use this ID to correlate with analytics events
+```
+
 `sendTransaction` will automatically render informational modals and notifications. You can change its behaviour:
 
 ```ts
@@ -382,6 +394,16 @@ try {
 }
 ```
 
+You can also pass a trace ID to correlate with analytics:
+
+```ts
+const result = await tonConnectUI.signData(textData, {
+    traceId: '019a2a92-a884-7cfc-b1bc-caab18644b6f' // optional, UUIDv7 auto-generated if not provided
+});
+
+console.log(result.traceId); // use this ID to correlate with analytics events
+```
+
 #### Binary Format
 
 Use for arbitrary binary data. The wallet shows a warning about unknown content.
@@ -922,6 +944,23 @@ tonConnectUI.onStatusChange(wallet => {
     });
 ```
 
+## Network selection
+
+You can specify the desired network before connecting to a wallet using the `setConnectionNetwork()` method. If the wallet connects to a different network, the connection will be aborted with a `WalletWrongNetworkError`.
+
+```ts
+import { CHAIN } from '@tonconnect/ui';
+
+// Set desired network before connecting
+tonConnectUI.setConnectionNetwork(CHAIN.MAINNET); // or CHAIN.TESTNET, or any custom chainId string
+
+// Allow any network (default behavior)
+tonConnectUI.setConnectionNetwork(undefined);
+```
+
+**Important:** 
+- Network must be set before calling `connectWallet()` or opening the wallet selection modal. Attempting to change network while connected will throw an error.
+- Network validation is also performed for `sendTransaction` and `signData` operations if a network was specified.
 
 # Tracking