Run Bridge Tests
This guide will show you how to run end-to-end (e2e) bridge tests against a Kurtosis devnet.
This guide assumes you have a running devnet, if that's not the case, you can head to the Getting Started section.
Clone the Test Suite
First, clone the agglayer/e2e repository. PoS-related tests are located in tests/pos.
git clone https://github.com/agglayer/e2e.git
cd e2e
Run Bats Tests
We rely on bats, a bash testing framework to run most of our e2e tests. The next steps assume you have it installed.
Then run the L1-to-L2 bridge test to validate that Heimdall and Bor can process bridge events and trigger state synchronizations.
bats --filter-tags pos,bridge,matic,pol --recursive tests/
If you have deployed the test runner in your environment, you can run the tests without cloning the repository:
kurtosis service exec pos test-runner "bats --filter-tags pos,bridge,matic,pol --recursive tests/"
After the tests complete, you should see output similar to:
The command was successfully executed and returned '0'.
1..1
ok 1 bridge MATIC/POL from L1 to L2 and confirm L2 ETH balance increased
If any tests fail, check the logs in your Kurtosis enclave for more details.