How to complete a crosschain transaction (XRP)
An in-depth guide outlining how to complete an XRP crosschain transaction using both the Wanchain Desktop Wallet and the WanBridge web portal
This guide will demonstrate four separate crosschain transactions:
- $XRP from Wanchain to XRP Ledger using the Wanchain Desktop Wallet
- $XRP from XRP Ledger to Wanchain using the Wanchain Desktop Wallet
- $XRP from Wanchain to XRP Ledger using the WanBridge web portal with Metamask
- $XRP from XRP Ledger to Wanchain using the WanBridge web portal
Note: XRP Ledger requires a 10 XRP wallet minimum balance, this means that once you send XRP to your address, it will “lock” 10 XRP as a minimum reserve. Read more about it here: https://xrpl.org/reserves.html
Crosschain transactions using the Wanchain Desktop Wallet
$XRP crosschain transaction from Wanchain to XRP Ledger
Step 1: Enable wanXRP and XRP on the Wanchain Desktop Wallet.
Navigate to Wallet → More Tokens.
Scroll down until you see XRP. Then, click the stars next to wanXRP and XRP. As in the screenshot below.
$XRP and $wanXRP wallets are now enabled and appear in your portfolio overview.
Step 2: Enabling XRP crosschain functionality.
Navigate to Cross Chain → More Tokens.
Scroll down until you see XRP. Then, click the star next to XRPL <-> Wanchain. As in the screenshot below.
Step 3: Initiate a crosschain transaction to move your $XRP from Wanchain to XRP Ledger.
Navigate to Cross Chain → XRP → XRPL <-> Wanchain
Since you are moving $XRP from Wanchain to XRP Ledger, click “Convert” next to your wanXRP balance, as in the screenshot below. $XRP on Wanchain is called $wanXRP.
Select which of your $XRP wallets you would like to receive the $XRP on XRP Ledger, enter the amount of $wanXRP to convert, then click “Next”. Optionally, you can select “Send Everything” to move your entire $wanXRP balance to XRP Ledger.
Confirm that all the details are correct then click “Send”. This will initiate the crosschain transaction.
Step 4: Wait for your crosschain transaction to complete. It is now processing.
While your crosschain transaction is processing, the status will change three times:
- Lock Request Sent — A lock request has been sent to Wanchain’s bridge nodes.
- Locked — Your wanXRP is now locked with Wanchain’s bridge nodes.
- Success — Your crosschain transaction is now complete.
Note: The speed of the crosschain transaction is entirely dependent on the networks involved. Transactions involving slower networks like Bitcoin or Ethereum may take several minutes or more to complete.
While your crosschain transaction is processing, you can click the status to view more detailed information.
Step 5: Confirm the receipt of your funds. Your crosschain transaction is now complete!
Once your transaction is complete, you’ll see your XRP balance update, and the crosschain transaction status change to “success”.
$XRP crosschain transaction from XRP Ledger to Wanchain
Step 1: Initiate a crosschain transaction to move your $XRP from XRP Ledger to Wanchain.
Navigate to Cross Chain → XRP → XRPL <-> Wanchain
Since you are moving $XRP from XRP Ledger to Wanchain, click “Convert” near your XRP balance, as in the screenshot below.
Select which of your $WAN wallets you would like to receive the $wanXRP on Wanchain, enter the amount of $XRP to convert, then click “Next”. Optionally, you can select “Send Everything” to move your entire $XRP balance to Wanchain.
Confirm that all the details are correct then click “Send”. This will initiate the crosschain transaction.
Step 2: Wait for your crosschain transaction to complete. It is now processing.
While your crosschain transaction is processing, the status will change three times:
- Lock Request Sent — A lock request has been sent to Wanchain’s bridge nodes.
- Locked — Your wanXRP is now locked with Wanchain’s bridge nodes.
- Success — Your crosschain transaction is now complete.
Note: The speed of the crosschain transaction is entirely dependent on the networks involved. Transactions involving slower networks like Bitcoin or Ethereum may take several minutes or more to complete.
You’ll also notice ~10 XRP has been “locked” as the XRP wallet minimum balance as described at the beginning of this guide.
While your crosschain transaction is processing, you can click the status to view more detailed information as we did before.
Step 3: Confirm the receipt of your funds. Your crosschain transaction is complete!
Once your crosschain transaction is complete, you’ll see your $XRP balance on XRP Ledger update, and the crosschain transaction status change to “success”.
Crosschain transactions using the WanBridge web portal
$XRP crosschain transaction from Wanchain to XRP Ledger
Step 1: Make sure you have the appropriate wallets installed.
Before completing decentralised crosschain transactions using the WanBridge web portal, you need to ensure you have access to the correct wallet(s). You must have wallets for each network involved in the crosschain transaction. Metamask is a fantastic wallet that grants you access to any EVM-compatible blockchain networks.
Step 2: Visit the WanBridge web portal and connect your wallet.
Click “Connect to Wallet”.
Click “Metamask”.
If this is your first time using the WanBridge web portal, you will first need to give permission to connect your wallet. Follow the MetaMask prompts by clicking “Next” then “Connect” as instructed.
Step 3: Initiate a crosschain transaction to move your $XRP from Wanchain to XRP Ledger.
Select “XRP” from the drop-down menu. Then, choose “Wanchain” and “XRP Ledger” as your From and To networks, respectively. Finally, input your destination address in the “Recipient” field as well as the amount of $XRP you want to send crosschain. Click “Next”.
Confirm that the “Recipient” address does not belong to a centralised exchange then click “Confirm”.
Confirm that all the details are correct then click “Confirm”
Confirm the transaction by clicking “Confirm” in the MetaMask pop-up window.
Step 4: Wait for your crosschain transaction to complete. It is now processing.
While your crosschain transaction is processing, the status will change three times:
- Processing (1/2)
- Processing (2/2)
- Success
Note: The speed of the crosschain transaction is entirely dependent on the networks involved. Transactions involving slower networks like Bitcoin or Ethereum may take several minutes or more to complete.
Step 5: Confirm the receipt of your funds. Your crosschain transaction is complete!
Once your crosschain transaction is complete, you’ll see your $XRP balance on your XRP Ledger address, and the crosschain transaction status change to “Success”.
$XRP crosschain transaction from XRP Ledger to Wanchain
Step 1: Make sure you have the appropriate wallets installed.
Before completing decentralised crosschain transactions using the WanBridge web portal, you need to ensure you have access to the correct wallet(s). You must have wallets for each network involved in the crosschain transaction. When transferring from networks that do not support native smart contracts, you will be instructed to manually send a transaction to initiate the crosschain transaction. It is highly recommended to only use a wallet that you own and control.
Step 2: Visit the WanBridge web portal.
Step 3: Initiate a crosschain transaction to move your $XRP from XRP Ledger to Wanchain.
Select “XRP” from the drop-down menu. Then, choose “XRP Ledger” and “Wanchain” as your From and To networks, respectively. Finally, input your destination address in the “Recipient” field as well as the amount of $XRP you want to send crosschain. Click “Next”.
Confirm that the “Recipient” address does not belong to a centralised exchange then click “Confirm”.
Confirm that all the details are correct then click “Confirm”.
Read the warning and click “Confirm”.
Step 4: Manually send your $XRP to the One-time Address.
Copy the One-time Address along with the tag ID and manually transfer the listed amount of $XRP using the XRP wallet of your choice. It is highly recommended to use an XRP wallet that you own and control.
Note: Be sure to send the correct amount of $XRP, as indicated. Send the entire amount as ONE transaction. Make sure to inlcude the tag ID.
Read the warning and click “Confirm”.
Step 5: Wait for your crosschain transaction to complete. It is now processing.
While your crosschain transaction is processing, the status will change three times:
- Processing (1/2)
- Processing (2/2)
- Success
Note: The speed of the crosschain transaction is entirely dependent on the networks involved. Transactions involving slower networks like Bitcoin or Ethereum may take several minutes or more to complete.
Step 6: Confirm the receipt of your funds. Your crosschain transaction is complete!
Once your crosschain transaction is complete, you’ll see your $XRP balance on Wanchain (called $wanXRP), and the crosschain transaction status change to “Success”.
Need help?
Join our Telegram Tech Support channel. Our support team is standing by and happy to help!
Note: If you receive a DM offering help, block them immediately. Admins will never DM you first! Never share your seed words with anyone, period.
About Wanchain
We are all connected — Wanchain, the Wide Area Network chain, is the world’s premier decentralised blockchain interoperability solution. Our mission is to drive blockchain adoption through interoperability by building fully decentralised bridges that connect the world’s many siloed blockchain networks. This crosschain infrastructure empowers developers to build truly decentralised crosschain applications to power the future of Web3.
Website | Bridge | Documentation | Telegram | Twitter | Newsletter | Blockchain Explorer | Developer Portal
