@dynamic-labs/tron 4.32.1 → 4.34.0

package/CHANGELOG.md

@@ -1,4 +1,24 @@
 
+## [4.34.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.33.0...v4.34.0) (2025-09-30)
+
+
+### Features
+
+* add getMultichainBalances to react-native ([#9593](https://github.com/dynamic-labs/dynamic-auth/issues/9593)) ([2e482c3](https://github.com/dynamic-labs/dynamic-auth/commit/2e482c3a3d17e4570173c3ca6e27d83c9fac7265))
+
+## [4.33.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.32.1...v4.33.0) (2025-09-26)
+
+
+### Features
+
+* add support for signAndExecuteTransactionBlock and signTransactionBlock legacy sui features ([#9574](https://github.com/dynamic-labs/dynamic-auth/issues/9574)) ([316481f](https://github.com/dynamic-labs/dynamic-auth/commit/316481f9255ccc8873d267e85932df3b9d58184b))
+* add viem account for waas wallets ([#9518](https://github.com/dynamic-labs/dynamic-auth/issues/9518)) ([39b6314](https://github.com/dynamic-labs/dynamic-auth/commit/39b631489a5fc38bf8077a91f7dd36d517e42512))
+
+
+### Bug Fixes
+
+* unable to use backup codes to delete totp method on dynamics ui ([#9575](https://github.com/dynamic-labs/dynamic-auth/issues/9575)) ([db55161](https://github.com/dynamic-labs/dynamic-auth/commit/db5516191103ba00f3d993db28ec0df630e066b0))
+
 ### [4.32.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.32.0...v4.32.1) (2025-09-25)
 
 

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.32.1";
+var version = "4.34.0";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.32.1";
+var version = "4.34.0";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/tron",
-  "version": "4.32.1",
+  "version": "4.34.0",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -9,11 +9,18 @@
   "types": "./src/index.d.ts",
   "type": "module",
   "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "require": "./src/index.cjs"
+    },
     "./package.json": "./package.json"
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/assert-package-version": "4.32.1",
-    "tronweb": "6.0.4"
-  }
+    "@dynamic-labs/assert-package-version": "4.34.0",
+    "tronweb": "6.0.4",
+    "@dynamic-labs/types": "4.34.0"
+  },
+  "peerDependencies": {}
 }

package/src/types.d.ts

@@ -1,11 +1,28 @@
 import type { TronWeb, Types } from 'tronweb';
 /**
- * Tron wallet provider interface
- * Defines the contract that Tron wallet providers must implement
+ * Global window interface extension for Tron wallet providers
+ */
+declare global {
+    interface Window {
+        tronLink?: ITronProvider;
+        tronWeb?: TronWeb;
+        tokenpocket?: {
+            tronWeb?: TronWeb;
+            tron?: unknown;
+        };
+    }
+}
+/**
+ * Interface that all Tron wallet providers must implement.
+ *
+ * This interface is designed to be flexible and work with different
+ * Tron wallet implementations like TronLink, TokenPocket, etc.
  */
 export interface ITronProvider {
     /** Whether the wallet is currently connected */
-    isConnected: boolean;
+    isConnected?: boolean;
+    /** Whether the wallet is ready */
+    ready?: boolean;
     /** The current network chain ID */
     chainId?: string;
     /** The current network name */
@@ -14,60 +31,52 @@ export interface ITronProvider {
     address?: string;
     /** TronWeb instance */
     tronWeb?: TronWeb;
+    /** TronLink specific flag */
+    isTronLink?: boolean;
     /**
-     * Connect to the wallet
+     * Request connection to the wallet
      * @returns Promise that resolves to connection result
      */
-    connect(): Promise<{
-        address: string;
-        chainId?: string;
-        network?: string;
-    }>;
+    request?(params: {
+        method: string;
+        params?: unknown;
+    }): Promise<unknown>;
     /**
-     * Disconnect from the wallet
-     * @returns Promise that resolves when disconnected
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Get the current account address
-     * @returns Promise that resolves to the address
+     * Connect to the wallet (TronLink style)
+     * @returns Promise that resolves to connection result
      */
-    getAddress(): Promise<string>;
+    connect?(): Promise<TronConnectionResult>;
     /**
-     * Get the current network information
-     * @returns Promise that resolves to network info
+     * Disconnect from the wallet
+     * @returns Promise that resolves when disconnected
      */
-    getNetwork(): Promise<{
-        chainId: string;
-        name: string;
-    }>;
+    disconnect?(): Promise<void>;
     /**
      * Sign a message
      * @param message - Message to sign
-     * @param useTronHeader - Whether to use Tron message header
      * @returns Promise that resolves to the signature
      */
-    signMessage(message: string | Uint8Array, useTronHeader?: boolean): Promise<string>;
+    signMessage?(message: string): Promise<string>;
     /**
      * Sign a transaction
      * @param transaction - Transaction to sign
-     * @param privateKey - Optional private key (if not using wallet's key)
      * @returns Promise that resolves to the signed transaction
      */
-    signTransaction(transaction: Types.Transaction, privateKey?: string): Promise<Types.SignedTransaction>;
+    signTransaction?(transaction: Types.Transaction): Promise<Types.SignedTransaction>;
     /**
      * Send a transaction
      * @param transaction - Transaction to send
      * @returns Promise that resolves to transaction result
      */
-    sendTransaction(transaction: Types.SignedTransaction): Promise<Types.BroadcastReturn<Types.SignedTransaction>>;
+    sendTransaction?(transaction: Types.SignedTransaction): Promise<Types.BroadcastReturn<Types.SignedTransaction>>;
     /**
      * Send TRX to an address
      * @param to - Recipient address
      * @param amount - Amount in TRX
+     * @param options - Optional parameters
      * @returns Promise that resolves to transaction result
      */
-    sendTrx(to: string, amount: number, options?: {
+    sendTrx?(to: string, amount: number, options?: {
         from?: string;
     }): Promise<Types.BroadcastReturn<Types.SignedTransaction>>;
     /**
@@ -75,36 +84,45 @@ export interface ITronProvider {
      * @param to - Recipient address
      * @param amount - Amount of tokens
      * @param tokenId - Token ID
+     * @param options - Optional parameters
      * @returns Promise that resolves to transaction result
      */
-    sendToken(to: string, amount: number, tokenId: string | number, options?: {
+    sendToken?(to: string, amount: number, tokenId: string | number, options?: {
         from?: string;
     }): Promise<Types.BroadcastReturn<Types.SignedTransaction>>;
     /**
      * Get account balance
      * @param address - Optional address (defaults to current account)
-     * @returns Promise that resolves to balance
+     * @returns Promise that resolves to balance in SUN
      */
-    getBalance(address?: string): Promise<number>;
+    getBalance?(address?: string): Promise<number>;
     /**
      * Get token balance
      * @param tokenId - Token ID
      * @param address - Optional address (defaults to current account)
      * @returns Promise that resolves to token balance
      */
-    getTokenBalance(tokenId: string, address?: string): Promise<number>;
+    getTokenBalance?(tokenId: string, address?: string): Promise<number>;
+    /**
+     * Get current network information
+     * @returns Promise that resolves to network info
+     */
+    getNetwork?(): Promise<{
+        chainId: string;
+        name: string;
+    }>;
     /**
      * Switch network
      * @param networkId - Network ID to switch to
      * @returns Promise that resolves when network is switched
      */
-    switchNetwork(networkId: string): Promise<void>;
+    switchNetwork?(networkId: string): Promise<void>;
     /**
      * Add network
      * @param network - Network configuration to add
      * @returns Promise that resolves when network is added
      */
-    addNetwork(network: {
+    addNetwork?(network: {
         networkId: string;
         name: string;
         rpcUrl: string;
@@ -114,12 +132,12 @@ export interface ITronProvider {
      * Listen for account changes
      * @param callback - Callback function for account changes
      */
-    onAccountChange(callback: (address: string) => void): void;
+    onAccountChange?(callback: (address: string) => void): void;
     /**
      * Listen for network changes
      * @param callback - Callback function for network changes
      */
-    onNetworkChange(callback: (network: {
+    onNetworkChange?(callback: (network: {
         chainId: string;
         name: string;
     }) => void): void;
@@ -127,13 +145,23 @@ export interface ITronProvider {
      * Remove account change listener
      * @param callback - Callback function to remove
      */
-    removeAccountChangeListener(callback: (address: string) => void): void;
+    removeAccountChangeListener?(callback: (address: string) => void): void;
     /**
      * Remove network change listener
      * @param callback - Callback function to remove
      */
-    removeNetworkChangeListener(callback: (network: {
+    removeNetworkChangeListener?(callback: (network: {
         chainId: string;
         name: string;
     }) => void): void;
+    /** Additional properties that providers may implement */
+    [key: string]: unknown;
 }
+/**
+ * Result from wallet connection
+ */
+export type TronConnectionResult = {
+    address: string;
+    chainId?: string;
+    network?: string;
+} | string | boolean;

package/src/utils/getDefaultTronNetworks.d.ts

@@ -0,0 +1,9 @@
+import type { GenericNetwork } from '@dynamic-labs/types';
+export declare const TRON_MAINNET_NETWORK: GenericNetwork;
+export declare const TRON_NILE_TESTNET_NETWORK: GenericNetwork;
+export declare const TRON_SHASTA_TESTNET_NETWORK: GenericNetwork;
+/**
+ * Gets the default Tron networks configuration
+ * @returns Array of default Tron networks
+ */
+export declare const getDefaultTronNetworks: () => GenericNetwork[];

package/src/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { assertProvider, getCurrentAddress, isProviderReady } from './provider';
+export { getDefaultTronNetworks } from './getDefaultTronNetworks';

package/src/utils/provider.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Utility functions for Tron provider validation and error handling
+ */
+import type { ITronProvider } from '../types';
+/**
+ * Asserts that a provider is available and throws an error if not
+ * @param provider - The provider to validate
+ * @param providerName - Human-readable name for error messages
+ * @returns The validated provider
+ * @throws {Error} If provider is not available
+ */
+export declare const assertProvider: <T>(provider: T | undefined, providerName: string) => T;
+/**
+ * Gets the current address from a Tron provider using various methods
+ * @param provider - The Tron provider
+ * @returns The current address or undefined if not available
+ */
+export declare const getCurrentAddress: (provider: ITronProvider) => string | undefined;
+/**
+ * Checks if a Tron provider is ready and connected
+ * @param provider - The Tron provider
+ * @returns True if the provider is ready and connected
+ */
+export declare const isProviderReady: (provider: ITronProvider) => boolean;