Set Up Playwright End-to-End (E2E) Test Suite with Synpress

[Lakes41]

Background

The application relies solely on basic unit tests. There are no automated browser tests that actually verify the frontend connecting to a wallet and signing transactions.

Problem

Frequent UI updates occasionally break core smart contract interaction flows, and manual regression testing before every deployment is tedious and error-prone.

Expected Outcome

A robust End-to-End testing pipeline utilizing Playwright and Synpress (a MetaMask automation wrapper) to simulate real user wallet interactions in a headless browser.

Suggested Implementation

• Install @synthetixio/synpress and configure it alongside Playwright.
• Write test cases for the critical path: Connect Wallet -> Navigate to Vault -> Input Amount -> Approve Token -> Deposit Token.
• Connect the tests to a local Hardhat/Anvil fork network so real transactions can be simulated safely in CI.

Acceptance Criteria

• E2E tests successfully mock a MetaMask extension, import a local test account, and sign a transaction.
• GitHub Actions CI pipeline runs the Synpress suite on every pull request targeting the main branch.

Likely Affected Files

• tests/e2e/deposit.spec.ts
• playwright.config.ts
• .github/workflows/e2e-tests.yml

Requirements

• Tests must run reliably in CI without timing out due to slow network mock responses.

[Paranoa-dev]

I’d like to take this on. I have experience building Playwright-based end-to-end test suites for Web3 applications, including automated wallet interactions, CI integration, and deterministic test environments for blockchain workflows.

For this issue, I'll set up Synpress alongside Playwright to automate MetaMask, import a dedicated test account, and connect it to a local Hardhat/Anvil fork so transactions can be executed safely during testing. I'll implement an end-to-end test covering the primary user journey: connect wallet → navigate to a vault → enter a deposit amount → approve the token → sign and confirm the deposit transaction, validating both the UI state and transaction outcome.

I'll also configure the GitHub Actions workflow to provision the local blockchain environment, launch the browser with the MetaMask extension, and run the Synpress suite reliably on pull requests targeting main. Particular attention will be given to eliminating flaky timing issues through deterministic waits, health checks, and resilient synchronization instead of arbitrary delays.

Finally, I'll document the local setup, ensure the suite can be run both locally and in CI, and verify that the implementation provides stable regression coverage for the application's critical wallet interaction flow.

[grantfox-oss]

🦊 GrantFox — @Paranoa-dev has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #93)
2. Your PR will be reviewed by the Adamantine-guild maintainers

Good luck! Track your progress on GrantFox.