diff --git a/.gitignore b/.gitignore
index 00c88a671..9722eeec3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,10 +1,3 @@
-<<<<<<< HEAD
-# Compiler files
-cache/
-out/
-
-# Ignores development broadcast logs
-=======
 # =============================================================================
 # Environment Variables - CRITICAL: Never commit .env files
 # =============================================================================
@@ -26,23 +19,14 @@ contracts/foundry-out/
 contracts/out/
 
 # Development broadcast logs (keep broadcast structure, ignore specific chains)
->>>>>>> 8b13a35cb03fb14cdb9f34a7b7b429971bb197b8
 !/broadcast
 /broadcast/*/31337/
 /broadcast/**/dry-run/
 
-<<<<<<< HEAD
-# Docs
-docs/
-
-# Dotenv file
-.env
-=======
 # =============================================================================
 # Hardhat Build Artifacts (if used)
 # =============================================================================
 artifacts/
-cache/
 typechain/
 typechain-types/
 
@@ -141,4 +125,3 @@ agents/
 *.temp
 .cache/
 .temp/
->>>>>>> 8b13a35cb03fb14cdb9f34a7b7b429971bb197b8
diff --git a/README.md b/README.md
index 8e03d8083..952c2ca8a 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,54 @@
 # Hook Bazaar Monorepo
 
+<div align="center">
+
+  <img src="https://img.shields.io/badge/Solidity-363636?style=for-the-badge&logo=solidity&logoColor=white" alt="Solidity"/>
+  <img src="https://img.shields.io/badge/Ethereum-3C3C3D?style=for-the-badge&logo=ethereum&logoColor=white" alt="Ethereum"/>
+  <img src="https://img.shields.io/badge/Uniswap-FF007A?style=for-the-badge&logo=uniswap&logoColor=white" alt="Uniswap"/>
+  <img src="https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript"/>
+  <img src="https://img.shields.io/badge/React-61DAFB?style=for-the-badge&logo=react&logoColor=black" alt="React"/>
+  <img src="https://img.shields.io/badge/Vite-646CFF?style=for-the-badge&logo=vite&logoColor=white" alt="Vite"/>
+  <img src="https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=for-the-badge&logo=tailwind-css&logoColor=white" alt="Tailwind CSS"/>
+  <img src="https://img.shields.io/badge/Foundry-000000?style=for-the-badge&logo=foundry&logoColor=white" alt="Foundry"/>
+  <img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js"/>
+  <img src="https://img.shields.io/badge/PostgreSQL-4169E1?style=for-the-badge&logo=postgresql&logoColor=white" alt="PostgreSQL"/>
+  <img src="https://img.shields.io/badge/Subsquid-000000?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2Zz48L3N2Zz4=&logoColor=white" alt="Subsquid"/>
+
+</div>
+
+<p align="center">
+  <img src="client2/src/assets/d9960bdb814135603341883999ea9dc547d831b8.png" alt="Description" width="300"/>
+</p>
+
+
+
+## Table of Contents
+- [Hook Bazaar Monorepo](#Hook Bazaar Monorepo)
+  - [Table of Contents](#table-of-contents)
+  - [Demo](#demo)
+  - [Problem Description](#problem-description)
+  - [Solution Overview](#solution-overview)
+  - [Arquitecture](#arquitecture)
+  - [Setup](#setup)
+    - [Build](#build)
+    - [Test](#test)
+    - [Deploy](#deploy)
+  - [References](#references)
+
+
+# Setup
+
 Minimal setup to run the frontend and indexer locally.
 
 ## Prerequisites
 
 - Node.js v18+
 - Docker (for indexer PostgreSQL)
+- Foundry
 
 ## Quick Start
 
+
 ### 1. Install Dependencies
 
 ```bash
@@ -28,51 +68,8 @@ Frontend runs on: **http://localhost:3000**
 
 ### 3. Indexer
 
-#### Setup (first time only)
-
-1. Set RPC endpoint in root `.env`:
-   ```bash
-   RPC_UNI_TESTNET_HTTP=https://your-rpc-endpoint-here
-   ```
-   (The indexer reads from the root `.env` file)
-
-2. Start PostgreSQL:
-   ```bash
-   npm run indexer:db:up
-   ```
-
-3. Build and migrate:
-   ```bash
-   npm run indexer:build
-   npm run indexer:migration
-   ```
-
-#### Run Indexer
-
-```bash
-npm run indexer
-```
-
-Indexer runs on: **PostgreSQL port 5432**
-
-(Optional) GraphQL server on port 4350:
-```bash
-npm run indexer:graphql
-```
-**Note:** Requires `@subsquid/openreader` package (install with `npm install`)
-
-## Available Commands
-
-### Frontend
-- `npm run dev` - Start Vite dev server (port 3000)
-- `npm run build` - Build for production
-
-### Indexer
-- `npm run indexer:build` - Build TypeScript
-- `npm run indexer` - Run indexer processor
-- `npm run indexer:graphql` - Start GraphQL server (port 4350)
-
-### Contracts
+### 4. Contracts
 - `forge build` - Compile contracts
 - `forge test` - Run tests
 
+
diff --git a/client2/docs/protocol-admin-management-spec.md b/client2/docs/protocol-admin-management-spec.md
new file mode 100644
index 000000000..835fda33c
--- /dev/null
+++ b/client2/docs/protocol-admin-management-spec.md
@@ -0,0 +1,284 @@
+# Protocol Admin Management Page - Frontend Specification
+
+## Overview
+
+This specification details the Protocol Admin Management Page, a comprehensive interface for protocol administrators to manage their protocols through the `IProtocolAdminManager` and `IProtocolAdminClient` smart contract interfaces.
+
+## Purpose
+
+Protocol administrators need a dedicated interface to:
+1. View and manage protocol details
+2. Create new pools for their protocol
+3. Set protocol-wide and pool-specific revenue configurations
+4. Delegate pool creator roles
+5. Manage protocol metadata (URIs)
+
+## Contract Interfaces
+
+### IProtocolAdminManager Functions (All exposed)
+
+| Function | Parameters | Returns | Description |
+|----------|------------|---------|-------------|
+| `isCreator(address)` | `_account: address` | `bool` | Check if address is protocol creator |
+| `setPool(PoolId)` | `_poolId: PoolId` | `void` | Set pool (called through admin panel) |
+| `getPools()` | - | `PoolId[]` | Get all pools for protocol |
+| `delegatePoolCreatorRole(address)` | `_account: address` | `void` | Delegate pool creation rights |
+| `isPoolCreator(address)` | `_account: address` | `bool` | Check if address can create pools |
+| `protocolId()` | - | `uint256` | Get protocol token ID |
+| `protocolName()` | - | `string` | Get protocol name |
+| `setURI(URI_TYPE, string)` | `_uriType: enum, _uri: string` | `void` | Set protocol URI metadata |
+| `getURI(URI_TYPE)` | `_uriType: enum` | `string` | Get protocol URI by type |
+
+### URI_TYPE Enum
+- `ZORA` (0) - Zora NFT metadata URI
+- `WEBSITE` (1) - Protocol website
+- `X` (2) - X/Twitter handle
+- `FARCASTER` (3) - Farcaster handle
+
+### IProtocolAdminClient Functions (Selective exposure)
+
+| Function | Parameters | Returns | Description | Exposed |
+|----------|------------|---------|-------------|---------|
+| `create_pool` | `protocolId: uint256, _encoded_pool_key: bytes, initialSqrtPrice: uint160` | `(PoolId, int24)` | Create new pool | Yes |
+| `setProtocolRevenue` | `protocolId: uint256` | `uint256` | Set protocol revenue | Yes |
+| `setPoolRevenue` | `protocolId: uint256, poolId: PoolId` | `uint256` | Set pool revenue | Yes |
+| `getProtocols` | - | `uint256[]` | Get user's protocols | No |
+| `getProtocolRevenue` | `protocolId: uint256` | `uint256` | Get protocol revenue | No (view only) |
+| `getPoolRevenue` | `protocolId: uint256, poolId: PoolId` | `uint256` | Get pool revenue | No (view only) |
+
+## Page Architecture
+
+### Route
+`/ProtocolDashboard/protocol/:protocolId/admin`
+
+### URL Parameters
+- `protocolId`: The protocol token ID from the contract
+
+### Navigation
+- Access via "View Details" button on Protocol Designer Dashboard
+- Back navigation to Protocol Designer Dashboard
+
+## Component Structure
+
+```
+ProtocolAdminPage/
+├── ProtocolAdminPage.tsx      # Main page orchestrator
+├── ProtocolHeader.tsx         # Protocol info header
+├── ManagerSection.tsx         # IProtocolAdminManager functions
+│   ├── PoolsTable.tsx         # Display pools with getPools()
+│   ├── DelegateRoleForm.tsx   # delegatePoolCreatorRole()
+│   └── URIManager.tsx         # setURI() and getURI()
+├── ClientSection.tsx          # IProtocolAdminClient functions
+│   ├── CreatePoolForm.tsx     # create_pool()
+│   ├── SetProtocolRevenueForm.tsx  # setProtocolRevenue()
+│   └── SetPoolRevenueForm.tsx      # setPoolRevenue()
+└── index.ts                   # Exports
+```
+
+## UI Sections
+
+### 1. Protocol Header
+- Protocol Name (from `protocolName()`)
+- Protocol ID (from `protocolId()`)
+- Creator verification badge (from `isCreator()`)
+- Chain information
+
+### 2. Protocol Admin Manager Section
+
+#### 2.1 Pools Overview
+- Table displaying all pools from `getPools()`
+- Columns: Pool ID, Status, Actions
+
+#### 2.2 Role Management
+- Form to delegate pool creator role via `delegatePoolCreatorRole()`
+- Check role status via `isPoolCreator()`
+- Input: Ethereum address
+
+#### 2.3 URI Management
+- Forms to set/update protocol URIs via `setURI()`
+- Display current URIs via `getURI()`
+- URI types: Website, X/Twitter, Farcaster, Zora
+
+### 3. Protocol Admin Client Section
+
+#### 3.1 Create Pool Form
+**Function:** `create_pool(uint256 protocolId, bytes _encoded_pool_key, uint160 initialSqrtPrice)`
+
+**Form Fields:**
+| Field | Type | Description | Validation |
+|-------|------|-------------|------------|
+| Token 0 Address | `address` | First token in pair | Valid checksum address |
+| Token 1 Address | `address` | Second token in pair | Valid checksum address |
+| Fee | `uint24` | Pool fee in bps | 100, 500, 3000, or 10000 |
+| Tick Spacing | `int24` | Price tick spacing | Positive integer |
+| Hook Address | `address` | Hook contract address | Valid address or zero |
+| Initial Price | `uint160` | sqrtPriceX96 format | Positive number |
+
+**PoolKey Structure (for encoding):**
+```typescript
+interface PoolKey {
+  currency0: Address;
+  currency1: Address;
+  fee: number;
+  tickSpacing: number;
+  hooks: Address;
+}
+```
+
+#### 3.2 Set Protocol Revenue Form
+**Function:** `setProtocolRevenue(uint256 protocolId)`
+
+**Form Fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| Revenue Amount | `uint256` | Revenue in wei |
+
+#### 3.3 Set Pool Revenue Form
+**Function:** `setPoolRevenue(uint256 protocolId, PoolId poolId)`
+
+**Form Fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| Pool ID | `PoolId` | Select from available pools |
+| Revenue Amount | `uint256` | Revenue in wei |
+
+## State Management
+
+### React Hooks Required
+- `useProtocolAdminManager` - Interact with IProtocolAdminManager
+- `useProtocolAdminClient` - Interact with IProtocolAdminClient (existing, extend if needed)
+
+### Wagmi Hooks
+- `useReadContract` - Read contract state
+- `useWriteContract` - Execute transactions
+- `useWaitForTransactionReceipt` - Track transaction status
+
+## TypeScript Types
+
+```typescript
+// URI Types enum matching contract
+export enum URIType {
+  ZORA = 0,
+  WEBSITE = 1,
+  X = 2,
+  FARCASTER = 3,
+}
+
+// Pool Key structure for encoding
+export interface PoolKey {
+  currency0: Address;
+  currency1: Address;
+  fee: number;
+  tickSpacing: number;
+  hooks: Address;
+}
+
+// Create Pool parameters
+export interface CreatePoolParams {
+  protocolId: bigint;
+  poolKey: PoolKey;
+  initialSqrtPrice: bigint;
+}
+
+// Revenue parameters
+export interface SetRevenueParams {
+  protocolId: bigint;
+  poolId?: string; // For pool-specific revenue
+  amount: bigint;
+}
+
+// Protocol Admin state
+export interface ProtocolAdminState {
+  protocolId: bigint | null;
+  protocolName: string;
+  isCreator: boolean;
+  pools: string[];
+  uris: Record<URIType, string>;
+}
+```
+
+## Transaction Flow
+
+### Create Pool Flow
+1. User fills pool key form
+2. Frontend encodes PoolKey to bytes using `abi.encode`
+3. Call `create_pool(protocolId, encodedPoolKey, initialSqrtPrice)`
+4. Wait for transaction confirmation
+5. Display pool ID and initial tick from return values
+6. Refresh pools list
+
+### Set Revenue Flow
+1. User enters revenue amount
+2. Convert to wei if needed
+3. Call `setProtocolRevenue()` or `setPoolRevenue()`
+4. Wait for confirmation
+5. Update displayed revenue
+
+## Error Handling
+
+| Error | Contract | User Message |
+|-------|----------|--------------|
+| `ProtocolAdminManagerCallerIsNotCreator` | Manager | "You are not the protocol creator" |
+| `ProtocolAdminClientUnauthorizedCaller` | Client | "You are not authorized to create pools" |
+| `ProtocolAdminManagerNotClone` | Manager | "Invalid protocol instance" |
+| `ProtocolAdminManagerInvalidContextCall` | Manager | "Invalid call context" |
+
+## Responsive Design
+
+- Desktop: Full 3-column layout
+- Tablet: 2-column layout with stacked sections
+- Mobile: Single column with collapsible sections
+
+## Accessibility
+
+- Form labels with proper `for` attributes
+- ARIA labels on action buttons
+- Keyboard navigation support
+- Screen reader friendly error messages
+- Focus management after transactions
+
+## Mock Data (Development)
+
+```typescript
+const mockProtocolAdmin = {
+  protocolId: 1n,
+  protocolName: 'My DeFi Protocol',
+  isCreator: true,
+  pools: [
+    '0x0000000000000000000000000000000000000000000000000000000000000001',
+    '0x0000000000000000000000000000000000000000000000000000000000000002',
+  ],
+  uris: {
+    [URIType.WEBSITE]: 'https://myprotocol.io',
+    [URIType.X]: '@myprotocol',
+    [URIType.FARCASTER]: 'myprotocol.eth',
+    [URIType.ZORA]: 'ipfs://...',
+  },
+};
+```
+
+## Implementation Priority
+
+1. **Phase 1 - Core Functions (Required)**
+   - ProtocolAdminPage layout
+   - Create Pool form
+   - Set Protocol Revenue form
+   - Set Pool Revenue form
+
+2. **Phase 2 - Manager Functions**
+   - Pools table display
+   - Delegate role form
+   - URI management
+
+3. **Phase 3 - Polish**
+   - Transaction status toasts
+   - Loading states
+   - Error boundaries
+
+## Dependencies
+
+- React Router v6 (navigation)
+- wagmi v2 (contract interactions)
+- viem (encoding/decoding)
+- lucide-react (icons)
+- Existing design system components
diff --git a/client2/package-lock.json b/client2/package-lock.json
new file mode 100644
index 000000000..90fd62a42
--- /dev/null
+++ b/client2/package-lock.json
@@ -0,0 +1,139 @@
+{
+  "name": "client2",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "dependencies": {
+        "katex": "^0.16.27",
+        "react-katex": "^3.1.0"
+      },
+      "devDependencies": {
+        "@types/katex": "^0.16.7",
+        "@types/react-katex": "^3.0.4"
+      }
+    },
+    "node_modules/@types/katex": {
+      "version": "0.16.7",
+      "resolved": "https://registry.npmjs.org/@types/katex/-/katex-0.16.7.tgz",
+      "integrity": "sha512-HMwFiRujE5PjrgwHQ25+bsLJgowjGjm5Z8FVSf0N6PwgJrwxH0QxzHYDcKsTfV3wva0vzrpqMTJS2jXPr5BMEQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/react": {
+      "version": "19.2.7",
+      "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.7.tgz",
+      "integrity": "sha512-MWtvHrGZLFttgeEj28VXHxpmwYbor/ATPYbBfSFZEIRK0ecCFLl2Qo55z52Hss+UV9CRN7trSeq1zbgx7YDWWg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "csstype": "^3.2.2"
+      }
+    },
+    "node_modules/@types/react-katex": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/@types/react-katex/-/react-katex-3.0.4.tgz",
+      "integrity": "sha512-aLkykKzSKLpXI6REJ3uClao6P47HAFfR1gcHOZwDeTuALsyjgMhz+oynLV4gX0kiJVnvHrBKF/TLXqyNTpHDUg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/react": "*"
+      }
+    },
+    "node_modules/csstype": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz",
+      "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/js-tokens": {
+      "version": "4.0.0",
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/katex": {
+      "version": "0.16.27",
+      "resolved": "https://registry.npmjs.org/katex/-/katex-0.16.27.tgz",
+      "integrity": "sha512-aeQoDkuRWSqQN6nSvVCEFvfXdqo1OQiCmmW1kc9xSdjutPv7BGO7pqY9sQRJpMOGrEdfDgF2TfRXe5eUAD2Waw==",
+      "funding": [
+        "https://opencollective.com/katex",
+        "https://github.com/sponsors/katex"
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "commander": "^8.3.0"
+      },
+      "bin": {
+        "katex": "cli.js"
+      }
+    },
+    "node_modules/katex/node_modules/commander": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz",
+      "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/loose-envify": {
+      "version": "1.4.0",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "js-tokens": "^3.0.0 || ^4.0.0"
+      },
+      "bin": {
+        "loose-envify": "cli.js"
+      }
+    },
+    "node_modules/object-assign": {
+      "version": "4.1.1",
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/prop-types": {
+      "version": "15.8.1",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "loose-envify": "^1.4.0",
+        "object-assign": "^4.1.1",
+        "react-is": "^16.13.1"
+      }
+    },
+    "node_modules/prop-types/node_modules/react-is": {
+      "version": "16.13.1",
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/react": {
+      "version": "18.3.1",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "loose-envify": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/react-katex": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/react-katex/-/react-katex-3.1.0.tgz",
+      "integrity": "sha512-At9uLOkC75gwn2N+ZXc5HD8TlATsB+3Hkp9OGs6uA8tM3dwZ3Wljn74Bk3JyHFPgSnesY/EMrIAB1WJwqZqejA==",
+      "license": "MIT",
+      "dependencies": {
+        "katex": "^0.16.0"
+      },
+      "peerDependencies": {
+        "prop-types": "^15.8.1",
+        "react": ">=15.3.2 <20"
+      }
+    }
+  }
+}
diff --git a/client2/package.json b/client2/package.json
new file mode 100644
index 000000000..1f7443caa
--- /dev/null
+++ b/client2/package.json
@@ -0,0 +1,10 @@
+{
+  "dependencies": {
+    "katex": "^0.16.27",
+    "react-katex": "^3.1.0"
+  },
+  "devDependencies": {
+    "@types/katex": "^0.16.7",
+    "@types/react-katex": "^3.0.4"
+  }
+}
diff --git a/client2/src/App.tsx b/client2/src/App.tsx
index ca8cc3611..eb483463b 100644
--- a/client2/src/App.tsx
+++ b/client2/src/App.tsx
@@ -5,8 +5,11 @@ import ContactPage from './components/ContactPage';
 import HookDeveloperDashboard from './components/HookDeveloperDashboard';
 import ProtocolDesignerDashboard from './components/ProtocolDesignerDashboard';
 import CreateProtocolPage from './components/protocol/CreateProtocolPage';
+import { ProtocolAdminPage } from './components/protocol/admin';
 import IntegratorPortal from './components/IntegratorPortal';
 import SkipLink from './components/common/SkipLink';
+import { CreateHookPage, CodeVerificationPage } from './components/hook';
+import { HookMarketPage } from './components/market';
 
 export default function App() {
   return (
@@ -19,8 +22,12 @@ export default function App() {
           <Route path="/about" element={<AboutPage onNavigate={() => {}} />} />
           <Route path="/contact" element={<ContactPage onNavigate={() => {}} />} />
           <Route path="/hook-developer" element={<HookDeveloperDashboard onNavigate={() => {}} />} />
+          <Route path="/hook-developer/create" element={<CreateHookPage />} />
+          <Route path="/hook-developer/verify" element={<CodeVerificationPage />} />
           <Route path="/ProtocolDashboard" element={<ProtocolDesignerDashboard onNavigate={() => {}} />} />
           <Route path="/ProtocolDashboard/createProtocol" element={<CreateProtocolPage />} />
+          <Route path="/ProtocolDashboard/hook-market" element={<HookMarketPage />} />
+          <Route path="/ProtocolDashboard/protocol/:protocolId/admin" element={<ProtocolAdminPage />} />
           <Route path="/integrator" element={<IntegratorPortal onNavigate={() => {}} />} />
           <Route path="*" element={<Navigate to="/" replace />} />
         </Routes>
diff --git a/client2/src/assets/d9960bdb814135603341883999ea9dc547d831b8.png b/client2/src/assets/d9960bdb814135603341883999ea9dc547d831b8.png
index c71293e14..51e89b382 100644
Binary files a/client2/src/assets/d9960bdb814135603341883999ea9dc547d831b8.png and b/client2/src/assets/d9960bdb814135603341883999ea9dc547d831b8.png differ
diff --git a/client2/src/components/HookDeveloperDashboard.tsx b/client2/src/components/HookDeveloperDashboard.tsx
index 3bc2c4769..042a3f2dc 100644
--- a/client2/src/components/HookDeveloperDashboard.tsx
+++ b/client2/src/components/HookDeveloperDashboard.tsx
@@ -1,4 +1,5 @@
 import { ArrowLeft, Code, DollarSign, Package, Plus, TrendingUp } from 'lucide-react';
+import { useNavigate } from 'react-router-dom';
 import Navigation from './Navigation';
 import Footer from './Footer';
 
@@ -7,6 +8,12 @@ interface HookDeveloperDashboardProps {
 }
 
 export default function HookDeveloperDashboard({ onNavigate }: HookDeveloperDashboardProps) {
+  const navigate = useNavigate();
+
+  const handleCreateHook = () => {
+    navigate('/hook-developer/create');
+  };
+
   const stats = [
     { icon: Package, label: 'Total Hooks', value: '3', color: 'primary' },
     { icon: DollarSign, label: 'Total Revenue', value: '$12,450', color: 'secondary' },
@@ -95,6 +102,7 @@ export default function HookDeveloperDashboard({ onNavigate }: HookDeveloperDash
             </div>
 
             <button
+              onClick={handleCreateHook}
               className="angular-clip-button px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200 hover:-translate-y-1 hover:rotate-[-1deg] flex items-center gap-2"
               style={{
                 background: 'var(--color-primary)',
@@ -112,7 +120,7 @@ export default function HookDeveloperDashboard({ onNavigate }: HookDeveloperDash
               }}
             >
               <Plus size={20} />
-              Deploy New Hook
+              Create New Hook
             </button>
           </div>
         </div>
diff --git a/client2/src/components/ProtocolDesignerDashboard.tsx b/client2/src/components/ProtocolDesignerDashboard.tsx
index 41f8e9422..6947183b9 100644
--- a/client2/src/components/ProtocolDesignerDashboard.tsx
+++ b/client2/src/components/ProtocolDesignerDashboard.tsx
@@ -1,6 +1,6 @@
 import { useState, useEffect } from 'react';
 import { useNavigate, useLocation } from 'react-router-dom';
-import { ArrowLeft, DollarSign, Layers, Plus, TrendingUp } from 'lucide-react';
+import { ArrowLeft, DollarSign, Layers, Plus, Search, TrendingUp } from 'lucide-react';
 import Navigation from './Navigation';
 import Footer from './Footer';
 import CreateProtocolDialog from './protocol/CreateProtocolDialog';
@@ -126,8 +126,16 @@ export default function ProtocolDesignerDashboard({ onNavigate }: ProtocolDesign
   }, [location.state, address, protocols, navigate, location.pathname]);
 
   const handleViewDetails = (protocol: Protocol) => {
-    setSelectedProtocol(protocol);
-    setDetailsDialogOpen(true);
+    // Navigate to the Protocol Admin page with the protocol data
+    if (protocol.protocolId) {
+      navigate(`/ProtocolDashboard/protocol/${protocol.protocolId}/admin`, {
+        state: { protocol },
+      });
+    } else {
+      // Fallback to dialog for protocols without protocolId
+      setSelectedProtocol(protocol);
+      setDetailsDialogOpen(true);
+    }
   };
 
   const handleSaveProtocolDetails = (
@@ -195,33 +203,56 @@ export default function ProtocolDesignerDashboard({ onNavigate }: ProtocolDesign
               </p>
             </div>
 
-            <button
-              onClick={() => {
-                if (!address) {
-                  alert('Please connect your wallet first');
-                  return;
-                }
-                setCreateDialogOpen(true);
-              }}
-              className="angular-clip-button px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200 hover:-translate-y-1 hover:rotate-[-1deg] flex items-center gap-2"
-              style={{
-                background: 'var(--color-primary)',
-                color: 'var(--color-secondary)',
-                border: '2px solid var(--color-secondary)',
-                fontSize: 'var(--font-size-body-sm)',
-                fontWeight: 'var(--font-weight-bold)',
-                boxShadow: '0 0 0 transparent',
-              }}
-              onMouseEnter={(e) => {
-                e.currentTarget.style.boxShadow = 'var(--shadow-level-2)';
-              }}
-              onMouseLeave={(e) => {
-                e.currentTarget.style.boxShadow = '0 0 0 transparent';
-              }}
-            >
-              <Plus size={20} />
-              Create Protocol
-            </button>
+            <div className="flex gap-4">
+              <button
+                onClick={() => navigate('/ProtocolDashboard/hook-market')}
+                className="angular-clip-button px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200 hover:-translate-y-1 hover:rotate-[-1deg] flex items-center gap-2"
+                style={{
+                  background: 'var(--color-white)',
+                  color: 'var(--color-secondary)',
+                  border: '2px solid var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)',
+                  fontWeight: 'var(--font-weight-bold)',
+                  boxShadow: '0 0 0 transparent',
+                }}
+                onMouseEnter={(e) => {
+                  e.currentTarget.style.boxShadow = 'var(--shadow-level-2)';
+                }}
+                onMouseLeave={(e) => {
+                  e.currentTarget.style.boxShadow = '0 0 0 transparent';
+                }}
+              >
+                <Search size={20} />
+                Browse Hooks
+              </button>
+              <button
+                onClick={() => {
+                  if (!address) {
+                    alert('Please connect your wallet first');
+                    return;
+                  }
+                  setCreateDialogOpen(true);
+                }}
+                className="angular-clip-button px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200 hover:-translate-y-1 hover:rotate-[-1deg] flex items-center gap-2"
+                style={{
+                  background: 'var(--color-primary)',
+                  color: 'var(--color-secondary)',
+                  border: '2px solid var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)',
+                  fontWeight: 'var(--font-weight-bold)',
+                  boxShadow: '0 0 0 transparent',
+                }}
+                onMouseEnter={(e) => {
+                  e.currentTarget.style.boxShadow = 'var(--shadow-level-2)';
+                }}
+                onMouseLeave={(e) => {
+                  e.currentTarget.style.boxShadow = '0 0 0 transparent';
+                }}
+              >
+                <Plus size={20} />
+                Create Protocol
+              </button>
+            </div>
           </div>
         </div>
       </section>
diff --git a/client2/src/components/common/LatexRenderer.tsx b/client2/src/components/common/LatexRenderer.tsx
new file mode 100644
index 000000000..6ed0bc013
--- /dev/null
+++ b/client2/src/components/common/LatexRenderer.tsx
@@ -0,0 +1,136 @@
+import { useMemo } from 'react';
+import katex from 'katex';
+import 'katex/dist/katex.min.css';
+
+interface LatexRendererProps {
+  latex: string;
+  displayMode?: boolean;
+  className?: string;
+  style?: React.CSSProperties;
+}
+
+/**
+ * Renders LaTeX mathematical expressions using KaTeX
+ * Handles both inline ($...$) and display ($$...$$) math
+ */
+export default function LatexRenderer({
+  latex,
+  displayMode = false,
+  className = '',
+  style = {}
+}: LatexRendererProps) {
+  const renderedHtml = useMemo(() => {
+    try {
+      // Clean up the LaTeX string - handle common subscript/superscript patterns
+      let cleanLatex = latex;
+
+      // If it doesn't look like LaTeX, wrap simple subscripts
+      if (!latex.includes('\\') && !latex.includes('{')) {
+        // Convert simple patterns like L_k to L_{k}
+        cleanLatex = latex
+          .replace(/([A-Za-z])_([A-Za-z0-9])/g, '$1_{$2}')
+          .replace(/([A-Za-z])\^([A-Za-z0-9])/g, '$1^{$2}');
+      }
+
+      return katex.renderToString(cleanLatex, {
+        displayMode,
+        throwOnError: false,
+        strict: false,
+        trust: true,
+        macros: {
+          // Common macros for DeFi/AMM notation
+          '\\R': '\\mathbb{R}',
+          '\\N': '\\mathbb{N}',
+          '\\Z': '\\mathbb{Z}',
+        }
+      });
+    } catch (error) {
+      // Fallback to plain text if LaTeX parsing fails
+      return `<span class="latex-error">${latex}</span>`;
+    }
+  }, [latex, displayMode]);
+
+  return (
+    <span
+      className={`latex-rendered ${className}`}
+      style={style}
+      dangerouslySetInnerHTML={{ __html: renderedHtml }}
+    />
+  );
+}
+
+/**
+ * Parse and render a string that may contain mixed text and LaTeX
+ * Handles inline $...$ and display $$...$$ delimiters
+ */
+export function MixedLatexRenderer({
+  content,
+  className = '',
+  style = {}
+}: {
+  content: string;
+  className?: string;
+  style?: React.CSSProperties;
+}) {
+  const parts = useMemo(() => {
+    const result: { type: 'text' | 'latex' | 'displayLatex'; content: string }[] = [];
+
+    // Match $$...$$ (display) and $...$ (inline)
+    const regex = /(\$\$[\s\S]*?\$\$|\$[^$]+\$)/g;
+    let lastIndex = 0;
+    let match;
+
+    while ((match = regex.exec(content)) !== null) {
+      // Add text before this match
+      if (match.index > lastIndex) {
+        result.push({
+          type: 'text',
+          content: content.slice(lastIndex, match.index)
+        });
+      }
+
+      // Add the LaTeX part
+      const matched = match[0];
+      if (matched.startsWith('$$')) {
+        result.push({
+          type: 'displayLatex',
+          content: matched.slice(2, -2)
+        });
+      } else {
+        result.push({
+          type: 'latex',
+          content: matched.slice(1, -1)
+        });
+      }
+
+      lastIndex = regex.lastIndex;
+    }
+
+    // Add remaining text
+    if (lastIndex < content.length) {
+      result.push({
+        type: 'text',
+        content: content.slice(lastIndex)
+      });
+    }
+
+    return result;
+  }, [content]);
+
+  return (
+    <span className={className} style={style}>
+      {parts.map((part, index) => {
+        if (part.type === 'text') {
+          return <span key={index}>{part.content}</span>;
+        }
+        return (
+          <LatexRenderer
+            key={index}
+            latex={part.content}
+            displayMode={part.type === 'displayLatex'}
+          />
+        );
+      })}
+    </span>
+  );
+}
diff --git a/client2/src/components/hook/AVSVerificationResults.tsx b/client2/src/components/hook/AVSVerificationResults.tsx
new file mode 100644
index 000000000..dd62c7aff
--- /dev/null
+++ b/client2/src/components/hook/AVSVerificationResults.tsx
@@ -0,0 +1,547 @@
+import { useState } from 'react';
+import {
+  Shield,
+  CheckCircle,
+  AlertTriangle,
+  AlertCircle,
+  Info,
+  ChevronDown,
+  ChevronRight,
+  ExternalLink,
+  FileCode
+} from 'lucide-react';
+import type { AVSVerificationResult, AVSFinding, CompilationResult } from '../../types/hookSpec';
+
+interface AVSVerificationResultsProps {
+  compilationResult: CompilationResult;
+  avsResult: AVSVerificationResult;
+}
+
+export default function AVSVerificationResults({
+  compilationResult,
+  avsResult
+}: AVSVerificationResultsProps) {
+  const [expandedFindings, setExpandedFindings] = useState<Set<string>>(new Set());
+
+  const toggleFinding = (id: string) => {
+    setExpandedFindings(prev => {
+      const next = new Set(prev);
+      if (next.has(id)) {
+        next.delete(id);
+      } else {
+        next.add(id);
+      }
+      return next;
+    });
+  };
+
+  const getScoreColor = (score: number) => {
+    if (score >= 95) return 'var(--color-primary)';
+    if (score >= 80) return '#FFA500';  // Orange
+    return 'var(--color-accent)';
+  };
+
+  const getSeverityIcon = (severity: AVSFinding['severity']) => {
+    switch (severity) {
+      case 'critical':
+        return <AlertCircle size={16} style={{ color: 'var(--color-accent)' }} />;
+      case 'warning':
+        return <AlertTriangle size={16} style={{ color: '#FFA500' }} />;
+      case 'info':
+        return <Info size={16} style={{ color: 'var(--color-accent)' }} />;
+    }
+  };
+
+  const getSeverityBg = (severity: AVSFinding['severity']) => {
+    switch (severity) {
+      case 'critical':
+        return 'rgba(232, 90, 79, 0.1)';
+      case 'warning':
+        return 'rgba(255, 165, 0, 0.1)';
+      case 'info':
+        return 'rgba(100, 100, 100, 0.1)';
+    }
+  };
+
+  const criticalCount = avsResult.findings.filter(f => f.severity === 'critical').length;
+  const warningCount = avsResult.findings.filter(f => f.severity === 'warning').length;
+  const infoCount = avsResult.findings.filter(f => f.severity === 'info').length;
+
+  return (
+    <div
+      className="angular-clip"
+      style={{
+        background: 'var(--color-white)',
+        border: '2px solid var(--color-secondary)',
+        padding: 'var(--space-lg)'
+      }}
+    >
+      {/* Header */}
+      <div className="flex items-center gap-3 mb-6">
+        <div
+          className="angular-clip w-12 h-12 flex items-center justify-center"
+          style={{
+            background: avsResult.compliant ? 'var(--color-primary)' : 'var(--color-accent)',
+            border: '2px solid var(--color-secondary)'
+          }}
+        >
+          <Shield size={24} style={{ color: 'var(--color-secondary)' }} />
+        </div>
+        <div>
+          <h3
+            className="font-heading"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-h4)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            AVS Verification Results
+          </h3>
+          <p
+            className="font-body"
+            style={{
+              color: 'var(--color-black)',
+              fontSize: 'var(--font-size-body-sm)'
+            }}
+          >
+            Code compliance checked by staked operators
+          </p>
+        </div>
+      </div>
+
+      {/* Compilation Status */}
+      <div
+        className="angular-clip p-4 mb-4"
+        style={{
+          background: compilationResult.success ? 'rgba(255, 215, 0, 0.1)' : 'rgba(232, 90, 79, 0.1)',
+          border: `1px solid ${compilationResult.success ? 'var(--color-primary)' : 'var(--color-accent)'}`
+        }}
+      >
+        <div className="flex items-center gap-2 mb-2">
+          <FileCode size={18} style={{ color: compilationResult.success ? 'var(--color-primary)' : 'var(--color-accent)' }} />
+          <span
+            className="font-heading"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body-sm)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            Compilation {compilationResult.success ? 'Successful' : 'Failed'}
+          </span>
+        </div>
+        {compilationResult.success && (
+          <div className="grid grid-cols-2 gap-4 mt-3">
+            <div>
+              <span
+                className="font-heading block"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Bytecode Hash
+              </span>
+              <code
+                className="font-mono"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: '11px'
+                }}
+              >
+                {compilationResult.bytecodeHash?.slice(0, 18)}...
+              </code>
+            </div>
+            <div>
+              <span
+                className="font-heading block"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Deployed Bytecode Hash
+              </span>
+              <code
+                className="font-mono"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: '11px'
+                }}
+              >
+                {compilationResult.deployedBytecodeHash?.slice(0, 18)}...
+              </code>
+            </div>
+          </div>
+        )}
+      </div>
+
+      {/* Compliance Score */}
+      <div
+        className="angular-clip p-6 mb-4"
+        style={{
+          background: 'var(--color-marble-light)',
+          border: '2px solid var(--color-secondary)'
+        }}
+      >
+        <div className="flex items-center justify-between mb-4">
+          <span
+            className="font-heading"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            Compliance Score
+          </span>
+          <span
+            className="font-heading"
+            style={{
+              color: getScoreColor(avsResult.complianceScore),
+              fontSize: 'var(--font-size-h2)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            {avsResult.complianceScore.toFixed(1)}%
+          </span>
+        </div>
+
+        {/* Score Bar */}
+        <div
+          className="h-4 angular-clip overflow-hidden"
+          style={{
+            background: 'var(--color-white)',
+            border: '1px solid var(--color-accent)'
+          }}
+        >
+          <div
+            className="h-full transition-all duration-500"
+            style={{
+              width: `${avsResult.complianceScore}%`,
+              background: getScoreColor(avsResult.complianceScore)
+            }}
+          />
+        </div>
+
+        {/* Status Badge */}
+        <div className="mt-4 flex items-center gap-2">
+          {avsResult.compliant ? (
+            <>
+              <CheckCircle size={20} style={{ color: 'var(--color-primary)' }} />
+              <span
+                className="font-heading"
+                style={{
+                  color: 'var(--color-primary)',
+                  fontSize: 'var(--font-size-body-sm)',
+                  fontWeight: 'var(--font-weight-bold)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Compliant with Specification
+              </span>
+            </>
+          ) : (
+            <>
+              <AlertCircle size={20} style={{ color: 'var(--color-accent)' }} />
+              <span
+                className="font-heading"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-body-sm)',
+                  fontWeight: 'var(--font-weight-bold)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Non-Compliant (Review Findings)
+              </span>
+            </>
+          )}
+        </div>
+      </div>
+
+      {/* Attestation Info */}
+      <div
+        className="angular-clip p-4 mb-4"
+        style={{
+          background: 'var(--color-white)',
+          border: '1px solid var(--color-accent)'
+        }}
+      >
+        <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+          <div>
+            <span
+              className="font-heading block mb-1"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Attestation ID
+            </span>
+            <div className="flex items-center gap-2">
+              <code
+                className="font-mono"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-caption)'
+                }}
+              >
+                {avsResult.attestationId.slice(0, 20)}...
+              </code>
+              <a
+                href={`https://etherscan.io/tx/${avsResult.attestationTxHash}`}
+                target="_blank"
+                rel="noopener noreferrer"
+                className="transition-colors"
+                style={{ color: 'var(--color-primary)' }}
+              >
+                <ExternalLink size={14} />
+              </a>
+            </div>
+          </div>
+          <div>
+            <span
+              className="font-heading block mb-1"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Verified At
+            </span>
+            <span
+              className="font-body"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)'
+              }}
+            >
+              {new Date(avsResult.verificationTimestamp).toLocaleString()}
+            </span>
+          </div>
+        </div>
+      </div>
+
+      {/* Findings Summary */}
+      {avsResult.findings.length > 0 && (
+        <>
+          <div className="flex items-center gap-4 mb-4">
+            <span
+              className="font-heading"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body)',
+                fontWeight: 'var(--font-weight-bold)'
+              }}
+            >
+              Findings ({avsResult.findings.length})
+            </span>
+            {criticalCount > 0 && (
+              <span
+                className="angular-clip px-2 py-1 flex items-center gap-1"
+                style={{
+                  background: 'var(--color-accent)',
+                  color: 'var(--color-white)',
+                  fontSize: 'var(--font-size-caption)'
+                }}
+              >
+                <AlertCircle size={12} />
+                {criticalCount} Critical
+              </span>
+            )}
+            {warningCount > 0 && (
+              <span
+                className="angular-clip px-2 py-1 flex items-center gap-1"
+                style={{
+                  background: '#FFA500',
+                  color: 'var(--color-white)',
+                  fontSize: 'var(--font-size-caption)'
+                }}
+              >
+                <AlertTriangle size={12} />
+                {warningCount} Warning
+              </span>
+            )}
+            {infoCount > 0 && (
+              <span
+                className="angular-clip px-2 py-1 flex items-center gap-1"
+                style={{
+                  background: 'var(--color-accent)',
+                  color: 'var(--color-white)',
+                  fontSize: 'var(--font-size-caption)'
+                }}
+              >
+                <Info size={12} />
+                {infoCount} Info
+              </span>
+            )}
+          </div>
+
+          {/* Findings List */}
+          <div className="space-y-2">
+            {avsResult.findings.map((finding, index) => {
+              const findingId = `${finding.ruleId}-${index}`;
+              const isExpanded = expandedFindings.has(findingId);
+
+              return (
+                <div
+                  key={findingId}
+                  className="angular-clip overflow-hidden"
+                  style={{
+                    background: getSeverityBg(finding.severity),
+                    border: '1px solid var(--color-accent)'
+                  }}
+                >
+                  <button
+                    onClick={() => toggleFinding(findingId)}
+                    className="w-full p-3 flex items-center gap-3 text-left"
+                  >
+                    {isExpanded ? (
+                      <ChevronDown size={16} style={{ color: 'var(--color-secondary)' }} />
+                    ) : (
+                      <ChevronRight size={16} style={{ color: 'var(--color-secondary)' }} />
+                    )}
+                    {getSeverityIcon(finding.severity)}
+                    <div className="flex-1 min-w-0">
+                      <span
+                        className="font-heading"
+                        style={{
+                          color: 'var(--color-secondary)',
+                          fontSize: 'var(--font-size-body-sm)',
+                          fontWeight: 'var(--font-weight-bold)'
+                        }}
+                      >
+                        [{finding.ruleId}] {finding.ruleName}
+                      </span>
+                    </div>
+                    <span
+                      className="angular-clip px-2 py-1 font-heading flex-shrink-0"
+                      style={{
+                        background:
+                          finding.severity === 'critical'
+                            ? 'var(--color-accent)'
+                            : finding.severity === 'warning'
+                            ? '#FFA500'
+                            : 'var(--color-accent)',
+                        color: 'var(--color-white)',
+                        fontSize: '10px',
+                        textTransform: 'uppercase'
+                      }}
+                    >
+                      {finding.severity}
+                    </span>
+                  </button>
+
+                  {isExpanded && (
+                    <div
+                      className="p-4 pt-0"
+                      style={{ borderTop: '1px solid var(--color-accent)' }}
+                    >
+                      <p
+                        className="font-body mb-3"
+                        style={{
+                          color: 'var(--color-black)',
+                          fontSize: 'var(--font-size-body-sm)'
+                        }}
+                      >
+                        {finding.description}
+                      </p>
+
+                      {finding.codeLocation && (
+                        <div
+                          className="angular-clip p-2 mb-3"
+                          style={{
+                            background: 'var(--color-secondary)',
+                            color: 'var(--color-white)'
+                          }}
+                        >
+                          <span
+                            className="font-heading block mb-1"
+                            style={{
+                              fontSize: 'var(--font-size-caption)',
+                              color: 'var(--color-primary)'
+                            }}
+                          >
+                            Code Location
+                          </span>
+                          <code
+                            className="font-mono"
+                            style={{ fontSize: 'var(--font-size-caption)' }}
+                          >
+                            Lines {finding.codeLocation.startLine}-{finding.codeLocation.endLine}
+                            {finding.codeLocation.functionName && ` in ${finding.codeLocation.functionName}()`}
+                          </code>
+                        </div>
+                      )}
+
+                      {finding.specReference && (
+                        <div className="flex items-center gap-2">
+                          <span
+                            className="font-heading"
+                            style={{
+                              color: 'var(--color-accent)',
+                              fontSize: 'var(--font-size-caption)'
+                            }}
+                          >
+                            Spec Reference:
+                          </span>
+                          <span
+                            className="font-body"
+                            style={{
+                              color: 'var(--color-secondary)',
+                              fontSize: 'var(--font-size-caption)'
+                            }}
+                          >
+                            {finding.specReference}
+                          </span>
+                        </div>
+                      )}
+                    </div>
+                  )}
+                </div>
+              );
+            })}
+          </div>
+        </>
+      )}
+
+      {/* No Findings */}
+      {avsResult.findings.length === 0 && (
+        <div
+          className="angular-clip p-6 text-center"
+          style={{
+            background: 'rgba(255, 215, 0, 0.1)',
+            border: '1px solid var(--color-primary)'
+          }}
+        >
+          <CheckCircle size={32} style={{ color: 'var(--color-primary)', margin: '0 auto 12px' }} />
+          <span
+            className="font-heading block"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            No Issues Found
+          </span>
+          <p
+            className="font-body mt-1"
+            style={{
+              color: 'var(--color-accent)',
+              fontSize: 'var(--font-size-body-sm)'
+            }}
+          >
+            Your code fully complies with the HookSpec specification
+          </p>
+        </div>
+      )}
+    </div>
+  );
+}
diff --git a/client2/src/components/hook/CFHEDeploymentStatus.tsx b/client2/src/components/hook/CFHEDeploymentStatus.tsx
new file mode 100644
index 000000000..91295f03c
--- /dev/null
+++ b/client2/src/components/hook/CFHEDeploymentStatus.tsx
@@ -0,0 +1,270 @@
+import {
+  Lock,
+  CheckCircle,
+  ExternalLink,
+  Copy,
+  Shield,
+  Cpu,
+  Hash
+} from 'lucide-react';
+import type { CFHEDeploymentResult } from '../../types/hookSpec';
+
+interface CFHEDeploymentStatusProps {
+  cfheResult: CFHEDeploymentResult;
+}
+
+export default function CFHEDeploymentStatus({ cfheResult }: CFHEDeploymentStatusProps) {
+  const copyToClipboard = (text: string) => {
+    navigator.clipboard.writeText(text);
+  };
+
+  return (
+    <div
+      className="angular-clip"
+      style={{
+        background: 'var(--color-white)',
+        border: '2px solid var(--color-secondary)',
+        padding: 'var(--space-lg)'
+      }}
+    >
+      {/* Header */}
+      <div className="flex items-center gap-3 mb-6">
+        <div
+          className="angular-clip w-12 h-12 flex items-center justify-center"
+          style={{
+            background: 'var(--color-primary)',
+            border: '2px solid var(--color-secondary)'
+          }}
+        >
+          <Lock size={24} style={{ color: 'var(--color-secondary)' }} />
+        </div>
+        <div>
+          <h3
+            className="font-heading"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-h4)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            CFHE Deployment
+          </h3>
+          <p
+            className="font-body"
+            style={{
+              color: 'var(--color-black)',
+              fontSize: 'var(--font-size-body-sm)'
+            }}
+          >
+            Encrypted bytecode deployed to confidential FHE network
+          </p>
+        </div>
+      </div>
+
+      {/* Success Banner */}
+      <div
+        className="angular-clip p-4 mb-6 flex items-center gap-3"
+        style={{
+          background: 'rgba(255, 215, 0, 0.15)',
+          border: '2px solid var(--color-primary)'
+        }}
+      >
+        <CheckCircle size={24} style={{ color: 'var(--color-primary)' }} />
+        <div>
+          <span
+            className="font-heading"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            Deployment Successful
+          </span>
+          <p
+            className="font-body"
+            style={{
+              color: 'var(--color-accent)',
+              fontSize: 'var(--font-size-caption)'
+            }}
+          >
+            Your hook bytecode has been encrypted and deployed
+          </p>
+        </div>
+      </div>
+
+      {/* Deployment Details */}
+      <div className="space-y-4">
+        {/* Encrypted Contract Address */}
+        <div
+          className="angular-clip p-4"
+          style={{
+            background: 'var(--color-marble-light)',
+            border: '1px solid var(--color-accent)'
+          }}
+        >
+          <div className="flex items-center gap-2 mb-2">
+            <Shield size={16} style={{ color: 'var(--color-secondary)' }} />
+            <span
+              className="font-heading"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Encrypted Contract Address
+            </span>
+          </div>
+          <div className="flex items-center gap-2">
+            <code
+              className="font-mono flex-1 break-all"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)'
+              }}
+            >
+              {cfheResult.encryptedContractAddress}
+            </code>
+            <button
+              onClick={() => copyToClipboard(cfheResult.encryptedContractAddress)}
+              className="p-1 transition-colors"
+              style={{ color: 'var(--color-accent)' }}
+              title="Copy address"
+            >
+              <Copy size={16} />
+            </button>
+          </div>
+        </div>
+
+        {/* Transaction Hash */}
+        <div
+          className="angular-clip p-4"
+          style={{
+            background: 'var(--color-marble-light)',
+            border: '1px solid var(--color-accent)'
+          }}
+        >
+          <div className="flex items-center gap-2 mb-2">
+            <Hash size={16} style={{ color: 'var(--color-secondary)' }} />
+            <span
+              className="font-heading"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Deployment Transaction
+            </span>
+          </div>
+          <div className="flex items-center gap-2">
+            <code
+              className="font-mono flex-1 break-all"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-caption)'
+              }}
+            >
+              {cfheResult.deploymentTxHash}
+            </code>
+            <a
+              href={cfheResult.explorerUrl}
+              target="_blank"
+              rel="noopener noreferrer"
+              className="p-1 transition-colors"
+              style={{ color: 'var(--color-primary)' }}
+              title="View on Explorer"
+            >
+              <ExternalLink size={16} />
+            </a>
+          </div>
+        </div>
+
+        {/* Grid Info */}
+        <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+          {/* Encrypted Bytecode Hash */}
+          <div
+            className="angular-clip p-4"
+            style={{
+              background: 'var(--color-marble-light)',
+              border: '1px solid var(--color-accent)'
+            }}
+          >
+            <div className="flex items-center gap-2 mb-2">
+              <Cpu size={16} style={{ color: 'var(--color-secondary)' }} />
+              <span
+                className="font-heading"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Encrypted Bytecode Hash
+              </span>
+            </div>
+            <code
+              className="font-mono break-all"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: '11px'
+              }}
+            >
+              {cfheResult.encryptedBytecodeHash.slice(0, 22)}...
+            </code>
+          </div>
+
+          {/* Block Number */}
+          <div
+            className="angular-clip p-4"
+            style={{
+              background: 'var(--color-marble-light)',
+              border: '1px solid var(--color-accent)'
+            }}
+          >
+            <span
+              className="font-heading block mb-2"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Block Number
+            </span>
+            <span
+              className="font-mono"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body)',
+                fontWeight: 'var(--font-weight-bold)'
+              }}
+            >
+              #{cfheResult.blockNumber.toLocaleString()}
+            </span>
+          </div>
+        </div>
+      </div>
+
+      {/* View on Explorer Button */}
+      <a
+        href={cfheResult.explorerUrl}
+        target="_blank"
+        rel="noopener noreferrer"
+        className="angular-clip-button w-full mt-6 px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200 flex items-center justify-center gap-2"
+        style={{
+          background: 'var(--color-secondary)',
+          color: 'var(--color-primary)',
+          border: '2px solid var(--color-secondary)',
+          fontSize: 'var(--font-size-body-sm)',
+          fontWeight: 'var(--font-weight-bold)',
+          textDecoration: 'none'
+        }}
+      >
+        <ExternalLink size={18} />
+        View on CFHE Explorer
+      </a>
+    </div>
+  );
+}
diff --git a/client2/src/components/hook/CodeSubmissionFlow.tsx b/client2/src/components/hook/CodeSubmissionFlow.tsx
new file mode 100644
index 000000000..b3b2d1a76
--- /dev/null
+++ b/client2/src/components/hook/CodeSubmissionFlow.tsx
@@ -0,0 +1,843 @@
+import { useState, useCallback } from 'react';
+import {
+  Github,
+  Code,
+  Terminal,
+  AlertCircle,
+  Check,
+  GitBranch,
+  FileCode,
+  Settings,
+  ExternalLink,
+  Loader2
+} from 'lucide-react';
+import type {
+  SubmissionResult,
+  CodeVerificationResult
+} from '../../types/hookSpec';
+
+interface CodeSubmissionFlowProps {
+  licenseInfo: {
+    tokenId: number;
+    hookName: string;
+    hookVersion: string;
+    specIpfsCid: string;
+  };
+  submissionResult: SubmissionResult;
+  walletConnected: boolean;
+  walletAddress?: string;
+  onConnectWallet: () => void;
+  onSubmitCode: (params: {
+    repoUrl: string;
+    branch?: string;
+    contractPath?: string;
+    compilerVersion: string;
+    optimizerRuns: number;
+    verifyOnly: boolean;
+  }) => Promise<CodeVerificationResult>;
+}
+
+type SubmissionStep = 'input' | 'configure' | 'submitting' | 'complete';
+
+const COMPILER_VERSIONS = [
+  '0.8.26',
+  '0.8.25',
+  '0.8.24',
+  '0.8.23',
+  '0.8.22',
+  '0.8.21',
+  '0.8.20',
+  '0.8.19',
+];
+
+// GitHub URL validation regex
+const GITHUB_URL_REGEX = /^https?:\/\/(www\.)?github\.com\/[\w.-]+\/[\w.-]+\/?$/;
+
+export default function CodeSubmissionFlow({
+  licenseInfo,
+  submissionResult,
+  walletConnected,
+  walletAddress,
+  onConnectWallet,
+  onSubmitCode
+}: CodeSubmissionFlowProps) {
+  const [step, setStep] = useState<SubmissionStep>('input');
+  const [repoUrl, setRepoUrl] = useState<string>('');
+  const [branch, setBranch] = useState<string>('');
+  const [contractPath, setContractPath] = useState<string>('');
+  const [compilerVersion, setCompilerVersion] = useState<string>('0.8.26');
+  const [optimizerRuns, setOptimizerRuns] = useState<number>(200);
+  const [verifyOnly, setVerifyOnly] = useState<boolean>(false);
+  const [urlError, setUrlError] = useState<string | null>(null);
+  const [verificationResult, setVerificationResult] = useState<CodeVerificationResult | null>(null);
+  const [submissionError, setSubmissionError] = useState<string | null>(null);
+  const [isValidating, setIsValidating] = useState<boolean>(false);
+
+  const validateGitHubUrl = (url: string): boolean => {
+    return GITHUB_URL_REGEX.test(url.trim());
+  };
+
+  const handleUrlChange = (url: string) => {
+    setRepoUrl(url);
+    setUrlError(null);
+  };
+
+  const handleContinue = async () => {
+    if (!repoUrl.trim()) {
+      setUrlError('Please enter a GitHub repository URL');
+      return;
+    }
+
+    if (!validateGitHubUrl(repoUrl)) {
+      setUrlError('Invalid GitHub URL. Please use format: https://github.com/username/repo');
+      return;
+    }
+
+    setIsValidating(true);
+    // In production, this would validate the repo exists
+    await new Promise(resolve => setTimeout(resolve, 500));
+    setIsValidating(false);
+    setStep('configure');
+  };
+
+  const handleSubmit = useCallback(async () => {
+    if (!repoUrl) return;
+
+    setStep('submitting');
+    setSubmissionError(null);
+
+    try {
+      const result = await onSubmitCode({
+        repoUrl: repoUrl.trim(),
+        branch: branch.trim() || undefined,
+        contractPath: contractPath.trim() || undefined,
+        compilerVersion,
+        optimizerRuns,
+        verifyOnly
+      });
+
+      setVerificationResult(result);
+      setStep('complete');
+    } catch (error) {
+      setSubmissionError(error instanceof Error ? error.message : 'Submission failed');
+      setStep('configure');
+    }
+  }, [repoUrl, branch, contractPath, compilerVersion, optimizerRuns, verifyOnly, onSubmitCode]);
+
+  // Extract repo info from URL for display
+  const getRepoInfo = (url: string) => {
+    const match = url.match(/github\.com\/([\w.-]+)\/([\w.-]+)/);
+    if (match) {
+      return { owner: match[1], repo: match[2] };
+    }
+    return null;
+  };
+
+  const repoInfo = repoUrl ? getRepoInfo(repoUrl) : null;
+
+  return (
+    <div
+      className="angular-clip"
+      style={{
+        background: 'var(--color-white)',
+        border: '2px solid var(--color-secondary)',
+        padding: 'var(--space-lg)'
+      }}
+    >
+      {/* Header */}
+      <div className="mb-6">
+        <h3
+          className="font-heading mb-2 flex items-center gap-2"
+          style={{
+            color: 'var(--color-secondary)',
+            fontSize: 'var(--font-size-h4)',
+            fontWeight: 'var(--font-weight-bold)'
+          }}
+        >
+          <Code size={24} />
+          Submit Hook Code
+        </h3>
+        <p
+          className="font-body"
+          style={{
+            color: 'var(--color-black)',
+            fontSize: 'var(--font-size-body-sm)'
+          }}
+        >
+          Submit your GitHub repository for AVS verification and CFHE deployment
+        </p>
+      </div>
+
+      {/* License Info Banner */}
+      <div
+        className="angular-clip p-4 mb-6"
+        style={{
+          background: 'var(--color-marble-light)',
+          border: '1px solid var(--color-accent)'
+        }}
+      >
+        <div className="flex flex-wrap items-center gap-4">
+          <div>
+            <span
+              className="font-heading"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Hook License
+            </span>
+            <p
+              className="font-heading"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body)',
+                fontWeight: 'var(--font-weight-bold)'
+              }}
+            >
+              {licenseInfo.hookName} v{licenseInfo.hookVersion}
+            </p>
+          </div>
+          <div>
+            <span
+              className="font-heading"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Token ID
+            </span>
+            <p
+              className="font-mono"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)'
+              }}
+            >
+              #{licenseInfo.tokenId}
+            </p>
+          </div>
+          <div>
+            <span
+              className="font-heading"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              IPFS TX
+            </span>
+            <p
+              className="font-mono"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-caption)'
+              }}
+            >
+              {submissionResult.transactionHash.slice(0, 10)}...
+            </p>
+          </div>
+        </div>
+      </div>
+
+      {/* CLI Command Alternative */}
+      <div
+        className="angular-clip p-4 mb-6"
+        style={{
+          background: 'var(--color-secondary)',
+          border: '1px solid var(--color-secondary)'
+        }}
+      >
+        <div className="flex items-start gap-3">
+          <Terminal size={20} style={{ color: 'var(--color-primary)', flexShrink: 0, marginTop: 2 }} />
+          <div className="flex-1 min-w-0">
+            <span
+              className="font-heading mb-2 block"
+              style={{
+                color: 'var(--color-primary)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Or use CLI
+            </span>
+            <code
+              className="font-mono block p-2 angular-clip break-all"
+              style={{
+                background: 'rgba(0,0,0,0.3)',
+                color: 'var(--color-white)',
+                fontSize: 'var(--font-size-caption)'
+              }}
+            >
+              hook-bazaar submit-code --license {licenseInfo.tokenId} --repo https://github.com/your-repo
+            </code>
+          </div>
+        </div>
+      </div>
+
+      {/* Input Step */}
+      {step === 'input' && (
+        <div className="space-y-4">
+          {/* GitHub URL Input */}
+          <div>
+            <label
+              className="block font-heading mb-2"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)',
+                fontWeight: 'var(--font-weight-bold)'
+              }}
+            >
+              GitHub Repository URL
+            </label>
+            <div className="relative">
+              <div
+                className="absolute left-3 top-1/2 transform -translate-y-1/2"
+                style={{ color: 'var(--color-accent)' }}
+              >
+                <Github size={20} />
+              </div>
+              <input
+                type="url"
+                value={repoUrl}
+                onChange={e => handleUrlChange(e.target.value)}
+                placeholder="https://github.com/username/hook-implementation"
+                className="angular-clip w-full pl-12 pr-4 py-3 font-mono"
+                style={{
+                  background: 'var(--color-marble-light)',
+                  border: urlError ? '2px solid var(--color-accent)' : '2px solid var(--color-secondary)',
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              />
+            </div>
+            {urlError && (
+              <div className="flex items-center gap-2 mt-2">
+                <AlertCircle size={14} style={{ color: 'var(--color-accent)' }} />
+                <span
+                  className="font-body"
+                  style={{
+                    color: 'var(--color-accent)',
+                    fontSize: 'var(--font-size-caption)'
+                  }}
+                >
+                  {urlError}
+                </span>
+              </div>
+            )}
+          </div>
+
+          {/* Help Text */}
+          <div
+            className="angular-clip p-4"
+            style={{
+              background: 'rgba(255, 215, 0, 0.1)',
+              border: '1px solid var(--color-primary)'
+            }}
+          >
+            <p
+              className="font-body"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)'
+              }}
+            >
+              Your repository should contain a Uniswap V4 hook implementation.
+              The system will automatically detect hook contracts that extend <code className="font-mono">BaseHook</code>.
+            </p>
+            <ul
+              className="mt-3 space-y-1 font-body"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)'
+              }}
+            >
+              <li>- Supports Foundry and Hardhat projects</li>
+              <li>- Auto-detects main hook contract</li>
+              <li>- Verifies compliance with your HookSpec</li>
+            </ul>
+          </div>
+
+          {/* Continue Button */}
+          <button
+            onClick={handleContinue}
+            disabled={!repoUrl.trim() || isValidating}
+            className="angular-clip-button w-full px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200 flex items-center justify-center gap-2"
+            style={{
+              background: repoUrl.trim() && !isValidating ? 'var(--color-primary)' : 'var(--color-marble-light)',
+              color: repoUrl.trim() && !isValidating ? 'var(--color-secondary)' : 'var(--color-accent)',
+              border: '2px solid var(--color-secondary)',
+              fontSize: 'var(--font-size-body-sm)',
+              fontWeight: 'var(--font-weight-bold)',
+              cursor: repoUrl.trim() && !isValidating ? 'pointer' : 'not-allowed'
+            }}
+          >
+            {isValidating ? (
+              <>
+                <Loader2 size={18} className="animate-spin" />
+                Validating...
+              </>
+            ) : (
+              'Continue'
+            )}
+          </button>
+        </div>
+      )}
+
+      {/* Configure Step */}
+      {step === 'configure' && (
+        <div className="space-y-6">
+          {/* Repo Info */}
+          <div
+            className="angular-clip p-4 flex items-center gap-3"
+            style={{
+              background: 'var(--color-marble-light)',
+              border: '1px solid var(--color-primary)'
+            }}
+          >
+            <Github size={24} style={{ color: 'var(--color-primary)' }} />
+            <div className="flex-1">
+              <span
+                className="font-heading"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body)',
+                  fontWeight: 'var(--font-weight-bold)'
+                }}
+              >
+                {repoInfo ? `${repoInfo.owner}/${repoInfo.repo}` : repoUrl}
+              </span>
+              <a
+                href={repoUrl}
+                target="_blank"
+                rel="noopener noreferrer"
+                className="flex items-center gap-1 mt-1 transition-colors"
+                style={{ color: 'var(--color-primary)' }}
+              >
+                <span className="font-body" style={{ fontSize: 'var(--font-size-caption)' }}>
+                  View on GitHub
+                </span>
+                <ExternalLink size={12} />
+              </a>
+            </div>
+            <button
+              onClick={() => {
+                setStep('input');
+                setRepoUrl('');
+              }}
+              className="font-heading transition-colors"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)'
+              }}
+            >
+              Change
+            </button>
+          </div>
+
+          {/* Optional Settings */}
+          <div>
+            <div className="flex items-center gap-2 mb-4">
+              <GitBranch size={18} style={{ color: 'var(--color-secondary)' }} />
+              <span
+                className="font-heading"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body)',
+                  fontWeight: 'var(--font-weight-bold)'
+                }}
+              >
+                Repository Options
+              </span>
+              <span
+                className="font-body"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-caption)'
+                }}
+              >
+                (Optional)
+              </span>
+            </div>
+
+            <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+              <div>
+                <label
+                  className="block font-heading mb-2"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  Branch
+                </label>
+                <input
+                  type="text"
+                  value={branch}
+                  onChange={e => setBranch(e.target.value)}
+                  placeholder="main (default)"
+                  className="angular-clip w-full px-3 py-2 font-mono"
+                  style={{
+                    background: 'var(--color-marble-light)',
+                    border: '2px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-body-sm)'
+                  }}
+                />
+              </div>
+
+              <div>
+                <label
+                  className="block font-heading mb-2"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  Contract Path
+                </label>
+                <input
+                  type="text"
+                  value={contractPath}
+                  onChange={e => setContractPath(e.target.value)}
+                  placeholder="Auto-detect"
+                  className="angular-clip w-full px-3 py-2 font-mono"
+                  style={{
+                    background: 'var(--color-marble-light)',
+                    border: '2px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-body-sm)'
+                  }}
+                />
+                <span
+                  className="font-body block mt-1"
+                  style={{
+                    color: 'var(--color-accent)',
+                    fontSize: '10px'
+                  }}
+                >
+                  e.g., src/DynamicFeeHook.sol
+                </span>
+              </div>
+            </div>
+          </div>
+
+          {/* Compiler Settings */}
+          <div>
+            <div className="flex items-center gap-2 mb-4">
+              <Settings size={18} style={{ color: 'var(--color-secondary)' }} />
+              <span
+                className="font-heading"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body)',
+                  fontWeight: 'var(--font-weight-bold)'
+                }}
+              >
+                Compiler Settings
+              </span>
+            </div>
+
+            <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+              <div>
+                <label
+                  className="block font-heading mb-2"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  Solidity Version
+                </label>
+                <select
+                  value={compilerVersion}
+                  onChange={e => setCompilerVersion(e.target.value)}
+                  className="angular-clip w-full px-3 py-2 font-mono"
+                  style={{
+                    background: 'var(--color-marble-light)',
+                    border: '2px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-body-sm)'
+                  }}
+                >
+                  {COMPILER_VERSIONS.map(v => (
+                    <option key={v} value={v}>
+                      {v}
+                    </option>
+                  ))}
+                </select>
+              </div>
+
+              <div>
+                <label
+                  className="block font-heading mb-2"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  Optimizer Runs
+                </label>
+                <input
+                  type="number"
+                  value={optimizerRuns}
+                  onChange={e => setOptimizerRuns(parseInt(e.target.value) || 200)}
+                  min={0}
+                  max={10000}
+                  className="angular-clip w-full px-3 py-2 font-mono"
+                  style={{
+                    background: 'var(--color-marble-light)',
+                    border: '2px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-body-sm)'
+                  }}
+                />
+              </div>
+            </div>
+          </div>
+
+          {/* Verify Only Option */}
+          <div
+            className="angular-clip p-4"
+            style={{
+              background: 'var(--color-marble-light)',
+              border: '1px solid var(--color-accent)'
+            }}
+          >
+            <label className="flex items-start gap-3 cursor-pointer">
+              <input
+                type="checkbox"
+                checked={verifyOnly}
+                onChange={e => setVerifyOnly(e.target.checked)}
+                className="mt-1"
+                style={{ accentColor: 'var(--color-primary)' }}
+              />
+              <div>
+                <span
+                  className="font-heading"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-body-sm)',
+                    fontWeight: 'var(--font-weight-bold)'
+                  }}
+                >
+                  Verify Only (Skip CFHE Deployment)
+                </span>
+                <p
+                  className="font-body mt-1"
+                  style={{
+                    color: 'var(--color-accent)',
+                    fontSize: 'var(--font-size-caption)'
+                  }}
+                >
+                  Only run AVS verification without deploying encrypted bytecode. Useful for testing compliance before final deployment.
+                </p>
+              </div>
+            </label>
+          </div>
+
+          {/* Submission Error */}
+          {submissionError && (
+            <div
+              className="angular-clip p-3 flex items-center gap-2"
+              style={{
+                background: 'rgba(232, 90, 79, 0.1)',
+                border: '1px solid var(--color-accent)'
+              }}
+            >
+              <AlertCircle size={18} style={{ color: 'var(--color-accent)' }} />
+              <span
+                className="font-body"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              >
+                {submissionError}
+              </span>
+            </div>
+          )}
+
+          {/* Wallet Connection / Submit Button */}
+          {!walletConnected ? (
+            <button
+              onClick={onConnectWallet}
+              className="angular-clip-button w-full px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+              style={{
+                background: 'var(--color-secondary)',
+                color: 'var(--color-primary)',
+                border: '2px solid var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)',
+                fontWeight: 'var(--font-weight-bold)'
+              }}
+            >
+              Connect Wallet to Submit
+            </button>
+          ) : (
+            <button
+              onClick={handleSubmit}
+              disabled={!repoUrl}
+              className="angular-clip-button w-full px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+              style={{
+                background: 'var(--color-primary)',
+                color: 'var(--color-secondary)',
+                border: '2px solid var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)',
+                fontWeight: 'var(--font-weight-bold)',
+                opacity: repoUrl ? 1 : 0.5,
+                cursor: repoUrl ? 'pointer' : 'not-allowed'
+              }}
+            >
+              {verifyOnly ? 'Verify Code' : 'Verify & Deploy'}
+            </button>
+          )}
+        </div>
+      )}
+
+      {/* Submitting Step */}
+      {step === 'submitting' && (
+        <div className="text-center py-8">
+          <div
+            className="w-16 h-16 mx-auto mb-4 angular-clip flex items-center justify-center animate-pulse"
+            style={{
+              background: 'var(--color-primary)',
+              border: '2px solid var(--color-secondary)'
+            }}
+          >
+            <Github size={32} style={{ color: 'var(--color-secondary)' }} />
+          </div>
+          <h4
+            className="font-heading mb-2"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-h5)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            Processing...
+          </h4>
+          <p
+            className="font-body"
+            style={{
+              color: 'var(--color-accent)',
+              fontSize: 'var(--font-size-body-sm)'
+            }}
+          >
+            Analyzing repository, verifying with AVS operators, and deploying to CFHE...
+          </p>
+
+          {/* Progress indicators */}
+          <div className="mt-6 space-y-3">
+            {['Cloning Repository', 'Analyzing Contracts', 'Compiling Solidity', 'Submitting to AVS', verifyOnly ? null : 'Deploying to CFHE'].filter(Boolean).map((stepName, i) => (
+              <div
+                key={i}
+                className="flex items-center justify-center gap-2"
+              >
+                <div
+                  className="w-4 h-4 rounded-full animate-pulse"
+                  style={{
+                    background: 'var(--color-primary)'
+                  }}
+                />
+                <span
+                  className="font-body"
+                  style={{
+                    color: 'var(--color-black)',
+                    fontSize: 'var(--font-size-body-sm)'
+                  }}
+                >
+                  {stepName}
+                </span>
+              </div>
+            ))}
+          </div>
+        </div>
+      )}
+
+      {/* Complete Step - Pass to parent to show results components */}
+      {step === 'complete' && verificationResult && (
+        <div className="text-center py-4">
+          <div
+            className="w-16 h-16 mx-auto mb-4 angular-clip flex items-center justify-center"
+            style={{
+              background: verificationResult.avsResult.compliant ? 'var(--color-primary)' : 'var(--color-accent)',
+              border: '2px solid var(--color-secondary)'
+            }}
+          >
+            <Check size={32} style={{ color: 'var(--color-secondary)' }} />
+          </div>
+          <h4
+            className="font-heading mb-2"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-h5)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            {verificationResult.avsResult.compliant ? 'Verification Complete!' : 'Verification Complete (Issues Found)'}
+          </h4>
+          <p
+            className="font-body"
+            style={{
+              color: 'var(--color-accent)',
+              fontSize: 'var(--font-size-body-sm)'
+            }}
+          >
+            View the detailed results below
+          </p>
+
+          {/* Repo Info Summary */}
+          {verificationResult.repoAnalysis && (
+            <div
+              className="angular-clip p-3 mt-4 text-left"
+              style={{
+                background: 'var(--color-marble-light)',
+                border: '1px solid var(--color-accent)'
+              }}
+            >
+              <div className="flex items-center gap-2 mb-2">
+                <Github size={16} style={{ color: 'var(--color-secondary)' }} />
+                <span
+                  className="font-heading"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)',
+                    fontWeight: 'var(--font-weight-bold)'
+                  }}
+                >
+                  Repository Analyzed
+                </span>
+              </div>
+              <div className="grid grid-cols-2 gap-2">
+                <div>
+                  <span className="font-heading block" style={{ color: 'var(--color-accent)', fontSize: '10px' }}>
+                    Commit
+                  </span>
+                  <code className="font-mono" style={{ color: 'var(--color-secondary)', fontSize: '11px' }}>
+                    {verificationResult.repoAnalysis.commitHash.slice(0, 8)}
+                  </code>
+                </div>
+                <div>
+                  <span className="font-heading block" style={{ color: 'var(--color-accent)', fontSize: '10px' }}>
+                    Contracts Found
+                  </span>
+                  <span className="font-mono" style={{ color: 'var(--color-secondary)', fontSize: '11px' }}>
+                    {verificationResult.repoAnalysis.contractsFound}
+                  </span>
+                </div>
+              </div>
+            </div>
+          )}
+        </div>
+      )}
+    </div>
+  );
+}
diff --git a/client2/src/components/hook/CodeVerificationPage.tsx b/client2/src/components/hook/CodeVerificationPage.tsx
new file mode 100644
index 000000000..9a13ebdd6
--- /dev/null
+++ b/client2/src/components/hook/CodeVerificationPage.tsx
@@ -0,0 +1,522 @@
+import { useState, useCallback, useEffect } from 'react';
+import { ArrowLeft, ChevronRight, Github, Shield, Lock, CheckCircle } from 'lucide-react';
+import { useNavigate, useLocation } from 'react-router-dom';
+import Navigation from '../Navigation';
+import Footer from '../Footer';
+import CodeSubmissionFlow from './CodeSubmissionFlow';
+import AVSVerificationResults from './AVSVerificationResults';
+import CFHEDeploymentStatus from './CFHEDeploymentStatus';
+import type {
+  SubmissionResult,
+  CodeVerificationResult
+} from '../../types/hookSpec';
+
+interface CodeVerificationPageProps {
+  onNavigate?: (page: string) => void;
+}
+
+type VerificationStep = 'submit-code' | 'verifying' | 'results';
+
+const STEPS: { id: VerificationStep; title: string; description: string; icon: React.ReactNode }[] = [
+  {
+    id: 'submit-code',
+    title: 'Submit Code',
+    description: 'Link GitHub repository',
+    icon: <Github size={18} />
+  },
+  {
+    id: 'verifying',
+    title: 'AVS Verification',
+    description: 'Compliance check',
+    icon: <Shield size={18} />
+  },
+  {
+    id: 'results',
+    title: 'Deploy',
+    description: 'CFHE deployment',
+    icon: <Lock size={18} />
+  }
+];
+
+export default function CodeVerificationPage({ onNavigate }: CodeVerificationPageProps) {
+  const navigate = useNavigate();
+  const location = useLocation();
+
+  // Get license info from navigation state (passed from CreateHookPage after minting)
+  const locationState = location.state as {
+    licenseInfo?: {
+      tokenId: number;
+      hookName: string;
+      hookVersion: string;
+      specIpfsCid: string;
+    };
+    submissionResult?: SubmissionResult;
+  } | null;
+
+  const [currentStep, setCurrentStep] = useState<VerificationStep>('submit-code');
+  const [codeVerificationResult, setCodeVerificationResult] = useState<CodeVerificationResult | null>(null);
+
+  // Mock license info if not passed (for direct navigation/testing)
+  const [licenseInfo] = useState(locationState?.licenseInfo || {
+    tokenId: 42,
+    hookName: 'DynamicFeeHook',
+    hookVersion: '1.0.0',
+    specIpfsCid: 'QmMockSpecCid123456789'
+  });
+
+  const [submissionResult] = useState<SubmissionResult>(locationState?.submissionResult || {
+    success: true,
+    ipfsCid: 'QmMockSpecCid123456789',
+    tokenId: 42,
+    transactionHash: '0xmock1234567890abcdef1234567890abcdef1234567890abcdef1234567890',
+    ownerAddress: '0x1234567890abcdef1234567890abcdef12345678',
+    ipfsGatewayUrl: 'https://ipfs.io/ipfs/QmMockSpecCid123456789',
+    openSeaUrl: 'https://opensea.io/assets/ethereum/...'
+  });
+
+  // Mock wallet state
+  const [walletConnected, setWalletConnected] = useState(true);
+  const [walletAddress] = useState('0x1234567890abcdef1234567890abcdef12345678');
+
+  const handleNavigate = (page: string) => {
+    if (onNavigate) {
+      onNavigate(page);
+    } else {
+      navigate(`/${page}`);
+    }
+  };
+
+  const handleConnectWallet = useCallback(() => {
+    setWalletConnected(true);
+  }, []);
+
+  const handleCodeSubmit = useCallback(async (params: {
+    repoUrl: string;
+    branch?: string;
+    contractPath?: string;
+    compilerVersion: string;
+    optimizerRuns: number;
+    verifyOnly: boolean;
+  }): Promise<CodeVerificationResult> => {
+    // Move to verifying step
+    setCurrentStep('verifying');
+
+    // Simulate code verification
+    await new Promise(resolve => setTimeout(resolve, 3000));
+
+    const mockResult: CodeVerificationResult = {
+      success: true,
+      repoAnalysis: {
+        repoUrl: params.repoUrl,
+        branch: params.branch || 'main',
+        commitHash: 'a1b2c3d4e5f6g7h8i9j0' + Math.random().toString(36).slice(2, 6),
+        mainContract: params.contractPath || 'src/DynamicFeeHook.sol',
+        contractsFound: 3,
+        dependencies: ['@uniswap/v4-core', '@openzeppelin/contracts']
+      },
+      compilation: {
+        success: true,
+        bytecodeHash: '0x' + Math.random().toString(16).slice(2) + Math.random().toString(16).slice(2),
+        deployedBytecodeHash: '0x' + Math.random().toString(16).slice(2) + Math.random().toString(16).slice(2)
+      },
+      avsResult: {
+        compliant: true,
+        complianceScore: 96.5,
+        attestationId: '0xattest' + Math.random().toString(16).slice(2, 18),
+        attestationTxHash: '0x' + Math.random().toString(16).slice(2) + Math.random().toString(16).slice(2),
+        findings: [
+          {
+            severity: 'info',
+            ruleId: 'GAS-01',
+            ruleName: 'Gas Optimization',
+            description: 'Consider using unchecked blocks for arithmetic operations that cannot overflow',
+            codeLocation: { startLine: 45, endLine: 48, functionName: 'beforeSwap' },
+            specReference: 'Section 3.2 - State Transitions'
+          },
+          {
+            severity: 'warning',
+            ruleId: 'SEC-02',
+            ruleName: 'Reentrancy Check',
+            description: 'External call detected before state update. Ensure reentrancy protection is in place.',
+            codeLocation: { startLine: 72, endLine: 75, functionName: 'afterSwap' }
+          }
+        ],
+        verificationTimestamp: Date.now()
+      },
+      cfheResult: params.verifyOnly ? undefined : {
+        encryptedBytecodeHash: '0xenc' + Math.random().toString(16).slice(2, 30),
+        deploymentTxHash: '0x' + Math.random().toString(16).slice(2) + Math.random().toString(16).slice(2),
+        encryptedContractAddress: '0x' + Math.random().toString(16).slice(2, 42),
+        blockNumber: 18500000 + Math.floor(Math.random() * 10000),
+        explorerUrl: 'https://explorer.inco.org/tx/0x...'
+      },
+      summary: {
+        hookName: licenseInfo.hookName,
+        hookVersion: licenseInfo.hookVersion,
+        licenseTokenId: licenseInfo.tokenId,
+        specIpfsCid: licenseInfo.specIpfsCid,
+        repoUrl: params.repoUrl,
+        commitHash: 'a1b2c3d4',
+        submittedAt: Date.now() - 3000,
+        completedAt: Date.now()
+      }
+    };
+
+    setCodeVerificationResult(mockResult);
+    setCurrentStep('results');
+    return mockResult;
+  }, [licenseInfo]);
+
+  const goToStep = (step: VerificationStep) => {
+    const stepOrder: VerificationStep[] = ['submit-code', 'verifying', 'results'];
+    const currentIndex = stepOrder.indexOf(currentStep);
+    const targetIndex = stepOrder.indexOf(step);
+
+    if (targetIndex <= currentIndex) {
+      setCurrentStep(step);
+    }
+  };
+
+  return (
+    <div className="min-h-screen" style={{ background: 'var(--color-white)' }}>
+      <Navigation onNavigate={handleNavigate} />
+
+      {/* Hero Section */}
+      <section
+        className="speed-lines"
+        style={{
+          paddingTop: 'var(--space-2xl)',
+          paddingBottom: 'var(--space-xl)',
+          background: 'var(--color-marble-light)'
+        }}
+      >
+        <div className="container-custom">
+          <button
+            onClick={() => handleNavigate('hook-developer')}
+            className="flex items-center gap-2 mb-6 font-heading transition-colors duration-200"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body)',
+              fontWeight: 'var(--font-weight-medium)'
+            }}
+          >
+            <ArrowLeft size={20} />
+            Back to Dashboard
+          </button>
+
+          <h1
+            className="mb-2 font-heading"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-h2)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            Verify & Deploy <span style={{ color: 'var(--color-primary)' }}>Code</span>
+          </h1>
+          <p
+            className="font-body"
+            style={{
+              color: 'var(--color-black)',
+              fontSize: 'var(--font-size-body)'
+            }}
+          >
+            Link your GitHub repository for AVS verification and CFHE deployment
+          </p>
+        </div>
+      </section>
+
+      {/* Step Indicator */}
+      <section style={{ paddingTop: 'var(--space-lg)', paddingBottom: 'var(--space-lg)' }}>
+        <div className="container-custom">
+          <div className="flex items-center justify-center gap-4">
+            {STEPS.map((step, index) => {
+              const stepOrder: VerificationStep[] = ['submit-code', 'verifying', 'results'];
+              const currentIndex = stepOrder.indexOf(currentStep);
+              const stepIndex = stepOrder.indexOf(step.id);
+              const isActive = step.id === currentStep;
+              const isCompleted = stepIndex < currentIndex;
+              const isAccessible = stepIndex <= currentIndex;
+
+              return (
+                <div key={step.id} className="flex items-center">
+                  <button
+                    onClick={() => goToStep(step.id)}
+                    disabled={!isAccessible}
+                    className="flex items-center gap-3 transition-all duration-200"
+                    style={{
+                      cursor: isAccessible ? 'pointer' : 'not-allowed',
+                      opacity: isAccessible ? 1 : 0.5
+                    }}
+                  >
+                    <div
+                      className="angular-clip w-12 h-12 flex items-center justify-center"
+                      style={{
+                        background: isActive
+                          ? 'var(--color-primary)'
+                          : isCompleted
+                          ? 'var(--color-secondary)'
+                          : 'var(--color-marble-light)',
+                        color: isActive || isCompleted
+                          ? isActive ? 'var(--color-secondary)' : 'var(--color-primary)'
+                          : 'var(--color-accent)',
+                        border: `2px solid ${isActive ? 'var(--color-secondary)' : 'var(--color-accent)'}`
+                      }}
+                    >
+                      {isCompleted ? <CheckCircle size={20} /> : step.icon}
+                    </div>
+                    <div className="text-left">
+                      <p
+                        className="font-heading"
+                        style={{
+                          color: isActive ? 'var(--color-secondary)' : 'var(--color-accent)',
+                          fontSize: 'var(--font-size-body-sm)',
+                          fontWeight: 'var(--font-weight-bold)'
+                        }}
+                      >
+                        {step.title}
+                      </p>
+                      <p
+                        className="font-body"
+                        style={{
+                          color: 'var(--color-black)',
+                          fontSize: 'var(--font-size-caption)'
+                        }}
+                      >
+                        {step.description}
+                      </p>
+                    </div>
+                  </button>
+
+                  {index < STEPS.length - 1 && (
+                    <ChevronRight
+                      size={24}
+                      className="mx-6"
+                      style={{ color: 'var(--color-accent)' }}
+                    />
+                  )}
+                </div>
+              );
+            })}
+          </div>
+        </div>
+      </section>
+
+      {/* Main Content */}
+      <section style={{ paddingBottom: 'var(--space-4xl)' }}>
+        <div className="container-custom max-w-4xl mx-auto">
+          {/* Code Submission Step */}
+          {currentStep === 'submit-code' && (
+            <CodeSubmissionFlow
+              licenseInfo={licenseInfo}
+              submissionResult={submissionResult}
+              walletConnected={walletConnected}
+              walletAddress={walletAddress}
+              onConnectWallet={handleConnectWallet}
+              onSubmitCode={handleCodeSubmit}
+            />
+          )}
+
+          {/* Verifying Step */}
+          {currentStep === 'verifying' && (
+            <div
+              className="angular-clip p-8 text-center"
+              style={{
+                background: 'var(--color-white)',
+                border: '2px solid var(--color-secondary)'
+              }}
+            >
+              <div
+                className="w-20 h-20 mx-auto mb-6 angular-clip flex items-center justify-center animate-pulse"
+                style={{
+                  background: 'var(--color-primary)',
+                  border: '2px solid var(--color-secondary)'
+                }}
+              >
+                <Shield size={40} style={{ color: 'var(--color-secondary)' }} />
+              </div>
+              <h3
+                className="font-heading mb-2"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-h4)',
+                  fontWeight: 'var(--font-weight-bold)'
+                }}
+              >
+                Verification in Progress
+              </h3>
+              <p
+                className="font-body mb-8"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              >
+                AVS operators are verifying your code against the HookSpec specification...
+              </p>
+
+              {/* Progress Steps */}
+              <div className="space-y-4 max-w-md mx-auto">
+                {[
+                  'Cloning Repository',
+                  'Analyzing Contracts',
+                  'Compiling Solidity',
+                  'AVS Consensus',
+                  'CFHE Encryption',
+                  'Deploying'
+                ].map((stepName, i) => (
+                  <div
+                    key={i}
+                    className="flex items-center gap-3 p-3 angular-clip"
+                    style={{
+                      background: 'var(--color-marble-light)',
+                      border: '1px solid var(--color-accent)'
+                    }}
+                  >
+                    <div
+                      className="w-6 h-6 rounded-full animate-pulse"
+                      style={{ background: 'var(--color-primary)' }}
+                    />
+                    <span
+                      className="font-body"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-body-sm)'
+                      }}
+                    >
+                      {stepName}
+                    </span>
+                  </div>
+                ))}
+              </div>
+            </div>
+          )}
+
+          {/* Results Step */}
+          {currentStep === 'results' && codeVerificationResult && (
+            <div className="space-y-6">
+              {/* AVS Verification Results */}
+              <AVSVerificationResults
+                compilationResult={codeVerificationResult.compilation}
+                avsResult={codeVerificationResult.avsResult}
+              />
+
+              {/* CFHE Deployment Status */}
+              {codeVerificationResult.cfheResult && (
+                <CFHEDeploymentStatus
+                  cfheResult={codeVerificationResult.cfheResult}
+                />
+              )}
+
+              {/* Success Summary */}
+              <div
+                className="angular-clip p-6"
+                style={{
+                  background: 'rgba(255, 215, 0, 0.15)',
+                  border: '2px solid var(--color-primary)'
+                }}
+              >
+                <div className="flex items-center gap-3 mb-4">
+                  <CheckCircle size={28} style={{ color: 'var(--color-primary)' }} />
+                  <h3
+                    className="font-heading"
+                    style={{
+                      color: 'var(--color-secondary)',
+                      fontSize: 'var(--font-size-h4)',
+                      fontWeight: 'var(--font-weight-bold)'
+                    }}
+                  >
+                    Verification Complete!
+                  </h3>
+                </div>
+
+                <div className="grid grid-cols-1 md:grid-cols-3 gap-4 mb-6">
+                  <div>
+                    <span
+                      className="font-heading block mb-1"
+                      style={{
+                        color: 'var(--color-accent)',
+                        fontSize: 'var(--font-size-caption)',
+                        textTransform: 'uppercase'
+                      }}
+                    >
+                      Hook Name
+                    </span>
+                    <span
+                      className="font-heading"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-body)'
+                      }}
+                    >
+                      {codeVerificationResult.summary.hookName} v{codeVerificationResult.summary.hookVersion}
+                    </span>
+                  </div>
+                  <div>
+                    <span
+                      className="font-heading block mb-1"
+                      style={{
+                        color: 'var(--color-accent)',
+                        fontSize: 'var(--font-size-caption)',
+                        textTransform: 'uppercase'
+                      }}
+                    >
+                      License Token ID
+                    </span>
+                    <span
+                      className="font-mono"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-body)'
+                      }}
+                    >
+                      #{codeVerificationResult.summary.licenseTokenId}
+                    </span>
+                  </div>
+                  <div>
+                    <span
+                      className="font-heading block mb-1"
+                      style={{
+                        color: 'var(--color-accent)',
+                        fontSize: 'var(--font-size-caption)',
+                        textTransform: 'uppercase'
+                      }}
+                    >
+                      Compliance Score
+                    </span>
+                    <span
+                      className="font-heading"
+                      style={{
+                        color: 'var(--color-primary)',
+                        fontSize: 'var(--font-size-body)',
+                        fontWeight: 'var(--font-weight-bold)'
+                      }}
+                    >
+                      {codeVerificationResult.avsResult.complianceScore.toFixed(1)}%
+                    </span>
+                  </div>
+                </div>
+
+                <button
+                  onClick={() => handleNavigate('hook-developer')}
+                  className="angular-clip-button px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+                  style={{
+                    background: 'var(--color-secondary)',
+                    color: 'var(--color-primary)',
+                    border: '2px solid var(--color-secondary)',
+                    fontSize: 'var(--font-size-body-sm)',
+                    fontWeight: 'var(--font-weight-bold)'
+                  }}
+                >
+                  Return to Dashboard
+                </button>
+              </div>
+            </div>
+          )}
+        </div>
+      </section>
+
+      <Footer onNavigate={handleNavigate} />
+    </div>
+  );
+}
diff --git a/client2/src/components/hook/CreateHookPage.tsx b/client2/src/components/hook/CreateHookPage.tsx
new file mode 100644
index 000000000..aa008acc3
--- /dev/null
+++ b/client2/src/components/hook/CreateHookPage.tsx
@@ -0,0 +1,560 @@
+import { useState, useCallback } from 'react';
+import { ArrowLeft, ChevronRight } from 'lucide-react';
+import { useNavigate } from 'react-router-dom';
+import Navigation from '../Navigation';
+import Footer from '../Footer';
+import StateSpaceModelViewer from './StateSpaceModelViewer';
+import HookSpecEditor from './HookSpecEditor';
+import ValidationResults from './ValidationResults';
+import SubmissionFlow from './SubmissionFlow';
+import type {
+  HookSpec,
+  StateSpaceModel,
+  ValidationResult,
+  SubmissionResult,
+  SystemStateVariable
+} from '../../types/hookSpec';
+
+interface CreateHookPageProps {
+  onNavigate?: (page: string) => void;
+}
+
+type FlowStep = 'view-model' | 'edit-spec' | 'validate' | 'submit';
+
+const STEPS: { id: FlowStep; title: string; description: string }[] = [
+  {
+    id: 'view-model',
+    title: 'View State Model',
+    description: 'Review available pool state variables'
+  },
+  {
+    id: 'edit-spec',
+    title: 'Write HookSpec',
+    description: 'Define your hook behavior'
+  },
+  {
+    id: 'validate',
+    title: 'Validate',
+    description: 'Check compatibility'
+  },
+  {
+    id: 'submit',
+    title: 'Mint License',
+    description: 'Mint HookLicense NFT'
+  }
+];
+
+// Mock data - replace with API calls
+const MOCK_STATE_SPACE_MODEL: StateSpaceModel = {
+  version: '1.0.0',
+  ipfsCid: 'QmSystemStateModelV1abc123def456',
+  uniswapVersion: 'v4',
+  updatedAt: '2025-12-09',
+  indices: {
+    lp: [
+      {
+        name: 'position_liquidity',
+        symbol: 'L_k',
+        type: 'uint128',
+        getter: 'getPositionLiquidity(poolId, positionId)',
+        description: 'Liquidity amount for a specific position'
+      },
+      {
+        name: 'tick_lower',
+        symbol: 't_l^k',
+        type: 'int24',
+        getter: 'getPositionInfo(poolId, positionId)',
+        description: 'Lower tick bound of position'
+      },
+      {
+        name: 'tick_upper',
+        symbol: 't_u^k',
+        type: 'int24',
+        getter: 'getPositionInfo(poolId, positionId)',
+        description: 'Upper tick bound of position'
+      },
+      {
+        name: 'fee_growth_inside_0',
+        symbol: 'f_{0,k}^{in}',
+        type: 'uint256',
+        getter: 'getPositionInfo(poolId, positionId)',
+        description: 'Fee growth inside position for token0'
+      },
+      {
+        name: 'fee_growth_inside_1',
+        symbol: 'f_{1,k}^{in}',
+        type: 'uint256',
+        getter: 'getPositionInfo(poolId, positionId)',
+        description: 'Fee growth inside position for token1'
+      },
+      {
+        name: 'liquidity_gross',
+        symbol: 'L_g^{tick}',
+        type: 'uint128',
+        getter: 'getTickLiquidity(poolId, tick)',
+        description: 'Gross liquidity at tick'
+      },
+      {
+        name: 'liquidity_net',
+        symbol: 'L_n^{tick}',
+        type: 'int128',
+        getter: 'getTickLiquidity(poolId, tick)',
+        description: 'Net liquidity change at tick'
+      }
+    ],
+    trader: [
+      {
+        name: 'sqrt_price',
+        symbol: '\\sqrt{P}',
+        type: 'uint160',
+        getter: 'getSlot0(poolId)',
+        description: 'Current sqrt price in Q64.96 format'
+      },
+      {
+        name: 'current_tick',
+        symbol: 't_c',
+        type: 'int24',
+        getter: 'getSlot0(poolId)',
+        description: 'Current tick index'
+      },
+      {
+        name: 'lp_fee',
+        symbol: '\\phi_{lp}',
+        type: 'uint24',
+        getter: 'getSlot0(poolId)',
+        description: 'Fee paid to liquidity providers'
+      },
+      {
+        name: 'protocol_fee',
+        symbol: '\\phi_{proto}',
+        type: 'uint24',
+        getter: 'getSlot0(poolId)',
+        description: 'Protocol fee percentage'
+      },
+      {
+        name: 'active_liquidity',
+        symbol: 'L_{act}',
+        type: 'uint128',
+        getter: 'getLiquidity(poolId)',
+        description: 'Currently active liquidity for swaps'
+      },
+      {
+        name: 'tick_bitmap',
+        symbol: 'B_{tick}',
+        type: 'uint256',
+        getter: 'getTickBitmap(poolId, wordPos)',
+        description: 'Bitmap for initialized ticks'
+      }
+    ],
+    shared: [
+      {
+        name: 'fee_growth_global_0',
+        symbol: 'f_0^{global}',
+        type: 'uint256',
+        getter: 'getFeeGrowthGlobals(poolId)',
+        description: 'Cumulative fee growth for token0'
+      },
+      {
+        name: 'fee_growth_global_1',
+        symbol: 'f_1^{global}',
+        type: 'uint256',
+        getter: 'getFeeGrowthGlobals(poolId)',
+        description: 'Cumulative fee growth for token1'
+      }
+    ]
+  }
+};
+
+export default function CreateHookPage({ onNavigate }: CreateHookPageProps) {
+  const navigate = useNavigate();
+  const [currentStep, setCurrentStep] = useState<FlowStep>('view-model');
+  const [hookSpec, setHookSpec] = useState<HookSpec | null>(null);
+  const [validationResults, setValidationResults] = useState<ValidationResult[]>([]);
+  const [isValidating, setIsValidating] = useState(false);
+  const [validationPassed, setValidationPassed] = useState(false);
+  const [submissionResult, setSubmissionResult] = useState<SubmissionResult | null>(null);
+
+  // Mock wallet state - replace with actual wallet integration
+  const [walletConnected, setWalletConnected] = useState(false);
+  const [walletAddress, setWalletAddress] = useState<string | undefined>(undefined);
+
+  const handleNavigate = (page: string) => {
+    if (onNavigate) {
+      onNavigate(page);
+    } else {
+      navigate(`/${page}`);
+    }
+  };
+
+  const handleSelectVariable = useCallback((variable: SystemStateVariable) => {
+    // Could open a tooltip or copy to clipboard
+    console.log('Selected variable:', variable);
+  }, []);
+
+  const handleSpecChange = useCallback((spec: HookSpec) => {
+    setHookSpec(spec);
+    // Reset validation when spec changes
+    setValidationResults([]);
+    setValidationPassed(false);
+  }, []);
+
+  const handleValidate = useCallback(async () => {
+    if (!hookSpec) return;
+
+    setIsValidating(true);
+    setValidationResults([]);
+
+    // Simulate API call
+    await new Promise(resolve => setTimeout(resolve, 1500));
+
+    // Mock validation results
+    const mockResults: ValidationResult[] = [
+      {
+        ruleId: 'V1',
+        ruleName: 'ValidPoolStateReferences',
+        passed: true,
+        errors: [],
+        warnings: []
+      },
+      {
+        ruleId: 'V2',
+        ruleName: 'UniqueHookStateNames',
+        passed: hookSpec.hook_state.length === new Set(hookSpec.hook_state.map(v => v.name)).size,
+        errors: hookSpec.hook_state.length !== new Set(hookSpec.hook_state.map(v => v.name)).size
+          ? ['Duplicate hook state variable names detected']
+          : [],
+        warnings: []
+      },
+      {
+        ruleId: 'V3',
+        ruleName: 'ValidCallbacks',
+        passed: true,
+        errors: [],
+        warnings: []
+      },
+      {
+        ruleId: 'V4',
+        ruleName: 'ValidEquationSymbols',
+        passed: true,
+        errors: [],
+        warnings: hookSpec.system_functions.some(f => !f.transition.equation)
+          ? ['Some functions are missing transition equations']
+          : []
+      },
+      {
+        ruleId: 'V5',
+        ruleName: 'ValidSolidityTypes',
+        passed: true,
+        errors: [],
+        warnings: []
+      },
+      {
+        ruleId: 'V6',
+        ruleName: 'WritesMatchHookState',
+        passed: true,
+        errors: [],
+        warnings: []
+      }
+    ];
+
+    setValidationResults(mockResults);
+    setValidationPassed(mockResults.every(r => r.passed));
+    setIsValidating(false);
+    setCurrentStep('validate');
+  }, [hookSpec]);
+
+  const handleSubmit = useCallback(async (): Promise<SubmissionResult> => {
+    // Simulate submission
+    await new Promise(resolve => setTimeout(resolve, 2000));
+
+    const result: SubmissionResult = {
+      success: true,
+      ipfsCid: 'QmNewHookSpec' + Math.random().toString(36).slice(2, 10),
+      tokenId: Math.floor(Math.random() * 1000) + 1,
+      transactionHash: '0x' + Math.random().toString(16).slice(2) + Math.random().toString(16).slice(2),
+      ownerAddress: walletAddress || '0x0000000000000000000000000000000000000000',
+      ipfsGatewayUrl: 'https://ipfs.io/ipfs/QmNewHookSpec...',
+      openSeaUrl: 'https://opensea.io/assets/ethereum/...'
+    };
+
+    setSubmissionResult(result);
+    return result;
+  }, [walletAddress]);
+
+  const handleConnectWallet = useCallback(() => {
+    // Simulate wallet connection
+    setWalletConnected(true);
+    setWalletAddress('0x1234567890abcdef1234567890abcdef12345678');
+  }, []);
+
+  const goToStep = (step: FlowStep) => {
+    const stepOrder: FlowStep[] = ['view-model', 'edit-spec', 'validate', 'submit'];
+    const currentIndex = stepOrder.indexOf(currentStep);
+    const targetIndex = stepOrder.indexOf(step);
+
+    // Allow going back, or forward if prerequisites are met
+    if (targetIndex <= currentIndex) {
+      setCurrentStep(step);
+    } else if (step === 'submit' && validationPassed) {
+      setCurrentStep(step);
+    }
+  };
+
+  const nextStep = () => {
+    const stepOrder: FlowStep[] = ['view-model', 'edit-spec', 'validate', 'submit'];
+    const currentIndex = stepOrder.indexOf(currentStep);
+    if (currentIndex < stepOrder.length - 1) {
+      setCurrentStep(stepOrder[currentIndex + 1]);
+    }
+  };
+
+  const handleContinueToVerification = () => {
+    // Navigate to CodeVerificationPage with license info
+    if (submissionResult && hookSpec) {
+      navigate('/hook-developer/verify', {
+        state: {
+          licenseInfo: {
+            tokenId: submissionResult.tokenId,
+            hookName: hookSpec.metadata.name,
+            hookVersion: hookSpec.metadata.version,
+            specIpfsCid: submissionResult.ipfsCid
+          },
+          submissionResult: submissionResult
+        }
+      });
+    }
+  };
+
+  return (
+    <div className="min-h-screen" style={{ background: 'var(--color-white)' }}>
+      <Navigation onNavigate={handleNavigate} />
+
+      {/* Hero Section */}
+      <section
+        className="speed-lines"
+        style={{
+          paddingTop: 'var(--space-2xl)',
+          paddingBottom: 'var(--space-xl)',
+          background: 'var(--color-marble-light)'
+        }}
+      >
+        <div className="container-custom">
+          <button
+            onClick={() => handleNavigate('hook-developer')}
+            className="flex items-center gap-2 mb-6 font-heading transition-colors duration-200"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body)',
+              fontWeight: 'var(--font-weight-medium)'
+            }}
+          >
+            <ArrowLeft size={20} />
+            Back to Dashboard
+          </button>
+
+          <h1
+            className="mb-2 font-heading"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-h2)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            Create New <span style={{ color: 'var(--color-primary)' }}>Hook</span>
+          </h1>
+          <p
+            className="font-body"
+            style={{
+              color: 'var(--color-black)',
+              fontSize: 'var(--font-size-body)'
+            }}
+          >
+            Define your hook specification, mint license, and deploy verified code
+          </p>
+        </div>
+      </section>
+
+      {/* Step Indicator */}
+      <section style={{ paddingTop: 'var(--space-lg)', paddingBottom: 'var(--space-lg)' }}>
+        <div className="container-custom">
+          <div className="flex items-center justify-between overflow-x-auto pb-2">
+            {STEPS.map((step, index) => {
+              const stepOrder: FlowStep[] = ['view-model', 'edit-spec', 'validate', 'submit'];
+              const currentIndex = stepOrder.indexOf(currentStep);
+              const stepIndex = stepOrder.indexOf(step.id);
+              const isActive = step.id === currentStep;
+              const isCompleted = stepIndex < currentIndex;
+              const isAccessible = stepIndex <= currentIndex ||
+                (step.id === 'submit' && validationPassed);
+
+              return (
+                <div key={step.id} className="flex items-center flex-shrink-0">
+                  <button
+                    onClick={() => goToStep(step.id)}
+                    disabled={!isAccessible}
+                    className="flex items-center gap-2 transition-all duration-200"
+                    style={{
+                      cursor: isAccessible ? 'pointer' : 'not-allowed',
+                      opacity: isAccessible ? 1 : 0.5
+                    }}
+                  >
+                    <div
+                      className="angular-clip w-8 h-8 md:w-10 md:h-10 flex items-center justify-center font-heading"
+                      style={{
+                        background: isActive
+                          ? 'var(--color-primary)'
+                          : isCompleted
+                          ? 'var(--color-secondary)'
+                          : 'var(--color-marble-light)',
+                        color: isActive || isCompleted
+                          ? isActive ? 'var(--color-secondary)' : 'var(--color-primary)'
+                          : 'var(--color-accent)',
+                        border: `2px solid ${isActive ? 'var(--color-secondary)' : 'var(--color-accent)'}`,
+                        fontSize: 'var(--font-size-body-sm)',
+                        fontWeight: 'var(--font-weight-bold)'
+                      }}
+                    >
+                      {index + 1}
+                    </div>
+                    <div className="hidden lg:block text-left">
+                      <p
+                        className="font-heading"
+                        style={{
+                          color: isActive ? 'var(--color-secondary)' : 'var(--color-accent)',
+                          fontSize: 'var(--font-size-caption)',
+                          fontWeight: 'var(--font-weight-bold)'
+                        }}
+                      >
+                        {step.title}
+                      </p>
+                      <p
+                        className="font-body hidden xl:block"
+                        style={{
+                          color: 'var(--color-black)',
+                          fontSize: '10px'
+                        }}
+                      >
+                        {step.description}
+                      </p>
+                    </div>
+                  </button>
+
+                  {index < STEPS.length - 1 && (
+                    <ChevronRight
+                      size={20}
+                      className="mx-2 flex-shrink-0"
+                      style={{ color: 'var(--color-accent)' }}
+                    />
+                  )}
+                </div>
+              );
+            })}
+          </div>
+        </div>
+      </section>
+
+      {/* Main Content */}
+      <section style={{ paddingBottom: 'var(--space-4xl)' }}>
+        <div className="container-custom">
+          <div className="grid grid-cols-1 lg:grid-cols-3 gap-6">
+            {/* Left Panel - State Space Model */}
+            <div className={currentStep === 'view-model' ? 'lg:col-span-3' : 'lg:col-span-1'}>
+                <StateSpaceModelViewer
+                  model={MOCK_STATE_SPACE_MODEL}
+                  onSelectVariable={handleSelectVariable}
+                  compact={currentStep !== 'view-model'}
+                />
+
+                {currentStep === 'view-model' && (
+                  <button
+                    onClick={nextStep}
+                    className="angular-clip-button w-full mt-4 px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+                    style={{
+                      background: 'var(--color-primary)',
+                      color: 'var(--color-secondary)',
+                      border: '2px solid var(--color-secondary)',
+                      fontSize: 'var(--font-size-body-sm)',
+                      fontWeight: 'var(--font-weight-bold)'
+                    }}
+                  >
+                    Continue to HookSpec Editor
+                  </button>
+                )}
+              </div>
+
+            {/* Right Panel - Editor/Validation/Submission */}
+            {currentStep !== 'view-model' && (
+              <div className="lg:col-span-2 space-y-6">
+                {(currentStep === 'edit-spec' || currentStep === 'validate') && (
+                  <HookSpecEditor
+                    initialSpec={hookSpec || undefined}
+                    stateSpaceModel={MOCK_STATE_SPACE_MODEL}
+                    onChange={handleSpecChange}
+                    onValidate={handleValidate}
+                    isValidating={isValidating}
+                  />
+                )}
+
+                {currentStep === 'validate' && (
+                  <>
+                    <ValidationResults
+                      results={validationResults}
+                      isLoading={isValidating}
+                    />
+
+                    {validationPassed && (
+                      <button
+                        onClick={() => setCurrentStep('submit')}
+                        className="angular-clip-button w-full px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+                        style={{
+                          background: 'var(--color-primary)',
+                          color: 'var(--color-secondary)',
+                          border: '2px solid var(--color-secondary)',
+                          fontSize: 'var(--font-size-body-sm)',
+                          fontWeight: 'var(--font-weight-bold)'
+                        }}
+                      >
+                        Continue to Submission
+                      </button>
+                    )}
+                  </>
+                )}
+
+                {currentStep === 'submit' && hookSpec && (
+                  <>
+                    <SubmissionFlow
+                      hookSpec={hookSpec}
+                      validationPassed={validationPassed}
+                      onSubmit={handleSubmit}
+                      walletConnected={walletConnected}
+                      walletAddress={walletAddress}
+                      onConnectWallet={handleConnectWallet}
+                    />
+
+                    {submissionResult && submissionResult.success && (
+                      <button
+                        onClick={handleContinueToVerification}
+                        className="angular-clip-button w-full px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+                        style={{
+                          background: 'var(--color-primary)',
+                          color: 'var(--color-secondary)',
+                          border: '2px solid var(--color-secondary)',
+                          fontSize: 'var(--font-size-body-sm)',
+                          fontWeight: 'var(--font-weight-bold)'
+                        }}
+                      >
+                        Continue to Code Verification
+                      </button>
+                    )}
+                  </>
+                )}
+              </div>
+            )}
+          </div>
+        </div>
+      </section>
+
+      <Footer onNavigate={handleNavigate} />
+    </div>
+  );
+}
diff --git a/client2/src/components/hook/HookSpecEditor.tsx b/client2/src/components/hook/HookSpecEditor.tsx
new file mode 100644
index 000000000..a3cac51e4
--- /dev/null
+++ b/client2/src/components/hook/HookSpecEditor.tsx
@@ -0,0 +1,898 @@
+import { useState, useCallback } from 'react';
+import { Upload, FileText, AlertCircle, CheckCircle, Info, Eye } from 'lucide-react';
+import type { HookSpec, StateSpaceModel, HookCallback } from '../../types/hookSpec';
+import LatexRenderer from '../common/LatexRenderer';
+
+interface HookSpecEditorProps {
+  initialSpec?: HookSpec;
+  stateSpaceModel: StateSpaceModel;
+  onChange: (spec: HookSpec) => void;
+  onValidate: () => void;
+  isValidating?: boolean;
+}
+
+const VALID_CALLBACKS: HookCallback[] = [
+  'beforeInitialize', 'afterInitialize',
+  'beforeAddLiquidity', 'afterAddLiquidity',
+  'beforeRemoveLiquidity', 'afterRemoveLiquidity',
+  'beforeSwap', 'afterSwap',
+  'beforeDonate', 'afterDonate'
+];
+
+const SOLIDITY_TYPES = [
+  'uint8', 'uint16', 'uint24', 'uint32', 'uint64', 'uint128', 'uint256',
+  'int8', 'int16', 'int24', 'int32', 'int64', 'int128', 'int256',
+  'address', 'bool', 'bytes32'
+];
+
+const DEFAULT_SPEC: HookSpec = {
+  metadata: {
+    name: '',
+    version: '1.0.0',
+    author: '',
+    description: '',
+    license: 'MIT'
+  },
+  hook_state: [],
+  system_functions: [],
+  invariants: []
+};
+
+export default function HookSpecEditor({
+  initialSpec,
+  stateSpaceModel,
+  onChange,
+  onValidate,
+  isValidating = false
+}: HookSpecEditorProps) {
+  const [spec, setSpec] = useState<HookSpec>(initialSpec || DEFAULT_SPEC);
+  const [activeTab, setActiveTab] = useState<'metadata' | 'state' | 'functions' | 'invariants'>('metadata');
+  const [uploadError, setUploadError] = useState<string | null>(null);
+
+  // Get all available state variables for autocomplete
+  const availableStateVars = [
+    ...stateSpaceModel.indices.lp.map(v => v.name),
+    ...stateSpaceModel.indices.trader.map(v => v.name),
+    ...stateSpaceModel.indices.shared.map(v => v.name)
+  ];
+
+  const updateSpec = useCallback((updates: Partial<HookSpec>) => {
+    const newSpec = { ...spec, ...updates };
+    setSpec(newSpec);
+    onChange(newSpec);
+  }, [spec, onChange]);
+
+  const handleFileUpload = async (event: React.ChangeEvent<HTMLInputElement>) => {
+    const file = event.target.files?.[0];
+    if (!file) return;
+
+    setUploadError(null);
+
+    try {
+      // Handle PDF files
+      if (file.name.endsWith('.pdf')) {
+        // For PDF, we can't parse it directly in browser without a library
+        // Inform user that PDF upload will store reference for manual processing
+        setUploadError(
+          'PDF files are accepted for reference. The PDF will be stored alongside your HookSpec. ' +
+          'Please also fill in the form fields below to create the machine-readable specification.'
+        );
+        // Store PDF reference in metadata
+        const pdfUrl = URL.createObjectURL(file);
+        updateSpec({
+          metadata: {
+            ...spec.metadata,
+            description: `${spec.metadata.description || ''}\n\n[Uploaded PDF: ${file.name}]`.trim(),
+            attachments: [{ type: 'pdf', name: file.name, url: pdfUrl }]
+          }
+        });
+        return;
+      }
+
+      const content = await file.text();
+      let parsed: HookSpec;
+
+      if (file.name.endsWith('.json')) {
+        parsed = JSON.parse(content);
+      } else if (file.name.endsWith('.yaml') || file.name.endsWith('.yml')) {
+        // Simple YAML parsing (in production, use a proper YAML library)
+        setUploadError('YAML parsing requires a YAML library. Please use JSON format.');
+        return;
+      } else {
+        setUploadError('Unsupported file format. Supported formats: .json, .yaml, .yml, .pdf');
+        return;
+      }
+
+      // Basic validation
+      if (!parsed.metadata?.name || !parsed.metadata?.version) {
+        setUploadError('Invalid HookSpec: missing required metadata fields');
+        return;
+      }
+
+      setSpec(parsed);
+      onChange(parsed);
+    } catch (error) {
+      setUploadError(`Failed to parse file: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+  };
+
+  const addHookStateVariable = () => {
+    updateSpec({
+      hook_state: [
+        ...spec.hook_state,
+        { name: '', symbol: '', type: 'uint256', description: '' }
+      ]
+    });
+  };
+
+  const removeHookStateVariable = (index: number) => {
+    updateSpec({
+      hook_state: spec.hook_state.filter((_, i) => i !== index)
+    });
+  };
+
+  const updateHookStateVariable = (index: number, field: string, value: string) => {
+    const newState = [...spec.hook_state];
+    newState[index] = { ...newState[index], [field]: value };
+    updateSpec({ hook_state: newState });
+  };
+
+  const addSystemFunction = () => {
+    updateSpec({
+      system_functions: [
+        ...spec.system_functions,
+        {
+          callback: 'afterSwap',
+          reads: [],
+          writes: [],
+          transition: {
+            preconditions: [],
+            equation: '',
+            postconditions: []
+          }
+        }
+      ]
+    });
+  };
+
+  const removeSystemFunction = (index: number) => {
+    updateSpec({
+      system_functions: spec.system_functions.filter((_, i) => i !== index)
+    });
+  };
+
+  const addInvariant = () => {
+    updateSpec({
+      invariants: [
+        ...(spec.invariants || []),
+        { name: '', expression: '', description: '' }
+      ]
+    });
+  };
+
+  const removeInvariant = (index: number) => {
+    updateSpec({
+      invariants: (spec.invariants || []).filter((_, i) => i !== index)
+    });
+  };
+
+  return (
+    <div
+      className="angular-clip"
+      style={{
+        background: 'var(--color-white)',
+        border: '2px solid var(--color-secondary)',
+        padding: 'var(--space-lg)'
+      }}
+    >
+      {/* Header */}
+      <div className="flex flex-col md:flex-row md:items-center md:justify-between gap-4 mb-6">
+        <div>
+          <h3
+            className="font-heading mb-1"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-h4)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            HookSpec Editor
+          </h3>
+          <p
+            className="font-body"
+            style={{
+              color: 'var(--color-black)',
+              fontSize: 'var(--font-size-body-sm)'
+            }}
+          >
+            Define your hook's state variables and system functions
+          </p>
+        </div>
+
+        {/* Upload Button */}
+        <label
+          className="angular-clip-button px-4 py-2 font-heading uppercase tracking-wider transition-all duration-200 cursor-pointer flex items-center gap-2"
+          style={{
+            background: 'transparent',
+            color: 'var(--color-secondary)',
+            border: '2px solid var(--color-secondary)',
+            fontSize: 'var(--font-size-caption)',
+            fontWeight: 'var(--font-weight-bold)'
+          }}
+        >
+          <Upload size={16} />
+          Upload File
+          <input
+            type="file"
+            accept=".json,.yaml,.yml,.pdf,application/pdf,application/json"
+            onChange={handleFileUpload}
+            className="hidden"
+          />
+        </label>
+      </div>
+
+      {/* Upload Error */}
+      {uploadError && (
+        <div
+          className="angular-clip p-3 mb-4 flex items-center gap-2"
+          style={{
+            background: 'rgba(232, 90, 79, 0.1)',
+            border: '1px solid var(--color-accent)'
+          }}
+        >
+          <AlertCircle size={18} style={{ color: 'var(--color-accent)' }} />
+          <span
+            className="font-body"
+            style={{
+              color: 'var(--color-accent)',
+              fontSize: 'var(--font-size-body-sm)'
+            }}
+          >
+            {uploadError}
+          </span>
+        </div>
+      )}
+
+      {/* Tabs */}
+      <div className="flex gap-2 mb-6 border-b-2" style={{ borderColor: 'var(--color-secondary)' }}>
+        {(['metadata', 'state', 'functions', 'invariants'] as const).map(tab => (
+          <button
+            key={tab}
+            onClick={() => setActiveTab(tab)}
+            className="px-4 py-2 font-heading uppercase tracking-wider transition-colors"
+            style={{
+              background: activeTab === tab ? 'var(--color-primary)' : 'transparent',
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-caption)',
+              fontWeight: 'var(--font-weight-bold)',
+              borderBottom: activeTab === tab ? '2px solid var(--color-secondary)' : 'none',
+              marginBottom: '-2px'
+            }}
+          >
+            {tab === 'state' ? 'Hook State' : tab === 'functions' ? 'Functions' : tab}
+          </button>
+        ))}
+      </div>
+
+      {/* Metadata Tab */}
+      {activeTab === 'metadata' && (
+        <div className="space-y-4">
+          <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+            <div>
+              <label
+                className="block font-heading mb-2"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Hook Name *
+              </label>
+              <input
+                type="text"
+                value={spec.metadata.name}
+                onChange={e => updateSpec({
+                  metadata: { ...spec.metadata, name: e.target.value }
+                })}
+                placeholder="e.g., DynamicFeeHook"
+                className="angular-clip w-full px-3 py-2 font-body"
+                style={{
+                  background: 'var(--color-marble-light)',
+                  border: '2px solid var(--color-secondary)',
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              />
+            </div>
+
+            <div>
+              <label
+                className="block font-heading mb-2"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Version *
+              </label>
+              <input
+                type="text"
+                value={spec.metadata.version}
+                onChange={e => updateSpec({
+                  metadata: { ...spec.metadata, version: e.target.value }
+                })}
+                placeholder="1.0.0"
+                className="angular-clip w-full px-3 py-2 font-body"
+                style={{
+                  background: 'var(--color-marble-light)',
+                  border: '2px solid var(--color-secondary)',
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              />
+            </div>
+
+            <div>
+              <label
+                className="block font-heading mb-2"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Author (Address) *
+              </label>
+              <input
+                type="text"
+                value={spec.metadata.author}
+                onChange={e => updateSpec({
+                  metadata: { ...spec.metadata, author: e.target.value }
+                })}
+                placeholder="0x..."
+                className="angular-clip w-full px-3 py-2 font-mono"
+                style={{
+                  background: 'var(--color-marble-light)',
+                  border: '2px solid var(--color-secondary)',
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              />
+            </div>
+
+            <div>
+              <label
+                className="block font-heading mb-2"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                License
+              </label>
+              <select
+                value={spec.metadata.license || 'MIT'}
+                onChange={e => updateSpec({
+                  metadata: { ...spec.metadata, license: e.target.value as any }
+                })}
+                className="angular-clip w-full px-3 py-2 font-body"
+                style={{
+                  background: 'var(--color-marble-light)',
+                  border: '2px solid var(--color-secondary)',
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              >
+                <option value="MIT">MIT</option>
+                <option value="GPL-3.0">GPL-3.0</option>
+                <option value="BUSL-1.1">BUSL-1.1</option>
+                <option value="PROPRIETARY">Proprietary</option>
+              </select>
+            </div>
+          </div>
+
+          <div>
+            <label
+              className="block font-heading mb-2"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Description
+            </label>
+            <textarea
+              value={spec.metadata.description || ''}
+              onChange={e => updateSpec({
+                metadata: { ...spec.metadata, description: e.target.value }
+              })}
+              placeholder="Describe what your hook does..."
+              rows={3}
+              className="angular-clip w-full px-3 py-2 font-body resize-none"
+              style={{
+                background: 'var(--color-marble-light)',
+                border: '2px solid var(--color-secondary)',
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)'
+              }}
+            />
+          </div>
+        </div>
+      )}
+
+      {/* Hook State Tab */}
+      {activeTab === 'state' && (
+        <div className="space-y-4">
+          <div
+            className="angular-clip p-3 flex items-start gap-2"
+            style={{
+              background: 'rgba(255, 215, 0, 0.1)',
+              border: '1px solid var(--color-primary)'
+            }}
+          >
+            <Info size={18} style={{ color: 'var(--color-primary)', flexShrink: 0, marginTop: 2 }} />
+            <span
+              className="font-body"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)'
+              }}
+            >
+              Define custom state variables that your hook will maintain. These are separate from pool state variables.
+            </span>
+          </div>
+
+          {spec.hook_state.map((variable, index) => (
+            <div
+              key={index}
+              className="angular-clip p-4"
+              style={{
+                background: 'var(--color-marble-light)',
+                border: '1px solid var(--color-accent)'
+              }}
+            >
+              <div className="flex justify-between items-start mb-3">
+                <span
+                  className="font-heading"
+                  style={{
+                    color: 'var(--color-accent)',
+                    fontSize: 'var(--font-size-caption)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  Variable {index + 1}
+                </span>
+                <button
+                  onClick={() => removeHookStateVariable(index)}
+                  className="text-red-500 hover:text-red-700 font-heading text-sm"
+                >
+                  Remove
+                </button>
+              </div>
+
+              <div className="grid grid-cols-1 md:grid-cols-4 gap-3">
+                <input
+                  type="text"
+                  value={variable.name}
+                  onChange={e => updateHookStateVariable(index, 'name', e.target.value)}
+                  placeholder="variable_name"
+                  className="angular-clip px-3 py-2 font-mono"
+                  style={{
+                    background: 'var(--color-white)',
+                    border: '1px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)'
+                  }}
+                />
+                <input
+                  type="text"
+                  value={variable.symbol}
+                  onChange={e => updateHookStateVariable(index, 'symbol', e.target.value)}
+                  placeholder="F_acc"
+                  className="angular-clip px-3 py-2 font-mono"
+                  style={{
+                    background: 'var(--color-white)',
+                    border: '1px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)'
+                  }}
+                />
+                <select
+                  value={variable.type}
+                  onChange={e => updateHookStateVariable(index, 'type', e.target.value)}
+                  className="angular-clip px-3 py-2 font-mono"
+                  style={{
+                    background: 'var(--color-white)',
+                    border: '1px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)'
+                  }}
+                >
+                  {SOLIDITY_TYPES.map(type => (
+                    <option key={type} value={type}>{type}</option>
+                  ))}
+                </select>
+                <input
+                  type="text"
+                  value={variable.description || ''}
+                  onChange={e => updateHookStateVariable(index, 'description', e.target.value)}
+                  placeholder="Description"
+                  className="angular-clip px-3 py-2 font-body"
+                  style={{
+                    background: 'var(--color-white)',
+                    border: '1px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)'
+                  }}
+                />
+              </div>
+            </div>
+          ))}
+
+          <button
+            onClick={addHookStateVariable}
+            className="angular-clip-button w-full px-4 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+            style={{
+              background: 'transparent',
+              color: 'var(--color-secondary)',
+              border: '2px dashed var(--color-secondary)',
+              fontSize: 'var(--font-size-caption)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            + Add State Variable
+          </button>
+        </div>
+      )}
+
+      {/* Functions Tab */}
+      {activeTab === 'functions' && (
+        <div className="space-y-4">
+          <div
+            className="angular-clip p-3 flex items-start gap-2"
+            style={{
+              background: 'rgba(255, 215, 0, 0.1)',
+              border: '1px solid var(--color-primary)'
+            }}
+          >
+            <Info size={18} style={{ color: 'var(--color-primary)', flexShrink: 0, marginTop: 2 }} />
+            <span
+              className="font-body"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)'
+              }}
+            >
+              Define which callbacks your hook implements and how they affect state. Reference pool variables from the State Space Model.
+            </span>
+          </div>
+
+          {spec.system_functions.map((func, index) => (
+            <div
+              key={index}
+              className="angular-clip p-4"
+              style={{
+                background: 'var(--color-marble-light)',
+                border: '1px solid var(--color-accent)'
+              }}
+            >
+              <div className="flex justify-between items-start mb-3">
+                <span
+                  className="font-heading"
+                  style={{
+                    color: 'var(--color-accent)',
+                    fontSize: 'var(--font-size-caption)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  Function {index + 1}
+                </span>
+                <button
+                  onClick={() => removeSystemFunction(index)}
+                  className="text-red-500 hover:text-red-700 font-heading text-sm"
+                >
+                  Remove
+                </button>
+              </div>
+
+              <div className="space-y-3">
+                <div>
+                  <label className="block font-heading mb-1" style={{ color: 'var(--color-secondary)', fontSize: 'var(--font-size-caption)' }}>
+                    Callback
+                  </label>
+                  <select
+                    value={func.callback}
+                    onChange={e => {
+                      const newFuncs = [...spec.system_functions];
+                      newFuncs[index] = { ...newFuncs[index], callback: e.target.value as HookCallback };
+                      updateSpec({ system_functions: newFuncs });
+                    }}
+                    className="angular-clip w-full px-3 py-2 font-mono"
+                    style={{
+                      background: 'var(--color-white)',
+                      border: '1px solid var(--color-secondary)',
+                      color: 'var(--color-secondary)',
+                      fontSize: 'var(--font-size-caption)'
+                    }}
+                  >
+                    {VALID_CALLBACKS.map(cb => (
+                      <option key={cb} value={cb}>{cb}</option>
+                    ))}
+                  </select>
+                </div>
+
+                <div className="grid grid-cols-1 md:grid-cols-2 gap-3">
+                  <div>
+                    <label className="block font-heading mb-1" style={{ color: 'var(--color-secondary)', fontSize: 'var(--font-size-caption)' }}>
+                      Reads (pool state vars)
+                    </label>
+                    <input
+                      type="text"
+                      value={func.reads.join(', ')}
+                      onChange={e => {
+                        const newFuncs = [...spec.system_functions];
+                        newFuncs[index] = { ...newFuncs[index], reads: e.target.value.split(',').map(s => s.trim()).filter(Boolean) };
+                        updateSpec({ system_functions: newFuncs });
+                      }}
+                      placeholder="sqrt_price, active_liquidity"
+                      className="angular-clip w-full px-3 py-2 font-mono"
+                      style={{
+                        background: 'var(--color-white)',
+                        border: '1px solid var(--color-secondary)',
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-caption)'
+                      }}
+                    />
+                  </div>
+                  <div>
+                    <label className="block font-heading mb-1" style={{ color: 'var(--color-secondary)', fontSize: 'var(--font-size-caption)' }}>
+                      Writes (hook state vars)
+                    </label>
+                    <input
+                      type="text"
+                      value={func.writes.join(', ')}
+                      onChange={e => {
+                        const newFuncs = [...spec.system_functions];
+                        newFuncs[index] = { ...newFuncs[index], writes: e.target.value.split(',').map(s => s.trim()).filter(Boolean) };
+                        updateSpec({ system_functions: newFuncs });
+                      }}
+                      placeholder="accumulated_fees"
+                      className="angular-clip w-full px-3 py-2 font-mono"
+                      style={{
+                        background: 'var(--color-white)',
+                        border: '1px solid var(--color-secondary)',
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-caption)'
+                      }}
+                    />
+                  </div>
+                </div>
+
+                <div>
+                  <label className="block font-heading mb-1" style={{ color: 'var(--color-secondary)', fontSize: 'var(--font-size-caption)' }}>
+                    Transition Equation (LaTeX)
+                  </label>
+                  <textarea
+                    value={func.transition.equation}
+                    onChange={e => {
+                      const newFuncs = [...spec.system_functions];
+                      newFuncs[index] = {
+                        ...newFuncs[index],
+                        transition: { ...newFuncs[index].transition, equation: e.target.value }
+                      };
+                      updateSpec({ system_functions: newFuncs });
+                    }}
+                    placeholder="F_{acc}' = F_{acc} + |\Delta| \cdot \phi_{lp}"
+                    rows={2}
+                    className="angular-clip w-full px-3 py-2 font-mono resize-none"
+                    style={{
+                      background: 'var(--color-white)',
+                      border: '1px solid var(--color-secondary)',
+                      color: 'var(--color-secondary)',
+                      fontSize: 'var(--font-size-caption)'
+                    }}
+                  />
+                  {/* LaTeX Preview */}
+                  {func.transition.equation && (
+                    <div
+                      className="mt-2 p-3 angular-clip flex items-center gap-2"
+                      style={{
+                        background: 'var(--color-marble-light)',
+                        border: '1px dashed var(--color-accent)'
+                      }}
+                    >
+                      <Eye size={14} style={{ color: 'var(--color-accent)', flexShrink: 0 }} />
+                      <span
+                        className="font-heading mr-2"
+                        style={{
+                          color: 'var(--color-accent)',
+                          fontSize: 'var(--font-size-caption)',
+                          textTransform: 'uppercase'
+                        }}
+                      >
+                        Preview:
+                      </span>
+                      <div style={{ fontSize: 'var(--font-size-body)' }}>
+                        <LatexRenderer latex={func.transition.equation} displayMode={false} />
+                      </div>
+                    </div>
+                  )}
+                </div>
+              </div>
+            </div>
+          ))}
+
+          <button
+            onClick={addSystemFunction}
+            className="angular-clip-button w-full px-4 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+            style={{
+              background: 'transparent',
+              color: 'var(--color-secondary)',
+              border: '2px dashed var(--color-secondary)',
+              fontSize: 'var(--font-size-caption)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            + Add System Function
+          </button>
+        </div>
+      )}
+
+      {/* Invariants Tab */}
+      {activeTab === 'invariants' && (
+        <div className="space-y-4">
+          <div
+            className="angular-clip p-3 flex items-start gap-2"
+            style={{
+              background: 'rgba(255, 215, 0, 0.1)',
+              border: '1px solid var(--color-primary)'
+            }}
+          >
+            <Info size={18} style={{ color: 'var(--color-primary)', flexShrink: 0, marginTop: 2 }} />
+            <span
+              className="font-body"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)'
+              }}
+            >
+              Define constraints that must always hold for your hook's state.
+            </span>
+          </div>
+
+          {(spec.invariants || []).map((inv, index) => (
+            <div
+              key={index}
+              className="angular-clip p-4"
+              style={{
+                background: 'var(--color-marble-light)',
+                border: '1px solid var(--color-accent)'
+              }}
+            >
+              <div className="flex justify-between items-start mb-3">
+                <span
+                  className="font-heading"
+                  style={{
+                    color: 'var(--color-accent)',
+                    fontSize: 'var(--font-size-caption)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  Invariant {index + 1}
+                </span>
+                <button
+                  onClick={() => removeInvariant(index)}
+                  className="text-red-500 hover:text-red-700 font-heading text-sm"
+                >
+                  Remove
+                </button>
+              </div>
+
+              <div className="space-y-3">
+                <input
+                  type="text"
+                  value={inv.name}
+                  onChange={e => {
+                    const newInvs = [...(spec.invariants || [])];
+                    newInvs[index] = { ...newInvs[index], name: e.target.value };
+                    updateSpec({ invariants: newInvs });
+                  }}
+                  placeholder="invariant_name"
+                  className="angular-clip w-full px-3 py-2 font-mono"
+                  style={{
+                    background: 'var(--color-white)',
+                    border: '1px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)'
+                  }}
+                />
+                <input
+                  type="text"
+                  value={inv.expression}
+                  onChange={e => {
+                    const newInvs = [...(spec.invariants || [])];
+                    newInvs[index] = { ...newInvs[index], expression: e.target.value };
+                    updateSpec({ invariants: newInvs });
+                  }}
+                  placeholder="F_{acc} \geq 0"
+                  className="angular-clip w-full px-3 py-2 font-mono"
+                  style={{
+                    background: 'var(--color-white)',
+                    border: '1px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)'
+                  }}
+                />
+                <input
+                  type="text"
+                  value={inv.description || ''}
+                  onChange={e => {
+                    const newInvs = [...(spec.invariants || [])];
+                    newInvs[index] = { ...newInvs[index], description: e.target.value };
+                    updateSpec({ invariants: newInvs });
+                  }}
+                  placeholder="Description"
+                  className="angular-clip w-full px-3 py-2 font-body"
+                  style={{
+                    background: 'var(--color-white)',
+                    border: '1px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)'
+                  }}
+                />
+              </div>
+            </div>
+          ))}
+
+          <button
+            onClick={addInvariant}
+            className="angular-clip-button w-full px-4 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+            style={{
+              background: 'transparent',
+              color: 'var(--color-secondary)',
+              border: '2px dashed var(--color-secondary)',
+              fontSize: 'var(--font-size-caption)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            + Add Invariant
+          </button>
+        </div>
+      )}
+
+      {/* Validate Button */}
+      <div className="mt-6 pt-6" style={{ borderTop: '2px solid var(--color-secondary)' }}>
+        <button
+          onClick={onValidate}
+          disabled={isValidating || !spec.metadata.name || !spec.metadata.version}
+          className="angular-clip-button w-full px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200 flex items-center justify-center gap-2"
+          style={{
+            background: isValidating ? 'var(--color-accent)' : 'var(--color-primary)',
+            color: 'var(--color-secondary)',
+            border: '2px solid var(--color-secondary)',
+            fontSize: 'var(--font-size-body-sm)',
+            fontWeight: 'var(--font-weight-bold)',
+            opacity: (!spec.metadata.name || !spec.metadata.version) ? 0.5 : 1,
+            cursor: (!spec.metadata.name || !spec.metadata.version) ? 'not-allowed' : 'pointer'
+          }}
+        >
+          {isValidating ? (
+            <>
+              <div className="w-4 h-4 border-2 border-secondary border-t-transparent rounded-full animate-spin" />
+              Validating...
+            </>
+          ) : (
+            <>
+              <CheckCircle size={18} />
+              Validate HookSpec
+            </>
+          )}
+        </button>
+      </div>
+    </div>
+  );
+}
diff --git a/client2/src/components/hook/StateSpaceModelViewer.tsx b/client2/src/components/hook/StateSpaceModelViewer.tsx
new file mode 100644
index 000000000..c3dc138d8
--- /dev/null
+++ b/client2/src/components/hook/StateSpaceModelViewer.tsx
@@ -0,0 +1,510 @@
+import { useState, useMemo } from 'react';
+import { Search, Copy, Check, ChevronDown, ChevronRight, ExternalLink } from 'lucide-react';
+import type { StateSpaceModel, SystemStateVariable } from '../../types/hookSpec';
+import LatexRenderer from '../common/LatexRenderer';
+
+interface StateSpaceModelViewerProps {
+  model: StateSpaceModel;
+  onSelectVariable?: (variable: SystemStateVariable) => void;
+  compact?: boolean;
+}
+
+type IndexType = 'lp' | 'trader' | 'shared';
+
+interface SectionConfig {
+  key: IndexType;
+  title: string;
+  description: string;
+  symbol: string;
+}
+
+const SECTIONS: SectionConfig[] = [
+  {
+    key: 'lp',
+    title: 'LP Index Variables',
+    description: 'Variables accessed by liquidity providers (positions, ticks)',
+    symbol: 'S_{LP}'
+  },
+  {
+    key: 'trader',
+    title: 'Trader Index Variables',
+    description: 'Variables accessed by traders during swaps (slot0, liquidity)',
+    symbol: 'S_T'
+  },
+  {
+    key: 'shared',
+    title: 'Shared Variables',
+    description: 'Variables accessed by both LPs and traders (fee growth)',
+    symbol: 'S_{shared}'
+  }
+];
+
+export default function StateSpaceModelViewer({
+  model,
+  onSelectVariable,
+  compact = false
+}: StateSpaceModelViewerProps) {
+  const [searchQuery, setSearchQuery] = useState('');
+  const [expandedSections, setExpandedSections] = useState<Set<IndexType>>(
+    new Set(compact ? [] : ['lp', 'trader', 'shared'])
+  );
+  const [copiedSymbol, setCopiedSymbol] = useState<string | null>(null);
+
+  // Filter variables based on search
+  const filteredModel = useMemo(() => {
+    if (!searchQuery.trim()) return model.indices;
+
+    const query = searchQuery.toLowerCase();
+    const filterVars = (vars: SystemStateVariable[]) =>
+      vars.filter(
+        v =>
+          v.name.toLowerCase().includes(query) ||
+          v.symbol.toLowerCase().includes(query) ||
+          v.type.toLowerCase().includes(query) ||
+          v.description.toLowerCase().includes(query)
+      );
+
+    return {
+      lp: filterVars(model.indices.lp),
+      trader: filterVars(model.indices.trader),
+      shared: filterVars(model.indices.shared)
+    };
+  }, [model.indices, searchQuery]);
+
+  const toggleSection = (key: IndexType) => {
+    setExpandedSections(prev => {
+      const next = new Set(prev);
+      if (next.has(key)) {
+        next.delete(key);
+      } else {
+        next.add(key);
+      }
+      return next;
+    });
+  };
+
+  const copyToClipboard = async (text: string) => {
+    await navigator.clipboard.writeText(text);
+    setCopiedSymbol(text);
+    setTimeout(() => setCopiedSymbol(null), 2000);
+  };
+
+  const totalVariables =
+    model.indices.lp.length + model.indices.trader.length + model.indices.shared.length;
+
+  return (
+    <div
+      className="angular-clip"
+      style={{
+        background: 'var(--color-marble-light)',
+        border: '2px solid var(--color-secondary)',
+        padding: compact ? 'var(--space-md)' : 'var(--space-lg)',
+        maxHeight: compact ? '600px' : 'none',
+        overflow: compact ? 'auto' : 'visible',
+        display: 'flex',
+        flexDirection: 'column'
+      }}
+    >
+      {/* Header */}
+      <div className="flex flex-col md:flex-row md:items-center md:justify-between gap-4 mb-4 flex-shrink-0">
+        <div>
+          <h3
+            className="font-heading mb-1 flex items-center gap-2 flex-wrap"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: compact ? 'var(--font-size-body)' : 'var(--font-size-h4)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            System State Model
+            <span
+              className="angular-clip px-2 py-1"
+              style={{
+                background: 'var(--color-accent)',
+                color: 'var(--color-white)',
+                fontSize: 'var(--font-size-caption)',
+                fontWeight: 'var(--font-weight-medium)'
+              }}
+            >
+              READ ONLY
+            </span>
+          </h3>
+          <p
+            className="font-body"
+            style={{
+              color: 'var(--color-black)',
+              fontSize: 'var(--font-size-body-sm)'
+            }}
+          >
+            {totalVariables} state variables from IStateView (v{model.version})
+          </p>
+        </div>
+
+        {/* Search */}
+        <div className="relative flex-shrink-0">
+          <Search
+            size={18}
+            className="absolute left-3 top-1/2 -translate-y-1/2"
+            style={{ color: 'var(--color-accent)' }}
+          />
+          <input
+            type="text"
+            placeholder="Search variables..."
+            value={searchQuery}
+            onChange={e => setSearchQuery(e.target.value)}
+            className="angular-clip pl-10 pr-4 py-2 font-body w-full md:w-auto"
+            style={{
+              background: 'var(--color-white)',
+              border: '2px solid var(--color-secondary)',
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body-sm)',
+              minWidth: '200px'
+            }}
+          />
+        </div>
+      </div>
+
+      {/* IPFS Info */}
+      {!compact && (
+        <div
+          className="angular-clip p-3 mb-4 flex-shrink-0"
+          style={{
+            background: 'var(--color-white)',
+            border: '1px solid var(--color-accent)'
+          }}
+        >
+          <div className="flex items-center justify-between flex-wrap gap-2">
+            <div className="min-w-0 flex-1">
+              <span
+                className="font-heading"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                IPFS CID
+              </span>
+              <p
+                className="font-mono truncate"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              >
+                {model.ipfsCid}
+              </p>
+            </div>
+            <a
+              href={`https://ipfs.io/ipfs/${model.ipfsCid}`}
+              target="_blank"
+              rel="noopener noreferrer"
+              className="flex items-center gap-1 font-heading transition-colors flex-shrink-0"
+              style={{
+                color: 'var(--color-primary)',
+                fontSize: 'var(--font-size-caption)'
+              }}
+            >
+              View on IPFS
+              <ExternalLink size={14} />
+            </a>
+          </div>
+        </div>
+      )}
+
+      {/* Sections - scrollable area */}
+      <div
+        className="space-y-3 flex-1 min-h-0"
+        style={{
+          overflowY: compact ? 'auto' : 'visible'
+        }}
+      >
+        {SECTIONS.map(section => {
+          const variables = filteredModel[section.key];
+          const isExpanded = expandedSections.has(section.key);
+
+          return (
+            <div
+              key={section.key}
+              className="angular-clip"
+              style={{
+                background: 'var(--color-white)',
+                border: '2px solid var(--color-secondary)'
+              }}
+            >
+              {/* Section Header */}
+              <button
+                onClick={() => toggleSection(section.key)}
+                className="w-full p-3 flex items-center justify-between transition-colors"
+                style={{
+                  background: isExpanded ? 'var(--color-primary)' : 'transparent'
+                }}
+              >
+                <div className="flex items-center gap-2 min-w-0">
+                  {isExpanded ? (
+                    <ChevronDown
+                      size={18}
+                      style={{ color: 'var(--color-secondary)' }}
+                      className="flex-shrink-0"
+                    />
+                  ) : (
+                    <ChevronRight
+                      size={18}
+                      style={{ color: 'var(--color-secondary)' }}
+                      className="flex-shrink-0"
+                    />
+                  )}
+                  <div className="text-left min-w-0">
+                    <h4
+                      className="font-heading flex items-center gap-2 flex-wrap"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-body-sm)',
+                        fontWeight: 'var(--font-weight-bold)'
+                      }}
+                    >
+                      {section.title}
+                      <span
+                        className="inline-flex items-center"
+                        style={{
+                          color: 'var(--color-accent)',
+                          fontSize: 'var(--font-size-caption)'
+                        }}
+                      >
+                        (<LatexRenderer latex={section.symbol} />)
+                      </span>
+                    </h4>
+                    {!compact && (
+                      <p
+                        className="font-body"
+                        style={{
+                          color: 'var(--color-black)',
+                          fontSize: 'var(--font-size-caption)'
+                        }}
+                      >
+                        {section.description}
+                      </p>
+                    )}
+                  </div>
+                </div>
+                <span
+                  className="angular-clip px-2 py-1 font-heading flex-shrink-0"
+                  style={{
+                    background: 'var(--color-secondary)',
+                    color: 'var(--color-primary)',
+                    fontSize: 'var(--font-size-caption)',
+                    fontWeight: 'var(--font-weight-bold)'
+                  }}
+                >
+                  {variables.length}
+                </span>
+              </button>
+
+              {/* Section Content */}
+              {isExpanded && variables.length > 0 && (
+                <div className="p-3 pt-0">
+                  <div className="overflow-x-auto">
+                    <table className="w-full" style={{ minWidth: '500px' }}>
+                      <thead>
+                        <tr
+                          style={{
+                            borderBottom: '2px solid var(--color-secondary)'
+                          }}
+                        >
+                          <th
+                            className="text-left py-2 px-2 font-heading"
+                            style={{
+                              color: 'var(--color-secondary)',
+                              fontSize: 'var(--font-size-caption)',
+                              textTransform: 'uppercase',
+                              width: '30%'
+                            }}
+                          >
+                            Variable
+                          </th>
+                          <th
+                            className="text-left py-2 px-2 font-heading"
+                            style={{
+                              color: 'var(--color-secondary)',
+                              fontSize: 'var(--font-size-caption)',
+                              textTransform: 'uppercase',
+                              width: '20%'
+                            }}
+                          >
+                            Symbol
+                          </th>
+                          <th
+                            className="text-left py-2 px-2 font-heading"
+                            style={{
+                              color: 'var(--color-secondary)',
+                              fontSize: 'var(--font-size-caption)',
+                              textTransform: 'uppercase',
+                              width: '15%'
+                            }}
+                          >
+                            Type
+                          </th>
+                          <th
+                            className="text-left py-2 px-2 font-heading"
+                            style={{
+                              color: 'var(--color-secondary)',
+                              fontSize: 'var(--font-size-caption)',
+                              textTransform: 'uppercase',
+                              width: '35%'
+                            }}
+                          >
+                            Getter
+                          </th>
+                        </tr>
+                      </thead>
+                      <tbody>
+                        {variables.map((variable, idx) => (
+                          <tr
+                            key={variable.name}
+                            className="transition-colors cursor-pointer"
+                            style={{
+                              borderBottom:
+                                idx < variables.length - 1
+                                  ? '1px solid var(--color-accent)'
+                                  : 'none'
+                            }}
+                            onClick={() => onSelectVariable?.(variable)}
+                            onMouseEnter={e => {
+                              e.currentTarget.style.background =
+                                'var(--color-marble-light)';
+                            }}
+                            onMouseLeave={e => {
+                              e.currentTarget.style.background = 'transparent';
+                            }}
+                          >
+                            <td className="py-2 px-2">
+                              <div>
+                                <span
+                                  className="font-heading"
+                                  style={{
+                                    color: 'var(--color-secondary)',
+                                    fontSize: 'var(--font-size-caption)',
+                                    fontWeight: 'var(--font-weight-medium)'
+                                  }}
+                                >
+                                  {variable.name}
+                                </span>
+                                <p
+                                  className="font-body mt-1"
+                                  style={{
+                                    color: 'var(--color-accent)',
+                                    fontSize: '11px',
+                                    lineHeight: 1.3
+                                  }}
+                                >
+                                  {variable.description}
+                                </p>
+                              </div>
+                            </td>
+                            <td className="py-2 px-2">
+                              <div className="flex items-center gap-1">
+                                <code
+                                  className="angular-clip px-2 py-1 inline-flex items-center"
+                                  style={{
+                                    background: 'var(--color-marble-light)',
+                                    color: 'var(--color-primary)',
+                                    fontSize: 'var(--font-size-caption)',
+                                    border: '1px solid var(--color-primary)'
+                                  }}
+                                >
+                                  <LatexRenderer latex={variable.symbol} />
+                                </code>
+                                <button
+                                  onClick={e => {
+                                    e.stopPropagation();
+                                    copyToClipboard(variable.symbol);
+                                  }}
+                                  className="p-1 transition-colors flex-shrink-0"
+                                  title="Copy symbol"
+                                >
+                                  {copiedSymbol === variable.symbol ? (
+                                    <Check
+                                      size={12}
+                                      style={{ color: 'var(--color-primary)' }}
+                                    />
+                                  ) : (
+                                    <Copy
+                                      size={12}
+                                      style={{ color: 'var(--color-accent)' }}
+                                    />
+                                  )}
+                                </button>
+                              </div>
+                            </td>
+                            <td className="py-2 px-2">
+                              <code
+                                className="font-mono"
+                                style={{
+                                  color: 'var(--color-accent)',
+                                  fontSize: '11px'
+                                }}
+                              >
+                                {variable.type}
+                              </code>
+                            </td>
+                            <td className="py-2 px-2">
+                              <code
+                                className="font-mono break-all"
+                                style={{
+                                  color: 'var(--color-black)',
+                                  fontSize: '11px',
+                                  wordBreak: 'break-word'
+                                }}
+                              >
+                                {variable.getter}
+                              </code>
+                            </td>
+                          </tr>
+                        ))}
+                      </tbody>
+                    </table>
+                  </div>
+                </div>
+              )}
+
+              {/* Empty state */}
+              {isExpanded && variables.length === 0 && (
+                <div className="p-4 text-center">
+                  <p
+                    className="font-body"
+                    style={{
+                      color: 'var(--color-accent)',
+                      fontSize: 'var(--font-size-body-sm)'
+                    }}
+                  >
+                    No variables match your search
+                  </p>
+                </div>
+              )}
+            </div>
+          );
+        })}
+      </div>
+
+      {/* IStateView Link */}
+      {!compact && (
+        <div className="mt-4 text-center flex-shrink-0">
+          <a
+            href="https://github.com/Uniswap/v4-periphery/blob/main/src/interfaces/IStateView.sol"
+            target="_blank"
+            rel="noopener noreferrer"
+            className="inline-flex items-center gap-2 font-heading transition-colors"
+            style={{
+              color: 'var(--color-primary)',
+              fontSize: 'var(--font-size-body-sm)',
+              fontWeight: 'var(--font-weight-medium)'
+            }}
+          >
+            View IStateView Source Code
+            <ExternalLink size={16} />
+          </a>
+        </div>
+      )}
+    </div>
+  );
+}
diff --git a/client2/src/components/hook/SubmissionFlow.tsx b/client2/src/components/hook/SubmissionFlow.tsx
new file mode 100644
index 000000000..2eb8f37e9
--- /dev/null
+++ b/client2/src/components/hook/SubmissionFlow.tsx
@@ -0,0 +1,683 @@
+import { useState } from 'react';
+import {
+  Upload,
+  CheckCircle,
+  XCircle,
+  ExternalLink,
+  Loader2,
+  Wallet,
+  FileText,
+  Award
+} from 'lucide-react';
+import type { HookSpec, SubmissionResult } from '../../types/hookSpec';
+
+interface SubmissionFlowProps {
+  hookSpec: HookSpec;
+  validationPassed: boolean;
+  onSubmit: () => Promise<SubmissionResult>;
+  walletConnected: boolean;
+  walletAddress?: string;
+  onConnectWallet: () => void;
+}
+
+type SubmissionStep = 'idle' | 'signing' | 'uploading' | 'minting' | 'complete' | 'error';
+
+interface StepConfig {
+  id: SubmissionStep;
+  title: string;
+  description: string;
+  icon: React.ReactNode;
+}
+
+const STEPS: StepConfig[] = [
+  {
+    id: 'signing',
+    title: 'Sign Message',
+    description: 'Confirm your intent to register this HookSpec',
+    icon: <Wallet size={24} />
+  },
+  {
+    id: 'uploading',
+    title: 'Upload to IPFS',
+    description: 'Storing your specification on decentralized storage',
+    icon: <Upload size={24} />
+  },
+  {
+    id: 'minting',
+    title: 'Mint License',
+    description: 'Creating your HookLicense NFT',
+    icon: <Award size={24} />
+  }
+];
+
+export default function SubmissionFlow({
+  hookSpec,
+  validationPassed,
+  onSubmit,
+  walletConnected,
+  walletAddress,
+  onConnectWallet
+}: SubmissionFlowProps) {
+  const [currentStep, setCurrentStep] = useState<SubmissionStep>('idle');
+  const [result, setResult] = useState<SubmissionResult | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  const handleSubmit = async () => {
+    setError(null);
+
+    try {
+      // Step 1: Signing
+      setCurrentStep('signing');
+      await new Promise(resolve => setTimeout(resolve, 1500)); // Simulate signing
+
+      // Step 2: Uploading
+      setCurrentStep('uploading');
+      await new Promise(resolve => setTimeout(resolve, 2000)); // Simulate upload
+
+      // Step 3: Minting
+      setCurrentStep('minting');
+
+      // Actually call the submit function
+      const submissionResult = await onSubmit();
+
+      setResult(submissionResult);
+      setCurrentStep('complete');
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Submission failed');
+      setCurrentStep('error');
+    }
+  };
+
+  const resetFlow = () => {
+    setCurrentStep('idle');
+    setResult(null);
+    setError(null);
+  };
+
+  const getStepStatus = (stepId: SubmissionStep): 'pending' | 'active' | 'complete' => {
+    const stepOrder: SubmissionStep[] = ['signing', 'uploading', 'minting'];
+    const currentIndex = stepOrder.indexOf(currentStep);
+    const stepIndex = stepOrder.indexOf(stepId);
+
+    if (currentStep === 'complete') return 'complete';
+    if (stepIndex < currentIndex) return 'complete';
+    if (stepIndex === currentIndex) return 'active';
+    return 'pending';
+  };
+
+  // Idle state - show submit button
+  if (currentStep === 'idle') {
+    return (
+      <div
+        className="angular-clip p-6"
+        style={{
+          background: 'var(--color-white)',
+          border: '2px solid var(--color-secondary)'
+        }}
+      >
+        <h3
+          className="font-heading mb-4"
+          style={{
+            color: 'var(--color-secondary)',
+            fontSize: 'var(--font-size-h4)',
+            fontWeight: 'var(--font-weight-bold)'
+          }}
+        >
+          Submit HookSpec
+        </h3>
+
+        {!walletConnected ? (
+          <div className="text-center py-6">
+            <Wallet size={48} style={{ color: 'var(--color-accent)', margin: '0 auto' }} />
+            <p
+              className="font-body mt-4 mb-6"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body)'
+              }}
+            >
+              Connect your wallet to submit your HookSpec
+            </p>
+            <button
+              onClick={onConnectWallet}
+              className="angular-clip-button px-6 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+              style={{
+                background: 'var(--color-primary)',
+                color: 'var(--color-secondary)',
+                border: '2px solid var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)',
+                fontWeight: 'var(--font-weight-bold)'
+              }}
+            >
+              Connect Wallet
+            </button>
+          </div>
+        ) : !validationPassed ? (
+          <div
+            className="angular-clip p-4 flex items-center gap-3"
+            style={{
+              background: 'rgba(232, 90, 79, 0.1)',
+              border: '1px solid var(--color-accent)'
+            }}
+          >
+            <XCircle size={24} style={{ color: 'var(--color-accent)' }} />
+            <div>
+              <p
+                className="font-heading"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-body)',
+                  fontWeight: 'var(--font-weight-medium)'
+                }}
+              >
+                Validation Required
+              </p>
+              <p
+                className="font-body"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              >
+                Your HookSpec must pass validation before submission
+              </p>
+            </div>
+          </div>
+        ) : (
+          <>
+            {/* Summary */}
+            <div
+              className="angular-clip p-4 mb-6"
+              style={{
+                background: 'var(--color-marble-light)',
+                border: '1px solid var(--color-accent)'
+              }}
+            >
+              <div className="flex items-start gap-3">
+                <FileText size={24} style={{ color: 'var(--color-primary)' }} />
+                <div className="flex-1">
+                  <h4
+                    className="font-heading"
+                    style={{
+                      color: 'var(--color-secondary)',
+                      fontSize: 'var(--font-size-body)',
+                      fontWeight: 'var(--font-weight-bold)'
+                    }}
+                  >
+                    {hookSpec.metadata.name}
+                  </h4>
+                  <p
+                    className="font-mono"
+                    style={{
+                      color: 'var(--color-accent)',
+                      fontSize: 'var(--font-size-caption)'
+                    }}
+                  >
+                    v{hookSpec.metadata.version}
+                  </p>
+                  {hookSpec.metadata.description && (
+                    <p
+                      className="font-body mt-2"
+                      style={{
+                        color: 'var(--color-black)',
+                        fontSize: 'var(--font-size-body-sm)'
+                      }}
+                    >
+                      {hookSpec.metadata.description}
+                    </p>
+                  )}
+                </div>
+              </div>
+
+              <div className="mt-4 pt-4 grid grid-cols-3 gap-4" style={{ borderTop: '1px solid var(--color-accent)' }}>
+                <div>
+                  <span
+                    className="font-heading"
+                    style={{
+                      color: 'var(--color-accent)',
+                      fontSize: 'var(--font-size-caption)',
+                      textTransform: 'uppercase'
+                    }}
+                  >
+                    State Vars
+                  </span>
+                  <p
+                    className="font-heading mt-1"
+                    style={{
+                      color: 'var(--color-secondary)',
+                      fontSize: 'var(--font-size-h5)',
+                      fontWeight: 'var(--font-weight-bold)'
+                    }}
+                  >
+                    {hookSpec.hook_state.length}
+                  </p>
+                </div>
+                <div>
+                  <span
+                    className="font-heading"
+                    style={{
+                      color: 'var(--color-accent)',
+                      fontSize: 'var(--font-size-caption)',
+                      textTransform: 'uppercase'
+                    }}
+                  >
+                    Functions
+                  </span>
+                  <p
+                    className="font-heading mt-1"
+                    style={{
+                      color: 'var(--color-secondary)',
+                      fontSize: 'var(--font-size-h5)',
+                      fontWeight: 'var(--font-weight-bold)'
+                    }}
+                  >
+                    {hookSpec.system_functions.length}
+                  </p>
+                </div>
+                <div>
+                  <span
+                    className="font-heading"
+                    style={{
+                      color: 'var(--color-accent)',
+                      fontSize: 'var(--font-size-caption)',
+                      textTransform: 'uppercase'
+                    }}
+                  >
+                    Invariants
+                  </span>
+                  <p
+                    className="font-heading mt-1"
+                    style={{
+                      color: 'var(--color-secondary)',
+                      fontSize: 'var(--font-size-h5)',
+                      fontWeight: 'var(--font-weight-bold)'
+                    }}
+                  >
+                    {hookSpec.invariants?.length || 0}
+                  </p>
+                </div>
+              </div>
+            </div>
+
+            {/* Connected Wallet */}
+            <div
+              className="angular-clip p-3 mb-6 flex items-center justify-between"
+              style={{
+                background: 'rgba(255, 215, 0, 0.1)',
+                border: '1px solid var(--color-primary)'
+              }}
+            >
+              <div className="flex items-center gap-2">
+                <Wallet size={18} style={{ color: 'var(--color-primary)' }} />
+                <span
+                  className="font-body"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-body-sm)'
+                  }}
+                >
+                  Connected:
+                </span>
+                <code
+                  className="font-mono"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)'
+                  }}
+                >
+                  {walletAddress?.slice(0, 6)}...{walletAddress?.slice(-4)}
+                </code>
+              </div>
+              <CheckCircle size={18} style={{ color: 'var(--color-primary)' }} />
+            </div>
+
+            {/* Submit Button */}
+            <button
+              onClick={handleSubmit}
+              className="angular-clip-button w-full px-6 py-4 font-heading uppercase tracking-wider transition-all duration-200 flex items-center justify-center gap-2"
+              style={{
+                background: 'var(--color-primary)',
+                color: 'var(--color-secondary)',
+                border: '2px solid var(--color-secondary)',
+                fontSize: 'var(--font-size-body)',
+                fontWeight: 'var(--font-weight-bold)'
+              }}
+            >
+              <Upload size={20} />
+              Submit & Mint HookLicense
+            </button>
+          </>
+        )}
+      </div>
+    );
+  }
+
+  // Progress state - show steps
+  if (['signing', 'uploading', 'minting'].includes(currentStep)) {
+    return (
+      <div
+        className="angular-clip p-6"
+        style={{
+          background: 'var(--color-white)',
+          border: '2px solid var(--color-secondary)'
+        }}
+      >
+        <h3
+          className="font-heading mb-6 text-center"
+          style={{
+            color: 'var(--color-secondary)',
+            fontSize: 'var(--font-size-h4)',
+            fontWeight: 'var(--font-weight-bold)'
+          }}
+        >
+          Submitting HookSpec...
+        </h3>
+
+        <div className="space-y-4">
+          {STEPS.map((step, index) => {
+            const status = getStepStatus(step.id);
+
+            return (
+              <div
+                key={step.id}
+                className="angular-clip p-4 flex items-center gap-4"
+                style={{
+                  background: status === 'active'
+                    ? 'var(--color-primary)'
+                    : status === 'complete'
+                    ? 'rgba(255, 215, 0, 0.1)'
+                    : 'var(--color-marble-light)',
+                  border: `2px solid ${status === 'active' ? 'var(--color-secondary)' : 'var(--color-accent)'}`
+                }}
+              >
+                <div
+                  className="angular-clip w-12 h-12 flex items-center justify-center"
+                  style={{
+                    background: status === 'complete'
+                      ? 'var(--color-primary)'
+                      : status === 'active'
+                      ? 'var(--color-secondary)'
+                      : 'var(--color-accent)',
+                    color: status === 'active' ? 'var(--color-primary)' : 'var(--color-white)'
+                  }}
+                >
+                  {status === 'complete' ? (
+                    <CheckCircle size={24} style={{ color: 'var(--color-secondary)' }} />
+                  ) : status === 'active' ? (
+                    <Loader2 size={24} className="animate-spin" />
+                  ) : (
+                    step.icon
+                  )}
+                </div>
+
+                <div className="flex-1">
+                  <h4
+                    className="font-heading"
+                    style={{
+                      color: 'var(--color-secondary)',
+                      fontSize: 'var(--font-size-body)',
+                      fontWeight: 'var(--font-weight-bold)'
+                    }}
+                  >
+                    {step.title}
+                  </h4>
+                  <p
+                    className="font-body"
+                    style={{
+                      color: status === 'active' ? 'var(--color-secondary)' : 'var(--color-black)',
+                      fontSize: 'var(--font-size-body-sm)'
+                    }}
+                  >
+                    {step.description}
+                  </p>
+                </div>
+
+                <span
+                  className="angular-clip px-3 py-1 font-heading"
+                  style={{
+                    background: status === 'complete'
+                      ? 'var(--color-primary)'
+                      : status === 'active'
+                      ? 'var(--color-secondary)'
+                      : 'var(--color-accent)',
+                    color: status === 'active' ? 'var(--color-primary)' : 'var(--color-white)',
+                    fontSize: 'var(--font-size-caption)',
+                    fontWeight: 'var(--font-weight-bold)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  {status === 'complete' ? 'Done' : status === 'active' ? 'In Progress' : 'Pending'}
+                </span>
+              </div>
+            );
+          })}
+        </div>
+      </div>
+    );
+  }
+
+  // Complete state
+  if (currentStep === 'complete' && result) {
+    return (
+      <div
+        className="angular-clip p-6"
+        style={{
+          background: 'var(--color-primary)',
+          border: '2px solid var(--color-secondary)'
+        }}
+      >
+        <div className="text-center mb-6">
+          <CheckCircle
+            size={64}
+            style={{ color: 'var(--color-secondary)', margin: '0 auto' }}
+          />
+          <h3
+            className="font-heading mt-4"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-h3)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            HookLicense Minted!
+          </h3>
+          <p
+            className="font-body mt-2"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body)'
+            }}
+          >
+            Your hook specification has been registered on-chain
+          </p>
+        </div>
+
+        {/* Result Details */}
+        <div
+          className="angular-clip p-4 space-y-3"
+          style={{
+            background: 'var(--color-white)',
+            border: '2px solid var(--color-secondary)'
+          }}
+        >
+          <div className="flex justify-between items-center">
+            <span
+              className="font-heading"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Token ID
+            </span>
+            <span
+              className="font-heading"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-h5)',
+                fontWeight: 'var(--font-weight-bold)'
+              }}
+            >
+              #{result.tokenId}
+            </span>
+          </div>
+
+          <div className="flex justify-between items-center">
+            <span
+              className="font-heading"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              IPFS CID
+            </span>
+            <code
+              className="font-mono"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-caption)'
+              }}
+            >
+              {result.ipfsCid.slice(0, 12)}...{result.ipfsCid.slice(-4)}
+            </code>
+          </div>
+
+          <div className="flex justify-between items-center">
+            <span
+              className="font-heading"
+              style={{
+                color: 'var(--color-accent)',
+                fontSize: 'var(--font-size-caption)',
+                textTransform: 'uppercase'
+              }}
+            >
+              Owner
+            </span>
+            <code
+              className="font-mono"
+              style={{
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-caption)'
+              }}
+            >
+              {result.ownerAddress.slice(0, 6)}...{result.ownerAddress.slice(-4)}
+            </code>
+          </div>
+        </div>
+
+        {/* Action Links */}
+        <div className="mt-6 grid grid-cols-2 gap-3">
+          <a
+            href={result.ipfsGatewayUrl}
+            target="_blank"
+            rel="noopener noreferrer"
+            className="angular-clip-button px-4 py-3 font-heading uppercase tracking-wider transition-all duration-200 flex items-center justify-center gap-2"
+            style={{
+              background: 'var(--color-white)',
+              color: 'var(--color-secondary)',
+              border: '2px solid var(--color-secondary)',
+              fontSize: 'var(--font-size-caption)',
+              fontWeight: 'var(--font-weight-bold)',
+              textDecoration: 'none'
+            }}
+          >
+            View on IPFS
+            <ExternalLink size={14} />
+          </a>
+
+          {result.openSeaUrl && (
+            <a
+              href={result.openSeaUrl}
+              target="_blank"
+              rel="noopener noreferrer"
+              className="angular-clip-button px-4 py-3 font-heading uppercase tracking-wider transition-all duration-200 flex items-center justify-center gap-2"
+              style={{
+                background: 'var(--color-white)',
+                color: 'var(--color-secondary)',
+                border: '2px solid var(--color-secondary)',
+                fontSize: 'var(--font-size-caption)',
+                fontWeight: 'var(--font-weight-bold)',
+                textDecoration: 'none'
+              }}
+            >
+              View on OpenSea
+              <ExternalLink size={14} />
+            </a>
+          )}
+        </div>
+
+        <button
+          onClick={resetFlow}
+          className="angular-clip-button w-full mt-4 px-4 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+          style={{
+            background: 'var(--color-secondary)',
+            color: 'var(--color-primary)',
+            border: '2px solid var(--color-secondary)',
+            fontSize: 'var(--font-size-caption)',
+            fontWeight: 'var(--font-weight-bold)'
+          }}
+        >
+          Back to Dashboard
+        </button>
+      </div>
+    );
+  }
+
+  // Error state
+  if (currentStep === 'error') {
+    return (
+      <div
+        className="angular-clip p-6"
+        style={{
+          background: 'rgba(232, 90, 79, 0.1)',
+          border: '2px solid var(--color-accent)'
+        }}
+      >
+        <div className="text-center mb-6">
+          <XCircle
+            size={64}
+            style={{ color: 'var(--color-accent)', margin: '0 auto' }}
+          />
+          <h3
+            className="font-heading mt-4"
+            style={{
+              color: 'var(--color-accent)',
+              fontSize: 'var(--font-size-h4)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            Submission Failed
+          </h3>
+          <p
+            className="font-body mt-2"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body)'
+            }}
+          >
+            {error || 'An unexpected error occurred'}
+          </p>
+        </div>
+
+        <button
+          onClick={resetFlow}
+          className="angular-clip-button w-full px-4 py-3 font-heading uppercase tracking-wider transition-all duration-200"
+          style={{
+            background: 'var(--color-primary)',
+            color: 'var(--color-secondary)',
+            border: '2px solid var(--color-secondary)',
+            fontSize: 'var(--font-size-body-sm)',
+            fontWeight: 'var(--font-weight-bold)'
+          }}
+        >
+          Try Again
+        </button>
+      </div>
+    );
+  }
+
+  return null;
+}
diff --git a/client2/src/components/hook/ValidationResults.tsx b/client2/src/components/hook/ValidationResults.tsx
new file mode 100644
index 000000000..016499d02
--- /dev/null
+++ b/client2/src/components/hook/ValidationResults.tsx
@@ -0,0 +1,437 @@
+import { CheckCircle, XCircle, AlertTriangle, ChevronDown, ChevronRight, Info } from 'lucide-react';
+import { useState } from 'react';
+import type { ValidationResult } from '../../types/hookSpec';
+
+interface ValidationResultsProps {
+  results: ValidationResult[];
+  isLoading: boolean;
+  onFixError?: (ruleId: string, errorIndex: number) => void;
+}
+
+const RULE_DESCRIPTIONS: Record<string, string> = {
+  V1: 'All referenced pool state variables must exist in system-state.md',
+  V2: 'Hook state variable names must be unique',
+  V3: 'System functions must use valid Uniswap V4 callbacks',
+  V4: 'Equations must use valid symbols from state definitions',
+  V5: 'Types must be valid Solidity types',
+  V6: 'All writes must reference declared hook state variables'
+};
+
+export default function ValidationResults({
+  results,
+  isLoading,
+  onFixError
+}: ValidationResultsProps) {
+  const [expandedRules, setExpandedRules] = useState<Set<string>>(new Set());
+
+  const toggleRule = (ruleId: string) => {
+    setExpandedRules(prev => {
+      const next = new Set(prev);
+      if (next.has(ruleId)) {
+        next.delete(ruleId);
+      } else {
+        next.add(ruleId);
+      }
+      return next;
+    });
+  };
+
+  const passedCount = results.filter(r => r.passed).length;
+  const failedCount = results.filter(r => !r.passed).length;
+  const warningCount = results.reduce((acc, r) => acc + r.warnings.length, 0);
+  const allPassed = failedCount === 0;
+
+  if (isLoading) {
+    return (
+      <div
+        className="angular-clip p-6"
+        style={{
+          background: 'var(--color-white)',
+          border: '2px solid var(--color-secondary)'
+        }}
+      >
+        <div className="flex items-center justify-center gap-3">
+          <div
+            className="w-6 h-6 border-3 rounded-full animate-spin"
+            style={{
+              borderColor: 'var(--color-primary)',
+              borderTopColor: 'transparent'
+            }}
+          />
+          <span
+            className="font-heading"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body)',
+              fontWeight: 'var(--font-weight-medium)'
+            }}
+          >
+            Validating HookSpec...
+          </span>
+        </div>
+      </div>
+    );
+  }
+
+  if (results.length === 0) {
+    return (
+      <div
+        className="angular-clip p-6"
+        style={{
+          background: 'var(--color-marble-light)',
+          border: '2px solid var(--color-accent)'
+        }}
+      >
+        <div className="flex items-center gap-3">
+          <Info size={24} style={{ color: 'var(--color-accent)' }} />
+          <span
+            className="font-body"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body)'
+            }}
+          >
+            Click "Validate HookSpec" to check compatibility with the State Space Model
+          </span>
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <div
+      className="angular-clip"
+      style={{
+        background: 'var(--color-white)',
+        border: '2px solid var(--color-secondary)',
+        overflow: 'hidden'
+      }}
+    >
+      {/* Summary Header */}
+      <div
+        className="p-4"
+        style={{
+          background: allPassed ? 'var(--color-primary)' : 'rgba(232, 90, 79, 0.1)',
+          borderBottom: '2px solid var(--color-secondary)'
+        }}
+      >
+        <div className="flex items-center justify-between">
+          <div className="flex items-center gap-3">
+            {allPassed ? (
+              <CheckCircle size={28} style={{ color: 'var(--color-secondary)' }} />
+            ) : (
+              <XCircle size={28} style={{ color: 'var(--color-accent)' }} />
+            )}
+            <div>
+              <h3
+                className="font-heading"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-h5)',
+                  fontWeight: 'var(--font-weight-bold)'
+                }}
+              >
+                {allPassed ? 'Validation Passed' : 'Validation Failed'}
+              </h3>
+              <p
+                className="font-body"
+                style={{
+                  color: allPassed ? 'var(--color-secondary)' : 'var(--color-accent)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              >
+                {allPassed
+                  ? 'Your HookSpec is compatible with the State Space Model'
+                  : `${failedCount} rule${failedCount > 1 ? 's' : ''} failed validation`
+                }
+              </p>
+            </div>
+          </div>
+
+          <div className="flex gap-4">
+            <div className="text-center">
+              <span
+                className="angular-clip px-3 py-1 font-heading"
+                style={{
+                  background: 'var(--color-primary)',
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-h5)',
+                  fontWeight: 'var(--font-weight-bold)'
+                }}
+              >
+                {passedCount}
+              </span>
+              <p
+                className="mt-1 font-heading"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Passed
+              </p>
+            </div>
+            {failedCount > 0 && (
+              <div className="text-center">
+                <span
+                  className="angular-clip px-3 py-1 font-heading"
+                  style={{
+                    background: 'var(--color-accent)',
+                    color: 'var(--color-white)',
+                    fontSize: 'var(--font-size-h5)',
+                    fontWeight: 'var(--font-weight-bold)'
+                  }}
+                >
+                  {failedCount}
+                </span>
+                <p
+                  className="mt-1 font-heading"
+                  style={{
+                    color: 'var(--color-accent)',
+                    fontSize: 'var(--font-size-caption)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  Failed
+                </p>
+              </div>
+            )}
+            {warningCount > 0 && (
+              <div className="text-center">
+                <span
+                  className="angular-clip px-3 py-1 font-heading"
+                  style={{
+                    background: 'rgba(255, 215, 0, 0.3)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-h5)',
+                    fontWeight: 'var(--font-weight-bold)'
+                  }}
+                >
+                  {warningCount}
+                </span>
+                <p
+                  className="mt-1 font-heading"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-caption)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  Warnings
+                </p>
+              </div>
+            )}
+          </div>
+        </div>
+      </div>
+
+      {/* Rule Results */}
+      <div className="divide-y" style={{ borderColor: 'var(--color-accent)' }}>
+        {results.map(result => {
+          const isExpanded = expandedRules.has(result.ruleId);
+          const hasDetails = result.errors.length > 0 || result.warnings.length > 0;
+
+          return (
+            <div key={result.ruleId}>
+              <button
+                onClick={() => hasDetails && toggleRule(result.ruleId)}
+                className="w-full p-4 flex items-center justify-between transition-colors"
+                style={{
+                  cursor: hasDetails ? 'pointer' : 'default'
+                }}
+                disabled={!hasDetails}
+              >
+                <div className="flex items-center gap-3">
+                  {hasDetails && (
+                    isExpanded ? (
+                      <ChevronDown size={18} style={{ color: 'var(--color-accent)' }} />
+                    ) : (
+                      <ChevronRight size={18} style={{ color: 'var(--color-accent)' }} />
+                    )
+                  )}
+                  {!hasDetails && <div className="w-[18px]" />}
+
+                  {result.passed ? (
+                    <CheckCircle size={20} style={{ color: 'var(--color-primary)' }} />
+                  ) : (
+                    <XCircle size={20} style={{ color: 'var(--color-accent)' }} />
+                  )}
+
+                  <div className="text-left">
+                    <div className="flex items-center gap-2">
+                      <span
+                        className="font-mono angular-clip px-2 py-0.5"
+                        style={{
+                          background: result.passed ? 'var(--color-primary)' : 'var(--color-accent)',
+                          color: result.passed ? 'var(--color-secondary)' : 'var(--color-white)',
+                          fontSize: 'var(--font-size-caption)',
+                          fontWeight: 'var(--font-weight-bold)'
+                        }}
+                      >
+                        {result.ruleId}
+                      </span>
+                      <span
+                        className="font-heading"
+                        style={{
+                          color: 'var(--color-secondary)',
+                          fontSize: 'var(--font-size-body-sm)',
+                          fontWeight: 'var(--font-weight-medium)'
+                        }}
+                      >
+                        {result.ruleName}
+                      </span>
+                    </div>
+                    <p
+                      className="font-body mt-1"
+                      style={{
+                        color: 'var(--color-black)',
+                        fontSize: 'var(--font-size-caption)'
+                      }}
+                    >
+                      {RULE_DESCRIPTIONS[result.ruleId] || 'Validation rule'}
+                    </p>
+                  </div>
+                </div>
+
+                <div className="flex items-center gap-2">
+                  {result.warnings.length > 0 && (
+                    <span className="flex items-center gap-1">
+                      <AlertTriangle size={14} style={{ color: 'var(--color-primary)' }} />
+                      <span
+                        className="font-mono"
+                        style={{
+                          color: 'var(--color-primary)',
+                          fontSize: 'var(--font-size-caption)'
+                        }}
+                      >
+                        {result.warnings.length}
+                      </span>
+                    </span>
+                  )}
+                  <span
+                    className="angular-clip px-2 py-1 font-heading"
+                    style={{
+                      background: result.passed ? 'rgba(255, 215, 0, 0.2)' : 'rgba(232, 90, 79, 0.2)',
+                      color: result.passed ? 'var(--color-secondary)' : 'var(--color-accent)',
+                      fontSize: 'var(--font-size-caption)',
+                      fontWeight: 'var(--font-weight-bold)',
+                      textTransform: 'uppercase'
+                    }}
+                  >
+                    {result.passed ? 'Pass' : 'Fail'}
+                  </span>
+                </div>
+              </button>
+
+              {/* Expanded Details */}
+              {isExpanded && hasDetails && (
+                <div
+                  className="px-4 pb-4 ml-[42px]"
+                  style={{
+                    background: 'var(--color-marble-light)'
+                  }}
+                >
+                  {/* Errors */}
+                  {result.errors.length > 0 && (
+                    <div className="mb-3">
+                      <span
+                        className="font-heading"
+                        style={{
+                          color: 'var(--color-accent)',
+                          fontSize: 'var(--font-size-caption)',
+                          textTransform: 'uppercase'
+                        }}
+                      >
+                        Errors
+                      </span>
+                      <ul className="mt-2 space-y-2">
+                        {result.errors.map((error, idx) => (
+                          <li
+                            key={idx}
+                            className="angular-clip p-3 flex items-start justify-between gap-3"
+                            style={{
+                              background: 'rgba(232, 90, 79, 0.1)',
+                              border: '1px solid var(--color-accent)'
+                            }}
+                          >
+                            <div className="flex items-start gap-2">
+                              <XCircle
+                                size={16}
+                                style={{ color: 'var(--color-accent)', flexShrink: 0, marginTop: 2 }}
+                              />
+                              <span
+                                className="font-mono"
+                                style={{
+                                  color: 'var(--color-accent)',
+                                  fontSize: 'var(--font-size-caption)'
+                                }}
+                              >
+                                {error}
+                              </span>
+                            </div>
+                            {onFixError && (
+                              <button
+                                onClick={() => onFixError(result.ruleId, idx)}
+                                className="font-heading text-xs uppercase tracking-wider transition-colors"
+                                style={{ color: 'var(--color-primary)' }}
+                              >
+                                Fix
+                              </button>
+                            )}
+                          </li>
+                        ))}
+                      </ul>
+                    </div>
+                  )}
+
+                  {/* Warnings */}
+                  {result.warnings.length > 0 && (
+                    <div>
+                      <span
+                        className="font-heading"
+                        style={{
+                          color: 'var(--color-primary)',
+                          fontSize: 'var(--font-size-caption)',
+                          textTransform: 'uppercase'
+                        }}
+                      >
+                        Warnings
+                      </span>
+                      <ul className="mt-2 space-y-2">
+                        {result.warnings.map((warning, idx) => (
+                          <li
+                            key={idx}
+                            className="angular-clip p-3 flex items-start gap-2"
+                            style={{
+                              background: 'rgba(255, 215, 0, 0.1)',
+                              border: '1px solid var(--color-primary)'
+                            }}
+                          >
+                            <AlertTriangle
+                              size={16}
+                              style={{ color: 'var(--color-primary)', flexShrink: 0, marginTop: 2 }}
+                            />
+                            <span
+                              className="font-mono"
+                              style={{
+                                color: 'var(--color-secondary)',
+                                fontSize: 'var(--font-size-caption)'
+                              }}
+                            >
+                              {warning}
+                            </span>
+                          </li>
+                        ))}
+                      </ul>
+                    </div>
+                  )}
+                </div>
+              )}
+            </div>
+          );
+        })}
+      </div>
+    </div>
+  );
+}
diff --git a/client2/src/components/hook/index.ts b/client2/src/components/hook/index.ts
new file mode 100644
index 000000000..4acda067e
--- /dev/null
+++ b/client2/src/components/hook/index.ts
@@ -0,0 +1,10 @@
+// Hook components exports
+export { default as CreateHookPage } from './CreateHookPage';
+export { default as CodeVerificationPage } from './CodeVerificationPage';
+export { default as StateSpaceModelViewer } from './StateSpaceModelViewer';
+export { default as HookSpecEditor } from './HookSpecEditor';
+export { default as ValidationResults } from './ValidationResults';
+export { default as SubmissionFlow } from './SubmissionFlow';
+export { default as CodeSubmissionFlow } from './CodeSubmissionFlow';
+export { default as AVSVerificationResults } from './AVSVerificationResults';
+export { default as CFHEDeploymentStatus } from './CFHEDeploymentStatus';
diff --git a/client2/src/components/market/BytecodeVerifier.tsx b/client2/src/components/market/BytecodeVerifier.tsx
new file mode 100644
index 000000000..6bd8b3143
--- /dev/null
+++ b/client2/src/components/market/BytecodeVerifier.tsx
@@ -0,0 +1,312 @@
+import React, { useState } from 'react';
+import {
+  BytecodeVerificationRequest,
+  BytecodeVerificationResult,
+  EncryptionStatus,
+} from '../../types/hookSpec';
+
+interface BytecodeVerifierProps {
+  hookTokenId: number;
+  hookName: string;
+  onClose: () => void;
+  onVerificationComplete?: (result: BytecodeVerificationResult) => void;
+}
+
+const BytecodeVerifier: React.FC<BytecodeVerifierProps> = ({
+  hookTokenId,
+  hookName,
+  onClose,
+  onVerificationComplete,
+}) => {
+  const [poolId, setPoolId] = useState('');
+  const [isVerifying, setIsVerifying] = useState(false);
+  const [result, setResult] = useState<BytecodeVerificationResult | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  const handleVerify = async () => {
+    setIsVerifying(true);
+    setError(null);
+    setResult(null);
+
+    try {
+      const request: BytecodeVerificationRequest = {
+        hookTokenId,
+        poolId: poolId || undefined,
+      };
+
+      // Mock API call - replace with actual API
+      await new Promise((resolve) => setTimeout(resolve, 2000));
+
+      // Mock result
+      const mockResult: BytecodeVerificationResult = {
+        verified: true,
+        obfuscatedBytecodeHash: '0x7f8e9d2c1a4b5e6f0123456789abcdef...',
+        deployedBytecodeHash: '0x7f8e9d2c1a4b5e6f0123456789abcdef...',
+        matchPercentage: 100,
+        cfheContractAddress: '0x1234567890abcdef1234567890abcdef12345678',
+        encryptionStatus: 'ENCRYPTED' as EncryptionStatus,
+      };
+
+      setResult(mockResult);
+      onVerificationComplete?.(mockResult);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Verification failed');
+    } finally {
+      setIsVerifying(false);
+    }
+  };
+
+  const getEncryptionStatusBadge = (status: EncryptionStatus) => {
+    const styles: Record<EncryptionStatus, { bg: string; text: string }> = {
+      ENCRYPTED: { bg: 'bg-green-100', text: 'text-green-800' },
+      PLAINTEXT: { bg: 'bg-yellow-100', text: 'text-yellow-800' },
+      NOT_DEPLOYED: { bg: 'bg-gray-100', text: 'text-gray-800' },
+    };
+    const style = styles[status];
+    return (
+      <span className={`px-2 py-1 rounded-full text-xs font-medium ${style.bg} ${style.text}`}>
+        {status.replace('_', ' ')}
+      </span>
+    );
+  };
+
+  const getMatchIndicator = (percentage: number) => {
+    if (percentage === 100) {
+      return { color: 'text-green-600', icon: 'check-circle', label: 'Perfect Match' };
+    } else if (percentage >= 90) {
+      return { color: 'text-yellow-600', icon: 'alert-circle', label: 'Partial Match' };
+    } else {
+      return { color: 'text-red-600', icon: 'x-circle', label: 'Mismatch' };
+    }
+  };
+
+  return (
+    <div className="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50">
+      <div className="bg-white rounded-lg shadow-xl max-w-2xl w-full mx-4 max-h-[90vh] overflow-y-auto">
+        {/* Header */}
+        <div className="p-6 border-b border-gray-200">
+          <div className="flex items-center justify-between">
+            <div>
+              <h2 className="text-xl font-semibold text-gray-900">
+                Bytecode Verification
+              </h2>
+              <p className="text-sm text-gray-500 mt-1">
+                Verify deployed code matches registered bytecode for {hookName}
+              </p>
+            </div>
+            <button
+              onClick={onClose}
+              className="p-2 hover:bg-gray-100 rounded-full transition-colors"
+            >
+              <svg className="w-5 h-5 text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
+              </svg>
+            </button>
+          </div>
+        </div>
+
+        {/* Content */}
+        <div className="p-6 space-y-6">
+          {/* Pool Selection */}
+          <div>
+            <label className="block text-sm font-medium text-gray-700 mb-2">
+              Pool ID (Optional)
+            </label>
+            <input
+              type="text"
+              value={poolId}
+              onChange={(e) => setPoolId(e.target.value)}
+              placeholder="0x... (leave empty for general verification)"
+              className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500"
+              disabled={isVerifying}
+            />
+            <p className="text-xs text-gray-500 mt-1">
+              Optionally specify a pool ID to verify deployment for a specific pool
+            </p>
+          </div>
+
+          {/* Verify Button */}
+          {!result && (
+            <button
+              onClick={handleVerify}
+              disabled={isVerifying}
+              className="w-full px-4 py-3 bg-blue-600 text-white rounded-lg hover:bg-blue-700 disabled:bg-gray-400 disabled:cursor-not-allowed transition-colors flex items-center justify-center gap-2"
+            >
+              {isVerifying ? (
+                <>
+                  <svg className="animate-spin h-5 w-5" viewBox="0 0 24 24">
+                    <circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" fill="none" />
+                    <path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z" />
+                  </svg>
+                  Verifying Bytecode...
+                </>
+              ) : (
+                <>
+                  <svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
+                  </svg>
+                  Verify Bytecode
+                </>
+              )}
+            </button>
+          )}
+
+          {/* Error Display */}
+          {error && (
+            <div className="p-4 bg-red-50 border border-red-200 rounded-lg">
+              <div className="flex items-center gap-2 text-red-800">
+                <svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+                </svg>
+                <span className="font-medium">Verification Failed</span>
+              </div>
+              <p className="text-red-700 text-sm mt-1">{error}</p>
+            </div>
+          )}
+
+          {/* Verification Result */}
+          {result && (
+            <div className="space-y-4">
+              {/* Status Banner */}
+              <div
+                className={`p-4 rounded-lg ${
+                  result.verified ? 'bg-green-50 border border-green-200' : 'bg-red-50 border border-red-200'
+                }`}
+              >
+                <div className="flex items-center gap-3">
+                  {result.verified ? (
+                    <svg className="w-8 h-8 text-green-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
+                    </svg>
+                  ) : (
+                    <svg className="w-8 h-8 text-red-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 14l2-2m0 0l2-2m-2 2l-2-2m2 2l2 2m7-2a9 9 0 11-18 0 9 9 0 0118 0z" />
+                    </svg>
+                  )}
+                  <div>
+                    <h3 className={`font-semibold ${result.verified ? 'text-green-800' : 'text-red-800'}`}>
+                      {result.verified ? 'Bytecode Verified' : 'Bytecode Mismatch'}
+                    </h3>
+                    <p className={`text-sm ${result.verified ? 'text-green-700' : 'text-red-700'}`}>
+                      {result.verified
+                        ? 'The deployed code matches the registered hook bytecode'
+                        : 'The deployed code does not match the registered bytecode'}
+                    </p>
+                  </div>
+                </div>
+              </div>
+
+              {/* Match Percentage */}
+              <div className="bg-gray-50 rounded-lg p-4">
+                <div className="flex items-center justify-between mb-2">
+                  <span className="text-sm font-medium text-gray-700">Match Percentage</span>
+                  <span className={`text-lg font-bold ${getMatchIndicator(result.matchPercentage).color}`}>
+                    {result.matchPercentage}%
+                  </span>
+                </div>
+                <div className="w-full bg-gray-200 rounded-full h-2">
+                  <div
+                    className={`h-2 rounded-full transition-all ${
+                      result.matchPercentage === 100
+                        ? 'bg-green-500'
+                        : result.matchPercentage >= 90
+                        ? 'bg-yellow-500'
+                        : 'bg-red-500'
+                    }`}
+                    style={{ width: `${result.matchPercentage}%` }}
+                  />
+                </div>
+              </div>
+
+              {/* Bytecode Hashes */}
+              <div className="space-y-3">
+                <div>
+                  <label className="block text-xs font-medium text-gray-500 mb-1">
+                    Obfuscated Bytecode Hash (CFHE)
+                  </label>
+                  <div className="flex items-center gap-2">
+                    <code className="flex-1 px-3 py-2 bg-gray-100 rounded font-mono text-xs text-gray-700 break-all">
+                      {result.obfuscatedBytecodeHash}
+                    </code>
+                    <button
+                      onClick={() => navigator.clipboard.writeText(result.obfuscatedBytecodeHash)}
+                      className="p-2 hover:bg-gray-100 rounded transition-colors"
+                      title="Copy to clipboard"
+                    >
+                      <svg className="w-4 h-4 text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z" />
+                      </svg>
+                    </button>
+                  </div>
+                </div>
+
+                <div>
+                  <label className="block text-xs font-medium text-gray-500 mb-1">
+                    Deployed Bytecode Hash
+                  </label>
+                  <div className="flex items-center gap-2">
+                    <code className="flex-1 px-3 py-2 bg-gray-100 rounded font-mono text-xs text-gray-700 break-all">
+                      {result.deployedBytecodeHash}
+                    </code>
+                    <button
+                      onClick={() => navigator.clipboard.writeText(result.deployedBytecodeHash)}
+                      className="p-2 hover:bg-gray-100 rounded transition-colors"
+                      title="Copy to clipboard"
+                    >
+                      <svg className="w-4 h-4 text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z" />
+                      </svg>
+                    </button>
+                  </div>
+                </div>
+              </div>
+
+              {/* CFHE Details */}
+              <div className="border border-gray-200 rounded-lg p-4">
+                <h4 className="text-sm font-medium text-gray-900 mb-3">CFHE Deployment Details</h4>
+                <div className="space-y-2">
+                  <div className="flex items-center justify-between">
+                    <span className="text-sm text-gray-600">Encryption Status</span>
+                    {getEncryptionStatusBadge(result.encryptionStatus)}
+                  </div>
+                  {result.cfheContractAddress && (
+                    <div className="flex items-center justify-between">
+                      <span className="text-sm text-gray-600">CFHE Contract</span>
+                      <a
+                        href={`https://explorer.fhenix.zone/address/${result.cfheContractAddress}`}
+                        target="_blank"
+                        rel="noopener noreferrer"
+                        className="text-sm text-blue-600 hover:text-blue-800 font-mono"
+                      >
+                        {result.cfheContractAddress.slice(0, 6)}...{result.cfheContractAddress.slice(-4)}
+                      </a>
+                    </div>
+                  )}
+                </div>
+              </div>
+
+              {/* Reset Button */}
+              <button
+                onClick={() => setResult(null)}
+                className="w-full px-4 py-2 border border-gray-300 text-gray-700 rounded-lg hover:bg-gray-50 transition-colors"
+              >
+                Verify Again
+              </button>
+            </div>
+          )}
+        </div>
+
+        {/* Footer */}
+        <div className="p-6 border-t border-gray-200 bg-gray-50">
+          <p className="text-xs text-gray-500 text-center">
+            Bytecode verification confirms that the deployed hook code matches the registered
+            obfuscated bytecode stored on the CFHE network. This ensures code integrity and
+            prevents tampering.
+          </p>
+        </div>
+      </div>
+    </div>
+  );
+};
+
+export default BytecodeVerifier;
diff --git a/client2/src/components/market/FunctionalityTester.tsx b/client2/src/components/market/FunctionalityTester.tsx
new file mode 100644
index 000000000..4a76bd6ac
--- /dev/null
+++ b/client2/src/components/market/FunctionalityTester.tsx
@@ -0,0 +1,562 @@
+import React, { useState } from 'react';
+import {
+  TestType,
+  SwapTestParams,
+  LiquidityTestParams,
+  FunctionalityTestRequest,
+  FunctionalityTestResult,
+  TestDeviation,
+  TestDeviationSeverity,
+} from '../../types/hookSpec';
+
+interface FunctionalityTesterProps {
+  hookTokenId: number;
+  hookName: string;
+  onClose: () => void;
+  onTestComplete?: (result: FunctionalityTestResult) => void;
+}
+
+const FunctionalityTester: React.FC<FunctionalityTesterProps> = ({
+  hookTokenId,
+  hookName,
+  onClose,
+  onTestComplete,
+}) => {
+  const [testType, setTestType] = useState<TestType>('SWAP');
+  const [isTesting, setIsTesting] = useState(false);
+  const [result, setResult] = useState<FunctionalityTestResult | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  // Swap params
+  const [zeroForOne, setZeroForOne] = useState(true);
+  const [amountSpecified, setAmountSpecified] = useState('1000000000000000000');
+  const [sqrtPriceLimitX96, setSqrtPriceLimitX96] = useState('79228162514264337593543950336');
+
+  // Liquidity params
+  const [tickLower, setTickLower] = useState(-887220);
+  const [tickUpper, setTickUpper] = useState(887220);
+  const [liquidityDelta, setLiquidityDelta] = useState('1000000000000000000');
+
+  // Custom params
+  const [customParams, setCustomParams] = useState('{}');
+
+  // Expected behavior
+  const [expectedBehavior, setExpectedBehavior] = useState('');
+
+  const handleRunTest = async () => {
+    setIsTesting(true);
+    setError(null);
+    setResult(null);
+
+    try {
+      const swapParams: SwapTestParams | undefined =
+        testType === 'SWAP'
+          ? {
+              zeroForOne,
+              amountSpecified,
+              sqrtPriceLimitX96,
+            }
+          : undefined;
+
+      const liquidityParams: LiquidityTestParams | undefined =
+        testType === 'LIQUIDITY'
+          ? {
+              tickLower,
+              tickUpper,
+              liquidityDelta,
+            }
+          : undefined;
+
+      let parsedCustomParams: Record<string, unknown> | undefined;
+      if (testType === 'CUSTOM') {
+        try {
+          parsedCustomParams = JSON.parse(customParams);
+        } catch {
+          throw new Error('Invalid JSON in custom parameters');
+        }
+      }
+
+      const request: FunctionalityTestRequest = {
+        hookTokenId,
+        testType,
+        testData: {
+          swapParams,
+          liquidityParams,
+          customParams: parsedCustomParams,
+        },
+        expectedBehavior: expectedBehavior || undefined,
+      };
+
+      // Mock API call - replace with actual AVS API
+      await new Promise((resolve) => setTimeout(resolve, 3000));
+
+      // Mock result
+      const mockResult: FunctionalityTestResult = {
+        success: true,
+        testId: `test-${Date.now()}`,
+        avsVerificationId: `avs-${Date.now()}`,
+        accuracyScore: 95,
+        behaviorMatch: true,
+        report: {
+          inputSummary: `${testType} test with ${
+            testType === 'SWAP'
+              ? `amount: ${amountSpecified}, zeroForOne: ${zeroForOne}`
+              : testType === 'LIQUIDITY'
+              ? `ticks: [${tickLower}, ${tickUpper}], delta: ${liquidityDelta}`
+              : 'custom parameters'
+          }`,
+          expectedOutput: expectedBehavior || 'Standard hook behavior',
+          actualOutput: 'Hook executed successfully with expected state changes',
+          deviations: [
+            {
+              field: 'gasUsed',
+              expected: '150000',
+              actual: '145230',
+              severity: 'INFO' as TestDeviationSeverity,
+            },
+          ],
+          gasUsed: '145230',
+          executionTimeMs: 2450,
+        },
+        attestation: {
+          attestationId: `att-${Date.now()}`,
+          attesters: [
+            '0x1111111111111111111111111111111111111111',
+            '0x2222222222222222222222222222222222222222',
+            '0x3333333333333333333333333333333333333333',
+          ],
+          consensus: 100,
+          timestamp: Math.floor(Date.now() / 1000),
+        },
+      };
+
+      setResult(mockResult);
+      onTestComplete?.(mockResult);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Test execution failed');
+    } finally {
+      setIsTesting(false);
+    }
+  };
+
+  const getSeverityColor = (severity: TestDeviationSeverity) => {
+    switch (severity) {
+      case 'CRITICAL':
+        return { bg: 'bg-red-100', text: 'text-red-800', border: 'border-red-200' };
+      case 'WARNING':
+        return { bg: 'bg-yellow-100', text: 'text-yellow-800', border: 'border-yellow-200' };
+      case 'INFO':
+        return { bg: 'bg-blue-100', text: 'text-blue-800', border: 'border-blue-200' };
+    }
+  };
+
+  const getAccuracyColor = (score: number) => {
+    if (score >= 90) return 'text-green-600';
+    if (score >= 70) return 'text-yellow-600';
+    return 'text-red-600';
+  };
+
+  const renderTestParams = () => {
+    switch (testType) {
+      case 'SWAP':
+        return (
+          <div className="space-y-4">
+            <div>
+              <label className="block text-sm font-medium text-gray-700 mb-2">
+                Swap Direction
+              </label>
+              <div className="flex gap-4">
+                <label className="flex items-center gap-2 cursor-pointer">
+                  <input
+                    type="radio"
+                    checked={zeroForOne}
+                    onChange={() => setZeroForOne(true)}
+                    className="text-blue-600 focus:ring-blue-500"
+                  />
+                  <span className="text-sm text-gray-700">Token0 → Token1</span>
+                </label>
+                <label className="flex items-center gap-2 cursor-pointer">
+                  <input
+                    type="radio"
+                    checked={!zeroForOne}
+                    onChange={() => setZeroForOne(false)}
+                    className="text-blue-600 focus:ring-blue-500"
+                  />
+                  <span className="text-sm text-gray-700">Token1 → Token0</span>
+                </label>
+              </div>
+            </div>
+
+            <div>
+              <label className="block text-sm font-medium text-gray-700 mb-2">
+                Amount Specified (wei)
+              </label>
+              <input
+                type="text"
+                value={amountSpecified}
+                onChange={(e) => setAmountSpecified(e.target.value)}
+                className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500 font-mono text-sm"
+                placeholder="1000000000000000000"
+              />
+            </div>
+
+            <div>
+              <label className="block text-sm font-medium text-gray-700 mb-2">
+                Sqrt Price Limit X96
+              </label>
+              <input
+                type="text"
+                value={sqrtPriceLimitX96}
+                onChange={(e) => setSqrtPriceLimitX96(e.target.value)}
+                className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500 font-mono text-sm"
+                placeholder="79228162514264337593543950336"
+              />
+            </div>
+          </div>
+        );
+
+      case 'LIQUIDITY':
+        return (
+          <div className="space-y-4">
+            <div className="grid grid-cols-2 gap-4">
+              <div>
+                <label className="block text-sm font-medium text-gray-700 mb-2">
+                  Tick Lower
+                </label>
+                <input
+                  type="number"
+                  value={tickLower}
+                  onChange={(e) => setTickLower(parseInt(e.target.value))}
+                  className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500"
+                />
+              </div>
+              <div>
+                <label className="block text-sm font-medium text-gray-700 mb-2">
+                  Tick Upper
+                </label>
+                <input
+                  type="number"
+                  value={tickUpper}
+                  onChange={(e) => setTickUpper(parseInt(e.target.value))}
+                  className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500"
+                />
+              </div>
+            </div>
+
+            <div>
+              <label className="block text-sm font-medium text-gray-700 mb-2">
+                Liquidity Delta (wei)
+              </label>
+              <input
+                type="text"
+                value={liquidityDelta}
+                onChange={(e) => setLiquidityDelta(e.target.value)}
+                className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500 font-mono text-sm"
+                placeholder="1000000000000000000"
+              />
+            </div>
+          </div>
+        );
+
+      case 'INITIALIZE':
+        return (
+          <div className="p-4 bg-gray-50 rounded-lg">
+            <p className="text-sm text-gray-600">
+              Initialize test will verify the hook's beforeInitialize and afterInitialize
+              callbacks with default pool parameters.
+            </p>
+          </div>
+        );
+
+      case 'CUSTOM':
+        return (
+          <div>
+            <label className="block text-sm font-medium text-gray-700 mb-2">
+              Custom Parameters (JSON)
+            </label>
+            <textarea
+              value={customParams}
+              onChange={(e) => setCustomParams(e.target.value)}
+              className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500 font-mono text-sm h-32"
+              placeholder='{"param1": "value1", "param2": 123}'
+            />
+          </div>
+        );
+    }
+  };
+
+  return (
+    <div className="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50">
+      <div className="bg-white rounded-lg shadow-xl max-w-3xl w-full mx-4 max-h-[90vh] overflow-y-auto">
+        {/* Header */}
+        <div className="p-6 border-b border-gray-200">
+          <div className="flex items-center justify-between">
+            <div>
+              <h2 className="text-xl font-semibold text-gray-900">
+                AVS Functionality Testing
+              </h2>
+              <p className="text-sm text-gray-500 mt-1">
+                Test hook behavior and get AVS accuracy report for {hookName}
+              </p>
+            </div>
+            <button
+              onClick={onClose}
+              className="p-2 hover:bg-gray-100 rounded-full transition-colors"
+            >
+              <svg className="w-5 h-5 text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
+              </svg>
+            </button>
+          </div>
+        </div>
+
+        {/* Content */}
+        <div className="p-6 space-y-6">
+          {!result ? (
+            <>
+              {/* Test Type Selection */}
+              <div>
+                <label className="block text-sm font-medium text-gray-700 mb-3">
+                  Test Type
+                </label>
+                <div className="grid grid-cols-4 gap-2">
+                  {(['SWAP', 'LIQUIDITY', 'INITIALIZE', 'CUSTOM'] as TestType[]).map((type) => (
+                    <button
+                      key={type}
+                      onClick={() => setTestType(type)}
+                      className={`px-4 py-2 rounded-lg border text-sm font-medium transition-colors ${
+                        testType === type
+                          ? 'bg-blue-600 text-white border-blue-600'
+                          : 'bg-white text-gray-700 border-gray-300 hover:bg-gray-50'
+                      }`}
+                    >
+                      {type}
+                    </button>
+                  ))}
+                </div>
+              </div>
+
+              {/* Test Parameters */}
+              <div className="border border-gray-200 rounded-lg p-4">
+                <h3 className="text-sm font-medium text-gray-900 mb-4">Test Parameters</h3>
+                {renderTestParams()}
+              </div>
+
+              {/* Expected Behavior */}
+              <div>
+                <label className="block text-sm font-medium text-gray-700 mb-2">
+                  Expected Behavior (Optional)
+                </label>
+                <textarea
+                  value={expectedBehavior}
+                  onChange={(e) => setExpectedBehavior(e.target.value)}
+                  className="w-full px-4 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-blue-500 h-24"
+                  placeholder="Describe the expected hook behavior in natural language..."
+                />
+                <p className="text-xs text-gray-500 mt-1">
+                  Provide a description of expected behavior to help AVS operators validate results
+                </p>
+              </div>
+
+              {/* Run Test Button */}
+              <button
+                onClick={handleRunTest}
+                disabled={isTesting}
+                className="w-full px-4 py-3 bg-purple-600 text-white rounded-lg hover:bg-purple-700 disabled:bg-gray-400 disabled:cursor-not-allowed transition-colors flex items-center justify-center gap-2"
+              >
+                {isTesting ? (
+                  <>
+                    <svg className="animate-spin h-5 w-5" viewBox="0 0 24 24">
+                      <circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" fill="none" />
+                      <path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z" />
+                    </svg>
+                    Running AVS Test...
+                  </>
+                ) : (
+                  <>
+                    <svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9.75 17L9 20l-1 1h8l-1-1-.75-3M3 13h18M5 17h14a2 2 0 002-2V5a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z" />
+                    </svg>
+                    Run Functionality Test
+                  </>
+                )}
+              </button>
+
+              {/* Error Display */}
+              {error && (
+                <div className="p-4 bg-red-50 border border-red-200 rounded-lg">
+                  <div className="flex items-center gap-2 text-red-800">
+                    <svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+                    </svg>
+                    <span className="font-medium">Test Failed</span>
+                  </div>
+                  <p className="text-red-700 text-sm mt-1">{error}</p>
+                </div>
+              )}
+            </>
+          ) : (
+            /* Test Results */
+            <div className="space-y-6">
+              {/* Accuracy Score */}
+              <div className="text-center py-6">
+                <div className="inline-flex items-center justify-center w-32 h-32 rounded-full bg-gray-100 mb-4">
+                  <span className={`text-4xl font-bold ${getAccuracyColor(result.accuracyScore)}`}>
+                    {result.accuracyScore}%
+                  </span>
+                </div>
+                <h3 className="text-lg font-semibold text-gray-900">Accuracy Score</h3>
+                <p className={`text-sm ${result.behaviorMatch ? 'text-green-600' : 'text-red-600'}`}>
+                  {result.behaviorMatch ? 'Behavior matches specification' : 'Behavior deviates from specification'}
+                </p>
+              </div>
+
+              {/* Test Summary */}
+              <div className="grid grid-cols-2 gap-4">
+                <div className="bg-gray-50 rounded-lg p-4">
+                  <p className="text-xs text-gray-500 mb-1">Test ID</p>
+                  <p className="text-sm font-mono text-gray-900">{result.testId}</p>
+                </div>
+                <div className="bg-gray-50 rounded-lg p-4">
+                  <p className="text-xs text-gray-500 mb-1">AVS Verification ID</p>
+                  <p className="text-sm font-mono text-gray-900">{result.avsVerificationId}</p>
+                </div>
+              </div>
+
+              {/* Execution Report */}
+              <div className="border border-gray-200 rounded-lg p-4">
+                <h4 className="text-sm font-medium text-gray-900 mb-4">Execution Report</h4>
+                <div className="space-y-3">
+                  <div>
+                    <p className="text-xs text-gray-500 mb-1">Input Summary</p>
+                    <p className="text-sm text-gray-700">{result.report.inputSummary}</p>
+                  </div>
+                  <div>
+                    <p className="text-xs text-gray-500 mb-1">Expected Output</p>
+                    <p className="text-sm text-gray-700">{result.report.expectedOutput}</p>
+                  </div>
+                  <div>
+                    <p className="text-xs text-gray-500 mb-1">Actual Output</p>
+                    <p className="text-sm text-gray-700">{result.report.actualOutput}</p>
+                  </div>
+                  <div className="grid grid-cols-2 gap-4 pt-2 border-t border-gray-100">
+                    <div>
+                      <p className="text-xs text-gray-500 mb-1">Gas Used</p>
+                      <p className="text-sm font-mono text-gray-900">{result.report.gasUsed}</p>
+                    </div>
+                    <div>
+                      <p className="text-xs text-gray-500 mb-1">Execution Time</p>
+                      <p className="text-sm font-mono text-gray-900">{result.report.executionTimeMs}ms</p>
+                    </div>
+                  </div>
+                </div>
+              </div>
+
+              {/* Deviations */}
+              {result.report.deviations.length > 0 && (
+                <div className="border border-gray-200 rounded-lg p-4">
+                  <h4 className="text-sm font-medium text-gray-900 mb-4">Deviations</h4>
+                  <div className="space-y-2">
+                    {result.report.deviations.map((deviation: TestDeviation, index: number) => {
+                      const colors = getSeverityColor(deviation.severity);
+                      return (
+                        <div
+                          key={index}
+                          className={`p-3 rounded-lg border ${colors.bg} ${colors.border}`}
+                        >
+                          <div className="flex items-center justify-between mb-2">
+                            <span className={`text-sm font-medium ${colors.text}`}>
+                              {deviation.field}
+                            </span>
+                            <span className={`px-2 py-0.5 rounded text-xs font-medium ${colors.text} ${colors.bg}`}>
+                              {deviation.severity}
+                            </span>
+                          </div>
+                          <div className="grid grid-cols-2 gap-4 text-sm">
+                            <div>
+                              <span className="text-gray-500">Expected:</span>{' '}
+                              <span className="font-mono">{deviation.expected}</span>
+                            </div>
+                            <div>
+                              <span className="text-gray-500">Actual:</span>{' '}
+                              <span className="font-mono">{deviation.actual}</span>
+                            </div>
+                          </div>
+                        </div>
+                      );
+                    })}
+                  </div>
+                </div>
+              )}
+
+              {/* AVS Attestation */}
+              <div className="border border-gray-200 rounded-lg p-4">
+                <h4 className="text-sm font-medium text-gray-900 mb-4">AVS Attestation</h4>
+                <div className="space-y-3">
+                  <div className="flex items-center justify-between">
+                    <span className="text-sm text-gray-600">Attestation ID</span>
+                    <span className="text-sm font-mono text-gray-900">{result.attestation.attestationId}</span>
+                  </div>
+                  <div className="flex items-center justify-between">
+                    <span className="text-sm text-gray-600">Consensus</span>
+                    <span className={`text-sm font-medium ${result.attestation.consensus >= 66 ? 'text-green-600' : 'text-red-600'}`}>
+                      {result.attestation.consensus}%
+                    </span>
+                  </div>
+                  <div className="flex items-center justify-between">
+                    <span className="text-sm text-gray-600">Timestamp</span>
+                    <span className="text-sm text-gray-900">
+                      {new Date(result.attestation.timestamp * 1000).toLocaleString()}
+                    </span>
+                  </div>
+                  <div>
+                    <p className="text-sm text-gray-600 mb-2">Attesters ({result.attestation.attesters.length})</p>
+                    <div className="flex flex-wrap gap-2">
+                      {result.attestation.attesters.map((attester, index) => (
+                        <span
+                          key={index}
+                          className="px-2 py-1 bg-gray-100 rounded text-xs font-mono text-gray-700"
+                        >
+                          {attester.slice(0, 6)}...{attester.slice(-4)}
+                        </span>
+                      ))}
+                    </div>
+                  </div>
+                </div>
+              </div>
+
+              {/* Actions */}
+              <div className="flex gap-4">
+                <button
+                  onClick={() => setResult(null)}
+                  className="flex-1 px-4 py-2 border border-gray-300 text-gray-700 rounded-lg hover:bg-gray-50 transition-colors"
+                >
+                  Run Another Test
+                </button>
+                <button
+                  onClick={onClose}
+                  className="flex-1 px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition-colors"
+                >
+                  Done
+                </button>
+              </div>
+            </div>
+          )}
+        </div>
+
+        {/* Footer */}
+        {!result && (
+          <div className="p-6 border-t border-gray-200 bg-gray-50">
+            <p className="text-xs text-gray-500 text-center">
+              AVS operators will execute your test parameters against the hook and provide
+              an attestation on the results. The accuracy score reflects how closely the
+              actual behavior matches the hook specification.
+            </p>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+};
+
+export default FunctionalityTester;
diff --git a/client2/src/components/market/HookBrowser.tsx b/client2/src/components/market/HookBrowser.tsx
new file mode 100644
index 000000000..d8183dcdd
--- /dev/null
+++ b/client2/src/components/market/HookBrowser.tsx
@@ -0,0 +1,636 @@
+import { useState, useMemo } from 'react';
+import {
+  Search,
+  Filter,
+  Grid,
+  List,
+  CheckCircle,
+  Shield,
+  Lock,
+  Tag,
+  Users,
+  ChevronDown
+} from 'lucide-react';
+import type {
+  HookListingSummary,
+  HookCategory,
+  PricingModel
+} from '../../types/hookSpec';
+import { HOOK_CATEGORIES } from '../../types/hookSpec';
+
+interface HookBrowserProps {
+  hooks: HookListingSummary[];
+  onSelectHook: (hook: HookListingSummary) => void;
+  selectedHookId?: number;
+  isLoading?: boolean;
+}
+
+type ViewMode = 'grid' | 'list';
+
+interface Filters {
+  category: HookCategory | 'ALL';
+  verified: boolean | null;
+  minComplianceScore: number;
+  pricingModel: PricingModel | 'ALL';
+  searchQuery: string;
+}
+
+export default function HookBrowser({
+  hooks,
+  onSelectHook,
+  selectedHookId,
+  isLoading
+}: HookBrowserProps) {
+  const [viewMode, setViewMode] = useState<ViewMode>('grid');
+  const [filters, setFilters] = useState<Filters>({
+    category: 'ALL',
+    verified: null,
+    minComplianceScore: 0,
+    pricingModel: 'ALL',
+    searchQuery: ''
+  });
+  const [showFilters, setShowFilters] = useState(false);
+
+  const filteredHooks = useMemo(() => {
+    return hooks.filter(hook => {
+      // Search filter
+      if (filters.searchQuery) {
+        const query = filters.searchQuery.toLowerCase();
+        const matchesSearch =
+          hook.name.toLowerCase().includes(query) ||
+          hook.description?.toLowerCase().includes(query) ||
+          hook.tags?.some(tag => tag.toLowerCase().includes(query));
+        if (!matchesSearch) return false;
+      }
+
+      // Category filter
+      if (filters.category !== 'ALL' && hook.category !== filters.category) {
+        return false;
+      }
+
+      // Verified filter
+      if (filters.verified !== null && hook.verified !== filters.verified) {
+        return false;
+      }
+
+      // Compliance score filter
+      if (filters.minComplianceScore > 0) {
+        if (!hook.complianceScore || hook.complianceScore < filters.minComplianceScore) {
+          return false;
+        }
+      }
+
+      // Pricing model filter
+      if (filters.pricingModel !== 'ALL' && hook.pricing.model !== filters.pricingModel) {
+        return false;
+      }
+
+      return true;
+    });
+  }, [hooks, filters]);
+
+  const formatPrice = (hook: HookListingSummary) => {
+    const { pricing } = hook;
+    if (pricing.model === 'FIXED' && pricing.fixedPrice) {
+      const ethValue = parseFloat(pricing.fixedPrice) / 1e18;
+      return `${ethValue.toFixed(4)} ETH`;
+    }
+    if (pricing.model === 'REVENUE_SHARE' && pricing.revenueShareBps) {
+      return `${(pricing.revenueShareBps / 100).toFixed(2)}% Rev Share`;
+    }
+    if (pricing.model === 'HYBRID') {
+      const parts = [];
+      if (pricing.fixedPrice) {
+        const ethValue = parseFloat(pricing.fixedPrice) / 1e18;
+        parts.push(`${ethValue.toFixed(4)} ETH`);
+      }
+      if (pricing.revenueShareBps) {
+        parts.push(`${(pricing.revenueShareBps / 100).toFixed(2)}%`);
+      }
+      return parts.join(' + ');
+    }
+    return 'Contact';
+  };
+
+  const getCategoryLabel = (category: HookCategory) => {
+    return HOOK_CATEGORIES.find(c => c.value === category)?.label || category;
+  };
+
+  return (
+    <div
+      className="angular-clip"
+      style={{
+        background: 'var(--color-white)',
+        border: '2px solid var(--color-secondary)',
+        padding: 'var(--space-lg)'
+      }}
+    >
+      {/* Header */}
+      <div className="flex flex-col md:flex-row md:items-center justify-between gap-4 mb-6">
+        <h2
+          className="font-heading"
+          style={{
+            color: 'var(--color-secondary)',
+            fontSize: 'var(--font-size-h4)',
+            fontWeight: 'var(--font-weight-bold)'
+          }}
+        >
+          Hook Marketplace
+        </h2>
+
+        <div className="flex items-center gap-3">
+          {/* View Toggle */}
+          <div className="flex">
+            <button
+              onClick={() => setViewMode('grid')}
+              className="angular-clip p-2"
+              style={{
+                background: viewMode === 'grid' ? 'var(--color-primary)' : 'var(--color-marble-light)',
+                color: viewMode === 'grid' ? 'var(--color-secondary)' : 'var(--color-accent)',
+                border: '1px solid var(--color-accent)'
+              }}
+            >
+              <Grid size={18} />
+            </button>
+            <button
+              onClick={() => setViewMode('list')}
+              className="angular-clip p-2"
+              style={{
+                background: viewMode === 'list' ? 'var(--color-primary)' : 'var(--color-marble-light)',
+                color: viewMode === 'list' ? 'var(--color-secondary)' : 'var(--color-accent)',
+                border: '1px solid var(--color-accent)'
+              }}
+            >
+              <List size={18} />
+            </button>
+          </div>
+        </div>
+      </div>
+
+      {/* Search and Filters */}
+      <div className="space-y-4 mb-6">
+        {/* Search Bar */}
+        <div className="flex gap-3">
+          <div className="flex-1 relative">
+            <Search
+              size={18}
+              className="absolute left-3 top-1/2 -translate-y-1/2"
+              style={{ color: 'var(--color-accent)' }}
+            />
+            <input
+              type="text"
+              placeholder="Search hooks by name, description, or tags..."
+              value={filters.searchQuery}
+              onChange={(e) => setFilters({ ...filters, searchQuery: e.target.value })}
+              className="angular-clip w-full pl-10 pr-4 py-2 font-body"
+              style={{
+                background: 'var(--color-marble-light)',
+                border: '1px solid var(--color-accent)',
+                color: 'var(--color-secondary)',
+                fontSize: 'var(--font-size-body-sm)'
+              }}
+            />
+          </div>
+          <button
+            onClick={() => setShowFilters(!showFilters)}
+            className="angular-clip px-4 py-2 flex items-center gap-2"
+            style={{
+              background: showFilters ? 'var(--color-primary)' : 'var(--color-marble-light)',
+              color: showFilters ? 'var(--color-secondary)' : 'var(--color-accent)',
+              border: '1px solid var(--color-accent)'
+            }}
+          >
+            <Filter size={18} />
+            <span className="font-heading text-sm">Filters</span>
+            <ChevronDown
+              size={16}
+              style={{
+                transform: showFilters ? 'rotate(180deg)' : 'rotate(0deg)',
+                transition: 'transform 0.2s'
+              }}
+            />
+          </button>
+        </div>
+
+        {/* Filter Panel */}
+        {showFilters && (
+          <div
+            className="angular-clip p-4 grid grid-cols-1 md:grid-cols-4 gap-4"
+            style={{
+              background: 'var(--color-marble-light)',
+              border: '1px solid var(--color-accent)'
+            }}
+          >
+            {/* Category Filter */}
+            <div>
+              <label
+                className="font-heading block mb-2"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Category
+              </label>
+              <select
+                value={filters.category}
+                onChange={(e) => setFilters({ ...filters, category: e.target.value as HookCategory | 'ALL' })}
+                className="angular-clip w-full px-3 py-2 font-body"
+                style={{
+                  background: 'var(--color-white)',
+                  border: '1px solid var(--color-accent)',
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              >
+                <option value="ALL">All Categories</option>
+                {HOOK_CATEGORIES.map(cat => (
+                  <option key={cat.value} value={cat.value}>{cat.label}</option>
+                ))}
+              </select>
+            </div>
+
+            {/* Pricing Filter */}
+            <div>
+              <label
+                className="font-heading block mb-2"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Pricing Model
+              </label>
+              <select
+                value={filters.pricingModel}
+                onChange={(e) => setFilters({ ...filters, pricingModel: e.target.value as PricingModel | 'ALL' })}
+                className="angular-clip w-full px-3 py-2 font-body"
+                style={{
+                  background: 'var(--color-white)',
+                  border: '1px solid var(--color-accent)',
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              >
+                <option value="ALL">All Pricing</option>
+                <option value="FIXED">Fixed Price</option>
+                <option value="REVENUE_SHARE">Revenue Share</option>
+                <option value="HYBRID">Hybrid</option>
+              </select>
+            </div>
+
+            {/* Verified Filter */}
+            <div>
+              <label
+                className="font-heading block mb-2"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Verification
+              </label>
+              <select
+                value={filters.verified === null ? 'ALL' : filters.verified ? 'VERIFIED' : 'UNVERIFIED'}
+                onChange={(e) => {
+                  const val = e.target.value;
+                  setFilters({
+                    ...filters,
+                    verified: val === 'ALL' ? null : val === 'VERIFIED'
+                  });
+                }}
+                className="angular-clip w-full px-3 py-2 font-body"
+                style={{
+                  background: 'var(--color-white)',
+                  border: '1px solid var(--color-accent)',
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body-sm)'
+                }}
+              >
+                <option value="ALL">All</option>
+                <option value="VERIFIED">Verified Only</option>
+                <option value="UNVERIFIED">Unverified</option>
+              </select>
+            </div>
+
+            {/* Min Compliance Score */}
+            <div>
+              <label
+                className="font-heading block mb-2"
+                style={{
+                  color: 'var(--color-accent)',
+                  fontSize: 'var(--font-size-caption)',
+                  textTransform: 'uppercase'
+                }}
+              >
+                Min Compliance: {filters.minComplianceScore}%
+              </label>
+              <input
+                type="range"
+                min="0"
+                max="100"
+                value={filters.minComplianceScore}
+                onChange={(e) => setFilters({ ...filters, minComplianceScore: parseInt(e.target.value) })}
+                className="w-full"
+              />
+            </div>
+          </div>
+        )}
+      </div>
+
+      {/* Results Count */}
+      <div className="mb-4">
+        <span
+          className="font-body"
+          style={{
+            color: 'var(--color-accent)',
+            fontSize: 'var(--font-size-body-sm)'
+          }}
+        >
+          {filteredHooks.length} hooks found
+        </span>
+      </div>
+
+      {/* Loading State */}
+      {isLoading && (
+        <div className="text-center py-12">
+          <div
+            className="w-12 h-12 mx-auto mb-4 angular-clip animate-pulse"
+            style={{ background: 'var(--color-primary)' }}
+          />
+          <p
+            className="font-body"
+            style={{ color: 'var(--color-accent)' }}
+          >
+            Loading hooks...
+          </p>
+        </div>
+      )}
+
+      {/* Hook Grid/List */}
+      {!isLoading && (
+        <div className={viewMode === 'grid'
+          ? 'grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4'
+          : 'space-y-3'
+        }>
+          {filteredHooks.map(hook => (
+            <button
+              key={hook.tokenId}
+              onClick={() => onSelectHook(hook)}
+              className={`angular-clip text-left transition-all duration-200 ${
+                viewMode === 'grid' ? 'p-4' : 'p-4 flex items-center gap-4'
+              }`}
+              style={{
+                background: selectedHookId === hook.tokenId
+                  ? 'var(--color-primary)'
+                  : 'var(--color-marble-light)',
+                border: selectedHookId === hook.tokenId
+                  ? '2px solid var(--color-secondary)'
+                  : '1px solid var(--color-accent)',
+                width: '100%'
+              }}
+            >
+              {viewMode === 'grid' ? (
+                // Grid View
+                <>
+                  {/* Header */}
+                  <div className="flex items-start justify-between mb-3">
+                    <div>
+                      <h3
+                        className="font-heading"
+                        style={{
+                          color: 'var(--color-secondary)',
+                          fontSize: 'var(--font-size-body)',
+                          fontWeight: 'var(--font-weight-bold)'
+                        }}
+                      >
+                        {hook.name}
+                      </h3>
+                      <span
+                        className="font-mono"
+                        style={{
+                          color: 'var(--color-accent)',
+                          fontSize: 'var(--font-size-caption)'
+                        }}
+                      >
+                        v{hook.version}
+                      </span>
+                    </div>
+                    <div className="flex gap-1">
+                      {hook.verified && (
+                        <div title="Verified">
+                          <CheckCircle size={16} style={{ color: 'var(--color-primary)' }} />
+                        </div>
+                      )}
+                      {hook.cfheDeployed && (
+                        <div title="CFHE Deployed">
+                          <Lock size={16} style={{ color: 'var(--color-secondary)' }} />
+                        </div>
+                      )}
+                    </div>
+                  </div>
+
+                  {/* Category Badge */}
+                  <div className="mb-3">
+                    <span
+                      className="angular-clip inline-block px-2 py-1 font-heading"
+                      style={{
+                        background: 'var(--color-secondary)',
+                        color: 'var(--color-primary)',
+                        fontSize: '10px',
+                        textTransform: 'uppercase'
+                      }}
+                    >
+                      {getCategoryLabel(hook.category)}
+                    </span>
+                  </div>
+
+                  {/* Description */}
+                  {hook.description && (
+                    <p
+                      className="font-body mb-3 line-clamp-2"
+                      style={{
+                        color: 'var(--color-black)',
+                        fontSize: 'var(--font-size-caption)'
+                      }}
+                    >
+                      {hook.description}
+                    </p>
+                  )}
+
+                  {/* Stats */}
+                  <div className="flex items-center justify-between">
+                    <div className="flex items-center gap-1">
+                      {hook.complianceScore !== undefined && (
+                        <div className="flex items-center gap-1">
+                          <Shield size={14} style={{ color: 'var(--color-accent)' }} />
+                          <span
+                            className="font-mono"
+                            style={{
+                              color: 'var(--color-secondary)',
+                              fontSize: 'var(--font-size-caption)'
+                            }}
+                          >
+                            {hook.complianceScore}%
+                          </span>
+                        </div>
+                      )}
+                    </div>
+                    <div className="flex items-center gap-1">
+                      <Users size={14} style={{ color: 'var(--color-accent)' }} />
+                      <span
+                        className="font-mono"
+                        style={{
+                          color: 'var(--color-secondary)',
+                          fontSize: 'var(--font-size-caption)'
+                        }}
+                      >
+                        {hook.subscriptionCount}
+                      </span>
+                    </div>
+                  </div>
+
+                  {/* Price */}
+                  <div
+                    className="mt-3 pt-3"
+                    style={{ borderTop: '1px solid var(--color-accent)' }}
+                  >
+                    <span
+                      className="font-heading"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-body-sm)',
+                        fontWeight: 'var(--font-weight-bold)'
+                      }}
+                    >
+                      {formatPrice(hook)}
+                    </span>
+                  </div>
+                </>
+              ) : (
+                // List View
+                <>
+                  {/* Icon */}
+                  <div
+                    className="angular-clip w-12 h-12 flex-shrink-0 flex items-center justify-center"
+                    style={{
+                      background: 'var(--color-secondary)',
+                      color: 'var(--color-primary)'
+                    }}
+                  >
+                    <Tag size={20} />
+                  </div>
+
+                  {/* Info */}
+                  <div className="flex-1 min-w-0">
+                    <div className="flex items-center gap-2 mb-1">
+                      <h3
+                        className="font-heading truncate"
+                        style={{
+                          color: 'var(--color-secondary)',
+                          fontSize: 'var(--font-size-body)',
+                          fontWeight: 'var(--font-weight-bold)'
+                        }}
+                      >
+                        {hook.name}
+                      </h3>
+                      <span
+                        className="font-mono flex-shrink-0"
+                        style={{
+                          color: 'var(--color-accent)',
+                          fontSize: 'var(--font-size-caption)'
+                        }}
+                      >
+                        v{hook.version}
+                      </span>
+                      {hook.verified && <CheckCircle size={14} style={{ color: 'var(--color-primary)' }} />}
+                      {hook.cfheDeployed && <Lock size={14} style={{ color: 'var(--color-secondary)' }} />}
+                    </div>
+                    <p
+                      className="font-body truncate"
+                      style={{
+                        color: 'var(--color-black)',
+                        fontSize: 'var(--font-size-caption)'
+                      }}
+                    >
+                      {hook.description || 'No description'}
+                    </p>
+                  </div>
+
+                  {/* Category */}
+                  <span
+                    className="angular-clip px-2 py-1 font-heading flex-shrink-0"
+                    style={{
+                      background: 'var(--color-secondary)',
+                      color: 'var(--color-primary)',
+                      fontSize: '10px',
+                      textTransform: 'uppercase'
+                    }}
+                  >
+                    {getCategoryLabel(hook.category)}
+                  </span>
+
+                  {/* Stats */}
+                  <div className="flex items-center gap-3 flex-shrink-0">
+                    {hook.complianceScore !== undefined && (
+                      <div className="flex items-center gap-1">
+                        <Shield size={14} style={{ color: 'var(--color-accent)' }} />
+                        <span className="font-mono text-xs">{hook.complianceScore}%</span>
+                      </div>
+                    )}
+                    <div className="flex items-center gap-1">
+                      <Users size={14} style={{ color: 'var(--color-accent)' }} />
+                      <span className="font-mono text-xs">{hook.subscriptionCount}</span>
+                    </div>
+                  </div>
+
+                  {/* Price */}
+                  <div className="flex-shrink-0 text-right">
+                    <span
+                      className="font-heading"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-body-sm)',
+                        fontWeight: 'var(--font-weight-bold)'
+                      }}
+                    >
+                      {formatPrice(hook)}
+                    </span>
+                  </div>
+                </>
+              )}
+            </button>
+          ))}
+        </div>
+      )}
+
+      {/* Empty State */}
+      {!isLoading && filteredHooks.length === 0 && (
+        <div className="text-center py-12">
+          <Tag size={48} className="mx-auto mb-4" style={{ color: 'var(--color-accent)' }} />
+          <p
+            className="font-heading mb-2"
+            style={{
+              color: 'var(--color-secondary)',
+              fontSize: 'var(--font-size-body)'
+            }}
+          >
+            No hooks found
+          </p>
+          <p
+            className="font-body"
+            style={{
+              color: 'var(--color-accent)',
+              fontSize: 'var(--font-size-body-sm)'
+            }}
+          >
+            Try adjusting your filters or search query
+          </p>
+        </div>
+      )}
+    </div>
+  );
+}
diff --git a/client2/src/components/market/HookLens.tsx b/client2/src/components/market/HookLens.tsx
new file mode 100644
index 000000000..fdeabbad8
--- /dev/null
+++ b/client2/src/components/market/HookLens.tsx
@@ -0,0 +1,713 @@
+import { useState } from 'react';
+import {
+  X,
+  Shield,
+  Lock,
+  DollarSign,
+  Users,
+  Code,
+  CheckCircle,
+  ExternalLink,
+  Copy,
+  AlertTriangle,
+  Play,
+  FileCode
+} from 'lucide-react';
+import type {
+  HookListing,
+  HookCallback,
+  PoolDeployment
+} from '../../types/hookSpec';
+import { HOOK_CATEGORIES } from '../../types/hookSpec';
+
+interface HookLensProps {
+  hook: HookListing | null;
+  pools?: PoolDeployment[];
+  onClose: () => void;
+  onSubscribe: (hookTokenId: number, poolId: string) => void;
+  onVerifyBytecode: (hookTokenId: number) => void;
+  onTestFunctionality: (hookTokenId: number) => void;
+  walletConnected: boolean;
+  subscribing?: boolean;
+}
+
+export default function HookLens({
+  hook,
+  pools = [],
+  onClose,
+  onSubscribe,
+  onVerifyBytecode,
+  onTestFunctionality,
+  walletConnected,
+  subscribing
+}: HookLensProps) {
+  const [selectedPoolId, setSelectedPoolId] = useState<string>('');
+  const [activeTab, setActiveTab] = useState<'overview' | 'capabilities' | 'pricing'>('overview');
+
+  if (!hook) return null;
+
+  const formatPrice = () => {
+    const { pricing } = hook;
+    if (pricing.model === 'FIXED' && pricing.fixedPrice) {
+      const ethValue = parseFloat(pricing.fixedPrice) / 1e18;
+      return `${ethValue.toFixed(4)} ETH`;
+    }
+    if (pricing.model === 'REVENUE_SHARE' && pricing.revenueShareBps) {
+      return `${(pricing.revenueShareBps / 100).toFixed(2)}% Revenue Share`;
+    }
+    if (pricing.model === 'HYBRID') {
+      const parts = [];
+      if (pricing.fixedPrice) {
+        const ethValue = parseFloat(pricing.fixedPrice) / 1e18;
+        parts.push(`${ethValue.toFixed(4)} ETH`);
+      }
+      if (pricing.revenueShareBps) {
+        parts.push(`${(pricing.revenueShareBps / 100).toFixed(2)}% Rev Share`);
+      }
+      return parts.join(' + ');
+    }
+    return 'Contact Developer';
+  };
+
+  const getCategoryLabel = () => {
+    return HOOK_CATEGORIES.find(c => c.value === hook.metadata.category)?.label || hook.metadata.category;
+  };
+
+  const copyToClipboard = (text: string) => {
+    navigator.clipboard.writeText(text);
+  };
+
+  const getCallbackDescription = (callback: HookCallback): string => {
+    const descriptions: Record<HookCallback, string> = {
+      beforeInitialize: 'Called before pool initialization',
+      afterInitialize: 'Called after pool initialization',
+      beforeAddLiquidity: 'Called before adding liquidity',
+      afterAddLiquidity: 'Called after adding liquidity',
+      beforeRemoveLiquidity: 'Called before removing liquidity',
+      afterRemoveLiquidity: 'Called after removing liquidity',
+      beforeSwap: 'Called before swap execution',
+      afterSwap: 'Called after swap execution',
+      beforeDonate: 'Called before donation',
+      afterDonate: 'Called after donation'
+    };
+    return descriptions[callback];
+  };
+
+  return (
+    <div
+      className="fixed inset-0 z-50 flex items-center justify-center p-4"
+      style={{ background: 'rgba(0, 0, 0, 0.5)' }}
+      onClick={onClose}
+    >
+      <div
+        className="angular-clip w-full max-w-4xl max-h-[90vh] overflow-y-auto"
+        style={{
+          background: 'var(--color-white)',
+          border: '2px solid var(--color-secondary)'
+        }}
+        onClick={(e) => e.stopPropagation()}
+      >
+        {/* Header */}
+        <div
+          className="sticky top-0 p-6 flex items-start justify-between"
+          style={{
+            background: 'var(--color-secondary)',
+            borderBottom: '2px solid var(--color-primary)'
+          }}
+        >
+          <div>
+            <div className="flex items-center gap-3 mb-2">
+              <h2
+                className="font-heading"
+                style={{
+                  color: 'var(--color-primary)',
+                  fontSize: 'var(--font-size-h3)',
+                  fontWeight: 'var(--font-weight-bold)'
+                }}
+              >
+                {hook.metadata.name}
+              </h2>
+              <span
+                className="angular-clip px-2 py-1 font-mono"
+                style={{
+                  background: 'var(--color-primary)',
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-caption)'
+                }}
+              >
+                v{hook.metadata.version}
+              </span>
+              {hook.verification.codeVerified && (
+                <div
+                  className="flex items-center gap-1"
+                  title="AVS Verified"
+                >
+                  <CheckCircle size={18} style={{ color: 'var(--color-primary)' }} />
+                </div>
+              )}
+              {hook.verification.cfheDeployed && (
+                <div
+                  className="flex items-center gap-1"
+                  title="CFHE Encrypted"
+                >
+                  <Lock size={18} style={{ color: 'var(--color-primary)' }} />
+                </div>
+              )}
+            </div>
+            <div className="flex items-center gap-3">
+              <span
+                className="angular-clip px-2 py-1 font-heading"
+                style={{
+                  background: 'var(--color-primary)',
+                  color: 'var(--color-secondary)',
+                  fontSize: '10px',
+                  textTransform: 'uppercase'
+                }}
+              >
+                {getCategoryLabel()}
+              </span>
+              <span
+                className="font-body"
+                style={{
+                  color: 'var(--color-marble-light)',
+                  fontSize: 'var(--font-size-caption)'
+                }}
+              >
+                Token #{hook.tokenId}
+              </span>
+            </div>
+          </div>
+          <button
+            onClick={onClose}
+            className="p-2 transition-colors"
+            style={{ color: 'var(--color-primary)' }}
+          >
+            <X size={24} />
+          </button>
+        </div>
+
+        {/* Tabs */}
+        <div
+          className="flex border-b"
+          style={{ borderColor: 'var(--color-accent)' }}
+        >
+          {(['overview', 'capabilities', 'pricing'] as const).map(tab => (
+            <button
+              key={tab}
+              onClick={() => setActiveTab(tab)}
+              className="px-6 py-3 font-heading uppercase tracking-wider transition-colors"
+              style={{
+                color: activeTab === tab ? 'var(--color-secondary)' : 'var(--color-accent)',
+                borderBottom: activeTab === tab ? '2px solid var(--color-primary)' : 'none',
+                fontSize: 'var(--font-size-body-sm)',
+                fontWeight: 'var(--font-weight-bold)'
+              }}
+            >
+              {tab}
+            </button>
+          ))}
+        </div>
+
+        {/* Content */}
+        <div className="p-6">
+          {activeTab === 'overview' && (
+            <div className="space-y-6">
+              {/* Description */}
+              <div>
+                <h3
+                  className="font-heading mb-2"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-body)',
+                    fontWeight: 'var(--font-weight-bold)'
+                  }}
+                >
+                  Description
+                </h3>
+                <p
+                  className="font-body"
+                  style={{
+                    color: 'var(--color-black)',
+                    fontSize: 'var(--font-size-body-sm)'
+                  }}
+                >
+                  {hook.metadata.description}
+                </p>
+              </div>
+
+              {/* Developer */}
+              <div
+                className="angular-clip p-4"
+                style={{
+                  background: 'var(--color-marble-light)',
+                  border: '1px solid var(--color-accent)'
+                }}
+              >
+                <span
+                  className="font-heading block mb-2"
+                  style={{
+                    color: 'var(--color-accent)',
+                    fontSize: 'var(--font-size-caption)',
+                    textTransform: 'uppercase'
+                  }}
+                >
+                  Developer
+                </span>
+                <div className="flex items-center gap-2">
+                  <code
+                    className="font-mono"
+                    style={{
+                      color: 'var(--color-secondary)',
+                      fontSize: 'var(--font-size-body-sm)'
+                    }}
+                  >
+                    {hook.developer.slice(0, 6)}...{hook.developer.slice(-4)}
+                  </code>
+                  <button
+                    onClick={() => copyToClipboard(hook.developer)}
+                    className="p-1"
+                    style={{ color: 'var(--color-accent)' }}
+                  >
+                    <Copy size={14} />
+                  </button>
+                </div>
+              </div>
+
+              {/* Verification Status */}
+              <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+                <div
+                  className="angular-clip p-4"
+                  style={{
+                    background: hook.verification.codeVerified
+                      ? 'rgba(255, 215, 0, 0.15)'
+                      : 'var(--color-marble-light)',
+                    border: hook.verification.codeVerified
+                      ? '2px solid var(--color-primary)'
+                      : '1px solid var(--color-accent)'
+                  }}
+                >
+                  <div className="flex items-center gap-2 mb-2">
+                    <Shield size={18} style={{ color: 'var(--color-secondary)' }} />
+                    <span
+                      className="font-heading"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-body-sm)',
+                        fontWeight: 'var(--font-weight-bold)'
+                      }}
+                    >
+                      AVS Verification
+                    </span>
+                  </div>
+                  {hook.verification.codeVerified ? (
+                    <>
+                      <div className="flex items-center gap-2 mb-1">
+                        <CheckCircle size={16} style={{ color: 'var(--color-primary)' }} />
+                        <span
+                          className="font-body"
+                          style={{
+                            color: 'var(--color-black)',
+                            fontSize: 'var(--font-size-caption)'
+                          }}
+                        >
+                          Code Verified
+                        </span>
+                      </div>
+                      {hook.verification.complianceScore !== undefined && (
+                        <div
+                          className="font-heading mt-2"
+                          style={{
+                            color: 'var(--color-secondary)',
+                            fontSize: 'var(--font-size-h4)',
+                            fontWeight: 'var(--font-weight-bold)'
+                          }}
+                        >
+                          {hook.verification.complianceScore}%
+                          <span
+                            className="ml-1 font-body"
+                            style={{
+                              fontSize: 'var(--font-size-caption)',
+                              fontWeight: 'normal'
+                            }}
+                          >
+                            Compliance
+                          </span>
+                        </div>
+                      )}
+                    </>
+                  ) : (
+                    <div className="flex items-center gap-2">
+                      <AlertTriangle size={16} style={{ color: 'var(--color-accent)' }} />
+                      <span
+                        className="font-body"
+                        style={{
+                          color: 'var(--color-accent)',
+                          fontSize: 'var(--font-size-caption)'
+                        }}
+                      >
+                        Not Yet Verified
+                      </span>
+                    </div>
+                  )}
+                </div>
+
+                <div
+                  className="angular-clip p-4"
+                  style={{
+                    background: hook.verification.cfheDeployed
+                      ? 'rgba(255, 215, 0, 0.15)'
+                      : 'var(--color-marble-light)',
+                    border: hook.verification.cfheDeployed
+                      ? '2px solid var(--color-primary)'
+                      : '1px solid var(--color-accent)'
+                  }}
+                >
+                  <div className="flex items-center gap-2 mb-2">
+                    <Lock size={18} style={{ color: 'var(--color-secondary)' }} />
+                    <span
+                      className="font-heading"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-body-sm)',
+                        fontWeight: 'var(--font-weight-bold)'
+                      }}
+                    >
+                      CFHE Deployment
+                    </span>
+                  </div>
+                  {hook.verification.cfheDeployed ? (
+                    <>
+                      <div className="flex items-center gap-2 mb-1">
+                        <CheckCircle size={16} style={{ color: 'var(--color-primary)' }} />
+                        <span
+                          className="font-body"
+                          style={{
+                            color: 'var(--color-black)',
+                            fontSize: 'var(--font-size-caption)'
+                          }}
+                        >
+                          Encrypted Bytecode Deployed
+                        </span>
+                      </div>
+                      {hook.verification.cfheContractAddress && (
+                        <code
+                          className="font-mono block mt-2"
+                          style={{
+                            color: 'var(--color-secondary)',
+                            fontSize: '11px'
+                          }}
+                        >
+                          {hook.verification.cfheContractAddress.slice(0, 10)}...
+                        </code>
+                      )}
+                    </>
+                  ) : (
+                    <div className="flex items-center gap-2">
+                      <AlertTriangle size={16} style={{ color: 'var(--color-accent)' }} />
+                      <span
+                        className="font-body"
+                        style={{
+                          color: 'var(--color-accent)',
+                          fontSize: 'var(--font-size-caption)'
+                        }}
+                      >
+                        Not Deployed
+                      </span>
+                    </div>
+                  )}
+                </div>
+              </div>
+
+              {/* Tags */}
+              {hook.metadata.tags.length > 0 && (
+                <div>
+                  <h3
+                    className="font-heading mb-2"
+                    style={{
+                      color: 'var(--color-accent)',
+                      fontSize: 'var(--font-size-caption)',
+                      textTransform: 'uppercase'
+                    }}
+                  >
+                    Tags
+                  </h3>
+                  <div className="flex flex-wrap gap-2">
+                    {hook.metadata.tags.map(tag => (
+                      <span
+                        key={tag}
+                        className="angular-clip px-2 py-1 font-body"
+                        style={{
+                          background: 'var(--color-marble-light)',
+                          color: 'var(--color-secondary)',
+                          fontSize: 'var(--font-size-caption)',
+                          border: '1px solid var(--color-accent)'
+                        }}
+                      >
+                        {tag}
+                      </span>
+                    ))}
+                  </div>
+                </div>
+              )}
+            </div>
+          )}
+
+          {activeTab === 'capabilities' && (
+            <div className="space-y-4">
+              <h3
+                className="font-heading mb-4"
+                style={{
+                  color: 'var(--color-secondary)',
+                  fontSize: 'var(--font-size-body)',
+                  fontWeight: 'var(--font-weight-bold)'
+                }}
+              >
+                Hook Callbacks
+              </h3>
+              {hook.metadata.capabilities.map((cap, idx) => (
+                <div
+                  key={idx}
+                  className="angular-clip p-4"
+                  style={{
+                    background: 'var(--color-marble-light)',
+                    border: '1px solid var(--color-accent)'
+                  }}
+                >
+                  <div className="flex items-center gap-2 mb-2">
+                    <Code size={16} style={{ color: 'var(--color-secondary)' }} />
+                    <span
+                      className="font-mono"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-body-sm)',
+                        fontWeight: 'var(--font-weight-bold)'
+                      }}
+                    >
+                      {cap.callback}
+                    </span>
+                  </div>
+                  <p
+                    className="font-body mb-2"
+                    style={{
+                      color: 'var(--color-accent)',
+                      fontSize: 'var(--font-size-caption)'
+                    }}
+                  >
+                    {getCallbackDescription(cap.callback)}
+                  </p>
+                  <p
+                    className="font-body"
+                    style={{
+                      color: 'var(--color-black)',
+                      fontSize: 'var(--font-size-body-sm)'
+                    }}
+                  >
+                    {cap.description}
+                  </p>
+                </div>
+              ))}
+            </div>
+          )}
+
+          {activeTab === 'pricing' && (
+            <div className="space-y-6">
+              {/* Pricing Model */}
+              <div
+                className="angular-clip p-6"
+                style={{
+                  background: 'var(--color-primary)',
+                  border: '2px solid var(--color-secondary)'
+                }}
+              >
+                <div className="flex items-center gap-3 mb-4">
+                  <DollarSign size={24} style={{ color: 'var(--color-secondary)' }} />
+                  <h3
+                    className="font-heading"
+                    style={{
+                      color: 'var(--color-secondary)',
+                      fontSize: 'var(--font-size-h4)',
+                      fontWeight: 'var(--font-weight-bold)'
+                    }}
+                  >
+                    HaaS Pricing
+                  </h3>
+                </div>
+
+                <div
+                  className="font-heading mb-4"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-h3)',
+                    fontWeight: 'var(--font-weight-bold)'
+                  }}
+                >
+                  {formatPrice()}
+                </div>
+
+                <div className="space-y-2">
+                  <div className="flex items-center gap-2">
+                    <span
+                      className="font-heading"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-caption)',
+                        textTransform: 'uppercase'
+                      }}
+                    >
+                      Model:
+                    </span>
+                    <span
+                      className="font-body"
+                      style={{
+                        color: 'var(--color-secondary)',
+                        fontSize: 'var(--font-size-body-sm)'
+                      }}
+                    >
+                      {hook.pricing.model === 'FIXED' && 'One-time License Fee'}
+                      {hook.pricing.model === 'REVENUE_SHARE' && 'Percentage of Pool Fees'}
+                      {hook.pricing.model === 'HYBRID' && 'Fixed + Revenue Share'}
+                    </span>
+                  </div>
+                  {hook.pricing.currency && hook.pricing.currency !== '0x0000000000000000000000000000000000000000' && (
+                    <div className="flex items-center gap-2">
+                      <span
+                        className="font-heading"
+                        style={{
+                          color: 'var(--color-secondary)',
+                          fontSize: 'var(--font-size-caption)',
+                          textTransform: 'uppercase'
+                        }}
+                      >
+                        Currency:
+                      </span>
+                      <code
+                        className="font-mono"
+                        style={{
+                          color: 'var(--color-secondary)',
+                          fontSize: 'var(--font-size-caption)'
+                        }}
+                      >
+                        {hook.pricing.currency.slice(0, 6)}...
+                      </code>
+                    </div>
+                  )}
+                </div>
+              </div>
+
+              {/* Pool Selection for Subscription */}
+              <div>
+                <label
+                  className="font-heading block mb-2"
+                  style={{
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-body-sm)',
+                    fontWeight: 'var(--font-weight-bold)'
+                  }}
+                >
+                  Select Pool for Subscription
+                </label>
+                <select
+                  value={selectedPoolId}
+                  onChange={(e) => setSelectedPoolId(e.target.value)}
+                  className="angular-clip w-full px-4 py-3 font-body"
+                  style={{
+                    background: 'var(--color-marble-light)',
+                    border: '1px solid var(--color-accent)',
+                    color: 'var(--color-secondary)',
+                    fontSize: 'var(--font-size-body-sm)'
+                  }}
+                >
+                  <option value="">Select a pool...</option>
+                  {pools.map(pool => (
+                    <option key={pool.poolId} value={pool.poolId}>
+                      Pool {pool.poolId.slice(0, 10)}... (Chain {pool.chainId})
+                    </option>
+                  ))}
+                </select>
+              </div>
+            </div>
+          )}
+        </div>
+
+        {/* Actions Footer */}
+        <div
+          className="sticky bottom-0 p-6 flex flex-wrap gap-3"
+          style={{
+            background: 'var(--color-marble-light)',
+            borderTop: '2px solid var(--color-accent)'
+          }}
+        >
+          {/* Verify Bytecode */}
+          <button
+            onClick={() => onVerifyBytecode(hook.tokenId)}
+            className="angular-clip-button px-4 py-2 flex items-center gap-2 font-heading uppercase tracking-wider transition-all"
+            style={{
+              background: 'var(--color-white)',
+              color: 'var(--color-secondary)',
+              border: '2px solid var(--color-secondary)',
+              fontSize: 'var(--font-size-caption)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            <FileCode size={16} />
+            Verify Bytecode
+          </button>
+
+          {/* Test Functionality */}
+          <button
+            onClick={() => onTestFunctionality(hook.tokenId)}
+            className="angular-clip-button px-4 py-2 flex items-center gap-2 font-heading uppercase tracking-wider transition-all"
+            style={{
+              background: 'var(--color-white)',
+              color: 'var(--color-secondary)',
+              border: '2px solid var(--color-secondary)',
+              fontSize: 'var(--font-size-caption)',
+              fontWeight: 'var(--font-weight-bold)'
+            }}
+          >
+            <Play size={16} />
+            Test with AVS
+          </button>
+
+          {/* Subscribe Button */}
+          <button
+            onClick={() => selectedPoolId && onSubscribe(hook.tokenId, selectedPoolId)}
+            disabled={!walletConnected || !selectedPoolId || subscribing}
+            className="angular-clip-button flex-1 px-6 py-3 flex items-center justify-center gap-2 font-heading uppercase tracking-wider transition-all"
+            style={{
+              background: walletConnected && selectedPoolId
+                ? 'var(--color-primary)'
+                : 'var(--color-accent)',
+              color: 'var(--color-secondary)',
+              border: '2px solid var(--color-secondary)',
+              fontSize: 'var(--font-size-body-sm)',
+              fontWeight: 'var(--font-weight-bold)',
+              opacity: (!walletConnected || !selectedPoolId || subscribing) ? 0.5 : 1,
+              cursor: (!walletConnected || !selectedPoolId || subscribing) ? 'not-allowed' : 'pointer'
+            }}
+          >
+            {subscribing ? (
+              <>
+                <div
+                  className="w-4 h-4 border-2 border-t-transparent rounded-full animate-spin"
+                  style={{ borderColor: 'var(--color-secondary)' }}
+                />
+                Subscribing...
+              </>
+            ) : (
+              <>
+                <Users size={18} />
+                {!walletConnected
+                  ? 'Connect Wallet'
+                  : !selectedPoolId
+                  ? 'Select Pool to Subscribe'
+                  : `Subscribe & Add Hook`
+                }
+              </>
+            )}
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/client2/src/components/market/HookMarketPage.tsx b/client2/src/components/market/HookMarketPage.tsx
new file mode 100644
index 000000000..062f9a0ef
--- /dev/null
+++ b/client2/src/components/market/HookMarketPage.tsx
@@ -0,0 +1,376 @@
+import React, { useState } from 'react';
+import { useNavigate } from 'react-router-dom';
+import HookBrowser from './HookBrowser';
+import HookLens from './HookLens';
+import BytecodeVerifier from './BytecodeVerifier';
+import FunctionalityTester from './FunctionalityTester';
+import {
+  HookListingSummary,
+  HookListing,
+  HookSpec,
+  BytecodeVerificationResult,
+  FunctionalityTestResult,
+} from '../../types/hookSpec';
+
+// Mock hook listings for browsing - replace with actual API calls
+const mockHooks: HookListingSummary[] = [
+  {
+    tokenId: 1,
+    name: 'Dynamic Fee Hook',
+    version: '1.2.0',
+    description: 'Implements dynamic trading fees based on market volatility using a TWAP oracle.',
+    category: 'FEE_MANAGEMENT',
+    developer: '0x1234567890abcdef1234567890abcdef12345678',
+    pricing: {
+      model: 'FIXED',
+      fixedPrice: '100000000000000000',
+      currency: '0x0000000000000000000000000000000000000000',
+    },
+    complianceScore: 98,
+    verified: true,
+    cfheDeployed: true,
+    subscriptionCount: 45,
+    registeredAt: '2024-01-15T10:30:00Z',
+    tags: ['fee', 'dynamic', 'volatility', 'twap'],
+  },
+  {
+    tokenId: 2,
+    name: 'TWAP Oracle Hook',
+    version: '2.0.1',
+    description: 'Time-weighted average price oracle for accurate on-chain price feeds.',
+    category: 'ORACLE',
+    developer: '0xabcdef1234567890abcdef1234567890abcdef12',
+    pricing: {
+      model: 'REVENUE_SHARE',
+      revenueShareBps: 50,
+      currency: '0x0000000000000000000000000000000000000000',
+    },
+    complianceScore: 95,
+    verified: true,
+    cfheDeployed: true,
+    subscriptionCount: 32,
+    registeredAt: '2024-02-20T14:15:00Z',
+    tags: ['oracle', 'twap', 'price'],
+  },
+  {
+    tokenId: 3,
+    name: 'Limit Order Hook',
+    version: '1.0.0',
+    description: 'Enables limit orders and stop-loss functionality on Uniswap v4 pools.',
+    category: 'LIMIT_ORDER',
+    developer: '0x9876543210fedcba9876543210fedcba98765432',
+    pricing: {
+      model: 'HYBRID',
+      fixedPrice: '50000000000000000',
+      revenueShareBps: 25,
+      currency: '0x0000000000000000000000000000000000000000',
+    },
+    complianceScore: 92,
+    verified: true,
+    cfheDeployed: false,
+    subscriptionCount: 18,
+    registeredAt: '2024-03-10T09:00:00Z',
+    tags: ['limit', 'order', 'stop-loss'],
+  },
+  {
+    tokenId: 4,
+    name: 'LP Incentive Hook',
+    version: '1.1.0',
+    description: 'Provides liquidity provider incentives through automatic reward distribution.',
+    category: 'LIQUIDITY',
+    developer: '0xfedcba9876543210fedcba9876543210fedcba98',
+    pricing: {
+      model: 'FIXED',
+      fixedPrice: '200000000000000000',
+      currency: '0x0000000000000000000000000000000000000000',
+    },
+    complianceScore: 88,
+    verified: true,
+    cfheDeployed: true,
+    subscriptionCount: 27,
+    registeredAt: '2024-03-25T16:45:00Z',
+    tags: ['liquidity', 'incentive', 'rewards'],
+  },
+  {
+    tokenId: 5,
+    name: 'MEV Shield Hook',
+    version: '0.9.0',
+    description: 'Protects traders from MEV extraction through commit-reveal schemes.',
+    category: 'MEV_PROTECTION',
+    developer: '0x1111222233334444555566667777888899990000',
+    pricing: {
+      model: 'REVENUE_SHARE',
+      revenueShareBps: 100,
+      currency: '0x0000000000000000000000000000000000000000',
+    },
+    complianceScore: 75,
+    verified: false,
+    cfheDeployed: false,
+    subscriptionCount: 8,
+    registeredAt: '2024-04-01T11:30:00Z',
+    tags: ['mev', 'protection', 'security'],
+  },
+  {
+    tokenId: 6,
+    name: 'Custom Analytics Hook',
+    version: '1.0.0',
+    description: 'Emits detailed analytics events for pool monitoring and dashboards.',
+    category: 'CUSTOM',
+    developer: '0xaaaabbbbccccddddeeeeffffgggghhhhiiiijjjj',
+    pricing: {
+      model: 'FIXED',
+      fixedPrice: '25000000000000000',
+      currency: '0x0000000000000000000000000000000000000000',
+    },
+    complianceScore: 90,
+    verified: true,
+    cfheDeployed: false,
+    subscriptionCount: 12,
+    registeredAt: '2024-04-15T08:00:00Z',
+    tags: ['analytics', 'events', 'monitoring'],
+  },
+];
+
+// Mock detailed hook data - replace with actual API calls
+const mockHookDetails: Record<number, HookListing> = {
+  1: {
+    tokenId: 1,
+    developer: '0x1234567890abcdef1234567890abcdef12345678',
+    registeredAt: '2024-01-15T10:30:00Z',
+    deprecated: false,
+    pricing: {
+      model: 'FIXED',
+      fixedPrice: '100000000000000000',
+      currency: '0x0000000000000000000000000000000000000000',
+    },
+    metadata: {
+      name: 'Dynamic Fee Hook',
+      version: '1.2.0',
+      description: 'Implements dynamic trading fees based on market volatility using a TWAP oracle. Fees automatically adjust to protect liquidity providers during high volatility periods.',
+      category: 'FEE_MANAGEMENT',
+      tags: ['fee', 'dynamic', 'volatility', 'twap'],
+      capabilities: [
+        { callback: 'beforeSwap', description: 'Calculates and applies dynamic fee based on volatility' },
+        { callback: 'afterSwap', description: 'Updates TWAP oracle with new price data' },
+      ],
+    },
+    verification: {
+      codeVerified: true,
+      avsAttestationId: 'avs-123456',
+      complianceScore: 98,
+      cfheDeployed: true,
+      cfheContractAddress: '0xabcdef1234567890abcdef1234567890abcdef12',
+    },
+    spec: {
+      metadata: {
+        name: 'Dynamic Fee Hook',
+        version: '1.2.0',
+        author: 'HookLabs',
+        description: 'Dynamic fee based on volatility',
+        license: 'MIT',
+      },
+      hook_state: [
+        { name: 'lastTwapPrice', symbol: 'P_twap', type: 'uint256', description: 'Last recorded TWAP price' },
+        { name: 'volatility', symbol: 'V', type: 'uint256', description: 'Current volatility measurement' },
+      ],
+      system_functions: [
+        {
+          callback: 'beforeSwap',
+          reads: ['P_twap', 'V'],
+          writes: [],
+          transition: {
+            preconditions: ['V >= 0'],
+            equation: 'fee = base_fee + (V * fee_multiplier)',
+            postconditions: ['fee <= max_fee'],
+          },
+        },
+      ],
+      invariants: [
+        { name: 'fee_bounds', expression: 'fee >= min_fee && fee <= max_fee', description: 'Fee must stay within bounds' },
+      ],
+    },
+  },
+};
+
+const HookMarketPage: React.FC = () => {
+  const navigate = useNavigate();
+
+  // State for selected hook and modals
+  const [selectedHook, setSelectedHook] = useState<HookListing | null>(null);
+  const [showHookLens, setShowHookLens] = useState(false);
+  const [showBytecodeVerifier, setShowBytecodeVerifier] = useState(false);
+  const [showFunctionalityTester, setShowFunctionalityTester] = useState(false);
+
+  // State for verification and test results
+  const [bytecodeResult, setBytecodeResult] = useState<BytecodeVerificationResult | null>(null);
+  const [testResult, setTestResult] = useState<FunctionalityTestResult | null>(null);
+
+  const handleSelectHook = (hook: HookListingSummary) => {
+    // In production, fetch full hook details from API
+    const fullHook = mockHookDetails[hook.tokenId] || {
+      tokenId: hook.tokenId,
+      developer: hook.developer,
+      registeredAt: hook.registeredAt,
+      deprecated: false,
+      pricing: hook.pricing,
+      metadata: {
+        name: hook.name,
+        version: hook.version,
+        description: hook.description || '',
+        category: hook.category,
+        tags: hook.tags || [],
+        capabilities: [],
+      },
+      verification: {
+        codeVerified: hook.verified,
+        complianceScore: hook.complianceScore,
+        cfheDeployed: hook.cfheDeployed,
+      },
+    };
+
+    setSelectedHook(fullHook);
+    setShowHookLens(true);
+  };
+
+  const handleVerifyBytecode = () => {
+    setShowHookLens(false);
+    setShowBytecodeVerifier(true);
+  };
+
+  const handleTestFunctionality = () => {
+    setShowHookLens(false);
+    setShowFunctionalityTester(true);
+  };
+
+  const handleSubscribe = async (poolId: string) => {
+    if (!selectedHook) return;
+
+    // In production, this would generate and execute the addHook transaction
+    console.log('Subscribing to hook', selectedHook.tokenId, 'for pool', poolId);
+
+    // Mock transaction flow
+    alert(`Subscription initiated for hook ${selectedHook.metadata.name} on pool ${poolId}`);
+    setShowHookLens(false);
+  };
+
+  const handleBytecodeVerificationComplete = (result: BytecodeVerificationResult) => {
+    setBytecodeResult(result);
+  };
+
+  const handleTestComplete = (result: FunctionalityTestResult) => {
+    setTestResult(result);
+  };
+
+  const handleCloseBytecodeVerifier = () => {
+    setShowBytecodeVerifier(false);
+    setShowHookLens(true);
+  };
+
+  const handleCloseFunctionalityTester = () => {
+    setShowFunctionalityTester(false);
+    setShowHookLens(true);
+  };
+
+  return (
+    <div className="min-h-screen bg-gray-50">
+      {/* Header */}
+      <header className="bg-white border-b border-gray-200">
+        <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-4">
+          <div className="flex items-center justify-between">
+            <div className="flex items-center gap-4">
+              <button
+                onClick={() => navigate('/protocol-designer')}
+                className="p-2 hover:bg-gray-100 rounded-lg transition-colors"
+              >
+                <svg className="w-5 h-5 text-gray-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 19l-7-7m0 0l7-7m-7 7h18" />
+                </svg>
+              </button>
+              <div>
+                <h1 className="text-2xl font-bold text-gray-900">Hook Marketplace</h1>
+                <p className="text-sm text-gray-500">
+                  Browse, verify, and subscribe to hooks for your pools
+                </p>
+              </div>
+            </div>
+
+            {/* Verification Status Summary */}
+            {(bytecodeResult || testResult) && (
+              <div className="flex items-center gap-4">
+                {bytecodeResult && (
+                  <div className={`flex items-center gap-2 px-3 py-1.5 rounded-full text-sm ${
+                    bytecodeResult.verified ? 'bg-green-100 text-green-800' : 'bg-red-100 text-red-800'
+                  }`}>
+                    {bytecodeResult.verified ? (
+                      <svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
+                      </svg>
+                    ) : (
+                      <svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 14l2-2m0 0l2-2m-2 2l-2-2m2 2l2 2m7-2a9 9 0 11-18 0 9 9 0 0118 0z" />
+                      </svg>
+                    )}
+                    Bytecode {bytecodeResult.verified ? 'Verified' : 'Mismatch'}
+                  </div>
+                )}
+                {testResult && (
+                  <div className={`flex items-center gap-2 px-3 py-1.5 rounded-full text-sm ${
+                    testResult.accuracyScore >= 90 ? 'bg-green-100 text-green-800' :
+                    testResult.accuracyScore >= 70 ? 'bg-yellow-100 text-yellow-800' :
+                    'bg-red-100 text-red-800'
+                  }`}>
+                    <svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z" />
+                    </svg>
+                    AVS Score: {testResult.accuracyScore}%
+                  </div>
+                )}
+              </div>
+            )}
+          </div>
+        </div>
+      </header>
+
+      {/* Main Content */}
+      <main className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
+        <HookBrowser hooks={mockHooks} onSelectHook={handleSelectHook} />
+      </main>
+
+      {/* Hook Lens Modal */}
+      {showHookLens && selectedHook && (
+        <HookLens
+          hook={selectedHook}
+          onClose={() => {
+            setShowHookLens(false);
+            setSelectedHook(null);
+          }}
+          onVerifyBytecode={handleVerifyBytecode}
+          onTestFunctionality={handleTestFunctionality}
+          onSubscribe={handleSubscribe}
+        />
+      )}
+
+      {/* Bytecode Verifier Modal */}
+      {showBytecodeVerifier && selectedHook && (
+        <BytecodeVerifier
+          hookTokenId={selectedHook.tokenId}
+          hookName={selectedHook.metadata.name}
+          onClose={handleCloseBytecodeVerifier}
+          onVerificationComplete={handleBytecodeVerificationComplete}
+        />
+      )}
+
+      {/* Functionality Tester Modal */}
+      {showFunctionalityTester && selectedHook && (
+        <FunctionalityTester
+          hookTokenId={selectedHook.tokenId}
+          hookName={selectedHook.metadata.name}
+          onClose={handleCloseFunctionalityTester}
+          onTestComplete={handleTestComplete}
+        />
+      )}
+    </div>
+  );
+};
+
+export default HookMarketPage;
diff --git a/client2/src/components/market/index.ts b/client2/src/components/market/index.ts
new file mode 100644
index 000000000..9c458fccf
--- /dev/null
+++ b/client2/src/components/market/index.ts
@@ -0,0 +1,5 @@
+export { default as HookMarketPage } from './HookMarketPage';
+export { default as HookBrowser } from './HookBrowser';
+export { default as HookLens } from './HookLens';
+export { default as BytecodeVerifier } from './BytecodeVerifier';
+export { default as FunctionalityTester } from './FunctionalityTester';
diff --git a/client2/src/components/protocol/CreateProtocolDialog.tsx b/client2/src/components/protocol/CreateProtocolDialog.tsx
index b4b40e062..e90e07647 100644
--- a/client2/src/components/protocol/CreateProtocolDialog.tsx
+++ b/client2/src/components/protocol/CreateProtocolDialog.tsx
@@ -125,7 +125,8 @@ export default function CreateProtocolDialog({
       isSwitchingChain.current = false;
       resetProtocolCreation(); // Reset hook state to allow subsequent protocol creations
     }
-  }, [open, resetProtocolCreation]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [open]); // Only depend on open, resetProtocolCreation is stable
 
   // Handle chain selection
   const handleSelectChain = (chainId: number) => {
diff --git a/client2/src/components/protocol/admin/CreatePoolForm.tsx b/client2/src/components/protocol/admin/CreatePoolForm.tsx
new file mode 100644
index 000000000..abb9add28
--- /dev/null
+++ b/client2/src/components/protocol/admin/CreatePoolForm.tsx
@@ -0,0 +1,354 @@
+import React, { useState } from 'react';
+import { ArrowLeft, Info, Plus, Loader2 } from 'lucide-react';
+import {
+  FEE_TIERS,
+  type CreatePoolFormValues,
+} from '../../../types/protocolAdmin';
+
+interface CreatePoolFormProps {
+  protocolId: bigint | null;
+  onSuccess: (poolId: string, initialTick: number) => void;
+  onCancel: () => void;
+}
+
+const CreatePoolForm: React.FC<CreatePoolFormProps> = ({
+  protocolId,
+  onSuccess,
+  onCancel,
+}) => {
+  const [formValues, setFormValues] = useState<CreatePoolFormValues>({
+    token0: '',
+    token1: '',
+    fee: '3000',
+    tickSpacing: '60',
+    hookAddress: '0x0000000000000000000000000000000000000000',
+    initialPrice: '1',
+  });
+  const [isSubmitting, setIsSubmitting] = useState(false);
+  const [errors, setErrors] = useState<Partial<Record<keyof CreatePoolFormValues, string>>>({});
+
+  const validateAddress = (address: string): boolean => {
+    return /^0x[a-fA-F0-9]{40}$/.test(address);
+  };
+
+  const validateForm = (): boolean => {
+    const newErrors: Partial<Record<keyof CreatePoolFormValues, string>> = {};
+
+    if (!validateAddress(formValues.token0)) {
+      newErrors.token0 = 'Invalid address format';
+    }
+    if (!validateAddress(formValues.token1)) {
+      newErrors.token1 = 'Invalid address format';
+    }
+    if (formValues.token0.toLowerCase() === formValues.token1.toLowerCase() && formValues.token0 !== '') {
+      newErrors.token1 = 'Tokens must be different';
+    }
+    if (!formValues.fee) {
+      newErrors.fee = 'Fee tier is required';
+    }
+    if (!formValues.tickSpacing || parseInt(formValues.tickSpacing) <= 0) {
+      newErrors.tickSpacing = 'Tick spacing must be positive';
+    }
+    if (formValues.hookAddress && !validateAddress(formValues.hookAddress)) {
+      newErrors.hookAddress = 'Invalid hook address';
+    }
+    if (!formValues.initialPrice || parseFloat(formValues.initialPrice) <= 0) {
+      newErrors.initialPrice = 'Initial price must be positive';
+    }
+
+    setErrors(newErrors);
+    return Object.keys(newErrors).length === 0;
+  };
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+
+    if (!validateForm() || !protocolId) {
+      return;
+    }
+
+    setIsSubmitting(true);
+
+    try {
+      // In production, this would:
+      // 1. Encode the PoolKey struct
+      // 2. Calculate sqrtPriceX96 from initialPrice
+      // 3. Call create_pool on the contract
+
+      console.log('Creating pool with:', {
+        protocolId: protocolId.toString(),
+        poolKey: {
+          currency0: formValues.token0,
+          currency1: formValues.token1,
+          fee: parseInt(formValues.fee),
+          tickSpacing: parseInt(formValues.tickSpacing),
+          hooks: formValues.hookAddress,
+        },
+        initialPrice: formValues.initialPrice,
+      });
+
+      // Mock success response
+      await new Promise(resolve => setTimeout(resolve, 2000));
+
+      const mockPoolId = '0x' + Math.random().toString(16).slice(2).padEnd(64, '0');
+      const mockInitialTick = 0;
+
+      onSuccess(mockPoolId, mockInitialTick);
+    } catch (error) {
+      console.error('Failed to create pool:', error);
+    } finally {
+      setIsSubmitting(false);
+    }
+  };
+
+  const handleInputChange = (field: keyof CreatePoolFormValues, value: string) => {
+    setFormValues(prev => ({ ...prev, [field]: value }));
+    if (errors[field]) {
+      setErrors(prev => ({ ...prev, [field]: undefined }));
+    }
+  };
+
+  return (
+    <div className="angular-clip" style={{ background: 'var(--color-white)', border: '2px solid var(--color-secondary)' }}>
+      {/* Header */}
+      <div className="px-6 py-4" style={{ borderBottom: '2px solid var(--color-secondary)' }}>
+        <div className="flex items-center gap-4">
+          <button
+            onClick={onCancel}
+            className="p-2 rounded-lg transition-colors"
+            style={{ color: 'var(--color-secondary)' }}
+            aria-label="Back to overview"
+          >
+            <ArrowLeft className="w-5 h-5" />
+          </button>
+          <div>
+            <h2 className="text-xl font-semibold font-heading" style={{ color: 'var(--color-secondary)' }}>
+              Create <span style={{ color: 'var(--color-primary)' }}>Pool</span>
+            </h2>
+            <p className="text-sm font-body" style={{ color: 'var(--color-black)' }}>
+              Deploy a new Uniswap v4 pool for Protocol #{protocolId?.toString()}
+            </p>
+          </div>
+        </div>
+      </div>
+
+      {/* Form */}
+      <form onSubmit={handleSubmit} className="p-6">
+        <div className="space-y-6">
+          {/* Token Pair */}
+          <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+            <div>
+              <label htmlFor="token0" className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+                Token 0 Address
+              </label>
+              <input
+                id="token0"
+                type="text"
+                value={formValues.token0}
+                onChange={(e) => handleInputChange('token0', e.target.value)}
+                placeholder="0x..."
+                className="w-full px-4 py-3 font-mono text-sm angular-clip"
+                style={{
+                  border: `2px solid ${errors.token0 ? 'var(--color-accent)' : 'var(--color-secondary)'}`,
+                  color: 'var(--color-secondary)',
+                  background: 'var(--color-white)',
+                }}
+              />
+              {errors.token0 && (
+                <p className="mt-1 text-sm" style={{ color: 'var(--color-accent)' }}>{errors.token0}</p>
+              )}
+            </div>
+
+            <div>
+              <label htmlFor="token1" className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+                Token 1 Address
+              </label>
+              <input
+                id="token1"
+                type="text"
+                value={formValues.token1}
+                onChange={(e) => handleInputChange('token1', e.target.value)}
+                placeholder="0x..."
+                className="w-full px-4 py-3 font-mono text-sm angular-clip"
+                style={{
+                  border: `2px solid ${errors.token1 ? 'var(--color-accent)' : 'var(--color-secondary)'}`,
+                  color: 'var(--color-secondary)',
+                  background: 'var(--color-white)',
+                }}
+              />
+              {errors.token1 && (
+                <p className="mt-1 text-sm" style={{ color: 'var(--color-accent)' }}>{errors.token1}</p>
+              )}
+            </div>
+          </div>
+
+          {/* Fee Tier */}
+          <div>
+            <label className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+              Fee Tier
+            </label>
+            <div className="grid grid-cols-2 md:grid-cols-4 gap-3">
+              {FEE_TIERS.map((tier) => (
+                <button
+                  key={tier.value}
+                  type="button"
+                  onClick={() => handleInputChange('fee', tier.value)}
+                  className="angular-clip p-4 text-left transition-all"
+                  style={{
+                    border: `2px solid ${formValues.fee === tier.value ? 'var(--color-primary)' : 'var(--color-secondary)'}`,
+                    background: formValues.fee === tier.value ? 'var(--color-primary)' : 'var(--color-white)',
+                  }}
+                >
+                  <div
+                    className="font-semibold font-heading"
+                    style={{ color: formValues.fee === tier.value ? 'var(--color-secondary)' : 'var(--color-secondary)' }}
+                  >
+                    {tier.label}
+                  </div>
+                  <div
+                    className="text-xs mt-1 font-body"
+                    style={{ color: formValues.fee === tier.value ? 'var(--color-secondary)' : 'var(--color-black)' }}
+                  >
+                    {tier.description}
+                  </div>
+                </button>
+              ))}
+            </div>
+          </div>
+
+          {/* Tick Spacing & Hook */}
+          <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+            <div>
+              <label htmlFor="tickSpacing" className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+                Tick Spacing
+              </label>
+              <input
+                id="tickSpacing"
+                type="number"
+                value={formValues.tickSpacing}
+                onChange={(e) => handleInputChange('tickSpacing', e.target.value)}
+                placeholder="60"
+                className="w-full px-4 py-3 angular-clip"
+                style={{
+                  border: `2px solid ${errors.tickSpacing ? 'var(--color-accent)' : 'var(--color-secondary)'}`,
+                  color: 'var(--color-secondary)',
+                  background: 'var(--color-white)',
+                }}
+              />
+              {errors.tickSpacing && (
+                <p className="mt-1 text-sm" style={{ color: 'var(--color-accent)' }}>{errors.tickSpacing}</p>
+              )}
+              <p className="mt-1 text-xs font-body" style={{ color: 'var(--color-black)' }}>
+                Determines price granularity. Common values: 1, 10, 60, 200
+              </p>
+            </div>
+
+            <div>
+              <label htmlFor="hookAddress" className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+                Hook Address (Optional)
+              </label>
+              <input
+                id="hookAddress"
+                type="text"
+                value={formValues.hookAddress}
+                onChange={(e) => handleInputChange('hookAddress', e.target.value)}
+                placeholder="0x0000...0000"
+                className="w-full px-4 py-3 font-mono text-sm angular-clip"
+                style={{
+                  border: `2px solid ${errors.hookAddress ? 'var(--color-accent)' : 'var(--color-secondary)'}`,
+                  color: 'var(--color-secondary)',
+                  background: 'var(--color-white)',
+                }}
+              />
+              {errors.hookAddress && (
+                <p className="mt-1 text-sm" style={{ color: 'var(--color-accent)' }}>{errors.hookAddress}</p>
+              )}
+              <p className="mt-1 text-xs font-body" style={{ color: 'var(--color-black)' }}>
+                Leave as zero address for no hook
+              </p>
+            </div>
+          </div>
+
+          {/* Initial Price */}
+          <div>
+            <label htmlFor="initialPrice" className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+              Initial Price (Token1/Token0)
+            </label>
+            <input
+              id="initialPrice"
+              type="text"
+              value={formValues.initialPrice}
+              onChange={(e) => handleInputChange('initialPrice', e.target.value)}
+              placeholder="1.0"
+              className="w-full px-4 py-3 angular-clip"
+              style={{
+                border: `2px solid ${errors.initialPrice ? 'var(--color-accent)' : 'var(--color-secondary)'}`,
+                color: 'var(--color-secondary)',
+                background: 'var(--color-white)',
+              }}
+            />
+            {errors.initialPrice && (
+              <p className="mt-1 text-sm" style={{ color: 'var(--color-accent)' }}>{errors.initialPrice}</p>
+            )}
+            <p className="mt-1 text-xs font-body" style={{ color: 'var(--color-black)' }}>
+              The starting price ratio between the two tokens
+            </p>
+          </div>
+
+          {/* Info Box */}
+          <div className="angular-clip p-4 flex gap-3" style={{ background: 'var(--color-marble-light)', border: '2px solid var(--color-secondary)' }}>
+            <Info className="w-5 h-5 flex-shrink-0 mt-0.5" style={{ color: 'var(--color-secondary)' }} />
+            <div className="text-sm" style={{ color: 'var(--color-secondary)' }}>
+              <p className="font-medium font-heading mb-1">Before creating a pool:</p>
+              <ul className="list-disc list-inside space-y-1 font-body" style={{ color: 'var(--color-black)' }}>
+                <li>Ensure both token contracts are deployed and verified</li>
+                <li>Token0 address must be less than Token1 (sorted)</li>
+                <li>Hook address must match the pool's hook permissions</li>
+              </ul>
+            </div>
+          </div>
+        </div>
+
+        {/* Actions */}
+        <div className="flex justify-end gap-4 mt-8 pt-6" style={{ borderTop: '2px solid var(--color-secondary)' }}>
+          <button
+            type="button"
+            onClick={onCancel}
+            className="angular-clip-button px-6 py-3 font-medium font-heading uppercase tracking-wider transition-all"
+            style={{
+              background: 'var(--color-white)',
+              color: 'var(--color-secondary)',
+              border: '2px solid var(--color-secondary)',
+            }}
+          >
+            Cancel
+          </button>
+          <button
+            type="submit"
+            disabled={isSubmitting || !protocolId}
+            className="angular-clip-button px-6 py-3 font-medium font-heading uppercase tracking-wider transition-all flex items-center gap-2 disabled:opacity-50 disabled:cursor-not-allowed"
+            style={{
+              background: 'var(--color-primary)',
+              color: 'var(--color-secondary)',
+              border: '2px solid var(--color-secondary)',
+            }}
+          >
+            {isSubmitting ? (
+              <>
+                <Loader2 className="w-5 h-5 animate-spin" />
+                Creating Pool...
+              </>
+            ) : (
+              <>
+                <Plus className="w-5 h-5" />
+                Create Pool
+              </>
+            )}
+          </button>
+        </div>
+      </form>
+    </div>
+  );
+};
+
+export default CreatePoolForm;
diff --git a/client2/src/components/protocol/admin/ManagerSection.tsx b/client2/src/components/protocol/admin/ManagerSection.tsx
new file mode 100644
index 000000000..40877a027
--- /dev/null
+++ b/client2/src/components/protocol/admin/ManagerSection.tsx
@@ -0,0 +1,317 @@
+import React, { useState } from 'react';
+import { ArrowLeft, Users, Link2, Layers, Loader2, Check, ExternalLink } from 'lucide-react';
+import {
+  URIType,
+  URI_TYPE_LABELS,
+  type ProtocolAdminState,
+} from '../../../types/protocolAdmin';
+
+interface ManagerSectionProps {
+  protocolId: bigint | null;
+  adminState: ProtocolAdminState;
+  onBack: () => void;
+}
+
+const ManagerSection: React.FC<ManagerSectionProps> = ({
+  protocolId,
+  adminState,
+  onBack,
+}) => {
+  const [activeTab, setActiveTab] = useState<'pools' | 'roles' | 'uris'>('pools');
+  const [delegateAddress, setDelegateAddress] = useState('');
+  const [isDelegating, setIsDelegating] = useState(false);
+  const [delegateError, setDelegateError] = useState<string | null>(null);
+  const [delegateSuccess, setDelegateSuccess] = useState(false);
+
+  const [uriValues, setUriValues] = useState<Partial<Record<URIType, string>>>(adminState.uris);
+  const [savingUri, setSavingUri] = useState<URIType | null>(null);
+
+  const validateAddress = (address: string): boolean => {
+    return /^0x[a-fA-F0-9]{40}$/.test(address);
+  };
+
+  const handleDelegateRole = async () => {
+    if (!validateAddress(delegateAddress)) {
+      setDelegateError('Invalid Ethereum address');
+      return;
+    }
+
+    setIsDelegating(true);
+    setDelegateError(null);
+
+    try {
+      // In production, call delegatePoolCreatorRole(address)
+      console.log('Delegating pool creator role to:', delegateAddress);
+      await new Promise(resolve => setTimeout(resolve, 1500));
+
+      setDelegateSuccess(true);
+      setDelegateAddress('');
+      setTimeout(() => setDelegateSuccess(false), 3000);
+    } catch (err) {
+      setDelegateError('Failed to delegate role');
+    } finally {
+      setIsDelegating(false);
+    }
+  };
+
+  const handleSaveUri = async (uriType: URIType) => {
+    setSavingUri(uriType);
+
+    try {
+      // In production, call setURI(uriType, uriValues[uriType])
+      console.log('Saving URI:', { type: uriType, value: uriValues[uriType] });
+      await new Promise(resolve => setTimeout(resolve, 1000));
+    } catch (err) {
+      console.error('Failed to save URI:', err);
+    } finally {
+      setSavingUri(null);
+    }
+  };
+
+  const tabs = [
+    { id: 'pools' as const, label: 'Pools', icon: Layers },
+    { id: 'roles' as const, label: 'Role Management', icon: Users },
+    { id: 'uris' as const, label: 'Protocol URIs', icon: Link2 },
+  ];
+
+  return (
+    <div className="angular-clip" style={{ background: 'var(--color-white)', border: '2px solid var(--color-secondary)' }}>
+      {/* Header */}
+      <div className="px-6 py-4" style={{ borderBottom: '2px solid var(--color-secondary)' }}>
+        <div className="flex items-center gap-4">
+          <button
+            onClick={onBack}
+            className="p-2 rounded-lg transition-colors"
+            style={{ color: 'var(--color-secondary)' }}
+            aria-label="Back to overview"
+          >
+            <ArrowLeft className="w-5 h-5" />
+          </button>
+          <div>
+            <h2 className="text-xl font-semibold font-heading" style={{ color: 'var(--color-secondary)' }}>
+              Protocol <span style={{ color: 'var(--color-primary)' }}>Manager</span>
+            </h2>
+            <p className="text-sm font-body" style={{ color: 'var(--color-black)' }}>
+              Manage pools, roles, and metadata for Protocol #{protocolId?.toString()}
+            </p>
+          </div>
+        </div>
+      </div>
+
+      {/* Tabs */}
+      <div style={{ borderBottom: '2px solid var(--color-secondary)' }}>
+        <nav className="flex px-6" aria-label="Tabs">
+          {tabs.map((tab) => (
+            <button
+              key={tab.id}
+              onClick={() => setActiveTab(tab.id)}
+              className="flex items-center gap-2 px-4 py-3 font-medium text-sm transition-colors font-heading"
+              style={{
+                borderBottom: activeTab === tab.id ? '3px solid var(--color-primary)' : '3px solid transparent',
+                color: activeTab === tab.id ? 'var(--color-secondary)' : 'var(--color-accent)',
+              }}
+            >
+              <tab.icon className="w-4 h-4" />
+              {tab.label}
+            </button>
+          ))}
+        </nav>
+      </div>
+
+      {/* Tab Content */}
+      <div className="p-6">
+        {activeTab === 'pools' && (
+          <div>
+            <h3 className="text-lg font-medium font-heading mb-4" style={{ color: 'var(--color-secondary)' }}>Active Pools</h3>
+            {adminState.pools.length === 0 ? (
+              <div className="text-center py-8 angular-clip" style={{ background: 'var(--color-marble-light)', border: '2px solid var(--color-secondary)' }}>
+                <Layers className="w-12 h-12 mx-auto mb-3" style={{ color: 'var(--color-accent)' }} />
+                <p className="font-body" style={{ color: 'var(--color-secondary)' }}>No pools created yet</p>
+                <p className="text-sm mt-1 font-body" style={{ color: 'var(--color-black)' }}>
+                  Create a pool to get started
+                </p>
+              </div>
+            ) : (
+              <div className="overflow-x-auto">
+                <table className="w-full">
+                  <thead>
+                    <tr className="text-left text-sm" style={{ borderBottom: '2px solid var(--color-secondary)' }}>
+                      <th className="pb-3 font-medium font-heading" style={{ color: 'var(--color-accent)' }}>#</th>
+                      <th className="pb-3 font-medium font-heading" style={{ color: 'var(--color-accent)' }}>Pool ID</th>
+                      <th className="pb-3 font-medium font-heading" style={{ color: 'var(--color-accent)' }}>Status</th>
+                    </tr>
+                  </thead>
+                  <tbody>
+                    {adminState.pools.map((poolId, index) => (
+                      <tr key={poolId} style={{ borderBottom: '1px solid var(--color-marble-light)' }}>
+                        <td className="py-3 font-body" style={{ color: 'var(--color-black)' }}>{index + 1}</td>
+                        <td className="py-3">
+                          <code className="text-sm px-2 py-1 font-mono" style={{ background: 'var(--color-marble-light)', color: 'var(--color-secondary)' }}>
+                            {poolId.slice(0, 10)}...{poolId.slice(-8)}
+                          </code>
+                        </td>
+                        <td className="py-3">
+                          <span className="angular-clip px-2 py-1 text-xs font-medium font-heading" style={{ background: 'var(--color-primary)', color: 'var(--color-secondary)' }}>
+                            Active
+                          </span>
+                        </td>
+                      </tr>
+                    ))}
+                  </tbody>
+                </table>
+              </div>
+            )}
+          </div>
+        )}
+
+        {activeTab === 'roles' && (
+          <div>
+            <h3 className="text-lg font-medium font-heading mb-4" style={{ color: 'var(--color-secondary)' }}>
+              Delegate Pool Creator Role
+            </h3>
+            <p className="text-sm font-body mb-4" style={{ color: 'var(--color-black)' }}>
+              Grant pool creation permissions to another address. This allows them to create pools
+              for this protocol.
+            </p>
+
+            <div className="space-y-4">
+              <div>
+                <label htmlFor="delegateAddress" className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+                  Address to Delegate
+                </label>
+                <div className="flex gap-3">
+                  <input
+                    id="delegateAddress"
+                    type="text"
+                    value={delegateAddress}
+                    onChange={(e) => {
+                      setDelegateAddress(e.target.value);
+                      setDelegateError(null);
+                    }}
+                    placeholder="0x..."
+                    className="flex-1 px-4 py-3 font-mono text-sm angular-clip"
+                    style={{
+                      border: '2px solid var(--color-secondary)',
+                      color: 'var(--color-secondary)',
+                      background: 'var(--color-white)',
+                    }}
+                  />
+                  <button
+                    onClick={handleDelegateRole}
+                    disabled={isDelegating || !delegateAddress}
+                    className="angular-clip-button px-6 py-3 font-medium font-heading uppercase tracking-wider transition-all flex items-center gap-2 disabled:opacity-50 disabled:cursor-not-allowed"
+                    style={{
+                      background: 'var(--color-primary)',
+                      color: 'var(--color-secondary)',
+                      border: '2px solid var(--color-secondary)',
+                    }}
+                  >
+                    {isDelegating ? (
+                      <>
+                        <Loader2 className="w-4 h-4 animate-spin" />
+                        Delegating...
+                      </>
+                    ) : delegateSuccess ? (
+                      <>
+                        <Check className="w-4 h-4" />
+                        Delegated!
+                      </>
+                    ) : (
+                      <>
+                        <Users className="w-4 h-4" />
+                        Delegate
+                      </>
+                    )}
+                  </button>
+                </div>
+                {delegateError && (
+                  <p className="mt-2 text-sm" style={{ color: 'var(--color-accent)' }}>{delegateError}</p>
+                )}
+              </div>
+
+              <div className="angular-clip p-4 text-sm" style={{ background: 'var(--color-marble-light)', border: '2px solid var(--color-accent)', color: 'var(--color-secondary)' }}>
+                <strong>Note:</strong> Only the protocol creator can delegate pool creator roles.
+                Delegated addresses can create pools but cannot delegate further.
+              </div>
+            </div>
+          </div>
+        )}
+
+        {activeTab === 'uris' && (
+          <div>
+            <h3 className="text-lg font-medium font-heading mb-4" style={{ color: 'var(--color-secondary)' }}>Protocol URIs</h3>
+            <p className="text-sm font-body mb-6" style={{ color: 'var(--color-black)' }}>
+              Set metadata URIs for your protocol. These are publicly visible and help users
+              discover and verify your protocol.
+            </p>
+
+            <div className="space-y-6">
+              {Object.entries(URI_TYPE_LABELS).map(([typeStr, label]) => {
+                const uriType = parseInt(typeStr) as URIType;
+                const currentValue = uriValues[uriType] || '';
+                const isSaving = savingUri === uriType;
+
+                return (
+                  <div key={uriType} className="angular-clip p-4" style={{ border: '2px solid var(--color-secondary)', background: 'var(--color-white)' }}>
+                    <label className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+                      {label}
+                    </label>
+                    <div className="flex gap-3">
+                      <input
+                        type="text"
+                        value={currentValue}
+                        onChange={(e) => setUriValues({ ...uriValues, [uriType]: e.target.value })}
+                        placeholder={
+                          uriType === URIType.WEBSITE ? 'https://myprotocol.io' :
+                          uriType === URIType.X ? '@myprotocol' :
+                          uriType === URIType.FARCASTER ? 'myprotocol.eth' :
+                          'ipfs://...'
+                        }
+                        className="flex-1 px-4 py-2 text-sm angular-clip"
+                        style={{
+                          border: '2px solid var(--color-secondary)',
+                          color: 'var(--color-secondary)',
+                          background: 'var(--color-white)',
+                        }}
+                      />
+                      <button
+                        onClick={() => handleSaveUri(uriType)}
+                        disabled={isSaving || !currentValue}
+                        className="angular-clip-button px-4 py-2 font-medium font-heading transition-all flex items-center gap-2 disabled:opacity-50 disabled:cursor-not-allowed"
+                        style={{
+                          background: 'var(--color-marble-light)',
+                          color: 'var(--color-secondary)',
+                          border: '2px solid var(--color-secondary)',
+                        }}
+                      >
+                        {isSaving ? (
+                          <Loader2 className="w-4 h-4 animate-spin" />
+                        ) : (
+                          <Check className="w-4 h-4" />
+                        )}
+                        Save
+                      </button>
+                      {currentValue && uriType === URIType.WEBSITE && (
+                        <a
+                          href={currentValue}
+                          target="_blank"
+                          rel="noopener noreferrer"
+                          className="p-2 transition-colors"
+                          style={{ color: 'var(--color-accent)' }}
+                        >
+                          <ExternalLink className="w-5 h-5" />
+                        </a>
+                      )}
+                    </div>
+                  </div>
+                );
+              })}
+            </div>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+};
+
+export default ManagerSection;
diff --git a/client2/src/components/protocol/admin/ProtocolAdminPage.tsx b/client2/src/components/protocol/admin/ProtocolAdminPage.tsx
new file mode 100644
index 000000000..1466a9433
--- /dev/null
+++ b/client2/src/components/protocol/admin/ProtocolAdminPage.tsx
@@ -0,0 +1,340 @@
+import React, { useState } from 'react';
+import { useNavigate, useParams, useLocation } from 'react-router-dom';
+import { ArrowLeft, Settings, Layers, DollarSign, Users, Link2, Plus } from 'lucide-react';
+import CreatePoolForm from './CreatePoolForm';
+import SetRevenueForm from './SetRevenueForm';
+import ManagerSection from './ManagerSection';
+import type { Protocol } from '../../../types';
+import {
+  URIType,
+  URI_TYPE_LABELS,
+  type ProtocolAdminState,
+} from '../../../types/protocolAdmin';
+
+// Mock data for development
+const mockProtocolState: ProtocolAdminState = {
+  protocolId: 1n,
+  protocolName: 'My DeFi Protocol',
+  isCreator: true,
+  isPoolCreator: true,
+  pools: [
+    '0x0000000000000000000000000000000000000000000000000000000000000001',
+    '0x0000000000000000000000000000000000000000000000000000000000000002',
+  ],
+  uris: {
+    [URIType.WEBSITE]: 'https://myprotocol.io',
+    [URIType.X]: '@myprotocol',
+  },
+};
+
+type ActiveSection = 'overview' | 'create-pool' | 'protocol-revenue' | 'pool-revenue' | 'manager';
+
+const ProtocolAdminPage: React.FC = () => {
+  const navigate = useNavigate();
+  const { protocolId } = useParams<{ protocolId: string }>();
+  const location = useLocation();
+
+  // Get protocol from location state or create mock
+  const protocol = (location.state as { protocol?: Protocol })?.protocol || {
+    id: `protocol-${protocolId}`,
+    name: mockProtocolState.protocolName,
+    feeRecipient: '0x0000000000000000000000000000000000000000',
+    pools: mockProtocolState.pools.length,
+    revenue: '$0',
+    status: 'active' as const,
+    protocolId: protocolId,
+  };
+
+  const [activeSection, setActiveSection] = useState<ActiveSection>('overview');
+  const [adminState] = useState<ProtocolAdminState>({
+    ...mockProtocolState,
+    protocolId: protocolId ? BigInt(protocolId) : null,
+    protocolName: protocol.name,
+  });
+
+  const handleBack = () => {
+    navigate('/ProtocolDashboard');
+  };
+
+  const handleCreatePoolSuccess = (poolId: string, initialTick: number) => {
+    console.log('Pool created:', { poolId, initialTick });
+    setActiveSection('overview');
+  };
+
+  const handleSetRevenueSuccess = () => {
+    console.log('Revenue set successfully');
+    setActiveSection('overview');
+  };
+
+  const sections = [
+    {
+      id: 'create-pool' as const,
+      label: 'Create Pool',
+      icon: Plus,
+      description: 'Deploy a new Uniswap v4 pool for your protocol',
+      color: 'var(--color-primary)',
+    },
+    {
+      id: 'protocol-revenue' as const,
+      label: 'Set Protocol Revenue',
+      icon: DollarSign,
+      description: 'Configure protocol-wide revenue settings',
+      color: 'var(--color-accent)',
+    },
+    {
+      id: 'pool-revenue' as const,
+      label: 'Set Pool Revenue',
+      icon: Layers,
+      description: 'Configure revenue for specific pools',
+      color: 'var(--color-secondary)',
+    },
+    {
+      id: 'manager' as const,
+      label: 'Protocol Manager',
+      icon: Settings,
+      description: 'Manage roles, URIs, and view pools',
+      color: 'var(--color-secondary)',
+    },
+  ];
+
+  return (
+    <div className="min-h-screen" style={{ background: 'var(--color-marble-light)' }}>
+      {/* Header */}
+      <header style={{ background: 'var(--color-white)', borderBottom: '2px solid var(--color-secondary)' }}>
+        <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-4">
+          <div className="flex items-center justify-between">
+            <div className="flex items-center gap-4">
+              <button
+                onClick={handleBack}
+                className="p-2 rounded-lg transition-colors"
+                style={{ color: 'var(--color-secondary)' }}
+                aria-label="Back to Protocol Dashboard"
+              >
+                <ArrowLeft className="w-5 h-5" />
+              </button>
+              <div>
+                <h1 className="text-2xl font-bold font-heading" style={{ color: 'var(--color-secondary)' }}>
+                  Protocol <span style={{ color: 'var(--color-primary)' }}>Admin</span>
+                </h1>
+                <p className="text-sm font-body" style={{ color: 'var(--color-black)' }}>
+                  {protocol.name} (ID: {protocolId})
+                </p>
+              </div>
+            </div>
+
+            {/* Status badges */}
+            <div className="flex items-center gap-3">
+              {adminState.isCreator && (
+                <span
+                  className="angular-clip flex items-center gap-1.5 px-3 py-1.5 text-sm font-medium font-heading"
+                  style={{ background: 'var(--color-primary)', color: 'var(--color-secondary)' }}
+                >
+                  <Users className="w-4 h-4" />
+                  Creator
+                </span>
+              )}
+              {adminState.isPoolCreator && (
+                <span
+                  className="angular-clip flex items-center gap-1.5 px-3 py-1.5 text-sm font-medium font-heading"
+                  style={{ background: 'var(--color-accent)', color: 'var(--color-white)' }}
+                >
+                  <Layers className="w-4 h-4" />
+                  Pool Creator
+                </span>
+              )}
+            </div>
+          </div>
+        </div>
+      </header>
+
+      {/* Main Content */}
+      <main className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
+        {activeSection === 'overview' ? (
+          <>
+            {/* Protocol Stats */}
+            <div className="grid grid-cols-1 md:grid-cols-3 gap-6 mb-8">
+              <div
+                className="angular-clip p-6"
+                style={{ background: 'var(--color-white)', border: '2px solid var(--color-secondary)' }}
+              >
+                <div className="flex items-center gap-3 mb-2">
+                  <div
+                    className="angular-clip p-2"
+                    style={{ background: 'var(--color-primary)' }}
+                  >
+                    <Layers className="w-5 h-5" style={{ color: 'var(--color-secondary)' }} />
+                  </div>
+                  <span className="text-sm font-medium font-heading" style={{ color: 'var(--color-accent)' }}>Active Pools</span>
+                </div>
+                <p className="text-3xl font-bold font-heading" style={{ color: 'var(--color-secondary)' }}>{adminState.pools.length}</p>
+              </div>
+
+              <div
+                className="angular-clip p-6"
+                style={{ background: 'var(--color-secondary)', border: '2px solid var(--color-secondary)' }}
+              >
+                <div className="flex items-center gap-3 mb-2">
+                  <div
+                    className="angular-clip p-2"
+                    style={{ background: 'var(--color-primary)' }}
+                  >
+                    <DollarSign className="w-5 h-5" style={{ color: 'var(--color-secondary)' }} />
+                  </div>
+                  <span className="text-sm font-medium font-heading" style={{ color: 'var(--color-marble-light)' }}>Total Revenue</span>
+                </div>
+                <p className="text-3xl font-bold font-heading" style={{ color: 'var(--color-primary)' }}>{protocol.revenue}</p>
+              </div>
+
+              <div
+                className="angular-clip p-6"
+                style={{ background: 'var(--color-white)', border: '2px solid var(--color-secondary)' }}
+              >
+                <div className="flex items-center gap-3 mb-2">
+                  <div
+                    className="angular-clip p-2"
+                    style={{ background: 'var(--color-accent)' }}
+                  >
+                    <Link2 className="w-5 h-5" style={{ color: 'var(--color-white)' }} />
+                  </div>
+                  <span className="text-sm font-medium font-heading" style={{ color: 'var(--color-accent)' }}>URIs Set</span>
+                </div>
+                <p className="text-3xl font-bold font-heading" style={{ color: 'var(--color-secondary)' }}>
+                  {Object.keys(adminState.uris).length}/{Object.keys(URI_TYPE_LABELS).length}
+                </p>
+              </div>
+            </div>
+
+            {/* Admin Client Actions */}
+            <div className="mb-8">
+              <h2
+                className="text-lg font-semibold font-heading mb-4"
+                style={{ color: 'var(--color-secondary)' }}
+              >
+                Protocol Admin Client Actions
+              </h2>
+              <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4">
+                {sections.map((section, index) => (
+                  <button
+                    key={section.id}
+                    onClick={() => setActiveSection(section.id)}
+                    className="angular-clip p-6 text-left transition-all duration-200 hover:-translate-y-1 hover:rotate-[-0.5deg]"
+                    style={{
+                      background: index % 2 === 0 ? 'var(--color-white)' : 'var(--color-secondary)',
+                      border: '2px solid var(--color-secondary)',
+                    }}
+                  >
+                    <div
+                      className="angular-clip w-12 h-12 flex items-center justify-center mb-4"
+                      style={{ background: section.color }}
+                    >
+                      <section.icon
+                        className="w-6 h-6"
+                        style={{ color: index % 2 === 0 ? 'var(--color-secondary)' : 'var(--color-white)' }}
+                      />
+                    </div>
+                    <h3
+                      className="font-semibold font-heading mb-1"
+                      style={{ color: index % 2 === 0 ? 'var(--color-secondary)' : 'var(--color-primary)' }}
+                    >
+                      {section.label}
+                    </h3>
+                    <p
+                      className="text-sm font-body"
+                      style={{ color: index % 2 === 0 ? 'var(--color-black)' : 'var(--color-marble-light)' }}
+                    >
+                      {section.description}
+                    </p>
+                  </button>
+                ))}
+              </div>
+            </div>
+
+            {/* Quick Pools Overview */}
+            {adminState.pools.length > 0 && (
+              <div
+                className="angular-clip p-6"
+                style={{ background: 'var(--color-white)', border: '2px solid var(--color-secondary)' }}
+              >
+                <h2
+                  className="text-lg font-semibold font-heading mb-4"
+                  style={{ color: 'var(--color-secondary)' }}
+                >
+                  Active Pools
+                </h2>
+                <div className="overflow-x-auto">
+                  <table className="w-full">
+                    <thead>
+                      <tr
+                        className="text-left text-sm"
+                        style={{ borderBottom: '2px solid var(--color-secondary)' }}
+                      >
+                        <th className="pb-3 font-medium font-heading" style={{ color: 'var(--color-accent)' }}>Pool ID</th>
+                        <th className="pb-3 font-medium font-heading" style={{ color: 'var(--color-accent)' }}>Status</th>
+                        <th className="pb-3 font-medium font-heading" style={{ color: 'var(--color-accent)' }}>Actions</th>
+                      </tr>
+                    </thead>
+                    <tbody>
+                      {adminState.pools.map((poolId) => (
+                        <tr key={poolId} style={{ borderBottom: '1px solid var(--color-marble-light)' }}>
+                          <td className="py-3 font-mono text-sm" style={{ color: 'var(--color-secondary)' }}>
+                            {poolId.slice(0, 10)}...{poolId.slice(-8)}
+                          </td>
+                          <td className="py-3">
+                            <span
+                              className="angular-clip px-2 py-1 text-xs font-medium font-heading"
+                              style={{ background: 'var(--color-primary)', color: 'var(--color-secondary)' }}
+                            >
+                              Active
+                            </span>
+                          </td>
+                          <td className="py-3">
+                            <button
+                              onClick={() => setActiveSection('pool-revenue')}
+                              className="text-sm font-medium font-heading"
+                              style={{ color: 'var(--color-accent)' }}
+                            >
+                              Set Revenue
+                            </button>
+                          </td>
+                        </tr>
+                      ))}
+                    </tbody>
+                  </table>
+                </div>
+              </div>
+            )}
+          </>
+        ) : activeSection === 'create-pool' ? (
+          <CreatePoolForm
+            protocolId={adminState.protocolId}
+            onSuccess={handleCreatePoolSuccess}
+            onCancel={() => setActiveSection('overview')}
+          />
+        ) : activeSection === 'protocol-revenue' ? (
+          <SetRevenueForm
+            protocolId={adminState.protocolId}
+            type="protocol"
+            onSuccess={handleSetRevenueSuccess}
+            onCancel={() => setActiveSection('overview')}
+          />
+        ) : activeSection === 'pool-revenue' ? (
+          <SetRevenueForm
+            protocolId={adminState.protocolId}
+            type="pool"
+            pools={adminState.pools}
+            onSuccess={handleSetRevenueSuccess}
+            onCancel={() => setActiveSection('overview')}
+          />
+        ) : activeSection === 'manager' ? (
+          <ManagerSection
+            protocolId={adminState.protocolId}
+            adminState={adminState}
+            onBack={() => setActiveSection('overview')}
+          />
+        ) : null}
+      </main>
+    </div>
+  );
+};
+
+export default ProtocolAdminPage;
diff --git a/client2/src/components/protocol/admin/SetRevenueForm.tsx b/client2/src/components/protocol/admin/SetRevenueForm.tsx
new file mode 100644
index 000000000..31000119a
--- /dev/null
+++ b/client2/src/components/protocol/admin/SetRevenueForm.tsx
@@ -0,0 +1,265 @@
+import React, { useState } from 'react';
+import { ArrowLeft, DollarSign, Info, Loader2 } from 'lucide-react';
+
+interface SetRevenueFormProps {
+  protocolId: bigint | null;
+  type: 'protocol' | 'pool';
+  pools?: string[];
+  onSuccess: () => void;
+  onCancel: () => void;
+}
+
+const SetRevenueForm: React.FC<SetRevenueFormProps> = ({
+  protocolId,
+  type,
+  pools = [],
+  onSuccess,
+  onCancel,
+}) => {
+  const [amount, setAmount] = useState('');
+  const [selectedPoolId, setSelectedPoolId] = useState('');
+  const [isSubmitting, setIsSubmitting] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const validateForm = (): boolean => {
+    if (!amount || parseFloat(amount) < 0) {
+      setError('Revenue amount must be a non-negative number');
+      return false;
+    }
+
+    if (type === 'pool' && !selectedPoolId) {
+      setError('Please select a pool');
+      return false;
+    }
+
+    setError(null);
+    return true;
+  };
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+
+    if (!validateForm() || !protocolId) {
+      return;
+    }
+
+    setIsSubmitting(true);
+
+    try {
+      // In production, this would call the appropriate contract function:
+      // - setProtocolRevenue(protocolId) for protocol-wide revenue
+      // - setPoolRevenue(protocolId, poolId) for pool-specific revenue
+
+      console.log('Setting revenue:', {
+        protocolId: protocolId.toString(),
+        type,
+        amount,
+        poolId: type === 'pool' ? selectedPoolId : undefined,
+      });
+
+      // Mock success
+      await new Promise(resolve => setTimeout(resolve, 1500));
+
+      onSuccess();
+    } catch (err) {
+      console.error('Failed to set revenue:', err);
+      setError('Failed to set revenue. Please try again.');
+    } finally {
+      setIsSubmitting(false);
+    }
+  };
+
+  return (
+    <div className="angular-clip" style={{ background: 'var(--color-white)', border: '2px solid var(--color-secondary)' }}>
+      {/* Header */}
+      <div className="px-6 py-4" style={{ borderBottom: '2px solid var(--color-secondary)' }}>
+        <div className="flex items-center gap-4">
+          <button
+            onClick={onCancel}
+            className="p-2 rounded-lg transition-colors"
+            style={{ color: 'var(--color-secondary)' }}
+            aria-label="Back to overview"
+          >
+            <ArrowLeft className="w-5 h-5" />
+          </button>
+          <div>
+            <h2 className="text-xl font-semibold font-heading" style={{ color: 'var(--color-secondary)' }}>
+              Set <span style={{ color: 'var(--color-primary)' }}>{type === 'protocol' ? 'Protocol' : 'Pool'}</span> Revenue
+            </h2>
+            <p className="text-sm font-body" style={{ color: 'var(--color-black)' }}>
+              Configure revenue settings for Protocol #{protocolId?.toString()}
+            </p>
+          </div>
+        </div>
+      </div>
+
+      {/* Form */}
+      <form onSubmit={handleSubmit} className="p-6">
+        <div className="space-y-6">
+          {/* Pool Selection (only for pool revenue) */}
+          {type === 'pool' && (
+            <div>
+              <label htmlFor="poolId" className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+                Select Pool
+              </label>
+              {pools.length === 0 ? (
+                <div className="angular-clip p-4 text-sm" style={{ background: 'var(--color-marble-light)', border: '2px solid var(--color-accent)', color: 'var(--color-secondary)' }}>
+                  No pools available. Create a pool first to set pool-specific revenue.
+                </div>
+              ) : (
+                <select
+                  id="poolId"
+                  value={selectedPoolId}
+                  onChange={(e) => setSelectedPoolId(e.target.value)}
+                  className="w-full px-4 py-3 font-mono text-sm angular-clip"
+                  style={{
+                    border: '2px solid var(--color-secondary)',
+                    color: 'var(--color-secondary)',
+                    background: 'var(--color-white)',
+                  }}
+                >
+                  <option value="">Select a pool...</option>
+                  {pools.map((poolId) => (
+                    <option key={poolId} value={poolId}>
+                      {poolId.slice(0, 10)}...{poolId.slice(-8)}
+                    </option>
+                  ))}
+                </select>
+              )}
+            </div>
+          )}
+
+          {/* Revenue Amount */}
+          <div>
+            <label htmlFor="amount" className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+              Revenue Amount (in Wei)
+            </label>
+            <div className="relative">
+              <div className="absolute inset-y-0 left-0 pl-4 flex items-center pointer-events-none">
+                <DollarSign className="w-5 h-5" style={{ color: 'var(--color-accent)' }} />
+              </div>
+              <input
+                id="amount"
+                type="text"
+                value={amount}
+                onChange={(e) => {
+                  setAmount(e.target.value);
+                  setError(null);
+                }}
+                placeholder="0"
+                className="w-full pl-12 pr-4 py-3 angular-clip"
+                style={{
+                  border: '2px solid var(--color-secondary)',
+                  color: 'var(--color-secondary)',
+                  background: 'var(--color-white)',
+                }}
+              />
+            </div>
+            <p className="mt-1 text-xs font-body" style={{ color: 'var(--color-black)' }}>
+              Enter the revenue amount in wei (1 ETH = 10^18 wei)
+            </p>
+          </div>
+
+          {/* Quick Amount Buttons */}
+          <div>
+            <label className="block text-sm font-medium font-heading mb-2" style={{ color: 'var(--color-secondary)' }}>
+              Quick Amount
+            </label>
+            <div className="flex flex-wrap gap-2">
+              {[
+                { label: '0.01 ETH', value: '10000000000000000' },
+                { label: '0.1 ETH', value: '100000000000000000' },
+                { label: '1 ETH', value: '1000000000000000000' },
+                { label: '10 ETH', value: '10000000000000000000' },
+              ].map((preset) => (
+                <button
+                  key={preset.value}
+                  type="button"
+                  onClick={() => setAmount(preset.value)}
+                  className="angular-clip px-4 py-2 text-sm font-medium font-heading transition-all"
+                  style={{
+                    border: `2px solid ${amount === preset.value ? 'var(--color-primary)' : 'var(--color-secondary)'}`,
+                    background: amount === preset.value ? 'var(--color-primary)' : 'var(--color-white)',
+                    color: 'var(--color-secondary)',
+                  }}
+                >
+                  {preset.label}
+                </button>
+              ))}
+            </div>
+          </div>
+
+          {/* Error Message */}
+          {error && (
+            <div className="angular-clip p-4 text-sm" style={{ background: 'var(--color-marble-light)', border: '2px solid var(--color-accent)', color: 'var(--color-accent)' }}>
+              {error}
+            </div>
+          )}
+
+          {/* Info Box */}
+          <div className="angular-clip p-4 flex gap-3" style={{ background: 'var(--color-marble-light)', border: '2px solid var(--color-secondary)' }}>
+            <Info className="w-5 h-5 flex-shrink-0 mt-0.5" style={{ color: 'var(--color-secondary)' }} />
+            <div className="text-sm" style={{ color: 'var(--color-secondary)' }}>
+              <p className="font-medium font-heading mb-1">About Revenue Settings:</p>
+              <ul className="list-disc list-inside space-y-1 font-body" style={{ color: 'var(--color-black)' }}>
+                {type === 'protocol' ? (
+                  <>
+                    <li>Protocol revenue applies to all pools in your protocol</li>
+                    <li>Revenue is distributed according to your protocol's fee structure</li>
+                    <li>Changes take effect after the next block confirmation</li>
+                  </>
+                ) : (
+                  <>
+                    <li>Pool revenue is specific to the selected pool</li>
+                    <li>This overrides the protocol-level revenue for this pool</li>
+                    <li>Use this for pools with custom revenue requirements</li>
+                  </>
+                )}
+              </ul>
+            </div>
+          </div>
+        </div>
+
+        {/* Actions */}
+        <div className="flex justify-end gap-4 mt-8 pt-6" style={{ borderTop: '2px solid var(--color-secondary)' }}>
+          <button
+            type="button"
+            onClick={onCancel}
+            className="angular-clip-button px-6 py-3 font-medium font-heading uppercase tracking-wider transition-all"
+            style={{
+              background: 'var(--color-white)',
+              color: 'var(--color-secondary)',
+              border: '2px solid var(--color-secondary)',
+            }}
+          >
+            Cancel
+          </button>
+          <button
+            type="submit"
+            disabled={isSubmitting || !protocolId || (type === 'pool' && pools.length === 0)}
+            className="angular-clip-button px-6 py-3 font-medium font-heading uppercase tracking-wider transition-all flex items-center gap-2 disabled:opacity-50 disabled:cursor-not-allowed"
+            style={{
+              background: 'var(--color-primary)',
+              color: 'var(--color-secondary)',
+              border: '2px solid var(--color-secondary)',
+            }}
+          >
+            {isSubmitting ? (
+              <>
+                <Loader2 className="w-5 h-5 animate-spin" />
+                Setting Revenue...
+              </>
+            ) : (
+              <>
+                <DollarSign className="w-5 h-5" />
+                Set Revenue
+              </>
+            )}
+          </button>
+        </div>
+      </form>
+    </div>
+  );
+};
+
+export default SetRevenueForm;
diff --git a/client2/src/components/protocol/admin/index.ts b/client2/src/components/protocol/admin/index.ts
new file mode 100644
index 000000000..5fc73df51
--- /dev/null
+++ b/client2/src/components/protocol/admin/index.ts
@@ -0,0 +1,4 @@
+export { default as ProtocolAdminPage } from './ProtocolAdminPage';
+export { default as CreatePoolForm } from './CreatePoolForm';
+export { default as SetRevenueForm } from './SetRevenueForm';
+export { default as ManagerSection } from './ManagerSection';
diff --git a/client2/src/hooks/useCreateProtocol.ts b/client2/src/hooks/useCreateProtocol.ts
index 63ee7580d..4b41be745 100644
--- a/client2/src/hooks/useCreateProtocol.ts
+++ b/client2/src/hooks/useCreateProtocol.ts
@@ -1,4 +1,4 @@
-import { useState, useEffect } from 'react';
+import { useState, useEffect, useCallback } from 'react';
 import { useWriteContract, useWaitForTransactionReceipt, useWatchContractEvent, usePublicClient } from 'wagmi';
 import { protocolAdminClientABI } from '../lib/contracts/abi';
 import { getContractAddress } from '../lib/contracts/protocolAdminClient';
@@ -217,13 +217,13 @@ export function useCreateProtocol({
     setIsSubscribed(false);
   }, [chainId, reset]);
 
-  // Expose a reset function for manual reset
-  const resetProtocolCreation = () => {
+  // Expose a reset function for manual reset - memoized to prevent infinite loops
+  const resetProtocolCreation = useCallback(() => {
     console.log('Resetting protocol creation state');
     reset();
     setProtocolId(null);
     setIsSubscribed(false);
-  };
+  }, [reset]);
 
   return {
     createProtocol,
diff --git a/client2/src/lib/deployments/static-deployments.json b/client2/src/lib/deployments/static-deployments.json
index d26d705d2..0637a088a 100644
--- a/client2/src/lib/deployments/static-deployments.json
+++ b/client2/src/lib/deployments/static-deployments.json
@@ -1,8 +1 @@
-[
-  {
-    "chainId": 1301,
-    "chainName": "Unichain Sepolia",
-    "networkType": "testnet",
-    "protocolAdminClientAddress": "0x957e136698d545abb754b279f3c8e0717568f027"
-  }
-]
\ No newline at end of file
+[]
\ No newline at end of file
diff --git a/client2/src/types/hookSpec.ts b/client2/src/types/hookSpec.ts
new file mode 100644
index 000000000..be841d179
--- /dev/null
+++ b/client2/src/types/hookSpec.ts
@@ -0,0 +1,509 @@
+// Hook Specification Types
+// Based on the HookSpec schema from hook-specification-platform-decomposition.md
+
+export interface HookSpecAttachment {
+  type: 'pdf' | 'image' | 'document';
+  name: string;
+  url: string;
+}
+
+export interface HookSpecMetadata {
+  name: string;
+  version: string;
+  author: string;
+  description?: string;
+  license?: 'MIT' | 'GPL-3.0' | 'BUSL-1.1' | 'PROPRIETARY';
+  system_state_version?: string;
+  attachments?: HookSpecAttachment[];
+}
+
+export interface StateVariable {
+  name: string;
+  symbol: string;
+  type: SolidityType;
+  description?: string;
+  initial_value?: string;
+}
+
+export type SolidityType =
+  | 'uint8' | 'uint16' | 'uint24' | 'uint32' | 'uint64' | 'uint128' | 'uint256'
+  | 'int8' | 'int16' | 'int24' | 'int32' | 'int64' | 'int128' | 'int256'
+  | 'address' | 'bool' | 'bytes32';
+
+export type HookCallback =
+  | 'beforeInitialize' | 'afterInitialize'
+  | 'beforeAddLiquidity' | 'afterAddLiquidity'
+  | 'beforeRemoveLiquidity' | 'afterRemoveLiquidity'
+  | 'beforeSwap' | 'afterSwap'
+  | 'beforeDonate' | 'afterDonate';
+
+export interface StateTransition {
+  preconditions?: string[];
+  equation: string;
+  postconditions?: string[];
+  delta_returns?: {
+    amount0?: string;
+    amount1?: string;
+  };
+}
+
+export interface SystemFunction {
+  callback: HookCallback;
+  reads: string[];
+  writes: string[];
+  transition: StateTransition;
+}
+
+export interface Invariant {
+  name: string;
+  expression: string;
+  description?: string;
+}
+
+export interface HookSpec {
+  metadata: HookSpecMetadata;
+  hook_state: StateVariable[];
+  system_functions: SystemFunction[];
+  invariants?: Invariant[];
+}
+
+// State Space Model Types
+export interface SystemStateVariable {
+  name: string;
+  symbol: string;
+  type: SolidityType;
+  getter: string;
+  description: string;
+}
+
+export interface StateSpaceModel {
+  version: string;
+  ipfsCid: string;
+  uniswapVersion: string;
+  updatedAt: string;
+  indices: {
+    lp: SystemStateVariable[];
+    trader: SystemStateVariable[];
+    shared: SystemStateVariable[];
+  };
+}
+
+// Validation Types
+export interface ValidationResult {
+  ruleId: string;
+  ruleName: string;
+  passed: boolean;
+  errors: string[];
+  warnings: string[];
+}
+
+export interface ValidateHookSpecResponse {
+  valid: boolean;
+  results: ValidationResult[];
+  errors: string[];
+  warnings: string[];
+}
+
+// Submission Types
+export interface SubmitHookSpecRequest {
+  spec: HookSpec;
+  signature: string;
+  royaltyBps?: number;
+}
+
+export interface SubmissionResult {
+  success: boolean;
+  ipfsCid: string;
+  tokenId: number;
+  transactionHash: string;
+  ownerAddress: string;
+  openSeaUrl?: string;
+  ipfsGatewayUrl: string;
+}
+
+// Hook License Types
+export interface HookLicenseSummary {
+  tokenId: number;
+  name: string;
+  version: string;
+  ipfsCid: string;
+  deprecated: boolean;
+  registeredAt: string;
+}
+
+export interface HookLicenseDetail extends HookLicenseSummary {
+  owner: string;
+  description?: string;
+  developer: string;
+  spec: HookSpec;
+  attestations?: AttestationInfo[];
+  deployments?: DeploymentInfo[];
+}
+
+export interface AttestationInfo {
+  attestationId: string;
+  attester: string;
+  timestamp: string;
+  valid: boolean;
+}
+
+export interface DeploymentInfo {
+  poolId: string;
+  deployer: string;
+  timestamp: string;
+  chainId: number;
+}
+
+// ============================================
+// Code Verification Types (Steps 5-6)
+// Based on hook-code-verifier-spec.md
+// ============================================
+
+// Code submission request
+export interface CodeSubmissionRequest {
+  licenseTokenId: number;
+  repoUrl: string;
+  branch?: string;
+  contractPath?: string;
+  compilerVersion: string;
+  optimizerRuns?: number;
+  signature: string;
+  verifyOnly?: boolean;
+}
+
+// Repository analysis result
+export interface RepoAnalysisResult {
+  repoUrl: string;
+  branch: string;
+  commitHash: string;
+  mainContract: string;
+  contractsFound: number;
+  dependencies: string[];
+}
+
+// Compilation result
+export interface CompilationResult {
+  success: boolean;
+  bytecodeHash?: string;
+  deployedBytecodeHash?: string;
+  errors?: CompilationError[];
+  warnings?: CompilationWarning[];
+}
+
+export interface CompilationError {
+  type: string;
+  message: string;
+  formattedMessage?: string;
+  sourceLocation?: {
+    file: string;
+    start: number;
+    end: number;
+  };
+}
+
+export interface CompilationWarning {
+  type: string;
+  message: string;
+  formattedMessage?: string;
+}
+
+// AVS Verification Types
+export type AVSFindingSeverity = 'critical' | 'warning' | 'info';
+
+export interface AVSFinding {
+  severity: AVSFindingSeverity;
+  ruleId: string;
+  ruleName: string;
+  description: string;
+  codeLocation?: {
+    startLine: number;
+    endLine: number;
+    functionName?: string;
+  };
+  specReference?: string;
+}
+
+export interface AVSVerificationResult {
+  compliant: boolean;
+  complianceScore: number;  // 0-100 percentage
+  attestationId: string;
+  attestationTxHash: string;
+  findings: AVSFinding[];
+  verificationTimestamp: number;
+}
+
+// CFHE Deployment Types
+export interface CFHEDeploymentResult {
+  encryptedBytecodeHash: string;
+  deploymentTxHash: string;
+  encryptedContractAddress: string;
+  blockNumber: number;
+  explorerUrl: string;
+}
+
+// Full Code Verification Result
+export interface CodeVerificationResult {
+  success: boolean;
+  repoAnalysis: RepoAnalysisResult;
+  compilation: CompilationResult;
+  avsResult: AVSVerificationResult;
+  cfheResult?: CFHEDeploymentResult;
+  summary: {
+    hookName: string;
+    hookVersion: string;
+    licenseTokenId: number;
+    specIpfsCid: string;
+    repoUrl: string;
+    commitHash: string;
+    submittedAt: number;
+    completedAt: number;
+  };
+}
+
+// Code Verification Error
+export type CodeVerificationErrorCode =
+  | 'INVALID_SIGNATURE'
+  | 'SIGNATURE_EXPIRED'
+  | 'INVALID_LICENSE'
+  | 'LICENSE_NOT_OWNED'
+  | 'LICENSE_DEPRECATED'
+  | 'INVALID_REPO_URL'
+  | 'REPO_NOT_FOUND'
+  | 'REPO_ACCESS_DENIED'
+  | 'BRANCH_NOT_FOUND'
+  | 'NO_HOOK_CONTRACTS_FOUND'
+  | 'MULTIPLE_HOOKS_FOUND'
+  | 'CONTRACT_PATH_NOT_FOUND'
+  | 'COMPILATION_FAILED'
+  | 'UNSUPPORTED_COMPILER'
+  | 'AVS_VERIFICATION_FAILED'
+  | 'AVS_TIMEOUT'
+  | 'INSUFFICIENT_STAKE'
+  | 'CFHE_ENCRYPTION_FAILED'
+  | 'CFHE_DEPLOYMENT_FAILED'
+  | 'NETWORK_ERROR';
+
+export interface CodeVerificationError {
+  success: false;
+  error: {
+    code: CodeVerificationErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+  };
+  partialResults?: {
+    compilation?: CompilationResult;
+    avsResult?: Partial<AVSVerificationResult>;
+  };
+}
+
+// Supported compiler versions
+export const SUPPORTED_COMPILER_VERSIONS = [
+  '0.8.26',
+  '0.8.25',
+  '0.8.24',
+  '0.8.23',
+  '0.8.22',
+  '0.8.21',
+  '0.8.20',
+  '0.8.19',
+] as const;
+
+export type SupportedCompilerVersion = typeof SUPPORTED_COMPILER_VERSIONS[number];
+
+// ============================================
+// Hook Market Types
+// Based on hook-market-spec.md
+// ============================================
+
+// Hook Categories
+export type HookCategory =
+  | 'FEE_MANAGEMENT'      // Dynamic fees, fee sharing
+  | 'ORACLE'              // Price oracles, TWAP
+  | 'LIMIT_ORDER'         // Limit orders, stop-loss
+  | 'LIQUIDITY'           // LP incentives, auto-rebalance
+  | 'MEV_PROTECTION'      // MEV mitigation
+  | 'CUSTOM';             // Other
+
+export const HOOK_CATEGORIES: { value: HookCategory; label: string; description: string }[] = [
+  { value: 'FEE_MANAGEMENT', label: 'Fee Management', description: 'Dynamic fees, fee sharing hooks' },
+  { value: 'ORACLE', label: 'Oracle', description: 'Price oracles, TWAP implementations' },
+  { value: 'LIMIT_ORDER', label: 'Limit Order', description: 'Limit orders, stop-loss functionality' },
+  { value: 'LIQUIDITY', label: 'Liquidity', description: 'LP incentives, auto-rebalancing' },
+  { value: 'MEV_PROTECTION', label: 'MEV Protection', description: 'MEV mitigation strategies' },
+  { value: 'CUSTOM', label: 'Custom', description: 'Other specialized hooks' },
+];
+
+// Hook Pricing
+export type PricingModel = 'FIXED' | 'REVENUE_SHARE' | 'HYBRID';
+
+export interface HookPricing {
+  model: PricingModel;
+  fixedPrice?: string;           // One-time fee (wei as string)
+  revenueShareBps?: number;      // Basis points (0-10000)
+  currency: string;              // Payment token address (0x0 = ETH)
+}
+
+// Hook Capability
+export interface HookCapability {
+  callback: HookCallback;
+  description: string;
+}
+
+// Hook Listing (summary for browsing)
+export interface HookListingSummary {
+  tokenId: number;
+  name: string;
+  version: string;
+  description?: string;
+  category: HookCategory;
+  developer: string;
+  pricing: HookPricing;
+  complianceScore?: number;
+  verified: boolean;
+  cfheDeployed: boolean;
+  subscriptionCount: number;
+  registeredAt: string;
+  tags?: string[];
+}
+
+// Full Hook Listing (detailed view)
+export interface HookListing {
+  tokenId: number;
+  developer: string;
+  registeredAt: string;
+  deprecated: boolean;
+  pricing: HookPricing;
+  metadata: {
+    name: string;
+    version: string;
+    description: string;
+    category: HookCategory;
+    tags: string[];
+    capabilities: HookCapability[];
+  };
+  verification: {
+    codeVerified: boolean;
+    avsAttestationId?: string;
+    complianceScore?: number;
+    cfheDeployed: boolean;
+    cfheContractAddress?: string;
+  };
+  spec?: HookSpec;
+}
+
+// Pool Deployment Info
+export interface PoolDeployment {
+  poolId: string;
+  chainId: number;
+  deployedAt: string;
+  active: boolean;
+}
+
+// Hook Subscription
+export interface HookSubscription {
+  subscriptionId: string;
+  hookTokenId: number;
+  poolId: string;
+  subscriber: string;
+  subscribedAt: string;
+  active: boolean;
+  totalPaid: string;
+  revenueShareAccrued: string;
+}
+
+// Bytecode Verification
+export interface BytecodeVerificationRequest {
+  hookTokenId: number;
+  poolId?: string;
+}
+
+export type EncryptionStatus = 'ENCRYPTED' | 'PLAINTEXT' | 'NOT_DEPLOYED';
+
+export interface BytecodeVerificationResult {
+  verified: boolean;
+  obfuscatedBytecodeHash: string;
+  deployedBytecodeHash: string;
+  matchPercentage: number;      // 0-100
+  cfheContractAddress?: string;
+  encryptionStatus: EncryptionStatus;
+}
+
+// Functionality Test Types
+export type TestType = 'SWAP' | 'LIQUIDITY' | 'INITIALIZE' | 'CUSTOM';
+
+export interface SwapTestParams {
+  zeroForOne: boolean;
+  amountSpecified: string;
+  sqrtPriceLimitX96: string;
+}
+
+export interface LiquidityTestParams {
+  tickLower: number;
+  tickUpper: number;
+  liquidityDelta: string;
+}
+
+export interface FunctionalityTestRequest {
+  hookTokenId: number;
+  testType: TestType;
+  testData: {
+    swapParams?: SwapTestParams;
+    liquidityParams?: LiquidityTestParams;
+    customParams?: Record<string, unknown>;
+  };
+  expectedBehavior?: string;
+}
+
+export type TestDeviationSeverity = 'CRITICAL' | 'WARNING' | 'INFO';
+
+export interface TestDeviation {
+  field: string;
+  expected: string;
+  actual: string;
+  severity: TestDeviationSeverity;
+}
+
+export interface FunctionalityTestResult {
+  success: boolean;
+  testId: string;
+  avsVerificationId: string;
+  accuracyScore: number;        // 0-100 percentage
+  behaviorMatch: boolean;
+  report: {
+    inputSummary: string;
+    expectedOutput: string;
+    actualOutput: string;
+    deviations: TestDeviation[];
+    gasUsed: string;
+    executionTimeMs: number;
+  };
+  attestation: {
+    attestationId: string;
+    attesters: string[];
+    consensus: number;          // Percentage of agreeing operators
+    timestamp: number;
+  };
+}
+
+// Hook Market Error Codes
+export type HookMarketErrorCode =
+  | 'HOOK_NOT_FOUND'
+  | 'HOOK_DEPRECATED'
+  | 'HOOK_NOT_VERIFIED'
+  | 'INVALID_POOL_ID'
+  | 'POOL_NOT_FOUND'
+  | 'ALREADY_SUBSCRIBED'
+  | 'INSUFFICIENT_PAYMENT'
+  | 'INVALID_SIGNATURE'
+  | 'SIGNATURE_EXPIRED'
+  | 'BYTECODE_MISMATCH'
+  | 'CFHE_NOT_DEPLOYED'
+  | 'AVS_UNAVAILABLE'
+  | 'TEST_TIMEOUT'
+  | 'INVALID_TEST_PARAMS';
+
+export interface HookMarketError {
+  code: HookMarketErrorCode;
+  message: string;
+  details?: Record<string, unknown>;
+}
diff --git a/client2/src/types/protocolAdmin.ts b/client2/src/types/protocolAdmin.ts
new file mode 100644
index 000000000..8f218dfb3
--- /dev/null
+++ b/client2/src/types/protocolAdmin.ts
@@ -0,0 +1,137 @@
+import type { Address } from 'viem';
+
+// URI Types enum matching the contract's URI_TYPE
+export enum URIType {
+  ZORA = 0,
+  WEBSITE = 1,
+  X = 2,
+  FARCASTER = 3,
+}
+
+// URI Type labels for UI display
+export const URI_TYPE_LABELS: Record<URIType, string> = {
+  [URIType.ZORA]: 'Zora NFT',
+  [URIType.WEBSITE]: 'Website',
+  [URIType.X]: 'X (Twitter)',
+  [URIType.FARCASTER]: 'Farcaster',
+};
+
+// Pool Key structure matching Uniswap v4 PoolKey
+export interface PoolKey {
+  currency0: Address;
+  currency1: Address;
+  fee: number;
+  tickSpacing: number;
+  hooks: Address;
+}
+
+// Create Pool parameters for the UI form
+export interface CreatePoolParams {
+  protocolId: bigint;
+  poolKey: PoolKey;
+  initialSqrtPrice: bigint;
+}
+
+// Create Pool form values (before conversion)
+export interface CreatePoolFormValues {
+  token0: string;
+  token1: string;
+  fee: string;
+  tickSpacing: string;
+  hookAddress: string;
+  initialPrice: string;
+}
+
+// Standard fee tiers for Uniswap v4
+export const FEE_TIERS = [
+  { value: '100', label: '0.01%', description: 'Best for stable pairs' },
+  { value: '500', label: '0.05%', description: 'Best for stable pairs' },
+  { value: '3000', label: '0.30%', description: 'Best for most pairs' },
+  { value: '10000', label: '1.00%', description: 'Best for exotic pairs' },
+];
+
+// Set Revenue parameters
+export interface SetRevenueParams {
+  protocolId: bigint;
+  poolId?: string; // For pool-specific revenue (bytes32)
+  amount: bigint;
+}
+
+// Set Revenue form values
+export interface SetRevenueFormValues {
+  amount: string;
+  poolId?: string;
+}
+
+// Protocol Admin state from contracts
+export interface ProtocolAdminState {
+  protocolId: bigint | null;
+  protocolName: string;
+  isCreator: boolean;
+  isPoolCreator: boolean;
+  pools: string[];
+  uris: Partial<Record<URIType, string>>;
+}
+
+// Pool display info
+export interface PoolInfo {
+  id: string; // bytes32 poolId
+  currency0?: Address;
+  currency1?: Address;
+  fee?: number;
+  tickSpacing?: number;
+  hooks?: Address;
+}
+
+// Transaction status for UI feedback
+export type TransactionStatus = 'idle' | 'pending' | 'confirming' | 'success' | 'error';
+
+// Create Pool result
+export interface CreatePoolResult {
+  poolId: string;
+  initialTick: number;
+}
+
+// Protocol Admin Manager function selectors (for reference)
+export const MANAGER_FUNCTIONS = {
+  isCreator: 'isCreator(address)',
+  setPool: 'setPool(bytes32)',
+  getPools: 'getPools()',
+  delegatePoolCreatorRole: 'delegatePoolCreatorRole(address)',
+  isPoolCreator: 'isPoolCreator(address)',
+  protocolId: 'protocolId()',
+  protocolName: 'protocolName()',
+  setURI: 'setURI(uint8,string)',
+  getURI: 'getURI(uint8)',
+} as const;
+
+// Protocol Admin Client function selectors (for reference)
+export const CLIENT_FUNCTIONS = {
+  createPool: 'create_pool(uint256,bytes,uint160)',
+  setProtocolRevenue: 'setProtocolRevenue(uint256)',
+  setPoolRevenue: 'setPoolRevenue(uint256,bytes32)',
+  getProtocols: 'getProtocols()',
+  getProtocolRevenue: 'getProtocolRevenue(uint256)',
+  getPoolRevenue: 'getPoolRevenue(uint256,bytes32)',
+} as const;
+
+// Error messages mapping
+export const PROTOCOL_ADMIN_ERRORS: Record<string, string> = {
+  ProtocolAdminManagerCallerIsNotCreator: 'You are not the protocol creator',
+  ProtocolAdminClientUnauthorizedCaller: 'You are not authorized to create pools',
+  ProtocolAdminManagerNotClone: 'Invalid protocol instance',
+  ProtocolAdminManagerInvalidContextCall: 'Invalid call context',
+  ProtocolAdminManagerUninitialized: 'Protocol manager not initialized',
+  ProtocolAdminClientUninitialized: 'Protocol client not initialized',
+};
+
+// Helper to get user-friendly error message
+export function getProtocolAdminErrorMessage(error: Error): string {
+  const errorMessage = error.message || '';
+  for (const [key, message] of Object.entries(PROTOCOL_ADMIN_ERRORS)) {
+    if (errorMessage.includes(key)) {
+      return message;
+    }
+  }
+  return errorMessage;
+}
diff --git a/docs/hook-pkg/NOTES.md b/docs/hook-pkg/NOTES.md
new file mode 100644
index 000000000..9e646632e
--- /dev/null
+++ b/docs/hook-pkg/NOTES.md
@@ -0,0 +1,55 @@
+## Layer 1
+
+- The pool state variables MUST be given as a public document this can be either a paper or a docuemtn of instructions tht parse the STatetVIew interfaCE TO ACTUAL STATE VARIAbles
+
+- A Hook spec MUST contain:
+    - Hook state variables
+    - system fucntions and equations on how this fucntions affet pool state adn hook state
+
+The HookSpec.tex OR HookSpec.md is the URI of the IPFS document. 
+Thus the platform MUST have the service of a pool (This pool is independant of protocol implementations) 
+    - letting view the system-state.md (READ ONLY)
+    - upload pdf that has HookSpec.md
+        - On this upload there must be a verification that accepts the document if it is compliant with system-state.md
+            -(Documents unrelated MUST be discarded)
+    - This generates a IPFS key assocuated with uploadre (Hook Developer)
+    - If successful this mints a HookLicense NFT with URI = the IPFS key generated by the document
+
+
+- Let's start with the frontend endpoints only from the HookDeveloper dashboard
+
+FrontEnd
+createHook --> HookDashbaord --> OpenStateSpaceModel --> [compare compatibility with STateSpaceMode]submitHookSpec
+BackEnd
+                                                                                                                    --> HookLicenseIssuer
+
+
+
+                                                                                                                    -->  (user, HookLicense)
+
+THis goes on the part 3 and 4 of the  
+The other part of the hook developer task is to provide the raw code the AVS verifier AND to the COFHE encoded
+    - Then deployed bytecode is COGFHE encoded
+    - functionalities request are sent to AVS verifier (staked amount by protocol designer making the query must havcve incentive economic meaning)
+At a high level the front end has received the PDF with the specification and is compliant The NFT has been minted also that represent the Hook license. Now the system provide a button to submit the Hook.sol code or a command with hook-bazaar cli command to submit the code and then It is sent to a AVS verifier and also to a FHE. The two confirmations appear one with the oupiut of the success/fail of the AVS verifier saying how compliant is the code with the pdf specification and another showing the transaction chash of the encrypted code deployed by CFHE
+
+
+
+
+
+
+Reference the current chat histroy and context buyt also now let's connect with the HookMarket component, inside documentation/ there is a md file to read:
+
+The ProtocolAdmin browse Hooks for a pool. There MUST be a Hook database on chain. The licencses structs  contain the category,
+from the IPFS link other details are fetchable 
+
+-If he enters a HookLens there is HaaS type contract information that if agreed he is prompted to subscribe to hook and excecutes the transaction to buy --> addHook
+
+- There is another part where he can check the code is deployerd --> retursn the obfuscated bytecode
+- ANd verify fucntionality (He can enter data) and the AVS SERVICE RETURNS accuracy report of results
+
+Again generate a specification document compliant with guyidliens and implemtn the FRONTEND COMPONENT ONLY
+
+
+Now the View Details button on the ProtocolDashboard NEEDS to prompt to a another page where the IProtocolAdminManager and
+IProtocolAdminClient is exposed on the UI with buttons for eahc service, for the AdminCLient it onyl needs to expose the createPool and setProtocolRevenu and asetPOolRevenue endpoints. This is ONLY FRONT END. Generate first the specification coherenmt with guidelines and the the front end code make sure it builds on npm run dev only
diff --git a/docs/hook-pkg/architecture/avs-verification-system.md b/docs/hook-pkg/architecture/avs-verification-system.md
new file mode 100644
index 000000000..6e9ab1fba
--- /dev/null
+++ b/docs/hook-pkg/architecture/avs-verification-system.md
@@ -0,0 +1,925 @@
+# Hook Attestation AVS: Verification Without Code Disclosure
+
+> **Status:** Architecture Design
+> **Last Updated:** 2025-12-09
+> **Prerequisites:** [State-Space Model](../mathematical-models/state-space-model.md)
+> **References:** [EigenLayer Middleware](https://github.com/Layr-Labs/eigenlayer-middleware), [Incredible Squaring AVS](https://github.com/Layr-Labs/incredible-squaring-avs)
+
+---
+
+## 1. Executive Summary
+
+This document describes the **HookAttestationAVS** - an EigenLayer Actively Validated Service that verifies hook implementations match their formal specifications **without revealing the source code**. The system enables:
+
+1. **Hook developers** to prove their implementations are correct
+2. **Integrators** to trust hooks based on cryptoeconomic guarantees
+3. **The marketplace** to provide verified, IP-protected hooks
+
+---
+
+## 2. System Architecture Overview
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                           HOOK BAZAAR ECOSYSTEM                              │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ┌──────────────────┐                        ┌──────────────────────────┐   │
+│  │   HOOK DEVELOPER │                        │     HOOK INTEGRATOR      │   │
+│  │                  │                        │                          │   │
+│  │  1. Write Spec   │                        │  6. Query Attestation    │   │
+│  │  2. Implement    │                        │  7. Deploy Verified Hook │   │
+│  │  3. Request AVS  │                        │                          │   │
+│  └────────┬─────────┘                        └────────────┬─────────────┘   │
+│           │                                               │                  │
+│           ▼                                               ▼                  │
+│  ┌────────────────────────────────────────────────────────────────────┐     │
+│  │                    HOOK ATTESTATION AVS                             │     │
+│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌───────────┐  │     │
+│  │  │   Service   │  │    Task     │  │   BLS Sig   │  │  Slashing │  │     │
+│  │  │   Manager   │  │   Manager   │  │   Checker   │  │  Registry │  │     │
+│  │  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  └─────┬─────┘  │     │
+│  └─────────┼────────────────┼────────────────┼───────────────┼────────┘     │
+│            │                │                │               │               │
+│            ▼                ▼                ▼               ▼               │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │                      AVS OPERATOR NETWORK                            │    │
+│  │                                                                      │    │
+│  │   ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐           │    │
+│  │   │Operator 1│  │Operator 2│  │Operator 3│  │Operator N│   ...     │    │
+│  │   │          │  │          │  │          │  │          │           │    │
+│  │   │ Sampler  │  │ Sampler  │  │ Sampler  │  │ Sampler  │           │    │
+│  │   │ Verifier │  │ Verifier │  │ Verifier │  │ Verifier │           │    │
+│  │   └──────────┘  └──────────┘  └──────────┘  └──────────┘           │    │
+│  └──────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │                      ON-CHAIN INFRASTRUCTURE                         │    │
+│  │                                                                      │    │
+│  │   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐         │    │
+│  │   │ Hook Market  │    │  Pool Mgr    │    │  Fhenix CoFHE│         │    │
+│  │   │   (NFTs)     │◄──►│  (Uniswap)   │◄──►│  (Encrypted) │         │    │
+│  │   └──────────────┘    └──────────────┘    └──────────────┘         │    │
+│  │                                                                      │    │
+│  │   ┌──────────────┐    ┌──────────────┐                              │    │
+│  │   │    IPFS      │    │  Attestation │                              │    │
+│  │   │ (Spec Docs)  │    │   Registry   │                              │    │
+│  │   └──────────────┘    └──────────────┘                              │    │
+│  └──────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 3. Core Components
+
+### 3.1 Hook Specification Document (IPFS)
+
+The hook developer creates a formal specification stored on IPFS:
+
+```markdown
+# Hook Specification: DynamicFeeHook v1.0.0
+
+## 1. Hook Identity
+- **Hook Address:** 0x... (deployed via Fhenix CoFHE)
+- **Callbacks Implemented:** beforeSwap, afterSwap
+- **Specification Hash:** QmXyz...
+
+## 2. State Variables
+
+### Hook State (H)
+| Variable | Type | Description |
+|----------|------|-------------|
+| volatilityWindow | uint256 | Rolling window for volatility calculation |
+| lastPrice | uint160 | Last recorded sqrtPriceX96 |
+| feeMultiplier | uint24 | Dynamic fee adjustment factor |
+
+### Pool State Dependencies (P)
+- Reads: TRADER_SQRT_PRICE, TRADER_TICK, TRADER_LP_FEE
+- Writes: TRADER_LP_FEE (via beforeSwap return)
+
+## 3. State Transition Functions
+
+### beforeSwap(H, P) → (H', δfee)
+
+$$
+\text{volatility} = |\sqrt{P}_{current} - \sqrt{P}_{last}| / \sqrt{P}_{last}
+$$
+
+$$
+\text{feeMultiplier}' = \min(\text{MAX\_FEE}, \text{baseFee} \times (1 + \text{volatility} \times \text{sensitivity}))
+$$
+
+$$
+\delta_{fee} = \text{feeMultiplier}' - \phi_{lp}
+$$
+
+### Constraints
+- `0 <= feeMultiplier' <= MAX_FEE (10000 = 1%)`
+- `volatility` computed over `volatilityWindow` blocks
+- No state changes if `volatility < MIN_THRESHOLD`
+
+## 4. Invariants
+
+### INV-1: Fee Bounds
+$$
+\forall t: \text{baseFee} \leq \phi_{lp}(t) \leq \text{MAX\_FEE}
+$$
+
+### INV-2: Monotonic Volatility Response
+$$
+\text{volatility}_1 < \text{volatility}_2 \Rightarrow \phi_{lp,1} \leq \phi_{lp,2}
+$$
+
+## 5. Test Vectors
+
+| Pre-State | Input | Expected Post-State |
+|-----------|-------|---------------------|
+| lastPrice=1e18, fee=3000 | sqrtP=1.01e18 | fee=3030 |
+| lastPrice=1e18, fee=3000 | sqrtP=1.10e18 | fee=MAX_FEE |
+| lastPrice=1e18, fee=3000 | sqrtP=1.001e18 | fee=3000 (no change) |
+```
+
+### 3.2 Task Manager Contract
+
+Based on [Incredible Squaring AVS](https://github.com/Layr-Labs/incredible-squaring-avs/blob/master/contracts/src/IncredibleSquaringTaskManager.sol):
+
+```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+import {BLSSignatureChecker} from "@eigenlayer-middleware/src/BLSSignatureChecker.sol";
+import {OperatorStateRetriever} from "@eigenlayer-middleware/src/OperatorStateRetriever.sol";
+import {ISlashingRegistryCoordinator} from "@eigenlayer-middleware/src/interfaces/ISlashingRegistryCoordinator.sol";
+
+/// @title IHookAttestationTaskManager
+/// @notice Task manager for hook specification verification
+interface IHookAttestationTaskManager {
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // EVENTS
+    // ═══════════════════════════════════════════════════════════════════════
+
+    event AttestationTaskCreated(
+        uint32 indexed taskIndex,
+        AttestationTask task
+    );
+
+    event AttestationTaskResponded(
+        uint32 indexed taskIndex,
+        AttestationResponse response,
+        AttestationResponseMetadata metadata
+    );
+
+    event AttestationChallenged(
+        uint32 indexed taskIndex,
+        address indexed challenger,
+        bool challengeSuccessful
+    );
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // STRUCTS
+    // ═══════════════════════════════════════════════════════════════════════
+
+    /// @notice An attestation task to verify hook specification compliance
+    struct AttestationTask {
+        /// @dev The hook contract address to verify
+        address hook;
+        /// @dev IPFS CID of the formal specification
+        string specificationURI;
+        /// @dev Pool IDs to sample state from
+        bytes32[] poolIds;
+        /// @dev Callbacks to test
+        bytes4[] callbacks;
+        /// @dev Number of state samples required
+        uint32 sampleCount;
+        /// @dev Block when task was created
+        uint32 taskCreatedBlock;
+        /// @dev Quorum configuration
+        bytes quorumNumbers;
+        /// @dev Threshold percentage for consensus
+        uint32 quorumThresholdPercentage;
+    }
+
+    /// @notice Response from operators after verification
+    struct AttestationResponse {
+        /// @dev Reference to the task being responded to
+        uint32 referenceTaskIndex;
+        /// @dev Whether the hook passes all spec tests
+        bool specCompliant;
+        /// @dev Hash of all state samples collected
+        bytes32 stateSamplesHash;
+        /// @dev Hash of test results
+        bytes32 testResultsHash;
+        /// @dev Number of invariants verified
+        uint32 invariantsVerified;
+        /// @dev Number of invariants failed
+        uint32 invariantsFailed;
+    }
+
+    /// @notice Metadata about the response
+    struct AttestationResponseMetadata {
+        uint32 taskRespondedBlock;
+        bytes32 hashOfNonSigners;
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // TASK LIFECYCLE
+    // ═══════════════════════════════════════════════════════════════════════
+
+    /// @notice Create a new attestation task
+    /// @param hook The hook contract to verify
+    /// @param specificationURI IPFS URI of formal specification
+    /// @param poolIds Pools to sample for verification
+    /// @param callbacks Hook callbacks to test
+    /// @param sampleCount Number of state samples to collect
+    function createAttestationTask(
+        address hook,
+        string calldata specificationURI,
+        bytes32[] calldata poolIds,
+        bytes4[] calldata callbacks,
+        uint32 sampleCount
+    ) external returns (uint32 taskIndex);
+
+    /// @notice Respond to an attestation task
+    /// @param task The original task
+    /// @param response The verification response
+    /// @param nonSignerStakesAndSignature BLS signature data
+    function respondToAttestationTask(
+        AttestationTask calldata task,
+        AttestationResponse calldata response,
+        BLSSignatureChecker.NonSignerStakesAndSignature memory nonSignerStakesAndSignature
+    ) external;
+
+    /// @notice Challenge an attestation response
+    /// @param task The original task
+    /// @param response The contested response
+    /// @param responseMetadata Response metadata
+    /// @param counterSamples State samples proving incorrect verification
+    function challengeAttestation(
+        AttestationTask calldata task,
+        AttestationResponse calldata response,
+        AttestationResponseMetadata calldata responseMetadata,
+        bytes calldata counterSamples
+    ) external;
+}
+```
+
+### 3.3 Operator Verification Logic (Off-Chain)
+
+```
+┌───────────────────────────────────────────────────────────────────────────┐
+│                     OPERATOR VERIFICATION WORKFLOW                         │
+├───────────────────────────────────────────────────────────────────────────┤
+│                                                                            │
+│   ┌─────────────────────────────────────────────────────────────────┐     │
+│   │                    1. RECEIVE TASK                               │     │
+│   │   - Parse AttestationTask from NewTaskCreated event              │     │
+│   │   - Fetch specification from IPFS (specificationURI)             │     │
+│   │   - Parse spec into structured verification rules                │     │
+│   └─────────────────────────────────────────────────────────────────┘     │
+│                                 │                                          │
+│                                 ▼                                          │
+│   ┌─────────────────────────────────────────────────────────────────┐     │
+│   │                    2. SAMPLE STATE                               │     │
+│   │   FOR each poolId in task.poolIds:                               │     │
+│   │     FOR i = 1 to task.sampleCount:                               │     │
+│   │       - Sample LP state via IHookStateView                       │     │
+│   │       - Sample Trader state via IHookStateView                   │     │
+│   │       - Sample Hook state via hook.getHookState()                │     │
+│   │       - Record (preState, timestamp, blockNumber)                │     │
+│   └─────────────────────────────────────────────────────────────────┘     │
+│                                 │                                          │
+│                                 ▼                                          │
+│   ┌─────────────────────────────────────────────────────────────────┐     │
+│   │                    3. EXECUTE CALLBACKS                          │     │
+│   │   FOR each callback in task.callbacks:                           │     │
+│   │     FOR each preState sample:                                    │     │
+│   │       - Generate valid callback input based on spec              │     │
+│   │       - Execute callback via PoolManager (simulation)            │     │
+│   │       - Capture postState                                        │     │
+│   │       - Record StateTransition(preState, input, postState)       │     │
+│   └─────────────────────────────────────────────────────────────────┘     │
+│                                 │                                          │
+│                                 ▼                                          │
+│   ┌─────────────────────────────────────────────────────────────────┐     │
+│   │                    4. VERIFY AGAINST SPEC                        │     │
+│   │   FOR each StateTransition:                                      │     │
+│   │     - Extract expected postState from spec equations             │     │
+│   │     - Compare actual vs expected within tolerance                │     │
+│   │     - Check all declared invariants hold                         │     │
+│   │     - Record (passed: bool, deviation: uint256)                  │     │
+│   │                                                                  │     │
+│   │   IMPORTANT: Operators verify behavior, NOT code                 │     │
+│   │   - Code remains encrypted via Fhenix CoFHE                      │     │
+│   │   - Only input→output behavior is checked                        │     │
+│   └─────────────────────────────────────────────────────────────────┘     │
+│                                 │                                          │
+│                                 ▼                                          │
+│   ┌─────────────────────────────────────────────────────────────────┐     │
+│   │                    5. AGGREGATE RESULTS                          │     │
+│   │   - Compute stateSamplesHash = keccak256(all samples)            │     │
+│   │   - Compute testResultsHash = keccak256(all results)             │     │
+│   │   - Count invariantsVerified, invariantsFailed                   │     │
+│   │   - Determine specCompliant = (invariantsFailed == 0)            │     │
+│   └─────────────────────────────────────────────────────────────────┘     │
+│                                 │                                          │
+│                                 ▼                                          │
+│   ┌─────────────────────────────────────────────────────────────────┐     │
+│   │                    6. SIGN & SUBMIT                              │     │
+│   │   - Create AttestationResponse                                   │     │
+│   │   - Sign response with BLS key                                   │     │
+│   │   - Submit to Aggregator                                         │     │
+│   │   - Aggregator collects signatures, submits to TaskManager       │     │
+│   └─────────────────────────────────────────────────────────────────┘     │
+│                                                                            │
+└───────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 4. Verification Protocol: How to Prove Without Seeing Code
+
+### 4.1 The Core Insight
+
+The key to verifying hook compliance without seeing source code is **behavioral verification**:
+
+1. The **specification** defines expected input→output relationships
+2. Operators **execute the hook** as a black box
+3. Operators **compare actual outputs** to spec-defined expected outputs
+4. Code remains encrypted; only **behavior** is verified
+
+### 4.2 Mathematical Formalization
+
+Given a hook specification $\mathcal{F} = (f_1, f_2, ..., f_N)$ where each $f_i: (H, P) \rightarrow (H', \Delta)$:
+
+**Verification Condition:**
+
+For sampled states $\{(H_j, P_j)\}_{j=1}^{M}$ and callback $f_i$:
+
+$$
+\text{PASS} \iff \forall j: \|f_i^{actual}(H_j, P_j) - f_i^{spec}(H_j, P_j)\| \leq \epsilon
+$$
+
+Where:
+- $f_i^{actual}$ is the hook's actual behavior (black box execution)
+- $f_i^{spec}$ is the expected behavior from specification
+- $\epsilon$ is the acceptable deviation (due to gas, rounding, etc.)
+
+### 4.3 State Sampling Strategy
+
+```solidity
+/// @title HookStateSampler
+/// @notice Collects state samples for verification
+/// @dev Used by AVS operators off-chain
+contract HookStateSampler {
+
+    struct StateSample {
+        /// @dev Block number when sampled
+        uint256 blockNumber;
+        /// @dev Timestamp when sampled
+        uint256 timestamp;
+        /// @dev Pool identifier
+        bytes32 poolId;
+        /// @dev Encoded LP state (LPPositionState[])
+        bytes lpState;
+        /// @dev Encoded Trader state (TraderState)
+        bytes traderState;
+        /// @dev Encoded Hook state (hook-specific)
+        bytes hookState;
+        /// @dev Encoded shared state
+        bytes sharedState;
+    }
+
+    struct TransitionSample {
+        /// @dev State before callback
+        StateSample preState;
+        /// @dev Callback executed
+        bytes4 callback;
+        /// @dev Callback input parameters
+        bytes input;
+        /// @dev State after callback
+        StateSample postState;
+        /// @dev Gas consumed
+        uint256 gasUsed;
+        /// @dev Return data from callback
+        bytes returnData;
+    }
+
+    /// @notice Sample current pool and hook state
+    /// @param poolId Pool to sample
+    /// @param hook Hook contract
+    /// @param stateView State view contract
+    /// @return sample The state sample
+    function sampleCurrentState(
+        bytes32 poolId,
+        address hook,
+        address stateView
+    ) external view returns (StateSample memory sample) {
+        sample.blockNumber = block.number;
+        sample.timestamp = block.timestamp;
+        sample.poolId = poolId;
+
+        // Sample via IHookStateView
+        IHookStateView view = IHookStateView(stateView);
+
+        // Get trader state
+        TraderState memory traderState = view.getTraderState(PoolId.wrap(poolId));
+        sample.traderState = abi.encode(traderState);
+
+        // Get shared state
+        (uint256 feeGrowth0, uint256 feeGrowth1) = view.getSharedFeeState(PoolId.wrap(poolId));
+        sample.sharedState = abi.encode(feeGrowth0, feeGrowth1);
+
+        // Get hook-specific state
+        sample.hookState = view.getHookState(PoolId.wrap(poolId));
+    }
+
+    /// @notice Sample a state transition by executing callback
+    /// @param poolId Pool to test
+    /// @param hook Hook contract
+    /// @param callback Callback selector
+    /// @param input Callback input
+    /// @return transition The transition sample
+    function sampleTransition(
+        bytes32 poolId,
+        address hook,
+        bytes4 callback,
+        bytes calldata input
+    ) external returns (TransitionSample memory transition) {
+        // Record pre-state
+        transition.preState = this.sampleCurrentState(poolId, hook, address(stateView));
+        transition.callback = callback;
+        transition.input = input;
+
+        // Execute callback and measure gas
+        uint256 gasBefore = gasleft();
+
+        // Note: In practice, this would be done via PoolManager
+        // with proper context setup
+        (bool success, bytes memory returnData) = hook.call(
+            abi.encodeWithSelector(callback, input)
+        );
+
+        transition.gasUsed = gasBefore - gasleft();
+        transition.returnData = returnData;
+
+        // Record post-state
+        transition.postState = this.sampleCurrentState(poolId, hook, address(stateView));
+    }
+}
+```
+
+### 4.4 Specification Compliance Checker
+
+```solidity
+/// @title SpecificationComplianceChecker
+/// @notice Verifies hook behavior matches specification
+/// @dev Run by AVS operators off-chain
+library SpecificationComplianceChecker {
+
+    struct ComplianceResult {
+        bool compliant;
+        uint256 deviationMagnitude;
+        bytes32 failedInvariant;
+        string failureReason;
+    }
+
+    /// @notice Check if a state transition matches specification
+    /// @param spec Parsed specification
+    /// @param transition Observed transition
+    /// @param tolerance Acceptable deviation
+    /// @return result Compliance check result
+    function checkTransitionCompliance(
+        ParsedSpecification memory spec,
+        TransitionSample memory transition,
+        uint256 tolerance
+    ) internal pure returns (ComplianceResult memory result) {
+        result.compliant = true;
+
+        // 1. Compute expected post-state from spec equations
+        bytes memory expectedPostState = computeExpectedState(
+            spec,
+            transition.preState,
+            transition.callback,
+            transition.input
+        );
+
+        // 2. Compare actual vs expected
+        uint256 deviation = computeDeviation(
+            transition.postState.hookState,
+            expectedPostState
+        );
+
+        if (deviation > tolerance) {
+            result.compliant = false;
+            result.deviationMagnitude = deviation;
+            result.failureReason = "State deviation exceeds tolerance";
+            return result;
+        }
+
+        // 3. Check all invariants
+        for (uint256 i = 0; i < spec.invariants.length; i++) {
+            bool invariantHolds = checkInvariant(
+                spec.invariants[i],
+                transition.preState,
+                transition.postState
+            );
+
+            if (!invariantHolds) {
+                result.compliant = false;
+                result.failedInvariant = spec.invariants[i].id;
+                result.failureReason = "Invariant violated";
+                return result;
+            }
+        }
+    }
+
+    /// @notice Compute expected state from specification equations
+    /// @dev This is the core spec-to-verification translation
+    function computeExpectedState(
+        ParsedSpecification memory spec,
+        StateSample memory preState,
+        bytes4 callback,
+        bytes memory input
+    ) internal pure returns (bytes memory expectedState) {
+        // Find the transition function for this callback
+        TransitionFunction memory fn = findTransitionFunction(spec, callback);
+
+        // Decode pre-state variables needed by the function
+        HookState memory H = decodeHookState(preState.hookState);
+        TraderState memory P = abi.decode(preState.traderState, (TraderState));
+
+        // Apply the specification's transition equations
+        // This is pseudo-code - actual implementation depends on spec format
+        //
+        // Example for DynamicFeeHook:
+        // volatility = |P.sqrtPrice - H.lastPrice| / H.lastPrice
+        // H'.feeMultiplier = min(MAX_FEE, baseFee * (1 + volatility * sensitivity))
+        // deltaFee = H'.feeMultiplier - P.lpFee
+
+        expectedState = fn.apply(H, P, input);
+    }
+}
+```
+
+---
+
+## 5. Slashing Conditions
+
+Operators can be slashed for:
+
+### 5.1 False Positive (Attesting Non-Compliant Hook)
+
+```solidity
+/// @notice Challenge: Hook was attested but doesn't match spec
+/// @dev Challenger provides counter-sample proving non-compliance
+function challengeFalsePositive(
+    AttestationTask calldata task,
+    AttestationResponse calldata response,
+    TransitionSample calldata counterSample
+) external {
+    require(response.specCompliant == true, "Response already marked non-compliant");
+
+    // Verify counter-sample is valid
+    require(
+        verifyTransitionSampleAuthenticity(counterSample, task.taskCreatedBlock),
+        "Invalid counter-sample"
+    );
+
+    // Check if counter-sample proves non-compliance
+    ComplianceResult memory result = SpecificationComplianceChecker.checkTransitionCompliance(
+        fetchAndParseSpec(task.specificationURI),
+        counterSample,
+        COMPLIANCE_TOLERANCE
+    );
+
+    if (!result.compliant) {
+        // Challenge successful - slash operators who signed the response
+        _slashSigningOperators(task, response);
+        emit AttestationChallenged(response.referenceTaskIndex, msg.sender, true);
+    } else {
+        emit AttestationChallenged(response.referenceTaskIndex, msg.sender, false);
+    }
+}
+```
+
+### 5.2 False Negative (Rejecting Compliant Hook)
+
+```solidity
+/// @notice Challenge: Hook was rejected but actually matches spec
+/// @dev Challenger provides samples proving compliance
+function challengeFalseNegative(
+    AttestationTask calldata task,
+    AttestationResponse calldata response,
+    TransitionSample[] calldata complianceSamples
+) external {
+    require(response.specCompliant == false, "Response already marked compliant");
+
+    // Verify all provided samples show compliance
+    ParsedSpecification memory spec = fetchAndParseSpec(task.specificationURI);
+
+    for (uint256 i = 0; i < complianceSamples.length; i++) {
+        ComplianceResult memory result = SpecificationComplianceChecker.checkTransitionCompliance(
+            spec,
+            complianceSamples[i],
+            COMPLIANCE_TOLERANCE
+        );
+
+        require(result.compliant, "Sample does not prove compliance");
+    }
+
+    // Require minimum sample coverage
+    require(
+        complianceSamples.length >= task.sampleCount,
+        "Insufficient compliance evidence"
+    );
+
+    // Challenge successful - slash operators who signed the response
+    _slashSigningOperators(task, response);
+    emit AttestationChallenged(response.referenceTaskIndex, msg.sender, true);
+}
+```
+
+---
+
+## 6. Integration with Hook Marketplace
+
+### 6.1 Attestation Registry
+
+```solidity
+/// @title AttestationRegistry
+/// @notice On-chain registry of hook attestations
+contract AttestationRegistry {
+
+    struct Attestation {
+        bytes32 attestationId;
+        address hook;
+        string specificationURI;
+        bool isValid;
+        uint256 attestedAt;
+        uint256 expiresAt;
+        uint32 taskIndex;
+        bytes32 responsesHash;
+    }
+
+    /// @dev hook address => Attestation
+    mapping(address => Attestation) public attestations;
+
+    /// @dev hook address => attestation history
+    mapping(address => bytes32[]) public attestationHistory;
+
+    event AttestationRecorded(
+        address indexed hook,
+        bytes32 indexed attestationId,
+        string specificationURI,
+        uint256 expiresAt
+    );
+
+    event AttestationRevoked(
+        address indexed hook,
+        bytes32 indexed attestationId,
+        string reason
+    );
+
+    /// @notice Record a successful attestation
+    /// @dev Called by TaskManager after successful response
+    function recordAttestation(
+        address hook,
+        string calldata specificationURI,
+        uint32 taskIndex,
+        bytes32 responsesHash
+    ) external onlyTaskManager {
+        bytes32 attestationId = keccak256(abi.encode(
+            hook,
+            specificationURI,
+            taskIndex,
+            block.timestamp
+        ));
+
+        attestations[hook] = Attestation({
+            attestationId: attestationId,
+            hook: hook,
+            specificationURI: specificationURI,
+            isValid: true,
+            attestedAt: block.timestamp,
+            expiresAt: block.timestamp + ATTESTATION_VALIDITY_PERIOD,
+            taskIndex: taskIndex,
+            responsesHash: responsesHash
+        });
+
+        attestationHistory[hook].push(attestationId);
+
+        emit AttestationRecorded(hook, attestationId, specificationURI, block.timestamp + ATTESTATION_VALIDITY_PERIOD);
+    }
+
+    /// @notice Check if a hook has valid attestation
+    function isHookAttested(address hook) external view returns (bool) {
+        Attestation storage att = attestations[hook];
+        return att.isValid && att.expiresAt > block.timestamp;
+    }
+
+    /// @notice Get full attestation details
+    function getAttestation(address hook) external view returns (Attestation memory) {
+        return attestations[hook];
+    }
+}
+```
+
+### 6.2 Hook Market Integration
+
+```solidity
+/// @title HookMarket
+/// @notice Marketplace for verified hooks
+contract HookMarket {
+
+    IAttestationRegistry public immutable attestationRegistry;
+
+    /// @notice List a hook for sale/use
+    /// @dev Requires valid attestation
+    function listHook(
+        address hook,
+        uint256 price,
+        bytes calldata metadata
+    ) external {
+        require(
+            attestationRegistry.isHookAttested(hook),
+            "Hook must have valid attestation"
+        );
+
+        // ... listing logic
+    }
+
+    /// @notice Deploy a verified hook to a pool
+    /// @dev Checks attestation before allowing deployment
+    function deployVerifiedHook(
+        bytes32 poolId,
+        address hook
+    ) external {
+        require(
+            attestationRegistry.isHookAttested(hook),
+            "Hook must have valid attestation"
+        );
+
+        IAttestationRegistry.Attestation memory att = attestationRegistry.getAttestation(hook);
+
+        // Emit specification URI for integrators to review
+        emit HookDeployed(poolId, hook, att.specificationURI);
+
+        // ... deployment logic
+    }
+}
+```
+
+---
+
+## 7. End-to-End Workflow
+
+### 7.1 Hook Developer Journey
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                     HOOK DEVELOPER WORKFLOW                              │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                          │
+│  STEP 1: Write Specification                                             │
+│  ─────────────────────────────                                          │
+│  - Define state variables (H)                                            │
+│  - Define state transitions f_i(H, P) → (H', Δ)                         │
+│  - Define invariants                                                     │
+│  - Create test vectors                                                   │
+│  - Upload to IPFS → specificationURI                                     │
+│                                                                          │
+│  STEP 2: Implement Hook                                                  │
+│  ─────────────────────────                                              │
+│  - Write Solidity implementation                                         │
+│  - Ensure implementation matches specification                           │
+│  - Local testing against test vectors                                    │
+│                                                                          │
+│  STEP 3: Deploy via Fhenix CoFHE                                        │
+│  ───────────────────────────────                                        │
+│  - Encrypt hook bytecode using Fhenix                                    │
+│  - Deploy encrypted contract                                             │
+│  - Code is protected from decompilation                                  │
+│                                                                          │
+│  STEP 4: Request Attestation                                             │
+│  ───────────────────────────                                            │
+│  HookAttestationTaskManager.createAttestationTask(                       │
+│      hook: deployedHookAddress,                                          │
+│      specificationURI: "ipfs://Qm...",                                   │
+│      poolIds: [testPoolId1, testPoolId2],                                │
+│      callbacks: [beforeSwap.selector, afterSwap.selector],               │
+│      sampleCount: 100                                                    │
+│  )                                                                       │
+│                                                                          │
+│  STEP 5: Wait for Operator Verification                                  │
+│  ──────────────────────────────────────                                 │
+│  - Operators sample state from specified pools                           │
+│  - Operators execute callbacks as black-box                              │
+│  - Operators verify behavior matches spec                                │
+│  - Operators sign and submit response                                    │
+│                                                                          │
+│  STEP 6: Receive Attestation                                             │
+│  ───────────────────────────                                            │
+│  - If specCompliant == true:                                             │
+│    - Attestation recorded in AttestationRegistry                         │
+│    - Hook can be listed in HookMarket                                    │
+│  - If specCompliant == false:                                            │
+│    - Developer reviews failure reasons                                   │
+│    - Fix implementation and retry                                        │
+│                                                                          │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+### 7.2 Integrator Journey
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                     HOOK INTEGRATOR WORKFLOW                             │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                          │
+│  STEP 1: Browse Hook Market                                              │
+│  ──────────────────────────                                             │
+│  - View available hooks with attestations                                │
+│  - Filter by: callback types, attestation status, price                  │
+│                                                                          │
+│  STEP 2: Review Specification                                            │
+│  ────────────────────────────                                           │
+│  Attestation att = attestationRegistry.getAttestation(hookAddress);      │
+│  - Fetch specification from att.specificationURI                         │
+│  - Review:                                                               │
+│    - State variables and their meaning                                   │
+│    - Transition functions and expected behavior                          │
+│    - Invariants that are guaranteed                                      │
+│    - Test vectors for validation                                         │
+│                                                                          │
+│  STEP 3: Verify Attestation                                              │
+│  ──────────────────────────                                             │
+│  require(attestationRegistry.isHookAttested(hook), "Not attested");      │
+│  require(att.expiresAt > block.timestamp, "Attestation expired");        │
+│  require(att.taskIndex > 0, "Valid task index");                         │
+│                                                                          │
+│  STEP 4: Deploy to Pool                                                  │
+│  ──────────────────────                                                 │
+│  hookMarket.deployVerifiedHook(poolId, hookAddress);                     │
+│                                                                          │
+│  STEP 5: Trust Guarantees                                                │
+│  ────────────────────────                                               │
+│  - Hook behavior matches published specification                         │
+│  - Operators stake slashable collateral on this claim                    │
+│  - Economic security proportional to operator stake                      │
+│  - No need to audit source code                                          │
+│                                                                          │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 8. Security Considerations
+
+### 8.1 Attack Vectors & Mitigations
+
+| Attack | Description | Mitigation |
+|--------|-------------|------------|
+| **Spec Gaming** | Developer writes spec that matches malicious behavior | Community review of specs; spec quality scoring |
+| **Sample Manipulation** | Hook behaves correctly only for sampled states | Random sampling; cross-operator sample comparison |
+| **Operator Collusion** | Operators collude to attest false compliance | Minimum operator count; stake distribution requirements |
+| **Time-Based Attacks** | Hook behavior changes after attestation | Attestation expiry; re-attestation requirements |
+| **Gas Manipulation** | Hook uses excessive gas in non-sampled paths | Gas bounds in specification; gas monitoring |
+
+### 8.2 Trust Assumptions
+
+1. **Specification Trust**: Integrators must review and understand the specification
+2. **Operator Honesty**: Majority of operators are honest (enforced by slashing)
+3. **Sample Coverage**: Random sampling provides statistical coverage
+4. **Fhenix Security**: Code encryption prevents reverse engineering
+
+---
+
+## 9. References
+
+1. **[EigenLayer Middleware]** Layr-Labs. *eigenlayer-middleware*. https://github.com/Layr-Labs/eigenlayer-middleware
+
+2. **[Incredible Squaring AVS]** Layr-Labs. *incredible-squaring-avs*. https://github.com/Layr-Labs/incredible-squaring-avs
+
+3. **[Hello World AVS]** Layr-Labs. *hello-world-avs*. https://github.com/Layr-Labs/hello-world-avs
+
+4. **[State-Space Model]** Hook Bazaar. *Hook State-Space Model: Dual-Index Architecture*. `docs/hook-pkg/mathematical-models/state-space-model.md`
+
+5. **[arXiv:2512.06203]** Tranquilli & Gupta. *Formal State-Machine Models for Uniswap v3*. https://arxiv.org/abs/2512.06203
+
+6. **[Fhenix CoFHE]** Fhenix Protocol. *CoFHE Documentation*. https://cofhe-docs.fhenix.zone/
+
+---
+
+## 10. Appendix: Contract Deployment Addresses
+
+*To be populated after deployment*
+
+| Contract | Network | Address |
+|----------|---------|---------|
+| HookAttestationServiceManager | - | - |
+| HookAttestationTaskManager | - | - |
+| AttestationRegistry | - | - |
+| HookStateSampler | - | - |
diff --git a/docs/hook-pkg/architecture/bonded-hooks-comparison.md b/docs/hook-pkg/architecture/bonded-hooks-comparison.md
new file mode 100644
index 000000000..91990eea5
--- /dev/null
+++ b/docs/hook-pkg/architecture/bonded-hooks-comparison.md
@@ -0,0 +1,419 @@
+# Bonded Hooks vs Hook Bazaar: Comparative Analysis
+
+> **Document Type:** Competitive Analysis
+> **Last Updated:** 2025-12-09
+> **Related:** [Mission Statement](./mission-statement.md) | [System Overview](./system-overview.md)
+
+---
+
+## 1. Executive Summary
+
+This document provides a comprehensive comparison between **Bonded Hooks** and **Hook Bazaar**, two distinct approaches to creating marketplaces and ecosystems for Uniswap V4 hooks. While both projects aim to make hook development more accessible and provide economic incentives, they solve fundamentally different problems and serve different user personas.
+
+| Aspect | Bonded Hooks | Hook Bazaar |
+|--------|-------------|-------------|
+| **Primary Focus** | Low-code hook composition | IP-protected hook marketplace |
+| **Target User** | Pool admins, non-developers | Hook developers, integrators |
+| **Core Innovation** | Crowdfunded command development | Mathematical specification + verification |
+| **IP Model** | Open source commands | Encrypted implementations |
+| **Verification** | Centralized AVS operator | Decentralized EigenLayer AVS |
+| **Economic Model** | Bond-to-earn, gas rebates | Purchase/license hooks |
+
+---
+
+## 2. Architecture Comparison
+
+### 2.1 Bonded Hooks Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                        BONDED HOOKS ARCHITECTURE                        │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  ┌─────────────────┐                                                    │
+│  │   Pool Admin    │ ─── selects ───▶ ┌─────────────────┐              │
+│  └─────────────────┘                   │    BLOCKS       │              │
+│                                        │ (curated sets)  │              │
+│                                        └────────┬────────┘              │
+│                                                 │                       │
+│                                                 ▼                       │
+│  ┌──────────────────────────────────────────────────────────────────┐  │
+│  │                      MASTER CONTROL                               │  │
+│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐         │  │
+│  │  │Command 1 │→ │Command 2 │→ │Command 3 │→ │Command N │         │  │
+│  │  │(Points)  │  │(Fees)    │  │(Rebates) │  │(Custom)  │         │  │
+│  │  └──────────┘  └──────────┘  └──────────┘  └──────────┘         │  │
+│  │         Sequential execution per callback                        │  │
+│  └──────────────────────────────────────────────────────────────────┘  │
+│                                                                         │
+│  ┌──────────────────────────────────────────────────────────────────┐  │
+│  │                    ECONOMIC LAYER                                 │  │
+│  │  ┌──────────┐  ┌──────────────┐  ┌─────────────────┐            │  │
+│  │  │ Bonding  │  │  DegenPool   │  │ GasRebateManager│            │  │
+│  │  │ (ETH)    │  │  (Points)    │  │ (Centralized)   │            │  │
+│  │  └──────────┘  └──────────────┘  └─────────────────┘            │  │
+│  └──────────────────────────────────────────────────────────────────┘  │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+**Key Components:**
+- **MasterControl**: Routes callbacks to ordered Command[] lists
+- **Commands**: Small, modular behavior units (~200-500 LOC each)
+- **Blocks**: Curated bundles of commands for common use cases
+- **Bonding**: "Bond once, earn forever" rewards-per-share model
+- **MemoryCard**: Per-pool storage abstraction
+
+### 2.2 Hook Bazaar Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                        HOOK BAZAAR ARCHITECTURE                         │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  ┌─────────────────────────────────────────────────────────────────┐   │
+│  │              SPECIFICATION LAYER                                 │   │
+│  │  ┌─────────────────────────────────────────────────────────┐   │   │
+│  │  │  Mathematical Spec (LaTeX/JSON)                          │   │   │
+│  │  │  - State variables & indices                             │   │   │
+│  │  │  - Transition functions: f(H, P) → (H', Δ)               │   │   │
+│  │  │  - Invariants & bounds                                   │   │   │
+│  │  └─────────────────────────────────────────────────────────┘   │   │
+│  └─────────────────────────────────────────────────────────────────┘   │
+│                              │                                          │
+│                              ▼                                          │
+│  ┌─────────────────────────────────────────────────────────────────┐   │
+│  │              IMPLEMENTATION LAYER                                │   │
+│  │  ┌──────────────────────┐    ┌──────────────────────┐          │   │
+│  │  │  Encrypted Code      │    │  NFT Ownership       │          │   │
+│  │  │  (Fhenix CoFHE)      │    │  (Royalties/Sales)   │          │   │
+│  │  └──────────────────────┘    └──────────────────────┘          │   │
+│  └─────────────────────────────────────────────────────────────────┘   │
+│                              │                                          │
+│                              ▼                                          │
+│  ┌─────────────────────────────────────────────────────────────────┐   │
+│  │              VERIFICATION LAYER (EigenLayer AVS)                │   │
+│  │  ┌────────┐  ┌────────┐  ┌────────┐  ┌────────┐               │   │
+│  │  │ Op 1   │  │ Op 2   │  │ Op 3   │  │ Op N   │               │   │
+│  │  │(staked)│  │(staked)│  │(staked)│  │(staked)│               │   │
+│  │  └────────┘  └────────┘  └────────┘  └────────┘               │   │
+│  │       Distributed verification with slashing                   │   │
+│  └─────────────────────────────────────────────────────────────────┘   │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+**Key Components:**
+- **Specification**: Mathematical description of hook behavior
+- **Encrypted Implementation**: Source code protected via FHE
+- **AVS**: Decentralized verification network with economic security
+- **NFT**: Ownership, licensing, and royalty distribution
+
+---
+
+## 3. Feature-by-Feature Comparison
+
+### 3.1 Hook Development Model
+
+| Feature | Bonded Hooks | Hook Bazaar |
+|---------|-------------|-------------|
+| **Development Approach** | Compose existing commands | Write full implementations |
+| **Code Visibility** | Open source commands | Encrypted, IP protected |
+| **Customization** | Select from whitelisted blocks | Full implementation freedom |
+| **Learning Curve** | Low (pick commands) | High (write specs + code) |
+| **Innovation Potential** | Limited to existing commands | Unlimited |
+
+**Bonded Hooks Approach:**
+```solidity
+// Pool admin selects a Block (curated command set)
+MasterHook.install(poolId, blockId);
+
+// Commands execute sequentially
+// Command 1: PointsCommand (award points)
+// Command 2: FeeDistributorCommand (split fees)
+// Command 3: GasRebateCommand (track gas)
+```
+
+**Hook Bazaar Approach:**
+```solidity
+// Developer writes mathematical specification
+specification TWAMM {
+    state: { virtualReserves: (uint256, uint256), lastBlock: uint256 }
+    invariant: virtualReserves.0 * virtualReserves.1 >= k
+    transition beforeSwap: (H, P) → (H', Δ) where ...
+}
+
+// Developer implements specification (encrypted)
+// Integrator deploys verified instance
+```
+
+### 3.2 Economic Model
+
+| Feature | Bonded Hooks | Hook Bazaar |
+|---------|-------------|-------------|
+| **Primary Revenue** | Bond yields, gas rebates | Hook sales/licensing |
+| **Funding Model** | Crowdfunded development | Developer self-funded |
+| **User Incentives** | Points, rebates, airdrops | Verified hook guarantees |
+| **Developer Incentives** | Bond rewards | Sales royalties |
+
+**Bonded Hooks Economics:**
+```
+Bond ETH → Receive share of pool fees
+          → Earn gas rebates (via centralized AVS)
+          → Accumulate points for airdrops
+```
+
+**Hook Bazaar Economics:**
+```
+Developer → Lists hook (pays listing fee)
+         → Sets price/licensing terms
+         → Earns royalties on each deployment
+
+Integrator → Browses marketplace
+           → Purchases license
+           → Deploys verified instance
+```
+
+### 3.3 Verification & Trust
+
+| Feature | Bonded Hooks | Hook Bazaar |
+|---------|-------------|-------------|
+| **Verification Model** | Centralized AVS operator | Decentralized EigenLayer AVS |
+| **Trust Assumption** | Trust AVS operator | Trust cryptoeconomics |
+| **Slashing** | Not mentioned | Full slashing conditions |
+| **Challenge Period** | Not implemented | 7-day challenge window |
+| **What's Verified** | Gas usage (for rebates) | Behavioral compliance |
+
+**Bonded Hooks Trust Model:**
+```
+┌─────────────────────────────────────────┐
+│         CENTRALIZED AVS                  │
+│  ┌─────────────────────────────────┐    │
+│  │   Single Operator               │    │
+│  │   - Runs Python signer         │    │
+│  │   - Signs rebate proofs        │    │
+│  │   - Trusted to be honest       │    │
+│  └─────────────────────────────────┘    │
+└─────────────────────────────────────────┘
+```
+
+**Hook Bazaar Trust Model:**
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                  DECENTRALIZED AVS                               │
+│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐            │
+│  │ Op 1    │  │ Op 2    │  │ Op 3    │  │ Op N    │            │
+│  │ $500K   │  │ $300K   │  │ $800K   │  │ $200K   │            │
+│  │ staked  │  │ staked  │  │ staked  │  │ staked  │            │
+│  └─────────┘  └─────────┘  └─────────┘  └─────────┘            │
+│       │            │            │            │                  │
+│       └────────────┴────────────┴────────────┘                  │
+│                        │                                        │
+│                   BLS Aggregate                                 │
+│              (quorum threshold: 67%)                            │
+│                                                                 │
+│  Slashing Conditions:                                           │
+│  - False attestation: 100% slash                                │
+│  - Missed duty: 1% per miss                                     │
+│  - Collusion: 100% slash + ban                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### 3.4 IP Protection
+
+| Feature | Bonded Hooks | Hook Bazaar |
+|---------|-------------|-------------|
+| **Code Visibility** | Fully open source | Encrypted via Fhenix |
+| **IP Protection** | None (by design) | Full protection |
+| **Copying Prevention** | Social/reputation only | Cryptographic |
+| **Monetization of IP** | Not possible | Core feature |
+
+### 3.5 Composability
+
+| Feature | Bonded Hooks | Hook Bazaar |
+|---------|-------------|-------------|
+| **Hook Composition** | Native (command chaining) | Not native (single hook) |
+| **Modularity** | High (pick and choose) | Low (monolithic) |
+| **Upgrade Path** | Swap commands | Deploy new version |
+| **Storage Model** | MemoryCard (per-pool) | Hook-specific storage |
+
+---
+
+## 4. Advantages & Disadvantages
+
+### 4.1 Bonded Hooks
+
+#### Advantages
+
+| Advantage | Description |
+|-----------|-------------|
+| **Low Barrier to Entry** | Pool admins need no coding skills |
+| **Rapid Deployment** | Select block → deploy → done |
+| **Built-in Incentives** | Points, rebates, bond yields attract users |
+| **Community Funded** | Crowdfunded development reduces individual risk |
+| **Composable** | Mix and match commands per pool |
+| **Gas Optimized** | Single MasterHook contract, shared code |
+
+#### Disadvantages
+
+| Disadvantage | Description |
+|--------------|-------------|
+| **Limited Innovation** | Constrained to existing commands |
+| **Centralized AVS** | Single point of failure for rebates |
+| **No IP Protection** | Code is fully open source |
+| **Whitelist Dependency** | Commands must be approved |
+| **Complex Economics** | Multiple token types (bonds, points, shares) |
+| **Upgrade Risk** | Command upgrades affect all pools |
+
+### 4.2 Hook Bazaar
+
+#### Advantages
+
+| Advantage | Description |
+|-----------|-------------|
+| **Full IP Protection** | Encrypted code cannot be copied |
+| **Unlimited Innovation** | Any hook design possible |
+| **Decentralized Verification** | No single point of failure |
+| **Mathematical Guarantees** | Formal specifications |
+| **Clear Monetization** | Direct sales and licensing |
+| **Economic Security** | Slashing provides accountability |
+
+#### Disadvantages
+
+| Disadvantage | Description |
+|--------------|-------------|
+| **High Barrier** | Requires spec + implementation |
+| **Complexity** | Mathematical specifications are difficult |
+| **FHE Overhead** | Encrypted execution has gas cost |
+| **Slower Iteration** | New spec required for changes |
+| **No Composition** | Hooks are monolithic units |
+| **Infrastructure Dependent** | Requires Fhenix + EigenLayer |
+
+---
+
+## 5. Problem-Solution Matrix
+
+### 5.1 What Problems Does Each Solve?
+
+| Problem | Bonded Hooks | Hook Bazaar |
+|---------|:-----------:|:-----------:|
+| **"I want to deploy a hook but can't code"** | ✅ Solves | ❌ Does not solve |
+| **"I want to monetize my hook without revealing code"** | ❌ Does not solve | ✅ Solves |
+| **"I need guaranteed hook behavior"** | ⚠️ Partial (trusted AVS) | ✅ Solves (cryptoeconomic) |
+| **"I want gas rebates for traders"** | ✅ Solves | ❌ Does not solve |
+| **"I want to crowdfund hook development"** | ✅ Solves | ❌ Does not solve |
+| **"I want to protect my algorithm from competitors"** | ❌ Does not solve | ✅ Solves |
+| **"I want to combine multiple behaviors in one pool"** | ✅ Solves | ❌ Does not solve |
+| **"I want trustless verification without code disclosure"** | ❌ Does not solve | ✅ Solves |
+| **"I want simple hook discovery"** | ⚠️ Partial (blocks only) | ✅ Solves |
+| **"I want economic accountability for hook failures"** | ❌ Does not solve | ✅ Solves |
+
+### 5.2 User Persona Fit
+
+| User Persona | Bonded Hooks | Hook Bazaar |
+|--------------|:-----------:|:-----------:|
+| **Non-technical Pool Admin** | ✅ Perfect fit | ❌ Not suitable |
+| **Hook Developer (IP-sensitive)** | ❌ Not suitable | ✅ Perfect fit |
+| **Hook Developer (Open source)** | ⚠️ Limited (commands) | ⚠️ Overkill |
+| **DeFi Protocol Integrator** | ⚠️ Limited customization | ✅ Perfect fit |
+| **Yield Farmer/Trader** | ✅ Points & rebates | ❌ No direct benefits |
+| **Institutional Integrator** | ❌ Trust concerns | ✅ Perfect fit |
+
+---
+
+## 6. Which Is Better?
+
+### 6.1 It Depends on the Use Case
+
+**Choose Bonded Hooks if:**
+- You're a pool admin who wants pre-built functionality
+- You want to attract traders with gas rebates and points
+- You prioritize simplicity over customization
+- You're comfortable with centralized AVS trust
+- You want to participate in crowdfunded development
+- You need composable behaviors (multiple commands)
+
+**Choose Hook Bazaar if:**
+- You're a developer with proprietary algorithms
+- You need IP protection for your hook implementation
+- You require trustless, decentralized verification
+- You want mathematical guarantees of behavior
+- You're building for institutional integrators
+- You need economic accountability (slashing)
+
+### 6.2 Complementary, Not Competing
+
+The two projects address different market segments:
+
+```
+                    HOOK ECOSYSTEM SPECTRUM
+
+ Simple ◀──────────────────────────────────────────▶ Complex
+ Composed ◀─────────────────────────────────────────▶ Custom
+ Open ◀────────────────────────────────────────────▶ Protected
+
+         ┌─────────────────┐         ┌─────────────────┐
+         │  BONDED HOOKS   │         │   HOOK BAZAAR   │
+         │                 │         │                 │
+         │  Pool admins    │         │  Developers     │
+         │  Yield farmers  │         │  Institutions   │
+         │  Quick deploy   │         │  Custom algos   │
+         │  Gas rebates    │         │  IP protection  │
+         └─────────────────┘         └─────────────────┘
+                │                           │
+                │    ┌─────────────────┐    │
+                └───▶│  Could integrate │◀───┘
+                     │  Bazaar hooks as │
+                     │  Bonded commands │
+                     └─────────────────┘
+```
+
+### 6.3 Potential Integration
+
+A future integration could combine both approaches:
+
+1. **Hook Bazaar hooks as Bonded Commands**: Verified, IP-protected hooks could be wrapped as Bonded Hooks commands, allowing pool admins to use them without understanding the implementation.
+
+2. **Bonded Hooks economics on Bazaar**: The bond-to-earn model could be applied to Hook Bazaar hooks, creating staking incentives around verified hooks.
+
+3. **Shared verification**: Hook Bazaar's decentralized AVS could replace Bonded Hooks' centralized AVS for stronger trust guarantees.
+
+---
+
+## 7. Summary Table
+
+| Dimension | Bonded Hooks | Hook Bazaar | Winner |
+|-----------|-------------|-------------|--------|
+| **Ease of Use** | ⭐⭐⭐⭐⭐ | ⭐⭐ | Bonded Hooks |
+| **IP Protection** | ⭐ | ⭐⭐⭐⭐⭐ | Hook Bazaar |
+| **Decentralization** | ⭐⭐ | ⭐⭐⭐⭐⭐ | Hook Bazaar |
+| **Innovation Potential** | ⭐⭐ | ⭐⭐⭐⭐⭐ | Hook Bazaar |
+| **User Incentives** | ⭐⭐⭐⭐⭐ | ⭐⭐ | Bonded Hooks |
+| **Composability** | ⭐⭐⭐⭐⭐ | ⭐⭐ | Bonded Hooks |
+| **Economic Security** | ⭐⭐ | ⭐⭐⭐⭐⭐ | Hook Bazaar |
+| **Developer Monetization** | ⭐⭐ | ⭐⭐⭐⭐⭐ | Hook Bazaar |
+| **Infrastructure Dependencies** | ⭐⭐⭐⭐ | ⭐⭐ | Bonded Hooks |
+| **Institutional Appeal** | ⭐⭐ | ⭐⭐⭐⭐⭐ | Hook Bazaar |
+
+---
+
+## 8. Conclusion
+
+**Bonded Hooks** and **Hook Bazaar** are not competitors—they are complementary solutions for different segments of the Uniswap V4 hook ecosystem:
+
+- **Bonded Hooks** democratizes hook access for non-developers through composable commands and gamified economics (points, rebates, bonds). It excels at rapid deployment and user engagement but sacrifices IP protection and decentralized trust.
+
+- **Hook Bazaar** professionalizes hook development by enabling developers to monetize proprietary algorithms while providing integrators with mathematical guarantees backed by cryptoeconomic security. It excels at IP protection and verification but requires significant technical expertise.
+
+**The market needs both**: Bonded Hooks grows the pie by making hooks accessible to everyone, while Hook Bazaar elevates the standard by introducing formal specifications and trustless verification. Together, they can create a robust, multi-layered hook ecosystem for Uniswap V4.
+
+---
+
+## 9. References
+
+- [Bonded Hooks Repository](https://github.com/Jammabeans/Bonded-hooks)
+- [Hook Bazaar Mission Statement](./mission-statement.md)
+- [Hook Bazaar System Overview](./system-overview.md)
+- [EigenLayer Documentation](https://docs.eigenlayer.xyz/)
+- [Fhenix CoFHE Documentation](https://docs.fhenix.zone/)
+- [Uniswap V4 Hooks](https://docs.uniswap.org/contracts/v4/concepts/hooks)
diff --git a/docs/hook-pkg/architecture/function-refinement-tree.md b/docs/hook-pkg/architecture/function-refinement-tree.md
new file mode 100644
index 000000000..061a3ccc7
--- /dev/null
+++ b/docs/hook-pkg/architecture/function-refinement-tree.md
@@ -0,0 +1,719 @@
+# Hook Bazaar: Function Refinement Tree
+
+> **Document Type:** Functional Decomposition
+> **Last Updated:** 2025-12-09
+> **Related:** [Mission Statement](./mission-statement.md) | [Goal Tree](./goal-tree.md) | [State-Space Model](../mathematical-models/state-space-model.md)
+
+---
+
+## 1. Overview
+
+This document decomposes the Hook Bazaar system into hierarchical functions, connecting high-level capabilities to concrete mathematical operations and interface definitions.
+
+---
+
+## 2. Top-Level Function Decomposition
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                    F0: HOOK BAZAAR SYSTEM                                    │
+│                                                                              │
+│    Enable trading of verified, IP-protected Uniswap V4 hooks                 │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│    ┌───────────────┐   ┌───────────────┐   ┌───────────────┐                │
+│    │      F1       │   │      F2       │   │      F3       │                │
+│    │   SPECIFY     │   │    VERIFY     │   │    TRADE      │                │
+│    │    HOOKS      │   │    HOOKS      │   │    HOOKS      │                │
+│    └───────┬───────┘   └───────┬───────┘   └───────┬───────┘                │
+│            │                   │                   │                         │
+│            ▼                   ▼                   ▼                         │
+│    ┌───────────────┐   ┌───────────────┐   ┌───────────────┐                │
+│    │ F1.1 Define   │   │ F2.1 Sample   │   │ F3.1 List     │                │
+│    │ F1.2 Declare  │   │ F2.2 Execute  │   │ F3.2 Purchase │                │
+│    │ F1.3 Validate │   │ F2.3 Compare  │   │ F3.3 Deploy   │                │
+│    │ F1.4 Store    │   │ F2.4 Attest   │   │ F3.4 Route    │                │
+│    └───────────────┘   └───────────────┘   └───────────────┘                │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 3. F1: Specify Hooks
+
+### 3.1 Function Hierarchy
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  F1: SPECIFY HOOKS                                                           │
+│                                                                              │
+│  Transform hook requirements into formal mathematical specifications         │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  F1.1: Define State Variables                                                │
+│  ════════════════════════════                                               │
+│  │                                                                          │
+│  ├── F1.1.1: defineHookState(hookId) → H                                    │
+│  │   │                                                                      │
+│  │   │   Define the hook-specific state variables                           │
+│  │   │                                                                      │
+│  │   │   Input:  hookId: bytes32                                            │
+│  │   │   Output: H = {h_1, h_2, ..., h_n} where h_i ∈ Type_i                │
+│  │   │                                                                      │
+│  │   │   Example:                                                           │
+│  │   │   H_DynamicFee = {                                                   │
+│  │   │       volatilityWindow: uint256,                                     │
+│  │   │       lastPrice: uint160,                                            │
+│  │   │       feeMultiplier: uint24                                          │
+│  │   │   }                                                                  │
+│  │   │                                                                      │
+│  │   └── Interface: IHookSpecification.declareStateWrites()                 │
+│  │                                                                          │
+│  ├── F1.1.2: declarePoolStateReads() → (S_LP, S_T, S_shared)                │
+│  │   │                                                                      │
+│  │   │   Declare which pool state variables the hook reads                  │
+│  │   │                                                                      │
+│  │   │   Output: Bitmasks indicating accessed variables                     │
+│  │   │                                                                      │
+│  │   │   S_LP ⊆ {L_k, t_l, t_u, f_0^in, f_1^in, L_g, L_n, ...}             │
+│  │   │   S_T  ⊆ {√P, t_c, φ_lp, φ_proto, L_act, B_tick}                    │
+│  │   │   S_shared ⊆ {f_0^global, f_1^global}                                │
+│  │   │                                                                      │
+│  │   └── Interface: IHookSpecification.declareStateReads()                  │
+│  │                                                                          │
+│  └── F1.1.3: mapToStateView() → IHookStateView calls                        │
+│      │                                                                      │
+│      │   Map formal variables to concrete getter functions                  │
+│      │                                                                      │
+│      │   √P → IStateView.getSlot0().sqrtPriceX96                            │
+│      │   L_k → IStateView.getPositionLiquidity()                            │
+│      │   ...                                                                │
+│      │                                                                      │
+│      └── Reference: state-space-model.md Section 9                          │
+│                                                                              │
+│  F1.2: Declare Transition Functions                                          │
+│  ══════════════════════════════════                                         │
+│  │                                                                          │
+│  ├── F1.2.1: specifyCallback(callback) → f_i(H, P) → (H', Δ)                │
+│  │   │                                                                      │
+│  │   │   Define state transition for a specific callback                    │
+│  │   │                                                                      │
+│  │   │   Input:  callback ∈ {beforeSwap, afterSwap, beforeMint, ...}        │
+│  │   │   Output: Transition function specification                          │
+│  │   │                                                                      │
+│  │   │   Mathematical Form:                                                 │
+│  │   │   f_i: (H × P × Input_i) → (H' × Δ_i)                                │
+│  │   │                                                                      │
+│  │   │   where:                                                             │
+│  │   │   - H is hook state before                                           │
+│  │   │   - P is pool state (read-only for hook)                             │
+│  │   │   - Input_i is callback-specific input                               │
+│  │   │   - H' is hook state after                                           │
+│  │   │   - Δ_i is return delta (fee override, etc.)                         │
+│  │   │                                                                      │
+│  │   └── Interface: IHookSpecification.transitionBounds()                   │
+│  │                                                                          │
+│  ├── F1.2.2: specifyBeforeSwap(H, P, swapParams) → (H', δ_fee)              │
+│  │   │                                                                      │
+│  │   │   Concrete specification for beforeSwap callback                     │
+│  │   │                                                                      │
+│  │   │   Inputs:                                                            │
+│  │   │   - H: Current hook state                                            │
+│  │   │   - P.sqrtPriceX96: Current price                                    │
+│  │   │   - P.tick: Current tick                                             │
+│  │   │   - P.lpFee: Current LP fee                                          │
+│  │   │   - swapParams: (zeroForOne, amountSpecified, ...)                   │
+│  │   │                                                                      │
+│  │   │   Outputs:                                                           │
+│  │   │   - H': Updated hook state                                           │
+│  │   │   - δ_fee: Fee adjustment (can be 0)                                 │
+│  │   │                                                                      │
+│  │   │   Example (DynamicFeeHook):                                          │
+│  │   │   ┌─────────────────────────────────────────────────────────┐       │
+│  │   │   │ volatility = |P.sqrtPriceX96 - H.lastPrice| / H.lastPrice│       │
+│  │   │   │ H'.feeMultiplier = min(MAX_FEE, baseFee × (1 + v × k))   │       │
+│  │   │   │ H'.lastPrice = P.sqrtPriceX96                            │       │
+│  │   │   │ δ_fee = H'.feeMultiplier - P.lpFee                       │       │
+│  │   │   └─────────────────────────────────────────────────────────┘       │
+│  │   │                                                                      │
+│  │   └── Reference: IHooks.beforeSwap()                                     │
+│  │                                                                          │
+│  ├── F1.2.3: specifyAfterSwap(H, P, swapResult) → (H', δ_amounts)           │
+│  │   │                                                                      │
+│  │   │   Concrete specification for afterSwap callback                      │
+│  │   │                                                                      │
+│  │   │   Inputs:                                                            │
+│  │   │   - H: Current hook state (post-beforeSwap)                          │
+│  │   │   - P: Pool state after swap execution                               │
+│  │   │   - swapResult: (amount0, amount1, sqrtPriceAfter, ...)              │
+│  │   │                                                                      │
+│  │   │   Outputs:                                                           │
+│  │   │   - H': Final hook state                                             │
+│  │   │   - δ_amounts: Amount adjustments (usually 0)                        │
+│  │   │                                                                      │
+│  │   └── Reference: IHooks.afterSwap()                                      │
+│  │                                                                          │
+│  └── F1.2.4: specifyLiquidityCallbacks(...)                                 │
+│      │                                                                      │
+│      │   Similar structure for:                                             │
+│      │   - beforeAddLiquidity / afterAddLiquidity                           │
+│      │   - beforeRemoveLiquidity / afterRemoveLiquidity                     │
+│      │   - beforeDonate / afterDonate                                       │
+│      │                                                                      │
+│      └── Each follows f_i(H, P, Input) → (H', Δ) pattern                    │
+│                                                                              │
+│  F1.3: Declare Invariants                                                    │
+│  ════════════════════════                                                   │
+│  │                                                                          │
+│  ├── F1.3.1: declareStateInvariant(inv_id) → φ(H)                           │
+│  │   │                                                                      │
+│  │   │   Invariant over hook state only                                     │
+│  │   │                                                                      │
+│  │   │   Form: φ(H) ≡ predicate that must hold ∀ reachable H                │
+│  │   │                                                                      │
+│  │   │   Example:                                                           │
+│  │   │   INV-FEE-BOUNDS: 0 ≤ H.feeMultiplier ≤ MAX_FEE                      │
+│  │   │                                                                      │
+│  │   └── Interface: IHookSpecification.declareInvariants()                  │
+│  │                                                                          │
+│  ├── F1.3.2: declareTransitionInvariant(callback) → ψ(H, H', P)             │
+│  │   │                                                                      │
+│  │   │   Invariant relating pre and post states                             │
+│  │   │                                                                      │
+│  │   │   Form: ψ(H, H', P) ≡ relationship that must hold                    │
+│  │   │                                                                      │
+│  │   │   Example:                                                           │
+│  │   │   INV-MONOTONIC: volatility₁ < volatility₂ ⟹ fee₁ ≤ fee₂            │
+│  │   │                                                                      │
+│  │   └── Used in behavioral verification                                    │
+│  │                                                                          │
+│  └── F1.3.3: declarePoolInvariant() → χ(P, H)                               │
+│      │                                                                      │
+│      │   Invariant relating pool state to hook state                        │
+│      │                                                                      │
+│      │   Example (from arXiv:2512.06203):                                   │
+│      │   INV-PRODUCT: |K_n - K_0| ≤ n × B                                   │
+│      │   where K = X × Y (constant product)                                 │
+│      │                                                                      │
+│      └── Reference: state-space-model.md Section 4                          │
+│                                                                              │
+│  F1.4: Store Specification                                                   │
+│  ═════════════════════════                                                  │
+│  │                                                                          │
+│  ├── F1.4.1: serializeSpec(spec) → bytes                                    │
+│  │   │                                                                      │
+│  │   │   Convert specification to storable format                           │
+│  │   │                                                                      │
+│  │   │   Output: Markdown + LaTeX document                                  │
+│  │   │                                                                      │
+│  │   └── Format: See specification-template.md (to be created)              │
+│  │                                                                          │
+│  ├── F1.4.2: uploadToIPFS(specBytes) → CID                                  │
+│  │   │                                                                      │
+│  │   │   Store specification on IPFS                                        │
+│  │   │                                                                      │
+│  │   │   Output: Content Identifier (CID) string                            │
+│  │   │                                                                      │
+│  │   └── Example: "ipfs://QmXyz..."                                         │
+│  │                                                                          │
+│  └── F1.4.3: linkToHook(hookAddress, specCID) → void                        │
+│      │                                                                      │
+│      │   Associate specification with deployed hook                         │
+│      │                                                                      │
+│      │   On-chain: hook.specificationURI = specCID                          │
+│      │                                                                      │
+│      └── Interface: IHookSpecification.specificationURI()                   │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 4. F2: Verify Hooks
+
+### 4.1 Function Hierarchy
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  F2: VERIFY HOOKS                                                            │
+│                                                                              │
+│  Prove hook implementation matches specification without code disclosure     │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  F2.1: Sample State                                                          │
+│  ══════════════════                                                         │
+│  │                                                                          │
+│  ├── F2.1.1: samplePoolState(poolId) → StateSample                          │
+│  │   │                                                                      │
+│  │   │   Capture current pool state snapshot                                │
+│  │   │                                                                      │
+│  │   │   Output: StateSample = {                                            │
+│  │   │       blockNumber: uint256,                                          │
+│  │   │       timestamp: uint256,                                            │
+│  │   │       poolId: bytes32,                                               │
+│  │   │       lpState: bytes,      // encoded LPPositionState[]              │
+│  │   │       traderState: bytes,  // encoded TraderState                    │
+│  │   │       hookState: bytes,    // encoded hook-specific state            │
+│  │   │       sharedState: bytes   // encoded fee growth                     │
+│  │   │   }                                                                  │
+│  │   │                                                                      │
+│  │   └── Uses: IHookStateView.getTraderState(), etc.                        │
+│  │                                                                          │
+│  ├── F2.1.2: sampleHookState(hook, poolId) → bytes                          │
+│  │   │                                                                      │
+│  │   │   Capture hook-specific state                                        │
+│  │   │                                                                      │
+│  │   │   Output: Encoded H values                                           │
+│  │   │                                                                      │
+│  │   └── Uses: IHookStateView.getHookState()                                │
+│  │                                                                          │
+│  └── F2.1.3: generateSampleSet(poolIds, n) → StateSample[]                  │
+│      │                                                                      │
+│      │   Generate n samples across specified pools                          │
+│      │                                                                      │
+│      │   Strategy:                                                          │
+│      │   - Random block selection within recent window                      │
+│      │   - Diverse pool states (different liquidity, prices)                │
+│      │   - Edge cases (near tick boundaries, low liquidity)                 │
+│      │                                                                      │
+│      └── Used by: AVS operators                                             │
+│                                                                              │
+│  F2.2: Execute Callbacks                                                     │
+│  ═══════════════════════                                                    │
+│  │                                                                          │
+│  ├── F2.2.1: executeCallback(hook, callback, input) → (output, gasUsed)     │
+│  │   │                                                                      │
+│  │   │   Execute hook callback as black box                                 │
+│  │   │                                                                      │
+│  │   │   Input:                                                             │
+│  │   │   - hook: address (encrypted bytecode)                               │
+│  │   │   - callback: bytes4 selector                                        │
+│  │   │   - input: bytes (callback parameters)                               │
+│  │   │                                                                      │
+│  │   │   Output:                                                            │
+│  │   │   - output: bytes (return data)                                      │
+│  │   │   - gasUsed: uint256                                                 │
+│  │   │                                                                      │
+│  │   │   Note: Code remains encrypted; only behavior observed               │
+│  │   │                                                                      │
+│  │   └── Execution via: PoolManager simulation or direct call               │
+│  │                                                                          │
+│  ├── F2.2.2: recordTransition(pre, callback, input, post) → TransitionSample│
+│  │   │                                                                      │
+│  │   │   Record complete state transition                                   │
+│  │   │                                                                      │
+│  │   │   Output: TransitionSample = {                                       │
+│  │   │       preState: StateSample,                                         │
+│  │   │       callback: bytes4,                                              │
+│  │   │       input: bytes,                                                  │
+│  │   │       postState: StateSample,                                        │
+│  │   │       gasUsed: uint256,                                              │
+│  │   │       returnData: bytes                                              │
+│  │   │   }                                                                  │
+│  │   │                                                                      │
+│  │   └── Used for: Verification comparison                                  │
+│  │                                                                          │
+│  └── F2.2.3: batchExecute(hook, callbacks[], inputs[]) → TransitionSample[] │
+│      │                                                                      │
+│      │   Execute multiple callbacks for comprehensive testing               │
+│      │                                                                      │
+│      └── Used by: AVS operators for task completion                         │
+│                                                                              │
+│  F2.3: Compare Against Specification                                         │
+│  ═══════════════════════════════════                                        │
+│  │                                                                          │
+│  ├── F2.3.1: parseSpecification(specURI) → ParsedSpec                       │
+│  │   │                                                                      │
+│  │   │   Load and parse specification from IPFS                             │
+│  │   │                                                                      │
+│  │   │   Output: ParsedSpec = {                                             │
+│  │   │       stateVars: StateVarDef[],                                      │
+│  │   │       transitions: TransitionDef[],                                  │
+│  │   │       invariants: InvariantDef[],                                    │
+│  │   │       testVectors: TestVector[]                                      │
+│  │   │   }                                                                  │
+│  │   │                                                                      │
+│  │   └── Parsing: Markdown → structured objects                             │
+│  │                                                                          │
+│  ├── F2.3.2: computeExpectedOutput(spec, preState, callback, input) → bytes │
+│  │   │                                                                      │
+│  │   │   Calculate expected output from specification                       │
+│  │   │                                                                      │
+│  │   │   Process:                                                           │
+│  │   │   1. Find transition function f_i for callback                       │
+│  │   │   2. Decode preState into (H, P)                                     │
+│  │   │   3. Apply f_i(H, P, input) equations                                │
+│  │   │   4. Encode expected (H', Δ) as bytes                                │
+│  │   │                                                                      │
+│  │   │   This is the CORE of spec-to-verification translation               │
+│  │   │                                                                      │
+│  │   └── Mathematical: f_i^spec(H, P, input) → (H', Δ)                      │
+│  │                                                                          │
+│  ├── F2.3.3: compareOutputs(actual, expected, ε) → ComparisonResult         │
+│  │   │                                                                      │
+│  │   │   Compare actual hook output to expected                             │
+│  │   │                                                                      │
+│  │   │   Input:                                                             │
+│  │   │   - actual: bytes (from executeCallback)                             │
+│  │   │   - expected: bytes (from computeExpectedOutput)                     │
+│  │   │   - ε: uint256 (tolerance for rounding)                              │
+│  │   │                                                                      │
+│  │   │   Output: ComparisonResult = {                                       │
+│  │   │       matches: bool,                                                 │
+│  │   │       deviation: uint256,                                            │
+│  │   │       fieldDeviations: mapping(field → deviation)                    │
+│  │   │   }                                                                  │
+│  │   │                                                                      │
+│  │   │   Condition: matches = (deviation ≤ ε)                               │
+│  │   │                                                                      │
+│  │   └── Accounts for: Rounding, gas limits, ordering                       │
+│  │                                                                          │
+│  └── F2.3.4: checkInvariants(spec, pre, post) → InvariantResult[]           │
+│      │                                                                      │
+│      │   Verify all declared invariants hold                                │
+│      │                                                                      │
+│      │   For each invariant φ ∈ spec.invariants:                            │
+│      │       result[φ.id] = evaluate(φ, pre, post)                          │
+│      │                                                                      │
+│      │   Output: Array of (invariantId, holds: bool, reason: string)        │
+│      │                                                                      │
+│      └── Used for: Comprehensive compliance check                           │
+│                                                                              │
+│  F2.4: Attest Compliance                                                     │
+│  ═══════════════════════                                                    │
+│  │                                                                          │
+│  ├── F2.4.1: aggregateResults(comparisons[], invariants[]) → AttestResult   │
+│  │   │                                                                      │
+│  │   │   Combine all verification results                                   │
+│  │   │                                                                      │
+│  │   │   Output: AttestResult = {                                           │
+│  │   │       specCompliant: bool,                                           │
+│  │   │       totalSamples: uint32,                                          │
+│  │   │       passingsamples: uint32,                                        │
+│  │   │       invariantsChecked: uint32,                                     │
+│  │   │       invariantsPassed: uint32,                                      │
+│  │   │       stateSamplesHash: bytes32,                                     │
+│  │   │       testResultsHash: bytes32                                       │
+│  │   │   }                                                                  │
+│  │   │                                                                      │
+│  │   │   specCompliant = (passingSamples == totalSamples) &&                │
+│  │   │                   (invariantsPassed == invariantsChecked)            │
+│  │   │                                                                      │
+│  │   └── Used by: AVS operators                                             │
+│  │                                                                          │
+│  ├── F2.4.2: signAttestation(result, operatorKey) → Signature               │
+│  │   │                                                                      │
+│  │   │   Sign attestation result with BLS key                               │
+│  │   │                                                                      │
+│  │   │   signature = BLS.sign(operatorKey, hash(result))                    │
+│  │   │                                                                      │
+│  │   └── Used for: Aggregated signature submission                          │
+│  │                                                                          │
+│  ├── F2.4.3: submitResponse(task, result, signatures) → void                │
+│  │   │                                                                      │
+│  │   │   Submit aggregated response to TaskManager                          │
+│  │   │                                                                      │
+│  │   │   On-chain: TaskManager.respondToAttestationTask(...)                │
+│  │   │                                                                      │
+│  │   └── Emits: AttestationTaskResponded event                              │
+│  │                                                                          │
+│  └── F2.4.4: recordAttestation(hook, specURI, taskIndex) → attestationId    │
+│      │                                                                      │
+│      │   Record successful attestation on-chain                             │
+│      │                                                                      │
+│      │   On-chain: AttestationRegistry.recordAttestation(...)               │
+│      │                                                                      │
+│      │   Output: attestationId = keccak256(hook, specURI, taskIndex, now)   │
+│      │                                                                      │
+│      └── Enables: Marketplace listing                                       │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 5. F3: Trade Hooks
+
+### 5.1 Function Hierarchy
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  F3: TRADE HOOKS                                                             │
+│                                                                              │
+│  Enable discovery, purchase, and deployment of verified hooks                │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  F3.1: List Hooks                                                            │
+│  ════════════════                                                           │
+│  │                                                                          │
+│  ├── F3.1.1: mintHookNFT(hook, specURI, metadata) → tokenId                 │
+│  │   │                                                                      │
+│  │   │   Create NFT representing hook ownership                             │
+│  │   │                                                                      │
+│  │   │   Requires: Valid attestation for hook                               │
+│  │   │                                                                      │
+│  │   │   Output: ERC-721 token with:                                        │
+│  │   │   - hook address                                                     │
+│  │   │   - specification URI                                                │
+│  │   │   - attestation ID                                                   │
+│  │   │   - metadata URI                                                     │
+│  │   │                                                                      │
+│  │   └── Contract: HookNFTRegistry.mint()                                   │
+│  │                                                                          │
+│  ├── F3.1.2: createListing(tokenId, price, terms) → listingId               │
+│  │   │                                                                      │
+│  │   │   List hook for sale in marketplace                                  │
+│  │   │                                                                      │
+│  │   │   Listing types:                                                     │
+│  │   │   - SALE: One-time transfer of ownership                             │
+│  │   │   - LICENSE: Per-use or subscription fee                             │
+│  │   │   - FREE: Open source with optional donation                         │
+│  │   │                                                                      │
+│  │   └── Contract: HookMarket.list()                                        │
+│  │                                                                          │
+│  └── F3.1.3: updateListing(listingId, newPrice, newTerms) → void            │
+│      │                                                                      │
+│      │   Modify existing listing                                            │
+│      │                                                                      │
+│      └── Contract: HookMarket.update()                                      │
+│                                                                              │
+│  F3.2: Purchase Hooks                                                        │
+│  ════════════════════                                                       │
+│  │                                                                          │
+│  ├── F3.2.1: queryListings(filters) → Listing[]                             │
+│  │   │                                                                      │
+│  │   │   Search available hooks                                             │
+│  │   │                                                                      │
+│  │   │   Filters:                                                           │
+│  │   │   - callbacks: bytes4[] (implemented callbacks)                      │
+│  │   │   - priceRange: (min, max)                                           │
+│  │   │   - attestationStatus: enum                                          │
+│  │   │   - category: string                                                 │
+│  │   │                                                                      │
+│  │   └── Off-chain: Indexer + on-chain verification                         │
+│  │                                                                          │
+│  ├── F3.2.2: verifyAttestation(hook) → AttestationInfo                      │
+│  │   │                                                                      │
+│  │   │   Check attestation validity before purchase                         │
+│  │   │                                                                      │
+│  │   │   Output: AttestationInfo = {                                        │
+│  │   │       isValid: bool,                                                 │
+│  │   │       attestationId: bytes32,                                        │
+│  │   │       expiresAt: uint256,                                            │
+│  │   │       specificationURI: string                                       │
+│  │   │   }                                                                  │
+│  │   │                                                                      │
+│  │   └── Contract: AttestationRegistry.getAttestation()                     │
+│  │                                                                          │
+│  └── F3.2.3: purchaseHook(listingId, payment) → receipt                     │
+│      │                                                                      │
+│      │   Complete hook purchase/license                                     │
+│      │                                                                      │
+│      │   Process:                                                           │
+│      │   1. Verify attestation still valid                                  │
+│      │   2. Transfer payment to seller                                      │
+│      │   3. If SALE: Transfer NFT ownership                                 │
+│      │   4. If LICENSE: Grant usage rights                                  │
+│      │   5. Emit purchase event                                             │
+│      │                                                                      │
+│      └── Contract: HookMarket.purchase()                                    │
+│                                                                              │
+│  F3.3: Deploy Hooks                                                          │
+│  ══════════════════                                                         │
+│  │                                                                          │
+│  ├── F3.3.1: registerHookForPool(poolId, hook) → void                       │
+│  │   │                                                                      │
+│  │   │   Associate hook with a pool via MasterHook                          │
+│  │   │                                                                      │
+│  │   │   Requires:                                                          │
+│  │   │   - Caller has usage rights (owner or licensee)                      │
+│  │   │   - Hook has valid attestation                                       │
+│  │   │   - Pool exists                                                      │
+│  │   │                                                                      │
+│  │   └── Contract: ProtocolHookMediator.registerHook()                      │
+│  │                                                                          │
+│  ├── F3.3.2: initializePoolWithHook(params, hook) → poolId                  │
+│  │   │                                                                      │
+│  │   │   Create new pool with verified hook                                 │
+│  │   │                                                                      │
+│  │   │   Process:                                                           │
+│  │   │   1. Verify hook attestation                                         │
+│  │   │   2. Call PoolManager.initialize() with MasterHook                   │
+│  │   │   3. Register specific hook in MasterHook                            │
+│  │   │                                                                      │
+│  │   └── Uses: Uniswap V4 PoolManager                                       │
+│  │                                                                          │
+│  └── F3.3.3: composeHooks(poolId, hooks[]) → void                           │
+│      │                                                                      │
+│      │   Chain multiple hooks for a pool                                    │
+│      │                                                                      │
+│      │   Execution order defined by MasterHook                              │
+│      │   Each hook must have valid attestation                              │
+│      │                                                                      │
+│      └── Contract: MasterHook.setHookChain()                                │
+│                                                                              │
+│  F3.4: Route Callbacks                                                       │
+│  ═════════════════════                                                      │
+│  │                                                                          │
+│  ├── F3.4.1: routeCallback(poolId, callback, data) → result                 │
+│  │   │                                                                      │
+│  │   │   MasterHook routes callback to registered hook(s)                   │
+│  │   │                                                                      │
+│  │   │   Process:                                                           │
+│  │   │   1. Look up registered hooks for poolId                             │
+│  │   │   2. For each hook in chain:                                         │
+│  │   │      - Execute callback                                              │
+│  │   │      - Aggregate results                                             │
+│  │   │   3. Return combined result to PoolManager                           │
+│  │   │                                                                      │
+│  │   └── Contract: MasterHook (Diamond facet)                               │
+│  │                                                                          │
+│  ├── F3.4.2: aggregateDeltas(deltas[]) → combinedDelta                      │
+│  │   │                                                                      │
+│  │   │   Combine return values from chained hooks                           │
+│  │   │                                                                      │
+│  │   │   Strategy depends on callback type:                                 │
+│  │   │   - beforeSwap: Last non-zero fee wins, or sum                       │
+│  │   │   - afterSwap: Sum of amount deltas                                  │
+│  │   │   - etc.                                                             │
+│  │   │                                                                      │
+│  │   └── Defined in: Hook composition rules                                 │
+│  │                                                                          │
+│  └── F3.4.3: handleHookFailure(poolId, hook, error) → fallback              │
+│      │                                                                      │
+│      │   Handle hook execution failures                                     │
+│      │                                                                      │
+│      │   Options:                                                           │
+│      │   - REVERT: Entire transaction fails                                 │
+│      │   - SKIP: Continue without hook                                      │
+│      │   - FALLBACK: Use default behavior                                   │
+│      │                                                                      │
+│      └── Configurable per pool                                              │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 6. Cross-Cutting Functions
+
+### 6.1 State Management
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  FC.1: STATE MANAGEMENT                                                      │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  FC.1.1: encodeState(state) → bytes                                          │
+│  ─────────────────────────────────                                          │
+│  │                                                                          │
+│  │  Convert typed state structs to bytes for hashing/storage                │
+│  │                                                                          │
+│  │  Used by: F2.1 (sampling), F2.3 (comparison)                             │
+│  │                                                                          │
+│  └── Implementation: abi.encode(state)                                      │
+│                                                                              │
+│  FC.1.2: decodeState(bytes, stateType) → state                               │
+│  ──────────────────────────────────────────────                             │
+│  │                                                                          │
+│  │  Reconstruct typed state from bytes                                      │
+│  │                                                                          │
+│  │  Used by: F2.3 (spec computation)                                        │
+│  │                                                                          │
+│  └── Implementation: abi.decode(bytes, (Type))                              │
+│                                                                              │
+│  FC.1.3: hashState(state) → bytes32                                          │
+│  ──────────────────────────────────                                         │
+│  │                                                                          │
+│  │  Compute deterministic hash of state                                     │
+│  │                                                                          │
+│  │  Used by: F2.4 (attestation recording)                                   │
+│  │                                                                          │
+│  └── Implementation: keccak256(encodeState(state))                          │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 6.2 Cryptographic Functions
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  FC.2: CRYPTOGRAPHIC FUNCTIONS                                               │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  FC.2.1: encryptBytecode(bytecode, key) → encryptedBytecode                  │
+│  ──────────────────────────────────────────────────────────                 │
+│  │                                                                          │
+│  │  Encrypt hook bytecode via Fhenix CoFHE                                  │
+│  │                                                                          │
+│  │  Used by: Hook deployment                                                │
+│  │                                                                          │
+│  └── Technology: Fhenix CoFHE                                               │
+│                                                                              │
+│  FC.2.2: signBLS(message, privateKey) → signature                            │
+│  ─────────────────────────────────────────────────                          │
+│  │                                                                          │
+│  │  Sign message with BLS private key                                       │
+│  │                                                                          │
+│  │  Used by: F2.4.2 (operator signatures)                                   │
+│  │                                                                          │
+│  └── Technology: EigenLayer BLS library                                     │
+│                                                                              │
+│  FC.2.3: verifyBLSAggregate(message, pubkeys[], aggSig) → bool               │
+│  ──────────────────────────────────────────────────────────────             │
+│  │                                                                          │
+│  │  Verify aggregated BLS signature                                         │
+│  │                                                                          │
+│  │  Used by: TaskManager response verification                              │
+│  │                                                                          │
+│  └── Contract: BLSSignatureChecker                                          │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 7. Function-to-Interface Mapping
+
+| Function | Interface/Contract | Method |
+|----------|-------------------|--------|
+| F1.1.1 | `IHookSpecification` | `declareStateWrites()` |
+| F1.1.2 | `IHookSpecification` | `declareStateReads()` |
+| F1.3.1 | `IHookSpecification` | `declareInvariants()` |
+| F1.4.3 | `IHookSpecification` | `specificationURI()` |
+| F2.1.1 | `IHookStateView` | `getTraderState()`, `getLPPositionState()` |
+| F2.1.2 | `IHookStateView` | `getHookState()` |
+| F2.4.3 | `IHookAttestationTaskManager` | `respondToAttestationTask()` |
+| F2.4.4 | `IAttestationRegistry` | `recordAttestation()` |
+| F3.1.1 | `IHookNFTRegistry` | `mint()` |
+| F3.1.2 | `IHookMarket` | `list()` |
+| F3.2.2 | `IAttestationRegistry` | `getAttestation()` |
+| F3.2.3 | `IHookMarket` | `purchase()` |
+| F3.3.1 | `IProtocolHookMediator` | `registerHook()` |
+| F3.4.1 | `IMasterHook` | `beforeSwap()`, etc. |
+
+---
+
+## 8. Mathematical Foundation Mapping
+
+| Function | Mathematical Concept | Reference |
+|----------|---------------------|-----------|
+| F1.1.1-3 | State space $\mathcal{S} = \mathcal{S}_{LP} \times \mathcal{S}_T \times \mathcal{S}_{shared}$ | state-space-model.md §2 |
+| F1.2.1-4 | Transition functions $f_i: (H \times P) \rightarrow (H' \times \Delta)$ | state-space-model.md §3 |
+| F1.3.1-3 | Invariants $\phi(H)$, $\psi(H, H', P)$, $\chi(P, H)$ | state-space-model.md §4 |
+| F2.3.2 | Expected output $f_i^{spec}(H, P, input)$ | avs-verification-system.md §4.2 |
+| F2.3.3 | Tolerance $\|f^{actual} - f^{spec}\| \leq \epsilon$ | avs-verification-system.md §4.2 |
+| F2.3.4 | Invariant verification $\forall \phi: \phi(H, P) = \text{true}$ | state-space-model.md §4 |
+
+---
+
+## 9. Next Steps
+
+Based on this decomposition, the priority implementation order is:
+
+1. **Specification Template (F1.4)**: Create concrete template developers can fill in
+2. **Spec Parser (F2.3.1)**: Build tool to parse specifications into verification rules
+3. **Expected Output Calculator (F2.3.2)**: Core spec-to-verification translation
+4. **State Sampler (F2.1)**: Implement sampling utilities
+5. **Comparison Logic (F2.3.3-4)**: Build verification comparison functions
diff --git a/docs/hook-pkg/architecture/goal-tree.md b/docs/hook-pkg/architecture/goal-tree.md
new file mode 100644
index 000000000..9b55b40f3
--- /dev/null
+++ b/docs/hook-pkg/architecture/goal-tree.md
@@ -0,0 +1,423 @@
+# Hook Bazaar: Goal Tree
+
+> **Document Type:** Strategic Decomposition
+> **Last Updated:** 2025-12-09
+> **Related:** [Mission Statement](./mission-statement.md) | [Function Refinement Tree](./function-refinement-tree.md)
+
+---
+
+## 1. Goal Tree Overview
+
+The goal tree decomposes the mission into hierarchical objectives, showing how lower-level goals contribute to higher-level outcomes.
+
+```
+                                    ┌─────────────────────────────────┐
+                                    │           MISSION               │
+                                    │  Trustless marketplace for      │
+                                    │  verified, IP-protected hooks   │
+                                    └───────────────┬─────────────────┘
+                                                    │
+                    ┌───────────────────────────────┼───────────────────────────────┐
+                    │                               │                               │
+                    ▼                               ▼                               ▼
+        ┌───────────────────────┐     ┌───────────────────────┐     ┌───────────────────────┐
+        │      GOAL 1           │     │      GOAL 2           │     │      GOAL 3           │
+        │  Enable Mathematical  │     │  Provide Trustless    │     │  Create Sustainable   │
+        │  Hook Specification   │     │  Verification         │     │  Marketplace          │
+        └───────────┬───────────┘     └───────────┬───────────┘     └───────────┬───────────┘
+                    │                             │                             │
+        ┌───────────┴───────────┐     ┌───────────┴───────────┐     ┌───────────┴───────────┐
+        │                       │     │                       │     │                       │
+        ▼                       ▼     ▼                       ▼     ▼                       ▼
+    [G1.1-G1.4]           [G2.1-G2.4]           [G3.1-G3.4]
+    Subgoals              Subgoals              Subgoals
+```
+
+---
+
+## 2. Primary Goals
+
+### G1: Enable Mathematical Hook Specification
+
+**Objective:** Create a formal framework for specifying hook behavior as mathematical systems
+
+**Success Criteria:**
+- Specification language can express all Uniswap V4 hook callbacks
+- Specifications are machine-parseable for verification
+- Specifications are human-readable for review
+
+---
+
+### G2: Provide Trustless Verification
+
+**Objective:** Verify that hook implementations match specifications without code disclosure
+
+**Success Criteria:**
+- Verification does not require access to source code
+- Economic security proportional to risk
+- Challenge mechanism for incorrect attestations
+
+---
+
+### G3: Create Sustainable Marketplace
+
+**Objective:** Build an economically viable platform for hook trading
+
+**Success Criteria:**
+- Developers can monetize hooks
+- Integrators can easily discover and deploy hooks
+- Platform is self-sustaining
+
+---
+
+## 3. Goal Decomposition
+
+### 3.1 G1: Enable Mathematical Hook Specification
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  G1: ENABLE MATHEMATICAL HOOK SPECIFICATION                                  │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G1.1: Define State Space Model                                       │    │
+│  │                                                                      │    │
+│  │ Formalize the state variables that hooks can read and write          │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G1.1.1: Partition pool state by user type (LP/Trader)            │    │
+│  │ ├── G1.1.2: Define hook-specific state variables (H)                 │    │
+│  │ ├── G1.1.3: Map IStateView to formal state vectors                   │    │
+│  │ └── G1.1.4: Document state variable semantics                        │    │
+│  │                                                                      │    │
+│  │ Deliverable: state-space-model.md                                    │    │
+│  │ Status: COMPLETE                                                     │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G1.2: Define Transition Functions                                    │    │
+│  │                                                                      │    │
+│  │ Specify how each callback transforms state                           │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G1.2.1: Map callbacks to state transitions                       │    │
+│  │ ├── G1.2.2: Define f_i(H, P) → (H', Δ) for each callback             │    │
+│  │ ├── G1.2.3: Specify pre/post conditions                              │    │
+│  │ └── G1.2.4: Define composition rules for chained hooks               │    │
+│  │                                                                      │    │
+│  │ Deliverable: transition-functions.md                                 │    │
+│  │ Status: PARTIAL (in state-space-model.md)                            │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G1.3: Define Invariant Framework                                     │    │
+│  │                                                                      │    │
+│  │ Specify properties that must always hold                             │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G1.3.1: Catalog pool invariants (constant product, etc.)         │    │
+│  │ ├── G1.3.2: Define hook-specific invariant types                     │    │
+│  │ ├── G1.3.3: Create invariant verification rules                      │    │
+│  │ └── G1.3.4: Document invariant composition                           │    │
+│  │                                                                      │    │
+│  │ Deliverable: invariant-framework.md                                  │    │
+│  │ Status: PARTIAL (in state-space-model.md)                            │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G1.4: Create Specification Template                                  │    │
+│  │                                                                      │    │
+│  │ Provide reusable template for hook specifications                    │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G1.4.1: Design specification document structure                  │    │
+│  │ ├── G1.4.2: Create LaTeX/Markdown template                           │    │
+│  │ ├── G1.4.3: Define test vector format                                │    │
+│  │ └── G1.4.4: Build specification validator tool                       │    │
+│  │                                                                      │    │
+│  │ Deliverable: specification-template.md                               │    │
+│  │ Status: NOT STARTED                                                  │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 3.2 G2: Provide Trustless Verification
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  G2: PROVIDE TRUSTLESS VERIFICATION                                          │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G2.1: Design AVS Architecture                                        │    │
+│  │                                                                      │    │
+│  │ Create EigenLayer AVS for hook verification                          │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G2.1.1: Define task structure (AttestationTask)                  │    │
+│  │ ├── G2.1.2: Define response structure (AttestationResponse)          │    │
+│  │ ├── G2.1.3: Design operator workflow                                 │    │
+│  │ └── G2.1.4: Integrate with EigenLayer middleware                     │    │
+│  │                                                                      │    │
+│  │ Deliverable: avs-verification-system.md                              │    │
+│  │ Status: COMPLETE                                                     │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G2.2: Implement Behavioral Verification                              │    │
+│  │                                                                      │    │
+│  │ Verify hook behavior without code access                             │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G2.2.1: Design state sampling strategy                           │    │
+│  │ ├── G2.2.2: Implement spec-to-expected-output translation            │    │
+│  │ ├── G2.2.3: Define tolerance/epsilon for comparisons                 │    │
+│  │ └── G2.2.4: Create verification result aggregation                   │    │
+│  │                                                                      │    │
+│  │ Deliverable: behavioral-verification.md + contracts                  │    │
+│  │ Status: DOCUMENTED (in avs-verification-system.md)                   │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G2.3: Implement Challenge Mechanism                                  │    │
+│  │                                                                      │    │
+│  │ Allow disputes of incorrect attestations                             │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G2.3.1: Define false positive challenge (bad attestation)        │    │
+│  │ ├── G2.3.2: Define false negative challenge (wrong rejection)        │    │
+│  │ ├── G2.3.3: Implement slashing logic                                 │    │
+│  │ └── G2.3.4: Define challenge window and resolution                   │    │
+│  │                                                                      │    │
+│  │ Deliverable: challenge-mechanism.md + contracts                      │    │
+│  │ Status: DOCUMENTED (in avs-verification-system.md)                   │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G2.4: Integrate Code Protection                                      │    │
+│  │                                                                      │    │
+│  │ Protect hook code from decompilation                                 │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G2.4.1: Integrate Fhenix CoFHE for bytecode encryption           │    │
+│  │ ├── G2.4.2: Define encryption/deployment workflow                    │    │
+│  │ ├── G2.4.3: Verify encrypted hooks remain callable                   │    │
+│  │ └── G2.4.4: Document gas overhead of encrypted execution             │    │
+│  │                                                                      │    │
+│  │ Deliverable: code-protection.md + integration guide                  │    │
+│  │ Status: NOT STARTED                                                  │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 3.3 G3: Create Sustainable Marketplace
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  G3: CREATE SUSTAINABLE MARKETPLACE                                          │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G3.1: Design NFT-Based Ownership                                     │    │
+│  │                                                                      │    │
+│  │ Represent hook ownership and rights as NFTs                          │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G3.1.1: Define NFT metadata schema                               │    │
+│  │ ├── G3.1.2: Link NFT to specification URI                            │    │
+│  │ ├── G3.1.3: Link NFT to deployed hook address                        │    │
+│  │ └── G3.1.4: Implement royalty mechanism (EIP-2981)                   │    │
+│  │                                                                      │    │
+│  │ Deliverable: HookNFTRegistry.sol                                     │    │
+│  │ Status: NOT STARTED                                                  │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G3.2: Build Hook Market                                              │    │
+│  │                                                                      │    │
+│  │ Create listing, discovery, and purchase mechanics                    │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G3.2.1: Implement hook listing function                          │    │
+│  │ ├── G3.2.2: Enforce attestation requirement for listing              │    │
+│  │ ├── G3.2.3: Implement purchase/licensing flow                        │    │
+│  │ └── G3.2.4: Build search and filter capabilities                     │    │
+│  │                                                                      │    │
+│  │ Deliverable: HookMarket.sol                                          │    │
+│  │ Status: NOT STARTED                                                  │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G3.3: Integrate with Uniswap V4                                      │    │
+│  │                                                                      │    │
+│  │ Connect marketplace hooks to PoolManager                             │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G3.3.1: Design MasterHook (Diamond pattern)                      │    │
+│  │ ├── G3.3.2: Implement ProtocolHookMediator                           │    │
+│  │ ├── G3.3.3: Create hook registration flow                            │    │
+│  │ └── G3.3.4: Handle hook composition and routing                      │    │
+│  │                                                                      │    │
+│  │ Deliverable: MasterHook.sol, ProtocolHookMediator.sol                │    │
+│  │ Status: IN PROGRESS (existing contracts)                             │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │ G3.4: Define Economic Model                                          │    │
+│  │                                                                      │    │
+│  │ Create sustainable economics for all participants                    │    │
+│  │                                                                      │    │
+│  │ Subgoals:                                                            │    │
+│  │ ├── G3.4.1: Define developer revenue model (sales, licensing, fees)  │    │
+│  │ ├── G3.4.2: Define operator incentives (verification rewards)        │    │
+│  │ ├── G3.4.3: Define platform fees                                     │    │
+│  │ └── G3.4.4: Model economic sustainability                            │    │
+│  │                                                                      │    │
+│  │ Deliverable: economic-model.md                                       │    │
+│  │ Status: NOT STARTED                                                  │    │
+│  └─────────────────────────────────────────────────────────────────────┘    │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 4. Goal Dependencies
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                         GOAL DEPENDENCY GRAPH                                │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│                              ┌─────────┐                                     │
+│                              │ MISSION │                                     │
+│                              └────┬────┘                                     │
+│                                   │                                          │
+│               ┌───────────────────┼───────────────────┐                      │
+│               │                   │                   │                      │
+│               ▼                   ▼                   ▼                      │
+│           ┌───────┐           ┌───────┐           ┌───────┐                  │
+│           │  G1   │           │  G2   │           │  G3   │                  │
+│           │ Spec  │           │Verify │           │Market │                  │
+│           └───┬───┘           └───┬───┘           └───┬───┘                  │
+│               │                   │                   │                      │
+│       ┌───────┴───────┐   ┌───────┴───────┐   ┌───────┴───────┐              │
+│       │               │   │               │   │               │              │
+│       ▼               ▼   ▼               ▼   ▼               ▼              │
+│   ┌───────┐       ┌───────┐           ┌───────┐           ┌───────┐          │
+│   │ G1.1  │◄──────│ G2.2  │           │ G2.1  │◄──────────│ G3.2  │          │
+│   │ State │       │Behav. │           │ AVS   │           │Market │          │
+│   │ Model │       │Verify │           │ Arch  │           │       │          │
+│   └───────┘       └───────┘           └───────┘           └───────┘          │
+│       │               ▲                   ▲                   │              │
+│       │               │                   │                   │              │
+│       ▼               │                   │                   ▼              │
+│   ┌───────┐       ┌───────┐           ┌───────┐           ┌───────┐          │
+│   │ G1.2  │──────▶│ G1.3  │           │ G2.4  │◄──────────│ G3.3  │          │
+│   │Trans. │       │Invari.│           │ Code  │           │Uniswap│          │
+│   │ Func  │       │       │           │Protect│           │Integr.│          │
+│   └───────┘       └───────┘           └───────┘           └───────┘          │
+│       │               │                                       │              │
+│       │               │                                       │              │
+│       ▼               ▼                                       ▼              │
+│   ┌───────────────────────┐                               ┌───────┐          │
+│   │        G1.4           │                               │ G3.1  │          │
+│   │   Spec Template       │◄──────────────────────────────│ NFT   │          │
+│   └───────────────────────┘                               └───────┘          │
+│                                                                              │
+│                                                                              │
+│  LEGEND:                                                                     │
+│  ───────▶  depends on (must complete before)                                 │
+│  ◄──────   enables (completion enables)                                      │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 5. Critical Path
+
+The critical path to minimum viable product (MVP):
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                           CRITICAL PATH TO MVP                               │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Phase 1: Foundation                                                         │
+│  ═══════════════════                                                         │
+│                                                                              │
+│  ┌─────────┐     ┌─────────┐     ┌─────────┐                                │
+│  │  G1.1   │────▶│  G1.2   │────▶│  G1.3   │                                │
+│  │ State   │     │ Trans.  │     │ Invari. │                                │
+│  │ Model   │     │ Funcs   │     │ Frame.  │                                │
+│  └─────────┘     └─────────┘     └─────────┘                                │
+│                                       │                                      │
+│                                       ▼                                      │
+│  Phase 2: Verification                │                                      │
+│  ═════════════════════                │                                      │
+│                                       │                                      │
+│  ┌─────────┐     ┌─────────┐     ┌────┴────┐                                │
+│  │  G2.1   │────▶│  G2.2   │◄────│  G1.4   │                                │
+│  │  AVS    │     │ Behav.  │     │  Spec   │                                │
+│  │  Arch   │     │ Verify  │     │ Template│                                │
+│  └─────────┘     └─────────┘     └─────────┘                                │
+│       │               │                                                      │
+│       ▼               ▼                                                      │
+│  ┌─────────┐     ┌─────────┐                                                │
+│  │  G2.3   │     │  G2.4   │                                                │
+│  │Challenge│     │  Code   │                                                │
+│  │  Mech.  │     │ Protect │                                                │
+│  └─────────┘     └─────────┘                                                │
+│       │               │                                                      │
+│       └───────┬───────┘                                                      │
+│               ▼                                                              │
+│  Phase 3: Marketplace                                                        │
+│  ════════════════════                                                        │
+│                                                                              │
+│  ┌─────────┐     ┌─────────┐     ┌─────────┐                                │
+│  │  G3.1   │────▶│  G3.2   │────▶│  G3.3   │                                │
+│  │  NFT    │     │ Market  │     │ Uniswap │                                │
+│  │ Ownership│    │         │     │ Integr. │                                │
+│  └─────────┘     └─────────┘     └─────────┘                                │
+│                                       │                                      │
+│                                       ▼                                      │
+│                                  ┌─────────┐                                │
+│                                  │   MVP   │                                │
+│                                  │ LAUNCH  │                                │
+│                                  └─────────┘                                │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 6. Goal Status Summary
+
+| Goal | Description | Status | Priority |
+|------|-------------|--------|----------|
+| G1.1 | State Space Model | COMPLETE | - |
+| G1.2 | Transition Functions | PARTIAL | HIGH |
+| G1.3 | Invariant Framework | PARTIAL | HIGH |
+| G1.4 | Specification Template | NOT STARTED | HIGH |
+| G2.1 | AVS Architecture | COMPLETE | - |
+| G2.2 | Behavioral Verification | DOCUMENTED | MEDIUM |
+| G2.3 | Challenge Mechanism | DOCUMENTED | MEDIUM |
+| G2.4 | Code Protection | NOT STARTED | HIGH |
+| G3.1 | NFT Ownership | NOT STARTED | MEDIUM |
+| G3.2 | Hook Market | NOT STARTED | MEDIUM |
+| G3.3 | Uniswap Integration | IN PROGRESS | HIGH |
+| G3.4 | Economic Model | NOT STARTED | LOW |
+
+---
+
+## 7. Next Actions
+
+Based on critical path and dependencies:
+
+1. **G1.2/G1.3**: Complete transition function and invariant documentation
+2. **G1.4**: Create specification template that developers can use
+3. **G2.4**: Begin Fhenix CoFHE integration research
+4. **G3.3**: Continue MasterHook and ProtocolHookMediator development
diff --git a/docs/hook-pkg/architecture/hook-specification-platform-decomposition.md b/docs/hook-pkg/architecture/hook-specification-platform-decomposition.md
new file mode 100644
index 000000000..11180bf84
--- /dev/null
+++ b/docs/hook-pkg/architecture/hook-specification-platform-decomposition.md
@@ -0,0 +1,1163 @@
+# Hook Specification Platform: System Decomposition
+
+> **Document Type:** Implementation TODO System
+> **Last Updated:** 2025-12-09
+> **Status:** Ready for Implementation
+> **Related:** [State-Space Model](../mathematical-models/state-space-model.md) | [System Overview](./system-overview.md)
+
+---
+
+## 1. Executive Summary
+
+This document decomposes the **Hook Specification Platform** into implementable components. The platform enables:
+
+1. **Public system state documentation** - Read-only `system-state.md` derived from `IStateView`
+2. **HookSpec upload & validation** - Verify spec compliance with system state schema
+3. **IPFS storage** - Generate content-addressed URIs for specifications
+4. **NFT minting** - Issue `HookLicense` NFTs with IPFS URI
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                    HOOK SPECIFICATION PLATFORM FLOW                          │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ┌──────────────────┐                                                        │
+│  │  system-state.md │◀───── IStateView Interface Parsing                    │
+│  │  (READ ONLY)     │                                                        │
+│  └────────┬─────────┘                                                        │
+│           │                                                                  │
+│           ▼                                                                  │
+│  ┌──────────────────────────────────────────────────────────────────────┐   │
+│  │                    HOOK DEVELOPER UPLOADS                             │   │
+│  │  ┌──────────────────┐                                                │   │
+│  │  │  HookSpec.md     │ ─── Contains: hook state vars + system funcs   │   │
+│  │  │  (or .tex/.pdf)  │                                                │   │
+│  │  └────────┬─────────┘                                                │   │
+│  └───────────┼──────────────────────────────────────────────────────────┘   │
+│              │                                                               │
+│              ▼                                                               │
+│  ┌──────────────────────────────────────────────────────────────────────┐   │
+│  │                    VALIDATION SERVICE                                 │   │
+│  │                                                                       │   │
+│  │  1. Parse HookSpec document                                          │   │
+│  │  2. Extract declared state variables                                  │   │
+│  │  3. Verify all referenced pool vars exist in system-state.md         │   │
+│  │  4. Validate function signatures reference valid state               │   │
+│  │  5. Check mathematical notation compliance                           │   │
+│  │                                                                       │   │
+│  │  ┌─────────────┐      ┌─────────────┐                               │   │
+│  │  │  ACCEPT ✓   │      │  REJECT ✗   │                               │   │
+│  │  │  (compliant)│      │  (invalid)  │                               │   │
+│  │  └──────┬──────┘      └─────────────┘                               │   │
+│  └─────────┼────────────────────────────────────────────────────────────┘   │
+│            │                                                                 │
+│            ▼                                                                 │
+│  ┌──────────────────────────────────────────────────────────────────────┐   │
+│  │                    IPFS UPLOAD SERVICE                                │   │
+│  │                                                                       │   │
+│  │  1. Pin document to IPFS                                             │   │
+│  │  2. Generate CID (content-addressed hash)                            │   │
+│  │  3. Associate CID with uploader address                              │   │
+│  │                                                                       │   │
+│  │  Output: ipfs://Qm... or ipfs://bafy...                              │   │
+│  └────────┬─────────────────────────────────────────────────────────────┘   │
+│           │                                                                  │
+│           ▼                                                                  │
+│  ┌──────────────────────────────────────────────────────────────────────┐   │
+│  │                    HOOKLICENSE NFT MINTING                            │   │
+│  │                                                                       │   │
+│  │  tokenURI = IPFS CID                                                 │   │
+│  │  owner = uploader (hook developer)                                   │   │
+│  │  metadata = { name, description, specVersion, ... }                  │   │
+│  └──────────────────────────────────────────────────────────────────────┘   │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 2. Component Decomposition
+
+### 2.1 Component Overview
+
+| ID | Component | Type | Priority | Dependencies |
+|----|-----------|------|----------|--------------|
+| C1 | System State Document | Documentation | P0 | IStateView interface |
+| C2 | HookSpec Schema | Schema/Spec | P0 | C1 |
+| C3 | Validation Service | Backend Service | P1 | C1, C2 |
+| C4 | IPFS Integration | Backend Service | P1 | C3 |
+| C5 | HookLicense NFT | Smart Contract | P1 | C4 |
+| C6 | Platform Frontend | Web App | P2 | C3, C4, C5 |
+
+---
+
+## 3. C1: System State Document (`system-state.md`)
+
+### 3.1 Purpose
+
+A **canonical, read-only document** that defines all pool state variables available for hooks to reference. Derived directly from parsing the `IStateView` interface.
+
+### 3.2 TODO Tasks
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ C1: SYSTEM STATE DOCUMENT                                                    │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│ □ C1.1 Parse IStateView Interface                                           │
+│   ├── Read contracts/lib/v4-periphery/src/interfaces/IStateView.sol         │
+│   ├── Extract all function signatures                                        │
+│   ├── Map return types to state variable definitions                         │
+│   └── Output: structured JSON of state variables                             │
+│                                                                              │
+│ □ C1.2 Generate system-state.md Document                                    │
+│   ├── Create markdown template with sections:                                │
+│   │   ├── Pool Configuration Variables                                       │
+│   │   ├── LP Index Variables (positions, ticks)                              │
+│   │   ├── Trader Index Variables (slot0, liquidity)                          │
+│   │   └── Shared Variables (fee growth)                                      │
+│   ├── Include mathematical notation for each variable                        │
+│   ├── Include Solidity type for each variable                                │
+│   └── Include IStateView getter mapping                                      │
+│                                                                              │
+│ □ C1.3 Version Control & Immutability                                       │
+│   ├── Pin system-state.md to IPFS                                           │
+│   ├── Store IPFS CID in platform contract                                   │
+│   └── Document versioning strategy for V4 upgrades                          │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 3.3 Output Schema
+
+```yaml
+# system-state.schema.yaml
+version: "1.0.0"
+uniswap_version: "v4"
+
+state_indices:
+  lp_index:
+    description: "Variables accessed by liquidity providers"
+    variables:
+      - name: "position_liquidity"
+        symbol: "L_k"
+        type: "uint128"
+        getter: "getPositionLiquidity(PoolId, bytes32)"
+        description: "Liquidity amount for a specific position"
+
+      - name: "tick_lower"
+        symbol: "t_l^k"
+        type: "int24"
+        getter: "getPositionInfo(PoolId, bytes32)"
+        description: "Lower tick bound of position"
+
+      # ... more variables
+
+  trader_index:
+    description: "Variables accessed by traders during swaps"
+    variables:
+      - name: "sqrt_price"
+        symbol: "√P"
+        type: "uint160"
+        getter: "getSlot0(PoolId)"
+        description: "Current sqrt price in Q64.96 format"
+
+      # ... more variables
+
+  shared:
+    description: "Variables accessed by both LPs and traders"
+    variables:
+      - name: "fee_growth_global_0"
+        symbol: "f_0^{global}"
+        type: "uint256"
+        getter: "getFeeGrowthGlobals(PoolId)"
+        description: "Cumulative fee growth for token0"
+
+      # ... more variables
+```
+
+### 3.4 Example system-state.md Output
+
+```markdown
+# System State Variables
+
+> **Version:** 1.0.0
+> **Uniswap Version:** V4
+> **IPFS CID:** QmXxx...
+> **Status:** READ ONLY - Canonical Reference
+
+---
+
+## 1. LP Index Variables ($\mathcal{S}_{LP}$)
+
+Variables primarily accessed by liquidity providers.
+
+### 1.1 Position Variables
+
+| Variable | Symbol | Type | IStateView Getter |
+|----------|--------|------|-------------------|
+| Position Liquidity | $L_k$ | `uint128` | `getPositionLiquidity(poolId, positionId)` |
+| Tick Lower | $t_l^k$ | `int24` | `getPositionInfo(poolId, positionId)` |
+| Tick Upper | $t_u^k$ | `int24` | `getPositionInfo(poolId, positionId)` |
+| Fee Growth Inside 0 | $f_{0,k}^{in}$ | `uint256` | `getPositionInfo(poolId, positionId)` |
+| Fee Growth Inside 1 | $f_{1,k}^{in}$ | `uint256` | `getPositionInfo(poolId, positionId)` |
+
+### 1.2 Tick Variables
+
+| Variable | Symbol | Type | IStateView Getter |
+|----------|--------|------|-------------------|
+| Liquidity Gross | $L_g^{tick}$ | `uint128` | `getTickLiquidity(poolId, tick)` |
+| Liquidity Net | $L_n^{tick}$ | `int128` | `getTickLiquidity(poolId, tick)` |
+| Fee Growth Outside 0 | $f_0^{out,tick}$ | `uint256` | `getTickFeeGrowthOutside(poolId, tick)` |
+| Fee Growth Outside 1 | $f_1^{out,tick}$ | `uint256` | `getTickFeeGrowthOutside(poolId, tick)` |
+
+---
+
+## 2. Trader Index Variables ($\mathcal{S}_T$)
+
+Variables primarily accessed by traders during swaps.
+
+| Variable | Symbol | Type | IStateView Getter |
+|----------|--------|------|-------------------|
+| Sqrt Price | $\sqrt{P}$ | `uint160` | `getSlot0(poolId)` |
+| Current Tick | $t_c$ | `int24` | `getSlot0(poolId)` |
+| LP Fee | $\phi_{lp}$ | `uint24` | `getSlot0(poolId)` |
+| Protocol Fee | $\phi_{proto}$ | `uint24` | `getSlot0(poolId)` |
+| Active Liquidity | $L_{act}$ | `uint128` | `getLiquidity(poolId)` |
+| Tick Bitmap | $B_{tick}$ | `uint256` | `getTickBitmap(poolId, wordPos)` |
+
+---
+
+## 3. Shared Variables ($\mathcal{S}_{shared}$)
+
+Variables accessed by both LPs and traders.
+
+| Variable | Symbol | Type | IStateView Getter |
+|----------|--------|------|-------------------|
+| Fee Growth Global 0 | $f_0^{global}$ | `uint256` | `getFeeGrowthGlobals(poolId)` |
+| Fee Growth Global 1 | $f_1^{global}$ | `uint256` | `getFeeGrowthGlobals(poolId)` |
+
+---
+
+## 4. Usage in HookSpec Documents
+
+When writing a HookSpec, you MUST reference state variables using:
+- The **Symbol** (e.g., $L_k$) for mathematical equations
+- The **Variable Name** (e.g., `position_liquidity`) for schema declarations
+
+Example:
+```yaml
+hook_state:
+  - name: "accumulated_fees"
+    symbol: "F_{acc}"
+    type: "uint256"
+
+system_functions:
+  - callback: "afterSwap"
+    reads: ["sqrt_price", "active_liquidity"]
+    writes: ["accumulated_fees"]
+    equation: "F_{acc}' = F_{acc} + \phi_{lp} \cdot \Delta"
+```
+```
+
+---
+
+## 4. C2: HookSpec Schema
+
+### 4.1 Purpose
+
+Define the **schema and validation rules** for HookSpec documents that developers upload.
+
+### 4.2 TODO Tasks
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ C2: HOOKSPEC SCHEMA                                                          │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│ □ C2.1 Define HookSpec JSON Schema                                          │
+│   ├── Required sections:                                                     │
+│   │   ├── metadata (name, version, author, description)                     │
+│   │   ├── hook_state (custom state variables)                               │
+│   │   ├── system_functions (callback specifications)                        │
+│   │   └── invariants (constraints that must hold)                           │
+│   ├── Optional sections:                                                     │
+│   │   ├── examples (usage examples)                                         │
+│   │   └── references (citations, related work)                              │
+│   └── Output: hookspec.schema.json                                          │
+│                                                                              │
+│ □ C2.2 Define Validation Rules                                              │
+│   ├── Rule V1: All referenced pool vars MUST exist in system-state.md      │
+│   ├── Rule V2: Hook state vars MUST have unique names                       │
+│   ├── Rule V3: System functions MUST map to valid callbacks                 │
+│   ├── Rule V4: Equations MUST use valid symbols from state defs             │
+│   ├── Rule V5: Types MUST be valid Solidity types                           │
+│   └── Output: validation-rules.md                                           │
+│                                                                              │
+│ □ C2.3 Support Multiple Formats                                             │
+│   ├── Primary: YAML/JSON (machine-readable)                                 │
+│   ├── Secondary: Markdown with YAML frontmatter                             │
+│   ├── Tertiary: LaTeX with structured comments                              │
+│   └── Define format detection and parsing strategy                          │
+│                                                                              │
+│ □ C2.4 Create Example HookSpecs                                             │
+│   ├── Example 1: Simple fee accumulator hook                                │
+│   ├── Example 2: TWAP oracle hook                                           │
+│   ├── Example 3: Dynamic fee hook                                           │
+│   └── Example 4: Liquidity mining hook                                      │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 4.3 HookSpec Schema Definition
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://hookbazaar.io/schemas/hookspec/v1.0.0",
+  "title": "HookSpec",
+  "description": "Schema for Hook Specification documents",
+  "type": "object",
+  "required": ["metadata", "hook_state", "system_functions"],
+  "properties": {
+    "metadata": {
+      "type": "object",
+      "required": ["name", "version", "author"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Human-readable hook name",
+          "pattern": "^[a-zA-Z][a-zA-Z0-9_-]{2,63}$"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$"
+        },
+        "author": {
+          "type": "string",
+          "description": "Ethereum address or ENS name"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 1000
+        },
+        "license": {
+          "type": "string",
+          "enum": ["MIT", "GPL-3.0", "BUSL-1.1", "PROPRIETARY"]
+        },
+        "system_state_version": {
+          "type": "string",
+          "description": "IPFS CID of system-state.md this spec targets"
+        }
+      }
+    },
+    "hook_state": {
+      "type": "array",
+      "description": "Custom state variables maintained by the hook",
+      "items": {
+        "$ref": "#/definitions/StateVariable"
+      }
+    },
+    "system_functions": {
+      "type": "array",
+      "description": "Callback specifications",
+      "items": {
+        "$ref": "#/definitions/SystemFunction"
+      }
+    },
+    "invariants": {
+      "type": "array",
+      "description": "Constraints that must always hold",
+      "items": {
+        "$ref": "#/definitions/Invariant"
+      }
+    }
+  },
+  "definitions": {
+    "StateVariable": {
+      "type": "object",
+      "required": ["name", "symbol", "type"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]*$"
+        },
+        "symbol": {
+          "type": "string",
+          "description": "LaTeX symbol (e.g., 'F_{acc}')"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["uint8", "uint16", "uint24", "uint32", "uint64", "uint128", "uint256",
+                   "int8", "int16", "int24", "int32", "int64", "int128", "int256",
+                   "address", "bool", "bytes32"]
+        },
+        "description": {
+          "type": "string"
+        },
+        "initial_value": {
+          "type": "string",
+          "description": "Initial value expression"
+        }
+      }
+    },
+    "SystemFunction": {
+      "type": "object",
+      "required": ["callback", "reads", "writes", "transition"],
+      "properties": {
+        "callback": {
+          "type": "string",
+          "enum": ["beforeInitialize", "afterInitialize",
+                   "beforeAddLiquidity", "afterAddLiquidity",
+                   "beforeRemoveLiquidity", "afterRemoveLiquidity",
+                   "beforeSwap", "afterSwap",
+                   "beforeDonate", "afterDonate"]
+        },
+        "reads": {
+          "type": "array",
+          "description": "Pool state variables read (from system-state.md)",
+          "items": { "type": "string" }
+        },
+        "writes": {
+          "type": "array",
+          "description": "Hook state variables modified",
+          "items": { "type": "string" }
+        },
+        "transition": {
+          "type": "object",
+          "description": "State transition specification",
+          "properties": {
+            "preconditions": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "equation": {
+              "type": "string",
+              "description": "LaTeX equation: H' = f(H, P)"
+            },
+            "postconditions": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "delta_returns": {
+              "type": "object",
+              "description": "BalanceDelta modifications",
+              "properties": {
+                "amount0": { "type": "string" },
+                "amount1": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "Invariant": {
+      "type": "object",
+      "required": ["name", "expression"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "expression": {
+          "type": "string",
+          "description": "LaTeX boolean expression"
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}
+```
+
+### 4.4 Example HookSpec Document
+
+```yaml
+# HookSpec: Fee Accumulator
+# Format: YAML with embedded LaTeX
+
+metadata:
+  name: "FeeAccumulatorHook"
+  version: "1.0.0"
+  author: "0x1234...abcd"
+  description: "Accumulates swap fees for later distribution"
+  license: "MIT"
+  system_state_version: "QmSystemStateV1..."
+
+hook_state:
+  - name: "accumulated_fees_0"
+    symbol: "F_0"
+    type: "uint256"
+    description: "Accumulated fees for token0"
+    initial_value: "0"
+
+  - name: "accumulated_fees_1"
+    symbol: "F_1"
+    type: "uint256"
+    description: "Accumulated fees for token1"
+    initial_value: "0"
+
+  - name: "last_distribution_block"
+    symbol: "b_{dist}"
+    type: "uint256"
+    description: "Block number of last fee distribution"
+    initial_value: "block.number"
+
+system_functions:
+  - callback: "afterSwap"
+    reads:
+      - "sqrt_price"        # √P from trader index
+      - "active_liquidity"  # L_act from trader index
+      - "lp_fee"            # φ_lp from trader index
+    writes:
+      - "accumulated_fees_0"
+      - "accumulated_fees_1"
+    transition:
+      preconditions:
+        - "swapDelta.amount0 != 0 OR swapDelta.amount1 != 0"
+      equation: |
+        F_0' = F_0 + |Δ_0| \cdot \phi_{lp}
+        F_1' = F_1 + |Δ_1| \cdot \phi_{lp}
+      postconditions:
+        - "F_0' >= F_0"
+        - "F_1' >= F_1"
+      delta_returns:
+        amount0: "0"
+        amount1: "0"
+
+invariants:
+  - name: "fees_non_negative"
+    expression: "F_0 \\geq 0 \\land F_1 \\geq 0"
+    description: "Accumulated fees cannot be negative"
+
+  - name: "monotonic_accumulation"
+    expression: "F_0' \\geq F_0 \\land F_1' \\geq F_1"
+    description: "Fees only increase (within same epoch)"
+```
+
+---
+
+## 5. C3: Validation Service
+
+### 5.1 Purpose
+
+Backend service that **validates HookSpec documents** against the system state schema.
+
+### 5.2 TODO Tasks
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ C3: VALIDATION SERVICE                                                       │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│ □ C3.1 Document Parser                                                      │
+│   ├── Implement YAML parser with schema validation                          │
+│   ├── Implement Markdown+frontmatter parser                                 │
+│   ├── Implement LaTeX parser (extract structured data)                      │
+│   ├── Auto-detect format from file extension/content                        │
+│   └── Output: Normalized HookSpec object                                    │
+│                                                                              │
+│ □ C3.2 State Variable Validator                                             │
+│   ├── Load system-state.md (from IPFS or local cache)                       │
+│   ├── Build lookup table of valid state variables                           │
+│   ├── Validate all `reads` reference valid system variables                 │
+│   ├── Validate all `writes` reference declared hook_state                   │
+│   └── Output: ValidationResult with errors/warnings                         │
+│                                                                              │
+│ □ C3.3 Equation Validator                                                   │
+│   ├── Parse LaTeX equations                                                 │
+│   ├── Extract symbols used in equations                                     │
+│   ├── Verify all symbols are declared (hook_state or system state)          │
+│   ├── Check equation syntax validity                                        │
+│   └── Output: EquationValidationResult                                      │
+│                                                                              │
+│ □ C3.4 Callback Validator                                                   │
+│   ├── Verify callbacks are valid Uniswap V4 hook callbacks                  │
+│   ├── Verify state access patterns match callback semantics                 │
+│   │   ├── beforeSwap: can read trader state, cannot modify pool             │
+│   │   ├── afterSwap: can read/modify, can return delta                      │
+│   │   └── ... (define for each callback)                                    │
+│   └── Output: CallbackValidationResult                                      │
+│                                                                              │
+│ □ C3.5 Invariant Validator                                                  │
+│   ├── Parse invariant expressions                                           │
+│   ├── Verify symbols are valid                                              │
+│   ├── Check logical consistency (no contradictions)                         │
+│   └── Output: InvariantValidationResult                                     │
+│                                                                              │
+│ □ C3.6 API Endpoints                                                        │
+│   ├── POST /validate - Upload and validate HookSpec                         │
+│   ├── GET /system-state - Retrieve current system-state.md                  │
+│   ├── GET /schema - Retrieve HookSpec JSON schema                           │
+│   └── GET /examples - Retrieve example HookSpecs                            │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 5.3 Validation Rules Specification
+
+```typescript
+// validation-rules.ts
+
+interface ValidationRule {
+  id: string;
+  name: string;
+  severity: 'error' | 'warning';
+  validate: (spec: HookSpec, systemState: SystemState) => ValidationResult;
+}
+
+const VALIDATION_RULES: ValidationRule[] = [
+  {
+    id: 'V1',
+    name: 'ValidPoolStateReferences',
+    severity: 'error',
+    validate: (spec, systemState) => {
+      // All referenced pool vars MUST exist in system-state.md
+      const invalidRefs: string[] = [];
+      for (const func of spec.system_functions) {
+        for (const readVar of func.reads) {
+          if (!systemState.hasVariable(readVar)) {
+            invalidRefs.push(`${func.callback}.reads: '${readVar}'`);
+          }
+        }
+      }
+      return {
+        valid: invalidRefs.length === 0,
+        errors: invalidRefs.map(ref => `Invalid state reference: ${ref}`)
+      };
+    }
+  },
+  {
+    id: 'V2',
+    name: 'UniqueHookStateNames',
+    severity: 'error',
+    validate: (spec, _) => {
+      // Hook state vars MUST have unique names
+      const names = spec.hook_state.map(v => v.name);
+      const duplicates = names.filter((n, i) => names.indexOf(n) !== i);
+      return {
+        valid: duplicates.length === 0,
+        errors: duplicates.map(d => `Duplicate hook state variable: '${d}'`)
+      };
+    }
+  },
+  {
+    id: 'V3',
+    name: 'ValidCallbacks',
+    severity: 'error',
+    validate: (spec, _) => {
+      // System functions MUST map to valid callbacks
+      const validCallbacks = [
+        'beforeInitialize', 'afterInitialize',
+        'beforeAddLiquidity', 'afterAddLiquidity',
+        'beforeRemoveLiquidity', 'afterRemoveLiquidity',
+        'beforeSwap', 'afterSwap',
+        'beforeDonate', 'afterDonate'
+      ];
+      const invalidCallbacks = spec.system_functions
+        .filter(f => !validCallbacks.includes(f.callback))
+        .map(f => f.callback);
+      return {
+        valid: invalidCallbacks.length === 0,
+        errors: invalidCallbacks.map(c => `Invalid callback: '${c}'`)
+      };
+    }
+  },
+  {
+    id: 'V4',
+    name: 'ValidEquationSymbols',
+    severity: 'error',
+    validate: (spec, systemState) => {
+      // Equations MUST use valid symbols from state defs
+      const validSymbols = new Set([
+        ...spec.hook_state.map(v => v.symbol),
+        ...systemState.getAllSymbols()
+      ]);
+      const errors: string[] = [];
+      for (const func of spec.system_functions) {
+        const usedSymbols = extractLatexSymbols(func.transition.equation);
+        for (const sym of usedSymbols) {
+          if (!validSymbols.has(sym)) {
+            errors.push(`Unknown symbol '${sym}' in ${func.callback} equation`);
+          }
+        }
+      }
+      return { valid: errors.length === 0, errors };
+    }
+  },
+  {
+    id: 'V5',
+    name: 'ValidSolidityTypes',
+    severity: 'error',
+    validate: (spec, _) => {
+      // Types MUST be valid Solidity types
+      const validTypes = [
+        'uint8', 'uint16', 'uint24', 'uint32', 'uint64', 'uint128', 'uint256',
+        'int8', 'int16', 'int24', 'int32', 'int64', 'int128', 'int256',
+        'address', 'bool', 'bytes32'
+      ];
+      const invalidTypes = spec.hook_state
+        .filter(v => !validTypes.includes(v.type))
+        .map(v => `${v.name}: ${v.type}`);
+      return {
+        valid: invalidTypes.length === 0,
+        errors: invalidTypes.map(t => `Invalid Solidity type: ${t}`)
+      };
+    }
+  },
+  {
+    id: 'V6',
+    name: 'WritesMatchHookState',
+    severity: 'error',
+    validate: (spec, _) => {
+      // All writes MUST reference declared hook_state variables
+      const hookStateNames = new Set(spec.hook_state.map(v => v.name));
+      const errors: string[] = [];
+      for (const func of spec.system_functions) {
+        for (const writeVar of func.writes) {
+          if (!hookStateNames.has(writeVar)) {
+            errors.push(`${func.callback} writes undeclared variable: '${writeVar}'`);
+          }
+        }
+      }
+      return { valid: errors.length === 0, errors };
+    }
+  }
+];
+```
+
+---
+
+## 6. C4: IPFS Integration
+
+### 6.1 Purpose
+
+Service to **pin validated HookSpecs to IPFS** and generate content-addressed URIs.
+
+### 6.2 TODO Tasks
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ C4: IPFS INTEGRATION                                                         │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│ □ C4.1 IPFS Client Setup                                                    │
+│   ├── Choose IPFS provider (Pinata, Infura, web3.storage, self-hosted)     │
+│   ├── Implement upload/pin functionality                                     │
+│   ├── Implement retrieval functionality                                      │
+│   └── Handle CID v0 vs v1 format                                            │
+│                                                                              │
+│ □ C4.2 Document Packaging                                                   │
+│   ├── Normalize document format before pinning                              │
+│   ├── Add metadata wrapper with timestamp, uploader, version                │
+│   ├── Generate deterministic CID (same content = same CID)                  │
+│   └── Support both raw content and directory structures                      │
+│                                                                              │
+│ □ C4.3 Upload Registry                                                      │
+│   ├── Store mapping: uploader_address => [CID, CID, ...]                   │
+│   ├── Store mapping: CID => { uploader, timestamp, status }                 │
+│   ├── Implement duplicate detection                                          │
+│   └── Support revocation/deprecation marking                                 │
+│                                                                              │
+│ □ C4.4 Gateway & Retrieval                                                  │
+│   ├── Configure IPFS gateway URLs                                           │
+│   ├── Implement fallback to multiple gateways                               │
+│   ├── Cache frequently accessed documents                                    │
+│   └── Verify content hash on retrieval                                       │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 6.3 IPFS Service Interface
+
+```typescript
+// ipfs-service.ts
+
+interface IPFSService {
+  /**
+   * Pin a validated HookSpec document to IPFS
+   * @param document - The validated HookSpec content
+   * @param uploader - Ethereum address of uploader
+   * @returns CID and full IPFS URI
+   */
+  pinDocument(document: HookSpec, uploader: string): Promise<{
+    cid: string;
+    uri: string;  // ipfs://Qm... or ipfs://bafy...
+    timestamp: number;
+  }>;
+
+  /**
+   * Retrieve a HookSpec document by CID
+   */
+  getDocument(cid: string): Promise<HookSpec>;
+
+  /**
+   * Check if a CID exists and is pinned
+   */
+  isPinned(cid: string): Promise<boolean>;
+
+  /**
+   * Get all CIDs uploaded by an address
+   */
+  getUploaderDocuments(uploader: string): Promise<string[]>;
+}
+
+// Document wrapper for IPFS storage
+interface IPFSHookSpecWrapper {
+  schema_version: "1.0.0";
+  content_type: "hookspec";
+  uploader: string;        // Ethereum address
+  uploaded_at: number;     // Unix timestamp
+  signature?: string;      // Optional EIP-712 signature
+  content: HookSpec;       // The actual spec
+}
+```
+
+---
+
+## 7. C5: HookLicense NFT Contract
+
+### 7.1 Purpose
+
+ERC-721 NFT contract that **represents ownership of a HookSpec**, with `tokenURI` pointing to IPFS.
+
+### 7.2 TODO Tasks
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ C5: HOOKLICENSE NFT CONTRACT                                                 │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│ □ C5.1 Contract Design                                                      │
+│   ├── Inherit ERC721 + ERC721URIStorage                                     │
+│   ├── Add minting function (callable by platform only)                      │
+│   ├── Store IPFS URI as tokenURI                                            │
+│   ├── Add on-chain metadata (name, version, author)                         │
+│   └── Consider ERC-2981 royalty standard                                    │
+│                                                                              │
+│ □ C5.2 Access Control                                                       │
+│   ├── Only validated specs can mint                                         │
+│   ├── Platform address has MINTER_ROLE                                      │
+│   ├── Developer (uploader) receives minted NFT                              │
+│   └── Add pause functionality for emergencies                                │
+│                                                                              │
+│ □ C5.3 Metadata Standard                                                    │
+│   ├── Define on-chain vs off-chain metadata split                           │
+│   ├── Implement tokenURI returning IPFS gateway URL                         │
+│   ├── Support ERC-721 Metadata JSON schema                                  │
+│   └── Include hook-specific attributes                                       │
+│                                                                              │
+│ □ C5.4 Events & Indexing                                                    │
+│   ├── HookSpecRegistered(tokenId, cid, developer)                           │
+│   ├── HookSpecDeprecated(tokenId, reason)                                   │
+│   ├── Design subgraph schema for indexing                                   │
+│   └── Support querying by developer, CID, etc.                              │
+│                                                                              │
+│ □ C5.5 Integration Points                                                   │
+│   ├── Link to HookImplementation registry (future)                          │
+│   ├── Link to AVS attestation system (future)                               │
+│   └── Support royalty distribution on hook usage                             │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 7.3 Contract Interface
+
+```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+import {ERC721} from "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+import {ERC721URIStorage} from "@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol";
+import {AccessControl} from "@openzeppelin/contracts/access/AccessControl.sol";
+import {ERC2981} from "@openzeppelin/contracts/token/common/ERC2981.sol";
+
+/// @title HookLicense
+/// @notice ERC-721 NFT representing ownership of a validated HookSpec
+/// @dev tokenURI points to IPFS CID of the HookSpec document
+contract HookLicense is ERC721, ERC721URIStorage, ERC2981, AccessControl {
+
+    bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");
+
+    /// @notice Counter for token IDs
+    uint256 private _nextTokenId;
+
+    /// @notice Mapping from IPFS CID to token ID
+    mapping(string => uint256) public cidToTokenId;
+
+    /// @notice Mapping from token ID to on-chain metadata
+    mapping(uint256 => HookMetadata) public hookMetadata;
+
+    /// @notice On-chain metadata for a HookSpec
+    struct HookMetadata {
+        string name;
+        string version;
+        address developer;
+        uint256 registeredAt;
+        bool deprecated;
+    }
+
+    /// @notice Emitted when a new HookSpec is registered
+    event HookSpecRegistered(
+        uint256 indexed tokenId,
+        string indexed cid,
+        address indexed developer,
+        string name,
+        string version
+    );
+
+    /// @notice Emitted when a HookSpec is deprecated
+    event HookSpecDeprecated(
+        uint256 indexed tokenId,
+        string reason
+    );
+
+    constructor() ERC721("HookLicense", "HOOK") {
+        _grantRole(DEFAULT_ADMIN_ROLE, msg.sender);
+        _grantRole(MINTER_ROLE, msg.sender);
+    }
+
+    /// @notice Mint a new HookLicense NFT for a validated spec
+    /// @param developer Address of the hook developer (receives NFT)
+    /// @param ipfsCid IPFS CID of the validated HookSpec document
+    /// @param name Human-readable name of the hook
+    /// @param version Semantic version of the spec
+    /// @param royaltyBps Royalty percentage in basis points (e.g., 500 = 5%)
+    /// @return tokenId The minted token ID
+    function mint(
+        address developer,
+        string calldata ipfsCid,
+        string calldata name,
+        string calldata version,
+        uint96 royaltyBps
+    ) external onlyRole(MINTER_ROLE) returns (uint256 tokenId) {
+        require(cidToTokenId[ipfsCid] == 0, "CID already registered");
+        require(bytes(ipfsCid).length > 0, "Empty CID");
+        require(developer != address(0), "Zero address developer");
+
+        tokenId = ++_nextTokenId;
+
+        _safeMint(developer, tokenId);
+        _setTokenURI(tokenId, string(abi.encodePacked("ipfs://", ipfsCid)));
+
+        cidToTokenId[ipfsCid] = tokenId;
+        hookMetadata[tokenId] = HookMetadata({
+            name: name,
+            version: version,
+            developer: developer,
+            registeredAt: block.timestamp,
+            deprecated: false
+        });
+
+        // Set royalty for this token
+        if (royaltyBps > 0) {
+            _setTokenRoyalty(tokenId, developer, royaltyBps);
+        }
+
+        emit HookSpecRegistered(tokenId, ipfsCid, developer, name, version);
+    }
+
+    /// @notice Mark a HookSpec as deprecated
+    /// @param tokenId Token ID to deprecate
+    /// @param reason Reason for deprecation
+    function deprecate(uint256 tokenId, string calldata reason) external {
+        require(
+            ownerOf(tokenId) == msg.sender || hasRole(DEFAULT_ADMIN_ROLE, msg.sender),
+            "Not authorized"
+        );
+        hookMetadata[tokenId].deprecated = true;
+        emit HookSpecDeprecated(tokenId, reason);
+    }
+
+    /// @notice Get token ID by IPFS CID
+    function getTokenByCid(string calldata cid) external view returns (uint256) {
+        uint256 tokenId = cidToTokenId[cid];
+        require(tokenId != 0, "CID not registered");
+        return tokenId;
+    }
+
+    /// @notice Check if a CID is registered
+    function isRegistered(string calldata cid) external view returns (bool) {
+        return cidToTokenId[cid] != 0;
+    }
+
+    // Required overrides
+    function tokenURI(uint256 tokenId)
+        public
+        view
+        override(ERC721, ERC721URIStorage)
+        returns (string memory)
+    {
+        return super.tokenURI(tokenId);
+    }
+
+    function supportsInterface(bytes4 interfaceId)
+        public
+        view
+        override(ERC721, ERC721URIStorage, ERC2981, AccessControl)
+        returns (bool)
+    {
+        return super.supportsInterface(interfaceId);
+    }
+}
+```
+
+---
+
+## 8. C6: Platform Frontend
+
+### 8.1 Purpose
+
+Web application for developers to **view system state, upload specs, and manage licenses**.
+
+### 8.2 TODO Tasks
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ C6: PLATFORM FRONTEND                                                        │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│ □ C6.1 System State Viewer (READ ONLY)                                      │
+│   ├── Display system-state.md in formatted view                             │
+│   ├── Searchable table of state variables                                   │
+│   ├── Copy-to-clipboard for symbols and types                               │
+│   ├── Show IPFS CID and version info                                        │
+│   └── Link to IStateView source code                                         │
+│                                                                              │
+│ □ C6.2 HookSpec Upload Flow                                                 │
+│   ├── File upload (YAML, MD, LaTeX, JSON)                                   │
+│   ├── Live validation feedback                                              │
+│   ├── Error highlighting with fix suggestions                               │
+│   ├── Preview rendered spec before submission                               │
+│   └── Wallet connection for authentication                                   │
+│                                                                              │
+│ □ C6.3 Validation Results UI                                                │
+│   ├── Show pass/fail for each validation rule                               │
+│   ├── Display detailed error messages                                        │
+│   ├── Link errors to relevant spec sections                                 │
+│   └── Suggest corrections where possible                                     │
+│                                                                              │
+│ □ C6.4 IPFS & NFT Minting Flow                                              │
+│   ├── Show IPFS upload progress                                             │
+│   ├── Display generated CID                                                  │
+│   ├── Trigger NFT mint transaction                                          │
+│   ├── Show transaction confirmation                                          │
+│   └── Display minted NFT with OpenSea link                                   │
+│                                                                              │
+│ □ C6.5 Developer Dashboard                                                  │
+│   ├── List all HookLicense NFTs owned                                       │
+│   ├── View spec details and IPFS link                                       │
+│   ├── Deprecation controls                                                   │
+│   └── Analytics (views, attestations, deployments)                          │
+│                                                                              │
+│ □ C6.6 HookSpec Editor (Optional)                                           │
+│   ├── In-browser YAML/Markdown editor                                       │
+│   ├── Syntax highlighting for LaTeX equations                               │
+│   ├── Auto-complete for state variable names                                │
+│   └── Real-time validation as you type                                       │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 9. Implementation Priority & Dependencies
+
+### 9.1 Dependency Graph
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                        IMPLEMENTATION DEPENDENCY GRAPH                       │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│                    ┌─────────────────────┐                                   │
+│                    │ C1: System State    │                                   │
+│                    │ (system-state.md)   │                                   │
+│                    └──────────┬──────────┘                                   │
+│                               │                                              │
+│                               ▼                                              │
+│                    ┌─────────────────────┐                                   │
+│                    │ C2: HookSpec Schema │                                   │
+│                    │ (hookspec.schema)   │                                   │
+│                    └──────────┬──────────┘                                   │
+│                               │                                              │
+│              ┌────────────────┼────────────────┐                             │
+│              │                │                │                             │
+│              ▼                ▼                ▼                             │
+│    ┌─────────────────┐ ┌─────────────┐ ┌─────────────────┐                  │
+│    │ C3: Validation  │ │ C4: IPFS    │ │ C5: HookLicense │                  │
+│    │ Service         │ │ Integration │ │ NFT Contract    │                  │
+│    └────────┬────────┘ └──────┬──────┘ └────────┬────────┘                  │
+│             │                 │                  │                           │
+│             └─────────────────┼──────────────────┘                           │
+│                               │                                              │
+│                               ▼                                              │
+│                    ┌─────────────────────┐                                   │
+│                    │ C6: Platform        │                                   │
+│                    │ Frontend            │                                   │
+│                    └─────────────────────┘                                   │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 9.2 Implementation Phases
+
+| Phase | Components | Deliverables | Duration |
+|-------|------------|--------------|----------|
+| **Phase 1** | C1, C2 | system-state.md, hookspec.schema.json | - |
+| **Phase 2** | C3, C4 | Validation API, IPFS service | - |
+| **Phase 3** | C5 | HookLicense.sol deployed | - |
+| **Phase 4** | C6 | MVP frontend | - |
+
+### 9.3 Master TODO Checklist
+
+```
+PHASE 1: FOUNDATION
+├── □ C1.1 Parse IStateView interface
+├── □ C1.2 Generate system-state.md
+├── □ C1.3 Pin to IPFS and version
+├── □ C2.1 Define HookSpec JSON schema
+├── □ C2.2 Define validation rules
+├── □ C2.3 Support multiple formats
+└── □ C2.4 Create example HookSpecs
+
+PHASE 2: SERVICES
+├── □ C3.1 Document parser
+├── □ C3.2 State variable validator
+├── □ C3.3 Equation validator
+├── □ C3.4 Callback validator
+├── □ C3.5 Invariant validator
+├── □ C3.6 API endpoints
+├── □ C4.1 IPFS client setup
+├── □ C4.2 Document packaging
+├── □ C4.3 Upload registry
+└── □ C4.4 Gateway & retrieval
+
+PHASE 3: CONTRACT
+├── □ C5.1 Contract design
+├── □ C5.2 Access control
+├── □ C5.3 Metadata standard
+├── □ C5.4 Events & indexing
+└── □ C5.5 Integration points
+
+PHASE 4: FRONTEND
+├── □ C6.1 System state viewer
+├── □ C6.2 HookSpec upload flow
+├── □ C6.3 Validation results UI
+├── □ C6.4 IPFS & NFT minting flow
+├── □ C6.5 Developer dashboard
+└── □ C6.6 HookSpec editor (optional)
+```
+
+---
+
+## 10. References
+
+- [State-Space Model](../mathematical-models/state-space-model.md)
+- [System Overview](./system-overview.md)
+- [Mission Statement](./mission-statement.md)
+- [IStateView Interface](https://github.com/Uniswap/v4-periphery/blob/main/src/interfaces/IStateView.sol)
+- [ERC-721 Standard](https://eips.ethereum.org/EIPS/eip-721)
+- [ERC-2981 Royalty Standard](https://eips.ethereum.org/EIPS/eip-2981)
+- [IPFS Documentation](https://docs.ipfs.tech/)
diff --git a/docs/hook-pkg/architecture/mission-statement.md b/docs/hook-pkg/architecture/mission-statement.md
new file mode 100644
index 000000000..ce74ee28b
--- /dev/null
+++ b/docs/hook-pkg/architecture/mission-statement.md
@@ -0,0 +1,289 @@
+# Hook Bazaar: Mission Statement
+
+> **Document Type:** Strategic Foundation
+> **Last Updated:** 2025-12-09
+> **Related:** [Goal Tree](./goal-tree.md) | [Function Refinement Tree](./function-refinement-tree.md)
+
+---
+
+## 1. Mission
+
+**To create a trustless marketplace where Uniswap V4 hook developers can monetize mathematically-specified implementations while protecting their intellectual property, and where integrators can deploy verified hooks with cryptoeconomic guarantees.**
+
+---
+
+## 2. Vision
+
+A future where:
+
+- **Hook development** becomes a sustainable business model for DeFi innovators
+- **Hook quality** is mathematically provable, not just auditable
+- **Hook discovery** is as simple as browsing an app store
+- **Hook trust** is backed by economic stake, not reputation alone
+
+---
+
+## 3. Core Problem Statement
+
+### 3.1 The Hook Developer's Dilemma
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                    CURRENT STATE (PROBLEM)                          │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                      │
+│  Hook Developer creates innovative algorithm                         │
+│           │                                                          │
+│           ▼                                                          │
+│  ┌─────────────────┐                                                │
+│  │ Deploy on-chain │                                                │
+│  └────────┬────────┘                                                │
+│           │                                                          │
+│           ▼                                                          │
+│  ┌─────────────────────────────────────────────────────────┐        │
+│  │  PROBLEM: Code is publicly visible                       │        │
+│  │                                                          │        │
+│  │  - Anyone can decompile bytecode                         │        │
+│  │  - Competitors can copy the algorithm                    │        │
+│  │  - No way to monetize without giving away IP             │        │
+│  │  - Audits are expensive and don't guarantee correctness  │        │
+│  └─────────────────────────────────────────────────────────┘        │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### 3.2 The Integrator's Dilemma
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                    CURRENT STATE (PROBLEM)                          │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                      │
+│  Integrator wants to use a third-party hook                          │
+│           │                                                          │
+│           ▼                                                          │
+│  ┌─────────────────────────────────────────────────────────┐        │
+│  │  PROBLEM: How to trust the hook?                         │        │
+│  │                                                          │        │
+│  │  - Audits are point-in-time, expensive                   │        │
+│  │  - No formal specification of expected behavior          │        │
+│  │  - "Trust me bro" is the default model                   │        │
+│  │  - No recourse if hook misbehaves                        │        │
+│  └─────────────────────────────────────────────────────────┘        │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 4. Solution Overview
+
+### 4.1 The Hook Bazaar Model
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                    DESIRED STATE (SOLUTION)                         │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                      │
+│  ┌─────────────────────────────────────────────────────────┐        │
+│  │  MATHEMATICAL SPECIFICATION                              │        │
+│  │  - Hook behavior defined as system of equations          │        │
+│  │  - State transitions formally specified                  │        │
+│  │  - Invariants explicitly declared                        │        │
+│  │  - Stored on IPFS, linked to NFT                         │        │
+│  └─────────────────────────────────────────────────────────┘        │
+│           │                                                          │
+│           ▼                                                          │
+│  ┌─────────────────────────────────────────────────────────┐        │
+│  │  ENCRYPTED IMPLEMENTATION                                │        │
+│  │  - Code encrypted via Fhenix CoFHE                       │        │
+│  │  - Cannot be decompiled or reverse-engineered            │        │
+│  │  - IP remains protected on-chain                         │        │
+│  └─────────────────────────────────────────────────────────┘        │
+│           │                                                          │
+│           ▼                                                          │
+│  ┌─────────────────────────────────────────────────────────┐        │
+│  │  CRYPTOECONOMIC VERIFICATION                             │        │
+│  │  - EigenLayer AVS verifies behavior matches spec         │        │
+│  │  - Operators stake collateral on correctness             │        │
+│  │  - Slashing for false attestations                       │        │
+│  │  - No code disclosure required                           │        │
+│  └─────────────────────────────────────────────────────────┘        │
+│           │                                                          │
+│           ▼                                                          │
+│  ┌─────────────────────────────────────────────────────────┐        │
+│  │  MARKETPLACE ECONOMICS                                   │        │
+│  │  - Developers monetize via licensing/sales               │        │
+│  │  - Integrators pay for verified, trusted hooks           │        │
+│  │  - NFT represents ownership and royalty rights           │        │
+│  └─────────────────────────────────────────────────────────┘        │
+│                                                                      │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 5. Value Propositions
+
+### 5.1 For Hook Developers
+
+| Value | Description |
+|-------|-------------|
+| **IP Protection** | Code remains encrypted; competitors cannot copy |
+| **Monetization** | Sell or license hooks without revealing implementation |
+| **Credibility** | Mathematical specification proves design quality |
+| **Distribution** | Marketplace provides discoverability and reach |
+
+### 5.2 For Integrators
+
+| Value | Description |
+|-------|-------------|
+| **Trust** | Cryptoeconomic guarantees, not just audits |
+| **Transparency** | Read specification to understand exact behavior |
+| **Recourse** | Slashing provides economic accountability |
+| **Simplicity** | Browse, verify, deploy - no custom audits needed |
+
+### 5.3 For the Ecosystem
+
+| Value | Description |
+|-------|-------------|
+| **Innovation** | Developers can profit from novel algorithms |
+| **Standards** | Mathematical specifications become the norm |
+| **Composability** | Verified hooks can be safely composed |
+| **Security** | Formal methods reduce exploit surface |
+
+---
+
+## 6. Success Metrics
+
+### 6.1 Quantitative Metrics
+
+| Metric | Target (Year 1) | Target (Year 3) |
+|--------|-----------------|-----------------|
+| Hooks Listed | 50 | 500 |
+| Hooks Attested | 40 | 400 |
+| Active Integrators | 20 | 200 |
+| TVL in Pools with Bazaar Hooks | $10M | $1B |
+| AVS Operators | 20 | 100 |
+| Total Stake (AVS) | $5M | $50M |
+
+### 6.2 Qualitative Metrics
+
+- **Developer Satisfaction**: NPS > 50
+- **Specification Quality**: Community review scores
+- **Attestation Accuracy**: Challenge success rate < 1%
+- **Market Liquidity**: Time-to-first-sale < 7 days
+
+---
+
+## 7. Constraints and Boundaries
+
+### 7.1 In Scope
+
+- Uniswap V4 hooks on Ethereum mainnet and L2s
+- EigenLayer-based verification
+- Fhenix-based code encryption
+- NFT-based ownership model
+- Mathematical specification framework
+
+### 7.2 Out of Scope (Initial Release)
+
+- Hooks for protocols other than Uniswap V4
+- Formal verification (TLA+, Coq proofs)
+- Cross-chain hook deployment
+- DAO governance of marketplace
+- Insurance/coverage products
+
+### 7.3 Assumptions
+
+1. Fhenix CoFHE provides sufficient code protection
+2. EigenLayer operator set is sufficiently decentralized
+3. Integrators will read and understand specifications
+4. Mathematical specifications can capture hook behavior adequately
+5. Gas costs for encrypted execution are acceptable
+
+### 7.4 Dependencies
+
+| Dependency | Risk Level | Mitigation |
+|------------|------------|------------|
+| Uniswap V4 Launch | Medium | Track V4 development closely |
+| Fhenix CoFHE Mainnet | High | Early integration, fallback plans |
+| EigenLayer Stability | Medium | Conservative operator requirements |
+| IPFS Availability | Low | Multiple pinning services |
+
+---
+
+## 8. Stakeholders
+
+### 8.1 Primary Stakeholders
+
+| Stakeholder | Role | Interest |
+|-------------|------|----------|
+| Hook Developers | Creators | Monetization, IP protection |
+| Pool Operators | Buyers | Verified hooks, easy deployment |
+| AVS Operators | Validators | Rewards, stake returns |
+| Liquidity Providers | End Users | Better pool performance |
+
+### 8.2 Secondary Stakeholders
+
+| Stakeholder | Role | Interest |
+|-------------|------|----------|
+| Uniswap Governance | Platform | Ecosystem growth |
+| EigenLayer | Infrastructure | AVS adoption |
+| Fhenix | Technology | Use case validation |
+| Auditors | Service Providers | Specification review services |
+
+---
+
+## 9. Guiding Principles
+
+### 9.1 Design Principles
+
+1. **Specification First**: No implementation without formal spec
+2. **Verify, Don't Trust**: Cryptoeconomic guarantees over reputation
+3. **Protect Creators**: IP protection is non-negotiable
+4. **Empower Users**: Clear specs enable informed decisions
+5. **Minimize Trust**: Reduce trusted parties to minimum
+
+### 9.2 Technical Principles
+
+1. **Mathematical Rigor**: Use formal notation, cite academic sources
+2. **Behavioral Verification**: Verify what code does, not what it is
+3. **Economic Security**: Security budget proportional to TVL at risk
+4. **Composability**: Hooks should work together safely
+5. **Gas Efficiency**: Encrypted execution must remain practical
+
+---
+
+## 10. Strategic Alignment
+
+### 10.1 Alignment with Uniswap V4
+
+- Hooks are the core extensibility primitive of V4
+- Hook Bazaar amplifies the value of the hooks architecture
+- Creates sustainable ecosystem for hook innovation
+
+### 10.2 Alignment with EigenLayer
+
+- Novel AVS use case: specification verification
+- Demonstrates programmable trust beyond simple tasks
+- Expands AVS adoption to DeFi primitives
+
+### 10.3 Alignment with Fhenix
+
+- Real-world use case for on-chain encryption
+- High-value IP protection requirement
+- Demonstrates CoFHE in production
+
+---
+
+## 11. Call to Action
+
+**For Hook Developers:**
+> Define your hook's behavior mathematically. Protect your code with encryption. Let the market reward your innovation.
+
+**For Integrators:**
+> Stop trusting code you can't verify. Read specifications, check attestations, deploy with confidence.
+
+**For the Community:**
+> Help us build the standard for trusted, verified DeFi primitives. Review specs, run operators, grow the ecosystem.
diff --git a/docs/hook-pkg/architecture/system-overview.md b/docs/hook-pkg/architecture/system-overview.md
new file mode 100644
index 000000000..037f16f79
--- /dev/null
+++ b/docs/hook-pkg/architecture/system-overview.md
@@ -0,0 +1,619 @@
+# Hook Bazaar: Complete System Architecture
+
+> **Status:** Architecture Specification
+> **Last Updated:** 2025-12-09
+> **Related Documents:**
+> - [State-Space Model](../mathematical-models/state-space-model.md)
+> - [AVS Verification System](./avs-verification-system.md)
+
+---
+
+## 1. Vision
+
+Hook Bazaar is a **marketplace for verified Uniswap V4 hooks** that enables:
+
+1. **Hook Developers** to monetize their implementations while protecting intellectual property
+2. **Pool Operators** to discover and deploy verified hooks with cryptoeconomic guarantees
+3. **The Ecosystem** to grow through composable, trusted hook infrastructure
+
+---
+
+## 2. System Components
+
+```
+┌─────────────────────────────────────────────────────────────────────────────────┐
+│                            HOOK BAZAAR ARCHITECTURE                              │
+├─────────────────────────────────────────────────────────────────────────────────┤
+│                                                                                  │
+│  ┌─────────────────────────────────────────────────────────────────────────┐    │
+│  │                          LAYER 1: SPECIFICATIONS                         │    │
+│  │                                                                          │    │
+│  │   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐              │    │
+│  │   │    Hook      │    │   State      │    │  Invariant   │              │    │
+│  │   │    Spec      │    │  Transition  │    │  Definitions │              │    │
+│  │   │  (Markdown)  │    │  Equations   │    │   (LaTeX)    │              │    │
+│  │   └──────┬───────┘    └──────┬───────┘    └──────┬───────┘              │    │
+│  │          │                   │                   │                       │    │
+│  │          └───────────────────┼───────────────────┘                       │    │
+│  │                              ▼                                           │    │
+│  │                    ┌──────────────────┐                                  │    │
+│  │                    │   IPFS Storage   │                                  │    │
+│  │                    │  (Spec Document) │                                  │    │
+│  │                    └────────┬─────────┘                                  │    │
+│  └─────────────────────────────┼────────────────────────────────────────────┘    │
+│                                │                                                  │
+│  ┌─────────────────────────────┼────────────────────────────────────────────┐    │
+│  │                          LAYER 2: IMPLEMENTATION                         │    │
+│  │                                │                                         │    │
+│  │   ┌───────────────────────────┼───────────────────────────────────┐     │    │
+│  │   │                           ▼                                    │     │    │
+│  │   │  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐    │     │    │
+│  │   │  │   Solidity   │───▶│   Fhenix    │───▶│  Encrypted   │    │     │    │
+│  │   │  │    Code      │    │   CoFHE     │    │   Bytecode   │    │     │    │
+│  │   │  └──────────────┘    └──────────────┘    └──────┬───────┘    │     │    │
+│  │   │         Hook Developer's Local Environment      │            │     │    │
+│  │   └─────────────────────────────────────────────────┼────────────┘     │    │
+│  │                                                     │                   │    │
+│  │                                                     ▼                   │    │
+│  │                              ┌──────────────────────────────┐          │    │
+│  │                              │   Deployed Hook Contract     │          │    │
+│  │                              │   (Code hidden, behavior     │          │    │
+│  │                              │    publicly observable)      │          │    │
+│  │                              └──────────────┬───────────────┘          │    │
+│  └─────────────────────────────────────────────┼────────────────────────────┘    │
+│                                                │                                  │
+│  ┌─────────────────────────────────────────────┼────────────────────────────┐    │
+│  │                          LAYER 3: VERIFICATION                           │    │
+│  │                                             │                            │    │
+│  │   ┌─────────────────────────────────────────┼─────────────────────────┐ │    │
+│  │   │                    EigenLayer AVS       │                         │ │    │
+│  │   │                                         ▼                         │ │    │
+│  │   │   ┌──────────────┐    ┌──────────────────────────┐               │ │    │
+│  │   │   │   Service    │    │     Task Manager          │               │ │    │
+│  │   │   │   Manager    │◄──▶│  - createAttestationTask  │               │ │    │
+│  │   │   └──────────────┘    │  - respondToTask          │               │ │    │
+│  │   │                       │  - challengeAttestation   │               │ │    │
+│  │   │                       └────────────┬─────────────┘               │ │    │
+│  │   │                                    │                              │ │    │
+│  │   │   ┌────────────────────────────────┼────────────────────────┐    │ │    │
+│  │   │   │              Operator Network  │                        │    │ │    │
+│  │   │   │                                ▼                        │    │ │    │
+│  │   │   │  ┌──────────┐  ┌──────────┐  ┌──────────┐             │    │ │    │
+│  │   │   │  │OP 1      │  │OP 2      │  │OP N      │   ...       │    │ │    │
+│  │   │   │  │Sample    │  │Sample    │  │Sample    │             │    │ │    │
+│  │   │   │  │Verify    │  │Verify    │  │Verify    │             │    │ │    │
+│  │   │   │  │Sign      │  │Sign      │  │Sign      │             │    │ │    │
+│  │   │   │  └──────────┘  └──────────┘  └──────────┘             │    │ │    │
+│  │   │   └─────────────────────────────────────────────────────────┘    │ │    │
+│  │   └───────────────────────────────────────────────────────────────────┘ │    │
+│  │                                             │                            │    │
+│  │                                             ▼                            │    │
+│  │                              ┌──────────────────────────┐               │    │
+│  │                              │   Attestation Registry   │               │    │
+│  │                              │   (On-chain record)      │               │    │
+│  │                              └──────────────┬───────────┘               │    │
+│  └─────────────────────────────────────────────┼────────────────────────────┘    │
+│                                                │                                  │
+│  ┌─────────────────────────────────────────────┼────────────────────────────┐    │
+│  │                          LAYER 4: MARKETPLACE                            │    │
+│  │                                             │                            │    │
+│  │                                             ▼                            │    │
+│  │   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐              │    │
+│  │   │  Hook NFT    │◄──▶│  Hook Market │◄──▶│   Protocol   │              │    │
+│  │   │  Registry    │    │  (Listings)  │    │   Mediator   │              │    │
+│  │   └──────────────┘    └──────────────┘    └──────────────┘              │    │
+│  │          │                   │                   │                       │    │
+│  │          │                   │                   │                       │    │
+│  │          ▼                   ▼                   ▼                       │    │
+│  │   ┌──────────────────────────────────────────────────────────┐          │    │
+│  │   │                   MasterHook (Diamond)                    │          │    │
+│  │   │   - Routes callbacks to verified hooks                    │          │    │
+│  │   │   - Enforces attestation requirements                     │          │    │
+│  │   │   - Manages hook composition                              │          │    │
+│  │   └──────────────────────────────────────────────────────────┘          │    │
+│  └──────────────────────────────────────────────────────────────────────────┘    │
+│                                                                                  │
+│  ┌──────────────────────────────────────────────────────────────────────────┐    │
+│  │                          LAYER 5: UNISWAP V4                             │    │
+│  │                                                                          │    │
+│  │   ┌──────────────────────────────────────────────────────────┐          │    │
+│  │   │                      PoolManager                          │          │    │
+│  │   │   - Executes swaps, mints, burns                          │          │    │
+│  │   │   - Invokes hook callbacks                                │          │    │
+│  │   │   - Manages pool state                                    │          │    │
+│  │   └──────────────────────────────────────────────────────────┘          │    │
+│  └──────────────────────────────────────────────────────────────────────────┘    │
+│                                                                                  │
+└─────────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 3. Component Specifications
+
+### 3.1 Specification Layer
+
+**Purpose:** Define hook behavior mathematically before implementation
+
+**Components:**
+
+| Component | Format | Storage | Purpose |
+|-----------|--------|---------|---------|
+| Hook Specification | Markdown + LaTeX | IPFS | Human-readable behavior description |
+| State Variables | JSON Schema | IPFS | Formal state definitions ($H$) |
+| Transition Functions | LaTeX equations | IPFS | $f_i(H, P) \rightarrow (H', \Delta)$ |
+| Invariants | First-order logic | IPFS | Properties that must always hold |
+| Test Vectors | JSON | IPFS | Input→Output pairs for validation |
+
+**Interface:**
+
+```solidity
+interface IHookSpecification {
+    /// @return specURI IPFS CID of complete specification
+    function specificationURI() external pure returns (string memory specURI);
+
+    /// @return vars Bitmask of state variables accessed
+    function declareStateReads() external pure returns (
+        uint256 lpStateVars,
+        uint256 traderStateVars,
+        uint256 sharedStateVars
+    );
+
+    /// @return invariantIds Identifiers for declared invariants
+    function declareInvariants() external pure returns (bytes32[] memory invariantIds);
+}
+```
+
+### 3.2 Implementation Layer
+
+**Purpose:** Transform specifications into executable code with IP protection
+
+**Components:**
+
+| Component | Technology | Purpose |
+|-----------|------------|---------|
+| Hook Contract | Solidity | Implements specification as executable code |
+| Fhenix CoFHE | FHE Encryption | Encrypts bytecode to prevent decompilation |
+| IHookStateView | Interface | Exposes hook state for verification |
+
+**Code Protection Flow:**
+
+```
+┌───────────────┐     ┌───────────────┐     ┌───────────────┐
+│   Solidity    │────▶│    Compile    │────▶│   Bytecode    │
+│    Source     │     │    (solc)     │     │   (clear)     │
+└───────────────┘     └───────────────┘     └───────┬───────┘
+                                                    │
+                                                    ▼
+                                            ┌───────────────┐
+                                            │  Fhenix CoFHE │
+                                            │   Encrypt     │
+                                            └───────┬───────┘
+                                                    │
+                                                    ▼
+                                            ┌───────────────┐
+                                            │   Encrypted   │
+                                            │   Bytecode    │
+                                            └───────┬───────┘
+                                                    │
+                                                    ▼
+                                            ┌───────────────┐
+                                            │    Deploy     │
+                                            │   (on-chain)  │
+                                            └───────────────┘
+```
+
+### 3.3 Verification Layer
+
+**Purpose:** Prove implementation matches specification without code disclosure
+
+**Reference:** [AVS Verification System](./avs-verification-system.md)
+
+**Key Contracts:**
+
+| Contract | Function |
+|----------|----------|
+| `HookAttestationServiceManager` | EigenLayer AVS registration and operator management |
+| `HookAttestationTaskManager` | Task creation, response, and challenge handling |
+| `AttestationRegistry` | On-chain record of valid attestations |
+| `HookStateSampler` | State sampling utilities for operators |
+
+**Verification Guarantee:**
+
+$$
+\text{Attestation} \implies P(\text{spec compliance}) \geq 1 - \epsilon
+$$
+
+Where $\epsilon$ depends on:
+- Sample count
+- Operator count
+- Stake amount
+- Challenge period duration
+
+### 3.4 Marketplace Layer
+
+**Purpose:** Enable discovery, trading, and deployment of verified hooks
+
+**Components:**
+
+| Contract | Purpose |
+|----------|---------|
+| `HookNFTRegistry` | ERC-721 tokens representing hook ownership |
+| `HookMarket` | Listings, pricing, and purchase mechanics |
+| `ProtocolHookMediator` | Interfaces between protocols and hooks |
+| `MasterHook` | Diamond-pattern hub routing callbacks |
+
+**NFT Metadata Schema:**
+
+```json
+{
+  "name": "DynamicFeeHook v1.0.0",
+  "description": "Volatility-responsive fee adjustment hook",
+  "image": "ipfs://Qm.../preview.png",
+  "external_url": "https://hookbazaar.xyz/hooks/0x...",
+  "attributes": [
+    { "trait_type": "Callbacks", "value": ["beforeSwap", "afterSwap"] },
+    { "trait_type": "Attestation Status", "value": "Verified" },
+    { "trait_type": "Attestation Expiry", "value": 1735689600 },
+    { "trait_type": "Specification URI", "value": "ipfs://Qm.../spec.md" },
+    { "trait_type": "Developer", "value": "0x..." }
+  ]
+}
+```
+
+### 3.5 Integration Layer (Uniswap V4)
+
+**Purpose:** Connect verified hooks to Uniswap V4 PoolManager
+
+**Key Integration Points:**
+
+| Component | Integration |
+|-----------|-------------|
+| `PoolManager` | Hook address registered at pool creation |
+| `IHooks` | Standard callback interface implementation |
+| `StateView` | Exposes pool state for verification sampling |
+
+---
+
+## 4. Data Flow Diagrams
+
+### 4.1 Hook Registration Flow
+
+```
+┌─────────────┐
+│  Developer  │
+└──────┬──────┘
+       │
+       │ 1. Create Specification
+       ▼
+┌─────────────┐
+│    IPFS     │◄─────────────────────────────────────────┐
+└──────┬──────┘                                          │
+       │                                                 │
+       │ 2. specificationURI                             │
+       ▼                                                 │
+┌─────────────┐                                          │
+│  Implement  │                                          │
+│    Hook     │                                          │
+└──────┬──────┘                                          │
+       │                                                 │
+       │ 3. Encrypt via Fhenix                           │
+       ▼                                                 │
+┌─────────────┐                                          │
+│   Deploy    │                                          │
+│  Contract   │                                          │
+└──────┬──────┘                                          │
+       │                                                 │
+       │ 4. hookAddress                                  │
+       ▼                                                 │
+┌─────────────────────┐                                  │
+│ createAttestationTask│                                  │
+│ (hookAddress, specURI)│                                  │
+└──────┬──────────────┘                                  │
+       │                                                 │
+       │ 5. Task emitted                                 │
+       ▼                                                 │
+┌─────────────────────┐     6. Fetch spec                │
+│  AVS Operators      │─────────────────────────────────▶│
+│  - Sample state     │
+│  - Execute callbacks│
+│  - Verify behavior  │
+│  - Sign response    │
+└──────┬──────────────┘
+       │
+       │ 7. Aggregated response
+       ▼
+┌─────────────────────┐
+│  respondToTask      │
+│  (BLS signatures)   │
+└──────┬──────────────┘
+       │
+       │ 8. If compliant
+       ▼
+┌─────────────────────┐
+│ AttestationRegistry │
+│ .recordAttestation()│
+└──────┬──────────────┘
+       │
+       │ 9. Attestation recorded
+       ▼
+┌─────────────────────┐
+│    HookMarket       │
+│  .listHook()        │
+└─────────────────────┘
+```
+
+### 4.2 Hook Deployment Flow
+
+```
+┌─────────────┐
+│ Integrator  │
+└──────┬──────┘
+       │
+       │ 1. Browse HookMarket
+       ▼
+┌─────────────┐
+│ HookMarket  │
+│ .getListings()│
+└──────┬──────┘
+       │
+       │ 2. Select hook
+       ▼
+┌─────────────────────┐
+│ AttestationRegistry │
+│ .getAttestation()   │
+└──────┬──────────────┘
+       │
+       │ 3. Verify attestation
+       │    - isValid == true
+       │    - expiresAt > now
+       ▼
+┌─────────────┐     4. Fetch spec
+│    IPFS     │◄─────────────────────────────────────────────
+└──────┬──────┘
+       │
+       │ 5. Review specification
+       │    - State variables
+       │    - Transition functions
+       │    - Invariants
+       ▼
+┌─────────────────────┐
+│ HookMarket          │
+│ .purchaseHook()     │
+│ (if paid model)     │
+└──────┬──────────────┘
+       │
+       │ 6. Deploy to pool
+       ▼
+┌─────────────────────┐
+│ ProtocolHookMediator│
+│ .registerHook()     │
+└──────┬──────────────┘
+       │
+       │ 7. Route via MasterHook
+       ▼
+┌─────────────────────┐
+│ MasterHook          │
+│ (Diamond facet)     │
+└──────┬──────────────┘
+       │
+       │ 8. Connect to PoolManager
+       ▼
+┌─────────────────────┐
+│ PoolManager         │
+│ .initialize(hook)   │
+└─────────────────────┘
+```
+
+### 4.3 Runtime Callback Flow
+
+```
+┌─────────────┐
+│   Trader    │
+└──────┬──────┘
+       │
+       │ 1. swap(poolId, params)
+       ▼
+┌─────────────────────┐
+│    PoolManager      │
+└──────┬──────────────┘
+       │
+       │ 2. hook.beforeSwap(...)
+       ▼
+┌─────────────────────┐
+│    MasterHook       │
+│    (Diamond Hub)    │
+└──────┬──────────────┘
+       │
+       │ 3. Route to registered hook
+       ▼
+┌─────────────────────┐
+│ DynamicFeeHook      │  ◄── Encrypted bytecode
+│ (Fhenix protected)  │      (cannot decompile)
+│                     │
+│ Executes:           │
+│ - Read H (hook state)│
+│ - Read P (pool state)│
+│ - Compute f(H,P)    │
+│ - Return Δ          │
+└──────┬──────────────┘
+       │
+       │ 4. Return (deltaFee, hookData)
+       ▼
+┌─────────────────────┐
+│    MasterHook       │
+└──────┬──────────────┘
+       │
+       │ 5. Return to PoolManager
+       ▼
+┌─────────────────────┐
+│    PoolManager      │
+│    - Apply fee Δ    │
+│    - Execute swap   │
+└──────┬──────────────┘
+       │
+       │ 6. hook.afterSwap(...)
+       │    (similar flow)
+       ▼
+┌─────────────────────┐
+│   Swap Complete     │
+└─────────────────────┘
+```
+
+---
+
+## 5. Security Model
+
+### 5.1 Trust Boundaries
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                          TRUST BOUNDARY 1                                │
+│                     (Cryptographic: Fhenix CoFHE)                        │
+│  ┌───────────────────────────────────────────────────────────────────┐  │
+│  │   Hook Source Code - Encrypted, cannot be extracted                │  │
+│  └───────────────────────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────┐
+│                          TRUST BOUNDARY 2                                │
+│                  (Cryptoeconomic: EigenLayer AVS)                        │
+│  ┌───────────────────────────────────────────────────────────────────┐  │
+│  │   Specification Compliance - Verified by staked operators          │  │
+│  │   Economic security: Σ(operator_stake) × slashing_rate            │  │
+│  └───────────────────────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────┐
+│                          TRUST BOUNDARY 3                                │
+│                    (Social: Specification Review)                        │
+│  ┌───────────────────────────────────────────────────────────────────┐  │
+│  │   Specification Quality - Community review, audits, reputation     │  │
+│  │   Risk: Malicious spec that matches malicious behavior             │  │
+│  └───────────────────────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+### 5.2 Threat Model
+
+| Threat | Impact | Mitigation | Residual Risk |
+|--------|--------|------------|---------------|
+| Code Extraction | IP theft | Fhenix FHE encryption | Cryptographic break |
+| False Attestation | Deploy malicious hook | Slashing, multi-operator | Operator collusion |
+| Spec Gaming | Approved malicious behavior | Community review | Undetected malicious spec |
+| State Manipulation | Bypass verification | Random sampling | Statistical edge cases |
+| Time-of-Check Attack | Behavior change after attestation | Attestation expiry | Short-term exploitation |
+
+### 5.3 Economic Security
+
+**Attestation Security Budget:**
+
+$$
+\text{Security} = \sum_{i \in \text{Operators}} \text{Stake}_i \times \text{SlashRate}
+$$
+
+**Recommended Parameters:**
+
+| Parameter | Value | Rationale |
+|-----------|-------|-----------|
+| Minimum Operator Count | 10 | Decentralization |
+| Quorum Threshold | 67% | BFT assumption |
+| Slash Rate | 10% | Sufficient deterrent |
+| Attestation Validity | 30 days | Balance freshness vs. overhead |
+| Sample Count | 100 | Statistical confidence |
+
+---
+
+## 6. Deployment Architecture
+
+### 6.1 Contract Deployment Order
+
+```
+Phase 1: Core Infrastructure
+├── 1.1 Deploy EigenLayer middleware (if not existing)
+├── 1.2 Deploy HookAttestationServiceManager
+├── 1.3 Deploy HookAttestationTaskManager
+└── 1.4 Deploy AttestationRegistry
+
+Phase 2: Marketplace
+├── 2.1 Deploy HookNFTRegistry
+├── 2.2 Deploy HookMarket
+├── 2.3 Deploy ProtocolHookMediator
+└── 2.4 Deploy MasterHook (Diamond)
+
+Phase 3: Integration
+├── 3.1 Register AVS with EigenLayer
+├── 3.2 Onboard initial operators
+├── 3.3 Connect MasterHook to PoolManager
+└── 3.4 Deploy StateView adapter
+
+Phase 4: Testing
+├── 4.1 Deploy test hooks
+├── 4.2 Run attestation workflow
+├── 4.3 Verify marketplace flow
+└── 4.4 Test slashing conditions
+```
+
+### 6.2 Operator Requirements
+
+**Hardware:**
+- CPU: 4+ cores
+- RAM: 8GB+
+- Storage: 100GB SSD
+- Network: 100Mbps+
+
+**Software:**
+- Ethereum node (archive preferred)
+- AVS operator client
+- BLS key management
+- IPFS gateway access
+
+**Stake:**
+- Minimum: 32 ETH equivalent
+- Recommended: 100+ ETH for higher task allocation
+
+---
+
+## 7. Future Extensions
+
+### 7.1 Planned Features
+
+| Feature | Description | Priority |
+|---------|-------------|----------|
+| Hook Composition | Chain multiple hooks on same pool | High |
+| Subscription Model | Recurring payments for hook usage | Medium |
+| Governance | DAO control of marketplace parameters | Medium |
+| Cross-chain | Deploy hooks on L2s and other chains | Low |
+| Formal Verification | TLA+ specs alongside Solidity | Low |
+
+### 7.2 Research Questions
+
+1. **Optimal Sample Distribution**: How to select state samples that maximize coverage with minimum count?
+2. **Specification Language**: Can we create a DSL that compiles to both Solidity and verification rules?
+3. **Incentive Alignment**: How to reward operators for thorough verification vs. speed?
+4. **Upgradeability**: How to handle hook upgrades while maintaining attestation?
+
+---
+
+## 8. References
+
+1. **[Uniswap V4 Core]** https://github.com/Uniswap/v4-core
+2. **[EigenLayer]** https://github.com/Layr-Labs/eigenlayer-contracts
+3. **[Fhenix CoFHE]** https://cofhe-docs.fhenix.zone/
+4. **[Bonded Hooks]** https://github.com/Jammabeans/Bonded-hooks
+5. **[arXiv:2512.06203]** Formal State-Machine Models for Uniswap v3
+6. **[Diamond Pattern]** EIP-2535 Diamonds
+
+---
+
+## 9. Glossary
+
+| Term | Definition |
+|------|------------|
+| **Hook** | Smart contract extending Uniswap V4 pool behavior via callbacks |
+| **Specification** | Formal document defining hook behavior mathematically |
+| **Attestation** | On-chain proof that hook implementation matches specification |
+| **AVS** | Actively Validated Service - EigenLayer service for decentralized verification |
+| **CoFHE** | Co-processing Fully Homomorphic Encryption |
+| **MasterHook** | Diamond-pattern contract routing callbacks to registered hooks |
+| **State Index** | Partitioning of pool state by user type (LP vs Trader) |
diff --git a/docs/hook-pkg/backend/hook-code-verifier-spec.md b/docs/hook-pkg/backend/hook-code-verifier-spec.md
new file mode 100644
index 000000000..1db168a9f
--- /dev/null
+++ b/docs/hook-pkg/backend/hook-code-verifier-spec.md
@@ -0,0 +1,1327 @@
+# HookCodeVerifier Service Specification
+
+> **Document Type:** Backend Service Specification
+> **Last Updated:** 2025-12-09
+> **Status:** Ready for Implementation
+
+---
+
+## 1. Service Overview
+
+The **HookCodeVerifier** is a modular backend service that handles the post-license workflow for hook code verification and encrypted deployment. After a HookLicense NFT is minted, developers submit a **GitHub repository URL** containing their hook implementation to be:
+
+1. **Fetched and analyzed by the Repository Analyzer** - Clones repo, identifies hook contracts, and prepares for verification
+2. **Verified by AVS (Actively Validated Service)** - Checks code compliance against the PDF/HookSpec specification
+3. **Encrypted and Deployed via CFHE (Confidential FHE)** - Deploys bytecode in encrypted form
+
+```
+┌─────────────────────────────────────────────────────────────────────────────────────────┐
+│                           HOOK CODE VERIFICATION FLOW                                    │
+├─────────────────────────────────────────────────────────────────────────────────────────┤
+│                                                                                          │
+│  PREREQUISITES (Already Completed)                                                       │
+│  ─────────────────────────────────                                                       │
+│  ✓ HookSpec validated against StateSpaceModel                                           │
+│  ✓ HookLicense NFT minted (tokenId, ipfsCid)                                           │
+│  ✓ PDF specification stored on IPFS                                                     │
+│                                                                                          │
+│  NEW FLOW (Steps 5-6)                                                                   │
+│  ────────────────────                                                                    │
+│                                                                                          │
+│  FRONTEND                                                                                │
+│  ────────                                                                                │
+│                                                                                          │
+│  HookLicense NFT Minted ──► "Submit Code" Button ──► Enter GitHub Repo URL             │
+│                                                              │                           │
+│                              OR                              │                           │
+│                                                              │                           │
+│  CLI: hook-bazaar submit-code --license <tokenId> --repo https://github.com/user/hook   │
+│                                                              │                           │
+│                                                              │ POST /api/hook/verify     │
+│                                                              ▼                           │
+│  ┌───────────────────────────────────────────────────────────────────────────────────┐  │
+│  │                              BACKEND                                               │  │
+│  │                                                                                    │  │
+│  │   CodeSubmissionRequest                                                           │  │
+│  │   {                                                                               │  │
+│  │     licenseTokenId: number,                                                       │  │
+│  │     repoUrl: string,            // GitHub repository URL                          │  │
+│  │     branch?: string,            // Optional branch (default: main)                │  │
+│  │     contractPath?: string,      // Optional path to main contract                 │  │
+│  │     compilerVersion: string,    // e.g., "0.8.26"                                 │  │
+│  │     optimizerRuns?: number,     // e.g., 200                                      │  │
+│  │     signature: string,          // EIP-712 signature                              │  │
+│  │   }                                                                               │  │
+│  │         │                                                                         │  │
+│  │         ▼                                                                         │  │
+│  │   ┌─────────────────────────────────────────────────────────────────────────┐    │  │
+│  │   │                    HOOKCODEEVERIFIER SERVICE                            │    │  │
+│  │   │                                                                          │    │  │
+│  │   │   ┌────────────────┐    ┌────────────────┐    ┌────────────────┐    ┌────────────────┐  │
+│  │   │   │ RepoAnalyzer   │───►│ CompilerModule │───►│ AVSVerifier    │───►│ CFHEDeployer   │  │
+│  │   │   │                │    │                │    │                │    │                │  │
+│  │   │   │ clone(url)     │    │ compile(code)  │    │ verify(byte,   │    │ encrypt(byte)  │  │
+│  │   │   │ analyze()      │    │ ──► bytecode   │    │        spec)   │    │ deploy()       │  │
+│  │   │   └────────────────┘    └────────────────┘    └────────────────┘    └────────────────┘  │
+│  │   │                                │                      │                  │    │  │
+│  │   │                                ▼                      ▼                  │    │  │
+│  │   │                     ┌──────────────────┐   ┌──────────────────┐          │    │  │
+│  │   │                     │ AVS Operators    │   │ CFHE Network     │          │    │  │
+│  │   │                     │                  │   │                  │          │    │  │
+│  │   │                     │ - Compliance %   │   │ - Encrypted      │          │    │  │
+│  │   │                     │ - Attestation    │   │   bytecode       │          │    │  │
+│  │   │                     │ - Stake slash    │   │ - Tx hash        │          │    │  │
+│  │   │                     │   if wrong       │   │ - Contract addr  │          │    │  │
+│  │   │                     └──────────────────┘   └──────────────────┘          │    │  │
+│  │   └─────────────────────────────────────────────────────────────────────────┘    │  │
+│  │         │                                                                         │  │
+│  │         ▼                                                                         │  │
+│  │   CodeVerificationResult                                                          │  │
+│  │   {                                                                               │  │
+│  │     success: true,                                                                │  │
+│  │     avsResult: {                                                                  │  │
+│  │       compliant: true,                                                            │  │
+│  │       complianceScore: 98.5,                                                      │  │
+│  │       attestationId: "0x...",                                                     │  │
+│  │       findings: [...],                                                            │  │
+│  │     },                                                                            │  │
+│  │     cfheResult: {                                                                 │  │
+│  │       encryptedBytecodeHash: "0x...",                                             │  │
+│  │       deploymentTxHash: "0x...",                                                  │  │
+│  │       encryptedContractAddress: "0x...",                                          │  │
+│  │     }                                                                             │  │
+│  │   }                                                                               │  │
+│  └───────────────────────────────────────────────────────────────────────────────────┘  │
+│                                                              │                           │
+│                                                              ▼                           │
+│  FRONTEND receives verification results + deployment confirmation                       │
+│                                                                                          │
+└─────────────────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 2. Modular Architecture
+
+### 2.1 Module Breakdown
+
+```
+HookCodeVerifier/
+├── index.ts                    # Main service orchestrator
+├── modules/
+│   ├── RepoAnalyzerModule.ts   # GitHub repo cloning & analysis
+│   ├── CompilerModule.ts       # Solidity compilation
+│   ├── AVSVerifierModule.ts    # AVS verification abstraction
+│   ├── CFHEDeployerModule.ts   # Encrypted deployment abstraction
+│   └── LicenseModule.ts        # HookLicense validation
+├── interfaces/
+│   ├── IRepoAnalyzer.ts        # Repository analyzer interface
+│   ├── ICompiler.ts            # Compiler interface
+│   ├── IAVSVerifier.ts         # AVS verifier interface
+│   ├── ICFHEDeployer.ts        # CFHE deployer interface
+│   └── ILicenseValidator.ts    # License validator interface
+├── providers/
+│   ├── GitHubProvider.ts       # GitHub API implementation
+│   ├── SolcProvider.ts         # solc-js implementation
+│   ├── EigenLayerAVS.ts        # EigenLayer AVS implementation
+│   ├── OthenticAVS.ts          # Othentic AVS implementation
+│   └── IncoFHE.ts              # Inco Network FHE implementation
+└── config/
+    └── index.ts                # Configuration management
+```
+
+### 2.2 Dependency Injection
+
+```typescript
+// Interfaces for dependency injection (fully modular)
+
+interface IRepoAnalyzer {
+  /**
+   * Clone and analyze a GitHub repository
+   * @param repoUrl - GitHub repository URL
+   * @param branch - Optional branch (defaults to main/master)
+   * @param contractPath - Optional path to main contract
+   * @returns Analysis result with discovered contracts and source code
+   */
+  analyze(request: RepoAnalyzeRequest): Promise<RepoAnalyzeResult>;
+
+  /**
+   * Get repository metadata (without cloning)
+   */
+  getRepoMetadata(repoUrl: string): Promise<RepoMetadata>;
+
+  /**
+   * Validate that URL is a valid GitHub repository
+   */
+  validateUrl(repoUrl: string): Promise<boolean>;
+}
+
+interface RepoAnalyzeRequest {
+  repoUrl: string;
+  branch?: string;          // Default: main or master
+  contractPath?: string;    // Optional: path to main hook contract
+}
+
+interface RepoAnalyzeResult {
+  success: boolean;
+  repoUrl: string;
+  branch: string;
+  commitHash: string;
+  contracts: DiscoveredContract[];
+  mainContract?: DiscoveredContract;  // Auto-detected or specified
+  dependencies: string[];             // External dependencies found
+  foundryConfig?: any;               // foundry.toml if present
+  hardhatConfig?: any;               // hardhat.config.js if present
+  errors?: string[];
+}
+
+interface DiscoveredContract {
+  name: string;
+  path: string;
+  sourceCode: string;
+  isHook: boolean;          // Detected as implementing BaseHook
+  inheritsFrom: string[];
+  pragmaVersion?: string;
+}
+
+interface RepoMetadata {
+  owner: string;
+  repo: string;
+  defaultBranch: string;
+  stars: number;
+  lastUpdated: string;
+  license?: string;
+  isPrivate: boolean;
+}
+
+interface ICompiler {
+  compile(
+    sourceCode: string,
+    compilerVersion: string,
+    optimizerRuns?: number
+  ): Promise<CompilationResult>;
+
+  getSupportedVersions(): Promise<string[]>;
+}
+
+interface CompilationResult {
+  success: boolean;
+  bytecode?: string;
+  deployedBytecode?: string;
+  abi?: any[];
+  errors?: CompilationError[];
+  warnings?: CompilationWarning[];
+}
+
+interface IAVSVerifier {
+  /**
+   * Verify bytecode compliance against specification
+   * @param request - Verification request with bytecode and spec reference
+   * @returns Verification result with compliance score and findings
+   */
+  verify(request: AVSVerifyRequest): Promise<AVSVerifyResult>;
+
+  /**
+   * Check verification status (for async verification)
+   */
+  getVerificationStatus(taskId: string): Promise<AVSVerifyResult>;
+
+  /**
+   * Get required stake for verification request
+   */
+  getRequiredStake(specComplexity: number): Promise<bigint>;
+}
+
+interface AVSVerifyRequest {
+  bytecode: string;
+  deployedBytecode: string;
+  specIpfsCid: string;
+  licenseTokenId: number;
+  requesterAddress: string;
+  stakeAmount: bigint;
+}
+
+interface AVSVerifyResult {
+  taskId: string;
+  status: 'pending' | 'completed' | 'failed';
+  compliant: boolean;
+  complianceScore: number;         // 0-100 percentage
+  attestationId?: string;          // On-chain attestation ID
+  attestationTxHash?: string;
+  findings: AVSFinding[];
+  operatorSignatures: string[];    // Signatures from AVS operators
+  timestamp: number;
+}
+
+interface AVSFinding {
+  severity: 'critical' | 'warning' | 'info';
+  ruleId: string;
+  ruleName: string;
+  description: string;
+  codeLocation?: {
+    startLine: number;
+    endLine: number;
+    functionName?: string;
+  };
+  specReference?: string;          // Reference to spec section
+}
+
+interface ICFHEDeployer {
+  /**
+   * Encrypt bytecode using FHE
+   */
+  encrypt(bytecode: string): Promise<EncryptionResult>;
+
+  /**
+   * Deploy encrypted bytecode to CFHE network
+   */
+  deploy(encryptedBytecode: string, metadata: DeploymentMetadata): Promise<DeploymentResult>;
+
+  /**
+   * Get deployment status
+   */
+  getDeploymentStatus(deploymentId: string): Promise<DeploymentResult>;
+}
+
+interface EncryptionResult {
+  encryptedBytecode: string;
+  encryptedBytecodeHash: string;
+  publicKeyUsed: string;
+  encryptionProof?: string;
+}
+
+interface DeploymentMetadata {
+  licenseTokenId: number;
+  specIpfsCid: string;
+  hookName: string;
+  hookVersion: string;
+  deployer: string;
+}
+
+interface DeploymentResult {
+  deploymentId: string;
+  status: 'pending' | 'deployed' | 'failed';
+  encryptedContractAddress?: string;
+  transactionHash?: string;
+  blockNumber?: number;
+  gasUsed?: bigint;
+  error?: string;
+}
+
+interface ILicenseValidator {
+  /**
+   * Validate that license exists and is owned by requester
+   */
+  validateLicense(
+    tokenId: number,
+    requesterAddress: string
+  ): Promise<LicenseValidation>;
+
+  /**
+   * Get license details including spec CID
+   */
+  getLicenseDetails(tokenId: number): Promise<LicenseDetails>;
+}
+
+interface LicenseValidation {
+  valid: boolean;
+  owner: string;
+  specIpfsCid: string;
+  deprecated: boolean;
+  error?: string;
+}
+
+interface LicenseDetails {
+  tokenId: number;
+  owner: string;
+  specIpfsCid: string;
+  hookName: string;
+  hookVersion: string;
+  registeredAt: number;
+  deprecated: boolean;
+}
+```
+
+---
+
+## 3. Input/Output Contracts
+
+### 3.1 Service Input (What HookCodeVerifier Receives)
+
+```typescript
+// POST /api/hook/verify
+interface CodeSubmissionRequest {
+  // License token ID (proves ownership of spec)
+  licenseTokenId: number;
+
+  // GitHub repository URL containing hook implementation
+  repoUrl: string;
+
+  // Optional: Branch to use (defaults to main/master)
+  branch?: string;
+
+  // Optional: Path to main hook contract (auto-detected if not provided)
+  contractPath?: string;
+
+  // Compiler version (e.g., "0.8.26")
+  compilerVersion: string;
+
+  // Optimizer settings
+  optimizerRuns?: number;  // Default: 200
+
+  // EIP-712 signature proving consent
+  signature: string;
+
+  // Optional: Skip CFHE deployment (verification only)
+  verifyOnly?: boolean;
+}
+
+// CLI equivalent
+// hook-bazaar submit-code \
+//   --license 42 \
+//   --repo https://github.com/username/my-hook \
+//   --branch main \
+//   --contract src/DynamicFeeHook.sol \
+//   --compiler 0.8.26 \
+//   --optimizer-runs 200
+
+// EIP-712 Typed Data being signed
+interface CodeSubmissionMessage {
+  licenseTokenId: number;
+  repoUrl: string;            // GitHub repository URL
+  commitHash: string;         // Specific commit being verified
+  compilerVersion: string;
+  submitter: string;
+  nonce: number;
+  deadline: number;
+}
+```
+
+### 3.2 Service Output (What HookCodeVerifier Returns)
+
+```typescript
+// Success Response
+interface CodeVerificationResult {
+  success: true;
+
+  // Repository analysis result
+  repoAnalysis: {
+    repoUrl: string;
+    branch: string;
+    commitHash: string;
+    mainContract: string;         // Path to main hook contract
+    contractsFound: number;
+    dependencies: string[];
+  };
+
+  // Compilation result
+  compilation: {
+    success: true;
+    bytecodeHash: string;
+    deployedBytecodeHash: string;
+  };
+
+  // AVS verification result
+  avsResult: {
+    compliant: boolean;
+    complianceScore: number;      // 0-100 percentage
+    attestationId: string;        // On-chain attestation reference
+    attestationTxHash: string;
+    findings: AVSFinding[];
+    verificationTimestamp: number;
+  };
+
+  // CFHE deployment result (if not verifyOnly)
+  cfheResult?: {
+    encryptedBytecodeHash: string;
+    deploymentTxHash: string;
+    encryptedContractAddress: string;
+    blockNumber: number;
+    explorerUrl: string;
+  };
+
+  // Summary
+  summary: {
+    hookName: string;
+    hookVersion: string;
+    licenseTokenId: number;
+    specIpfsCid: string;
+    repoUrl: string;
+    commitHash: string;
+    submittedAt: number;
+    completedAt: number;
+  };
+}
+
+// Error Response
+interface CodeVerificationError {
+  success: false;
+  error: {
+    code: ErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+  };
+  // Partial results if available
+  partialResults?: {
+    compilation?: CompilationResult;
+    avsResult?: Partial<AVSVerifyResult>;
+  };
+}
+
+type ErrorCode =
+  | 'INVALID_SIGNATURE'
+  | 'SIGNATURE_EXPIRED'
+  | 'INVALID_LICENSE'
+  | 'LICENSE_NOT_OWNED'
+  | 'LICENSE_DEPRECATED'
+  | 'INVALID_REPO_URL'
+  | 'REPO_NOT_FOUND'
+  | 'REPO_ACCESS_DENIED'
+  | 'BRANCH_NOT_FOUND'
+  | 'NO_HOOK_CONTRACTS_FOUND'
+  | 'MULTIPLE_HOOKS_FOUND'
+  | 'CONTRACT_PATH_NOT_FOUND'
+  | 'COMPILATION_FAILED'
+  | 'UNSUPPORTED_COMPILER'
+  | 'AVS_VERIFICATION_FAILED'
+  | 'AVS_TIMEOUT'
+  | 'INSUFFICIENT_STAKE'
+  | 'CFHE_ENCRYPTION_FAILED'
+  | 'CFHE_DEPLOYMENT_FAILED'
+  | 'NETWORK_ERROR';
+```
+
+---
+
+## 4. Module Specifications
+
+### 4.1 CompilerModule
+
+**Purpose**: Compile Solidity source code to bytecode.
+
+```typescript
+// modules/CompilerModule.ts
+
+import solc from 'solc';
+
+interface CompilerModuleConfig {
+  supportedVersions: string[];
+  defaultOptimizerRuns: number;
+  timeout: number;
+}
+
+class CompilerModule implements ICompiler {
+  constructor(private config: CompilerModuleConfig) {}
+
+  /**
+   * Compile Solidity source code
+   */
+  async compile(
+    sourceCode: string,
+    compilerVersion: string,
+    optimizerRuns: number = this.config.defaultOptimizerRuns
+  ): Promise<CompilationResult> {
+    // Validate compiler version
+    if (!this.config.supportedVersions.includes(compilerVersion)) {
+      return {
+        success: false,
+        errors: [{
+          type: 'UnsupportedCompiler',
+          message: `Compiler version ${compilerVersion} not supported`
+        }]
+      };
+    }
+
+    // Load specific compiler version
+    const compiler = await this.loadCompiler(compilerVersion);
+
+    // Prepare input
+    const input = {
+      language: 'Solidity',
+      sources: {
+        'Hook.sol': { content: sourceCode }
+      },
+      settings: {
+        optimizer: {
+          enabled: true,
+          runs: optimizerRuns
+        },
+        outputSelection: {
+          '*': {
+            '*': ['abi', 'evm.bytecode', 'evm.deployedBytecode']
+          }
+        }
+      }
+    };
+
+    // Compile
+    const output = JSON.parse(compiler.compile(JSON.stringify(input)));
+
+    // Check for errors
+    const errors = output.errors?.filter((e: any) => e.severity === 'error') || [];
+    const warnings = output.errors?.filter((e: any) => e.severity === 'warning') || [];
+
+    if (errors.length > 0) {
+      return {
+        success: false,
+        errors: errors.map((e: any) => ({
+          type: e.type,
+          message: e.message,
+          formattedMessage: e.formattedMessage
+        })),
+        warnings
+      };
+    }
+
+    // Extract bytecode from first contract
+    const contracts = output.contracts['Hook.sol'];
+    const contractName = Object.keys(contracts)[0];
+    const contract = contracts[contractName];
+
+    return {
+      success: true,
+      bytecode: contract.evm.bytecode.object,
+      deployedBytecode: contract.evm.deployedBytecode.object,
+      abi: contract.abi,
+      warnings
+    };
+  }
+
+  private async loadCompiler(version: string): Promise<any> {
+    // Load specific solc version
+    return new Promise((resolve, reject) => {
+      solc.loadRemoteVersion(`v${version}`, (err: any, solcSnapshot: any) => {
+        if (err) reject(err);
+        else resolve(solcSnapshot);
+      });
+    });
+  }
+
+  async getSupportedVersions(): Promise<string[]> {
+    return this.config.supportedVersions;
+  }
+}
+```
+
+### 4.2 AVSVerifierModule
+
+**Purpose**: Submit bytecode to AVS operators for specification compliance verification.
+
+```typescript
+// modules/AVSVerifierModule.ts
+
+interface AVSVerifierConfig {
+  avsContractAddress: string;
+  rpcUrl: string;
+  minOperatorQuorum: number;
+  verificationTimeout: number;  // ms
+  stakingTokenAddress: string;
+}
+
+class AVSVerifierModule implements IAVSVerifier {
+  private contract: ethers.Contract;
+  private provider: ethers.Provider;
+
+  constructor(private config: AVSVerifierConfig) {
+    this.provider = new ethers.JsonRpcProvider(config.rpcUrl);
+    this.contract = new ethers.Contract(
+      config.avsContractAddress,
+      HookVerifierAVSABI,
+      this.provider
+    );
+  }
+
+  /**
+   * Submit verification request to AVS
+   */
+  async verify(request: AVSVerifyRequest): Promise<AVSVerifyResult> {
+    // Check required stake
+    const requiredStake = await this.getRequiredStake(
+      this.estimateSpecComplexity(request.specIpfsCid)
+    );
+
+    if (request.stakeAmount < requiredStake) {
+      throw new AVSError('INSUFFICIENT_STAKE',
+        `Required stake: ${requiredStake}, provided: ${request.stakeAmount}`);
+    }
+
+    // Create verification task
+    const taskId = await this.createVerificationTask(request);
+
+    // Wait for operator responses (with timeout)
+    const result = await this.waitForVerification(taskId);
+
+    return result;
+  }
+
+  private async createVerificationTask(request: AVSVerifyRequest): Promise<string> {
+    // This would interact with AVS contract to create a task
+    // Operators would then fetch bytecode and spec, verify, and submit responses
+
+    const tx = await this.contract.createVerificationTask(
+      request.bytecode,
+      request.specIpfsCid,
+      request.licenseTokenId,
+      request.requesterAddress,
+      { value: request.stakeAmount }
+    );
+
+    const receipt = await tx.wait();
+    const event = receipt.logs.find(
+      (log: any) => log.fragment?.name === 'TaskCreated'
+    );
+
+    return event?.args?.taskId;
+  }
+
+  private async waitForVerification(taskId: string): Promise<AVSVerifyResult> {
+    const startTime = Date.now();
+
+    while (Date.now() - startTime < this.config.verificationTimeout) {
+      const status = await this.getVerificationStatus(taskId);
+
+      if (status.status === 'completed' || status.status === 'failed') {
+        return status;
+      }
+
+      // Wait before polling again
+      await new Promise(resolve => setTimeout(resolve, 5000));
+    }
+
+    throw new AVSError('AVS_TIMEOUT', 'Verification timed out');
+  }
+
+  async getVerificationStatus(taskId: string): Promise<AVSVerifyResult> {
+    const task = await this.contract.getTask(taskId);
+    const responses = await this.contract.getTaskResponses(taskId);
+
+    // Aggregate operator responses
+    const findings = this.aggregateFindings(responses);
+    const complianceScore = this.calculateComplianceScore(responses);
+    const compliant = complianceScore >= 95;  // 95% threshold
+
+    return {
+      taskId,
+      status: task.status,
+      compliant,
+      complianceScore,
+      attestationId: task.attestationId,
+      attestationTxHash: task.attestationTxHash,
+      findings,
+      operatorSignatures: responses.map((r: any) => r.signature),
+      timestamp: task.completedAt
+    };
+  }
+
+  async getRequiredStake(specComplexity: number): Promise<bigint> {
+    // Stake increases with spec complexity
+    // This creates economic incentive for accurate verification
+    const baseStake = await this.contract.baseStakeAmount();
+    return baseStake * BigInt(specComplexity);
+  }
+
+  private estimateSpecComplexity(specCid: string): number {
+    // In production, this would analyze the spec
+    // For now, return a default complexity
+    return 1;
+  }
+
+  private aggregateFindings(responses: any[]): AVSFinding[] {
+    // Aggregate findings from all operators
+    // Use consensus to filter out false positives
+    const findingsMap = new Map<string, { finding: AVSFinding; count: number }>();
+
+    for (const response of responses) {
+      for (const finding of response.findings) {
+        const key = `${finding.ruleId}:${finding.codeLocation?.startLine}`;
+        const existing = findingsMap.get(key);
+        if (existing) {
+          existing.count++;
+        } else {
+          findingsMap.set(key, { finding, count: 1 });
+        }
+      }
+    }
+
+    // Only include findings with consensus (>50% of operators)
+    const threshold = Math.ceil(responses.length / 2);
+    return Array.from(findingsMap.values())
+      .filter(({ count }) => count >= threshold)
+      .map(({ finding }) => finding);
+  }
+
+  private calculateComplianceScore(responses: any[]): number {
+    const scores = responses.map((r: any) => r.complianceScore);
+    return scores.reduce((a: number, b: number) => a + b, 0) / scores.length;
+  }
+}
+```
+
+### 4.3 CFHEDeployerModule
+
+**Purpose**: Encrypt bytecode and deploy to CFHE network.
+
+```typescript
+// modules/CFHEDeployerModule.ts
+
+interface CFHEDeployerConfig {
+  networkUrl: string;
+  encryptionKeyId: string;
+  deployerPrivateKey: string;
+  gasLimit: number;
+}
+
+class CFHEDeployerModule implements ICFHEDeployer {
+  private fheClient: FHEClient;
+  private signer: ethers.Wallet;
+
+  constructor(private config: CFHEDeployerConfig) {
+    const provider = new ethers.JsonRpcProvider(config.networkUrl);
+    this.signer = new ethers.Wallet(config.deployerPrivateKey, provider);
+    this.fheClient = new FHEClient(config.networkUrl, config.encryptionKeyId);
+  }
+
+  /**
+   * Encrypt bytecode using FHE
+   */
+  async encrypt(bytecode: string): Promise<EncryptionResult> {
+    // Get public key for encryption
+    const publicKey = await this.fheClient.getPublicKey();
+
+    // Encrypt bytecode
+    const encryptedBytecode = await this.fheClient.encrypt(
+      Buffer.from(bytecode, 'hex'),
+      publicKey
+    );
+
+    // Calculate hash of encrypted bytecode
+    const encryptedBytecodeHash = ethers.keccak256(encryptedBytecode);
+
+    return {
+      encryptedBytecode: encryptedBytecode.toString('hex'),
+      encryptedBytecodeHash,
+      publicKeyUsed: publicKey,
+      encryptionProof: await this.fheClient.getEncryptionProof(encryptedBytecode)
+    };
+  }
+
+  /**
+   * Deploy encrypted bytecode
+   */
+  async deploy(
+    encryptedBytecode: string,
+    metadata: DeploymentMetadata
+  ): Promise<DeploymentResult> {
+    try {
+      // Create deployment transaction
+      const tx = await this.signer.sendTransaction({
+        data: `0x${encryptedBytecode}`,
+        gasLimit: this.config.gasLimit
+      });
+
+      // Wait for confirmation
+      const receipt = await tx.wait();
+
+      // Extract contract address
+      const contractAddress = receipt?.contractAddress;
+
+      if (!contractAddress) {
+        throw new Error('Contract address not found in receipt');
+      }
+
+      // Register deployment in registry (links to license)
+      await this.registerDeployment(
+        contractAddress,
+        metadata.licenseTokenId,
+        metadata.specIpfsCid
+      );
+
+      return {
+        deploymentId: tx.hash,
+        status: 'deployed',
+        encryptedContractAddress: contractAddress,
+        transactionHash: tx.hash,
+        blockNumber: receipt.blockNumber,
+        gasUsed: receipt.gasUsed
+      };
+
+    } catch (error) {
+      return {
+        deploymentId: '',
+        status: 'failed',
+        error: error instanceof Error ? error.message : 'Unknown error'
+      };
+    }
+  }
+
+  private async registerDeployment(
+    contractAddress: string,
+    licenseTokenId: number,
+    specIpfsCid: string
+  ): Promise<void> {
+    // Register in deployment registry contract
+    const registry = new ethers.Contract(
+      DEPLOYMENT_REGISTRY_ADDRESS,
+      DeploymentRegistryABI,
+      this.signer
+    );
+
+    await registry.registerDeployment(
+      contractAddress,
+      licenseTokenId,
+      specIpfsCid
+    );
+  }
+
+  async getDeploymentStatus(deploymentId: string): Promise<DeploymentResult> {
+    const receipt = await this.signer.provider?.getTransactionReceipt(deploymentId);
+
+    if (!receipt) {
+      return {
+        deploymentId,
+        status: 'pending'
+      };
+    }
+
+    return {
+      deploymentId,
+      status: receipt.status === 1 ? 'deployed' : 'failed',
+      encryptedContractAddress: receipt.contractAddress || undefined,
+      transactionHash: deploymentId,
+      blockNumber: receipt.blockNumber,
+      gasUsed: receipt.gasUsed
+    };
+  }
+}
+```
+
+### 4.4 LicenseModule
+
+**Purpose**: Validate HookLicense ownership and retrieve spec details.
+
+```typescript
+// modules/LicenseModule.ts
+
+interface LicenseModuleConfig {
+  contractAddress: string;
+  rpcUrl: string;
+}
+
+class LicenseModule implements ILicenseValidator {
+  private contract: ethers.Contract;
+
+  constructor(private config: LicenseModuleConfig) {
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl);
+    this.contract = new ethers.Contract(
+      config.contractAddress,
+      HookLicenseABI,
+      provider
+    );
+  }
+
+  /**
+   * Validate license ownership
+   */
+  async validateLicense(
+    tokenId: number,
+    requesterAddress: string
+  ): Promise<LicenseValidation> {
+    try {
+      // Check token exists
+      const owner = await this.contract.ownerOf(tokenId);
+
+      // Check ownership
+      if (owner.toLowerCase() !== requesterAddress.toLowerCase()) {
+        return {
+          valid: false,
+          owner,
+          specIpfsCid: '',
+          deprecated: false,
+          error: 'License not owned by requester'
+        };
+      }
+
+      // Get spec details
+      const details = await this.getLicenseDetails(tokenId);
+
+      // Check not deprecated
+      if (details.deprecated) {
+        return {
+          valid: false,
+          owner,
+          specIpfsCid: details.specIpfsCid,
+          deprecated: true,
+          error: 'License is deprecated'
+        };
+      }
+
+      return {
+        valid: true,
+        owner,
+        specIpfsCid: details.specIpfsCid,
+        deprecated: false
+      };
+
+    } catch (error) {
+      return {
+        valid: false,
+        owner: '',
+        specIpfsCid: '',
+        deprecated: false,
+        error: 'License does not exist'
+      };
+    }
+  }
+
+  async getLicenseDetails(tokenId: number): Promise<LicenseDetails> {
+    const [name, version, ipfsCid, deprecated, registeredAt] = await Promise.all([
+      this.contract.hookName(tokenId),
+      this.contract.hookVersion(tokenId),
+      this.contract.specCid(tokenId),
+      this.contract.isDeprecated(tokenId),
+      this.contract.registeredAt(tokenId)
+    ]);
+
+    const owner = await this.contract.ownerOf(tokenId);
+
+    return {
+      tokenId,
+      owner,
+      specIpfsCid: ipfsCid,
+      hookName: name,
+      hookVersion: version,
+      registeredAt: Number(registeredAt),
+      deprecated
+    };
+  }
+}
+```
+
+---
+
+## 5. Main Service Orchestrator
+
+```typescript
+// index.ts - HookCodeVerifier main service
+
+interface HookCodeVerifierConfig {
+  compiler: CompilerModuleConfig;
+  avs: AVSVerifierConfig;
+  cfhe: CFHEDeployerConfig;
+  license: LicenseModuleConfig;
+  signature: SignatureModuleConfig;
+}
+
+class HookCodeVerifier {
+  private compilerModule: CompilerModule;
+  private avsModule: AVSVerifierModule;
+  private cfheModule: CFHEDeployerModule;
+  private licenseModule: LicenseModule;
+  private signatureModule: SignatureModule;
+
+  constructor(config: HookCodeVerifierConfig) {
+    this.compilerModule = new CompilerModule(config.compiler);
+    this.avsModule = new AVSVerifierModule(config.avs);
+    this.cfheModule = new CFHEDeployerModule(config.cfhe);
+    this.licenseModule = new LicenseModule(config.license);
+    this.signatureModule = new SignatureModule(config.signature);
+  }
+
+  /**
+   * Main entry point: Verify and deploy hook code
+   */
+  async verifyAndDeploy(request: CodeSubmissionRequest): Promise<CodeVerificationResult> {
+    const { licenseTokenId, sourceCode, compilerVersion, optimizerRuns, signature, verifyOnly } = request;
+
+    // Step 1: Validate signature
+    const codeHash = ethers.keccak256(ethers.toUtf8Bytes(sourceCode));
+    const recoveredSigner = this.signatureModule.recoverSigner(
+      { licenseTokenId, codeHash, compilerVersion, submitter: '', nonce: 0, deadline: 0 },
+      signature
+    );
+
+    // Step 2: Validate license ownership
+    const licenseValidation = await this.licenseModule.validateLicense(
+      licenseTokenId,
+      recoveredSigner
+    );
+
+    if (!licenseValidation.valid) {
+      throw new VerifierError(
+        licenseValidation.deprecated ? 'LICENSE_DEPRECATED' : 'LICENSE_NOT_OWNED',
+        licenseValidation.error || 'License validation failed'
+      );
+    }
+
+    // Step 3: Compile source code
+    const compilation = await this.compilerModule.compile(
+      sourceCode,
+      compilerVersion,
+      optimizerRuns
+    );
+
+    if (!compilation.success) {
+      throw new VerifierError('COMPILATION_FAILED', 'Compilation failed', {
+        errors: compilation.errors
+      });
+    }
+
+    // Step 4: Submit to AVS for verification
+    const avsResult = await this.avsModule.verify({
+      bytecode: compilation.bytecode!,
+      deployedBytecode: compilation.deployedBytecode!,
+      specIpfsCid: licenseValidation.specIpfsCid,
+      licenseTokenId,
+      requesterAddress: recoveredSigner,
+      stakeAmount: await this.avsModule.getRequiredStake(1)
+    });
+
+    // Step 5: Deploy to CFHE (if not verify-only and AVS passed)
+    let cfheResult: DeploymentResult | undefined;
+
+    if (!verifyOnly && avsResult.compliant) {
+      const encryption = await this.cfheModule.encrypt(compilation.deployedBytecode!);
+
+      const licenseDetails = await this.licenseModule.getLicenseDetails(licenseTokenId);
+
+      cfheResult = await this.cfheModule.deploy(encryption.encryptedBytecode, {
+        licenseTokenId,
+        specIpfsCid: licenseValidation.specIpfsCid,
+        hookName: licenseDetails.hookName,
+        hookVersion: licenseDetails.hookVersion,
+        deployer: recoveredSigner
+      });
+
+      if (cfheResult.status === 'failed') {
+        throw new VerifierError('CFHE_DEPLOYMENT_FAILED', cfheResult.error || 'Deployment failed');
+      }
+    }
+
+    // Return result
+    const licenseDetails = await this.licenseModule.getLicenseDetails(licenseTokenId);
+
+    return {
+      success: true,
+      compilation: {
+        success: true,
+        bytecodeHash: ethers.keccak256(`0x${compilation.bytecode}`),
+        deployedBytecodeHash: ethers.keccak256(`0x${compilation.deployedBytecode}`)
+      },
+      avsResult: {
+        compliant: avsResult.compliant,
+        complianceScore: avsResult.complianceScore,
+        attestationId: avsResult.attestationId!,
+        attestationTxHash: avsResult.attestationTxHash!,
+        findings: avsResult.findings,
+        verificationTimestamp: avsResult.timestamp
+      },
+      cfheResult: cfheResult ? {
+        encryptedBytecodeHash: ethers.keccak256(`0x${cfheResult.encryptedContractAddress}`),
+        deploymentTxHash: cfheResult.transactionHash!,
+        encryptedContractAddress: cfheResult.encryptedContractAddress!,
+        blockNumber: cfheResult.blockNumber!,
+        explorerUrl: `https://explorer.inco.org/tx/${cfheResult.transactionHash}`
+      } : undefined,
+      summary: {
+        hookName: licenseDetails.hookName,
+        hookVersion: licenseDetails.hookVersion,
+        licenseTokenId,
+        specIpfsCid: licenseValidation.specIpfsCid,
+        submittedAt: Date.now(),
+        completedAt: Date.now()
+      }
+    };
+  }
+}
+```
+
+---
+
+## 6. API Endpoint Implementation
+
+```typescript
+// routes/hook.ts
+
+import { Router } from 'express';
+import { HookCodeVerifier } from '../services/HookCodeVerifier';
+
+const router = Router();
+const verifier = new HookCodeVerifier(config);
+
+/**
+ * POST /api/hook/verify
+ *
+ * Submit hook code for AVS verification and CFHE deployment
+ */
+router.post('/verify', async (req, res) => {
+  try {
+    const request: CodeSubmissionRequest = req.body;
+
+    // Validate request shape
+    if (!request.licenseTokenId || !request.sourceCode || !request.signature) {
+      return res.status(400).json({
+        success: false,
+        error: {
+          code: 'INVALID_REQUEST',
+          message: 'Missing required fields: licenseTokenId, sourceCode, signature'
+        }
+      });
+    }
+
+    // Verify and deploy
+    const result = await verifier.verifyAndDeploy(request);
+
+    return res.status(200).json(result);
+
+  } catch (error) {
+    if (error instanceof VerifierError) {
+      return res.status(400).json({
+        success: false,
+        error: {
+          code: error.code,
+          message: error.message,
+          details: error.details
+        }
+      });
+    }
+
+    console.error('Unexpected error in /verify:', error);
+    return res.status(500).json({
+      success: false,
+      error: {
+        code: 'INTERNAL_ERROR',
+        message: 'An unexpected error occurred'
+      }
+    });
+  }
+});
+
+/**
+ * GET /api/hook/verify/:taskId
+ *
+ * Get verification status for async verification
+ */
+router.get('/verify/:taskId', async (req, res) => {
+  try {
+    const { taskId } = req.params;
+    const status = await verifier.getVerificationStatus(taskId);
+    return res.status(200).json(status);
+  } catch (error) {
+    return res.status(500).json({
+      success: false,
+      error: {
+        code: 'INTERNAL_ERROR',
+        message: 'Failed to get verification status'
+      }
+    });
+  }
+});
+
+export default router;
+```
+
+---
+
+## 7. Economic Model
+
+### 7.1 Staking Requirements
+
+```
+Protocol Designer (requester) must stake:
+┌────────────────────────────────────────────────────────────────────┐
+│                                                                     │
+│  Required Stake = baseStake * specComplexity                       │
+│                                                                     │
+│  Where:                                                             │
+│  - baseStake: Minimum stake (e.g., 0.1 ETH)                        │
+│  - specComplexity: Based on number of functions/invariants          │
+│                                                                     │
+│  Purpose:                                                           │
+│  - Prevents spam requests                                           │
+│  - Compensates AVS operators for verification work                  │
+│  - Creates economic incentive for accurate specifications           │
+│                                                                     │
+└────────────────────────────────────────────────────────────────────┘
+```
+
+### 7.2 AVS Operator Economics
+
+```
+AVS Operators:
+┌────────────────────────────────────────────────────────────────────┐
+│                                                                     │
+│  Correct Verification:                                              │
+│  - Receive portion of requester's stake as reward                  │
+│  - Reputation score increases                                       │
+│                                                                     │
+│  Incorrect Verification (detected via challenge):                   │
+│  - Operator's stake is slashed                                      │
+│  - Slashed stake goes to challenger                                │
+│  - Reputation score decreases                                       │
+│                                                                     │
+│  This creates:                                                      │
+│  - Incentive for thorough verification                             │
+│  - Disincentive for lazy/malicious attestations                    │
+│  - Self-correcting system via challenges                           │
+│                                                                     │
+└────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 8. Summary
+
+**HookCodeVerifier receives:**
+```typescript
+{
+  licenseTokenId: number,     // Proves ownership of spec
+  repoUrl: string,            // GitHub repository URL
+  branch?: string,            // Optional branch (default: main)
+  contractPath?: string,      // Optional path to hook contract
+  compilerVersion: string,    // Compiler version
+  optimizerRuns?: number,     // Optimizer settings
+  signature: string,          // EIP-712 consent
+  verifyOnly?: boolean        // Skip deployment
+}
+```
+
+**HookCodeVerifier returns:**
+```typescript
+{
+  success: true,
+  repoAnalysis: {
+    repoUrl: string,
+    branch: string,
+    commitHash: string,
+    mainContract: string,
+    contractsFound: number
+  },
+  compilation: {
+    success: true,
+    bytecodeHash: string,
+    deployedBytecodeHash: string
+  },
+  avsResult: {
+    compliant: boolean,
+    complianceScore: number,     // 0-100%
+    attestationId: string,
+    attestationTxHash: string,
+    findings: AVSFinding[]
+  },
+  cfheResult: {
+    encryptedBytecodeHash: string,
+    deploymentTxHash: string,
+    encryptedContractAddress: string,
+    explorerUrl: string
+  }
+}
+```
+
+**Modular design via interfaces:**
+- `IRepoAnalyzer` - Clone and analyze GitHub repositories
+- `ICompiler` - Compile Solidity to bytecode
+- `IAVSVerifier` - Verify compliance with staked operators
+- `ICFHEDeployer` - Encrypt and deploy to CFHE network
+- `ILicenseValidator` - Validate license ownership
+
+Each module can be independently tested, replaced, or upgraded without affecting the others.
diff --git a/docs/hook-pkg/backend/hook-license-issuer-spec.md b/docs/hook-pkg/backend/hook-license-issuer-spec.md
new file mode 100644
index 000000000..927552fab
--- /dev/null
+++ b/docs/hook-pkg/backend/hook-license-issuer-spec.md
@@ -0,0 +1,876 @@
+# HookLicenseIssuer Service Specification
+
+> **Document Type:** Backend Service Specification
+> **Last Updated:** 2025-12-09
+> **Status:** Ready for Implementation
+
+---
+
+## 1. Service Overview
+
+The **HookLicenseIssuer** is a modular backend service that:
+1. Receives validated HookSpecs from the frontend
+2. Uploads specs to IPFS
+3. Mints HookLicense NFTs
+4. Returns the license to the user
+
+```
+┌─────────────────────────────────────────────────────────────────────────────────────────┐
+│                              HOOKLICENSEISSUER FLOW                                      │
+├─────────────────────────────────────────────────────────────────────────────────────────┤
+│                                                                                          │
+│  FRONTEND                                                                                │
+│  ────────                                                                                │
+│                                                                                          │
+│  createHook ──► HookDashboard ──► StateSpaceModel ──► [Validate] ──► submitHookSpec    │
+│                                    (READ ONLY)         Compatibility                     │
+│                                                                                          │
+│                                                              │                           │
+│                                                              │ POST /api/hookspec/submit │
+│                                                              ▼                           │
+│  ┌───────────────────────────────────────────────────────────────────────────────────┐  │
+│  │                              BACKEND                                               │  │
+│  │                                                                                    │  │
+│  │   SubmitHookSpecRequest                                                           │  │
+│  │   {                                                                               │  │
+│  │     spec: HookSpec,                                                               │  │
+│  │     signature: string,    // EIP-712 signature                                    │  │
+│  │     royaltyBps?: number   // Optional royalty (default: 500 = 5%)                 │  │
+│  │   }                                                                               │  │
+│  │         │                                                                         │  │
+│  │         ▼                                                                         │  │
+│  │   ┌─────────────────────────────────────────────────────────────────────────┐    │  │
+│  │   │                    HOOKLICENSEISSUER SERVICE                             │    │  │
+│  │   │                                                                          │    │  │
+│  │   │   ┌────────────────┐    ┌────────────────┐    ┌────────────────┐        │    │  │
+│  │   │   │ SignatureModule│───►│ IPFSModule     │───►│ MintModule     │        │    │  │
+│  │   │   │                │    │                │    │                │        │    │  │
+│  │   │   │ verify(sig,    │    │ upload(spec)   │    │ mint(dev,cid,  │        │    │  │
+│  │   │   │        signer) │    │ ──► CID        │    │      metadata) │        │    │  │
+│  │   │   └────────────────┘    └────────────────┘    └────────────────┘        │    │  │
+│  │   │                                                       │                  │    │  │
+│  │   │                                                       ▼                  │    │  │
+│  │   │                                              ┌────────────────┐          │    │  │
+│  │   │                                              │ HookLicense    │          │    │  │
+│  │   │                                              │ NFT Contract   │          │    │  │
+│  │   │                                              │                │          │    │  │
+│  │   │                                              │ tokenId: 42    │          │    │  │
+│  │   │                                              │ owner: user    │          │    │  │
+│  │   │                                              │ uri: ipfs://...│          │    │  │
+│  │   │                                              └────────────────┘          │    │  │
+│  │   └─────────────────────────────────────────────────────────────────────────┘    │  │
+│  │         │                                                                         │  │
+│  │         ▼                                                                         │  │
+│  │   SubmissionResult                                                                │  │
+│  │   {                                                                               │  │
+│  │     success: true,                                                                │  │
+│  │     ipfsCid: "Qm...",                                                             │  │
+│  │     tokenId: 42,                                                                  │  │
+│  │     transactionHash: "0x...",                                                     │  │
+│  │     ownerAddress: "0x1234...",                                                    │  │
+│  │     ipfsGatewayUrl: "https://ipfs.io/ipfs/Qm..."                                  │  │
+│  │   }                                                                               │  │
+│  └───────────────────────────────────────────────────────────────────────────────────┘  │
+│                                                              │                           │
+│                                                              ▼                           │
+│  FRONTEND receives (user, HookLicense)                                                  │
+│                                                                                          │
+└─────────────────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 2. Modular Architecture
+
+### 2.1 Module Breakdown
+
+```
+HookLicenseIssuer/
+├── index.ts                    # Main service orchestrator
+├── modules/
+│   ├── SignatureModule.ts      # EIP-712 signature verification
+│   ├── ValidationModule.ts     # HookSpec re-validation
+│   ├── IPFSModule.ts           # IPFS upload abstraction
+│   └── MintModule.ts           # NFT minting abstraction
+├── interfaces/
+│   ├── ISignatureVerifier.ts   # Signature interface
+│   ├── IIPFSProvider.ts        # IPFS provider interface
+│   └── IMinter.ts              # NFT minter interface
+├── providers/
+│   ├── PinataProvider.ts       # Pinata IPFS implementation
+│   ├── Web3StorageProvider.ts  # Web3.storage implementation
+│   └── InfuraProvider.ts       # Infura IPFS implementation
+└── config/
+    └── index.ts                # Configuration management
+```
+
+### 2.2 Dependency Injection
+
+```typescript
+// Interfaces for dependency injection (fully modular)
+
+interface ISignatureVerifier {
+  verify(message: SignedMessage, signature: string, expectedSigner: string): boolean;
+  recoverSigner(message: SignedMessage, signature: string): string;
+}
+
+interface IIPFSProvider {
+  upload(content: string | Buffer): Promise<string>;  // Returns CID
+  pin(cid: string): Promise<boolean>;
+  unpin(cid: string): Promise<boolean>;
+  getGatewayUrl(cid: string): string;
+}
+
+interface IMinter {
+  mint(
+    developer: string,
+    ipfsCid: string,
+    name: string,
+    version: string,
+    royaltyBps: number
+  ): Promise<MintResult>;
+
+  getTokenByCid(cid: string): Promise<number | null>;
+  isRegistered(cid: string): Promise<boolean>;
+}
+
+interface MintResult {
+  tokenId: number;
+  transactionHash: string;
+  blockNumber: number;
+}
+```
+
+---
+
+## 3. Input/Output Contracts
+
+### 3.1 Service Input (What HookLicenseIssuer Receives)
+
+```typescript
+// POST /api/hookspec/submit
+interface SubmitHookSpecRequest {
+  // The validated HookSpec document
+  spec: HookSpec;
+
+  // EIP-712 signature proving user consent
+  signature: string;
+
+  // Optional royalty percentage (basis points)
+  // Default: 500 (5%)
+  // Range: 0-10000 (0-100%)
+  royaltyBps?: number;
+}
+
+// HookSpec structure (from frontend validation)
+interface HookSpec {
+  metadata: {
+    name: string;           // e.g., "DynamicFeeHook"
+    version: string;        // e.g., "1.0.0"
+    author: string;         // Ethereum address
+    description?: string;
+    license?: string;
+    system_state_version?: string;  // IPFS CID of system-state.md
+  };
+  hook_state: StateVariable[];
+  system_functions: SystemFunction[];
+  invariants?: Invariant[];
+}
+
+// EIP-712 Typed Data being signed
+interface SignedMessage {
+  name: string;              // spec.metadata.name
+  version: string;           // spec.metadata.version
+  specHash: string;          // keccak256(JSON.stringify(spec))
+  developer: string;         // User's address
+  nonce: number;             // Replay protection
+  deadline: number;          // Unix timestamp
+}
+```
+
+### 3.2 Service Output (What HookLicenseIssuer Returns)
+
+```typescript
+// Success Response
+interface SubmissionResult {
+  success: true;
+
+  // IPFS CID of the uploaded spec
+  ipfsCid: string;           // e.g., "QmXyz..."
+
+  // Minted NFT token ID
+  tokenId: number;           // e.g., 42
+
+  // Transaction hash of mint
+  transactionHash: string;   // e.g., "0xabc..."
+
+  // Owner of the NFT (developer)
+  ownerAddress: string;      // e.g., "0x1234..."
+
+  // Convenience URLs
+  ipfsGatewayUrl: string;    // e.g., "https://ipfs.io/ipfs/QmXyz..."
+  openSeaUrl?: string;       // e.g., "https://opensea.io/assets/..."
+  etherscanUrl?: string;     // e.g., "https://etherscan.io/tx/..."
+}
+
+// Error Response
+interface SubmissionError {
+  success: false;
+  error: {
+    code: ErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+  };
+}
+
+type ErrorCode =
+  | 'INVALID_SIGNATURE'
+  | 'SIGNATURE_EXPIRED'
+  | 'INVALID_SPEC'
+  | 'IPFS_UPLOAD_FAILED'
+  | 'CID_ALREADY_REGISTERED'
+  | 'MINT_FAILED'
+  | 'INSUFFICIENT_GAS'
+  | 'CONTRACT_ERROR'
+  | 'NETWORK_ERROR';
+```
+
+---
+
+## 4. Module Specifications
+
+### 4.1 SignatureModule
+
+**Purpose**: Verify EIP-712 signatures to ensure user consent.
+
+```typescript
+// modules/SignatureModule.ts
+
+import { ethers } from 'ethers';
+
+interface SignatureModuleConfig {
+  domain: EIP712Domain;
+  types: EIP712Types;
+}
+
+interface EIP712Domain {
+  name: string;              // "HookBazaar"
+  version: string;           // "1"
+  chainId: number;           // 1 (mainnet) or testnet
+  verifyingContract: string; // HookLicense contract address
+}
+
+class SignatureModule implements ISignatureVerifier {
+  constructor(private config: SignatureModuleConfig) {}
+
+  /**
+   * Verify signature matches expected signer
+   */
+  verify(message: SignedMessage, signature: string, expectedSigner: string): boolean {
+    const recoveredSigner = this.recoverSigner(message, signature);
+    return recoveredSigner.toLowerCase() === expectedSigner.toLowerCase();
+  }
+
+  /**
+   * Recover signer address from signature
+   */
+  recoverSigner(message: SignedMessage, signature: string): string {
+    return ethers.verifyTypedData(
+      this.config.domain,
+      this.config.types,
+      message,
+      signature
+    );
+  }
+
+  /**
+   * Check if signature deadline has passed
+   */
+  isExpired(message: SignedMessage): boolean {
+    return Date.now() / 1000 > message.deadline;
+  }
+}
+```
+
+**Input**:
+- `message`: The typed data that was signed
+- `signature`: The hex-encoded signature
+- `expectedSigner`: The address we expect signed it
+
+**Output**:
+- `boolean`: Whether signature is valid
+
+### 4.2 ValidationModule
+
+**Purpose**: Re-validate HookSpec before processing (defense in depth).
+
+```typescript
+// modules/ValidationModule.ts
+
+interface ValidationModuleConfig {
+  systemStateUrl: string;  // URL or IPFS CID of system-state.md
+  strictMode: boolean;     // Fail on warnings
+}
+
+class ValidationModule {
+  private systemState: StateSpaceModel | null = null;
+
+  constructor(private config: ValidationModuleConfig) {}
+
+  /**
+   * Load system state model
+   */
+  async initialize(): Promise<void> {
+    this.systemState = await this.fetchSystemState();
+  }
+
+  /**
+   * Validate HookSpec against system state
+   */
+  validate(spec: HookSpec): ValidationResult[] {
+    const results: ValidationResult[] = [];
+
+    // Run all validation rules
+    results.push(this.validatePoolStateReferences(spec));
+    results.push(this.validateUniqueHookStateNames(spec));
+    results.push(this.validateCallbacks(spec));
+    results.push(this.validateEquationSymbols(spec));
+    results.push(this.validateSolidityTypes(spec));
+    results.push(this.validateWritesMatchHookState(spec));
+
+    return results;
+  }
+
+  /**
+   * Quick check if spec is valid
+   */
+  isValid(spec: HookSpec): boolean {
+    const results = this.validate(spec);
+    return results.every(r => r.passed);
+  }
+}
+```
+
+**Input**:
+- `spec`: HookSpec document
+
+**Output**:
+- `ValidationResult[]`: Array of rule results
+- `boolean`: Overall validity
+
+### 4.3 IPFSModule
+
+**Purpose**: Abstract IPFS operations with provider flexibility.
+
+```typescript
+// modules/IPFSModule.ts
+
+interface IPFSModuleConfig {
+  provider: 'pinata' | 'web3storage' | 'infura';
+  apiKey: string;
+  apiSecret?: string;
+  gateway: string;
+}
+
+class IPFSModule implements IIPFSProvider {
+  private provider: IIPFSProvider;
+
+  constructor(private config: IPFSModuleConfig) {
+    // Factory pattern for provider selection
+    this.provider = this.createProvider(config);
+  }
+
+  private createProvider(config: IPFSModuleConfig): IIPFSProvider {
+    switch (config.provider) {
+      case 'pinata':
+        return new PinataProvider(config.apiKey, config.apiSecret);
+      case 'web3storage':
+        return new Web3StorageProvider(config.apiKey);
+      case 'infura':
+        return new InfuraProvider(config.apiKey, config.apiSecret);
+      default:
+        throw new Error(`Unknown IPFS provider: ${config.provider}`);
+    }
+  }
+
+  /**
+   * Upload HookSpec to IPFS
+   */
+  async upload(spec: HookSpec, developer: string): Promise<string> {
+    // Wrap spec with metadata
+    const wrapper: IPFSHookSpecWrapper = {
+      schema_version: '1.0.0',
+      content_type: 'hookspec',
+      uploader: developer,
+      uploaded_at: Date.now(),
+      content: spec
+    };
+
+    const content = JSON.stringify(wrapper, null, 2);
+    const cid = await this.provider.upload(content);
+
+    // Ensure pinned
+    await this.provider.pin(cid);
+
+    return cid;
+  }
+
+  /**
+   * Get gateway URL for CID
+   */
+  getGatewayUrl(cid: string): string {
+    return `${this.config.gateway}/ipfs/${cid}`;
+  }
+}
+```
+
+**Input**:
+- `spec`: HookSpec document
+- `developer`: Uploader address
+
+**Output**:
+- `string`: IPFS CID
+
+### 4.4 MintModule
+
+**Purpose**: Abstract NFT minting operations.
+
+```typescript
+// modules/MintModule.ts
+
+interface MintModuleConfig {
+  contractAddress: string;
+  rpcUrl: string;
+  signerPrivateKey: string;  // Backend signer with MINTER_ROLE
+  chainId: number;
+  gasLimit?: number;
+}
+
+class MintModule implements IMinter {
+  private contract: ethers.Contract;
+  private signer: ethers.Wallet;
+
+  constructor(private config: MintModuleConfig) {
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl);
+    this.signer = new ethers.Wallet(config.signerPrivateKey, provider);
+    this.contract = new ethers.Contract(
+      config.contractAddress,
+      HookLicenseABI,
+      this.signer
+    );
+  }
+
+  /**
+   * Mint HookLicense NFT
+   */
+  async mint(
+    developer: string,
+    ipfsCid: string,
+    name: string,
+    version: string,
+    royaltyBps: number
+  ): Promise<MintResult> {
+    // Check if already registered
+    if (await this.isRegistered(ipfsCid)) {
+      throw new MintError('CID_ALREADY_REGISTERED', `CID ${ipfsCid} already registered`);
+    }
+
+    // Estimate gas
+    const estimatedGas = await this.contract.mint.estimateGas(
+      developer,
+      ipfsCid,
+      name,
+      version,
+      royaltyBps
+    );
+
+    // Execute mint
+    const tx = await this.contract.mint(
+      developer,
+      ipfsCid,
+      name,
+      version,
+      royaltyBps,
+      {
+        gasLimit: Math.ceil(Number(estimatedGas) * 1.2)  // 20% buffer
+      }
+    );
+
+    // Wait for confirmation
+    const receipt = await tx.wait();
+
+    // Extract tokenId from event
+    const event = receipt.logs.find(
+      (log: any) => log.fragment?.name === 'HookSpecRegistered'
+    );
+    const tokenId = event?.args?.tokenId?.toNumber() ?? 0;
+
+    return {
+      tokenId,
+      transactionHash: receipt.hash,
+      blockNumber: receipt.blockNumber
+    };
+  }
+
+  /**
+   * Check if CID is already registered
+   */
+  async isRegistered(cid: string): Promise<boolean> {
+    return await this.contract.isRegistered(cid);
+  }
+
+  /**
+   * Get token ID by CID
+   */
+  async getTokenByCid(cid: string): Promise<number | null> {
+    try {
+      const tokenId = await this.contract.getTokenByCid(cid);
+      return tokenId.toNumber();
+    } catch {
+      return null;
+    }
+  }
+}
+```
+
+**Input**:
+- `developer`: Address to receive NFT
+- `ipfsCid`: IPFS CID of spec
+- `name`: Hook name
+- `version`: Hook version
+- `royaltyBps`: Royalty percentage
+
+**Output**:
+- `MintResult`: Token ID, tx hash, block number
+
+---
+
+## 5. Main Service Orchestrator
+
+```typescript
+// index.ts - HookLicenseIssuer main service
+
+interface HookLicenseIssuerConfig {
+  signature: SignatureModuleConfig;
+  validation: ValidationModuleConfig;
+  ipfs: IPFSModuleConfig;
+  mint: MintModuleConfig;
+}
+
+class HookLicenseIssuer {
+  private signatureModule: SignatureModule;
+  private validationModule: ValidationModule;
+  private ipfsModule: IPFSModule;
+  private mintModule: MintModule;
+
+  constructor(config: HookLicenseIssuerConfig) {
+    this.signatureModule = new SignatureModule(config.signature);
+    this.validationModule = new ValidationModule(config.validation);
+    this.ipfsModule = new IPFSModule(config.ipfs);
+    this.mintModule = new MintModule(config.mint);
+  }
+
+  /**
+   * Initialize service (load system state, etc.)
+   */
+  async initialize(): Promise<void> {
+    await this.validationModule.initialize();
+  }
+
+  /**
+   * Main entry point: Issue a HookLicense NFT
+   *
+   * @param request - The submission request from frontend
+   * @returns SubmissionResult on success, throws on error
+   */
+  async issueHookLicense(request: SubmitHookSpecRequest): Promise<SubmissionResult> {
+    const { spec, signature, royaltyBps = 500 } = request;
+    const developer = spec.metadata.author;
+
+    // Step 1: Verify signature
+    const specHash = this.computeSpecHash(spec);
+    const signedMessage: SignedMessage = {
+      name: spec.metadata.name,
+      version: spec.metadata.version,
+      specHash,
+      developer,
+      nonce: await this.getNonce(developer),
+      deadline: Math.floor(Date.now() / 1000) + 3600  // Assume 1 hour validity
+    };
+
+    if (this.signatureModule.isExpired(signedMessage)) {
+      throw new IssuerError('SIGNATURE_EXPIRED', 'Signature deadline has passed');
+    }
+
+    if (!this.signatureModule.verify(signedMessage, signature, developer)) {
+      throw new IssuerError('INVALID_SIGNATURE', 'Signature verification failed');
+    }
+
+    // Step 2: Re-validate spec (defense in depth)
+    if (!this.validationModule.isValid(spec)) {
+      const results = this.validationModule.validate(spec);
+      const errors = results.filter(r => !r.passed).flatMap(r => r.errors);
+      throw new IssuerError('INVALID_SPEC', 'HookSpec validation failed', { errors });
+    }
+
+    // Step 3: Upload to IPFS
+    let ipfsCid: string;
+    try {
+      ipfsCid = await this.ipfsModule.upload(spec, developer);
+    } catch (error) {
+      throw new IssuerError('IPFS_UPLOAD_FAILED', 'Failed to upload to IPFS', { error });
+    }
+
+    // Step 4: Mint NFT
+    let mintResult: MintResult;
+    try {
+      mintResult = await this.mintModule.mint(
+        developer,
+        ipfsCid,
+        spec.metadata.name,
+        spec.metadata.version,
+        royaltyBps
+      );
+    } catch (error) {
+      if (error instanceof MintError && error.code === 'CID_ALREADY_REGISTERED') {
+        throw new IssuerError('CID_ALREADY_REGISTERED', 'This spec is already registered');
+      }
+      throw new IssuerError('MINT_FAILED', 'Failed to mint NFT', { error });
+    }
+
+    // Step 5: Return result
+    return {
+      success: true,
+      ipfsCid,
+      tokenId: mintResult.tokenId,
+      transactionHash: mintResult.transactionHash,
+      ownerAddress: developer,
+      ipfsGatewayUrl: this.ipfsModule.getGatewayUrl(ipfsCid),
+      openSeaUrl: this.buildOpenSeaUrl(mintResult.tokenId),
+      etherscanUrl: this.buildEtherscanUrl(mintResult.transactionHash)
+    };
+  }
+
+  private computeSpecHash(spec: HookSpec): string {
+    return ethers.keccak256(
+      ethers.toUtf8Bytes(JSON.stringify(spec))
+    );
+  }
+
+  private async getNonce(address: string): Promise<number> {
+    // Implement nonce tracking (could be from contract or database)
+    return 0;
+  }
+
+  private buildOpenSeaUrl(tokenId: number): string {
+    // Build OpenSea URL based on network
+    return `https://opensea.io/assets/ethereum/${this.mintModule.config.contractAddress}/${tokenId}`;
+  }
+
+  private buildEtherscanUrl(txHash: string): string {
+    return `https://etherscan.io/tx/${txHash}`;
+  }
+}
+```
+
+---
+
+## 6. API Endpoint Implementation
+
+```typescript
+// routes/hookspec.ts
+
+import { Router } from 'express';
+import { HookLicenseIssuer } from '../services/HookLicenseIssuer';
+
+const router = Router();
+const issuer = new HookLicenseIssuer(config);
+
+// Initialize on startup
+issuer.initialize();
+
+/**
+ * POST /api/hookspec/submit
+ *
+ * Submit a validated HookSpec for IPFS upload and NFT minting
+ */
+router.post('/submit', async (req, res) => {
+  try {
+    const request: SubmitHookSpecRequest = req.body;
+
+    // Validate request shape
+    if (!request.spec || !request.signature) {
+      return res.status(400).json({
+        success: false,
+        error: {
+          code: 'INVALID_REQUEST',
+          message: 'Missing required fields: spec, signature'
+        }
+      });
+    }
+
+    // Issue the license
+    const result = await issuer.issueHookLicense(request);
+
+    return res.status(201).json(result);
+
+  } catch (error) {
+    if (error instanceof IssuerError) {
+      return res.status(400).json({
+        success: false,
+        error: {
+          code: error.code,
+          message: error.message,
+          details: error.details
+        }
+      });
+    }
+
+    // Unexpected error
+    console.error('Unexpected error in /submit:', error);
+    return res.status(500).json({
+      success: false,
+      error: {
+        code: 'INTERNAL_ERROR',
+        message: 'An unexpected error occurred'
+      }
+    });
+  }
+});
+
+export default router;
+```
+
+---
+
+## 7. Configuration
+
+```typescript
+// config/index.ts
+
+interface Config {
+  // Network
+  chainId: number;
+  rpcUrl: string;
+
+  // Contracts
+  hookLicenseContract: string;
+
+  // IPFS
+  ipfsProvider: 'pinata' | 'web3storage' | 'infura';
+  ipfsApiKey: string;
+  ipfsApiSecret?: string;
+  ipfsGateway: string;
+
+  // Signing
+  signerPrivateKey: string;  // For backend minting
+
+  // Validation
+  systemStateCid: string;    // IPFS CID of system-state.md
+  strictValidation: boolean;
+}
+
+// Example config loading
+function loadConfig(): Config {
+  return {
+    chainId: parseInt(process.env.CHAIN_ID || '1'),
+    rpcUrl: process.env.RPC_URL || 'https://mainnet.infura.io/v3/...',
+    hookLicenseContract: process.env.HOOK_LICENSE_CONTRACT!,
+    ipfsProvider: (process.env.IPFS_PROVIDER || 'pinata') as any,
+    ipfsApiKey: process.env.IPFS_API_KEY!,
+    ipfsApiSecret: process.env.IPFS_API_SECRET,
+    ipfsGateway: process.env.IPFS_GATEWAY || 'https://ipfs.io',
+    signerPrivateKey: process.env.SIGNER_PRIVATE_KEY!,
+    systemStateCid: process.env.SYSTEM_STATE_CID!,
+    strictValidation: process.env.STRICT_VALIDATION === 'true'
+  };
+}
+```
+
+---
+
+## 8. Modularity Benefits
+
+### 8.1 Swappable Components
+
+| Component | Interface | Implementations |
+|-----------|-----------|-----------------|
+| Signature Verification | `ISignatureVerifier` | EIP-712, EIP-1271 (smart contract wallets) |
+| IPFS Upload | `IIPFSProvider` | Pinata, Web3.storage, Infura, IPFS daemon |
+| NFT Minting | `IMinter` | HookLicense (ERC-721), HookLicense1155 (ERC-1155) |
+
+### 8.2 Testing Strategy
+
+```typescript
+// Mock implementations for testing
+
+class MockIPFSProvider implements IIPFSProvider {
+  private storage = new Map<string, string>();
+
+  async upload(content: string): Promise<string> {
+    const cid = `Qm${Math.random().toString(36).slice(2)}`;
+    this.storage.set(cid, content);
+    return cid;
+  }
+
+  // ... other methods
+}
+
+class MockMinter implements IMinter {
+  private tokenCounter = 0;
+  private registry = new Map<string, number>();
+
+  async mint(developer, ipfsCid, name, version, royaltyBps): Promise<MintResult> {
+    const tokenId = ++this.tokenCounter;
+    this.registry.set(ipfsCid, tokenId);
+    return {
+      tokenId,
+      transactionHash: `0x${Math.random().toString(16).slice(2)}`,
+      blockNumber: 12345
+    };
+  }
+
+  // ... other methods
+}
+```
+
+### 8.3 Future Extensions
+
+1. **Multi-chain Support**: Add chain-specific minters
+2. **Batch Minting**: Support minting multiple specs at once
+3. **Upgradeable Specs**: Support versioning and updates
+4. **AVS Integration**: Add attestation before minting
+5. **Payment Integration**: Add payment module for paid listings
+
+---
+
+## 9. Summary
+
+**HookLicenseIssuer receives:**
+```typescript
+{
+  spec: HookSpec,        // The validated hook specification
+  signature: string,     // EIP-712 signature proving consent
+  royaltyBps?: number    // Optional royalty (default 5%)
+}
+```
+
+**HookLicenseIssuer returns:**
+```typescript
+{
+  success: true,
+  ipfsCid: string,       // IPFS content address
+  tokenId: number,       // NFT token ID
+  transactionHash: string,
+  ownerAddress: string,
+  ipfsGatewayUrl: string,
+  openSeaUrl?: string
+}
+```
+
+**Modular design via interfaces:**
+- `ISignatureVerifier` - Verify user consent
+- `IIPFSProvider` - Store spec immutably
+- `IMinter` - Issue NFT ownership
+
+Each module can be independently tested, replaced, or upgraded without affecting the others.
diff --git a/docs/hook-pkg/backend/hook-market-spec.md b/docs/hook-pkg/backend/hook-market-spec.md
new file mode 100644
index 000000000..11f1b13b8
--- /dev/null
+++ b/docs/hook-pkg/backend/hook-market-spec.md
@@ -0,0 +1,479 @@
+# Hook Market Service Specification
+
+## Problem Description
+
+Protocol Administrators (ProtocolAdmins) need a marketplace to discover, evaluate, and subscribe to hooks for their Uniswap v4 pools. The system must:
+
+1. Provide browsable hook catalog from on-chain HookLicense database
+2. Display HaaS (Hook-as-a-Service) subscription pricing and terms
+3. Enable subscription purchase via `addHook` transaction
+4. Verify deployed code matches registered bytecode (obfuscated)
+5. Allow functionality testing via AVS verification service
+
+---
+
+## Solution Overview
+
+```mermaid
+graph TB
+    subgraph "Protocol Admin Flow"
+        PA[Protocol Admin]
+        HB[Hook Browser]
+        HL[Hook Lens]
+        BV[Bytecode Verifier]
+        FT[Functionality Tester]
+    end
+
+    subgraph "On-Chain"
+        HR[HookRegistry]
+        LR[LicenseRegistry]
+        CFHE[CFHE Network]
+    end
+
+    subgraph "Off-Chain Services"
+        IPFS[IPFS Gateway]
+        AVS[AVS Verification]
+        IDX[Indexer]
+    end
+
+    PA --> HB
+    HB --> HR
+    HB --> IDX
+    HB --> HL
+    HL --> LR
+    HL --> IPFS
+    HL -->|addHook| HR
+    HL --> BV
+    BV --> CFHE
+    HL --> FT
+    FT --> AVS
+```
+
+---
+
+## Data Models
+
+### HookListing (On-Chain + IPFS)
+
+```typescript
+interface HookListing {
+  // On-chain data
+  tokenId: number;              // HookLicense NFT token ID
+  developer: address;           // Hook developer address
+  registeredAt: number;         // Block timestamp
+  deprecated: boolean;          // Deprecation status
+
+  // Pricing (on-chain)
+  pricing: HookPricing;
+
+  // IPFS metadata
+  metadata: {
+    name: string;
+    version: string;
+    description: string;
+    category: HookCategory;
+    tags: string[];
+    capabilities: HookCapability[];
+  };
+
+  // Verification status
+  verification: {
+    codeVerified: boolean;
+    avsAttestationId?: string;
+    complianceScore?: number;
+    cfheDeployed: boolean;
+  };
+}
+
+type HookCategory =
+  | 'FEE_MANAGEMENT'      // Dynamic fees, fee sharing
+  | 'ORACLE'              // Price oracles, TWAP
+  | 'LIMIT_ORDER'         // Limit orders, stop-loss
+  | 'LIQUIDITY'           // LP incentives, auto-rebalance
+  | 'MEV_PROTECTION'      // MEV mitigation
+  | 'CUSTOM';             // Other
+
+interface HookCapability {
+  callback: HookCallback;
+  description: string;
+}
+
+interface HookPricing {
+  model: 'FIXED' | 'REVENUE_SHARE' | 'HYBRID';
+  fixedPrice?: bigint;           // One-time fee (wei)
+  revenueShareBps?: number;      // Basis points (0-10000)
+  currency: address;             // Payment token (address(0) = ETH)
+}
+```
+
+### HookSubscription
+
+```typescript
+interface HookSubscription {
+  subscriptionId: bytes32;
+  hookTokenId: number;
+  poolId: bytes32;
+  subscriber: address;          // ProtocolAdmin
+  subscribedAt: number;
+  active: boolean;
+
+  // Payment tracking
+  totalPaid: bigint;
+  revenueShareAccrued: bigint;
+}
+```
+
+### BytecodeVerification
+
+```typescript
+interface BytecodeVerificationRequest {
+  hookTokenId: number;
+  poolId?: bytes32;             // Optional: verify for specific pool
+}
+
+interface BytecodeVerificationResult {
+  verified: boolean;
+  obfuscatedBytecodeHash: string;
+  deployedBytecodeHash: string;
+  matchPercentage: number;      // 0-100
+  cfheContractAddress?: string;
+  encryptionStatus: 'ENCRYPTED' | 'PLAINTEXT' | 'NOT_DEPLOYED';
+}
+```
+
+### FunctionalityTest
+
+```typescript
+interface FunctionalityTestRequest {
+  hookTokenId: number;
+  testType: 'SWAP' | 'LIQUIDITY' | 'INITIALIZE' | 'CUSTOM';
+  testData: {
+    // Swap test
+    swapParams?: {
+      zeroForOne: boolean;
+      amountSpecified: bigint;
+      sqrtPriceLimitX96: bigint;
+    };
+    // Liquidity test
+    liquidityParams?: {
+      tickLower: number;
+      tickUpper: number;
+      liquidityDelta: bigint;
+    };
+    // Custom test
+    customParams?: Record<string, unknown>;
+  };
+  expectedBehavior?: string;    // Natural language description
+}
+
+interface FunctionalityTestResult {
+  success: boolean;
+  testId: string;
+  avsVerificationId: string;
+
+  // Results
+  accuracyScore: number;        // 0-100 percentage
+  behaviorMatch: boolean;
+
+  // Detailed report
+  report: {
+    inputSummary: string;
+    expectedOutput: string;
+    actualOutput: string;
+    deviations: TestDeviation[];
+    gasUsed: bigint;
+    executionTimeMs: number;
+  };
+
+  // AVS attestation
+  attestation: {
+    attestationId: string;
+    attesters: address[];
+    consensus: number;          // Percentage of agreeing operators
+    timestamp: number;
+  };
+}
+
+interface TestDeviation {
+  field: string;
+  expected: string;
+  actual: string;
+  severity: 'CRITICAL' | 'WARNING' | 'INFO';
+}
+```
+
+---
+
+## API Endpoints
+
+### GET /hooks
+
+List available hooks from marketplace.
+
+**Query Parameters:**
+- `category?: HookCategory` - Filter by category
+- `minComplianceScore?: number` - Minimum AVS compliance score
+- `verified?: boolean` - Only show verified hooks
+- `maxPrice?: string` - Maximum fixed price (wei)
+- `maxRevShareBps?: number` - Maximum revenue share
+- `page?: number` - Pagination
+- `limit?: number` - Results per page (default: 20)
+
+**Response:**
+```typescript
+interface ListHooksResponse {
+  hooks: HookListingSummary[];
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    hasMore: boolean;
+  };
+}
+
+interface HookListingSummary {
+  tokenId: number;
+  name: string;
+  version: string;
+  category: HookCategory;
+  developer: address;
+  pricing: HookPricing;
+  complianceScore?: number;
+  verified: boolean;
+  subscriptionCount: number;
+}
+```
+
+### GET /hooks/:tokenId
+
+Get detailed hook information.
+
+**Response:**
+```typescript
+interface GetHookResponse {
+  hook: HookListing;
+  spec: HookSpec;                // Full specification from IPFS
+  subscriptions: number;         // Total subscription count
+  pools: PoolDeployment[];       // Pools using this hook
+}
+
+interface PoolDeployment {
+  poolId: bytes32;
+  chainId: number;
+  deployedAt: number;
+  active: boolean;
+}
+```
+
+### POST /hooks/:tokenId/verify-bytecode
+
+Verify deployed bytecode matches registered hook.
+
+**Request:**
+```typescript
+interface VerifyBytecodeRequest {
+  poolId?: bytes32;
+  chainId?: number;
+}
+```
+
+**Response:** `BytecodeVerificationResult`
+
+### POST /hooks/:tokenId/test-functionality
+
+Run functionality test via AVS.
+
+**Request:** `FunctionalityTestRequest`
+
+**Response:** `FunctionalityTestResult`
+
+### POST /hooks/:tokenId/subscribe
+
+Generate subscription transaction data.
+
+**Request:**
+```typescript
+interface SubscribeRequest {
+  poolId: bytes32;
+  signature: string;            // EIP-712 signature
+}
+```
+
+**Response:**
+```typescript
+interface SubscribeResponse {
+  transactionData: {
+    to: address;
+    data: bytes;
+    value: bigint;
+  };
+  estimatedGas: bigint;
+  pricing: {
+    fixedCost: bigint;
+    revenueShareBps: number;
+  };
+}
+```
+
+---
+
+## Contracts Integration
+
+### IHookRegistry
+
+```solidity
+interface IHookRegistry {
+    struct HookInfo {
+        uint256 tokenId;
+        address developer;
+        uint256 registeredAt;
+        bool deprecated;
+        bytes32 specCid;        // IPFS CID
+        bytes32 bytecodeHash;   // Deployed bytecode hash
+    }
+
+    struct Pricing {
+        PricingModel model;
+        uint256 fixedPrice;
+        uint16 revenueShareBps;
+        address currency;
+    }
+
+    enum PricingModel { FIXED, REVENUE_SHARE, HYBRID }
+
+    function getHook(uint256 tokenId) external view returns (HookInfo memory);
+    function getPricing(uint256 tokenId) external view returns (Pricing memory);
+    function getHooksByCategory(bytes32 category) external view returns (uint256[] memory);
+    function isVerified(uint256 tokenId) external view returns (bool);
+}
+```
+
+### IHookSubscription
+
+```solidity
+interface IHookSubscription {
+    function subscribe(
+        uint256 hookTokenId,
+        bytes32 poolId,
+        bytes calldata signature
+    ) external payable returns (bytes32 subscriptionId);
+
+    function getSubscription(bytes32 subscriptionId)
+        external view returns (Subscription memory);
+
+    function isSubscribed(bytes32 poolId, uint256 hookTokenId)
+        external view returns (bool);
+
+    function addHook(bytes32 poolId, uint256 hookTokenId) external;
+}
+```
+
+---
+
+## Error Codes
+
+```typescript
+type HookMarketErrorCode =
+  | 'HOOK_NOT_FOUND'
+  | 'HOOK_DEPRECATED'
+  | 'HOOK_NOT_VERIFIED'
+  | 'INVALID_POOL_ID'
+  | 'POOL_NOT_FOUND'
+  | 'ALREADY_SUBSCRIBED'
+  | 'INSUFFICIENT_PAYMENT'
+  | 'INVALID_SIGNATURE'
+  | 'SIGNATURE_EXPIRED'
+  | 'BYTECODE_MISMATCH'
+  | 'CFHE_NOT_DEPLOYED'
+  | 'AVS_UNAVAILABLE'
+  | 'TEST_TIMEOUT'
+  | 'INVALID_TEST_PARAMS';
+```
+
+---
+
+## Activity Diagram
+
+```mermaid
+stateDiagram-v2
+    [*] --> BrowseHooks: ProtocolAdmin enters marketplace
+
+    BrowseHooks --> FilterHooks: Apply filters
+    FilterHooks --> BrowseHooks
+
+    BrowseHooks --> ViewHookDetails: Select hook
+    ViewHookDetails --> ViewPricing: Check HaaS terms
+    ViewHookDetails --> VerifyBytecode: Check deployment
+    ViewHookDetails --> TestFunctionality: Test with AVS
+
+    VerifyBytecode --> BytecodeResult: View obfuscated code
+    BytecodeResult --> ViewHookDetails
+
+    TestFunctionality --> EnterTestData: Configure test
+    EnterTestData --> RunAVSTest: Submit to AVS
+    RunAVSTest --> ViewAccuracyReport: Get results
+    ViewAccuracyReport --> ViewHookDetails
+
+    ViewPricing --> Subscribe: Agree to terms
+    Subscribe --> SignTransaction: Connect wallet
+    SignTransaction --> ExecuteAddHook: Confirm tx
+    ExecuteAddHook --> SubscriptionActive: Success
+
+    SubscriptionActive --> [*]
+```
+
+---
+
+## Data Flow
+
+```mermaid
+flowchart LR
+    subgraph Frontend
+        HB[HookBrowser]
+        HL[HookLens]
+        BV[BytecodeVerifier]
+        FT[FunctionalityTester]
+    end
+
+    subgraph Backend
+        API[Hook Market API]
+        IDX[Indexer]
+    end
+
+    subgraph Blockchain
+        HR[HookRegistry]
+        HS[HookSubscription]
+        CFHE[CFHE Contract]
+    end
+
+    subgraph AVS
+        OP[AVS Operators]
+    end
+
+    HB -->|GET /hooks| API
+    API -->|Query| IDX
+    IDX -->|Index| HR
+
+    HL -->|GET /hooks/:id| API
+    API -->|Fetch spec| IPFS[(IPFS)]
+
+    BV -->|POST verify| API
+    API -->|Read bytecode| CFHE
+
+    FT -->|POST test| API
+    API -->|Verify| OP
+    OP -->|Attestation| API
+
+    HL -->|addHook tx| HS
+    HS -->|Register| HR
+```
+
+---
+
+## Security Considerations
+
+1. **Signature Verification**: All subscription requests require EIP-712 signatures
+2. **Price Manipulation**: Fixed prices stored on-chain, immutable after listing
+3. **Bytecode Tampering**: CFHE encryption prevents modification
+4. **AVS Collusion**: Multiple operators provide consensus on test results
+5. **Rate Limiting**: Functionality tests rate-limited per user/hour
diff --git a/docs/hook-pkg/frontend/hook-developer-flow.md b/docs/hook-pkg/frontend/hook-developer-flow.md
new file mode 100644
index 000000000..0e547538d
--- /dev/null
+++ b/docs/hook-pkg/frontend/hook-developer-flow.md
@@ -0,0 +1,675 @@
+# Hook Developer Dashboard: Frontend Flow & API Specification
+
+> **Document Type:** Implementation Specification
+> **Last Updated:** 2025-12-09
+> **Status:** Ready for Implementation
+
+---
+
+## 1. User Flow Diagram
+
+```
+┌─────────────────────────────────────────────────────────────────────────────────────────┐
+│                           HOOK DEVELOPER DASHBOARD FLOW                                  │
+├─────────────────────────────────────────────────────────────────────────────────────────┤
+│                                                                                          │
+│  ┌────────────────────┐                                                                 │
+│  │  HookDeveloper     │                                                                 │
+│  │  Dashboard         │                                                                 │
+│  │  /hook-developer   │                                                                 │
+│  └─────────┬──────────┘                                                                 │
+│            │                                                                            │
+│            │ clicks "Create New Hook"                                                   │
+│            ▼                                                                            │
+│  ┌────────────────────────────────────────────────────────────────────────────────┐    │
+│  │  CreateHook Page                                                                │    │
+│  │  /hook-developer/create                                                         │    │
+│  │                                                                                 │    │
+│  │  ┌─────────────────────────────────────────────────────────────────────────┐   │    │
+│  │  │  Step 1: View State Space Model (READ ONLY)                             │   │    │
+│  │  │                                                                          │   │    │
+│  │  │  ┌──────────────────────────────────────────────────────────────────┐  │   │    │
+│  │  │  │  StateSpaceModelViewer                                           │  │   │    │
+│  │  │  │                                                                   │  │   │    │
+│  │  │  │  - LP Index Variables (positions, ticks)                         │  │   │    │
+│  │  │  │  - Trader Index Variables (slot0, liquidity)                     │  │   │    │
+│  │  │  │  - Shared Variables (fee growth)                                 │  │   │    │
+│  │  │  │                                                                   │  │   │    │
+│  │  │  │  [Search] [Copy Symbol] [View IStateView Source]                 │  │   │    │
+│  │  │  └──────────────────────────────────────────────────────────────────┘  │   │    │
+│  │  └─────────────────────────────────────────────────────────────────────────┘   │    │
+│  │                                                                                 │    │
+│  │  ┌─────────────────────────────────────────────────────────────────────────┐   │    │
+│  │  │  Step 2: Write/Upload HookSpec                                          │   │    │
+│  │  │                                                                          │   │    │
+│  │  │  [Upload File] or [Use Editor]                                          │   │    │
+│  │  │                                                                          │   │    │
+│  │  │  ┌──────────────────────────────────────────────────────────────────┐  │   │    │
+│  │  │  │  HookSpecEditor                                                  │  │   │    │
+│  │  │  │                                                                   │  │   │    │
+│  │  │  │  metadata:                                                        │  │   │    │
+│  │  │  │    name: "MyHook"                                                 │  │   │    │
+│  │  │  │    version: "1.0.0"                                               │  │   │    │
+│  │  │  │                                                                   │  │   │    │
+│  │  │  │  hook_state:                                                      │  │   │    │
+│  │  │  │    - name: accumulated_fees                                       │  │   │    │
+│  │  │  │      symbol: F_acc                                                │  │   │    │
+│  │  │  │      type: uint256                                                │  │   │    │
+│  │  │  │                                                                   │  │   │    │
+│  │  │  │  system_functions:                                                │  │   │    │
+│  │  │  │    - callback: afterSwap                                          │  │   │    │
+│  │  │  │      reads: [sqrt_price, active_liquidity]                        │  │   │    │
+│  │  │  │      ...                                                          │  │   │    │
+│  │  │  └──────────────────────────────────────────────────────────────────┘  │   │    │
+│  │  └─────────────────────────────────────────────────────────────────────────┘   │    │
+│  │                                                                                 │    │
+│  │  ┌─────────────────────────────────────────────────────────────────────────┐   │    │
+│  │  │  Step 3: Validate Compatibility                                         │   │    │
+│  │  │                                                                          │   │    │
+│  │  │  [Validate HookSpec]                                                    │   │    │
+│  │  │                                                                          │   │    │
+│  │  │  ┌──────────────────────────────────────────────────────────────────┐  │   │    │
+│  │  │  │  ValidationResults                                               │  │   │    │
+│  │  │  │                                                                   │  │   │    │
+│  │  │  │  ✓ V1: Valid pool state references                               │  │   │    │
+│  │  │  │  ✓ V2: Unique hook state names                                   │  │   │    │
+│  │  │  │  ✓ V3: Valid callbacks                                           │  │   │    │
+│  │  │  │  ✗ V4: Invalid symbol 'X_invalid' in equation                    │  │   │    │
+│  │  │  │  ✓ V5: Valid Solidity types                                      │  │   │    │
+│  │  │  │  ✓ V6: Writes match hook state                                   │  │   │    │
+│  │  │  └──────────────────────────────────────────────────────────────────┘  │   │    │
+│  │  └─────────────────────────────────────────────────────────────────────────┘   │    │
+│  │                                                                                 │    │
+│  │  ┌─────────────────────────────────────────────────────────────────────────┐   │    │
+│  │  │  Step 4: Submit & Mint License (if validation passes)                   │   │    │
+│  │  │                                                                          │   │    │
+│  │  │  [Submit HookSpec]                                                      │   │    │
+│  │  │                                                                          │   │    │
+│  │  │  Backend Flow:                                                          │   │    │
+│  │  │  1. Upload to IPFS → Get CID                                            │   │    │
+│  │  │  2. Call HookLicenseIssuer.mint(user, CID, metadata)                   │   │    │
+│  │  │  3. Return HookLicense NFT                                              │   │    │
+│  │  │                                                                          │   │    │
+│  │  │  ┌──────────────────────────────────────────────────────────────────┐  │   │    │
+│  │  │  │  SubmissionResult                                                │  │   │    │
+│  │  │  │                                                                   │  │   │    │
+│  │  │  │  ✓ HookSpec uploaded to IPFS                                     │  │   │    │
+│  │  │  │    CID: QmXyz...                                                  │  │   │    │
+│  │  │  │                                                                   │  │   │    │
+│  │  │  │  ✓ HookLicense NFT minted                                        │  │   │    │
+│  │  │  │    Token ID: #42                                                  │  │   │    │
+│  │  │  │    Owner: 0x1234...abcd                                          │  │   │    │
+│  │  │  │                                                                   │  │   │    │
+│  │  │  │  [View on OpenSea] [View on IPFS] [Back to Dashboard]            │  │   │    │
+│  │  │  └──────────────────────────────────────────────────────────────────┘  │   │    │
+│  │  └─────────────────────────────────────────────────────────────────────────┘   │    │
+│  └────────────────────────────────────────────────────────────────────────────────┘    │
+│                                                                                          │
+└─────────────────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 2. Frontend Routes
+
+| Route | Component | Description |
+|-------|-----------|-------------|
+| `/hook-developer` | `HookDeveloperDashboard` | Main dashboard with stats and hook list |
+| `/hook-developer/create` | `CreateHookPage` | Create new hook flow |
+| `/hook-developer/hooks/:tokenId` | `HookDetailPage` | View specific hook details |
+| `/hook-developer/hooks/:tokenId/edit` | `EditHookPage` | Edit hook metadata |
+
+---
+
+## 3. Frontend Components
+
+### 3.1 Component Hierarchy
+
+```
+CreateHookPage
+├── StateSpaceModelViewer (Step 1)
+│   ├── StateVariableTable
+│   │   ├── LPIndexSection
+│   │   ├── TraderIndexSection
+│   │   └── SharedSection
+│   └── SearchInput
+├── HookSpecEditor (Step 2)
+│   ├── MetadataForm
+│   ├── HookStateForm
+│   ├── SystemFunctionsForm
+│   └── InvariantsForm
+├── ValidationResults (Step 3)
+│   ├── ValidationRuleResult (x6)
+│   └── ErrorDetails
+└── SubmissionFlow (Step 4)
+    ├── IPFSUploadStatus
+    ├── MintTransaction
+    └── SubmissionResult
+```
+
+### 3.2 Component Specifications
+
+#### StateSpaceModelViewer
+
+```typescript
+// components/hook/StateSpaceModelViewer.tsx
+
+interface StateVariable {
+  name: string;
+  symbol: string;
+  type: string;
+  getter: string;
+  description: string;
+}
+
+interface StateSpaceModel {
+  version: string;
+  ipfsCid: string;
+  lpIndex: StateVariable[];
+  traderIndex: StateVariable[];
+  shared: StateVariable[];
+}
+
+interface StateSpaceModelViewerProps {
+  model: StateSpaceModel;
+  onSelectVariable?: (variable: StateVariable) => void;
+}
+
+// Features:
+// - Collapsible sections for each index
+// - Search/filter by name, symbol, or type
+// - Copy-to-clipboard for symbols
+// - Tooltip with full description
+// - Link to IStateView source code
+```
+
+#### HookSpecEditor
+
+```typescript
+// components/hook/HookSpecEditor.tsx
+
+interface HookSpecEditorProps {
+  initialSpec?: HookSpec;
+  stateSpaceModel: StateSpaceModel;
+  onChange: (spec: HookSpec) => void;
+  onValidate: () => void;
+}
+
+// Features:
+// - Monaco editor or CodeMirror for YAML editing
+// - Syntax highlighting
+// - Auto-complete for state variable names
+// - Real-time schema validation
+// - Upload from file option
+// - Template selection
+```
+
+#### ValidationResults
+
+```typescript
+// components/hook/ValidationResults.tsx
+
+interface ValidationResult {
+  ruleId: string;
+  ruleName: string;
+  passed: boolean;
+  errors: string[];
+  warnings: string[];
+}
+
+interface ValidationResultsProps {
+  results: ValidationResult[];
+  isLoading: boolean;
+  onFixError?: (ruleId: string, errorIndex: number) => void;
+}
+
+// Features:
+// - Visual pass/fail indicator for each rule
+// - Expandable error details
+// - Link to relevant spec section
+// - Fix suggestions where possible
+```
+
+#### SubmissionFlow
+
+```typescript
+// components/hook/SubmissionFlow.tsx
+
+interface SubmissionFlowProps {
+  hookSpec: HookSpec;
+  validationPassed: boolean;
+  onSubmit: () => Promise<SubmissionResult>;
+}
+
+interface SubmissionResult {
+  ipfsCid: string;
+  tokenId: number;
+  transactionHash: string;
+  ownerAddress: string;
+}
+
+// Features:
+// - Step-by-step progress indicator
+// - IPFS upload progress
+// - Transaction confirmation
+// - Success/error states
+// - Links to OpenSea, IPFS, Etherscan
+```
+
+---
+
+## 4. API Endpoints
+
+### 4.1 Frontend → Backend API
+
+| Method | Endpoint | Request | Response | Description |
+|--------|----------|---------|----------|-------------|
+| `GET` | `/api/state-space-model` | - | `StateSpaceModel` | Get current system state model |
+| `POST` | `/api/hookspec/validate` | `HookSpec` | `ValidationResult[]` | Validate a HookSpec |
+| `POST` | `/api/hookspec/submit` | `{ spec: HookSpec, signature: string }` | `SubmissionResult` | Submit spec, upload to IPFS, mint NFT |
+| `GET` | `/api/hooks` | `?owner=0x...` | `HookLicense[]` | List user's hook licenses |
+| `GET` | `/api/hooks/:tokenId` | - | `HookLicenseDetail` | Get hook license details |
+
+### 4.2 API Type Definitions
+
+```typescript
+// types/api.ts
+
+// GET /api/state-space-model
+interface StateSpaceModelResponse {
+  version: string;
+  ipfsCid: string;
+  uniswapVersion: string;
+  updatedAt: string;
+  indices: {
+    lp: StateVariable[];
+    trader: StateVariable[];
+    shared: StateVariable[];
+  };
+}
+
+// POST /api/hookspec/validate
+interface ValidateHookSpecRequest {
+  spec: HookSpec;
+}
+
+interface ValidateHookSpecResponse {
+  valid: boolean;
+  results: ValidationResult[];
+  errors: string[];
+  warnings: string[];
+}
+
+// POST /api/hookspec/submit
+interface SubmitHookSpecRequest {
+  spec: HookSpec;
+  signature: string;  // EIP-712 signature from wallet
+  royaltyBps?: number; // Royalty percentage (default: 500 = 5%)
+}
+
+interface SubmitHookSpecResponse {
+  success: boolean;
+  ipfsCid: string;
+  tokenId: number;
+  transactionHash: string;
+  ownerAddress: string;
+  openSeaUrl?: string;
+  ipfsGatewayUrl: string;
+}
+
+// GET /api/hooks
+interface ListHooksRequest {
+  owner?: string;
+  page?: number;
+  limit?: number;
+}
+
+interface ListHooksResponse {
+  hooks: HookLicenseSummary[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+interface HookLicenseSummary {
+  tokenId: number;
+  name: string;
+  version: string;
+  ipfsCid: string;
+  deprecated: boolean;
+  registeredAt: string;
+}
+
+// GET /api/hooks/:tokenId
+interface HookLicenseDetailResponse {
+  tokenId: number;
+  owner: string;
+  metadata: {
+    name: string;
+    version: string;
+    description?: string;
+    developer: string;
+    registeredAt: string;
+    deprecated: boolean;
+  };
+  ipfsCid: string;
+  ipfsGatewayUrl: string;
+  spec: HookSpec;  // Full spec content
+  attestations?: AttestationInfo[];
+  deployments?: DeploymentInfo[];
+}
+```
+
+---
+
+## 5. Backend Services
+
+### 5.1 Service Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                           BACKEND SERVICES                                   │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ┌─────────────────────────────────────────────────────────────────────┐    │
+│  │                        API Gateway                                   │    │
+│  │                    (Express / Fastify)                               │    │
+│  └───────────────────────────┬─────────────────────────────────────────┘    │
+│                              │                                               │
+│         ┌────────────────────┼────────────────────┐                         │
+│         │                    │                    │                         │
+│         ▼                    ▼                    ▼                         │
+│  ┌─────────────┐    ┌─────────────────┐   ┌─────────────────┐              │
+│  │ StateSpace  │    │  Validation     │   │ HookLicense     │              │
+│  │ Service     │    │  Service        │   │ Issuer          │              │
+│  └──────┬──────┘    └────────┬────────┘   └────────┬────────┘              │
+│         │                    │                     │                        │
+│         │                    │                     │                        │
+│         ▼                    ▼                     ▼                        │
+│  ┌─────────────┐    ┌─────────────────┐   ┌─────────────────┐              │
+│  │   IPFS      │    │   IPFS          │   │   Blockchain    │              │
+│  │   Gateway   │    │   (fetch spec)  │   │   (mint NFT)    │              │
+│  └─────────────┘    └─────────────────┘   └─────────────────┘              │
+│                                                                              │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 5.2 HookLicenseIssuer Service
+
+```typescript
+// services/HookLicenseIssuer.ts
+
+interface HookLicenseIssuerConfig {
+  contractAddress: string;
+  ipfsProvider: 'pinata' | 'infura' | 'web3storage';
+  ipfsApiKey: string;
+  ipfsGatewayUrl: string;
+  rpcUrl: string;
+  signerPrivateKey: string;  // Backend signer with MINTER_ROLE
+}
+
+interface MintRequest {
+  developer: string;          // User's address (receives NFT)
+  spec: HookSpec;             // Validated HookSpec
+  signature: string;          // User's EIP-712 signature
+  royaltyBps?: number;
+}
+
+interface MintResult {
+  success: boolean;
+  tokenId: number;
+  ipfsCid: string;
+  transactionHash: string;
+  error?: string;
+}
+
+class HookLicenseIssuer {
+  constructor(config: HookLicenseIssuerConfig);
+
+  /**
+   * Issue a new HookLicense NFT
+   *
+   * Flow:
+   * 1. Verify user signature
+   * 2. Validate HookSpec (double-check)
+   * 3. Package and upload to IPFS
+   * 4. Call HookLicense.mint() on-chain
+   * 5. Return result with tokenId and CID
+   */
+  async issueHookLicense(request: MintRequest): Promise<MintResult>;
+
+  /**
+   * Upload HookSpec to IPFS
+   */
+  async uploadToIPFS(spec: HookSpec, developer: string): Promise<string>;
+
+  /**
+   * Mint NFT on-chain
+   */
+  async mintNFT(
+    developer: string,
+    ipfsCid: string,
+    name: string,
+    version: string,
+    royaltyBps: number
+  ): Promise<{ tokenId: number; transactionHash: string }>;
+
+  /**
+   * Verify EIP-712 signature
+   */
+  verifySignature(spec: HookSpec, signature: string, expectedSigner: string): boolean;
+}
+```
+
+### 5.3 EIP-712 Signature Schema
+
+```typescript
+// For user to sign before submission
+const HOOKSPEC_TYPEHASH = {
+  HookSpecSubmission: [
+    { name: 'name', type: 'string' },
+    { name: 'version', type: 'string' },
+    { name: 'specHash', type: 'bytes32' },  // keccak256(JSON.stringify(spec))
+    { name: 'developer', type: 'address' },
+    { name: 'nonce', type: 'uint256' },
+    { name: 'deadline', type: 'uint256' },
+  ],
+};
+
+const domain = {
+  name: 'HookBazaar',
+  version: '1',
+  chainId: 1,  // or appropriate chain
+  verifyingContract: HOOK_LICENSE_CONTRACT_ADDRESS,
+};
+```
+
+---
+
+## 6. Implementation Files
+
+### 6.1 File Structure
+
+```
+client2/src/
+├── components/
+│   └── hook/
+│       ├── CreateHookPage.tsx           # Main create hook flow
+│       ├── StateSpaceModelViewer.tsx    # Read-only state model viewer
+│       ├── HookSpecEditor.tsx           # YAML/JSON editor for specs
+│       ├── ValidationResults.tsx        # Validation results display
+│       ├── SubmissionFlow.tsx           # Submit, IPFS, mint flow
+│       ├── HookDetailPage.tsx           # View single hook details
+│       └── HookCard.tsx                 # Hook list item component
+├── hooks/
+│   ├── useStateSpaceModel.ts            # Fetch state space model
+│   ├── useValidateHookSpec.ts           # Validate hook spec
+│   ├── useSubmitHookSpec.ts             # Submit and mint
+│   └── useHookLicenses.ts               # List user's hooks
+├── lib/
+│   └── api/
+│       ├── hookApi.ts                   # API client for hooks
+│       └── types.ts                     # API type definitions
+└── types/
+    └── hookSpec.ts                      # HookSpec type definitions
+```
+
+---
+
+## 7. State Management
+
+### 7.1 Create Hook Flow State
+
+```typescript
+// hooks/useCreateHookFlow.ts
+
+interface CreateHookState {
+  step: 'view-model' | 'edit-spec' | 'validate' | 'submit' | 'complete';
+  stateSpaceModel: StateSpaceModel | null;
+  hookSpec: HookSpec | null;
+  validationResults: ValidationResult[] | null;
+  submissionResult: SubmissionResult | null;
+  error: string | null;
+  isLoading: boolean;
+}
+
+type CreateHookAction =
+  | { type: 'LOAD_STATE_MODEL'; payload: StateSpaceModel }
+  | { type: 'UPDATE_SPEC'; payload: HookSpec }
+  | { type: 'VALIDATE_START' }
+  | { type: 'VALIDATE_SUCCESS'; payload: ValidationResult[] }
+  | { type: 'VALIDATE_ERROR'; payload: string }
+  | { type: 'SUBMIT_START' }
+  | { type: 'SUBMIT_SUCCESS'; payload: SubmissionResult }
+  | { type: 'SUBMIT_ERROR'; payload: string }
+  | { type: 'RESET' };
+
+function useCreateHookFlow() {
+  const [state, dispatch] = useReducer(createHookReducer, initialState);
+
+  // Actions
+  const loadStateModel = async () => { ... };
+  const updateSpec = (spec: HookSpec) => { ... };
+  const validateSpec = async () => { ... };
+  const submitSpec = async (signature: string) => { ... };
+  const reset = () => { ... };
+
+  return { state, loadStateModel, updateSpec, validateSpec, submitSpec, reset };
+}
+```
+
+---
+
+## 8. Wallet Integration
+
+### 8.1 Required Wallet Actions
+
+| Action | Method | When |
+|--------|--------|------|
+| Connect Wallet | `connect()` | On page load or "Connect" button |
+| Sign Message | `signTypedData()` | Before submitting HookSpec |
+| View Transaction | - | After mint transaction |
+
+### 8.2 Signature Flow
+
+```typescript
+// hooks/useSignHookSpec.ts
+
+async function signHookSpec(
+  spec: HookSpec,
+  walletClient: WalletClient
+): Promise<string> {
+  const specHash = keccak256(
+    toBytes(JSON.stringify(spec))
+  );
+
+  const nonce = await getNonce(walletClient.account.address);
+  const deadline = Math.floor(Date.now() / 1000) + 3600; // 1 hour
+
+  const signature = await walletClient.signTypedData({
+    domain,
+    types: HOOKSPEC_TYPEHASH,
+    primaryType: 'HookSpecSubmission',
+    message: {
+      name: spec.metadata.name,
+      version: spec.metadata.version,
+      specHash,
+      developer: walletClient.account.address,
+      nonce,
+      deadline,
+    },
+  });
+
+  return signature;
+}
+```
+
+---
+
+## 9. Error Handling
+
+### 9.1 Error Types
+
+```typescript
+// types/errors.ts
+
+enum HookErrorCode {
+  // Validation errors
+  INVALID_SPEC_FORMAT = 'INVALID_SPEC_FORMAT',
+  INVALID_STATE_REFERENCE = 'INVALID_STATE_REFERENCE',
+  INVALID_CALLBACK = 'INVALID_CALLBACK',
+  INVALID_TYPE = 'INVALID_TYPE',
+  DUPLICATE_STATE_NAME = 'DUPLICATE_STATE_NAME',
+  INVALID_EQUATION = 'INVALID_EQUATION',
+
+  // Submission errors
+  IPFS_UPLOAD_FAILED = 'IPFS_UPLOAD_FAILED',
+  SIGNATURE_INVALID = 'SIGNATURE_INVALID',
+  MINT_FAILED = 'MINT_FAILED',
+  CID_ALREADY_REGISTERED = 'CID_ALREADY_REGISTERED',
+
+  // Network errors
+  NETWORK_ERROR = 'NETWORK_ERROR',
+  CONTRACT_ERROR = 'CONTRACT_ERROR',
+}
+
+interface HookError {
+  code: HookErrorCode;
+  message: string;
+  details?: Record<string, unknown>;
+}
+```
+
+---
+
+## 10. Testing Strategy
+
+### 10.1 Unit Tests
+
+- StateSpaceModelViewer: renders all sections, search works
+- HookSpecEditor: updates state on change, validates schema
+- ValidationResults: displays pass/fail correctly
+- SubmissionFlow: handles all states
+
+### 10.2 Integration Tests
+
+- Full create flow: view model → edit spec → validate → submit
+- API mocking for backend calls
+- Wallet signature mocking
+
+### 10.3 E2E Tests
+
+- Connect wallet → create hook → verify NFT minted
+- Invalid spec rejection flow
+- Network error handling
+
+---
+
+## 11. Next Steps
+
+1. **Create component files** in `client2/src/components/hook/`
+2. **Add routes** to `App.tsx`
+3. **Implement hooks** for API calls
+4. **Set up backend API** endpoints
+5. **Deploy HookLicense contract** to testnet
+6. **Integrate IPFS provider**
diff --git a/docs/hook-pkg/mathematical-models/state-space-model.md b/docs/hook-pkg/mathematical-models/state-space-model.md
new file mode 100644
index 000000000..92ca177c0
--- /dev/null
+++ b/docs/hook-pkg/mathematical-models/state-space-model.md
@@ -0,0 +1,702 @@
+# Hook State-Space Model: Dual-Index Architecture
+
+> **Status:** Research Foundation
+> **Last Updated:** 2025-12-09
+> **References:** [arXiv:2512.06203](https://arxiv.org/abs/2512.06203), [arXiv:2103.12732](https://arxiv.org/abs/2103.12732), [arXiv:2103.00540](https://arxiv.org/abs/2103.00540)
+
+## 1. Overview
+
+This document formalizes the state-space model for Uniswap V4 hooks using a **dual-index architecture** that separates state variables by primary user interaction patterns:
+
+- **LP Index ($\mathcal{S}_{LP}$)**: State accessed/modified by liquidity providers
+- **Trader Index ($\mathcal{S}_T$)**: State accessed/modified by traders/swappers
+
+This partitioning enables:
+1. Efficient state queries per user type
+2. Clear hook callback → state mapping
+3. Formal verification of hook invariants
+4. Gas-optimized storage patterns
+
+---
+
+## 2. State Vector Definitions
+
+### 2.1 Complete Pool State
+
+Following [Tranquilli & Gupta, 2025](https://arxiv.org/abs/2512.06203), Definition 1:
+
+```
+Pool Configuration: cfg = (ic, X, Y, Lact, L, Fx, Fy)
+```
+
+We decompose this into three partitions:
+
+$$
+\mathcal{S} = \mathcal{S}_{LP} \times \mathcal{S}_T \times \mathcal{S}_{shared}
+$$
+
+### 2.2 LP State Index ($\mathcal{S}_{LP}$)
+
+Variables primarily accessed by liquidity providers:
+
+| Variable | Type | Description | IStateView Getter |
+|----------|------|-------------|-------------------|
+| $L_k$ | `uint128` | Position liquidity | `getPositionLiquidity()` |
+| $t_l^k$ | `int24` | Lower tick bound | `getPositionInfo()` |
+| $t_u^k$ | `int24` | Upper tick bound | `getPositionInfo()` |
+| $f_{0,k}^{in}$ | `uint256` | Fee growth inside (token0) | `getPositionInfo()` |
+| $f_{1,k}^{in}$ | `uint256` | Fee growth inside (token1) | `getPositionInfo()` |
+| $L_g^{tick}$ | `uint128` | Gross liquidity at tick | `getTickLiquidity()` |
+| $L_n^{tick}$ | `int128` | Net liquidity at tick | `getTickLiquidity()` |
+| $f_0^{out,tick}$ | `uint256` | Fee growth outside (token0) | `getTickFeeGrowthOutside()` |
+| $f_1^{out,tick}$ | `uint256` | Fee growth outside (token1) | `getTickFeeGrowthOutside()` |
+
+**Formal Definition:**
+
+$$
+\mathcal{S}_{LP} = \bigcup_{k \in \mathcal{I}} \{(L_k, t_l^k, t_u^k, f_{0,k}^{in}, f_{1,k}^{in})\} \cup \bigcup_{i \in \text{Tick}} \{(L_g^i, L_n^i, f_0^{out,i}, f_1^{out,i})\}
+$$
+
+**Solidity Struct Mapping:**
+
+```solidity
+/// @notice LP-indexed state for a position
+/// @dev Maps to IStateView.getPositionInfo()
+struct LPPositionState {
+    uint128 liquidity;        // L_k
+    int24 tickLower;          // t_l^k
+    int24 tickUpper;          // t_u^k
+    uint256 feeGrowthInside0; // f_{0,k}^{in}
+    uint256 feeGrowthInside1; // f_{1,k}^{in}
+}
+
+/// @notice LP-indexed state for a tick
+/// @dev Maps to IStateView.getTickInfo()
+struct LPTickState {
+    uint128 liquidityGross;      // L_g^{tick}
+    int128 liquidityNet;         // L_n^{tick}
+    uint256 feeGrowthOutside0;   // f_0^{out,tick}
+    uint256 feeGrowthOutside1;   // f_1^{out,tick}
+}
+```
+
+### 2.3 Trader State Index ($\mathcal{S}_T$)
+
+Variables primarily accessed by traders during swaps:
+
+| Variable | Type | Description | IStateView Getter |
+|----------|------|-------------|-------------------|
+| $\sqrt{P}$ | `uint160` | Current sqrt price (Q64.96) | `getSlot0()` |
+| $t_c$ | `int24` | Current tick | `getSlot0()` |
+| $\phi_{lp}$ | `uint24` | LP fee (swap fee) | `getSlot0()` |
+| $\phi_{proto}$ | `uint24` | Protocol fee | `getSlot0()` |
+| $L_{act}$ | `uint128` | Active liquidity | `getLiquidity()` |
+| $B_{tick}$ | `uint256` | Tick bitmap | `getTickBitmap()` |
+
+**Formal Definition:**
+
+$$
+\mathcal{S}_T = (\sqrt{P}, t_c, \phi_{lp}, \phi_{proto}, L_{act}, B_{tick})
+$$
+
+**Solidity Struct Mapping:**
+
+```solidity
+/// @notice Trader-indexed state (Slot0 + active liquidity)
+/// @dev Maps to IStateView.getSlot0() and getLiquidity()
+struct TraderState {
+    uint160 sqrtPriceX96;  // sqrt(P) in Q64.96
+    int24 tick;            // t_c - current tick
+    uint24 lpFee;          // phi_lp - fee paid to LPs
+    uint24 protocolFee;    // phi_proto - protocol fee
+    uint128 liquidity;     // L_act - active liquidity for swaps
+}
+
+/// @notice Extended trader state with routing info
+struct TraderStateExtended {
+    TraderState core;
+    uint256 tickBitmap;    // B_tick - for finding next initialized tick
+}
+```
+
+### 2.4 Shared State ($\mathcal{S}_{shared}$)
+
+Variables accessed by both LPs and traders:
+
+| Variable | Type | Description | IStateView Getter |
+|----------|------|-------------|-------------------|
+| $f_0^{global}$ | `uint256` | Global fee growth (token0) | `getFeeGrowthGlobals()` |
+| $f_1^{global}$ | `uint256` | Global fee growth (token1) | `getFeeGrowthGlobals()` |
+
+**Formal Definition:**
+
+$$
+\mathcal{S}_{shared} = (f_0^{global}, f_1^{global})
+$$
+
+**Derived Invariant** (from [arXiv:2512.06203](https://arxiv.org/abs/2512.06203), Definition 2):
+
+$$
+K_i(X, Y, L_{act}) := X \cdot Y
+$$
+
+Where $X, Y$ are virtual reserves computed from $L_{act}$ and $\sqrt{P}$.
+
+---
+
+## 3. State Transition System
+
+### 3.1 Transition Types
+
+Following [Tranquilli & Gupta, 2025](https://arxiv.org/abs/2512.06203), Section III-B:
+
+```
+Transitions := SWAP(δ) | MINT(k, ...) | BURN(k) | CROSS(±)
+```
+
+### 3.2 Hook Callback → State Mapping
+
+| Hook Callback | Transition Type | Primary Index | Secondary Index | State Changes |
+|---------------|-----------------|---------------|-----------------|---------------|
+| `beforeSwap` | SWAP | $\mathcal{S}_T$ | read $\mathcal{S}_{LP}$ | May modify fee, block swap |
+| `afterSwap` | SWAP | $\mathcal{S}_T$, $\mathcal{S}_{shared}$ | - | Fee accounting, delta modifications |
+| `beforeAddLiquidity` | MINT | $\mathcal{S}_{LP}$ | - | Validation, custom accounting |
+| `afterAddLiquidity` | MINT | $\mathcal{S}_{LP}$ | $\mathcal{S}_T$ ($L_{act}$) | Position creation, liquidity update |
+| `beforeRemoveLiquidity` | BURN | $\mathcal{S}_{LP}$ | - | Validation, lock checks |
+| `afterRemoveLiquidity` | BURN | $\mathcal{S}_{LP}$ | $\mathcal{S}_T$ ($L_{act}$) | Position removal, fee collection |
+| `beforeDonate` | - | $\mathcal{S}_{shared}$ | - | Custom donation logic |
+| `afterDonate` | - | $\mathcal{S}_{shared}$ | - | Fee distribution |
+
+### 3.3 Formal Transition Rules
+
+**SWAP Transition (within tick):**
+
+From [arXiv:2512.06203](https://arxiv.org/abs/2512.06203), Section III-B:
+
+```
+Given cfg with tick ic and Lact > 0:
+
+X' = X + δx
+Y' = Y - ⌊φ(δx, Lact, ic)⌋
+ic' = ic
+Lact' = Lact
+```
+
+**Solidity Implementation Pattern:**
+
+```solidity
+/// @notice State changes for a swap within a single tick
+/// @dev Implements the discretized constant-product update
+/// @param state Current trader state
+/// @param deltaX Input amount of token0
+/// @return newState Updated trader state
+/// @return deltaY Output amount of token1
+function applySwapTransition(
+    TraderState memory state,
+    int256 deltaX
+) internal pure returns (TraderState memory newState, int256 deltaY) {
+    // K = X * Y (virtual reserves from L and sqrtP)
+    // X' = X + δx
+    // Y' = ⌊K / X'⌋
+
+    uint160 sqrtPriceNext = SqrtPriceMath.getNextSqrtPriceFromInput(
+        state.sqrtPriceX96,
+        state.liquidity,
+        uint256(deltaX),
+        true // zeroForOne
+    );
+
+    newState = TraderState({
+        sqrtPriceX96: sqrtPriceNext,
+        tick: TickMath.getTickAtSqrtPrice(sqrtPriceNext),
+        lpFee: state.lpFee,
+        protocolFee: state.protocolFee,
+        liquidity: state.liquidity
+    });
+
+    deltaY = SqrtPriceMath.getAmount1Delta(
+        state.sqrtPriceX96,
+        sqrtPriceNext,
+        state.liquidity,
+        false // roundUp
+    );
+}
+```
+
+**CROSS Transition (tick crossing):**
+
+```
+If swap drives price to P_{ic+1}:
+
+ic' = ic + 1
+Lact' = Lact + ΔL_{ic+1}
+X' = X  (unchanged)
+Y' = Y  (unchanged)
+```
+
+**Solidity Implementation Pattern:**
+
+```solidity
+/// @notice State changes when crossing a tick boundary
+/// @dev Updates active liquidity based on net liquidity at tick
+/// @param state Current trader state
+/// @param tickNext The tick being crossed into
+/// @param liquidityNet Net liquidity change at the tick boundary
+/// @return newState Updated trader state
+function applyTickCrossTransition(
+    TraderState memory state,
+    int24 tickNext,
+    int128 liquidityNet
+) internal pure returns (TraderState memory newState) {
+    // Lact' = Lact + ΔL_{tick}
+    // Sign depends on direction: add when crossing up, subtract when crossing down
+
+    bool crossingUp = tickNext > state.tick;
+    int128 liquidityDelta = crossingUp ? liquidityNet : -liquidityNet;
+
+    newState = TraderState({
+        sqrtPriceX96: TickMath.getSqrtPriceAtTick(tickNext),
+        tick: tickNext,
+        lpFee: state.lpFee,
+        protocolFee: state.protocolFee,
+        liquidity: LiquidityMath.addDelta(state.liquidity, liquidityDelta)
+    });
+}
+```
+
+---
+
+## 4. Invariant Properties
+
+### 4.1 Tick-wise Constant Product Invariant
+
+From [arXiv:2512.06203](https://arxiv.org/abs/2512.06203), Lemma 1:
+
+**Single-Swap Bound:**
+
+$$
+K - X' \leq K' \leq K
+$$
+
+Where $K = X \cdot Y$ and $K' = X' \cdot Y'$.
+
+**Multi-Swap Bound (Theorem 1):**
+
+For a sequence of $n$ swaps with $X_j \leq B$ at each step:
+
+$$
+|K_n - K_0| \leq n \cdot B
+$$
+
+**Solidity Invariant Check:**
+
+```solidity
+/// @notice Verifies the constant product invariant holds within epsilon
+/// @dev Based on arXiv:2512.06203 Theorem 1
+/// @param k0 Initial product K = X * Y
+/// @param kN Final product after n swaps
+/// @param n Number of swaps executed
+/// @param maxReserve Maximum reserve bound B
+/// @return valid True if invariant holds
+function checkProductInvariant(
+    uint256 k0,
+    uint256 kN,
+    uint256 n,
+    uint256 maxReserve
+) internal pure returns (bool valid) {
+    // |K_n - K_0| <= n * B
+    uint256 epsilon = n * maxReserve;
+
+    if (kN <= k0) {
+        return (k0 - kN) <= epsilon;
+    } else {
+        // K should never increase (rounding always reduces)
+        return false;
+    }
+}
+```
+
+### 4.2 Cross-Tick k-Invariance
+
+From [arXiv:2512.06203](https://arxiv.org/abs/2512.06203), Definition 3:
+
+A CLAMM satisfies **cross-tick k-invariance** if:
+
+$$
+|K_{i_c}(X, Y, L_{act}) - k| \leq \epsilon
+$$
+
+for all reachable configurations and some constant $k$, $\epsilon \geq 0$.
+
+### 4.3 LP State Consistency Invariants
+
+```solidity
+/// @notice Invariants that must hold for LP state consistency
+interface ILPStateInvariants {
+    /// @dev Sum of position liquidities in range equals active liquidity
+    /// Σ L_k (where t_l^k <= t_c < t_u^k) == L_act
+    function invariantActiveLiquiditySum(PoolId poolId) external view returns (bool);
+
+    /// @dev Gross liquidity at tick equals sum of all positions touching that tick
+    /// L_g^{tick} == Σ L_k (where t_l^k == tick OR t_u^k == tick)
+    function invariantGrossLiquiditySum(PoolId poolId, int24 tick) external view returns (bool);
+
+    /// @dev Fee growth inside is bounded by global fee growth
+    /// f_{0,k}^{in} <= f_0^{global} for all positions k
+    function invariantFeeGrowthBounded(PoolId poolId, bytes32 positionId) external view returns (bool);
+}
+```
+
+---
+
+## 5. Hook State View Interface
+
+### 5.1 Proposed IHookStateView
+
+Extending `IStateView` for hook-specific state:
+
+```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {PoolId} from "@uniswap/v4-core/src/types/PoolId.sol";
+
+/// @title IHookStateView
+/// @notice Interface for querying hook-specific state partitioned by user type
+/// @dev Extends the concept from IStateView with hook state variables
+/// @custom:reference arXiv:2512.06203 - Formal State-Machine Models for Uniswap v3
+interface IHookStateView {
+
+    // ============ LP Index Queries ============
+
+    /// @notice Get LP-relevant state for a specific position
+    /// @param poolId The pool identifier
+    /// @param owner Position owner
+    /// @param tickLower Lower tick bound
+    /// @param tickUpper Upper tick bound
+    /// @param salt Position salt
+    /// @return state The LP position state struct
+    function getLPPositionState(
+        PoolId poolId,
+        address owner,
+        int24 tickLower,
+        int24 tickUpper,
+        bytes32 salt
+    ) external view returns (LPPositionState memory state);
+
+    /// @notice Get LP-relevant state for a tick
+    /// @param poolId The pool identifier
+    /// @param tick The tick index
+    /// @return state The LP tick state struct
+    function getLPTickState(
+        PoolId poolId,
+        int24 tick
+    ) external view returns (LPTickState memory state);
+
+    /// @notice Batch query LP states for multiple positions
+    /// @param poolId The pool identifier
+    /// @param positionIds Array of position identifiers
+    /// @return states Array of LP position states
+    function batchGetLPPositionStates(
+        PoolId poolId,
+        bytes32[] calldata positionIds
+    ) external view returns (LPPositionState[] memory states);
+
+    // ============ Trader Index Queries ============
+
+    /// @notice Get all trader-relevant state in a single call
+    /// @param poolId The pool identifier
+    /// @return state The trader state struct
+    function getTraderState(
+        PoolId poolId
+    ) external view returns (TraderState memory state);
+
+    /// @notice Get extended trader state including routing info
+    /// @param poolId The pool identifier
+    /// @param tickBitmapIndex The word position in tick bitmap
+    /// @return state The extended trader state struct
+    function getTraderStateExtended(
+        PoolId poolId,
+        int16 tickBitmapIndex
+    ) external view returns (TraderStateExtended memory state);
+
+    // ============ Shared State Queries ============
+
+    /// @notice Get global fee growth state
+    /// @param poolId The pool identifier
+    /// @return feeGrowthGlobal0 Global fee growth for token0
+    /// @return feeGrowthGlobal1 Global fee growth for token1
+    function getSharedFeeState(
+        PoolId poolId
+    ) external view returns (uint256 feeGrowthGlobal0, uint256 feeGrowthGlobal1);
+
+    // ============ Hook-Specific State ============
+
+    /// @notice Get hook-specific state variables
+    /// @dev H in the notation (f_{it}(H, P))
+    /// @param poolId The pool identifier
+    /// @return hookState Encoded hook state
+    function getHookState(
+        PoolId poolId
+    ) external view returns (bytes memory hookState);
+
+    /// @notice Get hook state for a specific position
+    /// @param poolId The pool identifier
+    /// @param positionId The position identifier
+    /// @return hookPositionState Encoded hook state for position
+    function getHookPositionState(
+        PoolId poolId,
+        bytes32 positionId
+    ) external view returns (bytes memory hookPositionState);
+}
+
+/// @notice LP-indexed state for a position
+struct LPPositionState {
+    uint128 liquidity;
+    int24 tickLower;
+    int24 tickUpper;
+    uint256 feeGrowthInside0LastX128;
+    uint256 feeGrowthInside1LastX128;
+}
+
+/// @notice LP-indexed state for a tick
+struct LPTickState {
+    uint128 liquidityGross;
+    int128 liquidityNet;
+    uint256 feeGrowthOutside0X128;
+    uint256 feeGrowthOutside1X128;
+}
+
+/// @notice Trader-indexed state
+struct TraderState {
+    uint160 sqrtPriceX96;
+    int24 tick;
+    uint24 lpFee;
+    uint24 protocolFee;
+    uint128 liquidity;
+}
+
+/// @notice Extended trader state with routing info
+struct TraderStateExtended {
+    TraderState core;
+    uint256 tickBitmap;
+}
+```
+
+---
+
+## 6. Hook Specification Framework
+
+### 6.1 Hook as Dynamic System
+
+From the project notes, a hook is specified as:
+
+$$
+(f_{it}(H, P))_{i=1}^{N}
+$$
+
+Where:
+- $f_i$ is the $i$-th hook callback function
+- $H$ is the hook state (exposed via `IHookStateView.getHookState()`)
+- $P$ is the pool state ($\mathcal{S}_{LP} \cup \mathcal{S}_T \cup \mathcal{S}_{shared}$)
+- $N$ is the number of implemented callbacks
+
+### 6.2 Hook Specification Interface
+
+```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {PoolId} from "@uniswap/v4-core/src/types/PoolId.sol";
+
+/// @title IHookSpecification
+/// @notice Interface for declaring hook behavior as a formal specification
+/// @dev Enables verification and attestation without code disclosure
+/// @custom:reference Project NOTES.md - Hook specification framework
+interface IHookSpecification {
+
+    /// @notice Declares which state variables the hook reads
+    /// @return lpStateVars Bitmask of LP state variables accessed
+    /// @return traderStateVars Bitmask of trader state variables accessed
+    /// @return sharedStateVars Bitmask of shared state variables accessed
+    function declareStateReads() external pure returns (
+        uint256 lpStateVars,
+        uint256 traderStateVars,
+        uint256 sharedStateVars
+    );
+
+    /// @notice Declares which state variables the hook writes
+    /// @return hookStateVars Bitmask of hook state variables modified
+    function declareStateWrites() external pure returns (uint256 hookStateVars);
+
+    /// @notice Declares invariants the hook maintains
+    /// @return invariantIds Array of invariant identifiers
+    function declareInvariants() external pure returns (bytes32[] memory invariantIds);
+
+    /// @notice Returns the IPFS hash of the formal specification document
+    /// @dev Document contains system of equations in LaTeX/markdown format
+    /// @return specHash IPFS CID of specification document
+    function specificationURI() external pure returns (string memory specHash);
+
+    /// @notice Returns state transition bounds for verification
+    /// @param callback The callback being analyzed
+    /// @return maxStateChange Maximum state change magnitude
+    /// @return affectedVariables Variables potentially modified
+    function transitionBounds(bytes4 callback) external pure returns (
+        uint256 maxStateChange,
+        bytes32[] memory affectedVariables
+    );
+}
+
+/// @notice State variable identifiers for bitmask operations
+library StateVarIds {
+    // LP State Variables (bits 0-31)
+    uint256 constant LP_LIQUIDITY = 1 << 0;
+    uint256 constant LP_TICK_LOWER = 1 << 1;
+    uint256 constant LP_TICK_UPPER = 1 << 2;
+    uint256 constant LP_FEE_GROWTH_INSIDE_0 = 1 << 3;
+    uint256 constant LP_FEE_GROWTH_INSIDE_1 = 1 << 4;
+    uint256 constant LP_LIQUIDITY_GROSS = 1 << 5;
+    uint256 constant LP_LIQUIDITY_NET = 1 << 6;
+    uint256 constant LP_FEE_GROWTH_OUTSIDE_0 = 1 << 7;
+    uint256 constant LP_FEE_GROWTH_OUTSIDE_1 = 1 << 8;
+
+    // Trader State Variables (bits 0-31)
+    uint256 constant TRADER_SQRT_PRICE = 1 << 0;
+    uint256 constant TRADER_TICK = 1 << 1;
+    uint256 constant TRADER_LP_FEE = 1 << 2;
+    uint256 constant TRADER_PROTOCOL_FEE = 1 << 3;
+    uint256 constant TRADER_LIQUIDITY = 1 << 4;
+    uint256 constant TRADER_TICK_BITMAP = 1 << 5;
+
+    // Shared State Variables (bits 0-31)
+    uint256 constant SHARED_FEE_GROWTH_GLOBAL_0 = 1 << 0;
+    uint256 constant SHARED_FEE_GROWTH_GLOBAL_1 = 1 << 1;
+}
+```
+
+---
+
+## 7. Verification Integration
+
+### 7.1 Connecting to EigenLayer AVS
+
+For attestation without code disclosure:
+
+```solidity
+/// @title IHookAttestationAVS
+/// @notice Interface for EigenLayer AVS that verifies hook specifications
+/// @custom:reference EigenLayer middleware contracts
+interface IHookAttestationAVS {
+
+    /// @notice Submit hook specification for verification
+    /// @param hook Address of the hook contract
+    /// @param specURI IPFS URI of formal specification
+    /// @param sampleData Fuzzer-generated test data
+    /// @return attestationId Unique identifier for this attestation request
+    function requestAttestation(
+        address hook,
+        string calldata specURI,
+        bytes calldata sampleData
+    ) external returns (bytes32 attestationId);
+
+    /// @notice Check if a hook has valid attestation
+    /// @param hook Address of the hook contract
+    /// @return isValid True if hook has valid attestation
+    /// @return attestationId The attestation identifier
+    /// @return expiresAt Timestamp when attestation expires
+    function getAttestation(address hook) external view returns (
+        bool isValid,
+        bytes32 attestationId,
+        uint256 expiresAt
+    );
+
+    /// @notice Verify state transition matches specification
+    /// @param hook Address of the hook
+    /// @param preState State before hook execution
+    /// @param postState State after hook execution
+    /// @param callback The callback that was executed
+    /// @return valid True if transition matches spec
+    function verifyTransition(
+        address hook,
+        bytes calldata preState,
+        bytes calldata postState,
+        bytes4 callback
+    ) external view returns (bool valid);
+}
+```
+
+### 7.2 State Sampling for Fuzzer
+
+```solidity
+/// @title IHookStateSampler
+/// @notice Interface for sampling hook state for verification
+/// @dev Used by fuzzer service to collect data for attestation
+interface IHookStateSampler {
+
+    /// @notice Sample current state snapshot
+    /// @param poolId The pool to sample
+    /// @return lpState Encoded LP state
+    /// @return traderState Encoded trader state
+    /// @return hookState Encoded hook-specific state
+    /// @return timestamp Block timestamp of sample
+    function sampleState(PoolId poolId) external view returns (
+        bytes memory lpState,
+        bytes memory traderState,
+        bytes memory hookState,
+        uint256 timestamp
+    );
+
+    /// @notice Sample state transition
+    /// @param poolId The pool
+    /// @param callback The callback to execute
+    /// @param calldata_ The callback parameters
+    /// @return preState State before
+    /// @return postState State after
+    /// @return gasUsed Gas consumed
+    function sampleTransition(
+        PoolId poolId,
+        bytes4 callback,
+        bytes calldata calldata_
+    ) external returns (
+        bytes memory preState,
+        bytes memory postState,
+        uint256 gasUsed
+    );
+}
+```
+
+---
+
+## 8. References
+
+1. **[arXiv:2512.06203]** Tranquilli, J., & Gupta, N. (2025). *Formal State-Machine Models for Uniswap v3 Concentrated-Liquidity AMMs: Priced Timed Automata, Finite-State Transducers, and Provable Rounding Bounds*. https://arxiv.org/abs/2512.06203
+
+2. **[arXiv:2103.12732]** Xu, J., Paruch, K., Cousaert, S., & Feng, Y. (2021). *SoK: Decentralized Exchanges (DEX) with Automated Market Maker (AMM) Protocols*. https://arxiv.org/abs/2103.12732
+
+3. **[arXiv:2103.00540]** Tolmach, P., Li, Y., Lin, S.-W., & Liu, Y. (2021). *Formal Analysis of Composable DeFi Protocols*. https://arxiv.org/abs/2103.00540
+
+4. **[arXiv:2205.08904]** Heimbach, L., Schertenleib, E., & Wattenhofer, R. (2022). *Risks and Returns of Uniswap V3 Liquidity Providers*. https://arxiv.org/abs/2205.08904
+
+5. **[Uniswap V4]** Adams, H. et al. *Uniswap V4 Core*. https://github.com/Uniswap/v4-core
+
+6. **[IStateView]** Uniswap V4 Periphery. `contracts/lib/v4-periphery/src/interfaces/IStateView.sol`
+
+---
+
+## 9. Appendix: State Variable Quick Reference
+
+### IStateView → Dual Index Mapping
+
+| IStateView Method | Returns | LP Index | Trader Index | Shared |
+|-------------------|---------|:--------:|:------------:|:------:|
+| `getSlot0()` | sqrtPriceX96, tick, protocolFee, lpFee | | X | |
+| `getTickInfo()` | liquidityGross, liquidityNet, feeGrowthOutside0, feeGrowthOutside1 | X | | |
+| `getTickLiquidity()` | liquidityGross, liquidityNet | X | | |
+| `getTickFeeGrowthOutside()` | feeGrowthOutside0, feeGrowthOutside1 | X | | |
+| `getFeeGrowthGlobals()` | feeGrowthGlobal0, feeGrowthGlobal1 | | | X |
+| `getLiquidity()` | liquidity | | X | |
+| `getTickBitmap()` | tickBitmap | | X | |
+| `getPositionInfo()` | liquidity, feeGrowthInside0, feeGrowthInside1 | X | | |
+| `getPositionLiquidity()` | liquidity | X | | |
+| `getFeeGrowthInside()` | feeGrowthInside0, feeGrowthInside1 | X | | |