@dynamic-labs/tron 4.39.0 → 4.40.1

package/CHANGELOG.md

@@ -1,4 +1,23 @@
 
+### [4.40.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.40.0...v4.40.1) (2025-10-24)
+
+### Bug Fixes
+
+* add support for Keplr in-app browser redirect for cosmos chain ([#9770](https://github.com/dynamic-labs/dynamic-auth/issues/9770)) ([35652f3](https://github.com/dynamic-labs/dynamic-auth/commit/35652f3167a4e768f5d4c634ab1b4f127fd5076a))
+
+## [4.40.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.39.0...v4.40.0) (2025-10-22)
+
+
+### Features
+
+* add Wallet Connect Solana as a wallet option ([#9719](https://github.com/dynamic-labs/dynamic-auth/issues/9719)) ([ece5f6b](https://github.com/dynamic-labs/dynamic-auth/commit/ece5f6b36c1fbefdf05cf8203fe0fee0b2e8ed3d))
+* make updates to crypto.com onramp flow ([#9746](https://github.com/dynamic-labs/dynamic-auth/issues/9746)) ([22040d2](https://github.com/dynamic-labs/dynamic-auth/commit/22040d28d0d66b84f5c3be9bed4cfce7f1978944))
+
+
+### Bug Fixes
+
+* return undefined if json payload is undefined in parse token ([#9750](https://github.com/dynamic-labs/dynamic-auth/issues/9750)) ([5751198](https://github.com/dynamic-labs/dynamic-auth/commit/575119867c93f89062e96e30c02b128161fb9675))
+
 ## [4.39.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.38.0...v4.39.0) (2025-10-17)
 
 

package/README.md

@@ -1,6 +1,10 @@
 # @dynamic-labs/tron
 
-A Tron wallet connector package for the Dynamic SDK that enables seamless integration with Spark network wallets.
+Tron blockchain integration for the Dynamic SDK using the industry-standard [TronWallet Adapter](https://walletadapter.org).
+
+## Overview
+
+This package provides seamless integration with Tron wallets in your dApp using the TronWallet Adapter standard. By leveraging the TronWallet Adapter, you get access to 9+ Tron wallets through a single, unified interface with automatic wallet detection, connection management, and standardized transaction handling.
 
 ## Installation
 
@@ -8,16 +12,23 @@ A Tron wallet connector package for the Dynamic SDK that enables seamless integr
 npm install @dynamic-labs/tron
 ```
 
-## 🔌 Supported Wallets
+## Supported Wallets
 
-### Provider Interface
+This package supports the following Tron wallets through TronWallet Adapter:
 
-## 🌐 Supported Networks
+| Wallet            | Type              | Description                          |
+| ----------------- | ----------------- | ------------------------------------ |
+| **OKX Wallet**    | Browser Extension | Multi-chain wallet with Tron support |
+| **Bitget Wallet** | Browser Extension | Formerly BitKeep                     |
+| **TokenPocket**   | Mobile/Extension  | Multi-chain wallet                   |
+| **Trust Wallet**  | Mobile/Extension  | Popular multi-chain wallet           |
 
-## 📖 Usage
+## Usage
 
 ### Basic Integration
 
+Integrate all Tron wallets into your Dynamic configuration:
+
 ```typescript
 import { DynamicContextProvider } from '@dynamic-labs/sdk-react-core';
 import { TronWalletConnectors } from '@dynamic-labs/tron';
@@ -36,48 +47,281 @@ function App() {
 }
 ```
 
-### Type Checking
+### Working with Tron Wallets
 
-Use the `isTronWallet` type guard to safely work with Tron wallets:
+Use the `isTronWallet` type guard to safely access Tron-specific functionality:
 
 ```typescript
+import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
 import { isTronWallet } from '@dynamic-labs/tron';
 
-function handleWallet(wallet: Wallet) {
-  if (isTronWallet(wallet)) {
-    // Do something
-  }
+function MyComponent() {
+  const { primaryWallet } = useDynamicContext();
+
+  const handleSendTrx = async () => {
+    if (!isTronWallet(primaryWallet)) {
+      console.error('Not a Tron wallet');
+      return;
+    }
+
+    try {
+      // Send 10 TRX
+      const result = await primaryWallet.sendTrx('TRecipientAddress...', 10);
+      console.log('Transaction sent:', result.txid);
+    } catch (error) {
+      console.error('Transaction failed:', error);
+    }
+  };
+
+  return <button onClick={handleSendTrx}>Send TRX</button>;
+}
+```
+
+### Accessing TronWeb
+
+Get direct access to the TronWeb instance:
+
+```typescript
+import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
+import { isTronWallet } from '@dynamic-labs/tron';
+
+function MyComponent() {
+  const { primaryWallet } = useDynamicContext();
+
+  const getTronWebInstance = () => {
+    if (!isTronWallet(primaryWallet)) return null;
+
+    const tronWeb = primaryWallet.getTronWeb();
+    return tronWeb;
+  };
+
+  const checkBalance = async () => {
+    const tronWeb = getTronWebInstance();
+    if (!tronWeb) return;
+
+    const balance = await tronWeb.trx.getBalance(primaryWallet.address);
+    console.log('Balance (in SUN):', balance);
+    console.log('Balance (in TRX):', balance / 1_000_000);
+  };
+
+  return <button onClick={checkBalance}>Check Balance</button>;
+}
+```
+
+### Signing Messages
+
+Sign messages with Tron wallets (uses `signMessageV2`):
+
+```typescript
+import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
+import { isTronWallet } from '@dynamic-labs/tron';
+
+function MyComponent() {
+  const { primaryWallet } = useDynamicContext();
+
+  const handleSignMessage = async () => {
+    if (!isTronWallet(primaryWallet)) return;
+
+    try {
+      const message = 'Hello, Tron!';
+      const signature = await primaryWallet.signMessage(message);
+      console.log('Signature:', signature);
+
+      // Verify the signature
+      const tronWeb = primaryWallet.getTronWeb();
+      if (tronWeb) {
+        const recoveredAddress = await tronWeb.trx.verifyMessageV2(
+          message,
+          signature,
+        );
+        console.log('Verified:', recoveredAddress === primaryWallet.address);
+      }
+    } catch (error) {
+      console.error('Signing failed:', error);
+    }
+  };
+
+  return <button onClick={handleSignMessage}>Sign Message</button>;
 }
 ```
 
-## 🧪 Testing
+### Working with TRC20 Tokens
 
-### Run Tests
+Get token balances and interact with TRC20 tokens:
+
+```typescript
+import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
+import { isTronWallet } from '@dynamic-labs/tron';
+
+function MyComponent() {
+  const { primaryWallet } = useDynamicContext();
+
+  const getUSDTBalance = async () => {
+    if (!isTronWallet(primaryWallet)) return;
+
+    // USDT contract address on Tron mainnet
+    const usdtContract = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
+
+    try {
+      const balance = await primaryWallet.getTokenBalance(usdtContract);
+      console.log('USDT Balance:', balance);
+    } catch (error) {
+      console.error('Failed to get token balance:', error);
+    }
+  };
+
+  return <button onClick={getUSDTBalance}>Get USDT Balance</button>;
+}
+```
+
+### Network Information
+
+Get current network details:
+
+```typescript
+import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
+import { isTronWallet } from '@dynamic-labs/tron';
+
+function MyComponent() {
+  const { primaryWallet } = useDynamicContext();
+
+  const getNetworkInfo = async () => {
+    if (!isTronWallet(primaryWallet)) return;
+
+    const network = await primaryWallet.getNetworkDetails();
+    console.log('Chain ID:', network.chainId);
+    console.log('Network Name:', network.name);
+  };
+
+  return <button onClick={getNetworkInfo}>Get Network Info</button>;
+}
+```
+
+## Supported Networks
+
+The package includes built-in support for:
+
+- **Tron Mainnet** (Chain ID: `0x2b6653dc`)
+- **Nile Testnet** (Chain ID: `0x94a9059e`)
+- **Shasta Testnet** (Chain ID: `0x401e93ff`)
+
+### Custom Networks
+
+You can configure custom networks when creating connectors:
+
+```typescript
+import { TronLinkConnector } from '@dynamic-labs/tron';
+import type { GenericNetwork } from '@dynamic-labs/types';
+
+const customNetworks: GenericNetwork[] = [
+  {
+    blockExplorerUrls: ['https://custom-explorer.com'],
+    chainId: '0x12345678',
+    chainName: 'Custom Tron Network',
+    name: 'Custom Tron Network',
+    nativeCurrency: {
+      decimals: 6,
+      name: 'TRX',
+      symbol: 'TRX',
+    },
+    networkId: '0x12345678',
+    rpcUrls: ['https://custom-rpc.example.com'],
+    vanityName: 'Custom Network',
+  },
+];
+
+// Use with connector
+const connector = new TronLinkConnector({
+  walletBook: walletBookInstance,
+  tronNetworks: customNetworks,
+});
+```
+
+## API Reference
+
+### TronWallet Class
+
+The main wallet class for Tron wallets.
+
+#### Methods
+
+- `getAddress(): Promise<string>` - Get the wallet address
+- `getNetwork(): Promise<string | number | undefined>` - Get current network
+- `signMessage(message: string | Uint8Array): Promise<string>` - Sign a message
+- `getBalance(address?: string): Promise<string | undefined>` - Get TRX balance
+- `sendTrx(to: string, amount: number, options?: { from?: string }): Promise<BroadcastReturn>` - Send TRX
+- `getTokenBalance(tokenId: string, address?: string): Promise<number>` - Get TRC20 token balance
+- `getNetworkDetails(): Promise<{ chainId: string; name: string }>` - Get network info
+- `getTronWeb(): TronWeb | undefined` - Get TronWeb instance
+
+### isTronWallet()
+
+Type guard to check if a wallet is a Tron wallet.
+
+```typescript
+function isTronWallet(wallet: Wallet | null | undefined): wallet is TronWallet;
+```
+
+## Architecture
+
+This package uses the **TronWallet Adapter** pattern, which provides:
+
+1. **Adapter Layer**: Each wallet connector wraps a TronWallet Adapter instance
+2. **Unified Interface**: All wallets expose the same methods and events
+3. **Event Handling**: Standardized events for connect, disconnect, account changes, etc.
+4. **Network Detection**: Automatic network detection and switching support
+
+The architecture follows Dynamic's wallet connector pattern while leveraging the TronWallet Adapter's battle-tested implementations.
+
+## Development
+
+### Build
+
+```bash
+npx nx build tron
+```
+
+### Test
 
 ```bash
 npx nx test tron
 ```
 
-### Build Package
+### Lint
 
 ```bash
-npx nx build tron
+npx nx lint tron
 ```
 
-## 🤝 Contributing
+## TypeScript Support
 
-We welcome contributions! Please see our [contributing guidelines](https://github.com/dynamic-labs/dynamic-sdk/blob/main/CONTRIBUTING.md) for details.
+This package is written in TypeScript and provides full type definitions. Enable strict mode in your `tsconfig.json` for the best experience:
 
-## 📄 License
+```json
+{
+  "compilerOptions": {
+    "strict": true
+  }
+}
+```
+
+## Resources
 
-This package is part of the Dynamic SDK and follows the same licensing terms. See [LICENSE](https://github.com/dynamic-labs/dynamic-sdk/blob/main/LICENSE) for details.
+- **TronWallet Adapter Docs**: https://walletadapter.org/docs/
+- **Dynamic Docs**: https://docs.dynamic.xyz
+- **TronWeb Docs**: https://developers.tron.network/docs
+- **Tron Network**: https://tron.network
 
-## 🆘 Support
+## Support
 
 - **Documentation**: [docs.dynamic.xyz](https://docs.dynamic.xyz)
 - **GitHub Issues**: [Report bugs or request features](https://github.com/dynamic-labs/dynamic-sdk/issues)
 - **Discord**: [Join our community](https://discord.gg/dynamic)
 
+## License
+
+This package is part of the Dynamic SDK and follows the same licensing terms. See [LICENSE](../../LICENSE) for details.
+
 ---
 
 **Built with ❤️ by the Dynamic Labs team**

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/tron",
-  "version": "4.39.0",
+  "version": "4.40.1",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,12 +18,14 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/assert-package-version": "4.39.0",
+    "@dynamic-labs/assert-package-version": "4.40.1",
+    "@tronweb3/tronwallet-abstract-adapter": "1.1.9",
+    "@tronweb3/tronwallet-adapters": "1.2.14",
     "tronweb": "6.0.4",
-    "@dynamic-labs/types": "4.39.0",
-    "@dynamic-labs/utils": "4.39.0",
-    "@dynamic-labs/wallet-book": "4.39.0",
-    "@dynamic-labs/wallet-connector-core": "4.39.0"
+    "@dynamic-labs/types": "4.40.1",
+    "@dynamic-labs/utils": "4.40.1",
+    "@dynamic-labs/wallet-book": "4.40.1",
+    "@dynamic-labs/wallet-connector-core": "4.40.1"
   },
   "peerDependencies": {}
 }

package/src/connectors/BitgetTronConnector/BitgetTronConnector.cjs

@@ -3,17 +3,17 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var TronWalletConnector = require('../TronWalletConnector/TronWalletConnector.cjs');
+var tronwalletAdapters = require('@tronweb3/tronwallet-adapters');
+var TronWalletAdapterConnector = require('../TronWalletAdapterConnector/TronWalletAdapterConnector.cjs');
 
-class BitgetTronConnector extends TronWalletConnector.TronWalletConnector {
+class BitgetTronConnector extends TronWalletAdapterConnector.TronWalletAdapterConnector {
     constructor() {
         super(...arguments);
         this.name = 'Bitget Wallet';
         this.overrideKey = 'bitgettron';
     }
-    getProvider() {
-        var _a;
-        return (_a = window.bitkeep) === null || _a === void 0 ? void 0 : _a.tron;
+    createAdapter() {
+        return new tronwalletAdapters.BitKeepAdapter();
     }
 }
 

package/src/connectors/BitgetTronConnector/BitgetTronConnector.d.ts

@@ -1,7 +1,7 @@
-import type { ITronProvider } from '../../types';
-import { TronWalletConnector } from '../TronWalletConnector';
-export declare class BitgetTronConnector extends TronWalletConnector {
+import { BitKeepAdapter } from '@tronweb3/tronwallet-adapters';
+import { TronWalletAdapterConnector } from '../TronWalletAdapterConnector';
+export declare class BitgetTronConnector extends TronWalletAdapterConnector {
     name: string;
     overrideKey: string;
-    getProvider(): ITronProvider | undefined;
+    protected createAdapter(): BitKeepAdapter;
 }

package/src/connectors/BitgetTronConnector/BitgetTronConnector.js

@@ -1,15 +1,15 @@
 'use client'
-import { TronWalletConnector } from '../TronWalletConnector/TronWalletConnector.js';
+import { BitKeepAdapter } from '@tronweb3/tronwallet-adapters';
+import { TronWalletAdapterConnector } from '../TronWalletAdapterConnector/TronWalletAdapterConnector.js';
 
-class BitgetTronConnector extends TronWalletConnector {
+class BitgetTronConnector extends TronWalletAdapterConnector {
     constructor() {
         super(...arguments);
         this.name = 'Bitget Wallet';
         this.overrideKey = 'bitgettron';
     }
-    getProvider() {
-        var _a;
-        return (_a = window.bitkeep) === null || _a === void 0 ? void 0 : _a.tron;
+    createAdapter() {
+        return new BitKeepAdapter();
     }
 }
 

package/src/connectors/OKXTronConnector/OKXTronConnector.cjs

@@ -3,17 +3,17 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var TronWalletConnector = require('../TronWalletConnector/TronWalletConnector.cjs');
+var tronwalletAdapters = require('@tronweb3/tronwallet-adapters');
+var TronWalletAdapterConnector = require('../TronWalletAdapterConnector/TronWalletAdapterConnector.cjs');
 
-class OKXTronConnector extends TronWalletConnector.TronWalletConnector {
+class OKXTronConnector extends TronWalletAdapterConnector.TronWalletAdapterConnector {
     constructor() {
         super(...arguments);
         this.name = 'OKX Wallet';
         this.overrideKey = 'okxtron';
     }
-    getProvider() {
-        var _a;
-        return (_a = window.okxwallet) === null || _a === void 0 ? void 0 : _a.tronLink;
+    createAdapter() {
+        return new tronwalletAdapters.OkxWalletAdapter();
     }
 }
 

package/src/connectors/OKXTronConnector/OKXTronConnector.d.ts

@@ -1,7 +1,7 @@
-import type { ITronProvider } from '../../types';
-import { TronWalletConnector } from '../TronWalletConnector';
-export declare class OKXTronConnector extends TronWalletConnector {
+import { OkxWalletAdapter } from '@tronweb3/tronwallet-adapters';
+import { TronWalletAdapterConnector } from '../TronWalletAdapterConnector';
+export declare class OKXTronConnector extends TronWalletAdapterConnector {
     name: string;
     overrideKey: string;
-    getProvider(): ITronProvider | undefined;
+    protected createAdapter(): OkxWalletAdapter;
 }

package/src/connectors/OKXTronConnector/OKXTronConnector.js

@@ -1,15 +1,15 @@
 'use client'
-import { TronWalletConnector } from '../TronWalletConnector/TronWalletConnector.js';
+import { OkxWalletAdapter } from '@tronweb3/tronwallet-adapters';
+import { TronWalletAdapterConnector } from '../TronWalletAdapterConnector/TronWalletAdapterConnector.js';
 
-class OKXTronConnector extends TronWalletConnector {
+class OKXTronConnector extends TronWalletAdapterConnector {
     constructor() {
         super(...arguments);
         this.name = 'OKX Wallet';
         this.overrideKey = 'okxtron';
     }
-    getProvider() {
-        var _a;
-        return (_a = window.okxwallet) === null || _a === void 0 ? void 0 : _a.tronLink;
+    createAdapter() {
+        return new OkxWalletAdapter();
     }
 }
 

package/src/connectors/TokenPocketTronConnector/TokenPocketTronConnector.cjs

@@ -3,25 +3,17 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var TronWalletConnector = require('../TronWalletConnector/TronWalletConnector.cjs');
-require('../../../_virtual/_tslib.cjs');
-require('@dynamic-labs/utils');
-require('@dynamic-labs/wallet-connector-core');
-var detectTronNetworkFromProvider = require('../../utils/detectTronNetworkFromProvider.cjs');
+var tronwalletAdapters = require('@tronweb3/tronwallet-adapters');
+var TronWalletAdapterConnector = require('../TronWalletAdapterConnector/TronWalletAdapterConnector.cjs');
 
-class TokenPocketTronConnector extends TronWalletConnector.TronWalletConnector {
+class TokenPocketTronConnector extends TronWalletAdapterConnector.TronWalletAdapterConnector {
     constructor() {
         super(...arguments);
         this.name = 'TokenPocket';
         this.overrideKey = 'tokenpockettron';
     }
-    getProvider() {
-        var _a;
-        const provider = (_a = window.tokenpocket) === null || _a === void 0 ? void 0 : _a.tron;
-        if (!provider) {
-            return undefined;
-        }
-        return detectTronNetworkFromProvider.detectTronNetworkFromProvider(provider);
+    createAdapter() {
+        return new tronwalletAdapters.TokenPocketAdapter();
     }
 }
 

package/src/connectors/TokenPocketTronConnector/TokenPocketTronConnector.d.ts

@@ -1,7 +1,7 @@
-import type { ITronProvider } from '../../types';
-import { TronWalletConnector } from '../TronWalletConnector';
-export declare class TokenPocketTronConnector extends TronWalletConnector {
+import { TokenPocketAdapter } from '@tronweb3/tronwallet-adapters';
+import { TronWalletAdapterConnector } from '../TronWalletAdapterConnector';
+export declare class TokenPocketTronConnector extends TronWalletAdapterConnector {
     name: string;
     overrideKey: string;
-    getProvider(): ITronProvider | undefined;
+    protected createAdapter(): TokenPocketAdapter;
 }

package/src/connectors/TokenPocketTronConnector/TokenPocketTronConnector.js

@@ -1,23 +1,15 @@
 'use client'
-import { TronWalletConnector } from '../TronWalletConnector/TronWalletConnector.js';
-import '../../../_virtual/_tslib.js';
-import '@dynamic-labs/utils';
-import '@dynamic-labs/wallet-connector-core';
-import { detectTronNetworkFromProvider } from '../../utils/detectTronNetworkFromProvider.js';
+import { TokenPocketAdapter } from '@tronweb3/tronwallet-adapters';
+import { TronWalletAdapterConnector } from '../TronWalletAdapterConnector/TronWalletAdapterConnector.js';
 
-class TokenPocketTronConnector extends TronWalletConnector {
+class TokenPocketTronConnector extends TronWalletAdapterConnector {
     constructor() {
         super(...arguments);
         this.name = 'TokenPocket';
         this.overrideKey = 'tokenpockettron';
     }
-    getProvider() {
-        var _a;
-        const provider = (_a = window.tokenpocket) === null || _a === void 0 ? void 0 : _a.tron;
-        if (!provider) {
-            return undefined;
-        }
-        return detectTronNetworkFromProvider(provider);
+    createAdapter() {
+        return new TokenPocketAdapter();
     }
 }