1.0.0 • Published 5 years ago

leap-contracts v1.0.0

Weekly downloads
1
License
MPL-2.0
Repository
-
Last release
5 years ago

LeapDAO Bridge implementation

Build Status

Development

Getting started

yarn
yarn test 

Deploying contracts

All the commands support any truffle options like --network or --reset.

Contract may be customized via ENV variables:

ENV variableDescriptionDefault value
PROPOSAL_TIMEGovernance proposal cool-off time (in seconds)1209600 (14 days)
EXIT_STAKEExit stake (in Wei)100000000000000000
EXIT_DURATIONExit duration (in seconds)604800 (7 days)
DEPLOYED_TOKENToken to be configured in vault
EPOCH_LENGTHNumber of initial slots for validators2
PARENT_BLOCK_INTERVALNumber of Ethereum blocks between Plasma periods2
TAX_RATEInitial tax rate (0 - 1000 equals 0% - 100%)50
POA_REWARDReward rate before supply of 7 million reached778000000000000000000
GOV_OWNEROwner address of the MinGov.sol contract, should be set to seed initial token supply.

E.g. PROPOSAL_TIME=600 EXIT_DURATION=180 yarn deploy deploys plasma contract with 3 minutes exit duration governed by MinGov with 10 minutes proposal time.

Deploy everything

yarn deploy

This will deploy deploy token, plasma and governance contracts.

Deploy only plasma and governance contracts (reusing token)

yarn deploy:plasma

Good things to know

slotId in MinGov.setSlot is encoded like this:

First 20 byteslast 12 bytes
address(OperatorProxy)slotId

Contracts

In this repository are the solidity smart contracts implementing LeapDAO's plasma leap.

There are 3 smart contracts that get deployed:

  • Bridge

    The bridge is responsible for storing the period chain. It is the source of truth for the plasma chain.

  • Operator

    The operator is the contract that is responsible for submitting new periods to the bridge.

  • ExitHandler

    This contract is responsible for user funds. Explained in more detail below.

Layout

The ExitHandler is actually the final contract in an inheritance chain that goes as follows:

  • Vault

    The vault defines what types of assets are allowed on the plasma chain and is responsible for registration of these assets.

  • DepositHandler

    The deposit handler is in general responsible for how funds get onto the plasma chain.

  • ExitHandler

    The exit handler is in general responsible for how funds leave the plasma chain.

Inheritance chain

LICENSE

Project source files are made available under the terms of the Mozilla Public License (MPLv2). See individual files for details.