Add files via upload

Author: BitcoinErrorLog

README.md

@@ -0,0 +1,66 @@
+# Blockspace Conservation Toy
+
+Interactive web UI for experimenting with the Law of Conservation of Blockspace from
+`cred10.tex`. It exposes the key variables—efficiency coefficient rho, usable window `W'`, and
+per-user enforcement weight `e`—and visualizes the lower bound on simultaneous unilateral exits.
+
+## Features
+
+- Preset scenarios mirroring the paper (Retail Panic, Quiet Exit, Mixed Economy, Institutional,
+  Ark).
+- Direct manipulation of `rho`, `W'`, `e`, and coinbase overhead with immediate capacity feedback.
+- Table + sparkline showing how `N_max` scales with the window length at the chosen efficiency.
+- Operational notes that document how to estimate `rho`, how HTLC jamming inflates `e`, and why the
+  model is a static bound.
+- Shareable URLs and JSON export for saving/sharing scenarios.
+- Deterministic math helpers with Vitest coverage (Lightning per-state weights, Ark lower bounds,
+  security zone classifier).
+
+## Getting Started
+
+```bash
+# install once
+npm install
+
+# run locally
+npm run dev
+
+# unit tests (math + scenarios)
+npm run test
+
+# production build
+npm run build
+npm run preview  # optional local preview of /dist
+```
+
+Tests live in `src/lib/*.test.ts` and exercise the published figures (e.g., the 83,060 and 94,926
+Lightning bounds). The Vitest environment is configured in `vite.config.ts`.
+
+## Project Layout
+
+```
+src/
+  App.tsx            # main UI
+  App.css            # glassmorphism styling + responsive grid
+  lib/math.ts        # reusable equations: C_max, rho losses, N_max, zone classifier
+  lib/scenarios.ts   # preset catalog, query-string serializer, blended cohorts
+```
+
+## Estimating rho (field method)
+
+1. Choose a window `[b, b+W')` and compute `C_max = (4_000_000 - w_cb) * W'`.
+2. For each block or mempool diff in the window, sum the serialized weight of:
+   - replaced transactions (RBF evictions)
+   - orphaned blocks' unique weight
+   - transactions stranded as dust
+   - policy-filtered packages (ancestor/descendant and package limits)
+3. Let `rho = 1 - (losses / C_max)`. The congestion sample from 5 Oct 2025 had total losses
+   `160,200,000` wu over `W' = 137` blocks, so `rho ≈ 0.71`.
+
+Lower `rho` collapses `N_max` linearly; HTLC jamming also raises per-user `e`, so the interactive
+toy should be interpreted as an optimistic (necessary) bound.
+
+## Sharing & Export
+
+- **Share current setup** copies a permalink with the full scenario embedded in the query string.
+- **Download JSON** saves `{ scenario, metrics }` for reproducibility or offline calculations.

eslint.config.js

@@ -0,0 +1,23 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+  },
+])

package.json

@@ -0,0 +1,34 @@
+{
+  "name": "web-toy",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "test": "vitest",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "@vitest/coverage-v8": "^4.0.13",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^16.5.0",
+    "jsdom": "^27.2.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "vite": "^7.2.4",
+    "vitest": "^4.0.13"
+  }
+}