Skip to content

Latest commit

 

History

History
82 lines (49 loc) · 2.7 KB

README.md

File metadata and controls

82 lines (49 loc) · 2.7 KB
Raw

auxo-e2e

This package contains the e2e test suite logic for the auxo app.

Setup

  1. Make sure you have a .env file set in the root of the auxo-e2e directory. You can see an example of the file in .env.example

At the time of writing, tests are written with an explicit test account in mind, grab the private key of the account from knxpwr or jordaniza

  1. Serve the auxo application on port 4200 with Nx serve auxo

  2. Start forks of the blockchain networks you wish to test. We will likely be migrating all config into this repo in the future, but for now:

  • 3a. Clone dapp-workstation and follow setup instructions
  • 3b. Run the following commands inside the dapp-workstation to start forks and initialise the state:
# Terminal 1
yarn fork:mainnet

# Terminal 2
yarn fork:ftm

# Terminal 3
yarn run:fork scripts/auxo/init.ts
yarn run:fork:ftm scripts/auxo/auxo.ts

Run test suite:

e2e tests use Synpress under the hood. This is a wrapper around Cypress that handles downloading, connecting to and authenticating with metamask.

Run it using the below command from the root directory:

$ nx synpress auxo-e2e

Remember to configure your .env file with the correct network informations (local RPC for instance) to test the target chain interactions.

Troubleshooting

Tests not working

  • Ensure the auxo app is running and on port 4200
  • Ensure all env vars are set correctly, in both the auxo and auxo e2e package
  • Ensure the forks are running and the initialisation scripts have completed successfully
  • Ensure you are not running niche operating systems for nerds

Cannot connect to browser

By default, synpress uses chrome as the browser, and will expect it to be installed on your system.

See the Synpress docs if you want to switch to another browser.

Missing style-jsx

Run into on some computers that you are missing style-jsx package. If you do find this, just npm install the library and restart the app.

Metamask issues

Cypress extensions require a certain set of dependencies to be installed, depending on your OS. See the Cypress Docs for Windows, MacOS, and installation instructions for most Linux distros.

For Arch Linux based distros, ensure the following packages are installed:

Arch Core:

sudo pacman -S gtk2 gtk3 libnotify dconf nss alsa-lib libxtst xorg-xauth unzip

AUR (we are using Paru here as an example):

paru -S xscreensaver

Please see this issue for a full reference Manjaro docker image.