Dev

.github/workflows/ci.yml

@@ -0,0 +1,96 @@
+name: CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # ─── Contracts: compile + unit + integration tests ───────────────────────
+  contracts:
+    name: Contracts — compile & test (v3.4)
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: ./contracts
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: contracts/package-lock.json
+
+      - name: Check for package-lock.json
+        run: |
+          if [ ! -f package-lock.json ]; then
+            echo "⚠️ package-lock.json not found, generating from package.json"
+            npm install --package-lock-only
+          fi
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Compile contracts
+        run: npx hardhat compile
+
+      - name: Run unit tests (Hardhat Network)
+        run: npx hardhat test test/unit/*.test.ts --network hardhat
+        continue-on-error: false
+
+      - name: Run integration tests (Hardhat Network)
+        run: npx hardhat test test/integration/*.test.ts --network hardhat
+        continue-on-error: false
+
+      - name: Upload test artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: contracts-test-results
+          path: test-results
+          if-no-files-found: warn
+
+
+
+  # ─── Frontend: lint + type-check + build ────────────────────────────────
+  frontend:
+    name: Frontend — lint & build
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: frontend
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npx eslint .
+
+      - name: Type check
+        run: npx tsc -b
+
+      - name: Unit tests
+        run: npx jest --ci --coverage
+
+      - name: Build
+        run: npx vite build

.gitignore

@@ -0,0 +1,40 @@
+# Dependencies
+node_modules/
+frontend/node_modules/
+
+# Build artifacts
+artifacts/
+cache/
+typechain-types/
+frontend/dist/
+frontend/dist-ssr/
+
+# Local node binaries (downloaded by scripts/setup-node.sh)
+bin/
+
+# Environment & secrets
+.env
+.env.*
+!.env.example
+
+# Generated deployment output
+deployed-addresses.json
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+
+# Editor & OS
+.vscode/
+.idea/
+.DS_Store
+*.suo
+*.sw?
+*.local
+
+# Coverage & reports
+coverage/
+coverage.json
+gasReporterOutput.json
+[empty]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 PolkaClaw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

contracts/.env.example

@@ -0,0 +1,9 @@
+# Deployer private key (hex, with 0x prefix)
+PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE
+
+# Testing: mnemonic phrase + HD derivation index (m/44'/60'/0'/0/{index})
+# PRIVATE_KEY_FOR_TESTING=your twelve word mnemonic phrase here
+# DERIVATION_INDEX=0
+
+# Optional: Gas reporter
+REPORT_GAS=false