Merge branch 'main' into feat/cargo-testutils-feature-flag

Author: ritik4ever

.github/workflows/check-bindings.yml

@@ -0,0 +1,45 @@
+name: Check ABI Drift
+
+on:
+  pull_request:
+    paths:
+      - 'contracts/src/**'
+      - 'frontend/src/generated/**'
+      - '.github/workflows/check-bindings.yml'
+
+jobs:
+  check-bindings:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Stellar CLI
+        run: |
+          curl -L https://github.com/stellar/js-stellar-sdk/releases/download/v14.0.0/stellar-cli-linux-x86_64.tar.gz -o stellar-cli.tar.gz
+          tar -xzf stellar-cli.tar.gz
+          chmod +x stellar
+
+      - name: Regenerate bindings
+        run: npm run gen:bindings
+        env:
+          CONTRACT_ID: ${{ secrets.CONTRACT_ID }}
+          RPC_URL: https://soroban-testnet.stellar.org
+          NETWORK_PASSPHRASE: 'Test SDF Network ; September 2015'
+
+      - name: Check for ABI drift
+        run: |
+          if ! git diff --exit-code frontend/src/generated/; then
+            echo "❌ ABI drift detected!"
+            echo "Contract ABI changed but bindings were not regenerated."
+            echo "Run 'npm run gen:bindings' and commit the changes."
+            exit 1
+          fi
+          echo "✅ Bindings are up to date"

.github/workflows/load-test.yml

@@ -0,0 +1,104 @@
+name: Load Test
+
+on:
+  schedule:
+    - cron: '0 6 * * 1'
+  workflow_dispatch:
+
+jobs:
+  load-test:
+    runs-on: ubuntu-latest
+    name: Load Test
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+          cache-dependency-path: 'backend/package-lock.json'
+
+      - name: Install backend dependencies
+        working-directory: backend
+        run: npm ci
+
+      - name: Install autocannon
+        working-directory: backend
+        run: npm install --no-save autocannon
+
+      - name: Build backend
+        working-directory: backend
+        run: npm run build
+
+      - name: Start backend (in-memory SQLite)
+        working-directory: backend
+        run: |
+          NODE_ENV=test DB_PATH=:memory: node dist/index.js &
+          BACKEND_PID=$!
+          echo "Backend PID: $BACKEND_PID"
+          echo "BACKEND_PID=$BACKEND_PID" >> $GITHUB_ENV
+          for i in $(seq 1 30); do
+            if curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:3001/api/health | grep -q 200; then
+              echo "Backend is ready"
+              break
+            fi
+            echo "Waiting for backend... attempt $i"
+            sleep 2
+          done
+
+      - name: Run CI load test
+        id: load-test
+        working-directory: backend
+        run: |
+          node scripts/ci-load-test.js 2>&1 | tee load-test-output.txt
+
+      - name: Check thresholds from JSON output
+        id: check-thresholds
+        run: |
+          python3 << 'EOF'
+          import json, os
+
+          with open("backend/load-test-output.txt") as f:
+              content = f.read()
+
+          start = content.index("---JSON-START---") + len("---JSON-START---")
+          end = content.index("---JSON-END---")
+          summary = json.loads(content[start:end].strip())
+
+          p99 = summary["latency"]["p99"]
+          error_rate = summary["requests"]["errorRate"]
+          passed = summary["passed"]
+
+          with open(os.environ["GITHUB_OUTPUT"], "a") as out:
+              out.write(f"summary={json.dumps(summary)}\n")
+              out.write(f"p99={p99}\n")
+              out.write(f"error-rate={error_rate}\n")
+              out.write(f"passed={passed}\n")
+
+          print(f"p99: {p99}ms")
+          print(f"Error rate: {error_rate}%")
+          print(f"Passed: {passed}")
+
+          if not passed:
+              print("❌ Thresholds exceeded!")
+              exit(1)
+          else:
+              print("✅ All thresholds passed!")
+          EOF
+
+      - name: Upload load test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: load-test-results
+          path: backend/load-test-output.txt
+
+      - name: Cleanup backend
+        if: always()
+        run: |
+          if [ -n "$BACKEND_PID" ]; then
+            kill $BACKEND_PID 2>/dev/null || true
+          fi

.vscode/settings.json

@@ -1 +1,2 @@
-{}
+{
+}

CONTRIBUTING.md

@@ -18,9 +18,118 @@ Thank you for your interest in contributing to **Stellar Goal Vault**!
 - Check the [FAQ.md](./FAQ.md) for answers to common questions.
 - Browse `OPEN_SOURCE_ISSUES.md` for curated contribution ideas.
 
+## Backend Development
+
+### Prerequisites
+
+- **Node.js** 18+ (check with `node --version`)
+- **npm** 9+ (comes with Node.js)
+
+### Setup
+
+1. Navigate to the backend directory:
+   ```bash
+   cd backend
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Copy the environment file:
+   ```bash
+   cp .env.example .env
+   ```
+
+4. Configure environment variables in `.env`:
+   - `DB_PATH`: Path to SQLite database file (default: `../../data/campaigns.db`)
+   - `NODE_ENV`: Set to `development` for local development
+   - `PORT`: Server port (default: 3000)
+   - `CORS_ALLOWED_ORIGINS`: Comma-separated list of allowed origins
+   - `CONTRACT_ID`: Stellar contract ID (required for pledge operations)
+   - `SOROBAN_RPC_URL`: URL to Soroban RPC endpoint
+   - `NETWORK_PASSPHRASE`: Stellar network (default: `Test SDF Network ; September 2015` for testnet)
+
+### Running the Backend
+
+- **Development mode** (with auto-reload):
+  ```bash
+  npm run dev
+  ```
+  Server listens on `http://localhost:3000` by default.
+
+- **Production mode** (build and run):
+  ```bash
+  npm run build
+  npm start
+  ```
+
+- **Watch mode** (for editing and testing):
+  ```bash
+  npm run dev
+  ```
+
+### Testing
+
+- **Run all tests once**:
+  ```bash
+  npm test
+  ```
+
+- **Run tests in watch mode** (re-run on file changes):
+  ```bash
+  npm run test:watch
+  ```
+
+- **Run with coverage**:
+  ```bash
+  npm test -- --coverage
+  ```
+
+### Database
+
+- **Seeding**: The application automatically initializes the SQLite database with the schema on first run. To seed deterministic test campaigns:
+  ```bash
+  npm test -- tests/services/seedDeterministic.test.ts
+  ```
+
+- **Viewing the database**:
+  - Use SQLite CLI: `sqlite3 ../../data/campaigns.db`
+  - Or use a GUI tool like [DB Browser for SQLite](https://sqlitebrowser.org/)
+
+- **Resetting the database** (for testing):
+  - Delete the database file: `rm ../../data/campaigns.db`
+  - Next run will recreate it with the schema
+
+### Troubleshooting
+
+#### "SQLITE_CANTOPEN" or database file not found
+- Ensure the directory specified in `DB_PATH` exists
+- Check file permissions on the database directory
+- If the directory doesn't exist, create it: `mkdir -p data`
+
+#### Tests fail with "database is locked"
+- This indicates concurrent access issues. Ensure only one test process is running.
+- Try clearing the test database: `rm test-temp-*.db*`
+- Run tests serially: `npm test -- --no-coverage`
+
+#### "Cannot find module" errors
+- Run `npm install` in the `backend` directory
+- Clear node_modules and reinstall: `rm -rf node_modules && npm install`
+
+#### Port already in use
+- Change the `PORT` in `.env` to an available port (e.g., 3001)
+- Or kill the process on the current port
+
+#### Environment variable not picked up
+- Ensure `.env` file is in the `backend` directory
+- Restart the development server after editing `.env`
+- Check for syntax errors in `.env` (no spaces around `=`)
+
 ## Testing
 
-- Backend: `cd backend && npx vitest`
+- Backend: `cd backend && npm test`
 - Contract: `cd contracts && cargo test`
 - E2E: `npm run test:e2e`