cBridge Canonical Token Transfer (mint & burn)

Search…
Terminology
The followings are used to describe cBridge transfer flow
The Original Chain is the chain which supports the original token
The Pegged Chain is the chain which has not supported original token yet. 
The Original Token is the existing token on the source chain
The Pegged Token is the original token mapping on the pegged chain. The rate between original token and pegged token is 1:1
The Original Token Vault is a contract deployed on the source chain locking and sending back user's assets
The Pegged Token Bridge is a contract deployed on the pegged chain minting and burning pegged token for users.
Flow Phrases 
Mint(Deposit)
A user submit on-chain deposit/mint request to the OriginalTokenVault contract on source chain. Then user's original tokens will be moved and locked in the OriginalTokenVault contract. Celer SGN will coordinate pegged token mint in PeggedTokenBridge contract and move generated tokens into user's wallet address
Burn(Withdraw)
A user submit on-chain burn/withdraw request to the PeggedTokenBridge contract on pegged chain. Then user's pegged tokens will be moved and burnt in the PeggedTokenBridge contract. Celer SGN will coordinate original tokens unlock and send back to user's wallet address in OriginalTokenVault bridge on source chain.
During the communication between you and cBridge gateway, you need to indicate it is a mint&burn transfer flow. Otherwise, cBridge gateway will treat it as a general pool-based transfer and may lead to unexpected error
1
// By refering pegged_pair_configs, we can determine whether 
2
// it is a pegged transfer. 
3
Scenario A:
4
   5 <---> 69 Domi ====> Pool-Based Transfer
5
Scenario B:
6
   5 <---> 97 Domi ====> Mint&Burn Transfer
7
​
8
"chains": [
9
    {
10
      "id": 5,
11
      "name": "Goerli",
12
      "icon": "https://get.celer.app/cbridge-icons/ETH.png",
13
      "block_delay": 5,
14
      "gas_token_symbol": "ETH",
15
      "explore_url": "https://goerli.etherscan.io/",
16
      //cbridge contract
17
      "contract_addr": "0x358234B325EF9eA8115291A8b81b7d33A2Fa762D",
18
      "drop_gas_amt": "0",
19
      "suggested_gas_cost": "0",
20
      "drop_gas_cost_amt": "0"
21
    },
22
    {
23
      "id": 69,
24
      "name": "Optimistic Kovan",
25
      "icon": "https://get.celer.app/cbridge-icons/chain-icon/OP.jpg",
26
      "block_delay": 8,
27
      "gas_token_symbol": "ETH",
28
      "explore_url": "https://kovan-optimistic.etherscan.io/",
29
      //cbridge contract
30
      "contract_addr": "0x265B25e22bcd7f10a5bD6E6410F10537Cc7567e8",
31
      "drop_gas_amt": "0",
32
      "suggested_gas_cost": "0",
33
      "drop_gas_cost_amt": "0"
34
    },
35
    {
36
      "id": 97,
37
      "name": "BSC Testnet",
38
      "icon": "https://get.celer.app/cbridge-icons/chain-icon/BSC.png",
39
      "block_delay": 8,
40
      "gas_token_symbol": "BNB",
41
      "explore_url": "https://testnet.bscscan.com/",
42
      "contract_addr": "0xf89354F314faF344Abd754924438bA798E306DF2",
43
      "drop_gas_amt": "2000000000000000",
44
      "suggested_gas_cost": "125624",
45
      "drop_gas_cost_amt": "100000000000000"
46
    },
47
  ]
48
{
49
  "token": {
50
      "symbol": "CELR",
51
      "address": "0x5D3c0F4cA5EE99f8E8F59Ff9A5fAb04F6a7e007f",
52
      "decimal": 18,
53
      "xfer_disabled": false
54
    },
55
    "name": "Celer Network",
56
    "icon": "https://get.celer.app/cbridge-icons/celr.png"
57
  },
58
  {
59
    "token": {
60
      "symbol": "DOMI",
61
      "address": "0x646Ff87BE4F232C555c264465007f3AAE7a5626e",
62
      "decimal": 18,
63
      "xfer_disabled": false
64
    },
65
    "name": "Domi",
66
    "icon": "https://get.celer.app/cbridge-icons/Domi.png"
67
  },
68
}
69
​
70
"pegged_pair_configs": [
71
    {
72
      "org_chain_id": 5,
73
      "org_token": {
74
        "token": {
75
          "symbol": "DOMI",
76
          "address": "0x646Ff87BE4F232C555c264465007f3AAE7a5626e",
77
          "decimal": 18,
78
          "xfer_disabled": false
79
        },
80
        "name": "Domi",
81
        "icon": "https://get.celer.app/cbridge-icons/Domi.png"
82
      },
83
      "pegged_chain_id": 97,
84
      "pegged_token": {
85
        "token": {
86
          "symbol": "DOMI",
87
          "address": "0x472c1c7147F335C97066eA59fa548aCeAc1F5b58",
88
          "decimal": 18,
89
          "xfer_disabled": false
90
        },
91
        "name": "Domi",
92
        "icon": "https://get.celer.app/cbridge-icons/Domi.png"
93
      },
94
      "pegged_deposit_contract_addr": "0x12E25Cd0787Bab0cC84C800a301615883Ef0C384",
95
      "pegged_burn_contract_addr": "0xcb1dB69399755Cf8A9EbE8A3033f3082793b67eB"
96
    },
97
  ]
Copied!
Transfer Refund
Mint
Last modified 4mo ago
Copy link
Contents
Terminology
Flow Phrases