friday

README

TESTNET

Prerequisites

• Rust
• Golang >= 1.13
• protoc >= 3.6.1
• make and cmake

Build

make install

Run

Setup a genesis status and run a genesis node

• note: Fill the name what you want inside < >

# run execution engine grpc server
./CasperLabs/execution-engine/target/release/casperlabs-engine-grpc-server $HOME/.casperlabs/.casper-node.sock

# init node
nodef init <node_name> --chain-id testnet

# copy execution engine chain configurations
cp ./x/executionlayer/resources/manifest.toml ~/.nodef/config

# create a wallet key
clif keys add elsa # select password
clif keys add anna # select password

# add genesis node
nodef add-genesis-account $(clif keys show elsa -a) 5000000000000dummy,100000000stake
nodef add-genesis-account $(clif keys show anna -a) 5000000000000dummy,100000000stake
nodef add-el-genesis-account $(clif keys show elsa -a) "5000000000000" "100000000"
nodef add-el-genesis-account $(clif keys show anna -a) "5000000000000" "100000000"
nodef load-chainspec ~/.nodef/config/manifest.toml

# apply default clif configure
clif config chain-id testnet
clif config output json
clif config indent true
clif config trust-node true

# prepare genesis status
nodef gentx --name elsa # insert password
nodef collect-gentxs
nodef validate-genesis

• edit ~/.nodef/config/config.toml

...
# Maximum size of request body, in bytes
max_body_bytes = 1000000 -> 3000000
...
# Maximum size of a single transaction.
# NOTE: the max size of a tx transmitted over the network is {max_tx_bytes} + {amino overhead}.
max_tx_bytes = 1048576 -> 3145728
...

• genesis node start

nodef start

• note your genesis node's ID and genesis file
• you can get your node ID using clif

clif status | grep \"id\"

• your genesis file exists ~/.nodef/config/genesis.json

Clif usage

• query
  • usage: clif query executionlayer getbalance [address]

clif query executionlayer getbalance $(clif keys show elsa -a)

{
   "value": "5000000000000"
}

• transfer (send)
  • usage: clif tx send [from address] [to address] [amount] [fee] [gas_price]

clif tx send $(clif keys show elsa -a) $(clif keys show anna -a) 100dummy 100000000 20000000

...
confirm transaction before signing and broadcasting [y/N]: y
Password to sign with 'elsa': # input your password
{
  "height": "0",
  "txhash": "141F12A891659F52B055EF7F701B1D406E5F1721CE929630CC5CE3CE0C4C8718",
  "raw_log": "[{\"msg_index\":0,\"success\":true,\"log\":\"\",\"events\":[{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"executionengine\"}]}]}]",
  "logs": [
    {
      "msg_index": 0,
      "success": true,
      "log": "",
      "events": [
        {
          "type": "message",
          "attributes": [
            {
              "key": "action",
              "value": "executionengine"
            }
          ]
        }
      ]
    }
  ]
}

• bond
  • usage: clif executionlayer bond [from address] [bond amount] [fee] [gas_price]
• unbond
  • usage: clif executionlayer unbond [from address] [unbond amount] [fee] [gas_price]

Connect to seed node

• run this on another machine

# run execution engine grpc server
./CasperLabs/execution-engine/target/release/casperlabs-engine-grpc-server $HOME/.casperlabs/.casper-node.sock

# init node
nodef init <node_name> --chain-id testnet

• edit ~/.nodef/config/config.toml

...
# Maximum size of request body, in bytes
max_body_bytes = 1000000 -> 3000000
...
# Comma separated list of seed nodes to connect to
seeds = "" -> "<genesis node's ID>@<genesis node's IP>:26656"
...
# Maximum size of a single transaction.
# NOTE: the max size of a tx transmitted over the network is {max_tx_bytes} + {amino overhead}.
max_tx_bytes = 1048576 -> 3145728
...

• replace ~/.nodef/config/genesis.json to genesis node's one what you saved above.

Test

$ make test