Skip to content

axieinfinity/ronin-bridge-contracts

This branch is 149 commits ahead of axieinfinity/ronin-dpos-contracts:mainnet.

Folders and files

NameName
Last commit message
Last commit date
Feb 2, 2024
Jan 18, 2024
Feb 7, 2024
Oct 18, 2023
Nov 2, 2023
Feb 6, 2024
Feb 4, 2024
Mar 5, 2024
Mar 5, 2024
Mar 5, 2024
Nov 2, 2023
Dec 15, 2023
Nov 2, 2023
Feb 2, 2024
Nov 2, 2023
Nov 3, 2023
Nov 2, 2023
Jan 18, 2024
Dec 21, 2023
Jan 17, 2024
Jan 17, 2024
Nov 2, 2023

Repository files navigation

ronin-bridge-contracts

The collections of smart contracts that power the Ronin Bridge.

Development

Requirement

Build & Test

  • Install packages
$ forge install
  • Build contracts
$ forge build
  • Run test
$ forge test

Deploy

$ forge script <path/to/file.s.sol> -f --private-key <your_private_key>

Target chain to deploy

This repo contains source code of contracts that will be either deployed on the mainchains, or on Ronin chain.

  • On mainchains:
    • Governance contract: MainchainGovernanceAdmin
    • Bridge contract: MainchainGatewayV3
  • On Ronin chain:
    • Governance contract: RoninGovernanceAdmin
    • Bridge operation: RoninGatewayV3

Upgradeability & Governance mechanism

Except for the governance contracts and vault forwarder contracts, all other contracts are deployed following the proxy pattern for upgradeability. The TransparentUpgradeableProxyV2, an extended version of OpenZeppelin's, is used for deploying the proxies.

To comply with the governance process, in which requires all modifications to a contract must be approved by a set of governors, the admin role of all proxies must be granted for the governance contract address.

Documentation

See docs/README.md for the documentation of the contracts.

See docs/HACK.md for the structure of the repo.

For the whitepaper, please refer to Ronin Whitepaper.

About

The collections of smart contracts that power the Ronin Bridge.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Solidity 99.1%
  • Other 0.9%