/firestarter

Snapshot Validator for EOS.io based Blockchains

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Introduction

This repo contains a set of tools that allows to boot and validate an EOSIO chain.

Boot, Snapshot, and validation tools can be used together or separatedly, eg: if you already have your boot in place, then you can only use validation tool to verify and validate

Current Validation tool includes these features:

  • The genesis.json.
  • The global Parameters.
  • Global Parameter - Max RAM Size
  • The System Accounts.
  • The System Contracts.
  • The erc20 Snapshot/account creation.
  • Accounts Stakes.
  • Account Permissions.
  • Validate that there are no codes in the snapshots accounts.
  • Validate Constitution
  • EOS Token Existence & Consistency

1) Boot Tool

  • Automatically setups and starts a chain.
  • Includes injection of EOS ERC20 Tokens.
  • Consider that this script recreates your wallet and starts a nodeos with custom parameters, please customize configuration files as needed.

Steps:

  • Before build add snapshot plugin
cd /eos
git merge origin/snapshot-plugin

  • Merge EOSIO/eos#3587 first

  • Remember change CORE_SYMBOL_NAME="EOS" to be EOS (vi ./eosio_build.sh)

  • If boot get stuck in Creating Account 1000/980000 ...... check ACCOUNTS_PER_TX var inparams.sh

cd boot
# optionally requires => pip install requests 
./boot.sh

2) Chain State Snapshot & Validation Tool

A) Take snapshot locally

  1. pick a block (370 in our case)
cleos get block 370

  1. take the block id 0000017239cb40966c033ebf0d9f48b1400ed620342ab134afa57b70bf0d9d77

  2. execute and wait between 5 to 15 minutes (depending on your hw speed)

cd validator
./validate_chain_at_bloc.sh 0000017239cb40966c033ebf0d9f48b1400ed620342ab134afa57b70bf0d9d77
  1. enjoy results :)

Alt Text

B) Take snapshot from a remote node

  1. obtain the genesis.json used in the chain
  2. pick a block where you want to validate the chain at (ej:4000)
cleos --url=http://the.remote.node.com:8888 get block 4000
  1. take the block id 0000017239cb40966c033ebf0d9f48b1400ed620342ab134afa57b70bf0d9d77
PEERP2P=the.remote.node.com:9876 GENESIS=/path/to/genesis ./validate_chain_at_bloc.sh 0000017239cb40966c033ebf0d9f48b1400ed620342ab134afa57b70bf0d9d77

Alt Text