Plasma EVM Implementation

Implementation of Plasma EVM You can check the RootChain smart contract here.

Plasma EVM Implementation

Development Status

Make enter / exit requests
Submit NRBs / ORBs
Finalize block and requests
Challenge on Null Address Transaction in NRBs
Continuous Rebase
Integration Computation Challenge using solevm.

Ethereum client

For the simple start of both clients(ethereum, plasma-evm), you can run run.rootchain.sh in Onther-Tech/go-ethereum and run.pls.sh in Onther-Tech/plasma-evm (this is recommended way to setup develop and test environment).

Public Testnet

Faraday testnet is running based on Rinkeby network as root chain.

See Onther-Tech/plasma-evm-networks

Build

$ make geth

Run

Before running plasma-evm client, you MUST run another geth client as root chain client.

$ git clone https://github.con/Onther-Tech/go-ethereum.git root-chain-geth && cd root-chain-geth
$ bash run.rootchain.sh

Then you can run or test plasma-evm client.

$ git clone https://github.con/Onther-Tech/plasma-evm.git && cd plasma-evm
$ bash run.pls.sh

Development Network

Custom network

1. Deploy RootChain contract and make genesis file.

All paramaeters are based on ethereum test network run by run.rootchain.sh.

$ rm -rf ~/.plasma-evm

$ geth deploy ./genesis.json 1019 true 1024 \
  --datadir ~/.plasma-evm \
  --rootchain.url ws://127.0.0.1:8546 \
  --operator.key b71c71a67e1177ad4e901695e1b4b9ee17ae16c6668d313eac2f96dbcda3f291

2. Run Plasma EVM client as operator mode.

$ geth \
  --datadir ~/.plasma-evm \
  --rpc \
  --rpcport 8547 \
  --miner.etherbase 0x71562b71999873DB5b286dF957af199Ec94617F7 \
  --operator 0x71562b71999873DB5b286dF957af199Ec94617F7 \
  --nodekeyhex b71c71a67e1177ad4e901695e1b4b9ee17ae16c6668d313eac2f96dbcda3f49b\
  --dev \
  --dev.key 78ae75d1cd5960d87e76a69760cb451a58928eee7890780c352186d23094a114 \
  --rootchain.challenger 0x3616BE06D68dD22886505e9c2CaAa9EcA84564b8 \
  --rootchain.url ws://127.0.0.1:8546 \
  --tx.interval "300ms"

This is based on run.pls.sh

CAVEAT: Challenger key is in step 2. So when restart node, you should not use --dev.key flag in step 2 not to import key again.

3. (Optional) Run another node as user mode.

$ geth init genesis.json \
  --datadir ~/.plasma-evm-user

$ geth \
  --datadir ~/.plasma-evm-user \
  --rpc \
  --rpcport 8548 \
  --rootchain.url ws://127.0.0.1:8546 \
  --bootnodes enode://a8d63d4760dbcd8656b8a61f28eb246c2f990949cd7a5d2efe483caa05a5381a61cfb30eb8622f4cb0909a6e94a82b7505fb5b2cd737398860f9369b3a8522ca@127.0.0.1:30305?discport=30305

Then use JSONRPC console to connect two nodes.

Test

Some original go-ethereum tests may fail.

To test plasam-evm related features,

$ go test github.com/Onther-Tech/plasma-evm/pls
$ go test github.com/Onther-Tech/plasma-evm/tx

Command-line Options

build/bin/geth help returns available flags. Belows are plasma-evm-specific flags.

PLASMA EVM - DEVELOPMENT MODE OPTIONS:
  --dev                               Ephemeral proof-of-authority network with a pre-funded developer account, mining enabled
  --dev.period value                  Block period to use in developer mode (0 = mine only if transaction pending) (default: 0)
  --dev.key value                     Comma seperated developer account key as hex(for dev)

PLASMA EVM - OPERATOR OPTIONS:
  --operator value                    Plasma operator address as hex.
  --operator.key value                Plasma operator key as hex(for dev)
  --operator.password value           Plasma operator key as hex(for dev)
  --operator.minether value           Plasma operator minimum balance (default = 0.5 ether) (default: "0.5")
  --miner.recommit value              Time interval to recreate the block being mined (default: 3s)

PLASMA EVM - ROOTCHAIN TRANSACTION MANAGER OPTIONS:
  --tx.gasprice value                 Gas price for transaction (default = 10 Gwei) (default: 0)
  --tx.mingasprice value              Minimum gas price for submitting a block (default = 1 Gwei) (default: 1000000000)
  --tx.maxgasprice value              Maximum gas price for submitting a block (default = 100 Gwei) (default: 100000000000)
  --tx.interval value                 Pending interval time after submitting a block (default = 10s). If block submit transaction is not mined in 2 intervals, gas price will be adjusted. See https://golang.org/pkg/time/#ParseDuration (default: 10s)

PLASMA EVM - STAMINA OPTIONS:
  --stamina.mindeposit value          MinDeposit variable state of stamina contract (default: 500000000000000000)
  --stamina.recoverepochlength value  RecoverEpochLength variable state of stamina contract (default: 10080)
  --stamina.withdrawaldelay value     WithdrawalDelay variable state of stamina contract (default: 30240)

PLASMA EVM - CHALLENGER OPTIONS:
  --rootchain.challenger value        Address of challenger account
  --challenger.password value         Plasma operator key as hex(for dev)

PLASMA EVM - ROOTCHAIN CONTRACT OPTIONS:
  --rootchain.url value               JSONRPC endpoint of rootchain provider. If URL is empty, ignore the provider.
  --rootchain.contract value          Address of the RootChain contract

PLASMA EVM - STAKING OPTIONS OPTIONS:
  --rootchain.ton value               Address of TON token contract
  --rootchain.wton value              Address of WTON token contract
  --rootchain.registry value          Address of RootChainRegistry contract
  --rootchain.depositManager value    Address of Deposit Manager contract
  --rootchain.seigManager value       Address of SeigManager contract
  --rootchain.powerton value          Address of PowerTON contract

Additional Commands

For more information, run below command (and sub-command) with --help flag.

Account

$ geth account importKey <privateKey>            # Import a private key from hex key into a new account
$ geth account importHDwallet <mnemonic> <path>  # Import a mnemonic into a new account

Deploy

$ geth deploy <genesisPath> <chainId> <withPETH> <NRELength>  # Deploy RootChain contract and make genesis file

Staking

$ geth staking deployManagers <withdrawalDelay> <seigPerBlock>  # Deploy staking manager contracts (except PowerTON)
$ geth staking deployPowerTON <roundDuration>                   # Deploy PowerTON contract
$ geth staking startPowerTON                                    # Start PowerTON first round
$ geth staking getManagers <uri?>                               # Get staking managers addresses in database
$ geth staking setManagers <uri>                                # Set staking managers addresses in database
$ geth staking register                                         # Register RootChain contract
$ geth staking balances <address>                               # Print balances of token and stake
$ geth staking mintTON <to> <amount>                            # Mint TON to account (for dev)
$ geth staking swapFromTON <tonAmount>                          # Swap TON with WTON
$ geth staking swapToTON <wtonAmount>                           # Swap WTON with TON
$ geth staking stake <amount>                                   # Stake WTON
$ geth staking requestWithdrawal <amount?>                      # Make a withdrawal request
$ geth staking processWithdrawal <numRequests?>                 # Process pending withdrawals

4000D / plasma-evm