Troubleshooting

This page provides solutions to common issues you might encounter when using the RWAPool protocol.

Wallet Connection Issues

Wallet Won't Connect

Symptoms:

• "Connect Wallet" button doesn't respond
• Connection dialog appears but then disappears
• Continuous "Connecting..." message

Solutions:

1. Refresh the page

   • Close the browser tab and reopen it
   • Try a hard refresh (Ctrl+F5 or Cmd+Shift+R)

2. Check wallet extension

   • Ensure your wallet extension is up to date
   • Restart your browser
   • Check if the extension is enabled

3. Network settings

   • Verify your wallet is set to the correct network (Ethereum, Polygon, etc.)
   • Try switching networks and then back again

4. Clear browser cache

   • Clear cookies and cache for the RWAPool site
   • Try in incognito/private browsing mode

5. Alternative connection method

   • If using MetaMask, try WalletConnect instead
   • If on mobile, try the in-app browser of your wallet

Wrong Account Connected

Symptoms:

• Wallet connects but shows the wrong account
• Cannot see your investments or balance

Solutions:

1. Switch accounts in wallet

   • Open your wallet extension
   • Select the correct account
   • Disconnect and reconnect to RWAPool

2. Check multiple wallets

   • Ensure you're using the same wallet you originally invested with
   • Check if you have multiple wallet extensions enabled

3. Verify address

   • Confirm the address you're expecting to see matches your transaction history

Transaction Issues

Transaction Pending Forever

Symptoms:

• Transaction shows as "Pending" for an unusually long time
• No confirmation or rejection appears

Solutions:

1. Check gas price

   • Verify if gas prices are high on the network
   • Consider speeding up the transaction in your wallet

2. Check transaction status

   • Look up your transaction hash on the appropriate block explorer
   • Verify if it's pending on the blockchain or just in your wallet

3. Cancel and retry

   • Cancel the pending transaction in your wallet
   • Submit a new transaction with higher gas price

4. Reset wallet

   • If using MetaMask, try the "Reset Account" feature
   • This clears pending transactions without affecting your funds

Transaction Failed

Symptoms:

• "Transaction Failed" error message
• Transaction reverted on the blockchain

Solutions:

1. Check error message

   • Look for specific error details in the failure message
   • Common errors include slippage, insufficient funds, or contract restrictions

2. Check wallet balance

   • Ensure you have enough native tokens (ETH, MATIC, etc.) for gas fees
   • Verify you have the tokens you're trying to transact with

3. Adjust gas settings

   • Try increasing gas limit by 20-30%
   • Ensure gas price is competitive for current network conditions

4. Check contract allowance

   • For token approvals, ensure you've approved enough tokens
   • You may need to reset and reapprove token allowances

5. Timing restrictions

   • Some pools have timing restrictions on deposits or withdrawals
   • Check if you're within the allowed transaction window

High Gas Fees

Symptoms:

• Gas fees seem unusually high for transactions
• Transactions cost more than expected

Solutions:

1. Use gas-efficient networks

   • Switch to Layer 2 networks like Polygon, Arbitrum, or Optimism
   • These typically have much lower gas fees than Ethereum mainnet

2. Time your transactions

   • Check gas trackers for optimal timing
   • Weekends and off-peak hours often have lower gas prices

3. Batch transactions

   • If making multiple transactions, use the batch function when available
   • This combines multiple actions into a single transaction

4. Gas optimization settings

   • Use "Economy" gas settings for non-urgent transactions
   • Consider setting custom gas parameters in your wallet

Pool Interaction Issues

Cannot Deposit

Symptoms:

• Deposit button is disabled
• Deposit transaction fails
• Error message when attempting to deposit

Solutions:

1. Check pool status

   • Verify if the pool is currently accepting deposits
   • Some pools have deposit caps or windows

2. Check minimum deposit

   • Ensure you're depositing at least the minimum required amount
   • Minimum amounts are displayed on the pool details page

3. Token approval

   • Check if you've approved the RWAPool contract to use your tokens
   • If not, you'll need to complete an approval transaction first

4. Network mismatch

   • Ensure you're on the same network as the pool
   • Different pools may exist on different networks

Cannot Withdraw

Symptoms:

• Withdrawal button is disabled
• Withdrawal transaction fails
• Cannot access funds when needed

Solutions:

1. Check redemption window

   • Verify if the pool is currently in its redemption window
   • Some pools only process withdrawals at specific times

2. Check lock period

   • Some pools have minimum lock periods
   • Check if your investment is still within the lock period

3. Check minimum withdrawal

   • Ensure you're withdrawing at least the minimum required amount
   • Or withdrawing your entire balance if it's below the minimum

4. Liquidity constraints

   • During high withdrawal periods, there may be withdrawal queues
   • Check the pool's current liquidity status

Yield Not Appearing

Symptoms:

• Expected yield is not showing in your account
• Yield amount seems incorrect or lower than expected

Solutions:

1. Check distribution schedule

   • Verify when yield is distributed for your specific pool
   • Some pools distribute daily, others weekly or monthly

2. Check reinvestment settings

   • If auto-compounding is enabled, yield may be automatically reinvested
   • Check your total balance instead of just the yield section

3. Recent deposit

   • If you recently deposited, you may not be eligible for the most recent distribution
   • Check the yield accrual start date for your deposit

4. Market conditions

   • Yield rates fluctuate based on market conditions
   • Check if there have been recent yield rate adjustments

Governance Issues

Cannot Vote

Symptoms:

• Voting buttons are disabled
• Vote transaction fails
• Vote not being counted

Solutions:

1. Check token holdings

   • Verify you hold RWA governance tokens
   • Check if your tokens are staked or in liquid form

2. Snapshot timing

   • Governance votes use a snapshot of token holdings at a specific block
   • If you acquired tokens after the snapshot, you cannot vote on that proposal

3. Delegation status

   • Check if you've delegated your voting power to someone else
   • You cannot vote directly if your voting power is delegated

4. Proposal status

   • Ensure the proposal is in the active voting period
   • Voting is not possible during review, queued, or executed states

Proposal Not Visible

Symptoms:

• Cannot see a specific governance proposal
• Proposals page is empty

Solutions:

1. Check proposal status filter

   • Adjust filters to show all proposal states
   • The proposal may be in a different state than what's currently filtered

2. Network selection

   • Ensure you're on the correct network for governance
   • Some proposals may only be visible on specific networks

3. Governance portal version

   • Check if you're using the latest version of the governance portal
   • Try clearing cache or using an incognito window

Account and Portfolio Issues

Investments Not Showing

Symptoms:

• Portfolio page is empty despite having investments
• Some investments are missing from your dashboard

Solutions:

1. Check connected wallet

   • Verify you're connected with the same wallet used for investments
   • Try connecting with alternative wallets if you've used multiple

2. Network selection

   • Ensure you've selected the correct network
   • Toggle "Show all networks" option if available

3. Recent transactions

   • If you just made an investment, it may take a few minutes to appear
   • Check transaction status on the blockchain explorer

4. Historical view

   • Check the "History" or "Transactions" tab to see past activity
   • This can help identify which wallet or network was used

Incorrect Balance

Symptoms:

• Balance shown doesn't match expected amount
• Numbers seem outdated or incorrect

Solutions:

1. Refresh data

   • Use the refresh button on the portfolio page
   • Disconnect and reconnect your wallet

2. Check multiple networks

   • Your balance may be spread across multiple networks
   • Ensure you're viewing aggregated balances if applicable

3. Pending transactions

   • Check for pending transactions that might affect your balance
   • These may not be reflected until confirmed

4. Token price impact

   • If viewing fiat value, price fluctuations affect your balance
   • Check if token prices have changed significantly

Technical and API Issues

API Integration Errors

Symptoms:

• API calls returning errors
• Integration with RWAPool not functioning

Solutions:

1. Check API key

   • Verify your API key is valid and has the correct permissions
   • Regenerate the key if necessary

2. Rate limits

   • Check if you've exceeded API rate limits
   • Implement proper rate limiting in your application

3. Endpoint URLs

   • Ensure you're using the correct API endpoints
   • Verify the API version in your requests

4. Request format

   • Validate your request format against the API documentation
   • Check for required parameters and correct data types

5. Network issues

   • Test API connectivity from different networks
   • Use API status page to check for known outages

SDK Implementation Problems

Symptoms:

• SDK methods throwing errors
• Unexpected behavior in SDK integration

Solutions:

1. SDK version

   • Ensure you're using the latest SDK version
   • Check changelog for breaking changes

2. Initialization

   • Verify SDK is properly initialized with correct parameters
   • Check provider connection before making calls

3. Error handling

   • Implement proper try/catch blocks around SDK methods
   • Log detailed error information for troubleshooting

4. Async handling

   • Ensure proper handling of asynchronous SDK methods
   • Use await/async or proper promise chains

Mobile App Issues

App Crashes

Symptoms:

• App closes unexpectedly
• Freezes on certain screens

Solutions:

1. Update app

   • Ensure you have the latest version from the app store
   • Check for pending updates

2. Restart device

   • Close all apps and restart your device
   • This clears memory and can resolve many issues

3. Reinstall app

   • Uninstall and reinstall the RWAPool app
   • Note: You'll need to reconnect your wallet after reinstalling

4. Check device compatibility

   • Verify your device meets minimum requirements
   • Older devices may have compatibility issues

Biometric Authentication Fails

Symptoms:

• Face ID or fingerprint authentication doesn't work
• Repeatedly asks for biometric verification

Solutions:

1. Re-register biometrics

   • Disable and re-enable biometric authentication
   • Update your biometric data in device settings

2. Alternative login

   • Use password/PIN method instead
   • Re-setup biometrics after successful login

3. App permissions

   • Check if the app has necessary permissions for biometrics
   • Grant permissions in device settings if needed

Getting Additional Help

If you've tried the solutions above and still experience issues:

1. Community Support

   • Ask in the Discord #support channel
   • Check if others are experiencing similar issues

2. Submit Support Ticket

   • Create a detailed ticket at help.rwapool.io
   • Include screenshots, transaction hashes, and steps to reproduce

3. Live Support

   • Use the live chat feature on the RWAPool website during business hours
   • Schedule a video call for complex issues

4. Email Support

   • Contact [email protected]
   • Include your wallet address (never share private keys or seed phrases)

When seeking help, always:

• Provide your wallet address (never private keys)
• Share transaction hashes for specific transaction issues
• Describe exactly what you were doing when the issue occurred
• Include browser/device information
• Mention any error messages you received