t

README

e2e

This package contains all e2e tests divided into subpackages which represents (or should represent) business domains like transactions, chat etc.

These tests are run against public testnets: Ropsten and Rinkeby.

e2e package contains a few utilities which are described in a godoc.

Flags

1. -network

The -network flag is used to provide either a network id or network name which specifies the ethereum network to use for running all test. It by default uses the StatusChain network.

Usage

First of all you need to export an ACCOUNT_PASSWORD environment variable. It should be a passphrase that was used to generate accounts used in tests. If you don't know this variable for default accounts you will have to create your own accounts and request some funds from rinkeby or ropsten faucet. Please see Preparation section for details.

To use the ropsten network for testing using network name:

ACCOUNT_PASSWORD=test go test -v ./t/e2e/... -p=1 -network=ropsten

To use the rinkeby network with chain id 4 for testing:

ACCOUNT_PASSWORD=test go test -v ./t/e2e/... -p=1 -network=4

Preparation

You will need geth in your PATH. Please visit: https://www.ethereum.org/cli. Once installed - generate 2 accounts and remember the passphrase for them, so run this command twice:

geth account new --keystore=static/keys/
Your new account is locked with a password. Please give a password. Do not forget this password.
Passphrase:
Repeat passphrase:
Address: {b6120ddd881593537c2bd4280bae509ec94b1a6b}

We expect that accounts will be named in a certain way:

pushd static/keys/
mv UTC--2018-01-26T13-46-53.657752811Z--b6120ddd881593537c2bd4280bae509ec94b1a6b test-account1.pk
mv UTC--2018-01-26T13-47-49.289567120Z--9f04dc05c4c3ec3b8b1f36f7d7d153f3934b1f07 test-account2.pk
popd

Update config for tests with new accounts static/config/public-chain-accounts.json:

{
  "Account1": {
    "Address": "0xb6120ddd881593537c2bd4280bae509ec94b1a6b"
  },
  "Account2": {
    "Address": "0x9f04dc05c4c3ec3b8b1f36f7d7d153f3934b1f07"
  }
}

Embed keys as a binary data, you will need to install npm tool and web3.js lib:

npm install web3
make generate

As a final step request funds from faucet for a chosen network:

• Rinkeby
• Ropsten

Finally, you are ready to run tests!

Documentation

Index

• func FirstBlockHash(nodeManager common.NodeManager) (string, error)
• func MakeTestNodeConfig(networkID int) (*params.NodeConfig, error)
• type BackendTestSuite
  • func (s *BackendTestSuite) LightEthereumService() *les.LightEthereum
  • func (s *BackendTestSuite) RestartTestNode()
  • func (s *BackendTestSuite) SetupTest()
  • func (s *BackendTestSuite) StartTestBackend(opts ...TestNodeOption)
  • func (s *BackendTestSuite) StopTestBackend()
  • func (s *BackendTestSuite) TearDownTest()
  • func (s *BackendTestSuite) TxQueueManager() *transactions.Manager
  • func (s *BackendTestSuite) WhisperService() *whisper.Whisper
• type NodeManagerTestSuite
  • func (s *NodeManagerTestSuite) StartTestNode(opts ...TestNodeOption)
  • func (s *NodeManagerTestSuite) StopTestNode()
• type TestNodeOption
  • func WithUpstream(url string) TestNodeOption

Functions

func FirstBlockHash

func FirstBlockHash(nodeManager common.NodeManager) (string, error)

FirstBlockHash validates Attach operation for the NodeManager.

func MakeTestNodeConfig

func MakeTestNodeConfig(networkID int) (*params.NodeConfig, error)

MakeTestNodeConfig defines a function to return a giving params.NodeConfig where specific network addresses are assigned based on provieded network id.

Types

type BackendTestSuite

type BackendTestSuite struct {
	suite.Suite
	Backend *api.StatusBackend
}

BackendTestSuite is a test suite with api.StatusBackend initialized and a few utility methods to start and stop node or get various services.

func (*BackendTestSuite) LightEthereumService

func (s *BackendTestSuite) LightEthereumService() *les.LightEthereum

LightEthereumService returns a reference to the LES service.

func (*BackendTestSuite) RestartTestNode

func (s *BackendTestSuite) RestartTestNode()

RestartTestNode restarts a currently running node.

func (*BackendTestSuite) SetupTest

func (s *BackendTestSuite) SetupTest()

SetupTest initializes Backend.

func (*BackendTestSuite) StartTestBackend

func (s *BackendTestSuite) StartTestBackend(opts ...TestNodeOption)

StartTestBackend imports some keys and starts a node.

func (*BackendTestSuite) StopTestBackend

func (s *BackendTestSuite) StopTestBackend()

StopTestBackend stops the node.

func (*BackendTestSuite) TearDownTest

func (s *BackendTestSuite) TearDownTest()

TearDownTest cleans up the packages state.

func (*BackendTestSuite) TxQueueManager

func (s *BackendTestSuite) TxQueueManager() *transactions.Manager

TxQueueManager returns a reference to the TxQueueManager.

func (*BackendTestSuite) WhisperService

func (s *BackendTestSuite) WhisperService() *whisper.Whisper

WhisperService returns a reference to the Whisper service.

type NodeManagerTestSuite

type NodeManagerTestSuite struct {
	suite.Suite
	NodeManager *node.NodeManager
}

NodeManagerTestSuite defines a test suit with NodeManager.

func (*NodeManagerTestSuite) StartTestNode

func (s *NodeManagerTestSuite) StartTestNode(opts ...TestNodeOption)

StartTestNode initiazes a NodeManager instances with configuration retrieved from the test config.

func (*NodeManagerTestSuite) StopTestNode

func (s *NodeManagerTestSuite) StopTestNode()

StopTestNode attempts to stop initialized NodeManager.

type TestNodeOption

type TestNodeOption func(config *params.NodeConfig)

TestNodeOption is a callback passed to StartTestNode which alters its config.

func WithUpstream

func WithUpstream(url string) TestNodeOption

WithUpstream returns TestNodeOption which enabled UpstreamConfig.