How to complete a crosschain transaction (XRPL tokens)

Wanchain
Wanchain
Published in
9 min readOct 13, 2022

An in-depth guide outlining how to complete XRPL token crosschain transactions using the WanBridge web portal with MetaMask and XUMM Wallet.

This guide will demonstrate two separate crosschain transactions:

  1. $xBIBLx from Wanchain to the XRP Ledger using the WanBridge web portal with Metamask
  2. $xBIBLx from the XRP Ledger to the XDC Network using the WanBridge web portal
  3. $xBIBLx from the XDC Network to the XRP Ledger using the WanBridge web portal with XDC Pay

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 WanBridge web portal

$xBIBLx crosschain transaction from Wanchain to the 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. Xumm Wallet is a mobile wallet that grants you access to XRP Ledger.

Download Metamask here.

Download Xumm here.

Step 2: Make sure you have a trust line for xBIBLx set up on your XRPL account.

Before you complete an XRPL token crosschain transfer, you must ensure you have a trust line set up with a particular asset on the XRPL.

Trust lines are structures in the XRP Ledger for holding tokens. Trust lines enforce the XRP Ledger’s rule that you cannot cause someone else to hold a token they don’t want. In other words, only after establishing the trust line can a user receive a particular asset. Trust lines record a token’s issuer, currency and limit.

Trust lines can be setup using a variety of tool and wallets, including Xumm Wallet. Please see this guide to for full details.

Note: This step is very important! Your account on the XRPL can not receive a non-XRP token without first establishing a trust line.

Step 3: 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 4: Initiate a crosschain transaction to move your $xBIBLx from Wanchain to the XRP Ledger.

Select “xBIBLx” 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 $xBIBLx 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 spend permission request by clicking “Confirm” in the MetaMask pop-up window.

Confirm the transaction by clicking “Confirm” in the MetaMask pop-up window.

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 $xBIBLx balance on XRP Ledger, and the crosschain transaction status change to “Success”.

$xBIBLx crosschain transfer from XRP Ledger to XDC Network.

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.

Metamask is a fantastic wallet that grants you access to any EVM-compatible blockchain networks. Xumm Wallet is a mobile wallet that grants you access to XRP Ledger.

Download Metamask here.

Download Xumm here.

Step 2: Visit the WanBridge web portal.

Step 3. Initiate a crosschain transaction to move your $xBIBLx from the XRP Ledger to the XDC Network.

Select “xBIBLx” from the drop-down menu. Then, choose “XRP Ledger” and “XDC Network” as your From and To networks, respectively. Finally, input your destination address in the “Recipient” field as well as the amount of $xBIBLx 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 $xBIBLx to the One-time Address.

Copy the One-time Address along with the Tag ID and manually transfer the listed amount of $xBIBLx using the XRP wallet of your choice. Alternatively, you may toggle the address and use the X address format. It is highly recommended to use an XRP wallet that you own and control.

Note: Be sure to send the correct amount of $xBIBLx, as indicated. Send the entire amount as ONE transaction. Make sure to include the tag ID if using the traditional XRPL address format.

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 $xBIBLx balance on XDC Network, and the crosschain transaction status change to “Success”.

$xBIBLx crosschain transfer from the XDC Network to the 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. XDC Pay is a web wallet similar to Metamask that grants you access to XDC Network.

Download XDC Pay here.

Step 2: Make sure you have a trust line for xBIBLx set up on your XRPL account.

Before you complete an XRPL token crosschain transfer, you must ensure you have a trust line set up with a particular asset on the XRPL.

Trust lines are structures in the XRP Ledger for holding tokens. Trust lines enforce the XRP Ledger’s rule that you cannot cause someone else to hold a token they don’t want. In other words, only after establishing the trust line can a user receive a particular asset. Trust lines record a token’s issuer, currency and limit.

Trust lines can be setup using a variety of tool and wallets, including Xumm Wallet. Please see this guide to for full details.

Note: This step is very important! Your account on the XRPL can not receive a non-XRP token without first establishing a trust line.

Step 3: Visit the WanBridge web portal and connect your wallet.

Click “Connect to Wallet”.

Click “XDCPay”.

Step 4: Initiate a crosschain transaction to move your $xBIBLx from the XDC Network to the XRP Ledger.

Select “xBIBLx” from the drop-down menu. Then, choose “XDC Network” 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 $xBIBLx 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 spend permission request by clicking “Submit” in the XDC Pay pop-up window.

Confirm the transaction by clicking “Submit” in the XDC Pay pop-up window.

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 $xBIBLx balance on XRP Ledger, 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 1 | Blockchain Explorer 2 | Developer Portal

--

--

Wanchain
Wanchain

The world’s premier decentralised blockchain interoperability solution. Wanchain’s cross-chain infrastructure empowers developers to build the future of Web3.