Initial commit

Author: digitalSloth

.env.example

@@ -0,0 +1,4 @@
+# WalletConnect Project ID (Reown)
+# Get your free project ID from: https://cloud.reown.com/
+# Note: WalletConnect is now Reown - same protocol, new name
+VITE_WALLETCONNECT_PROJECT_ID=your_project_id_here

.eslintrc.json

@@ -0,0 +1,23 @@
+{
+  "root": true,
+  "env": {
+    "browser": true,
+    "es2021": true,
+    "node": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:vue/vue3-recommended",
+    "@vue/typescript/recommended"
+  ],
+  "parser": "vue-eslint-parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "parser": "@typescript-eslint/parser",
+    "sourceType": "module"
+  },
+  "rules": {
+    "vue/multi-word-component-names": "off"
+  }
+}

.github/workflows/deploy.yml

@@ -0,0 +1,48 @@
+name: Deploy Web App
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Clean install dependencies
+        run: |
+          rm -rf node_modules package-lock.json
+          npm install
+
+      - name: Build web app
+        env:
+          VITE_WALLETCONNECT_PROJECT_ID: ${{ secrets.VITE_WALLETCONNECT_PROJECT_ID }}
+        run: npm run build:web
+
+      - name: Setup SSH
+        run: |
+          mkdir -p ~/.ssh
+          echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/deploy_key
+          chmod 600 ~/.ssh/deploy_key
+          ssh-keyscan -H ${{ secrets.SSH_HOST }} >> ~/.ssh/known_hosts
+
+      - name: Deploy to server
+        run: |
+          rsync -avz --delete \
+            -e "ssh -i ~/.ssh/deploy_key -o StrictHostKeyChecking=no" \
+            apps/web/dist/ \
+            ${{ secrets.SSH_USER }}@${{ secrets.SSH_HOST }}:${{ secrets.DEPLOY_PATH }}
+
+      - name: Cleanup
+        if: always()
+        run: rm -f ~/.ssh/deploy_key

.gitignore

@@ -0,0 +1,10 @@
+node_modules
+dist
+dist-extension
+.DS_Store
+*.local
+.vscode
+.idea
+*.log
+.env
+.air

.prettierrc.json

@@ -0,0 +1,7 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "tabWidth": 2
+}

CLAUDE.md

@@ -0,0 +1,76 @@
+# NoM WebWallet
+
+A cryptocurrency wallet for the Zenon Network, supporting both browser extension (Chrome/Edge, Manifest V3) and standalone web application modes.
+
+## Tech Stack
+
+- **Framework**: Vue 3 (Composition API)
+- **Build Tool**: Vite
+- **Styling**: Tailwind CSS 4 + shadcn-vue + Reka UI
+- **Language**: TypeScript (strict mode)
+- **Blockchain**: znn-typescript-sdk (Zenon Network)
+- **WalletConnect**: v2 for dApp connections
+- **Package Manager**: npm workspaces (monorepo)
+
+## Project Structure
+
+```
+nom-webwallet/
+├── src/
+│   ├── core/               # Business logic services
+│   │   ├── composables/    # Vue 3 reactive wrappers around services
+│   │   └── storage/        # Storage adapters (localStorage / chrome.storage)
+│   ├── components/         # Vue components
+│   ├── pages/              # Route components
+│   ├── types/              # TypeScript type definitions
+│   ├── main.ts             # App entry point
+│   └── background.ts       # Extension service worker
+├── packages/
+│   └── ui/                 # Shared shadcn-vue component library
+├── vite.config.web.ts      # Web app build config
+├── vite.config.extension.ts# Extension build config
+└── manifest.json           # Chrome extension manifest (MV3)
+```
+
+## Commands
+
+```bash
+npm install               # Install all workspaces
+npm run dev               # Web dev server (localhost:5173)
+npm run dev:extension     # Extension watch build
+npm run build             # Web production build → dist/
+npm run build:extension   # Extension production build → dist-extension/
+npm run lint              # ESLint (TypeScript + Vue)
+npm run format            # Prettier
+```
+
+## Architecture
+
+**Service Layer** (`src/core/`): All blockchain and wallet business logic lives in service classes (`wallet-service.ts`, `transaction-service.ts`, `account-service.ts`, etc.).
+
+**Composables** (`src/core/composables/`): Vue 3 composables wrap services for reactive state in components. Each service has a corresponding composable (`useWallet`, `useAccount`, `useTransaction`, etc.).
+
+**Storage Abstraction**: `StorageAdapter` interface with `LocalStorageAdapter` (web) and `ChromeStorageAdapter` (extension). Adapter is selected at startup in `main.ts`.
+
+**Session Management**: Unlocked wallets are held in memory only via `SessionManager` with a 30-minute auto-timeout. No private keys are persisted unencrypted.
+
+**Singletons**: `ZenonService` (blockchain connection) and `SessionManager` use `getInstance()` pattern.
+
+## Routes
+
+- `/` — Home dashboard
+- `/setup` — Wallet creation/import
+- `/send` — Send transaction
+- `/receive` — Receive address
+- `/token/:tokenStandard` — Token details
+
+## Code Style
+
+- No semicolons, single quotes, 100-char print width (see `.prettierrc.json`)
+- Strict TypeScript mode
+- PascalCase for Vue components, camelCase for services/functions
+- No Pinia/Vuex — state managed via composables only
+
+## Testing
+
+No automated test suite. TypeScript strict mode is the primary correctness check.