pwc-sdk-wallet 0.8.1 → 0.8.3

package/README.md

@@ -1881,6 +1881,9 @@ console.log('New account address:', newAccount.address);
 // Add a new Solana account
 const newSolanaAccount = await vault.addNewSolanaAccount();
 console.log('New Solana account:', newSolanaAccount.address);
+
+// Note: All Solana accounts are automatically persisted when you encrypt and save the vault.
+// When you load the vault later, all previously added accounts will be restored.
 ```
 
 #### Add New TRON Account

package/dist/Vault.d.ts

@@ -4,7 +4,7 @@ import { Recipient, MultiTransferResult } from './types/multiTransfer';
 import { NFTDetailExtended, NFTBalance, NFTOptions } from './types/nft';
 export interface Account {
     address: string;
-    type: 'HD' | 'Simple' | 'Solana' | 'Tron';
+    type: 'HD' | 'Simple' | 'Solana';
     name: string;
 }
 export interface TransactionResponse {
@@ -51,7 +51,7 @@ 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, 'solana' for Solana, or 'tron' for TRON). Defaults to 'evm'
+     * @param chainType - The type of blockchain to support ('evm' for Ethereum-compatible chains, 'solana' for Solana). 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
      */
@@ -63,7 +63,7 @@ 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, 'solana' for Solana, or 'tron' for TRON). Defaults to 'evm'
+     * @param chainType - The type of blockchain to support ('evm' for Ethereum-compatible chains, 'solana' for Solana). 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
      */
@@ -92,7 +92,7 @@ export declare class Vault {
      */
     addNewSolanaAccount(): Promise<Account>;
     /**
-     * Adds a new TRON account derived from the TRON keyring.
+     * Adds a new TRON account derived from the TRON keyring. (TEMPORARILY DISABLED)
      * @returns Promise resolving to the newly created TRON account information
      * @throws Error if no TRON keyring is available in the vault
      */
@@ -595,7 +595,7 @@ export declare class Vault {
      */
     sendNativeToken(fromAddress: string, to: string, amount: string, chainId: ChainId): Promise<TransactionResponse>;
     /**
-     * Sends TRX (native TRON token) to another address.
+     * Sends TRX (native TRON token) to another address. (TEMPORARILY DISABLED)
      * @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")

package/dist/Vault.js

@@ -4,10 +4,10 @@ exports.Vault = void 0;
 const HDKeyring_1 = require("./keyrings/HDKeyring");
 const SimpleKeyring_1 = require("./keyrings/SimpleKeyring");
 const SolanaKeyring_1 = require("./keyrings/SolanaKeyring");
-const TronKeyring_1 = require("./keyrings/TronKeyring");
+// import { TronKeyring } from './keyrings/TronKeyring'; // TEMPORARILY DISABLED - tronweb compatibility issues
 const ChainService_1 = require("./chain/ChainService");
 const SolanaChainService_1 = require("./chain/SolanaChainService");
-const TronChainService_1 = require("./chain/TronChainService");
+// import { TronChainService } from './chain/TronChainService'; // TEMPORARILY DISABLED - tronweb compatibility issues
 const EncryptionService_1 = require("./crypto/EncryptionService");
 const chains_1 = require("./config/chains");
 const constants_1 = require("./config/constants");
@@ -45,7 +45,7 @@ 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, 'solana' for Solana, or 'tron' for TRON). Defaults to 'evm'
+     * @param chainType - The type of blockchain to support ('evm' for Ethereum-compatible chains, 'solana' for Solana). 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
      */
@@ -59,11 +59,7 @@ class Vault {
             return { vault, encryptedVault };
         }
         else if (chainType === 'tron') {
-            const tronKeyring = new TronKeyring_1.TronKeyring(mnemonic);
-            const vault = new Vault([tronKeyring], config);
-            vault.chainId = 'tron'; // Set TRON chain ID
-            const encryptedVault = await vault.encrypt(password);
-            return { vault, encryptedVault };
+            throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
         }
         else {
             const hdKeyring = new HDKeyring_1.HDKeyring(mnemonic);
@@ -78,7 +74,7 @@ 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, 'solana' for Solana, or 'tron' for TRON). Defaults to 'evm'
+     * @param chainType - The type of blockchain to support ('evm' for Ethereum-compatible chains, 'solana' for Solana). 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
      */
@@ -91,11 +87,7 @@ class Vault {
             return { vault, encryptedVault };
         }
         else if (chainType === 'tron') {
-            const tronKeyring = new TronKeyring_1.TronKeyring(mnemonic);
-            const vault = new Vault([tronKeyring], config);
-            vault.chainId = 'tron'; // Set TRON chain ID
-            const encryptedVault = await vault.encrypt(password);
-            return { vault, encryptedVault };
+            throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
         }
         else {
             const hdKeyring = new HDKeyring_1.HDKeyring(mnemonic);
@@ -133,10 +125,10 @@ class Vault {
                 }
                 else if (sKeyring.type === 'Solana') {
                     keyrings.push(await SolanaKeyring_1.SolanaKeyring.deserialize(sKeyring));
-                }
+                } /* TEMPORARILY DISABLED - tronweb compatibility issues
                 else if (sKeyring.type === 'Tron') {
-                    keyrings.push(await TronKeyring_1.TronKeyring.deserialize(sKeyring));
-                }
+                    keyrings.push(await TronKeyring.deserialize(sKeyring));
+                } */
                 else {
                     throw new Error(`Unknown keyring type: ${sKeyring.type}`);
                 }
@@ -150,10 +142,10 @@ class Vault {
         // Set chain ID based on keyring type
         if (keyrings.some(k => k instanceof SolanaKeyring_1.SolanaKeyring)) {
             vault.chainId = 'solana';
-        }
-        else if (keyrings.some(k => k instanceof TronKeyring_1.TronKeyring)) {
+        } /* TEMPORARILY DISABLED - tronweb compatibility issues
+        else if (keyrings.some(k => k instanceof TronKeyring)) {
             vault.chainId = 'tron';
-        }
+        } */
         else {
             vault.chainId = '1'; // Default to Ethereum mainnet
         }
@@ -196,21 +188,12 @@ class Vault {
         };
     }
     /**
-     * Adds a new TRON account derived from the TRON keyring.
+     * Adds a new TRON account derived from the TRON keyring. (TEMPORARILY DISABLED)
      * @returns Promise resolving to the newly created TRON account information
      * @throws Error if no TRON keyring is available in the vault
      */
     async addNewTronAccount() {
-        const tronKeyring = this.keyrings.find(k => k instanceof TronKeyring_1.TronKeyring);
-        if (!tronKeyring) {
-            throw new Error('No TRON keyring available to create new accounts.');
-        }
-        const newAddress = await tronKeyring.addNewAccount();
-        return {
-            address: newAddress,
-            type: 'Tron',
-            name: `Tron ${tronKeyring.getAllAccounts().length}`
-        };
+        throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
     }
     /**
      * Imports an account from a private key and adds it to the vault.
@@ -271,8 +254,8 @@ class Vault {
                         name: `Solana ${solanaAccountCount++}`,
                     });
                 }
-            }
-            else if (keyring instanceof TronKeyring_1.TronKeyring) {
+            } /* TEMPORARILY DISABLED - tronweb compatibility issues
+            else if (keyring instanceof TronKeyring) {
                 for (const address of keyring.getAllAccounts()) {
                     accounts.push({
                         address,
@@ -281,6 +264,7 @@ class Vault {
                     });
                 }
             }
+            */
         }
         return accounts;
     }
@@ -401,11 +385,10 @@ class Vault {
         if (chainInfo.type === 'solana') {
             const chainService = new SolanaChainService_1.SolanaChainService(privateKey, chainInfo);
             return chainService.getNativeBalance();
-        }
+        } /* TEMPORARILY DISABLED - tronweb compatibility issues
         else if (chainInfo.type === 'tron') {
-            const chainService = new TronChainService_1.TronChainService(privateKey, chainInfo);
-            return chainService.getNativeBalance();
-        }
+            throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
+        } */
         else {
             const chainService = new ChainService_1.ChainService(privateKey, chainInfo);
             return chainService.getNativeBalance();
@@ -1373,17 +1356,10 @@ class Vault {
                 to: result.to,
                 blockNumber: result.blockNumber || undefined
             };
-        }
+        } /* TEMPORARILY DISABLED - tronweb compatibility issues
         else if (chainInfo.type === 'tron') {
-            const chainService = new TronChainService_1.TronChainService(privateKey, chainInfo);
-            const result = await chainService.sendTransaction(to, amount);
-            return {
-                hash: result.hash,
-                from: result.from,
-                to: result.to,
-                blockNumber: result.blockNumber || undefined
-            };
-        }
+            throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
+        } */
         else {
             const chainService = new ChainService_1.ChainService(privateKey, chainInfo);
             // Create transaction request for native token transfer
@@ -1400,9 +1376,10 @@ class Vault {
             };
         }
     }
-    // --- TRON Operations ---
+    // --- TRON Operations --- (TEMPORARILY DISABLED - tronweb compatibility issues)
+    // All TRON-related methods are temporarily disabled due to tronweb compatibility issues with React Native
     /**
-     * Sends TRX (native TRON token) to another address.
+     * Sends TRX (native TRON token) to another address. (TEMPORARILY DISABLED)
      * @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")
@@ -1417,19 +1394,7 @@ class Vault {
      * ```
      */
     async sendTRX(fromAddress, to, amount) {
-        const chainInfo = (0, chains_1.getChainConfig)('tron');
-        if (chainInfo.type !== 'tron') {
-            throw new Error('TRON chain configuration not found');
-        }
-        const privateKey = await this.getPrivateKeyFor(fromAddress);
-        const chainService = new TronChainService_1.TronChainService(privateKey, chainInfo);
-        const result = await chainService.sendTransaction(to, amount);
-        return {
-            hash: result.hash,
-            from: result.from,
-            to: result.to,
-            blockNumber: result.blockNumber
-        };
+        throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
     }
     /**
      * Sends TRC-20 tokens on TRON blockchain.
@@ -1452,19 +1417,7 @@ class Vault {
      * ```
      */
     async sendTRC20Token(fromAddress, to, amount, tokenAddress) {
-        const chainInfo = (0, chains_1.getChainConfig)('tron');
-        if (chainInfo.type !== 'tron') {
-            throw new Error('TRON chain configuration not found');
-        }
-        const privateKey = await this.getPrivateKeyFor(fromAddress);
-        const chainService = new TronChainService_1.TronChainService(privateKey, chainInfo);
-        const result = await chainService.sendToken(to, amount, tokenAddress);
-        return {
-            hash: result.hash,
-            from: result.from,
-            to: result.to,
-            blockNumber: result.blockNumber
-        };
+        throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
     }
     /**
      * Gets TRX balance for a specific address on TRON.
@@ -1473,13 +1426,7 @@ class Vault {
      * @throws Error if the balance query fails
      */
     async getTRXBalance(address) {
-        const chainInfo = (0, chains_1.getChainConfig)('tron');
-        if (chainInfo.type !== 'tron') {
-            throw new Error('TRON chain configuration not found');
-        }
-        const privateKey = await this.getPrivateKeyFor(address);
-        const chainService = new TronChainService_1.TronChainService(privateKey, chainInfo);
-        return await chainService.getNativeBalance();
+        throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
     }
     /**
      * Gets TRC-20 token balance for a specific address on TRON.
@@ -1489,13 +1436,7 @@ class Vault {
      * @throws Error if the balance query fails
      */
     async getTRC20TokenBalance(address, tokenAddress) {
-        const chainInfo = (0, chains_1.getChainConfig)('tron');
-        if (chainInfo.type !== 'tron') {
-            throw new Error('TRON chain configuration not found');
-        }
-        const privateKey = await this.getPrivateKeyFor(address);
-        const chainService = new TronChainService_1.TronChainService(privateKey, chainInfo);
-        return await chainService.getTokenBalance(tokenAddress);
+        throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
     }
     /**
      * Gets TRC-20 token information.
@@ -1504,21 +1445,7 @@ class Vault {
      * @throws Error if the token query fails
      */
     async getTRC20TokenInfo(tokenAddress) {
-        const chainInfo = (0, chains_1.getChainConfig)('tron');
-        if (chainInfo.type !== 'tron') {
-            throw new Error('TRON chain configuration not found');
-        }
-        // Use a dummy private key for read-only operations
-        const dummyPrivateKey = '0000000000000000000000000000000000000000000000000000000000000001';
-        const chainService = new TronChainService_1.TronChainService(dummyPrivateKey, chainInfo);
-        const tokenInfo = await chainService.getTokenInfo(tokenAddress);
-        return {
-            address: tokenInfo.address,
-            name: tokenInfo.name,
-            symbol: tokenInfo.symbol,
-            decimals: tokenInfo.decimals,
-            totalSupply: tokenInfo.totalSupply
-        };
+        throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
     }
     /**
      * Estimates the transaction fee for a TRX transfer.
@@ -1529,13 +1456,7 @@ class Vault {
      * @throws Error if the estimation fails
      */
     async estimateTRXTransferFee(fromAddress, to, amount) {
-        const chainInfo = (0, chains_1.getChainConfig)('tron');
-        if (chainInfo.type !== 'tron') {
-            throw new Error('TRON chain configuration not found');
-        }
-        const privateKey = await this.getPrivateKeyFor(fromAddress);
-        const chainService = new TronChainService_1.TronChainService(privateKey, chainInfo);
-        return await chainService.estimateTransactionFee(to, amount);
+        throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
     }
     /**
      * Estimates the transaction fee for a TRC-20 token transfer.
@@ -1547,13 +1468,7 @@ class Vault {
      * @throws Error if the estimation fails
      */
     async estimateTRC20TransferFee(fromAddress, to, amount, tokenAddress) {
-        const chainInfo = (0, chains_1.getChainConfig)('tron');
-        if (chainInfo.type !== 'tron') {
-            throw new Error('TRON chain configuration not found');
-        }
-        const privateKey = await this.getPrivateKeyFor(fromAddress);
-        const chainService = new TronChainService_1.TronChainService(privateKey, chainInfo);
-        return await chainService.estimateTokenTransferFee(to, amount, tokenAddress);
+        throw new Error('TRON support is temporarily disabled due to tronweb compatibility issues with React Native.');
     }
 }
 exports.Vault = Vault;

package/dist/index.d.ts

@@ -3,7 +3,6 @@ export type { Account } from './Vault';
 export type { ChainId, ChainConfig } from './config/chains';
 export type { EncryptedData } from './crypto/EncryptionService';
 export type { Token } from './chain/ChainService';
-export type { TronTransactionResponse, TronToken } from './chain/TronChainService';
 export type { Recipient, MultiTransferOptions, MultiTransferResult, BatchResult, ValidationResult } from './types/multiTransfer';
 export type { QRCodeData, WalletImportData, TransactionData } from './services/QRCodeService';
 export { SUPPORTED_CHAINS, DERIVATION_PATHS, registerCustomChain, overrideChain, overrideChains, getChainConfig, setupChainConfigs, getAllAvailableChains, clearCustomChains, clearOverrides, clearOverride, getCustomChains, getOverrides, setGlobalRPCConfig, setGlobalExplorerConfig, clearGlobalConfigs } from './config/chains';
@@ -13,10 +12,8 @@ export { getEnvironmentConfig, validateEnvironmentConfig, getEnvVar, getEnvVarNu
 export { HDKeyring } from './keyrings/HDKeyring';
 export { SimpleKeyring } from './keyrings/SimpleKeyring';
 export { SolanaKeyring } from './keyrings/SolanaKeyring';
-export { TronKeyring } from './keyrings/TronKeyring';
 export { ChainService } from './chain/ChainService';
 export { SolanaChainService } from './chain/SolanaChainService';
-export { TronChainService } from './chain/TronChainService';
 export { EncryptionService } from './crypto/EncryptionService';
 export { MultiTransferService } from './services/MultiTransferService';
 export { BatchProcessor } from './services/BatchProcessor';

package/dist/index.js

@@ -15,8 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransactionHandler = exports.MessageBridgeService = exports.BrowserProviderService = exports.QRCodeService = exports.BatchProcessor = exports.MultiTransferService = exports.EncryptionService = exports.TronChainService = exports.SolanaChainService = exports.ChainService = exports.TronKeyring = exports.SolanaKeyring = exports.SimpleKeyring = exports.HDKeyring = exports.getEnvVarBoolean = exports.getEnvVarBigInt = exports.getEnvVarNumber = exports.getEnvVar = exports.validateEnvironmentConfig = exports.getEnvironmentConfig = exports.VALIDATION_CONFIG = exports.CACHE_CONFIG = exports.NETWORK_CONFIG = exports.SECURITY_CONFIG = exports.VANITY_WALLET_CONFIG = exports.clearGlobalGasConfigs = exports.getGasConfig = exports.setGlobalNetworkGasConfig = exports.setGlobalGasConfig = exports.calculateOptimalGasPrice = exports.getNetworkGasConfig = exports.NETWORK_GAS_CONFIG = exports.GAS_CONFIG = exports.clearGlobalConfigs = exports.setGlobalExplorerConfig = exports.setGlobalRPCConfig = exports.getOverrides = exports.getCustomChains = exports.clearOverride = exports.clearOverrides = exports.clearCustomChains = exports.getAllAvailableChains = exports.setupChainConfigs = exports.getChainConfig = exports.overrideChains = exports.overrideChain = exports.registerCustomChain = exports.DERIVATION_PATHS = exports.SUPPORTED_CHAINS = exports.Vault = void 0;
-exports.usePWCWallet = exports.ConnectionModal = exports.TransactionModal = exports.DAppBrowser = void 0;
+exports.TransactionModal = exports.DAppBrowser = exports.TransactionHandler = exports.MessageBridgeService = exports.BrowserProviderService = exports.QRCodeService = exports.BatchProcessor = exports.MultiTransferService = exports.EncryptionService = exports.SolanaChainService = exports.ChainService = exports.SolanaKeyring = exports.SimpleKeyring = exports.HDKeyring = exports.getEnvVarBoolean = exports.getEnvVarBigInt = exports.getEnvVarNumber = exports.getEnvVar = exports.validateEnvironmentConfig = exports.getEnvironmentConfig = exports.VALIDATION_CONFIG = exports.CACHE_CONFIG = exports.NETWORK_CONFIG = exports.SECURITY_CONFIG = exports.VANITY_WALLET_CONFIG = exports.clearGlobalGasConfigs = exports.getGasConfig = exports.setGlobalNetworkGasConfig = exports.setGlobalGasConfig = exports.calculateOptimalGasPrice = exports.getNetworkGasConfig = exports.NETWORK_GAS_CONFIG = exports.GAS_CONFIG = exports.clearGlobalConfigs = exports.setGlobalExplorerConfig = exports.setGlobalRPCConfig = exports.getOverrides = exports.getCustomChains = exports.clearOverride = exports.clearOverrides = exports.clearCustomChains = exports.getAllAvailableChains = exports.setupChainConfigs = exports.getChainConfig = exports.overrideChains = exports.overrideChain = exports.registerCustomChain = exports.DERIVATION_PATHS = exports.SUPPORTED_CHAINS = exports.Vault = void 0;
+exports.usePWCWallet = exports.ConnectionModal = void 0;
 // The primary `Vault` class is the main entry point for interacting with the SDK.
 var Vault_1 = require("./Vault");
 Object.defineProperty(exports, "Vault", { enumerable: true, get: function () { return Vault_1.Vault; } });
@@ -73,15 +73,13 @@ var SimpleKeyring_1 = require("./keyrings/SimpleKeyring");
 Object.defineProperty(exports, "SimpleKeyring", { enumerable: true, get: function () { return SimpleKeyring_1.SimpleKeyring; } });
 var SolanaKeyring_1 = require("./keyrings/SolanaKeyring");
 Object.defineProperty(exports, "SolanaKeyring", { enumerable: true, get: function () { return SolanaKeyring_1.SolanaKeyring; } });
-var TronKeyring_1 = require("./keyrings/TronKeyring");
-Object.defineProperty(exports, "TronKeyring", { enumerable: true, get: function () { return TronKeyring_1.TronKeyring; } });
+// export { TronKeyring } from './keyrings/TronKeyring'; // TEMPORARILY DISABLED
 // Chain services
 var ChainService_1 = require("./chain/ChainService");
 Object.defineProperty(exports, "ChainService", { enumerable: true, get: function () { return ChainService_1.ChainService; } });
 var SolanaChainService_1 = require("./chain/SolanaChainService");
 Object.defineProperty(exports, "SolanaChainService", { enumerable: true, get: function () { return SolanaChainService_1.SolanaChainService; } });
-var TronChainService_1 = require("./chain/TronChainService");
-Object.defineProperty(exports, "TronChainService", { enumerable: true, get: function () { return TronChainService_1.TronChainService; } });
+// export { TronChainService } from './chain/TronChainService'; // TEMPORARILY DISABLED
 // `EncryptionService` provides access to the underlying encryption/decryption methods.
 var EncryptionService_1 = require("./crypto/EncryptionService");
 Object.defineProperty(exports, "EncryptionService", { enumerable: true, get: function () { return EncryptionService_1.EncryptionService; } });

package/dist/keyrings/SolanaKeyring.d.ts

@@ -1,4 +1,12 @@
 import { Keypair } from '@solana/web3.js';
+/**
+ * Serialized keyring data structure
+ */
+export interface SerializedSolanaKeyring {
+    type: 'Solana';
+    mnemonic: string;
+    accounts: string[];
+}
 /**
  * Solana keyring for managing multiple Solana accounts
  * derived from a single mnemonic phrase using BIP-44 derivation paths.
@@ -9,12 +17,25 @@ export declare class SolanaKeyring {
     private keypairs;
     accounts: string[];
     private mnemonic;
+    private seed;
+    private static seedCache;
+    private static readonly ERROR_INVALID_MNEMONIC;
+    private static readonly ERROR_INVALID_INDEX;
+    private static readonly ERROR_DUPLICATE_ACCOUNT;
+    private static readonly ERROR_ADDRESS_NOT_FOUND;
+    private static readonly ERROR_INVALID_DESERIALIZE;
+    private static readonly ERROR_ADDRESS_MISMATCH;
     /**
      * Creates a new SolanaKeyring instance from a mnemonic phrase.
      * @param mnemonic - The mnemonic phrase (12, 15, 18, 21, or 24 words)
      * @throws Error if the mnemonic is invalid
      */
     constructor(mnemonic: string);
+    /**
+     * Gets or generates the seed for this keyring, using cache when available.
+     * @returns The seed buffer
+     */
+    private getSeed;
     /**
      * Initializes the keyring by generating the seed and creating the first account.
      * @param mnemonic - The mnemonic phrase to initialize from
@@ -23,21 +44,28 @@ export declare class SolanaKeyring {
     /**
      * Derives a Solana keypair at a specific index using BIP-44 derivation.
      * @param seed - The seed buffer to derive from
-     * @param index - The account index to derive (0-based)
+     * @param index - The account index to derive (0-based, must be non-negative integer)
      * @returns The derived Solana keypair
+     * @throws Error if index is invalid
      */
-    private deriveKeypair;
+    private static deriveKeypair;
     /**
      * Adds a new Solana account derived from the mnemonic at the next available index.
      * @returns Promise resolving to the public key address of the newly created account
      * @throws Error if account derivation fails or duplicate address is generated
      */
     addNewAccount(): Promise<string>;
+    /**
+     * Validates a Solana address format.
+     * @param address - The address to validate
+     * @returns True if the address is valid, false otherwise
+     */
+    static isValidAddress(address: string): boolean;
     /**
      * Gets the private key for a given address managed by this keyring.
      * @param address - The account's public key address to get the private key for
      * @returns Promise resolving to the private key as a hex string
-     * @throws Error if the address is not found in this keyring
+     * @throws Error if the address is not found in this keyring or is invalid
      */
     getPrivateKeyForAddress(address: string): Promise<string>;
     /**
@@ -47,9 +75,9 @@ export declare class SolanaKeyring {
     getMnemonic(): string;
     /**
      * Serializes the keyring data for encryption and storage.
-     * @returns An object containing the keyring type and mnemonic
+     * @returns An object containing the keyring type, mnemonic, and accounts
      */
-    serialize(): any;
+    serialize(): SerializedSolanaKeyring;
     /**
      * Deserializes data into a SolanaKeyring instance.
      * @param data - The serialized keyring data
@@ -61,6 +89,7 @@ export declare class SolanaKeyring {
      * Gets the Solana keypair for a given address.
      * @param address - The account's public key address
      * @returns The Solana keypair or undefined if not found
+     * @throws Error if the address format is invalid
      */
     getKeypair(address: string): Keypair | undefined;
     /**
@@ -68,4 +97,20 @@ export declare class SolanaKeyring {
      * @returns Array of all Solana keypairs
      */
     getAllKeypairs(): Keypair[];
+    /**
+     * Clears sensitive data from memory.
+     * This should be called when the keyring is no longer needed to help prevent memory dumps.
+     * Note: This does not clear the seed cache, only instance-specific data.
+     */
+    clearSensitiveData(): void;
+    /**
+     * Clears the seed cache to free up memory.
+     * Call this when you want to clear sensitive data from memory.
+     */
+    static clearSeedCache(): void;
+    /**
+     * Gets the cache size for debugging purposes.
+     * @returns Number of cached seeds
+     */
+    static getSeedCacheSize(): number;
 }