// readme

Polkadot Ecosystem Tests

Automated testing suite for the Polkadot ecosystem powered by Chopsticks.

Quick Start

# Install dependencies
yarn install

# Run all tests
yarn test

# Run tests for specific chain
yarn test <chain>

# Run specific test
yarn test -t <test-name> #<test-name> is what was passed to `vitest.test()`, usually inside a `describe()` suite

# Run with Vitest UI
yarn test:ui

# Update snapshots
yarn test -u

For Network Operators

Automated Test Runs

  • Tests run every 6 hours automatically
  • Failed tests are retried after 5 minutes
  • Persistent failures trigger notifications
  • Subscribe to notification issues for updates

Manual Test Triggers

Use the bot trigger issue to run tests on-demand via GitHub Actions

For Test Writers

Test Naming Convention

For XCM tests between two networks, use the naming convention

<chain-a>.<chain-b>.test.ts

For end-to-end tests on a single network, use