Mono repository of Token Bridge (Oracle, Deployment, Monitor). TokenBridge is an interoperability solution between EVM-based networks for assets/data cross chain transfers
Go to file
Alexander Kolotov dbaf7feca7
Merge the develop branch to the master branch, preparation to v3.5.0
This merge contains the following set of changes:
  * [Oracle, Improvement] Helpers for overriding AMB signatures (#640)
  * [Oracle, Improvement] Support manual signatures in erc to native mode (#646)
  * [ALM, Improvement] ALM: Do not show unneeded failed confirmations (#641)
  * [ALM, Improvement] ALM: warning for auto-relayed messages (#644)
  * [ALM, Fix] ALM: reorder warnings
2022-03-18 17:07:42 +03:00
.github/workflows Try to detect unsynced node state (#592) 2021-08-03 23:36:50 +03:00
alm ALM: reorder warnings 2022-03-17 17:41:33 +04:00
alm-e2e Improve confirm-relay feature (#582) 2021-07-07 16:21:01 +03:00
audit Final version of AMB and OB contracts security audit report by ChainSecurity 2021-09-28 20:39:04 +03:00
burner-wallet-plugin Allow cors in monitor server (#472) 2020-10-12 21:16:41 +03:00
commons Add support for EIP1559 gas price oracle (#631) 2022-01-03 17:58:36 +03:00
contracts@908a481079 Update the contract's submodule to the release 6.0.0 (#600) 2021-09-18 13:44:48 +03:00
deployment Improvements for the local logs configuration (#602) 2021-09-18 13:42:29 +03:00
deployment-e2e Fix dependencies versions and update example.yml (#566) 2021-05-10 14:36:57 -06:00
e2e-commons Refetch old logs ranges to see if there are missed events (#627) 2022-01-03 15:32:38 +03:00
monitor Added logging prior the investedAmount call (#614) 2021-10-12 18:06:50 +03:00
monitor-e2e Upload services logs in e2e and ultimate tests (#568) 2021-05-15 10:29:20 -06:00
oracle Support manual signatures in erc to native mode (#646) 2022-03-10 14:18:19 +03:00
oracle-e2e Fix handling of Compound related Transfer events (#595) 2021-08-24 11:31:15 +03:00
parity Fix handling of Compound related Transfer events (#595) 2021-08-24 11:31:15 +03:00
.coveralls.yml Added Coveralls for UI (#59) 2019-05-22 16:09:02 +02:00
.dockerignore Cache fetched events in monitor (#482) 2020-11-04 14:24:42 +03:00
.editorconfig Move .editorconfig to root dir. 2019-05-22 16:33:28 +02:00
.eslintignore Add ALM new styles (#373) 2020-06-26 18:47:45 +03:00
.eslintrc Configured Prettier (#60) 2019-05-22 16:31:09 +02:00
.gitignore ALM manual signatures execution (#471) 2020-11-26 00:22:21 +03:00
.gitmodules Updated links to new repo with tokenbridge contracts (#226) 2019-11-05 15:53:47 +03:00
.nvmrc Update the contract's submodule to the release 6.0.0-rc0 (#562) 2021-05-08 09:50:46 -06:00
.prettierrc Extend line width to 120 (#174) 2019-08-01 15:10:22 +02:00
CODE_OF_CONDUCT.md Update the token-bridge sub-repo (#19) 2019-05-07 16:52:44 +02:00
CONFIGURATION.md Add support for EIP1559 gas price oracle (#631) 2022-01-03 17:58:36 +03:00
CONTRIBUTING.md Update the token-bridge sub-repo (#19) 2019-05-07 16:52:44 +02:00
Dockerfile.e2e Async calls error codes (#587) 2021-07-13 11:57:08 +03:00
LICENSE Update the token-bridge sub-repo (#19) 2019-05-07 16:52:44 +02:00
package.json Add support for EIP1559 gas price oracle (#631) 2022-01-03 17:58:36 +03:00
README.md Update the contract's submodule to the release 6.0.0-rc0 (#562) 2021-05-08 09:50:46 -06:00
yarn.lock CollectedSignatures AMB watcher for MEV bundling (#634) 2022-02-07 23:32:41 +03:00

tokenbridge Gitter License: LGPL v3.0

Tokenbridge

Welcome to the POA TokenBridge monorepository!

Please note that this repository as a work in progress.

Overview

The POA TokenBridge allows users to transfer assets between two chains in the Ethereum ecosystem. It is composed of several elements which are contained within this monorepository.

For a complete picture of the POA TokenBridge functionality, it is useful to explore each subrepository.

Structure

Sub-repositories maintained within this monorepo are listed below.

Sub-repository Description
Oracle Oracle responsible for listening to bridge related events and authorizing asset transfers.
Monitor Tool for checking balances and unprocessed events in bridged networks.
Deployment Ansible playbooks for deploying cross-chain bridges.
Oracle-E2E End to end tests for the Oracle
Monitor-E2E End to end tests for the Monitor
Deployment-E2E End to end tests for the Deployment
Commons Interfaces, constants and utilities shared between the sub-repositories
E2E-Commons Common utilities and configuration used in end to end tests
ALM DApp interface tool for AMB Live Monitoring
Burner-wallet-plugin TokenBridge Burner Wallet 2 Plugin

Additionally there are Smart Contracts used to manage bridge validators, collect signatures, and confirm asset relay and disposal.

Available deployments

Launched by POA Launched by 3rd parties
POA20 Bridge Ocean TokenBridge
xDai Bridge Thunder bridge
WETC Bridge Volta TokenBridge & DAI bridge to Volta Chain
Artis Brige
Tenda bridge & xDai-to-Tenda bridge

Network Definitions

Bridging occurs between two networks.

  • Home - or Native - is a network with fast and inexpensive operations. All bridge operations to collect validator confirmations are performed on this side of the bridge.

  • Foreign can be any chain; generally it refers to the Ethereum mainnet.

Operational Modes

The POA TokenBridge provides four operational modes:

  • ERC20-to-Native: Pre-existing tokens in the Foreign network are locked and coins are minted in the Home network. In this mode, the Home network consensus engine invokes Parity's Block Reward contract to mint coins per the bridge contract request. More Information: xDai Chain
  • Arbitrary-Message: Transfer arbitrary data between two networks as so the data could be interpreted as an arbitrary contract method invocation.

Initializing the monorepository

Clone the repository:

git clone https://github.com/poanetwork/tokenbridge

If there is no need to build docker images for the TokenBridge components (oracle, monitor), initialize submodules, install dependencies, compile the Smart Contracts:

yarn initialize

Then refer to the corresponding README files to get information about particular TokenBridge component.

Linting

Running linter for all JS projects:

yarn lint

Tests

Running tests for all projects:

yarn test

Additionally there are end-to-end tests for Oracle and Monitor.

For details on building, running and developing please refer to respective READMEs in sub-repositories.

Building, running and deploying

Please refer to the instructions in sub-directories. Configuration details are available here.

Contributing

See the CONTRIBUTING document for contribution, testing and pull request protocol.

License

This project is licensed under the GNU Lesser General Public License v3.0. See the LICENSE file for details.

References