Skip to content

RosenBridge Troubleshooting Guide#

This guide helps diagnose and resolve the most common issues users see when bridging with Rosen. It complements the FAQs and Watcher/Guard docs with practical checks and fixes.

See also:

Useful links:

My event looks stuck#

Symptoms:

  • Event shows “pending,” “detected,” or similar for a long time
  • No “approved” or “signed” state after a reasonable period

Checks:

  • Confirmations: Verify your source-chain transaction has enough confirmations. Bridge timing depends on chain policy (e.g., BTC takes longer).
  • Events page: Check https://app.rosen.tech/events for updates and error notes.
  • Congestion: EVM gas spikes or network congestion can delay finality.
  • Large transfers: Very large amounts may require cold hot fund movements by Guards; this can take hours to 1–2 days.

If it remains delayed far beyond normal windows, contact official support channels (Telegram/Discord) with:

  • Source/target chains and tx hashes
  • Destination address
  • Time initiated

“Insufficient ERG” but I have funds#

Cause:

  • Your wallet UTXOs may be fragmented into many small boxes, causing insufficient available value for fees in a single transaction.

Fix:

  • Use wallet optimization / consolidation (e.g., Nautilus “Wallet Optimization”).
  • Try reducing concurrent transactions so available inputs are not locked by pending txs.

More background: fees-and-dust.md

rsToken not visible on target chain#

Symptoms:

  • Bridged completed, but token not shown by your wallet/DEX

Checks:

  • Verify token on official Asset List: https://app.rosen.tech/assets
  • For EVMs, add the token contract manually in your wallet (MetaMask etc.).
  • For Cardano/Ergo, ensure your wallet supports the asset standard and is fully synced.

Never trust token addresses from chats/DMs; always cross-check with the official Asset List.

EVM approval or “allowance” issues#

Symptoms:

  • Unable to swap/provide LP; DEX asks for repeated approvals

Checks:

  • Reset/cancel stuck pending approvals in your wallet
  • Use chain explorers’ approval checkers (e.g., BscScan Token Approval Checker)
  • Ensure you’re on the correct network and the token contract matches the Asset List

High or unexpected fees#

Symptoms:

  • Total fees higher than expected

Understand the fee components:

  • Bridge fee: Greater of $10 or 0.5% of transfer value (adjustable by guard set)
  • Network fees: Source/target chain network fees (static on Ergo/Cardano, dynamic on EVMs)

Tips:

  • Batch actions (where safe) on EVMs to reduce gas overhead
  • Avoid tiny transfers that are uneconomical after fees
  • See fees-and-dust.md

Long BTC/UTXO chain delays#

Bitcoin & other UTXO chains:

  • Delays are normal during fee spikes/mempool congestion
  • Watchers require conservative confirmations before proceeding
  • If using a self-run node (for Watchers), Bitcoin must be full with txindex=1 (not pruned). See bitcoin-watcher.md

Wrong destination address or chain#

If you provided an incorrect destination address or selected the wrong target chain:

  • Transactions are final; Rosen cannot reroute assets post-finality
  • Provide the full details to support immediately; outcomes depend on chain and status
  • Always copy addresses from your wallet; avoid hand-typing

Event “approved” but no finalization#

Symptoms:

  • Approved event box visible but no signed/broadcast transaction yet

Checks:

  • Guard validation/signature collection is in progress; timing varies with chain and load
  • Large-value transfers can be delayed for additional checks or liquidity positioning
  • Continue monitoring https://app.rosen.tech/events

Cardano/Ergo wallet synchronization issues#

Symptoms:

  • Wallet doesn’t show the bridged asset or updated balance

Fix:

  • Ensure wallet fully synced to tip
  • Restart wallet app; some wallets cache state
  • Re-import account in extreme cases (with seed); verify balances in explorer first

Bridged token appears but DEX refuses to list/swap#

  • DEXs may need token metadata or listing; permissionless DEXs usually accept by contract
  • Verify the token contract and decimal settings
  • Some curated venues require a manual listing process

Troubleshooting matrix#

  • Delayed events: Check confirmations → Events page → Chain congestion → Large-value transfers → Support
  • Wallet errors (insufficient ERG): Consolidate UTXOs → Retry
  • Token visibility: Verify Asset List → Add token contract in wallet → Sync wallet
  • EVM approvals: Reset approvals → Use official approval checkers → Confirm correct network/contract
  • Watcher operators: see watcher setup and FAQ for logs, volumes, health, minBoxValue, and architecture-specific issues.

When to escalate#

Prepare:

  • Source chain tx hash and target chain tx hash (if any)
  • Destination address and asset
  • Event URL from https://app.rosen.tech/events
  • Timestamps and screenshots

Contact:

  • Public Telegram/Discord channels listed on the Rosen site or dApp