₿

ReserveBTC

Dash
Fct
Test
Back to Documentation

Troubleshooting Guide

Common issues and their solutions when using ReserveBTC. If you can't find your issue here, check our community forum or contact support.

Quick Fixes (Try These First)

Refresh & Reconnect

Refresh page and reconnect wallet

Check Network

Ensure connected to MegaETH Testnet

Clear Cache

Clear browser cache and cookies

Check Gas

Ensure sufficient ETH for gas fees

Update Wallets

Update MetaMask and Bitcoin wallet

Wait & Retry

Wait 30 seconds and try again

🔌 Wallet Connection Issues

❌ "MetaMask Not Detected"

Symptoms: Wallet connection button doesn't work

Solutions:

  • Install MetaMask browser extension
  • Refresh the page after installation
  • Enable MetaMask in browser extensions
  • Try incognito mode to test
  • Disable other wallet extensions temporarily

❌ "Wrong Network"

Symptoms: Transactions fail or interface shows errors

Solutions:

  • Switch to MegaETH Testnet in MetaMask
  • Add MegaETH network if missing (Chain ID: 6342)
  • Verify RPC URL: https://carrot.megaeth.com/rpc
  • Check network status on MegaETH explorer

❌ "Insufficient Funds for Gas"

Symptoms: Transactions fail with gas error

Solutions:

  • Request test ETH from MegaETH developers
  • Join MegaETH Discord for faucet access
  • Wait for gas prices to decrease
  • Increase gas limit in MetaMask settings

✍️ Bitcoin Address Verification Issues

❌ "Invalid BIP-322 Signature"

Symptoms: Signature verification fails

Common causes & solutions:

  • Message modified: Copy message exactly as shown
  • Wrong address: Sign with the exact address you entered
  • Wallet compatibility: Use Sparrow or Electrum wallet
  • Truncated signature: Copy complete signature including padding
  • Encoding issues: Ensure proper UTF-8 encoding

❌ "Address Balance Not Found"

Symptoms: System can't find Bitcoin balance

Solutions:

  • Ensure address has confirmed Bitcoin balance
  • Wait for recent transactions to confirm (6 confirmations)
  • Check address format is correct
  • Try again in 5-10 minutes (API delays)
  • Verify on blockchain explorer first

❌ "Wallet Doesn't Support BIP-322"

Symptoms: Can't find signing option or gets errors

Recommended alternatives:

  • Download Sparrow Wallet (best BIP-322 support)
  • Update Electrum to latest version (4.5.0+)
  • Import seed phrase to supported wallet temporarily
  • Use Bitcoin Core for advanced users

🔮 Oracle & Synchronization Issues

❌ "Oracle Not Responding"

Symptoms: Balance updates not happening

Solutions:

  • Check Oracle Dashboard status
  • Verify Oracle server is running
  • Check MegaETH network connectivity
  • Wait for next sync cycle (every 5 minutes)
  • Manual sync via Oracle interface

❌ "Balance Not Syncing"

Symptoms: Token balance doesn't match Bitcoin balance

Solutions:

  • Wait up to 10 minutes for automatic sync
  • Check that Bitcoin transaction is confirmed
  • Use manual sync button in Oracle dashboard
  • Verify Oracle has sufficient gas fees
  • Check for Oracle authorization issues

❌ "Sync Transaction Failed"

Symptoms: Oracle shows sync errors

Solutions:

  • Check Oracle has enough ETH for gas
  • Verify smart contract addresses are correct
  • Ensure Oracle is authorized as committee member
  • Check MegaETH network status
  • Restart Oracle server if self-hosting

🪙 Token & Transaction Issues

❌ "Tokens Not Visible in Wallet"

Symptoms: Minted tokens don't appear in MetaMask

Solutions:

  • Add token contracts manually to MetaMask
  • rBTC-SYNTH: 0x37fE059490B70e2605cb3D6fD64F5292d3eB46dE
  • wrBTC: 0xa10FC332f12d102Dddf431F8136E4E89279EFF87
  • Refresh MetaMask and check "Assets" tab
  • Verify transaction was successful on explorer

❌ "Minting Transaction Reverted"

Symptoms: Mint transaction fails

Solutions:

  • Ensure address verification completed successfully
  • Check Bitcoin balance is sufficient (>0)
  • Increase gas limit in MetaMask
  • Try minting smaller amount first
  • Verify contract addresses are correct

❌ "Transfer Failed" (wrBTC only)

Symptoms: Can't transfer wrBTC tokens

Solutions:

  • Ensure sufficient token balance
  • Check recipient address is valid
  • Increase gas limit for transfers
  • Verify you're using wrBTC (not rBTC-SYNTH)
  • Note: rBTC-SYNTH is non-transferable by design

🌐 Network & Performance Issues

❌ "Network Timeout"

Symptoms: Requests taking too long or timing out

Solutions:

  • Check internet connection stability
  • Try different RPC endpoint if available
  • Disable VPN temporarily
  • Use different browser or incognito mode
  • Check MegaETH network status

❌ "RPC Error"

Symptoms: JSON-RPC errors or connection failures

Solutions:

  • Verify RPC URL: https://carrot.megaeth.com/rpc
  • Check if MegaETH network is experiencing issues
  • Clear MetaMask cache and reconnect
  • Try removing and re-adding the network
  • Contact MegaETH support if persistent

Common Error Codes

Oracle Errors

ORACLE_NOT_AUTHORIZED

Oracle not authorized as committee member

BALANCE_MISMATCH

Bitcoin balance verification failed

SYNC_TIMEOUT

Balance sync operation timed out

Contract Errors

INSUFFICIENT_BALANCE

Not enough Bitcoin to mint requested amount

INVALID_SIGNATURE

BIP-322 signature verification failed

USER_NOT_VERIFIED

Address verification required first

Still Need Help?

Community Support

Join our Discord community for real-time help

Join Discord

GitHub Issues

Report bugs or request features

Open Issue

Email Support

Direct email for technical issues

Email Support

Emergency Procedures

🚨 If You Suspect Security Compromise

  1. Immediately move Bitcoin to a new address
  2. Disconnect all wallet connections
  3. Change all wallet passwords
  4. Monitor for unauthorized transactions
  5. Contact support immediately

🔧 If Protocol Appears Broken

  1. Check official status page and social media
  2. Verify you're using the correct URLs
  3. Try the backup interface if available
  4. Do NOT panic-sell or make hasty decisions
  5. Wait for official communications

Self-Diagnostic Tools

Check Your Setup

← First Mint TutorialBest Practices →