deploy: AEGIS Protocol live on Base Sepolia testnet

Deployed all 7 contracts to Base Sepolia (chain 84532):
- AegisEscrow: 0xD5140b684Ea05a9e5fB6090cb89ED53eeE22A42a
- AegisDispute: 0xEA82d5142557CD5B63EFDE17a0a62AC913abE4a0
- AegisTreasury: 0x7977a4F05b2a93738b4aBb2b29328c8d0666FF2A
- AegisJobFactory: 0x9A9821B35D1Cd7fC38f02daEF5BE4B1a77954a29
- MockIdentityRegistry: 0x3365f24bC393e7B8Fd7c05B2B038916D4B043167
- MockReputationRegistry: 0x8f354D60D8f12bf1339DbAC02F84F0bdf292F39D
- MockValidationRegistry: 0x63e89bE524b338c32BFd5752e199362b77F895Ad

Updated SDK types and CLAUDE.md with deployed addresses.
202/202 tests passing, all gas costs viable on Base L2.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: im-sham

CLAUDE.md

@@ -51,6 +51,33 @@ CREATED → CANCELLED (before funding)
 5. **Provider wallet from ERC-8004**: Payments go to `getAgentWallet()`, not msg.sender
 6. **Protocol fee snapshot**: Fee BPS stored per-job at creation time (immune to admin changes mid-job)
 
+## Monorepo Structure
+
+Root `pnpm-workspace.yaml` links: `sdk/`, `sdk/packages/*`, `api/`, `mcp/`
+- SDK: `@aegis-protocol/sdk`, `@aegis-protocol/types`, `@aegis-protocol/abis`
+- API: `@aegis-protocol/api` (Hono relay server)
+- MCP: `@aegis-protocol/mcp-server` (Model Context Protocol server)
+- Subgraph: `subgraph/` (The Graph, AssemblyScript)
+
+## MCP Server (mcp/)
+
+MCP server enabling AI agents to autonomously use AEGIS escrow via the Model Context Protocol.
+- **10 tools**: create_job, deliver_work, check_job, settle_job, open_dispute, claim_refund, lookup_agent, list_jobs, check_balance, get_template
+- **Dual mode**: Read-only (returns unsigned tx calldata) or signing (executes directly with `AEGIS_PRIVATE_KEY`)
+- **Transport**: Stdio (Claude Desktop) — primary
+- **Config env vars**: `AEGIS_CHAIN`, `AEGIS_RPC_URL`, `AEGIS_PRIVATE_KEY` (optional), `AEGIS_API_URL` (optional)
+- **Build/Test**: `cd mcp && pnpm build` / `cd mcp && pnpm test`
+- **LLM-optimized**: Tool descriptions explain *when* to use escrow, not just *how*
+
+## API Package (api/)
+
+Hono HTTP relay server — AI agents interact with AEGIS without importing Web3 SDK.
+- **Read routes**: jobs, disputes, templates, agents (ERC-8004), USDC, treasury
+- **Write route**: POST /tx/relay (accepts pre-signed tx, validates against contract whitelist, broadcasts)
+- **SSE**: GET /events/stream (real-time on-chain events with filters)
+- **Test**: `cd api && npx vitest run` (run from api/ dir, NOT repo root)
+- **Deploy**: Dockerfile + fly.toml (Fly.io, EWR region)
+
 ## Tech Stack
 
 - **Solidity 0.8.24** with optimizer (200 runs)
@@ -94,39 +121,64 @@ forge script script/Deploy.s.sol:DeployAegis \
 - `disputeTTLSeconds`: 7 days
 - `minArbitratorStake`: 1,000 USDC
 
-## Addresses (Base Sepolia)
+## Addresses (Base Sepolia) — Deployed 2026-02-18
+
+| Contract | Address |
+|----------|---------|
+| AegisEscrow | `0xD5140b684Ea05a9e5fB6090cb89ED53eeE22A42a` |
+| AegisDispute | `0xEA82d5142557CD5B63EFDE17a0a62AC913abE4a0` |
+| AegisTreasury | `0x7977a4F05b2a93738b4aBb2b29328c8d0666FF2A` |
+| AegisJobFactory | `0x9A9821B35D1Cd7fC38f02daEF5BE4B1a77954a29` |
+| MockIdentityRegistry | `0x3365f24bC393e7B8Fd7c05B2B038916D4B043167` |
+| MockReputationRegistry | `0x8f354D60D8f12bf1339DbAC02F84F0bdf292F39D` |
+| MockValidationRegistry | `0x63e89bE524b338c32BFd5752e199362b77F895Ad` |
+| USDC | `0x036CbD53842c5426634e7929541eC2318f3dCF7e` |
+| Owner/Admin | `0x31084ba014bC91D467D008e6fb21f827AC6f7eb0` |
 
-- USDC: `0x036CbD53842c5426634e7929541eC2318f3dCF7e`
 - USDC (Base Mainnet): `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
-- ERC-8004 Registries: TBD (need to find/deploy on Base — EIP is 2 weeks old)
 
 ## Implementation Roadmap
 
-### Phase 1: Core Contracts ✅ (CURRENT — code written, needs compile/test)
+### Phase 1: Core Contracts ✅ COMPLETE — Deployed to Base Sepolia 2026-02-18
 - [x] AegisEscrow.sol with full state machine
 - [x] ERC-8004 interface definitions (Identity, Reputation, Validation)
 - [x] AegisTypes.sol shared library
 - [x] AegisTreasury.sol
 - [x] AegisDispute.sol with 3-tier resolution
 - [x] AegisJobFactory.sol with templates
 - [x] Mock ERC-8004 registries for testing
-- [x] Comprehensive test suite (25 tests + fuzz)
+- [x] Comprehensive test suite (202 tests including fuzz — all passing)
 - [x] Deploy script for Base Sepolia
-- [ ] **NEXT: Compile, fix any errors, get all tests passing**
-- [ ] Gas optimization pass
-- [ ] Deploy mocks + AEGIS to Base Sepolia testnet
-
-### Phase 2: SDK & Developer Experience (Weeks 9-12)
-- [ ] TypeScript SDK (`@aegis/sdk`)
-- [ ] Python SDK (`@aegis/python`)
-- [ ] Subgraph (The Graph) for indexing
-- [ ] REST API wrapper
+- [x] Compile clean (zero errors)
+- [x] All 202 tests passing across 5 test suites
+- [x] Gas report reviewed — all functions economically viable on Base L2
+- [x] Deployed mocks + AEGIS to Base Sepolia testnet
+
+### Phase 2: SDK & Developer Experience ✅
+- [x] TypeScript SDK (`@aegis-protocol/sdk`) — PR #1 merged
+- [x] SDK integration tests against Base Sepolia — PR #2 merged
+- [x] SDK DX enhancements — PR #3 merged
+- [x] Subgraph (The Graph) for full event indexing — PR #4 merged
+- [x] REST API relay server — PR #5 merged
+- [ ] Python SDK
 - [ ] Integration examples (AutoGPT, CrewAI, LangChain)
 
+### Phase 2.5: Agent-Native Distribution (Parallel with Phase 2)
+- [x] AEGIS MCP Server (Model Context Protocol) — highest priority agent distribution channel
+  - 10 tools: aegis_create_job, aegis_deliver_work, aegis_check_job, aegis_settle_job, aegis_open_dispute, aegis_claim_refund, aegis_lookup_agent, aegis_list_jobs, aegis_check_balance, aegis_get_template
+  - LLM-optimized tool descriptions (explain *when* to use escrow, not just *how*)
+  - Dual mode: read-only (unsigned tx) or signing (direct execution)
+  - [ ] Test with Claude Desktop, Gemini, GPT
+  - [ ] Publish to MCP registries and npm
+- [ ] A2A Agent Card (`/.well-known/agent-card.json`) — agent discovery via Google A2A protocol
+- [ ] ERC-8004 Identity Registration — register AEGIS as a service agent in the registry
+- [ ] Agent framework integrations: AutoGPT (P0), CrewAI (P0), LangChain (P0), OpenClaw (P1)
+
 ### Phase 3: Mainnet Launch (Weeks 13-16)
-- [ ] Security audit
+- [ ] Security audit (Sherlock competitive audit contest — public, ~1,500 nSLOC)
 - [ ] Base mainnet deployment
 - [ ] Partner integrations
+- [ ] x402 escrow header extension proposal (AEGIS-ESCROW-RECOMMENDED)
 - [ ] ERC extension proposal
 
 ## Competitive Landscape
@@ -140,8 +192,36 @@ Nobody else composes ERC-8004 + x402:
 
 Our moat: every agent that registers with ERC-8004 is a potential AEGIS user. Data flywheel — every settled job generates reputation data that makes the ecosystem smarter.
 
+## Git Worktrees
+
+Worktrees at `.worktrees/<branch-name>` (gitignored). Always verify `.worktrees/` is in `.gitignore`.
+
+## Gotchas
+
+- `workspace:*` deps don't resolve in isolated worktrees — use `vi.mock()` to stub `@aegis-protocol/*` in tests
+- Run vitest from `api/` not repo root (OpenZeppelin test files get picked up otherwise)
+- When dispatching subagents for file creation, use `general-purpose` type (NOT `Bash` — it lacks Write tool)
+- Root `.gitignore` must include `node_modules/`
+
+## Strategic Context
+
+- **GTM Strategy**: Developer-first, standards-native organic growth. See `AEGIS_Strategic_Research_Brief.md` for full execution plan.
+- **Primary distribution channels**: MCP Server (highest priority), A2A Agent Cards, ERC-8004 registry, agent framework integrations
+- **Licensing**: MIT License for all code (contracts, SDK, API, subgraph). Revenue is from protocol fees, not software licensing.
+- **Audit plan**: Sherlock competitive audit contest (public). Start Sherlock AI GitHub integration during development.
+- **Grant targets**: Base Builder Grants (apply at testnet deploy), Base Batches 2026, Ethereum Foundation ESP, x402 Foundation, Optimism RetroPGF
+- **Go-public timing**: Repo goes public at Base Sepolia testnet deployment (scrub git history for secrets first)
+- **Not competitors**: Fomolt (vertical trading app), OpenX402 (complementary payment facilitator). OpenX402 is a potential integration partner.
+
 ## Key Reference Docs
 
 - `docs/ERC-8004-SPEC.md` — Complete ERC-8004 specification notes
 - `docs/ARCHITECTURE.md` — Full architecture decisions and rationale
 - `docs/COMPETITIVE-ANALYSIS.md` — Detailed competitor breakdown
+- `docs/plans/2026-02-17-rest-api-design.md` — REST API architecture
+- `docs/plans/2026-02-17-rest-api-plan.md` — REST API 12-task implementation plan
+- `docs/plans/2026-02-17-subgraph-design.md` — Subgraph design document
+- `docs/plans/2026-02-17-subgraph-plan.md` — Subgraph implementation plan (10 tasks)
+- `AEGIS_Strategic_Research_Brief.md` — Living strategic research document (competitive landscape, GTM, grants, costs)
+- `docs/plans/2026-02-18-python-sdk-design-wip.md` — Python SDK design (paused, resume after MCP Server)
+- `TASKS.md` — Master task list with priorities and sequencing