@tonconnect/sdk 3.3.1 → 3.4.0-beta.1

package/lib/types/index.d.ts

@@ -6,7 +6,7 @@ export declare interface Account {
     /**
      * User's selected chain.
      */
-    chain: CHAIN;
+    chain: ChainId;
     /**
      * Base64 (not url safe) encoded wallet contract stateInit.
      * Can be used to get user's public key from the stateInit if the wallet contract doesn't support corresponding get method.
@@ -70,6 +70,8 @@ export declare enum CHAIN {
     TESTNET = "-3"
 }
 
+export declare type ChainId = CHAIN | string;
+
 export declare function checkRequiredWalletFeatures(features: Feature[], walletsRequiredFeatures?: RequiredFeatures): boolean;
 
 export declare enum CONNECT_EVENT_ERROR_CODES {
@@ -115,6 +117,10 @@ export declare type ConnectionCompletedEvent = {
      * Connection success flag.
      */
     is_success: true;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 } & ConnectionInfo;
 
 /**
@@ -140,7 +146,14 @@ export declare type ConnectionErrorEvent = {
     /**
      * Custom data for the connection.
      */
-    custom_data: Version;
+    custom_data: {
+        client_id: string | null;
+        wallet_id: string | null;
+    } & Version;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 };
 
 /**
@@ -156,6 +169,10 @@ export declare type ConnectionInfo = {
      * Connected wallet address.
      */
     wallet_address: string | null;
+    /**
+     * Connected wallet state init.
+     */
+    wallet_state_init: string | null;
     /**
      * Wallet type: 'tonkeeper', 'tonhub', etc.
      */
@@ -180,6 +197,8 @@ export declare type ConnectionInfo = {
          * Wallet provider.
          */
         provider: 'http' | 'injected' | null;
+        client_id: string | null;
+        wallet_id: string | null;
     } & Version;
 };
 
@@ -195,6 +214,10 @@ export declare type ConnectionRestoringCompletedEvent = {
      * Connection success flag.
      */
     is_success: true;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 } & ConnectionInfo;
 
 /**
@@ -217,6 +240,10 @@ export declare type ConnectionRestoringErrorEvent = {
      * Custom data for the connection.
      */
     custom_data: Version;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 };
 
 /**
@@ -236,6 +263,10 @@ export declare type ConnectionRestoringStartedEvent = {
      * Custom data for the connection.
      */
     custom_data: Version;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 };
 
 /**
@@ -250,6 +281,10 @@ export declare type ConnectionStartedEvent = {
      * Custom data for the connection.
      */
     custom_data: Version;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 };
 
 export declare type ConnectItem = TonAddressItem | TonProofItem;
@@ -268,55 +303,55 @@ export declare type ConnectItemReplyError<T> = {
  * Create a connection completed event.
  * @param version
  * @param wallet
+ * @param sessionInfo
+ * @param traceId
  */
-export declare function createConnectionCompletedEvent(version: Version, wallet: Wallet | null): ConnectionCompletedEvent;
+export declare function createConnectionCompletedEvent(version: Version, wallet: Wallet | null, sessionInfo?: SessionInfo | null, traceId?: string | null): ConnectionCompletedEvent;
 
 /**
  * Create a connection error event.
  * @param version
  * @param error_message
  * @param errorCode
+ * @param sessionInfo
+ * @param traceId
  */
-export declare function createConnectionErrorEvent(version: Version, error_message: string, errorCode: CONNECT_EVENT_ERROR_CODES | void): ConnectionErrorEvent;
+export declare function createConnectionErrorEvent(version: Version, error_message: string, errorCode: CONNECT_EVENT_ERROR_CODES | void, sessionInfo?: SessionInfo | null, traceId?: string | null): ConnectionErrorEvent;
 
 /**
  * Create a connection restoring completed event.
  * @param version
  * @param wallet
+ * @param sessionInfo
+ * @param traceId
  */
-export declare function createConnectionRestoringCompletedEvent(version: Version, wallet: Wallet | null): ConnectionRestoringCompletedEvent;
+export declare function createConnectionRestoringCompletedEvent(version: Version, wallet: Wallet | null, sessionInfo?: SessionInfo | null, traceId?: string | null): ConnectionRestoringCompletedEvent;
 
 /**
  * Create a connection restoring error event.
  * @param version
  * @param errorMessage
+ * @param traceId
  */
-export declare function createConnectionRestoringErrorEvent(version: Version, errorMessage: string): ConnectionRestoringErrorEvent;
+export declare function createConnectionRestoringErrorEvent(version: Version, errorMessage: string, traceId?: string | null): ConnectionRestoringErrorEvent;
 
 /**
  * Create a connection restoring started event.
  */
-export declare function createConnectionRestoringStartedEvent(version: Version): ConnectionRestoringStartedEvent;
+export declare function createConnectionRestoringStartedEvent(version: Version, traceId?: string | null): ConnectionRestoringStartedEvent;
 
 /**
  * Create a connection init event.
  */
-export declare function createConnectionStartedEvent(version: Version): ConnectionStartedEvent;
+export declare function createConnectionStartedEvent(version: Version, traceId?: string | null): ConnectionStartedEvent;
 
-export declare function createDataSentForSignatureEvent(version: Version, wallet: Wallet | null, data: SignDataPayload): DataSentForSignatureEvent;
+export declare function createDataSentForSignatureEvent(version: Version, wallet: Wallet | null, data: SignDataPayload, sessionInfo?: SessionInfo | null, traceId?: string | null): DataSentForSignatureEvent;
 
-export declare function createDataSignedEvent(version: Version, wallet: Wallet | null, data: SignDataPayload, signedData: SignDataResponse): DataSignedEvent;
+export declare function createDataSignedEvent(version: Version, wallet: Wallet | null, data: SignDataPayload, signedData: SignDataResponse, sessionInfo?: SessionInfo | null, traceId?: string | null): DataSignedEvent;
 
-export declare function createDataSigningFailedEvent(version: Version, wallet: Wallet | null, data: SignDataPayload, errorMessage: string, errorCode: SIGN_DATA_ERROR_CODES | void): DataSigningFailedEvent;
+export declare function createDataSigningFailedEvent(version: Version, wallet: Wallet | null, data: SignDataPayload, errorMessage: string, errorCode: SIGN_DATA_ERROR_CODES | void, sessionInfo?: SessionInfo | null, traceId?: string | null): DataSigningFailedEvent;
 
-/**
- * Create a disconnect event.
- * @param version
- * @param wallet
- * @param scope
- * @returns
- */
-export declare function createDisconnectionEvent(version: Version, wallet: Wallet | null, scope: 'dapp' | 'wallet'): DisconnectionEvent;
+export declare function createDisconnectionEvent(version: Version, wallet: Wallet | null, scope: 'dapp' | 'wallet', sessionInfo?: SessionInfo | null, traceId?: string | null): DisconnectionEvent;
 
 /**
  * Create a request version event.
@@ -329,13 +364,17 @@ export declare function createRequestVersionEvent(): RequestVersionEvent;
  */
 export declare function createResponseVersionEvent(version: string): ResponseVersionEvent;
 
+export declare function createSelectedWalletEvent(version: Version, visibleWallets: string[], lastSelectedWallet: WalletInfoInjectable | WalletInfoRemote | null, walletsMenu: 'explicit_wallet' | 'main_screen' | 'other_wallets', redirectLink: string, redirectLinkType?: 'tg_link' | 'external_link', clientId?: string | null, traceId?: string | null): SelectedWalletEvent;
+
 /**
  * Create a transaction init event.
  * @param version
  * @param wallet
  * @param transaction
+ * @param sessionInfo
+ * @param traceId
  */
-export declare function createTransactionSentForSignatureEvent(version: Version, wallet: Wallet | null, transaction: SendTransactionRequest): TransactionSentForSignatureEvent;
+export declare function createTransactionSentForSignatureEvent(version: Version, wallet: Wallet | null, transaction: SendTransactionRequest, sessionInfo?: SessionInfo | null, traceId?: string | null): TransactionSentForSignatureEvent;
 
 /**
  * Create a transaction signed event.
@@ -343,8 +382,10 @@ export declare function createTransactionSentForSignatureEvent(version: Version,
  * @param wallet
  * @param transaction
  * @param signedTransaction
+ * @param sessionInfo
+ * @param traceId
  */
-export declare function createTransactionSignedEvent(version: Version, wallet: Wallet | null, transaction: SendTransactionRequest, signedTransaction: SendTransactionResponse): TransactionSignedEvent;
+export declare function createTransactionSignedEvent(version: Version, wallet: Wallet | null, transaction: SendTransactionRequest, signedTransaction: SendTransactionResponse, sessionInfo?: SessionInfo | null, traceId?: string | null): TransactionSignedEvent;
 
 /**
  * Create a transaction error event.
@@ -353,8 +394,10 @@ export declare function createTransactionSignedEvent(version: Version, wallet: W
  * @param transaction
  * @param errorMessage
  * @param errorCode
+ * @param sessionInfo
+ * @param traceId
  */
-export declare function createTransactionSigningFailedEvent(version: Version, wallet: Wallet | null, transaction: SendTransactionRequest, errorMessage: string, errorCode: SEND_TRANSACTION_ERROR_CODES | void): TransactionSigningFailedEvent;
+export declare function createTransactionSigningFailedEvent(version: Version, wallet: Wallet | null, transaction: SendTransactionRequest, errorMessage: string, errorCode: SEND_TRANSACTION_ERROR_CODES | void, sessionInfo?: SessionInfo | null, traceId?: string | null): TransactionSigningFailedEvent;
 
 /**
  * Create a version info.
@@ -362,6 +405,8 @@ export declare function createTransactionSigningFailedEvent(version: Version, wa
  */
 export declare function createVersionInfo(version: Version): Version;
 
+export declare function createWalletModalOpenedEvent(version: Version, visibleWallets: string[], clientId?: string | null, traceId?: string | null): WalletModalOpenedEvent;
+
 export declare interface DappMetadata {
     /**
      * Dapp name. Might be simple, will not be used as identifier.
@@ -384,6 +429,10 @@ export declare interface DappMetadata {
 export declare type DataSentForSignatureEvent = {
     type: 'sign-data-request-initiated';
     data: SignDataPayload;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 } & ConnectionInfo;
 
 export declare type DataSignedEvent = {
@@ -391,6 +440,10 @@ export declare type DataSignedEvent = {
     is_success: true;
     data: SignDataPayload;
     signed_data: SignDataResponse;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 } & ConnectionInfo;
 
 export declare type DataSigningEvent = DataSentForSignatureEvent | DataSignedEvent | DataSigningFailedEvent;
@@ -401,8 +454,14 @@ export declare type DataSigningFailedEvent = {
     error_message: string;
     error_code: SIGN_DATA_ERROR_CODES | null;
     data: SignDataPayload;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 } & ConnectionInfo;
 
+export declare function decodeTelegramUrlParameters(parameters: string): string;
+
 export declare interface DeviceInfo {
     platform: 'iphone' | 'ipad' | 'android' | 'windows' | 'mac' | 'linux' | 'browser';
     appName: string;
@@ -423,6 +482,10 @@ export declare type DisconnectionEvent = {
      * Disconnect scope: 'dapp' or 'wallet'.
      */
     scope: 'dapp' | 'wallet';
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 } & ConnectionInfo;
 
 export declare function enableQaMode(): void;
@@ -467,6 +530,36 @@ export declare class FetchWalletsError extends TonConnectError {
     constructor(...args: ConstructorParameters<typeof TonConnectError>);
 }
 
+/**
+ * Represents the client environment in which the application is running.
+ */
+export declare interface IEnvironment {
+    /**
+     * Retrieves the user's current locale setting.
+     */
+    getLocale(): string;
+    /**
+     * Retrieves the name or identifier of the user's browser.
+     */
+    getBrowser(): string;
+    /**
+     * Retrieves the name of the user's operating system or platform.
+     */
+    getPlatform(): string;
+    /**
+     * Retrieves the Telegram user associated with the current environment, if available.
+     */
+    getTelegramUser(): TelegramUser | undefined;
+    /**
+     * Retrieves the type of client environment.
+     * Indicates whether the client is running as a web application,
+     * Telegram Mini App, or another custom environment.
+     */
+    getClientEnvironment(): 'web' | 'miniapp' | (string & {});
+}
+
+export declare function isConnectUrl(link: string | undefined): link is string;
+
 export declare function isQaModeEnabled(): boolean;
 
 export declare function isTelegramUrl(link: string | undefined): link is string;
@@ -551,16 +644,20 @@ export declare interface ITonConnect {
      * Generates universal link for an external wallet and subscribes to the wallet's bridge, or sends connect request to the injected wallet.
      * @param wallet wallet's bridge url and universal link for an external wallet or jsBridge key for the injected wallet, or list of bridges urls for creating an universal connection request for the corresponding wallets.
      * @param request (optional) additional request to pass to the wallet while connect (currently only ton_proof is available).
+     * @param options (optional) options
      * @returns universal link if external wallet was passed or void for the injected wallet.
      */
-    connect<T extends WalletConnectionSource | Pick<WalletConnectionSourceHTTP, 'bridgeUrl'>[]>(wallet: T, request?: ConnectAdditionalRequest): T extends WalletConnectionSourceJS ? void : string;
+    connect<T extends WalletConnectionSource | Pick<WalletConnectionSourceHTTP, 'bridgeUrl'>[]>(wallet: T, request?: ConnectAdditionalRequest, options?: OptionalTraceable<{
+        openingDeadlineMS?: number;
+        signal?: AbortSignal;
+    }>): T extends WalletConnectionSourceJS ? void : string;
     /**
      * Try to restore existing session and reconnect to the corresponding wallet. Call it immediately when your app is loaded.
      */
-    restoreConnection(options?: {
+    restoreConnection(options?: OptionalTraceable<{
         openingDeadlineMS?: number;
         signal?: AbortSignal;
-    }): Promise<void>;
+    }>): Promise<void>;
     /**
      * Pause bridge HTTP connection. Might be helpful, if you want to pause connections while browser tab is unfocused,
      * or if you use SDK with NodeJS and want to save server resources.
@@ -570,12 +667,18 @@ export declare interface ITonConnect {
      * Unpause bridge HTTP connection if it is paused.
      */
     unPauseConnection(): Promise<void>;
+    /**
+     * Set desired network for the connection. Can only be set before connecting.
+     * If wallet connects with a different chain, the SDK will throw an error and abort connection.
+     * @param network desired network id (e.g., '-239', '-3', or custom). Pass undefined to allow any network.
+     */
+    setConnectionNetwork(network?: ChainId): void;
     /**
      * Disconnect form thw connected wallet and drop current session.
      */
-    disconnect(options?: {
+    disconnect(options?: OptionalTraceable<{
         signal?: AbortSignal;
-    }): Promise<void>;
+    }>): Promise<void>;
     /**
      * Asks connected wallet to sign and send the transaction.
      * @param transaction transaction to send.
@@ -583,16 +686,16 @@ export declare interface ITonConnect {
      * @returns signed transaction boc that allows you to find the transaction in the blockchain.
      * If user rejects transaction, method will throw the corresponding error.
      */
-    sendTransaction(transaction: SendTransactionRequest, options?: {
+    sendTransaction(transaction: SendTransactionRequest, options?: OptionalTraceable<{
         onRequestSent?: () => void;
         signal?: AbortSignal;
-    }): Promise<SendTransactionResponse>;
+    }>): Promise<OptionalTraceable<SendTransactionResponse>>;
     /** @deprecated use sendTransaction(transaction, options) instead */
-    sendTransaction(transaction: SendTransactionRequest, onRequestSent?: () => void): Promise<SendTransactionResponse>;
-    signData(data: SignDataPayload, options?: {
+    sendTransaction(transaction: SendTransactionRequest, onRequestSent?: () => void): Promise<OptionalTraceable<SendTransactionResponse>>;
+    signData(data: SignDataPayload, options?: OptionalTraceable<{
         onRequestSent?: () => void;
         signal?: AbortSignal;
-    }): Promise<SignDataResponse>;
+    }>): Promise<OptionalTraceable<SignDataResponse>>;
     /**
      * Gets the current session ID if available.
      * @returns session ID string or null if not available.
@@ -613,6 +716,10 @@ export declare class LocalstorageNotFoundError extends TonConnectError {
     constructor(...args: ConstructorParameters<typeof TonConnectError>);
 }
 
+export declare type OptionalTraceable<T extends {} = {}> = {
+    traceId?: string;
+} & T;
+
 /**
  * Thrown when passed hex is in incorrect format.
  */
@@ -688,7 +795,46 @@ export declare type ResponseVersionEvent = {
 /**
  * User action events.
  */
-export declare type SdkActionEvent = VersionEvent | ConnectionEvent | ConnectionRestoringEvent | DisconnectionEvent | TransactionSigningEvent | DataSigningEvent;
+export declare type SdkActionEvent = VersionEvent | ConnectionEvent | ConnectionRestoringEvent | DisconnectionEvent | TransactionSigningEvent | DataSigningEvent | WalletModalOpenedEvent | SelectedWalletEvent;
+
+/**
+ * Represents the event triggered when the wallet is selected.
+ */
+export declare type SelectedWalletEvent = {
+    /**
+     * Event type.
+     */
+    type: 'selected-wallet';
+    /**
+     * The unique client identifier associated with the session or user.
+     */
+    client_id: string | null;
+    /**
+     * A list of wallet identifiers that are currently visible in the modal.
+     */
+    visible_wallets: string[];
+    wallets_menu: 'explicit_wallet' | 'main_screen' | 'other_wallets';
+    /**
+     * Redirect method: tg_link, external_link
+     */
+    wallet_redirect_method?: 'tg_link' | 'external_link';
+    /**
+     * URL used to open the wallet
+     */
+    wallet_redirect_link?: string;
+    /**
+     * Wallet type: 'tonkeeper', 'tonhub', etc.
+     */
+    wallet_type: string | null;
+    /**
+     * Custom metadata containing versioning or contextual data for the modal.
+     */
+    custom_data: Version;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id: string | null;
+};
 
 export declare enum SEND_TRANSACTION_ERROR_CODES {
     UNKNOWN_ERROR = 0,
@@ -714,7 +860,7 @@ export declare interface SendTransactionRequest {
     /**
      * The network (mainnet or testnet) where DApp intends to send the transaction. If not set, the transaction is sent to the network currently set in the wallet, but this is not safe and DApp should always strive to set the network. If the network parameter is set, but the wallet has a different network set, the wallet should show an alert and DO NOT ALLOW TO SEND this transaction.
      */
-    network?: CHAIN;
+    network?: ChainId;
     /**
      * The sender address in '<wc>:<hex>' format from which DApp intends to send the transaction. Current account.address by default.
      */
@@ -768,6 +914,11 @@ export declare class SessionCrypto {
     stringifyKeypair(): KeyPair;
 }
 
+export declare type SessionInfo = {
+    clientId: string | null;
+    walletId: string | null;
+};
+
 export declare enum SIGN_DATA_ERROR_CODES {
     UNKNOWN_ERROR = 0,
     BAD_REQUEST_ERROR = 1,
@@ -782,7 +933,7 @@ export declare type SignDataFeature = {
 };
 
 export declare type SignDataPayload = {
-    network?: CHAIN;
+    network?: ChainId;
     from?: string;
 } & (SignDataPayloadText | SignDataPayloadBinary | SignDataPayloadCell);
 
@@ -812,19 +963,34 @@ export declare type SignDataResponse = {
 
 export declare type SignDataType = 'text' | 'binary' | 'cell';
 
+/**
+ * Basic Telegram user information.
+ */
+export declare type TelegramUser = {
+    /** Unique Telegram user ID. */
+    id: number;
+    /** Whether the user has Telegram Premium. */
+    isPremium: boolean;
+};
+
 export declare interface TonAddressItem {
     name: 'ton_addr';
+    /**
+     * Desired network global_id. If provided, wallet should connect on this network.
+     */
+    network?: ChainId;
 }
 
 export declare interface TonAddressItemReply {
     name: 'ton_addr';
     address: string;
-    network: CHAIN;
+    network: ChainId;
     walletStateInit: string;
     publicKey: string;
 }
 
 declare class TonConnect implements ITonConnect {
+    private desiredChainId;
     private static readonly walletsList;
     /**
      * Check if specified wallet is injected and available to use with the app.
@@ -846,6 +1012,8 @@ declare class TonConnect implements ITonConnect {
      */
     private readonly tracker;
     private readonly walletsList;
+    private readonly analytics?;
+    private readonly environment;
     private readonly dappSettings;
     private readonly bridgeConnectionStorage;
     private _wallet;
@@ -886,23 +1054,23 @@ declare class TonConnect implements ITonConnect {
      * @param options (optional) openingDeadlineMS for the connection opening deadline and signal for the connection abort.
      * @returns universal link if external wallet was passed or void for the injected wallet.
      */
-    connect<T extends WalletConnectionSource | Pick<WalletConnectionSourceHTTP, 'bridgeUrl'>[]>(wallet: T, options?: {
+    connect<T extends WalletConnectionSource | Pick<WalletConnectionSourceHTTP, 'bridgeUrl'>[]>(wallet: T, options?: OptionalTraceable<{
         request?: ConnectAdditionalRequest;
         openingDeadlineMS?: number;
         signal?: AbortSignal;
-    }): T extends WalletConnectionSourceJS ? void : string;
+    }>): T extends WalletConnectionSourceJS ? void : string;
     /** @deprecated use connect(wallet, options) instead */
-    connect<T extends WalletConnectionSource | Pick<WalletConnectionSourceHTTP, 'bridgeUrl'>[]>(wallet: T, request?: ConnectAdditionalRequest, options?: {
+    connect<T extends WalletConnectionSource | Pick<WalletConnectionSourceHTTP, 'bridgeUrl'>[]>(wallet: T, request?: ConnectAdditionalRequest, options?: OptionalTraceable<{
         openingDeadlineMS?: number;
         signal?: AbortSignal;
-    }): T extends WalletConnectionSourceJS ? void : string;
+    }>): T extends WalletConnectionSourceJS ? void : string;
     /**
      * Try to restore existing session and reconnect to the corresponding wallet. Call it immediately when your app is loaded.
      */
-    restoreConnection(options?: {
+    restoreConnection(options?: OptionalTraceable<{
         openingDeadlineMS?: number;
         signal?: AbortSignal;
-    }): Promise<void>;
+    }>): Promise<void>;
     /**
      * Asks connected wallet to sign and send the transaction.
      * @param transaction transaction to send.
@@ -910,27 +1078,34 @@ declare class TonConnect implements ITonConnect {
      * @returns signed transaction boc that allows you to find the transaction in the blockchain.
      * If user rejects transaction, method will throw the corresponding error.
      */
-    sendTransaction(transaction: SendTransactionRequest, options?: {
+    sendTransaction(transaction: SendTransactionRequest, options?: OptionalTraceable<{
         onRequestSent?: () => void;
         signal?: AbortSignal;
-    }): Promise<SendTransactionResponse>;
+    }>): Promise<Traceable<SendTransactionResponse>>;
     /** @deprecated use sendTransaction(transaction, options) instead */
-    sendTransaction(transaction: SendTransactionRequest, onRequestSent?: () => void): Promise<SendTransactionResponse>;
-    signData(data: SignDataPayload, options?: {
+    sendTransaction(transaction: SendTransactionRequest, onRequestSent?: () => void): Promise<Traceable<SendTransactionResponse>>;
+    signData(data: SignDataPayload, options?: OptionalTraceable<{
         onRequestSent?: () => void;
         signal?: AbortSignal;
-    }): Promise<SignDataResponse>;
+    }>): Promise<Traceable<SignDataResponse>>;
+    /**
+     * Set desired network for the connection. Can only be set before connecting.
+     * If wallet connects with a different chain, the SDK will throw an error and abort connection.
+     * @param network desired network id (e.g., '-239', '-3', or custom). Pass undefined to allow any network.
+     */
+    setConnectionNetwork(network?: ChainId): void;
     /**
      * Disconnect form thw connected wallet and drop current session.
      */
-    disconnect(options?: {
+    disconnect(options?: OptionalTraceable<{
         signal?: AbortSignal;
-    }): Promise<void>;
+    }>): Promise<void>;
     /**
      * Gets the current session ID if available.
      * @returns session ID string or null if not available.
      */
     getSessionId(): Promise<string | null>;
+    private getSessionInfo;
     /**
      * Pause bridge HTTP connection. Might be helpful, if you want to pause connections while browser tab is unfocused,
      * or if you use SDK with NodeJS and want to save server resources.
@@ -999,6 +1174,10 @@ export declare interface TonConnectOptions {
      * Allows to disable auto pause/unpause SSE connection on 'document.visibilitychange' event. It is not recommended to change default behaviour.
      */
     disableAutoPauseConnection?: boolean;
+    /**
+     * Represents the client environment in which the application is running.
+     */
+    environment?: IEnvironment;
 }
 
 export declare interface TonProofItem {
@@ -1030,6 +1209,39 @@ export declare interface TonProofItemReplySuccess {
  */
 export declare function toUserFriendlyAddress(hexAddress: string, testOnly?: boolean): string;
 
+export declare type Traceable<T extends {} = {}> = {
+    traceId: string;
+} & T;
+
+/**
+ * Transaction information.
+ */
+export declare type TransactionFullInfo = Omit<TransactionInfo, 'messages'> & {
+    messages: TransactionFullMessage[];
+};
+
+/**
+ * Transaction message.
+ */
+export declare type TransactionFullMessage = {
+    /**
+     * Recipient address.
+     */
+    address: string | null;
+    /**
+     * Transfer amount.
+     */
+    amount: string | null;
+    /**
+     * Message payload
+     */
+    payload: string | null;
+    /**
+     * Message state init
+     */
+    state_init: string | null;
+};
+
 /**
  * Transaction information.
  */
@@ -1070,6 +1282,10 @@ export declare type TransactionSentForSignatureEvent = {
      * Event type.
      */
     type: 'transaction-sent-for-signature';
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 } & ConnectionInfo & TransactionInfo;
 
 /**
@@ -1088,6 +1304,10 @@ export declare type TransactionSignedEvent = {
      * Signed transaction.
      */
     signed_transaction: string;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
 } & ConnectionInfo & TransactionInfo;
 
 /**
@@ -1115,7 +1335,11 @@ export declare type TransactionSigningFailedEvent = {
      * Error code.
      */
     error_code: SEND_TRANSACTION_ERROR_CODES | null;
-} & ConnectionInfo & TransactionInfo;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id?: string | null;
+} & ConnectionInfo & TransactionFullInfo;
 
 /**
  * Thrown when app tries to send rpc request to the injected wallet while not connected.
@@ -1140,6 +1364,23 @@ export declare class UserRejectsError extends TonConnectError {
     constructor(...args: ConstructorParameters<typeof TonConnectError>);
 }
 
+/**
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2010-2020 Robert Kieffer and other contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+export declare type UUIDTypes<TBuf extends Uint8Array = Uint8Array> = string | TBuf;
+
+export declare function UUIDv7(options?: Version7Options, buf?: undefined, offset?: number): string;
+
+export declare function UUIDv7<TBuf extends Uint8Array = Uint8Array>(options: Version7Options | undefined, buf: TBuf, offset?: number): TBuf;
+
 /**
  * Version of the TON Connect SDK and TON Connect UI.
  */
@@ -1154,6 +1395,13 @@ export declare type Version = {
     ton_connect_ui_lib: string | null;
 };
 
+export declare type Version7Options = {
+    random?: Uint8Array;
+    msecs?: number;
+    seq?: number;
+    rng?: () => Uint8Array;
+};
+
 /**
  * Version events.
  */
@@ -1321,6 +1569,32 @@ export declare class WalletMissingRequiredFeaturesError extends TonConnectError<
     });
 }
 
+/**
+ * Represents the event triggered when the wallet modal is opened.
+ */
+export declare type WalletModalOpenedEvent = {
+    /**
+     * Event type.
+     */
+    type: 'wallet-modal-opened';
+    /**
+     * The unique client identifier associated with the session or user.
+     */
+    client_id: string | null;
+    /**
+     * A list of wallet identifiers that are currently visible in the modal.
+     */
+    visible_wallets: string[];
+    /**
+     * Custom metadata containing versioning or contextual data for the modal.
+     */
+    custom_data: Version;
+    /**
+     * Unique identifier used for tracking a specific user flow.
+     */
+    trace_id: string | null;
+};
+
 /**
  * Thrown when send transaction or other protocol methods called while wallet is not connected.
  */
@@ -1377,6 +1651,18 @@ export declare class WalletsListManager {
     private isCorrectWalletConfigDTO;
 }
 
+export declare class WalletWrongNetworkError extends TonConnectError<{
+    expectedChainId: string;
+    actualChainId: string;
+}> {
+    constructor(message: string, options: {
+        cause: {
+            expectedChainId: string;
+            actualChainId: string;
+        };
+    });
+}
+
 /**
  * Parameters without version field.
  */