Resolve conflicts: merge main into PR #239 (combine both changes)

Author: Calebux

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+## Bug Report
+
+### Description
+Describe the issue clearly.
+
+---
+
+### Steps to Reproduce
+1.
+2.
+3.
+
+---
+
+### Expected Behavior
+What should happen?
+
+---
+
+### Actual Behavior
+What actually happens?
+
+---
+
+### Environment
+- OS:
+- Node version:
+- Browser:
+
+---
+
+### Additional Context
+Logs, screenshots, or extra details.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,24 @@
+## Feature Request
+
+### Description
+What feature would you like to see?
+
+---
+
+### Problem
+What problem does this solve?
+
+---
+
+### Proposed Solution
+Describe your idea.
+
+---
+
+### Alternatives Considered
+Any other approaches?
+
+---
+
+### Additional Context
+Add extra details if needed.

.github/pull_request_template.md

@@ -0,0 +1,31 @@
+
+## Description
+
+Briefly describe what this PR does.
+
+---
+
+## Related Issue
+
+Closes #
+
+---
+
+## Test Plan
+
+- [ ] Tested locally
+- [ ] Verified expected behavior
+- [ ] No regressions introduced
+
+---
+
+## Screenshots (if applicable)
+
+---
+
+## Checklist
+
+- [ ] Code builds successfully
+- [ ] Tests pass
+- [ ] Follows project conventions
+- [ ] No sensitive data exposed

.github/workflows/contracts.yml

@@ -0,0 +1,67 @@
+name: Contracts
+
+on:
+    push:
+        branches: [main]
+        paths:
+            - "contracts/**"
+    pull_request:
+        branches: [main]
+        paths:
+            - "contracts/**"
+
+permissions:
+    contents: read
+
+concurrency:
+    group: contracts-${{ github.workflow }}-${{ github.ref }}
+    cancel-in-progress: true
+
+jobs:
+    build-contracts:
+        runs-on: ubuntu-latest
+        timeout-minutes: 20
+        defaults:
+            run:
+                working-directory: contracts
+
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Install Rust
+              uses: dtolnay/rust-toolchain@stable
+              with:
+                  targets: wasm32-unknown-unknown
+
+            - name: Cache Rust dependencies
+              uses: Swatinem/rust-cache@v2
+              with:
+                  workspaces: contracts
+
+            - name: Build contracts
+              run: cargo build --target wasm32-unknown-unknown --release
+
+            - name: Run contract tests
+              run: cargo test
+
+            - name: Check contract sizes
+              shell: bash
+              run: |
+                  set -euo pipefail
+                  shopt -s nullglob
+
+                  wasm_files=(target/wasm32-unknown-unknown/release/*.wasm)
+
+                  if [ ${#wasm_files[@]} -eq 0 ]; then
+                    echo "No WASM artifacts found in target/wasm32-unknown-unknown/release"
+                    exit 1
+                  fi
+
+                  for wasm in "${wasm_files[@]}"; do
+                    size=$(wc -c < "$wasm")
+                    echo "$wasm: ${size} bytes"
+
+                    if [ "$size" -gt 65536 ]; then
+                      echo "WARNING: Contract exceeds 64KB limit"
+                    fi
+                  done

.github/workflows/e2e.yml

@@ -0,0 +1,62 @@
+name: E2E Tests
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  playwright:
+    name: Playwright E2E (Desktop + Mobile)
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: client/package-lock.json
+
+      - name: Install dependencies
+        working-directory: client
+        run: npm ci
+
+      - name: Install Playwright browsers
+        working-directory: client
+        run: npx playwright install --with-deps
+
+      - name: Verify preview deployment URL is available
+        env:
+          E2E_BASE_URL: ${{ secrets.E2E_BASE_URL }}
+        run: |
+          if [ -z "$E2E_BASE_URL" ]; then
+            echo "Missing E2E_BASE_URL secret. Set it to your Vercel preview deployment URL pattern for PR testing."
+            exit 1
+          fi
+
+      - name: Run Playwright tests
+        working-directory: client
+        env:
+          CI: true
+          E2E_BASE_URL: ${{ secrets.E2E_BASE_URL }}
+        run: npx playwright test
+
+      - name: Upload Playwright report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: client/playwright-report/
+          retention-days: 14
+
+      - name: Upload failure screenshots and traces
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-test-results
+          path: client/test-results/
+          retention-days: 14

.github/workflows/lint.yml

@@ -0,0 +1,38 @@
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-backend:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: backend
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+          cache-dependency-path: backend/package-lock.json
+      - run: npm ci
+      - run: npx eslint src --ext .ts --max-warnings 0
+
+  lint-client:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: client
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+          cache-dependency-path: client/package-lock.json
+      - run: npm ci
+      - run: npx next lint

.github/workflows/soroban_tests.yml

@@ -0,0 +1,34 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test-backend:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: backend
+    env:
+      NODE_ENV: test
+      SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
+      SUPABASE_SERVICE_ROLE_KEY: ${{ secrets.SUPABASE_SERVICE_ROLE_KEY }}
+      JWT_SECRET: test-secret
+      ADMIN_API_KEY: test-admin-key
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: backend/package-lock.json
+      - run: npm ci
+      - run: npm test -- --coverage --ci
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: coverage-report
+          path: backend/coverage/

.github/workflows/test.yml

@@ -100,4 +100,4 @@ coverage/
 *.claude
 CLAUDE.md
 
-backend/package-lock.json
+!backend/package-lock.json

.gitignore

@@ -0,0 +1 @@
+{"specId": "7fce59ae-4f86-43e1-b223-34de74af24d0", "workflowType": "requirements-first", "specType": "feature"}