Troubleshooting
Solutions to common issues when using ZcashBridge.
Common Issues
Transaction Stuck or Delayed
Symptoms
Transaction shows as "pending" for extended time
No confirmations received
Status hasn't updated
Solutions
Quote Not Loading
Symptoms
Quote doesn't appear
Error loading quote
Quote request fails
Solutions
Wallet Connection Issues
Symptoms
Wallet won't connect
Connection fails
Wallet not detected
Solutions
Insufficient Funds Error
Symptoms
"Insufficient funds" error
Transaction fails
Can't complete bridge
Solutions
Network-Specific Issues
Bitcoin Issues
Slow Confirmations
Cause: Bitcoin network congestion
Solutions:
Wait for confirmations (can take 10-60+ minutes)
Check mempool status
Consider timing (avoid peak hours)
High Fees
Cause: Network congestion increases fees
Solutions:
Wait for lower congestion
Accept higher fees if urgent
Monitor fee trends
Ethereum Issues
High Gas Fees
Cause: Ethereum network congestion
Solutions:
Wait for lower gas prices
Use Layer 2 solutions (Arbitrum, Optimism, Polygon)
Monitor gas prices
Time transactions for lower activity
Slow Confirmations
Cause: Network congestion or low gas
Solutions:
Wait for confirmations
Increase gas if possible
Check network status
Solana Issues
Network Congestion
Cause: High network activity
Solutions:
Wait for network to clear
Retry transaction
Check Solana network status
Transaction Failures
Cause: Various network issues
Solutions:
Retry transaction
Check Solana status
Verify sufficient SOL for fees
Tron Issues
Energy/Bandwidth Requirements
Cause: Some transactions require energy/bandwidth
Solutions:
System handles automatically
Ensure sufficient TRX
Stake TRX for energy if needed
Slow Confirmations
Cause: Network issues
Solutions:
Wait for confirmations
Check Tron network status
Retry if needed
EVM Chain Issues
Wrong Network
Cause: Wallet on wrong network
Solutions:
Switch to correct network
Add network if not added
Verify network in wallet
RPC Issues
Cause: RPC endpoint problems
Solutions:
Wait and retry
Check chain status
Contact support if persistent
Transaction Problems
Transaction Failed
Before Confirmation
Can cancel and start over
No fees if not confirmed
Try again: request new quote
After Confirmation
Check error: review error message
Verify on-chain: check transaction on explorer
Contact Support: provide transaction hash
Wrong Amount Received
Check Quote
Compare received amount to quote
Account for all fees
Verify on-chain transaction
Contact Support
Provide details: transaction hash and details
Explain issue: describe discrepancy
Wait response: support will investigate
Wrong Address
Prevention
Always verify addresses before sending
Copy carefully: ensure full address copied
Test small: test with small amount first
If Sent to Wrong Address
Contact Support: immediately
Provide Hash: transaction hash
Act Quickly: time-sensitive
Address Issues
Invalid Address Format
Shielded Address Issues
Check format: Must start with
zs1orz1Verify length: Check address length
Copy correctly: Ensure full address copied
Transparent Address Issues
Check format: Must start with
t1ort3Verify length: Check address length
Copy correctly: Ensure full address copied
Address Verification
Double-check: Always verify addresses
Use tools: Use address verification tools
Test small: Test with small amount first
Getting Help
Information to Provide
Support Channels
Email: [email protected]
Documentation: Check documentation first
FAQ: Review FAQ for common issues
Status Page: Check for known issues
Prevention Tips
Best Practices
Before Each Transaction
Security Reminders
Never share seed phrases or private keys
Always verify you're on official site
Double-check all addresses before sending
Use hardware wallets for large amounts
Keep wallet software updated
Additional Resources
FAQ - Common questions and answers
Getting Started - Setup guide
Security - Security best practices
Supported Networks - Network information
Still need help? Contact support at [email protected] with detailed information about your issue.
Last updated