@dynamic-labs/ton 4.60.1 → 4.61.0

package/src/connectors/TonConnectConnector/TonConnectConnector.d.ts

@@ -0,0 +1,169 @@
+import { TonConnect, type SendTransactionRequest } from '@tonconnect/sdk';
+import { TonClient } from '@ton/ton';
+import { Chain, WalletConnectorBase } from '@dynamic-labs/wallet-connector-core';
+import type { GenericNetwork, IUITransaction } from '@dynamic-labs/types';
+import { TonWallet } from '../../wallet/TonWallet';
+import type { SendJettonOptions, TonConnectConnectorOpts, TonConnectProof, TonTransactionResult } from '../../types';
+/**
+ * TON Connect connector implementation
+ *
+ * Uses the TON Connect SDK to connect with TON wallets that support
+ * the TON Connect protocol (Tonkeeper, MyTonWallet, etc.)
+ */
+export declare class TonConnectConnector extends WalletConnectorBase<typeof TonWallet> {
+    ChainWallet: typeof TonWallet;
+    name: string;
+    overrideKey: string;
+    connectedChain: Chain;
+    supportedChains: Chain[];
+    canConnectViaQrCode: boolean;
+    private tonConnect;
+    private tonNetworks;
+    private connectedWallet;
+    private pendingProofPayload;
+    /**
+     * Get the TonConnect instance (for discovering wallets and advanced usage)
+     */
+    getTonConnect(): TonConnect;
+    /**
+     * Creates a new TON Connect connector
+     *
+     * @param opts - Configuration options
+     */
+    constructor(opts: TonConnectConnectorOpts);
+    /**
+     * Setup event listeners for TON Connect
+     */
+    setupEventListeners(): void;
+    /**
+     * Check if TON Connect is available
+     */
+    isInstalledOnBrowser(): boolean;
+    /**
+     * Connect to a TON wallet
+     * @param tonProofPayload - Optional payload for tonProof authentication
+     */
+    connect(tonProofPayload?: string): Promise<void>;
+    /**
+     * Find a wallet matching this connector's overrideKey
+     */
+    private findMatchingWallet;
+    /**
+     * Get the current wallet address in user-friendly format (EQ... or UQ...)
+     */
+    getAddress(): Promise<string | undefined>;
+    /**
+     * Get connected accounts
+     */
+    getConnectedAccounts(): Promise<string[]>;
+    /**
+     * Get the current network
+     */
+    getNetwork(): Promise<string | undefined>;
+    /**
+     * Check if current network is testnet
+     */
+    isTestnet(): Promise<boolean>;
+    /**
+     * Sign a message
+     */
+    signMessage(messageToSign: string): Promise<string>;
+    /**
+     * Send a transaction
+     */
+    sendTransaction(request: SendTransactionRequest): Promise<TonTransactionResult>;
+    /**
+     * Send Jetton transaction
+     */
+    sendJettonTransaction(_options: SendJettonOptions): Promise<TonTransactionResult>;
+    /**
+     * Get TonClient for the current or specified network.
+     */
+    getTonClient(chainId?: string): TonClient;
+    /**
+     * Get balance of an address
+     */
+    getBalance(address: string): Promise<string | undefined>;
+    /**
+     * Get enabled networks
+     */
+    getEnabledNetworks(): GenericNetwork[];
+    /**
+     * Switch network (TON Connect handles this automatically)
+     */
+    switchNetwork(): Promise<void>;
+    /**
+     * Disconnect and cleanup
+     */
+    endSession(): Promise<void>;
+    /**
+     * Create a UI transaction for the send balance flow
+     */
+    createUiTransaction(from: string): Promise<IUITransaction>;
+    /**
+     * Internal handler for UI transaction submission
+     */
+    private internalSendUiTransaction;
+    /**
+     * Convert TON address from raw format (0:hex) to user-friendly format (UQ...)
+     * TON Connect SDK expects user-friendly format for message addresses
+     */
+    private convertAddressToUserFriendly;
+    /**
+     * Encode a comment as TON message payload
+     *
+     * TON comments are encoded as a Cell with:
+     * - First 32 bits (4 bytes): 0x00000000 (comment opcode)
+     * - Then the UTF-8 bytes of the comment
+     *
+     * For long messages, the comment is split across multiple cells using references.
+     * The Cell is then serialized to base64 BOC format for TON Connect SDK
+     */
+    encodeComment(comment: string): string;
+    /**
+     * Check if error is a user rejection
+     */
+    private isUserRejectionError;
+    /**
+     * Generate a TON Connect proof for authentication
+     * @param payload - The payload string to include in the proof
+     * @returns TON Connect proof object
+     */
+    generateTonConnectProof(payload: string): Promise<TonConnectProof>;
+    /**
+     * Override proveOwnership to use tonProof for wallet verification
+     *
+     * For TON wallets, we use the tonProof mechanism during connection
+     * which is the standard way to prove wallet ownership in TON Connect.
+     * The backend expects a specific format with state_init and public_key.
+     */
+    proveOwnership(address: string, messageToSign: string): Promise<string | undefined>;
+    /**
+     * proveOwnership using tonProof
+     *
+     * Returns the proof in the format expected by the backend:
+     * {
+     *   address: string,
+     *   proof: { domain, payload, signature, state_init, timestamp },
+     *   public_key: string
+     * }
+     */
+    private proveOwnershipWithTonProof;
+    /**
+     * Extract public key from state_init cell
+     *
+     * For standard TON wallets, the public key is stored in the data cell:
+     * - First 32 bits: seqno (skipped)
+     * - Next 256 bits (32 bytes): public key
+     *
+     * This matches the extraction logic in the backend.
+     */
+    private extractPublicKeyFromStateInit;
+    /**
+     * Extract the nonce from a SIWE-style message
+     *
+     * @param message - The full message to extract nonce from
+     * @returns A short payload suitable for tonProof
+     */
+    private extractNonceFromMessage;
+}