poanetwork
/
istanbul-tools
mirror of https://github.com/poanetwork/istanbul-tools.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
254 Commits 2 Branches 3 Tags 94 MiB
Go 97.1%
Smarty 1.1%
Python 0.7%
HCL 0.7%
Makefile 0.3%
Go to file
Alan Chen cf2b999685 infra: add load testing deployment configs for terraform 2017-09-22 17:08:20 +08:00
benchmark/kubernetes benchmark/kubernetes: fix consensus 2017-09-21 17:50:46 +08:00
charts charts, common, genesis, k8s: Fix bugs about ether sending 2017-09-21 17:52:47 +08:00
client charts, client, common, container, genesis, k8s, log: logger refactoing for correct caller line number 2017-09-13 17:26:39 +08:00
cmd common, container, genesis: utilities refactoring 2017-09-07 18:22:07 +08:00
common charts, common, genesis, k8s: Fix bugs about ether sending 2017-09-21 17:52:47 +08:00
container Merge pull request #82 from getamis/feature/load-test-tx 2017-09-15 16:01:55 +08:00
genesis charts, common, genesis, k8s: Fix bugs about ether sending 2017-09-21 17:52:47 +08:00
infra infra: add load testing deployment configs for terraform 2017-09-22 17:08:20 +08:00
k8s k8s, tests/load: add ether sending to load testing 2017-09-22 16:05:45 +08:00
log charts, client, common, container, genesis, k8s, log: logger refactoing for correct caller line number 2017-09-13 17:26:39 +08:00
tests k8s, tests/load: add ether sending to load testing 2017-09-22 16:05:45 +08:00
vendor glide, vendor: add log15 2017-09-12 12:16:48 +08:00
.gitignore add gitignore file 2017-06-19 15:37:13 +08:00
.travis.yml travis: update notification 2017-09-14 12:34:00 +08:00
Makefile Makefile: add load testing make target 2017-09-07 18:22:07 +08:00
README.md Readme: add seal 2017-09-15 10:26:45 +08:00
glide.lock glide, vendor: add log15 2017-09-12 12:16:48 +08:00
glide.yaml glide, vendor: add log15 2017-09-12 12:16:48 +08:00

README.md

istanbul-tools

Test Status

Istanbul tools contain tools for configuring extraData field for istanbul BFT (IBFT) network, integration tests for both IBFT Geth and Quorum, and load testing utilities for IBFT Geth.

Command line tools

Genesis extra-data encoder and decoder library for Istanbul consensus.

istanbul-tools is used to generate extra-data field of genesis due to extra-data is combined signer vanity with RLP encoded Istanbul extra data. The Istanbul extra data struct is defined as follows:

type IstanbulExtra struct {
    Validators    []common.Address  // Validator addresses
    Seal          []byte            // Proposer seal 65 bytes
    CommittedSeal [][]byte          // Committed seal, 65 * len(Validators) bytes
}

Please note: The Seal, and CommittedSeal is not considered in genesis block.

Getting started

$ make istanbul
$ build/bin/istanbul

NAME:
   istanbul - the istanbul-tools command line interface

USAGE:
   istanbul [global options] command [command options] [arguments...]

COMMANDS:
     decode   To decode an Istanbul extraData
     encode   To encode an Istanbul extraData
     help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h  show help

COPYRIGHT:
   Copyright 2017 The Amis Authors

Example

Encode command

Encode the given file to Encoded Istanbul extra-data

$ build/bin/istanbul encode --config ./cmd/istanbul/example/config.toml

OUTPUT:
Encoded Istanbul extra-data: 0x0000000000000000000000000000000000000000000000000000000000000000f89af85494475cc98b5521ab2a1335683e7567c8048bfe79ed9407d8299de61faed3686ba4c4e6c3b9083d7e2371944fe035ce99af680d89e2c4d73aca01dbfc1bd2fd94dc421209441a754f79c4a4ecd2b49c935aad0312b8410000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c0

Decode command

Decode extraData for the given input

$ build/bin/istanbul decode --extradata 0x0000000000000000000000000000000000000000000000000000000000000000f89af85494475cc98b5521ab2a1335683e7567c8048bfe79ed9407d8299de61faed3686ba4c4e6c3b9083d7e2371944fe035ce99af680d89e2c4d73aca01dbfc1bd2fd94dc421209441a754f79c4a4ecd2b49c935aad0312b8410000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c0

OUTPUT:
vanity:  0x0000000000000000000000000000000000000000000000000000000000000000
validator:  0x475cc98b5521ab2a1335683e7567c8048bfe79ed
validator:  0x07d8299de61faed3686ba4c4e6c3b9083d7e2371
validator:  0x4fe035ce99af680d89e2c4d73aca01dbfc1bd2fd
validator:  0xdc421209441a754f79c4a4ecd2b49c935aad0312
seal: 0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

Integration tests

Istanbul BFT Geth Integration tests

Test specification Source code

Istanbul BFT Quorum Integration tests

Test specification Source code

Load tests

Test specification