pwc-sdk-wallet 0.7.9 → 0.8.0

package/README.md

@@ -1795,7 +1795,7 @@ console.log('New account address:', newAccount.address);
 #### Add New Solana Account
 ```typescript
 // Add a new Solana account
-const newSolanaAccount = vault.addSolanaAccount();
+const newSolanaAccount = await vault.addNewSolanaAccount();
 console.log('New Solana account:', newSolanaAccount.address);
 ```
 
@@ -1827,6 +1827,14 @@ console.log('All accounts:', accounts.map(acc => acc.address));
 // Get native token balance (ETH, BNB, MATIC, etc.)
 const balance = await vault.getNativeBalance(address, '1'); // Ethereum
 console.log('ETH Balance:', ethers.formatEther(balance));
+
+// Get SOL balance on Solana
+const solBalance = await vault.getNativeBalance(address, 'solana');
+console.log('SOL Balance:', solBalance.toString(), 'lamports');
+
+// Get TRX balance on TRON
+const trxBalance = await vault.getNativeBalance(address, 'tron');
+console.log('TRX Balance:', trxBalance.toString(), 'SUN');
 ```
 
 #### Get Token Balance
@@ -1847,9 +1855,17 @@ console.log('Token:', tokenInfo.name, '(', tokenInfo.symbol, ')');
 
 #### Send Native Token
 ```typescript
-// Send native tokens (ETH, BNB, etc.)
-const tx = await vault.sendNativeToken(from, to, amount, '1');
+// Send native tokens (ETH, BNB, etc.) on EVM chains
+const tx = await vault.sendNativeToken(from, to, amount, '1'); // Ethereum
 console.log('Transaction hash:', tx.hash);
+
+// Send SOL on Solana
+const solTx = await vault.sendNativeToken(from, to, amount, 'solana');
+console.log('Solana transaction hash:', solTx.hash);
+
+// Send TRX on TRON
+const trxTx = await vault.sendNativeToken(from, to, amount, 'tron');
+console.log('TRON transaction hash:', trxTx.hash);
 ```
 
 #### Send Token
@@ -2085,7 +2101,8 @@ console.log('Token transfers completed:', result.successfulCount);
 ```typescript
 import { Vault, type VaultConfig } from 'pwc-wallet-sdk';
 
-const config: VaultConfig = {
+// Example: EVM chains config
+const evmConfig: VaultConfig = {
   rpcUrls: {
     '1': 'https://your-eth-rpc.com',
     '56': 'https://your-bsc-rpc.com',
@@ -2110,9 +2127,37 @@ const config: VaultConfig = {
     enableBatchProcessing: true,
   }
 };
+
+// Example: Solana config
+const solanaConfig: VaultConfig = {
+  rpcUrls: {
+    'solana': 'https://your-solana-rpc.com',
+    'solana-devnet': 'https://your-devnet-rpc.com'
+  },
+  explorerUrls: {
+    'solana': 'https://solscan.io',
+    'solana-devnet': 'https://solscan.io?cluster=devnet'
+  },
+  defaultChainId: 'solana'
+};
+
+// Example: TRON config
+const tronConfig: VaultConfig = {
+  rpcUrls: {
+    'tron': 'https://your-tron-rpc.com',
+    'tron-shasta': 'https://your-shasta-rpc.com'
+  },
+  explorerUrls: {
+    'tron': 'https://tronscan.org',
+    'tron-shasta': 'https://shasta.tronscan.org'
+  },
+  defaultChainId: 'tron'
+};
 ```
 
 #### Usage Example (Recommended for Mobile Apps)
+
+**For EVM Chains:**
 ```typescript
 import { Vault, type VaultConfig } from 'pwc-wallet-sdk';
 const appConfig: VaultConfig = {
@@ -2125,12 +2170,63 @@ const appConfig: VaultConfig = {
 const { vault, encryptedVault } = await Vault.createNew(password, 'evm', appConfig);
 
 // Pass config when loading existing vault
-const vault = await Vault.load('password, encryptedVault, appConfig);
+const vault = await Vault.load(password, encryptedVault, appConfig);
 
 // All operations will use the config automatically
 await vault.sendToken(from, to, amount, tokenAddress, '1');
 ```
 
+**For Solana:**
+```typescript
+import { Vault, type VaultConfig } from 'pwc-wallet-sdk';
+
+// Configure Solana RPC URLs
+const solanaConfig: VaultConfig = {
+  rpcUrls: {
+    'solana': 'https://your-solana-rpc.com', // Mainnet
+    'solana-devnet': 'https://your-devnet-rpc.com' // Devnet (optional)
+  },
+  explorerUrls: {
+    'solana': 'https://solscan.io',
+    'solana-devnet': 'https://solscan.io?cluster=devnet'
+  },
+  defaultChainId: 'solana' // Optional: set default chain
+};
+
+// Create Solana vault with config
+const { vault, encryptedVault } = await Vault.createNew('password', 'solana', solanaConfig);
+
+// Or from mnemonic
+const { vault, encryptedVault } = await Vault.createFromMnemonic(
+  mnemonic, 
+  'password', 
+  'solana', 
+  solanaConfig
+);
+
+// All Solana operations will use the configured RPC URLs
+const balance = await vault.getNativeBalance(address, 'solana');
+const tx = await vault.sendSPLToken(from, to, amount, tokenAddress);
+```
+
+**For TRON:**
+```typescript
+import { Vault, type VaultConfig } from 'pwc-wallet-sdk';
+
+const tronConfig: VaultConfig = {
+  rpcUrls: {
+    'tron': 'https://your-tron-rpc.com',
+    'tron-shasta': 'https://your-shasta-rpc.com' // Testnet (optional)
+  },
+  explorerUrls: {
+    'tron': 'https://tronscan.org',
+    'tron-shasta': 'https://shasta.tronscan.org'
+  }
+};
+
+const { vault, encryptedVault } = await Vault.createNew('password', 'tron', tronConfig);
+```
+
 #### Alternative: Global Config (Advanced)
 You can also set config globally for all vaults:
 ```typescript

package/dist/Vault.d.ts

@@ -136,6 +136,14 @@ export declare class Vault {
      * @throws Error if the address is not found in any keyring
      */
     getPrivateKeyFor(address: string): Promise<string>;
+    /**
+     * Gets the native token balance (ETH, SOL, TRX, etc.) for a specific address.
+     * @param address - The account address to check balance for
+     * @param chainId - The ID of the blockchain (e.g., '1' for Ethereum, 'solana' for Solana, 'tron' for TRON)
+     * @returns Promise resolving to the native token balance as a bigint
+     * @throws Error if the balance query fails or chain configuration not found
+     */
+    getNativeBalance(address: string, chainId: ChainId): Promise<bigint>;
     /**
      * Gets the token balance for a specific account and token contract.
      * @param accountAddress - The account address to check balance for

package/dist/Vault.js

@@ -134,12 +134,16 @@ class Vault {
                 else if (sKeyring.type === 'Solana') {
                     keyrings.push(await SolanaKeyring_1.SolanaKeyring.deserialize(sKeyring));
                 }
+                else if (sKeyring.type === 'Tron') {
+                    keyrings.push(await TronKeyring_1.TronKeyring.deserialize(sKeyring));
+                }
                 else {
                     throw new Error(`Unknown keyring type: ${sKeyring.type}`);
                 }
             }
             catch (error) {
-                throw error;
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                throw new Error(`Failed to deserialize ${sKeyring.type} keyring: ${errorMessage}`);
             }
         }
         const vault = new Vault(keyrings, config);
@@ -147,6 +151,9 @@ class Vault {
         if (keyrings.some(k => k instanceof SolanaKeyring_1.SolanaKeyring)) {
             vault.chainId = 'solana';
         }
+        else if (keyrings.some(k => k instanceof TronKeyring_1.TronKeyring)) {
+            vault.chainId = 'tron';
+        }
         else {
             vault.chainId = '1'; // Default to Ethereum mainnet
         }
@@ -178,7 +185,8 @@ class Vault {
     async addNewSolanaAccount() {
         const solanaKeyring = this.keyrings.find(k => k instanceof SolanaKeyring_1.SolanaKeyring);
         if (!solanaKeyring) {
-            throw new Error('No Solana keyring available to create new accounts.');
+            const availableTypes = this.keyrings.map(k => k.type).join(', ') || 'none';
+            throw new Error(`No Solana keyring available to create new accounts. Available keyring types: ${availableTypes}. Make sure you created the vault with chainType: 'solana'.`);
         }
         const newAddress = await solanaKeyring.addNewAccount();
         return {
@@ -380,6 +388,29 @@ class Vault {
         throw new Error('Private key not found for the given address.');
     }
     // --- Blockchain Interaction Methods ---
+    /**
+     * Gets the native token balance (ETH, SOL, TRX, etc.) for a specific address.
+     * @param address - The account address to check balance for
+     * @param chainId - The ID of the blockchain (e.g., '1' for Ethereum, 'solana' for Solana, 'tron' for TRON)
+     * @returns Promise resolving to the native token balance as a bigint
+     * @throws Error if the balance query fails or chain configuration not found
+     */
+    async getNativeBalance(address, chainId) {
+        const chainInfo = (0, chains_1.getChainConfig)(chainId);
+        const privateKey = await this.getPrivateKeyFor(address);
+        if (chainInfo.type === 'solana') {
+            const chainService = new SolanaChainService_1.SolanaChainService(privateKey, chainInfo);
+            return chainService.getNativeBalance();
+        }
+        else if (chainInfo.type === 'tron') {
+            const chainService = new TronChainService_1.TronChainService(privateKey, chainInfo);
+            return chainService.getNativeBalance();
+        }
+        else {
+            const chainService = new ChainService_1.ChainService(privateKey, chainInfo);
+            return chainService.getNativeBalance();
+        }
+    }
     /**
      * Gets the token balance for a specific account and token contract.
      * @param accountAddress - The account address to check balance for

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pwc-sdk-wallet",
-  "version": "0.7.9",
+  "version": "0.8.0",
   "description": "A comprehensive wallet SDK for React Native (pwc), supporting multi-chain and multi-account features.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",