Troubleshooting
Common issues and how to resolve them.
Token doesn't appear in search
This is expected for non-EVM chains (Solana, Bitcoin, Tron), they support only specific pre-configured tokens. Paste the token's contract address directly into the search field. If it still doesn't find it, that token isn't supported.
Fix: Paste the token address directly, or swap to a supported token first (USDC, USDT, etc.) then bridge to dmfUSD on Base.
Wallet not connecting
EVM wallets connect via the DMF App Connect. For non-EVM (Solana), you must first select a token on that chain, the widget will then prompt you to connect the appropriate wallet. Bitcoin and Tron require their respective wallets (Leather/Xverse, TronLink).
Fix: For Solana: select a Solana token first, then the widget shows the Connect flow for Phantom/Backpack.
Transaction stuck or failed
Cross-chain transactions can take 30 seconds to 5 minutes. If it's been longer, check the transaction on the source chain explorer. Common failure reasons: insufficient gas, slippage too low, or the route expired.
Fix: Increase slippage tolerance slightly, ensure you have enough native gas token, and retry. Same-chain swaps should be instant, if stuck, refresh and try again.
Received less than expected
The displayed estimate includes all fees (solver fee + DMF app fee). The final amount may differ slightly due to price movement during execution, especially for cross-chain routes that take longer.
Fix: The difference is typically small. If it's significantly off, check the route details before confirming next time.
Solana/Bitcoin/Tron options don't show
The widget shows wallet options based on the selected token's chain. If no token is selected, it defaults to EVM. Pick a token on your desired chain first.
Fix: Click SELECT TOKEN on the Sell side, search for or paste a token address on the chain you want to use.