Pandaa Token Bridge

This is Pandaa token bridge web dapp that allow users to transfer Pandaa token between Goerli testnet and Binance testnet.
View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Contributing
5. License
6. Contact

About The Project

Built With

• Solidity
• Truffle
• Web3 Js
• Ether Js
• Javascript
• React Js

Getting Started

Below is a list of prerequisite:

• Install NodeJS, Recommended version is 14.16.0
• Install MetaMask in your browser.

Installation

1. Clone/Download the Repository

2. Install Dependencies:

$ npm install

3. Setup .env File

Create a .env file and update the value for the following fields. Note that REACT_APP_PRIVATE_KEY should be the same value as PRIVATE_KEY. and REACT_APP_INFURA_API_KEY should be the same value as INFURA_API_KEY.

PRIVATE_KEY=""
INFURA_API_KEY=""
REACT_APP_PRIVATE_KEY=""
REACT_APP_INFURA_API_KEY=""

4. Start Ganache

$ npx ganache -p 7545

5. Test Smart Contract

$ npx truffle test

6. Migrate(Deploy) Smart Contracts

$ npx truffle migrate --reset And specify network information with --network. Note we need to deploy contracts twice, once on goerli testnet and once on binance testnet.

7. Run Frontend Application

In another separate terminal run: $ npm start

(back to top)

Usage

• To interact with the web dapp, first connect an ethereum account with metamask wallet and connect your ethereum account which you used for contract deployment. This is to make sure you have Pandaa Token already minted for you to begin with.

• Before we start, make sure metamask is configured to display both Goerli testnet and Binance testnet. Input below chain info in metamask to add Binance testnet:

Network name: BSC Testnet
New RPC URL:
https://data-seed-prebsc-1-s1.binance.org:8545/
Chain ID:
97
Currency symbol:
tBNB
Block explore URL:
https://testnet.bscscan.com

• Add Pandaa token to your MetaMask on Goerli and Bsc testnet. Click Add Token to Metamask button would add Pandaa token symbol on your metamask goerli and bsc networks. You should be able to see some Pandaa Token balance on both networks instantly.

• Connect your wallet and input an amount in ether to bridge. You should receive metamask prompt to sign message and then confirm the transaction. After a short wait(typically less than 1 minute), you should see the waiting message disappear. And you can check your new Pandaa token balance which confirms the bridging is successful.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

bzpassersby - @bzpassersby - bowenzby@gmail.com

(back to top)