The E2E tests run against local deployments of the parachain, relayer and ganache.

• Development environment for Rust and Substrate. See parachain requirements.

• Node 14 LTS. Can install using nvm:

  nvm install 14.17.4
  nvm use 14.17.4

• Development environment for Ethereum smart contracts.

  (cd ../ethereum && yarn install)

• Development environment for the relay services. See relayer requirements.

• timeout - native package on Ubuntu, on macOS try brew install coreutils

• jq - https://stedolan.github.io/jq/download/

• geth - https://geth.ethereum.org/docs/install-and-build/installing-geth

• sponge - Is available in the moreutils package. On Mac see https://formulae.brew.sh/formula/moreutils. On Linux:

  apt install moreutils

• polkadot-launch

  git clone -b fix-simple-paras https://github.com/Snowfork/polkadot-launch.git
  yarn install
  yarn build
  yarn global add file:$(pwd)

• Clone the polkadot repository somewhere on your machine
• Checkout commit release-v0.9.12.
• Build polkadot and the adder-collator parachain

Example:

git clone -n https://github.com/paritytech/polkadot.git
cd /path/to/polkadot
git checkout release-v0.9.12
cargo build --release
cargo build --manifest-path parachain/test-parachains/adder/collator/Cargo.toml --release

Create an .env file with variables that point to the binaries for polkadot and adder-collator

Example:

POLKADOT_BIN=/path/to/polkadot/target/release/polkadot
ADDER_COLLATOR_BIN=/path/to/polkadot/target/release/adder-collator

Run the following script

scripts/start-services.sh

Wait until the "System has been initialized" message

Go to polkadot-js and wait until the parachain has started producing blocks: https://polkadot.js.org/apps/?rpc=ws%3A%2F%2F127.0.0.1%3A11144#/explorer

You can see the relay chain by connecting to https://polkadot.js.org/apps/?rpc=ws%3A%2F%2F127.0.0.1%3A9944#/explorer

Confirm the block number is > 2

The start-services.sh script writes the following logs:

• Parachain nodes: /tmp/snowbridge/{alice,bob,11144,11155}.log
• Relay services: /tmp/snowbridge/{beefy,parachain,ethereum}-relay.log
• Geth: /tmp/snowbridge/geth.log

Download dependencies:

yarn install

You should now be good to go!

yarn test

These tests are meant to closely replicate real-world behaviour. This means that they also replicate real-world delays and confirmation times. This can take up to 4 minutes per test and ~20minutes for all tests.

We also have a test environment that tests against a malicious contract that attempts to consume infinite gas. To setup this environment, run the start-services script with the malicious flag:

TEST_MALICIOUS_APP=1 scripts/start-services.sh

This will deploy and run everything as usual, but replace the dot app with a malicious one. Once everything is ready to go, run the tests for the malicious app:

yarn test ./test/malicious-dotapp.js

You should see the test pass, checking that message delivery works correctly and channel functionality is still secure without being affected by the malicious app.

Test fixtures are taken by running the service in full e2e test. The relayer should log the fixture data you need (code is in the relayer here, though may require a bit of manual copy/pasting to get perfectly it in the right format.