pwc-sdk-wallet 0.7.7 → 0.7.9

package/README.md

@@ -31,20 +31,30 @@ A comprehensive, secure, and user-friendly wallet SDK for React Native applicati
 - [Account Management](#account-management)
    - [Add New HD Account](#add-new-hd-account)
    - [Add New Solana Account](#add-new-solana-account)
+   - [Add New TRON Account](#add-new-tron-account)
    - [Import Account](#import-account)
    - [Get Accounts](#get-accounts)
 - [Balance & Token Functions](#balance--token-functions)
    - [Get Native Balance](#get-native-balance)
    - [Get Token Balance](#get-token-balance)
    - [Get Token Info](#get-token-info)
+   - [Get SPL Token Balance (Solana)](#get-spl-token-balance)
+   - [Get SPL Token Info (Solana)](#get-spl-token-info)
+   - [Estimate SPL Token Transfer Fee](#estimate-spl-token-transfer-fee)
+   - [Popular Solana SPL Tokens](#popular-solana-spl-tokens)
 - [Transaction Functions](#transaction-functions)
    - [Send Native Token](#send-native-token)
    - [Send Token](#send-token)
+   - [Send SPL Token (Solana)](#send-spl-token-solana)
+   - [Send TRX (TRON)](#send-trx-tron)
+   - [Send TRC-20 Token (TRON)](#send-trc-20-token-tron)
+   - [Popular TRON TRC-20 Tokens](#popular-tron-trc-20-tokens)
    - [Export Mnemonic](#export-mnemonic)
 
 ### 🔄 Multi-Transfer Operations
 - [Batch Send Native Tokens](#batch-send-native-tokens)
 - [Batch Send ERC-20 Tokens](#batch-send-erc-20-tokens)
+- [Multi-Transfer (Batch Send) - Simple Usage](#multi-transfer-batch-send---simple-usage)
 
 ### 📱 QR Code Functionality
 - [Generate Address QR](#generate-address-qr)
@@ -76,6 +86,9 @@ A comprehensive, secure, and user-friendly wallet SDK for React Native applicati
 - [React Native NFT Component Example](#react-native-nft-component-example)
 - [Get Owned NFTs](#get-owned-nfts)
 - [Transfer NFT](#transfer-nft)
+- [Transfer Solana NFT](#transfer-solana-nft)
+- [Get Solana NFT Balance](#get-solana-nft-balance)
+- [Get Solana NFT Details](#get-solana-nft-details)
 - [Estimate NFT Transfer Gas](#estimate-nft-transfer-gas)
 
 ### ⛽ Advanced Features
@@ -122,7 +135,26 @@ A comprehensive, secure, and user-friendly wallet SDK for React Native applicati
 ### 🛠️ Development
 - [Contributing](#contributing)
 
+### 🔥 New API: Simple chainId-based usage
+- [Simple chainId-based usage](#new-api-simple-chainid-based-usage)
+
+### 📱 QR Code Functionality
+- [Generate Address QR](#generate-address-qr)
+- [Generate Mnemonic QR](#generate-mnemonic-qr)
+- [Generate Transaction QR](#generate-transaction-qr)
+- [Import Wallet from QR](#import-wallet-from-qr)
+- [Process Transaction from QR](#process-transaction-from-qr)
+- [Validate QR Code](#validate-qr-code)
+- [Generate EIP-681 Compatible Address QR](#generate-eip-681-compatible-address-qr-for-metamask-binance-trust-wallet)
+
 ### 🛠️ Advanced Transaction Utilities
+- [Build Generic Transaction](#build-generic-transaction)
+- [Sign Transaction (Vault)](#sign-transaction-recommended---using-vault)
+- [Sign Transaction (Private Key)](#sign-transaction-deprecated---using-private-key)
+- [Send Raw Transaction](#send-raw-transaction)
+- [Approve Token (Vault)](#approve-token-recommended---using-vault)
+- [Approve Token (Private Key)](#approve-token-deprecated---using-private-key)
+- [Track Transaction Status](#track-transaction-status)
 
 ### Build Generic Transaction
 Builds an unsigned transaction for any contract method.
@@ -975,7 +1007,7 @@ The PWC Wallet SDK with direct provider injection provides **universal dApp comp
 
 #### ✅ **One Setup, Universal Access:**
 ```typescript
-// Mobile dev chỉ cần setup 1 lần
+// Mobile developers only need to setup once
 <DAppBrowser
   vault={vault}
   initialUrl="https://pancakeswap.finance/"
@@ -1194,7 +1226,7 @@ Transfers an NFT (ERC-721) from one address to another.
 - `tokenId` - Token ID to transfer (string)
 
 ```typescript
-// Gửi NFT ERC-721 từ ví này sang ví khác
+// Send ERC-721 NFT from this wallet to another wallet
 const tx = await vault.transferNFT(
   '0xSenderAddress',
   '0xRecipientAddress',
@@ -1204,7 +1236,88 @@ const tx = await vault.transferNFT(
 console.log('NFT transfer tx hash:', tx.hash);
 ```
 
-> **Note:** Hiện tại chỉ hỗ trợ EVM chains (Ethereum, BSC, v.v.). Solana NFT transfer chưa được hỗ trợ.
+> **Note:** Currently supports EVM chains (Ethereum, BSC, etc.) and Solana NFTs. Solana NFT transfers are now fully supported!
+
+#### Transfer Solana NFT
+Transfers a Solana NFT from one address to another using the dedicated Solana NFT method.
+
+**Parameters:**
+- `fromAddress` - Sender's address
+- `toAddress` - Recipient's address
+- `mintAddress` - The NFT mint address
+- `commitment` - Optional commitment level (default: 'confirmed')
+
+```typescript
+// Transfer a Solana NFT
+const tx = await vault.transferSolanaNFT(
+  '0xYourAddress...',
+  '0xRecipient...',
+  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v' // NFT mint address
+);
+console.log('Solana NFT transfer hash:', tx.hash);
+
+// With custom commitment level
+const txFast = await vault.transferSolanaNFT(
+  '0xYourAddress...',
+  '0xRecipient...',
+  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+  'processed' // Fastest confirmation
+);
+```
+
+#### Get Solana NFT Balance
+Gets Solana NFT balance for a specific address.
+
+**Parameters:**
+- `address` - Wallet address to check balance for
+- `mintAddress` - The NFT mint address
+- `commitment` - Optional commitment level (default: 'confirmed')
+
+```typescript
+// Check if you own a specific Solana NFT
+const balance = await vault.getSolanaNFTBalance(
+  '0xYourAddress...',
+  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
+);
+
+if (balance.count > 0) {
+  console.log('You own this NFT!');
+} else {
+  console.log('You do not own this NFT');
+}
+```
+
+#### Get Solana NFT Details
+Gets detailed Solana NFT information with metadata.
+
+**Parameters:**
+- `mintAddress` - The NFT mint address
+- `options` - Query options for additional data
+- `commitment` - Optional commitment level (default: 'confirmed')
+
+```typescript
+// Get basic Solana NFT information
+const nftDetail = await vault.getSolanaNFTDetail(
+  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
+);
+console.log('NFT Name:', nftDetail.name);
+console.log('Owner:', nftDetail.owner);
+console.log('Token Type:', nftDetail.tokenType); // 'SPL-NFT'
+
+// Get extended information with metadata
+const nftDetailExtended = await vault.getSolanaNFTDetail(
+  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+  { 
+    includeMetadata: true, 
+    includeHistory: true,
+    includeCollection: true 
+  }
+);
+console.log('Description:', nftDetailExtended.description);
+console.log('Image URL:', nftDetailExtended.image);
+console.log('Attributes:', nftDetailExtended.attributes);
+console.log('Transaction History:', nftDetailExtended.transactionHistory);
+```
 
 ---
 
@@ -1360,7 +1473,7 @@ console.log('ERC-1155 transfer gas:', erc1155TransferGas.toString());
 
 - 🔐 **Secure HD Wallet Management**: BIP-44 compliant hierarchical deterministic wallets
 - 🎯 **Vanity Address Generation**: Generate wallets with custom address prefixes
-- 🔗 **Multi-Chain Support**: Ethereum, BSC, Polygon, Arbitrum, Optimism, Base, and Solana
+- 🔗 **Multi-Chain Support**: Ethereum, BSC, Polygon, Arbitrum, Optimism, Base, Solana, and TRON
 - 🚀 **Multi-Transfer Operations**: Batch send tokens to multiple recipients
 - 🔧 **Custom Chain Support**: Add custom chains and override built-in configurations
 - 📱 **React Native Optimized**: Designed specifically for mobile applications
@@ -1427,6 +1540,13 @@ const { vault, encryptedVault } = await Vault.createFromMnemonic(
   'solana'
 );
 
+// For TRON
+const { vault, encryptedVault } = await Vault.createFromMnemonic(
+  existingMnemonic, 
+  'your-secure-password', 
+  'tron'
+);
+
 // Get wallet accounts
 const accounts = vault.getAccounts();
 console.log('Imported wallet addresses:', accounts.map(acc => acc.address));
@@ -1679,6 +1799,13 @@ const newSolanaAccount = vault.addSolanaAccount();
 console.log('New Solana account:', newSolanaAccount.address);
 ```
 
+#### Add New TRON Account
+```typescript
+// Add a new TRON account
+const newTronAccount = vault.addNewTronAccount();
+console.log('New TRON account:', newTronAccount.address);
+```
+
 #### Import Account
 ```typescript
 // Import an existing account with private key
@@ -1727,9 +1854,175 @@ console.log('Transaction hash:', tx.hash);
 
 #### Send Token
 ```typescript
-// Send ERC-20 tokens
+// Send ERC-20 tokens on EVM chains
 const tx = await vault.sendToken(from, to, amount, tokenAddress, '1');
 console.log('Transaction hash:', tx.hash);
+
+// Send SPL tokens on Solana
+const solanaTx = await vault.sendSPLToken(
+  from, 
+  to, 
+  amount, 
+  tokenAddress // SPL token mint address
+);
+console.log('Solana transaction hash:', solanaTx.hash);
+```
+
+#### Send SPL Token (Solana)
+```typescript
+// Send USDC on Solana
+const usdcTx = await vault.sendSPLToken(
+  '0xYourAddress...',
+  '0xRecipient...',
+  '100', // 100 USDC
+  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v' // USDC mint address
+);
+
+// Send USDT on Solana
+const usdtTx = await vault.sendSPLToken(
+  '0xYourAddress...',
+  '0xRecipient...',
+  '50', // 50 USDT
+  'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB' // USDT mint address
+);
+
+// Get SPL token balance
+const usdcBalance = await vault.getSPLTokenBalance(
+  '0xYourAddress...',
+  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
+);
+console.log('USDC Balance:', usdcBalance.toString());
+
+// Get SPL token information
+const tokenInfo = await vault.getSPLTokenInfo(
+  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
+);
+console.log('Token:', tokenInfo.name, '(', tokenInfo.symbol, ')');
+console.log('Decimals:', tokenInfo.decimals);
+
+// Estimate SPL token transfer fee
+const transferFee = await vault.estimateSPLTokenTransferFee(
+  '0xYourAddress...',
+  '0xRecipient...',
+  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
+);
+console.log('Estimated fee:', transferFee.toString(), 'lamports');
+```
+
+#### Popular Solana SPL Tokens
+
+**Mainnet Token Addresses:**
+```typescript
+// USDC (USD Coin)
+const USDC_MINT = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
+
+// USDT (Tether)
+const USDT_MINT = 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB';
+
+// BONK (Bonk)
+const BONK_MINT = 'DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263';
+
+// JUP (Jupiter)
+const JUP_MINT = 'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN';
+```
+
+**Devnet Token Addresses (for testing):**
+```typescript
+// USDC Devnet
+const USDC_DEVNET = '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU';
+
+// USDT Devnet  
+const USDT_DEVNET = 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB';
+```
+
+#### Send TRX (TRON)
+```typescript
+// Send native TRX
+const tx = await vault.sendTRX(from, to, '1.5');
+console.log('Transaction hash:', tx.hash);
+
+// Get TRX balance
+const balance = await vault.getTRXBalance(address);
+console.log('TRX Balance:', TronChainService.sunToTrx(balance.toString()));
+```
+
+#### Send TRC-20 Token (TRON)
+```typescript
+// Send USDT on TRON
+const usdtTx = await vault.sendTRC20Token(
+  'TYourAddress...',
+  'TRecipient...',
+  '100', // 100 USDT
+  'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t' // USDT contract address
+);
+
+// Send USDC on TRON
+const usdcTx = await vault.sendTRC20Token(
+  'TYourAddress...',
+  'TRecipient...',
+  '50', // 50 USDC
+  'TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8' // USDC contract address
+);
+
+// Get TRC-20 token balance
+const usdtBalance = await vault.getTRC20TokenBalance(
+  'TYourAddress...',
+  'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
+);
+console.log('USDT Balance:', usdtBalance.toString());
+
+// Get TRC-20 token information
+const tokenInfo = await vault.getTRC20TokenInfo(
+  'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
+);
+console.log('Token:', tokenInfo.name, '(', tokenInfo.symbol, ')');
+console.log('Decimals:', tokenInfo.decimals);
+
+// Estimate TRX transfer fee
+const trxFee = await vault.estimateTRXTransferFee(
+  'TYourAddress...',
+  'TRecipient...',
+  '1.5'
+);
+console.log('Estimated TRX fee:', TronChainService.sunToTrx(trxFee.toString()), 'TRX');
+
+// Estimate TRC-20 transfer fee
+const tokenFee = await vault.estimateTRC20TransferFee(
+  'TYourAddress...',
+  'TRecipient...',
+  '100',
+  'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
+);
+console.log('Estimated token fee:', TronChainService.sunToTrx(tokenFee.toString()), 'TRX');
+```
+
+#### Popular TRON TRC-20 Tokens
+
+**Mainnet Token Addresses:**
+```typescript
+// USDT (Tether USD)
+const USDT_TRC20 = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
+
+// USDC (USD Coin)
+const USDC_TRC20 = 'TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8';
+
+// USDD (Decentralized USD)
+const USDD_TRC20 = 'TPYmHEhy5n8TCEfYGqW2rPxsghSfzghPDn';
+
+// JST (JUST)
+const JST_TRC20 = 'TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9';
+
+// WIN (WINkLink)
+const WIN_TRC20 = 'TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7';
+```
+
+**Shasta Testnet Token Addresses (for testing):**
+```typescript
+// USDT Shasta
+const USDT_SHASTA = 'TG3XXyExBkPp9nzdajDZsozEu1kkaAzc3X';
+
+// USDC Shasta
+const USDC_SHASTA = 'TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBZ';
 ```
 
 #### Export Mnemonic
@@ -1745,7 +2038,7 @@ console.log('Mnemonic:', mnemonic);
 ```typescript
 import { MultiTransferService } from 'pwc-wallet-sdk';
 
-const multiTransferService = new MultiTransferService(vault, chainService, '1'); // '1' là chainId cho Ethereum mainnet
+const multiTransferService = new MultiTransferService(vault, chainService, '1'); // '1' is chainId for Ethereum mainnet
 const recipients = [
   { address: '0x1111...', amount: '0.01' },
   { address: '0x2222...', amount: '0.02' },
@@ -2148,7 +2441,7 @@ const balance = await getTokenBalance('0xToken...', '0x123...', '1');
 ### Example: MultiTransfer
 ```ts
 import { MultiTransferService } from 'pwc-wallet-sdk';
-const service = new MultiTransferService(vault, chainService, '1'); // truyền chainId rõ ràng
+const service = new MultiTransferService(vault, chainService, '1'); // pass chainId explicitly
 await service.transferNativeTokens('0x123...', [{ address: '0xabc...', amount: '0.1' }], '1');
 ```
 

package/dist/Vault.d.ts

@@ -1,10 +1,10 @@
 import { type EncryptedData } from './crypto/EncryptionService';
 import { type ChainId } from './config/chains';
 import { Recipient, MultiTransferResult } from './types/multiTransfer';
-import { NFTDetailExtended, NFTOptions } from './types/nft';
+import { NFTDetailExtended, NFTBalance, NFTOptions } from './types/nft';
 export interface Account {
     address: string;
-    type: 'HD' | 'Simple' | 'Solana';
+    type: 'HD' | 'Simple' | 'Solana' | 'Tron';
     name: string;
 }
 export interface TransactionResponse {
@@ -51,11 +51,11 @@ export declare class Vault {
     /**
      * Creates a new Vault with a fresh mnemonic.
      * @param password - The password used to encrypt the vault data
-     * @param chainType - The type of blockchain to support ('evm' for Ethereum-compatible chains or 'solana' for Solana). Defaults to 'evm'
+     * @param chainType - The type of blockchain to support ('evm' for Ethereum-compatible chains, 'solana' for Solana, or 'tron' for TRON). Defaults to 'evm'
      * @returns Promise resolving to an object containing the created vault instance and its encrypted data
      * @throws Error if mnemonic generation or keyring initialization fails
      */
-    static createNew(password: string, chainType?: 'evm' | 'solana', config?: VaultConfig): Promise<{
+    static createNew(password: string, chainType?: 'evm' | 'solana' | 'tron', config?: VaultConfig): Promise<{
         vault: Vault;
         encryptedVault: EncryptedData;
     }>;
@@ -63,11 +63,11 @@ export declare class Vault {
      * Creates a new Vault from an existing mnemonic phrase.
      * @param mnemonic - The existing mnemonic phrase (12, 15, 18, 21, or 24 words)
      * @param password - The password used to encrypt the vault data
-     * @param chainType - The type of blockchain to support ('evm' for Ethereum-compatible chains or 'solana' for Solana). Defaults to 'evm'
+     * @param chainType - The type of blockchain to support ('evm' for Ethereum-compatible chains, 'solana' for Solana, or 'tron' for TRON). Defaults to 'evm'
      * @returns Promise resolving to an object containing the created vault instance and its encrypted data
      * @throws Error if mnemonic is invalid or keyring initialization fails
      */
-    static createFromMnemonic(mnemonic: string, password: string, chainType?: 'evm' | 'solana', config?: VaultConfig): Promise<{
+    static createFromMnemonic(mnemonic: string, password: string, chainType?: 'evm' | 'solana' | 'tron', config?: VaultConfig): Promise<{
         vault: Vault;
         encryptedVault: EncryptedData;
     }>;
@@ -91,6 +91,12 @@ export declare class Vault {
      * @throws Error if no Solana keyring is available in the vault
      */
     addNewSolanaAccount(): Promise<Account>;
+    /**
+     * Adds a new TRON account derived from the TRON keyring.
+     * @returns Promise resolving to the newly created TRON account information
+     * @throws Error if no TRON keyring is available in the vault
+     */
+    addNewTronAccount(): Promise<Account>;
     /**
      * Imports an account from a private key and adds it to the vault.
      * @param privateKey - The private key to import (hex string without '0x' prefix for EVM, base58 for Solana)
@@ -150,6 +156,96 @@ export declare class Vault {
      * @throws Error if insufficient balance, invalid addresses, or transaction fails
      */
     sendToken(fromAddress: string, to: string, amount: string, tokenAddress: string, chainId: ChainId): Promise<TransactionResponse>;
+    /**
+     * Sends SPL tokens on Solana blockchain with enhanced validation and error handling.
+     * This method is specifically designed for Solana SPL token transfers.
+     * @param fromAddress - The sender's account address
+     * @param to - The recipient's address
+     * @param amount - The amount of tokens to send as a string
+     * @param tokenAddress - The SPL token mint address
+     * @param commitment - Optional commitment level for the transaction (default: 'confirmed')
+     * @returns Promise resolving to the transaction response with hash and details
+     * @throws Error if insufficient balance, invalid addresses, or transaction fails
+     *
+     * @example
+     * ```typescript
+     * // Send USDC on Solana
+     * const tx = await vault.sendSPLToken(
+     *   '0xYourAddress...',
+     *   '0xRecipient...',
+     *   '100', // 100 USDC
+     *   'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v' // USDC mint address
+     * );
+     * ```
+     */
+    sendSPLToken(fromAddress: string, to: string, amount: string, tokenAddress: string, commitment?: 'processed' | 'confirmed' | 'finalized'): Promise<TransactionResponse>;
+    /**
+     * Gets SPL token balance for a specific address on Solana.
+     * @param address - The account address to check balance for
+     * @param tokenAddress - The SPL token mint address
+     * @param commitment - Optional commitment level (default: 'confirmed')
+     * @returns Promise resolving to the token balance as a bigint
+     * @throws Error if the balance query fails
+     */
+    getSPLTokenBalance(address: string, tokenAddress: string, commitment?: 'processed' | 'confirmed' | 'finalized'): Promise<bigint>;
+    /**
+     * Gets SPL token information on Solana.
+     * @param tokenAddress - The SPL token mint address
+     * @param commitment - Optional commitment level (default: 'confirmed')
+     * @returns Promise resolving to token metadata
+     * @throws Error if the token info query fails
+     */
+    getSPLTokenInfo(tokenAddress: string, commitment?: 'processed' | 'confirmed' | 'finalized'): Promise<Token>;
+    /**
+     * Estimates the transaction fee for SPL token transfers on Solana.
+     * @param fromAddress - The sender's account address
+     * @param to - The recipient's address
+     * @param tokenAddress - The SPL token mint address
+     * @param commitment - Optional commitment level (default: 'confirmed')
+     * @returns Promise resolving to the estimated fee as a bigint in lamports
+     * @throws Error if the fee estimation fails
+     */
+    estimateSPLTokenTransferFee(fromAddress: string, to: string, tokenAddress: string, commitment?: 'processed' | 'confirmed' | 'finalized'): Promise<bigint>;
+    /**
+     * Transfers a Solana NFT from one address to another.
+     * This method is specifically designed for Solana NFT transfers.
+     * @param fromAddress - The sender's account address
+     * @param toAddress - The recipient's address
+     * @param mintAddress - The NFT mint address
+     * @param commitment - Optional commitment level for the transaction (default: 'confirmed')
+     * @returns Promise resolving to the transaction response with hash and details
+     * @throws Error if insufficient balance, invalid addresses, or transaction fails
+     *
+     * @example
+     * ```typescript
+     * // Transfer a Solana NFT
+     * const tx = await vault.transferSolanaNFT(
+     *   '0xYourAddress...',
+     *   '0xRecipient...',
+     *   'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v' // NFT mint address
+     * );
+     * console.log('NFT transfer hash:', tx.hash);
+     * ```
+     */
+    transferSolanaNFT(fromAddress: string, toAddress: string, mintAddress: string, commitment?: 'processed' | 'confirmed' | 'finalized'): Promise<TransactionResponse>;
+    /**
+     * Gets Solana NFT balance for a specific address.
+     * @param address - Wallet address to check balance for
+     * @param mintAddress - The NFT mint address
+     * @param commitment - Optional commitment level (default: 'confirmed')
+     * @returns Promise resolving to the NFT balance
+     * @throws Error if the balance query fails
+     */
+    getSolanaNFTBalance(address: string, mintAddress: string, commitment?: 'processed' | 'confirmed' | 'finalized'): Promise<NFTBalance>;
+    /**
+     * Gets detailed Solana NFT information with metadata.
+     * @param mintAddress - The NFT mint address
+     * @param options - Query options for additional data
+     * @param commitment - Optional commitment level (default: 'confirmed')
+     * @returns Promise resolving to extended NFT detail
+     * @throws Error if the NFT query fails
+     */
+    getSolanaNFTDetail(mintAddress: string, options?: NFTOptions, commitment?: 'processed' | 'confirmed' | 'finalized'): Promise<NFTDetailExtended>;
     /**
      * Generates a vanity HD wallet with a specific address prefix.
      * Uses default configuration from VANITY_WALLET_CONFIG for optimal settings.
@@ -490,4 +586,82 @@ export declare class Vault {
      * ```
      */
     sendNativeToken(fromAddress: string, to: string, amount: string, chainId: ChainId): Promise<TransactionResponse>;
+    /**
+     * Sends TRX (native TRON token) to another address.
+     * @param fromAddress - The sender's TRON address
+     * @param to - The recipient's TRON address
+     * @param amount - The amount of TRX to send as a string (e.g., "1.5")
+     * @returns Promise resolving to the transaction response with hash and details
+     * @throws Error if the transaction fails or recipient address is invalid
+     *
+     * @example
+     * ```typescript
+     * // Send 1.5 TRX
+     * const tx = await vault.sendTRX(from, to, '1.5');
+     * console.log('Transaction hash:', tx.hash);
+     * ```
+     */
+    sendTRX(fromAddress: string, to: string, amount: string): Promise<TransactionResponse>;
+    /**
+     * Sends TRC-20 tokens on TRON blockchain.
+     * @param fromAddress - The sender's TRON address
+     * @param to - The recipient's TRON address
+     * @param amount - The amount of tokens to send as a string
+     * @param tokenAddress - The TRC-20 token contract address
+     * @returns Promise resolving to the transaction response with hash and details
+     * @throws Error if insufficient balance, invalid addresses, or transaction fails
+     *
+     * @example
+     * ```typescript
+     * // Send USDT on TRON
+     * const tx = await vault.sendTRC20Token(
+     *   'TYourAddress...',
+     *   'TRecipient...',
+     *   '100', // 100 USDT
+     *   'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t' // USDT contract address
+     * );
+     * ```
+     */
+    sendTRC20Token(fromAddress: string, to: string, amount: string, tokenAddress: string): Promise<TransactionResponse>;
+    /**
+     * Gets TRX balance for a specific address on TRON.
+     * @param address - The TRON address to check balance for
+     * @returns Promise resolving to the TRX balance as a bigint in SUN
+     * @throws Error if the balance query fails
+     */
+    getTRXBalance(address: string): Promise<bigint>;
+    /**
+     * Gets TRC-20 token balance for a specific address on TRON.
+     * @param address - The TRON address to check balance for
+     * @param tokenAddress - The TRC-20 token contract address
+     * @returns Promise resolving to the token balance as a bigint
+     * @throws Error if the balance query fails
+     */
+    getTRC20TokenBalance(address: string, tokenAddress: string): Promise<bigint>;
+    /**
+     * Gets TRC-20 token information.
+     * @param tokenAddress - The TRC-20 token contract address
+     * @returns Promise resolving to the token information
+     * @throws Error if the token query fails
+     */
+    getTRC20TokenInfo(tokenAddress: string): Promise<Token>;
+    /**
+     * Estimates the transaction fee for a TRX transfer.
+     * @param fromAddress - The sender's TRON address
+     * @param to - The recipient's TRON address
+     * @param amount - The amount of TRX to send
+     * @returns Promise resolving to the estimated fee in SUN
+     * @throws Error if the estimation fails
+     */
+    estimateTRXTransferFee(fromAddress: string, to: string, amount: string): Promise<bigint>;
+    /**
+     * Estimates the transaction fee for a TRC-20 token transfer.
+     * @param fromAddress - The sender's TRON address
+     * @param to - The recipient's TRON address
+     * @param amount - The amount of tokens to send
+     * @param tokenAddress - The TRC-20 token contract address
+     * @returns Promise resolving to the estimated fee in SUN
+     * @throws Error if the estimation fails
+     */
+    estimateTRC20TransferFee(fromAddress: string, to: string, amount: string, tokenAddress: string): Promise<bigint>;
 }