/thor-e2e-tests

Thor E2E Testing

Primary LanguageTypeScript

VechainThor E2E Tests

Prerequisites

Running the tests

yarn install
yarn docker:up
yarn test

Debugging the tests

# Start a thor solo instance so your tests can run quickly
yarn docker:solo:up
# Run a single test / test suite
yarn test -t 'GET /accounts/{address}/storage'

Custom Docker Image

  • You can specify a custom docker image by running the following in the vechain/thor repo:
docker build -t vechain/thor:custom .
export THOR_IMAGE=vechain/thor:custom
yarn docker:up
yarn test

Running a group of tests

yarn test -test <group/test>

Custom solo url

--nodeURL http://localhost:8669

This is added to be able to configure the url of the client for future network hub integration. We need to keep same genesis for now.

Scripts

Generate Open API Specification

  • These scripts will output the Open API Spec to ./src/open-api-types.ts

Option 1 - By local file:

yarn generate:openapi ./thor.yaml

Option 2 - By URL:

yarn generate:openapi https://raw.githubusercontent.com/vechain/thor/master/api/doc/thor.yaml

Test accounts

Tests are executed using a custom private thor blockchain. The genesis of this blockchain is defined in genesis.json. This file contains accounts that are created with defined VET/VTHO balance for testing purposes. These accounts are used as a faucet. Please refer to:

  • ./src/wallet.ts to generate new accounts/ private keys
  • ./src/account-faucet.ts to fund your accounts with VET/VTHO

Types of tests

  • thorest-api --> Tests that validate the swagger contract definition of the Thorest api