Beta Testing Orange Bridge

Getting Started

Orange Bridge is a web application supported by popular Internet browsers for mobile and desktop devices. You can test it here during our beta period. Orange Bridge utilizes Bitcoin and Ethereum Mainnet networks. This means that all transactions are mined on each blockchain network. During this beta, only bridges between the following blockchains are supported:

  • Bitcoin

  • Ethereum

The BRC20 inscription for ORNJ tokens is https://unisat.io/brc20/ornj

Once bridged, the ERC20 EVM token contract address for ORNJ is 0x2E8607dA39A40D780406dCf1207B9C27221137Fc All bridged transactions and Bridged TVL (Max Total Supply) between the Bitcoin and Ethereum blockchains for ORNJ can be located here: https://etherscan.io/token/0x2e8607da39a40d780406dcf1207b9c27221137fc

Please note that Orange Bridge is in beta and an experimental phase. While contracts have been deployed on Mainnet, have undergone quality assurance testing, and are undergoing a security audit, there is always a risk of errors that may result in a loss of funds. We encourage all tests to be conducted with a small amount of funds. Due to the associated risks, Orange Labs accepts limited liability during this testing phase.

Requirements

  • Orange Bridge requires Bitcoin and Ethereum for gas to execute the bridge requests.

  • Orange Bridge requires experimental Orange Wallet version 1.1.6B or greater. You can download the wallet package here. To install the package, go to Google Chrome and:

    • Unzip the wallet package in your downloads folder

    • Tap on the Extensions icon in the top right of the browser

    • Tap on Manage Extensions

    • Tap Load Unpacked in the top left of the browser

    • Navigate to the downloads folder where you unzipped the wallet package and select the build folder

Orange Bridge is currently in beta and is hosted on a temporary domain for testing purposes.

  1. Using your favorite Chromium-based Internet web browser, navigate here

Connect Wallets

Enabling Mainnet on Your Wallet

To use Orange Bridge, you must connect your Bitcoin and Ethereum wallets, which contain the assets you would like to bridge and receive the bridged assets. Connecting both wallets ensures your security, minimizes the risk of error, and provides the most straightforward user experience for bridging assets.

  1. Please ensure that you are logged in to both wallets and that both wallets have your accounts logged in.

  2. Both wallets should be on the Mainnet network. For the Orange Wallet, check the Network Indicator if you are on Mainnet. If you are on Testnet, change networks by:

    1. Navigate to the top-right gear icon and tap Settings

    2. Tap Network

    3. Tap Mainnet

    4. Tap Save

For Metamask, check the Network Indicator if you are on Mainnet. If you are on Testnet, change networks by:

  1. Navigating to the top-left network drop-down and tap the network selector

  2. Tap and select Ethereum Mainnet

  3. After the setup of the wallets, return to Orange Bridge and tap the Connect BTC and Connect EVM buttons to connect your wallets:

Connecting the Orange Wallet

  1. Tap on the Connect BTC button in the top right-hand corner

  2. Tap the Orange Wallet button option in the Orange Bridge Connect Wallet pop-up

  3. Tap the Approve button on the Connect Request pop-up from Orange Wallet

Connecting the Metamask Wallet

  1. Tap on the Connect EVM button in the top right-hand corner

  2. Tap the Metamask button option in the Connect a Wallet pop-up

  3. Tap the Next button on the Connect with Metamask pop-up

  4. Tap the Connect button on the Connect to Account pop-up

Once connected, you will return to the Orange Bridge. Connected wallets will display a preview of the wallet address in each button. To disconnect any wallet, tap the button for the wallet you want to disconnect.

Bridging Between Assets

Bridging from Bitcoin BRC20 to Ethereum ERC20:

  1. After connecting both wallets, ensure the Bridge tab is selected in the DAPP.

  2. Tap the Tap the TO EVM tab

  3. Tap the Bitcoin asset you would like to bridge from in the Asset drop-down

  4. Enter the amount you would like to bridge in the input field

  5. Tap Confirm to begin the bridge process

  6. Sign the transaction request in your Orange wallet and tap Confirm to broadcast your transaction on the blockchain. Please note that you must pay a bridge fee to proceed.

  7. The Transaction status pop-up will display the progress of your bridge transaction. You can close this pop-up and view the progress in the History tab.

Bridging from Ethereum ERC20 to Bitcoin BRC20:

  1. After connecting both wallets, ensure the Bridge tab is selected in the DAPP.

  2. Tap the Tap the TO BTC tab

  3. Tap the Ethereum asset you would like to bridge from in the Asset drop-down

  4. Enter the amount you would like to bridge in the input field

  5. Tap Confirm to begin the bridge process

  6. Sign the transaction request in your Orange wallet and tap Confirm to broadcast your transaction on the blockchain. Please note that you must pay a bridge fee to proceed.

  7. The Transaction status pop-up will display the progress of your bridge transaction. You can close this pop-up and view the progress in the History tab

Viewing Bridge History

To view your bridge history:

  1. After connecting both wallets, tap the History tab in the DAPP.

  2. If you are looking for your recently broadcasted bridge transaction, you must wait a few minutes for it to confirm on the blockchain and appear.

  3. View the status column for the progress of your transaction:

Withdrawing Unclaimed Tokens

In certain instances, tokens may not be delivered successfully due to network congestion or bridging errors, or you may want to cancel your bridge transaction. In Orange Wallet, you can tap the Withdraw button to cancel the transaction and re-claim your tokens to your wallet. Please note that bridge fees are not refunded for withdrawals as they are used to subsidize network fees.

  1. After connecting both wallets, tap the History tab in the DAPP.

  2. Find the transaction where tokens may exist in the contract and the Withdraw button is active

  3. Tap the Withdraw button

Verifying Transactions

If you experience issues, you can verify your transactions using a blockchain explorer:

Providing Feedback

Users should report issues and provide feedback in the Orange Discord or Telegram support channels.

Last updated