BC <-> BSC Token Bridge
!!! Note Please note that BC <-> BSC Token Bridge is a module of BNB Beacon Chain fullnode to facilitate cross-chain transfer between BNB Beacon Chain and BNB Smart Chain , while Binance Bridge, a bridge service providing access to inter-blockchain liquidity for BNB Beacon Chain , BNB Smart Chain decentralized applications, and bring valuable assets to BNB Beacon Chain ecosystems.
What is BC <-> BSC bridge
BC <-> BSC token bridge for self transfers of BEP2 tokens to BEP20 (ERC20 representation). The BC <-> BSC bridge connects two chains (BC and BSC). When a user deposits BEP2 into the BC <-> BSC bridge contract contract on BC they get the same amount of BEP20 tokens on BSC, and they can convert them back as well.
A purely-code-controlled escrow account is a kind of account which is derived from a hard-coded string in BNB Beacon Chain protocol. This kind of account doesn't have its own private key and it's only controlled by code in protocol. The code for calculating escrow account is the same as how it's done in cosmos-sdk:
AtomicSwapCoinsAccAddr = sdk.AccAddress(crypto.AddressHash([]byte("BinanceChainPegAccount")))
The account for mainnet is: bnb1v8vkkymvhe2sf7gd2092ujc6hweta38xadu2pj and the account for testnet is: tbnb1v8vkkymvhe2sf7gd2092ujc6hweta38xnc4wpr. Once the swap is claimed or refunded, the fund will be transferred from the purely-code-controlled escrow account to client accounts.
Fee Table
| Transaction Type | Pay in BNB |
|---|---|
| BC <-> BSC Bridge Bind | 0.01 |
| Transfer Out | 0.01 |
| BC <-> BSC Bridge Bind Relayer Fee | 0.01 |
| Transfer Out Relayer Fee | 0.01 |
Commands
Download
Please download tbnbcli binary from here
Bind
Parameters for BC <-> BSC bridge bind
| parameter name | example | comments | required |
|---|---|---|---|
| --chain-id | Binance-Chain-XXX | the chain id of binance chain | Yes |
| --from | alice | account name | Yes |
| --symbol | DEF-0E9 | chain-id of the side chain the validator belongs to | Yes |
| --amount | 1000000000 | amount of tokens to bind | Yes |
| --contract-address | 0x6aade9709155a8386c63c1d2e5939525b960b4e7 | contract address of token in smart chain | Yes |
| --contract-decimals | 18 | decimals of token in smart chain | Yes |
| --expire-time | 1594715271 | timestamp of bind expire time | Yes |
For example
- Mainnet
bnbcli bridge bind --symbol DEF-0F9 --amount 6000000000000000 --expire-time 1594715271 --contract-decimals 18 --from alice --chain-id Binance-Chain-Tigris --contract-address 0x6aade9709155a8386c63c1d2e5939525b960b4e7 --home ~/home_cli
Unbind
Parameters for BC <-> BSC bridge unbind
| parameter name | example | comments | required |
|---|---|---|---|
| --chain-id | Binance-Chain-XXX | the chain id of binance chain | Yes |
| --from | alice | account name | Yes |
| --symbol | DEF-0E9 | chain-id of the side chain the validator belongs to | Yes |
For example
- Mainnet
bnbcli bridge unbind --symbol DEF-0F9 --from alice --chain-id Binance-Chain-Tigris --home ~/home_cli
Transfer out
Parameters for BC <-> BSC bridge transfer-out
| parameter name | example | comments | required |
|---|---|---|---|
| --chain-id | Binance-Chain-XXX | the chain id of binance chain | Yes |
| --from | alice | account name | Yes |
| --to | 0xf9f609f9f4309f191654aa1fd691a6be6aefa7ac | receiver address in smart chain | Yes |
| --amount | 1000000000:BNB (10 BNB) | amount of token to transfer | Yes |
| --expire-time | 1594715271 | timestamp of transfer out expire time | Yes |
For example
- Mainnet
bnbcli bridge transfer-out --to 0xf9f609f9f4309f191654aa1fd691a6be6aefa7ac --expire-time 1594715271 --chain-id Binance-Chain-Tigris --from alice --amount 100000000:DEF-0F9 --home ~/home_cli