Concepts

The BEP3 module implements the BEP3 protocol for secure cross-chain asset transfers between Highbury and other BEP3 compatible chains, such as Binance Chain. Transactions are witnessed and relayed between the two blockchains by Binance’s BEP3 deputy process. The deputy maintains an address on both chains and is responsible for delivering tokens upon the successful completion of an Atomic Swap. Learn more about the BEP3 deputy process here.

Requirements

Highbury

  • The deputy’s Highbury address on mainnet is fury1r4v2zdhdalfj2ydazallqvrus9fkphmglhn6u6.
  • Highbury’s official API endpoint is https://api.data.fury.black.

Binance Chain

  • The deputy’s Binance Chain address on mainnet is bnb1jh7uv2rm6339yue8k4mj9406k3509kr4wt5nxn.
  • We recommend using https://testnet-dex.binance.org/ as Binance Chain’s API endpoint.

Highbury’s JavaScript SDK and Binance Chain’s JavaScript SDK can be used to create, claim, and refund swaps.

Binance Chain to Highbury

When a user wants to transfer tokens from Binance Chain to Highbury, the following steps are taken:

  1. User’s tokens are locked on Binance Chain along with the hash of a secret only known to the user. If the secret is not revealed before the deadline, the tokens are refundable.
  2. The deputy sends a message to Highbury saying “a user has locked X tokens, if their secret is revealed before the deadline issue them an equivalent amount of pegged tokens”.
  3. The user reveals the secret on Highbury and receives the pegged tokens.
  4. The deputy relays the secret to Binance Chain and the original tokens are locked permanently.

Binance Chain to Highbury Diagram

Highbury to Binance Chain

  1. When a user wants to transfer tokens from Highbury to Binance Chain by redeeming pegged tokens, the following steps are taken: User’s pegged tokens are locked on Highbury along with the hash of a secret only known to the user. If the secret is not revealed before the deadline, the tokens are refundable.
  2. The deputy sends a message to Binance Chain saying “a user has locked X pegged tokens, if their secret is revealed before the deadline issue them an equivalent amount of tokens”.
  3. The user reveals the secret on Binance Chain and receives the tokens.
  4. The deputy relays the secret to Highbury and the pegged tokens are locked permanently.

Highbury to Binance Chain Diagram