Merge branch 'main' into feat/verifiable-and-privacy-preserving-delegated-onchain-execution

Author: sid030sid

.github/workflows/ci.yml

@@ -0,0 +1,99 @@
+name: Test and Build
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.12.0'
+      
+      # Frontend Linting
+      - name: Install frontend dependencies
+        working-directory: packages/demo-app-frontend
+        run: npm ci
+      
+      - name: Run ESLint (Frontend)
+        working-directory: packages/demo-app-frontend
+        run: npm run lint
+      
+      - name: Check Prettier formatting (Frontend)
+        working-directory: packages/demo-app-frontend
+        run: npx prettier --check .
+      
+      # Solidity Linting
+      - name: Install contract dependencies
+        working-directory: packages/trust-anchor-did-ethr
+        run: npm ci
+      
+      - name: Run Solhint (Contracts)
+        working-directory: packages/trust-anchor-did-ethr
+        run: npx solhint 'contracts/**/*.sol'
+
+  test:
+    name: Test
+    needs: lint
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.12.0'
+          cache: 'npm'
+          cache-dependency-path: packages/trust-anchor-did-ethr/package-lock.json
+      
+      - name: Install dependencies
+        working-directory: packages/trust-anchor-did-ethr
+        run: npm ci
+      
+      - name: Run Hardhat tests
+        working-directory: packages/trust-anchor-did-ethr
+        run: npx hardhat test
+
+  build:
+    name: Build
+    needs: test
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.12.0'
+      
+      # Compile Contracts
+      - name: Install contract dependencies
+        working-directory: packages/trust-anchor-did-ethr
+        run: npm ci
+      
+      - name: Compile smart contracts
+        working-directory: packages/trust-anchor-did-ethr
+        run: npx hardhat compile
+      
+      # Build Frontend
+      - name: Install frontend dependencies
+        working-directory: packages/demo-app-frontend
+        run: npm ci
+      
+      - name: Build frontend
+        working-directory: packages/demo-app-frontend
+        run: npm run build

.github/workflows/docs-validation.yml

@@ -0,0 +1,24 @@
+name: Docs Validation
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - 'docs/**'
+  pull_request:
+    branches: [ "main" ]
+    paths:
+      - 'docs/**'
+
+jobs:
+  lint-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Lint markdown files
+        uses: davidanson/markdownlint-cli2-action@v15
+        with:
+          globs: |
+            docs/**/*.md

.husky/pre-commit

@@ -0,0 +1 @@
+cd packages/demo-app-frontend && npx lint-staged

.markdownlint.json

@@ -0,0 +1,6 @@
+{
+  "default": true,
+  "MD013": false,
+  "MD033": false,
+  "MD041": false
+}

AGENTS.md

@@ -0,0 +1,42 @@
+# AI Agent Instructions for On-Chain SSI
+
+## Project Context
+This is an On-Chain Self-Sovereign Identity (SSI) architecture project. It enables organizations to issue and verify decentralized digital identities anchored on the blockchain using the `did:ethr` standard and CRSet (Credential Revocation Set) management.
+The repository is a **monorepo** containing smart contracts, frontend, and backend packages.
+
+## Tech Stack & Global Rules
+- **Node.js**: Strict requirement of `>= 22.12.0` (Do NOT use Node 20.x due to Hardhat 3 and Vite 7 constraints).
+- **Package Manager**: `npm` (version `>= 10.0.0`). Do not use `yarn` or `pnpm`.
+- **Language**: TypeScript is used everywhere (contracts and frontend).
+
+## Package-Specific Guidelines
+
+### 1. Smart Contracts (`packages/trust-anchor-did-ethr`)
+- **Framework**: Hardhat 3 with Viem (`@nomicfoundation/hardhat-toolbox-viem`).
+- **Solidity Version**: `0.8.28`.
+- **Deployment**: We use **Hardhat Ignition** (`@nomicfoundation/hardhat-ignition`). Do not use the legacy `hardhat-deploy` plugins.
+- **Testing**: Tests are written using Hardhat and Viem.
+- **Commands**:
+  - Compile: `npm run compile` (or `npx hardhat compile`)
+  - Test: `npx hardhat test`
+  - Local Node: `npx hardhat node`
+
+### 2. Frontend (`packages/demo-app-frontend`)
+- **Framework**: React 19 + Vite 7.
+- **Blockchain Interaction**: `wagmi` (v3) + `viem` (v2).
+- **Styling**: Tailwind CSS + Vanilla CSS (`index.css`). Use modern, clean aesthetics.
+- **Linting/Formatting**: ESLint and Prettier are strictly enforced via Husky pre-commit hooks. Ensure code passes `npm run lint` before committing.
+- **Commands**:
+  - Dev server: `npm run dev`
+  - Build: `npm run build`
+
+## Workflows
+
+### Git & Code Commits
+- We use Husky pre-commit hooks to lint and format code automatically. Do not bypass them unless explicitly instructed.
+- When generating Markdown documentation, ensure compliance with `markdownlint` (we ignore MD013 / line lengths by default).
+
+### Implementation Steps (For AI Agents)
+1. **Plan Mode**: Analyze the file structure, specifically checking the `package.json` in the respective sub-package before importing new libraries. Ask for clarification if unsure about the system architecture.
+2. **Build Mode**: Write clean, modular TypeScript code. Document any new smart contract functions with NatSpec comments. 
+3. **Verification**: Always double-check your output against the specific Vite or Hardhat versions we are using.