xDai - DAI Bridge - Etherspot

Search…
xDai - DAI Bridge
Transfer xDai on xDai to DAI on Mainnet using Etherspot SDK
Before we continue, please ensure that you have had a look at our Supported Ethereum Chains, followed the steps in Install Etherspot SDK and how to Bootstrap Etherspot SDK. We're assuming that you have completed these steps before going forward.
In this example, we're going to show you how to send xDai to Dai using their TokenBridge and Etherspot. 
​🛑
 Before we continue...
We're going to be using two Etherspot SDK instances here:
A mainnet version
​↗
 We will use this instance to send our DAI from and ETH to pay the gas fees.
A xDai version
​↘
 We will use this instance to receive our xDai on the xDai chain.
​⚠
 Make sure you've checked out Supported Ethereum Chains before you continue as we also show you the code to instantiate mainnet and xDai versions of the SDK. Remember to use the same private key for both SDK instances to get the same Ethereum address on both mainnet and xDai.
This example use case is more complex than the previous guide in this series: DAI - xDai Bridge, but completes the cycle of DAI↔
xDai. 
Please make sure your that your xDai Etherspot address is funded with enough xDAI to pay the gas fees required.
Sending xDai to TokenBridge
The first step in our journey to change xDai back to DAI is to send our xDai, using the xDai version of the Etherspot SDK, to the xDai TokenBridge.
Let's define our required variables:
1
/**
2
* Note: Make sure that your `mainnet` and `xDai`
3
* instances of the Etherspot SDK are available here.
4
*
5
* For the purposes of this demonstration, we're going
6
* to assume the following:
7
* 
8
* The mainnet Etherspot SDK:
9
* - const mainnetEtherspotSdk
10
*
11
* The xDai Etherspot SDK:
12
* - const xdaiEtherspotsdk
13
*/
14
​
15
import { ethers } from 'etherspot';
16
const xdaiBridgeAddress = "0x7301CFA0e1756B71869E93d4e4Dca5c7d0eb0AA6";
17
const xdaiBridgeContract = "0x6A92e97A568f5F58590E8b1f56484e6268CdDC51";
18
// Visit https://blockscout.com/xdai/mainnet/address/0x6A92e97A568f5F58590E8b1f56484e6268CdDC51/contracts.
19
// Under the "Code" tab, scroll down to "Contract ABI" 
20
// and copy the code into a JSON file and import it here.
21
const xdaiBridgeAbi = require('xDaiBridgeAbi.json');
22
​
23
const daiContractAddress = "0x4aa42145Aa6Ebf72e164C9bBC74fbD3788045016";
24
// Visit https://etherscan.io/address/0x7e7669bdff02f2ee75b68b91fb81c2b38f9228c2#code and scroll down to Contract ABI and copy the whole code and paste it in a JSON file and import it to this variable.
25
const daiContractAbi = require('daiContractAbi.json');
Copied!
Next, let's specify how much xDai we would like to send.
1
// Note: TokenBridge requires a minimum of 10 xDai
2
let xdaiTransferAmount = ethers.utils.parseEther("10");
Copied!
​🧹
 Let's ensure that we have no batches of transactions waiting in the queue to be sent. We like to keep the house clean.
1
await xdaiEtherspotsdk
2
  .clearGatewayBatch()
3
  .catch(console.error);
Copied!
Next, we're going to perform a series of steps to:
1.
Add the transaction to the batch
2.
Estimate the gas required to submit and execute this batch
3.
Send the batch to Etherspot to be processed
4.
Check to see when the transaction has been sent
1
/**
2
* Step 1: Add the transaction to a clean
3
* "batch" of transactions.
4
*
5
* Note: You can batch many transactions together and
6
* submit them as one request for a more gas-efficient
7
* operation. Here, we're just adding 1 transaction to
8
* this batch.
9
*/
10
const batchResponse = await xdaiEtherspotsdk
11
  .batchExecuteAccountTransaction({
12
    to: xdaiBridgeAddress,
13
    value: xdaiTransferAmount
14
  })
15
  .catch(console.error);
16
  
17
/**
18
* Step 2: Estimate the gas required to perform this
19
* operation. This is useful for presenting to users
20
* and allowing them to make a final decision.
21
*/
22
const estimateResponse = await xdaiEtherspotsdk
23
  .estimateGatewayBatch()
24
  .catch(console.error);
25
  
26
/**
27
* Step 3: Next, send this batch to Etherspot for
28
* processing. We'll manage the transaction, queuing,
29
* retries and endevour to do whatever it takes to
30
* get this transaction on the chosen blockchain.
31
*/
32
const submitGatewayResponse = await xdaiEtherspotsdk
33
  .submitGatewayBatch()
34
  .catch(console.error);
35
  
36
/**
37
* Step 4: Let's keep checking on this batch submission
38
* to check the status before we move on. Keep calling
39
* this method below, using an Interval timer for example,
40
* and move on to the next step when gatewayBatchStatus.state
41
* is "Sent".
42
*/
43
const gatewayBatchStatus = await xdaiEtherspotsdk
44
  .getGatewaySubmittedBatch({
45
    hash: submitGatewayResponse.hash,
46
  })
47
  .catch(console.error);
Copied!
gatewayBatchStatus.state
meaning
"Sent"
The transactions that existed in the batch are due to be confirmed.
"Sending"
The transactions that existed in the batch are currently pending broadcast on the blockchain.
"Queued"
The transactions that existed in the batch are queued by Etherspot to be processed.
Get TokenBridge Signature
Once gatewayBatchStatus.state is equal to "Sent", indicating that the transactions in the batch are due to be confirmed, we'll lift the hash of the transaction into its own variable.
1
const xDaiSubmissionHash = gatewayBatchStatus.transaction.hash;
Copied!
Next, we need to construct an instance of the xDai bridge contract from the ethers library. We'll communicate with the contract to fetch the required data to continue.
1
const xDaiTokenBridgeContract = await new ethers.Contract(
2
  xdaiBridgeContract,
3
  xdaiBridgeAbi, 
4
  new ethers.providers.JsonRpcProvider(
5
    "https://rpc.xdaichain.com/",
6
  ),
7
);
Copied!
Next, we're going to perform three steps:
1.
Query the contract for a corresponding message hash for xDai amount and the xDai Etherspot address
2.
Use the message hash from the previous point to get a message payload from the contract
3.
Check if the message payload is valid, and then get the required signature to continue.
1
/**
2
* Step 1: Query the contract for the corresponding
3
* message hash
4
*/
5
const messageHash = await contract.getMessageHash(
6
  xdaiEtherspotsdk.state.accountAddress, // Your xDai Etherspot address
7
  xdaiTransferAmount.toString(),
8
  xDaiSubmissionHash, 
9
);
10
​
11
/**
12
* Step 2: Use the message hash to fetch the
13
* message payload itself
14
*/
15
let messagePayload = await contract.getMessage(messageHash);
16
​
17
/**
18
* Step 3: Let's do a basic check to ensure that the
19
* available tokens are still available to withdraw
20
*/
21
let signature = null;
22
if (messagePayload != "0x" && messagePayload != "0x0") {
23
  signature = await contract
24
    .getSignatures(
25
      ethers.utils.keccak256(messagePayload)
26
    );
27
} else {
28
  console.error('Please check the contract payload parameters.');
29
}
Copied!
Once the transaction above gets confirmed, pass the required parameters along with the hash of the transaction made earlier to the contract methods to get the signature from token bridge. 
Withdraw DAI from TokenBridge to Etherspot address
In this final section, we're going to initiate a move from the DAI contract address to our own Etherspot address on mainnet - it's final destination.
First, let's construct a contract interface to communicate with the DAI contract:
1
// First, construct the interface...
2
const daiInterface = new ethers.utils.Interface(daiContractAbi); 
3
​
4
// Next, encode the required data to perform the withdrawal
5
let encodedData = await daiInterface.encodeFunctionData(
6
  "executeSignatures",
7
  [messagePayload, signature],
8
);
Copied!
​🧹
 Let's ensure that we have no batches of transactions waiting in the queue to be sent. We like to keep the house clean.
1
await xdaiEtherspotsdk
2
  .clearGatewayBatch()
3
  .catch(console.error);
Copied!
Now, we have completed all the required prerequisites to withdraw the DAI from TokenBridge. We're going to perform a series of steps to:
1.
Add the transaction to the batch
2.
Estimate the gas required to submit and execute this batch
3.
Send the batch to Etherspot to be processed
1
/**
2
* Step 1: Add the transaction to a clean
3
* "batch" of transactions.
4
*
5
* Note: You can batch many transactions together and
6
* submit them as one request for a more gas-efficient
7
* operation. Here, we're just adding 1 transaction to
8
* this batch.
9
*/
10
const daiBatchResponse = await mainnetEtherspotSdk
11
  .batchExecuteAccountTransaction({
12
    to: daiContractAddress,
13
    data: encodedData,
14
  })
15
  .catch(console.error);
16
​
17
/**
18
* Step 2: Estimate the gas required to perform this
19
* operation. This is useful for presenting to users
20
* and allowing them to make a final decision.
21
*/
22
const daiBatchEstimation = await mainnetEtherspotSdk
23
  .estimateGatewayBatch()
24
  .catch(console.error);
25
  
26
/**
27
* Step 3: Next, send this batch to Etherspot for
28
* processing. We'll manage the transaction, queuing,
29
* retries and endevour to do whatever it takes to
30
* get this transaction on the chosen blockchain.
31
*/
32
const daiBatchTransaction = await mainnetEtherspotSdk
33
  .submitGatewayBatch()
34
  .catch(console.error);
Copied!
​🎉
 Finished!
DAI - xDai Bridge
Native Token Bridge
Last modified 3mo ago
Copy link
Contents
Before we continue...
Sending xDai to TokenBridge
Get TokenBridge Signature
Withdraw DAI from TokenBridge to Etherspot address
Finished!
​🛑 Before we continue...

Sending xDai to TokenBridge

Get TokenBridge Signature

Withdraw DAI from TokenBridge to Etherspot address

​🎉 Finished!

🛑
Before we continue...

🎉
Finished!
