Develop

.github/workflows/e2e-verify.yml

@@ -0,0 +1,78 @@
+name: E2E Verification Tests
+
+on:
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+
+# Read-only document verification suite (OA + W3C VC). No MetaMask, runs headless.
+jobs:
+  e2e-verify:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Playwright browsers
+        run: npx playwright install chromium --with-deps
+
+      # ── Local chain + contracts ──────────────────────────────────────────
+      - name: Start Hardhat node
+        run: npx hardhat node &
+        env:
+          NODE_OPTIONS: --max-old-space-size=4096
+
+      - name: Wait for Hardhat node
+        run: npx wait-on http://127.0.0.1:8545 --timeout 180000
+
+      # Token registry (token-registry fixtures) + document store (doc-store fixtures)
+      - name: Deploy contracts and mint tokens
+        run: node e2e/setup-contracts.cjs
+
+      - name: Deploy document store
+        run: node e2e/setup-document-store.cjs
+
+      # ── Dev server ───────────────────────────────────────────────────────
+      - name: Start dev server
+        run: npm run dev &
+        env:
+          VITE_APP_NETWORK: local
+          VITE_NETWORK_TYPE: testnet
+          VITE_RPC_URL_1337: http://127.0.0.1:8545
+
+      - name: Wait for dev server
+        run: npx wait-on http://localhost:5173 --timeout 180000
+
+      # ── Verification tests (headless, no MetaMask) ───────────────────────
+      - name: Run verification E2E tests
+        run: npm run e2e:verify
+        env:
+          CI: 'true'
+
+      - name: Upload Playwright report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report-verify
+          path: playwright-report-verify/
+          retention-days: 7
+
+      - name: Upload screenshots on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: verify-test-results
+          path: test-results/
+          retention-days: 7
+          if-no-files-found: ignore

.github/workflows/e2e.yml

@@ -0,0 +1,124 @@
+name: E2E Tests
+
+on:
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch: # allow manual trigger
+
+jobs:
+  e2e:
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Playwright browsers
+        run: npx playwright install chromium --with-deps
+
+      # ── Hardhat node ─────────────────────────────────────────────────────
+      - name: Start Hardhat node
+        run: npx hardhat node &
+        env:
+          # Give the node a moment before we use it
+          NODE_OPTIONS: --max-old-space-size=4096
+
+      - name: Wait for Hardhat node
+        run: npx wait-on http://127.0.0.1:8545 --timeout 180000
+
+      - name: Deploy contracts and mint tokens
+        run: node e2e/setup-contracts.cjs
+
+      # ── Dev server ───────────────────────────────────────────────────────
+      - name: Start dev server
+        run: npm run dev &
+        env:
+          VITE_APP_NETWORK: local
+          VITE_NETWORK_TYPE: testnet
+          VITE_RPC_URL_1337: http://127.0.0.1:8545
+          VITE_RPC_URL_80002: https://rpc-amoy.polygon.technology/
+          VITE_RPC_URL_137: https://rpc.ankr.com/polygon
+
+      - name: Wait for dev server
+        run: npx wait-on http://localhost:5173 --timeout 180000
+
+      # ── MetaMask wallet cache ────────────────────────────────────────────
+      # Cache the wallet setup so it is not rebuilt on every run.
+      - name: Cache MetaMask wallet
+        id: metamask-cache
+        uses: actions/cache@v4
+        with:
+          path: .cache-synpress
+          key: metamask-wallet-${{ hashFiles('e2e/wallet-setup/**') }}
+
+      - name: Build MetaMask wallet cache
+        if: steps.metamask-cache.outputs.cache-hit != 'true'
+        timeout-minutes: 10
+        run: npm run e2e:setup-wallet -- --headless
+        env:
+          HEADLESS: 'true'
+
+      # ── E2E tests ────────────────────────────────────────────────────────
+      - name: Start Xvfb virtual display
+        run: |
+          Xvfb :99 -screen 0 1280x720x24 >/dev/null 2>&1 &
+          sleep 1
+
+      - name: Install ffmpeg
+        run: sudo apt-get install -y ffmpeg
+
+      - name: Start screen recording
+        run: |
+          ffmpeg -f x11grab -video_size 1280x720 -framerate 15 \
+            -i :99 -c:v libx264 -preset ultrafast -pix_fmt yuv420p \
+            /tmp/e2e-recording.mp4 &
+          echo $! > /tmp/ffmpeg.pid
+
+      - name: Run E2E tests
+        run: npm run e2e
+        env:
+          DISPLAY: ':99'
+          CI: 'true'
+
+      - name: Stop screen recording
+        if: always()
+        run: |
+          kill $(cat /tmp/ffmpeg.pid) 2>/dev/null || true
+          sleep 2
+
+      # ── Artifacts ────────────────────────────────────────────────────────
+      - name: Upload Playwright report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 7
+
+      - name: Upload screen recording
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: screen-recording
+          path: /tmp/e2e-recording.mp4
+          retention-days: 7
+          if-no-files-found: ignore
+
+      - name: Upload screenshots on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results
+          path: test-results/
+          retention-days: 7
+          if-no-files-found: ignore

.gitignore

@@ -38,3 +38,9 @@ trustvc-cms/.sanity
 # Misc
 *.pem
 *.tsbuildinfo
+
+# Playwright / Synpress
+.cache-synpress
+playwright-report
+test-results
+cache

e2e/fixtures.ts

@@ -0,0 +1,8 @@
+import { testWithSynpress } from '@synthetixio/synpress'
+import { MetaMask, metaMaskFixtures } from '@synthetixio/synpress/playwright'
+import BasicSetup from './wallet-setup/basic.setup'
+
+const test = testWithSynpress(metaMaskFixtures(BasicSetup))
+const { expect } = test
+
+export { test, expect, MetaMask, BasicSetup }