Merge branch 'main' into feat/subs

Author: Abd-Standard

.dockerignore

@@ -0,0 +1,14 @@
+**/.git
+**/node_modules
+**/dist
+**/build
+**/.next
+**/coverage
+**/*.log
+**/*.db
+**/*.db-journal
+**/data
+**/.env
+**/.env.*
+!**/.env.example
+contract/target

.editorconfig

@@ -0,0 +1,21 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{ts,tsx,js,jsx,cjs,mjs,json,yaml,yml,md}]
+indent_style = space
+indent_size = 2
+
+[*.rs]
+indent_style = space
+indent_size = 4
+
+[Makefile]
+indent_style = tab
+
+[*.md]
+trim_trailing_whitespace = false

.env.example

@@ -0,0 +1,23 @@
+# Root .env — values here are picked up by docker compose via ${VAR} substitution.
+# Copy to .env and fill in your values:
+#   cp .env.example .env
+
+# ── Stellar connectivity ──────────────────────────────────────────────────────
+STELLAR_RPC_URL=https://soroban-testnet.stellar.org:443
+STELLAR_NETWORK=testnet
+STELLAR_NETWORK_PASSPHRASE=Test SDF Network ; September 2015
+
+# Replace with your deployed contract ID
+CONTRACT_ADDRESSES=[{"address":"CXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","events":["*"]}]
+
+# ── Dashboard ─────────────────────────────────────────────────────────────────
+# Vite embeds this at BUILD time — change requires `docker compose up --build`
+VITE_EVENTS_API_URL=http://localhost:8787/api/events
+VITE_STELLAR_NETWORK=TESTNET
+
+# ── Optional: Discord notifications ──────────────────────────────────────────
+# DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN
+# DISCORD_WEBHOOK_ID=YOUR_ID
+
+# ── Logging ───────────────────────────────────────────────────────────────────
+LOG_LEVEL=info

.github/dependabot.yml

@@ -0,0 +1,85 @@
+version: 2
+
+updates:
+  # Dashboard (frontend) npm dependencies
+  - package-ecosystem: "npm"
+    directory: "/dashboard"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+      timezone: "UTC"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "frontend"
+    commit-message:
+      prefix: "chore(dashboard)"
+    groups:
+      react:
+        patterns:
+          - "react"
+          - "react-dom"
+          - "@types/react"
+          - "@types/react-dom"
+      testing:
+        patterns:
+          - "@testing-library/*"
+          - "jest"
+          - "jest-*"
+          - "ts-jest"
+          - "@types/jest*"
+      typescript-eslint:
+        patterns:
+          - "@typescript-eslint/*"
+          - "eslint*"
+          - "typescript"
+      vite:
+        patterns:
+          - "vite"
+          - "@vitejs/*"
+
+  # Listener npm dependencies
+  - package-ecosystem: "npm"
+    directory: "/listener"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+      timezone: "UTC"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "listener"
+    commit-message:
+      prefix: "chore(listener)"
+
+  # Rust/Cargo contract dependencies
+  - package-ecosystem: "cargo"
+    directory: "/contract"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+      timezone: "UTC"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "contract"
+    commit-message:
+      prefix: "chore(contract)"
+
+  # GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+      timezone: "UTC"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "chore(ci)"

.github/pull_request_template.md

@@ -0,0 +1,34 @@
+## Overview
+
+<!-- What does this PR change and why? -->
+
+## Related Issue
+
+Closes #<!-- issue number -->
+
+## Changes
+
+<!-- List the key files/areas modified -->
+
+## Verification
+
+<!-- What commands did you run to verify this works? -->
+
+```bash
+# e.g.
+cd dashboard && npm test
+cd listener && npm run typecheck && npm test
+cd contract/contracts/hello-world && cargo test
+```
+
+## How to Test
+
+<!-- Any manual steps a reviewer needs beyond running the test suite -->
+
+## Checklist
+
+- [ ] Branch is up to date with `main`
+- [ ] Tests added/updated and all pass locally
+- [ ] `cargo fmt --all` run (if Rust changes)
+- [ ] `npm run lint` passes (if TypeScript changes)
+- [ ] Documentation updated if behavior changed

.github/workflows/ci.yml

@@ -2,17 +2,39 @@ name: CI
 
 on:
   pull_request:
-    paths:
-      - 'listener/src/migrations/**'
-      - 'listener/src/database/**'
-      - 'listener/src/scripts/**'
-      - 'listener/package.json'
   push:
     branches:
       - main
       - staging
 
 jobs:
+  format:
+    name: Formatting checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install dashboard dependencies
+        working-directory: dashboard
+        run: npm ci
+
+      - name: Check dashboard formatting (Prettier)
+        working-directory: dashboard
+        run: npm run format:check
+
+      - name: Install listener dependencies
+        working-directory: listener
+        run: npm ci
+
+      - name: Check listener formatting (Prettier)
+        working-directory: listener
+        run: npm run format:check
+
   frontend:
     name: Frontend (lint, typecheck, test)
     runs-on: ubuntu-latest
@@ -21,7 +43,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 20
           cache: "npm"
           cache-dependency-path: dashboard/package-lock.json
       - name: Install dependencies
@@ -54,7 +76,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 20
           cache: "npm"
           cache-dependency-path: listener/package-lock.json
       - name: Install dependencies

.github/workflows/preview-cleanup.yml

@@ -17,6 +17,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Delete Cloudflare Pages deployment
+        if: github.event.pull_request.head.repo.full_name == github.repository
         uses: cloudflare/wrangler-action@v3
         with:
           apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}

.github/workflows/preview.yml

@@ -23,7 +23,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
           cache: npm
           cache-dependency-path: dashboard/package-lock.json
 

.github/workflows/staging.yml

@@ -31,9 +31,20 @@ jobs:
           cd listener
           npm ci
           npm run build
+      - name: Start listener (background)
+        run: |
+          cd listener
+          nohup npm run start >/tmp/listener.log 2>&1 &
+          echo $! >/tmp/listener.pid
       - run: |
           cd dashboard
           npm ci
           npm run build
       - run: |
-          bash scripts/health-check.sh http://localhost:3000/health
+          bash scripts/health-check.sh
+      - name: Stop listener
+        if: always()
+        run: |
+          if [ -f /tmp/listener.pid ]; then
+            kill "$(cat /tmp/listener.pid)" || true
+          fi

.gitignore

@@ -0,0 +1,22 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+build/
+.next/
+out/
+coverage/
+
+# Env / local
+.env
+.env.*
+!.env.example
+*.log
+.DS_Store
+
+# Tooling / data
+data/
+test-data/
+*.db
+*.db-journal