Merge branch 'main' into wire-up-leaderboard

Author: heymide

.env.example

@@ -26,3 +26,22 @@ PUBLIC_STELLAR_HORIZON_URL="http://localhost:8000"
 # PUBLIC_STELLAR_NETWORK_PASSPHRASE="Public Global Stellar Network ; September 2015"
 # PUBLIC_STELLAR_RPC_URL=
 # PUBLIC_STELLAR_HORIZON_URL=
+
+# V1 Contract IDs (deployed to Testnet)
+# These will be populated after running ./scripts/deploy-testnet.sh
+
+# Core Platform Contracts
+PUBLIC_LEARN_TOKEN_CONTRACT=""
+PUBLIC_GOVERNANCE_TOKEN_CONTRACT=""
+
+# Scholarship System Contracts  
+PUBLIC_COURSE_MILESTONE_CONTRACT=""
+PUBLIC_MILESTONE_ESCROW_CONTRACT=""
+PUBLIC_SCHOLARSHIP_TREASURY_CONTRACT=""
+PUBLIC_SCHOLAR_NFT_CONTRACT=""
+
+# Token Contract
+PUBLIC_USDC_CONTRACT_ID="" # USDC token contract address (testnet or mainnet)
+
+# Optional: Friendbot-funded deployer address for testing
+# PUBLIC_DEPLOYER_ADDRESS=""

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -38,7 +38,8 @@ body:
     id: environment
     attributes:
       label: Environment
-      description: Include OS, browser, Node.js version, and wallet details if relevant.
+      description:
+        Include OS, browser, Node.js version, and wallet details if relevant.
       placeholder: macOS 14.4, Chrome 123, Node 22.2.0, Freighter
     validations:
       required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -24,6 +24,7 @@ body:
     id: alternatives
     attributes:
       label: Alternatives considered
-      description: What alternatives did you evaluate and why were they insufficient?
+      description:
+        What alternatives did you evaluate and why were they insufficient?
     validations:
       required: false

.github/workflows/build.yml

@@ -42,6 +42,9 @@ jobs:
           else
             echo "stellar-scaffold already installed. Clear cache to force reinstall."
           fi
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
       - run: npm ci
       - run: npm run lint
       - run: npx prettier . --check

.github/workflows/e2e.yml

@@ -0,0 +1,34 @@
+name: E2E (Playwright)
+
+on:
+  pull_request:
+
+jobs:
+  e2e:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - 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 --with-deps chromium
+
+      - name: Run E2E tests
+        run: npm run test:e2e
+
+      - name: Upload test artifacts (on failure)
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-artifacts
+          path: |
+            test-results/
+            playwright-report/

.github/workflows/frontend-ci.yml

@@ -23,7 +23,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: lts/*
+          node-version: 22
           cache: npm
 
       - name: Install dependencies

.github/workflows/preview-comment.yml

@@ -0,0 +1,39 @@
+# .github/workflows/preview-comment.yml
+name: Preview deployment comment
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  comment-preview-url:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+    steps:
+      - name: Wait for Vercel preview
+        uses: patrickedqvist/wait-for-vercel-preview@v1.3.1
+        id: vercel_preview
+        continue-on-error: true
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          environment: Preview
+          max_timeout: 120
+
+      - name: Post preview URL comment
+        if: ${{ steps.vercel_preview.outputs.url != '' }}
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `🚀 **Preview deployed!**\n\n${process.env.PREVIEW_URL}\n\n> Built against Stellar Testnet`
+            })
+        env:
+          PREVIEW_URL: ${{ steps.vercel_preview.outputs.url }}
+
+      - name: Skip missing preview
+        if: ${{ steps.vercel_preview.outputs.url == '' }}
+        run: echo "No Vercel preview deployment found for this pull request."

.gitignore

@@ -12,6 +12,13 @@ test_snapshots
 dist
 dist-ssr
 
+# Playwright E2E output
+test-results/
+playwright-report/
+
+# TypeScript incremental build info
+*.tsbuildinfo
+
 # dependencies
 node_modules/
 
@@ -43,3 +50,6 @@ packages/*
 # generated contract client imports
 src/contracts/*
 !src/contracts/util.ts
+
+# test coverage
+coverage/

.prettierignore

@@ -1,2 +1,3 @@
 package-lock.json
 Cargo.lock
+.github/