Skip to content

Latest commit

 

History

History
94 lines (61 loc) · 2.88 KB

README.md

File metadata and controls

94 lines (61 loc) · 2.88 KB
Raw

stests

Casper Network System Test Platform

What is stests ?

The stests library is a CSPR network system testing tool.

Why stests ?

Launching a blockchain network within a hostile permission-less setting is non-trivial. The elevated risk burden demands a multi-faceted and sophisticated approach in respect of system testing. One pillar of such system testing is stests, a library desiged to support progressively constraining network behaviour to that of a successful production setting, i.e. main net.

Who uses stests ?

CSPR network community. This encompasses developers, validators, evaluators ... etc.

Requirements

- python 3.8+
- pipenv
- redis

Installation

See installation for further information.

curl https://raw.githubusercontent.com/CasperLabs/stests/master/installer | bash

Commands

Once installed a set of commands are available for use within a terminal session.

Usage

See usage for further information.

Quick Start

  1. Register network + faucet key:

    stests-cache-set-network --net poc1
stests-cache-set-faucet-key --net poc1 --path path-to-faucet-private-key-pem-file

  2. Register nodes + node bonding keys:

    stests-cache-set-node --net poc1 --node 1 --address {host}:{port} --type full
stests-cache-set-bonding-key --net poc1 --node 1 --path path-to-validator-private-key-pem-file

stests-cache-set-node --net poc1 --node 2 --address {host}:{port} --type full
stests-cache-set-bonding-key --net poc1 --node 2 --path path-to-validator-private-key-pem-file

stests-cache-set-node --net poc1 --node 3 --address {host}:{port} --type full
stests-cache-set-bonding-key --net poc1 --node 3 --path path-to-validator-private-key-pem-file

  3. Run a generator:

    # Run once.
stests-wg-100 --net poc1 --user-accounts 5
stests-wg-100 --net poc1 --user-accounts 50
stests-wg-100 --net poc1 --user-accounts 500

# Run 2 in parallel.
stests-wg-100 --net poc1 --user-accounts 5 --parallel 2

# Run 2 in parallel, each looping 4 times or until a failure occurs.
stests-wg-100 --net poc1 --user-accounts 5 --parallel 2 --loop 4

# Run 2 in parallel, each looping 4 times every 10 minutes.
stests-wg-100 --net poc1 --user-accounts 5 --parallel 2 --loop 4 --loop-interval 600 --execution-mode periodic

Further Information ?

Please refer to the specification for further information.