docs: update documentation to reflect PR hummingbot#594 submission

- Update PR-SUBMISSION-CHECKLIST.md with completed status and PR link
- Update docs/README.md with current implementation status
- Add upstream merge checklist to CLAUDE.md
- Streamline ETCswap section in CLAUDE.md

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

Author: chris-mercer

CLAUDE.md

@@ -277,14 +277,24 @@ node scripts/test-helius-live.js
 ## Hummingbot Gateway Endpoint Standardization
 - This repo standardized DEX and chain endpoints that are used by Hummingbot strategies. See this branch for the matching code, especially the Gateway connector classes https://github.com/hummingbot/hummingbot/tree/development
 
-## ETCswap Integration (Current Focus)
+## ETCswap Integration
 
-This fork is focused on adding ETCswap V2 and V3 connectors for Ethereum Classic.
+This fork adds ETCswap V2 and V3 connectors for Ethereum Classic.
 
-### Contract Reference
-**Source of Truth:** [docs/ETCSWAP-CONTRACTS.md](docs/ETCSWAP-CONTRACTS.md) for all contract addresses.
+### Upstream PR Status
+**PR #594:** https://github.com/hummingbot/gateway/pull/594 (Submitted 2026-01-22)
+
+### Upstream Merge Checklist
+1. [x] Create clean feature branch from `upstream/main`
+2. [x] Copy ETCswap-specific files only (no community docs)
+3. [x] Run full test suite (134 tests passing)
+4. [x] Submit PR to upstream
+5. [ ] Address review feedback
+6. [ ] PR merged
+7. [ ] Submit NCP (New Connector Proposal) on Snapshot
 
-**CRITICAL:** Always verify addresses against the source of truth document. Never copy addresses from generated reports or other documentation without verification.
+### Contract Reference
+**Source of Truth:** [docs/ETCSWAP-CONTRACTS.md](docs/ETCSWAP-CONTRACTS.md)
 
 ### Networks Implemented
 | Network | Config Name | Chain ID | V2 (AMM) | V3 (CLMM) |
@@ -337,16 +347,12 @@ This fork is focused on adding ETCswap V2 and V3 connectors for Ethereum Classic
    - etc.
 
 ### ETCswap SDKs
-Use the official ETCswap SDK packages (NOT `@_etcswap/*` which are deprecated):
-
 ```bash
 pnpm add @etcswapv2/sdk-core @etcswapv2/sdk @etcswapv3/sdk @etcswapv3/router-sdk
 ```
 
-SDK Repository: https://github.com/etcswap/sdks
-
 ### ETCswap Links
+- Upstream PR: https://github.com/hummingbot/gateway/pull/594
+- SDKs Repository: https://github.com/etcswap/sdks
 - V2 App: https://v2.etcswap.org
 - V3 App: https://v3.etcswap.org
-- V2 Subgraph: https://v2-graph.etcswap.org/subgraphs/name/etcswap/graphql
-- V3 Subgraph: https://v3-graph.etcswap.org/subgraphs/name/etcswap/graphql

docs/PR-SUBMISSION-CHECKLIST.md

@@ -1,15 +1,21 @@
 # ETCswap Connector PR Submission Checklist
 
-This checklist tracks all requirements for submitting the ETCswap V2 and V3 connector implementation to the official Hummingbot Gateway repository.
+This checklist tracks the status of the ETCswap V2 and V3 connector submission to the official Hummingbot Gateway repository.
 
-## PR Information
+## PR Status: SUBMITTED
 
-- **Target Repository:** https://github.com/hummingbot/gateway
-- **Target Branch:** `development`
-- **Source Branch:** `feat/etcswap-v28-upgrade` (clean PR branch)
-- **Connector Name:** ETCswap
-- **Networks:** Ethereum Classic (`classic`, Chain ID 61), Mordor Testnet (`mordor`, Chain ID 63)
-- **Trading Types:** Router, AMM (V2), CLMM (V3)
+**PR #594:** https://github.com/hummingbot/gateway/pull/594
+
+| Field | Value |
+|-------|-------|
+| Target Repository | https://github.com/hummingbot/gateway |
+| Target Branch | `main` |
+| Source Branch | `feat/etcswap-connector` |
+| Connector Name | ETCswap |
+| Networks | Ethereum Classic (`classic`, Chain ID 61), Mordor Testnet (`mordor`, Chain ID 63) |
+| Trading Types | Router, AMM (V2), CLMM (V3) |
+| Tests Passing | 134/134 |
+| Submitted | 2026-01-22 |
 
 ---
 
@@ -136,33 +142,31 @@ This checklist tracks all requirements for submitting the ETCswap V2 and V3 conn
 
 ---
 
-## 5. PR Preparation
+## 5. PR Preparation - COMPLETED
 
 ### 5.1 Branch Setup
-- [ ] Fetch latest from upstream: `git fetch upstream`
-- [ ] Create clean branch from upstream/development
-- [ ] Cherry-pick only connector-related commits (exclude community docs)
-- [ ] Resolve any merge conflicts
+- [x] Fetch latest from upstream: `git fetch upstream`
+- [x] Create clean branch from upstream/main: `feat/etcswap-connector`
+- [x] Copy only ETCswap-specific files (no community docs)
+- [x] All 134 tests passing on clean branch
 
 ### 5.2 PR Content
-- [ ] Clear PR title: `feat: add ETCswap V2 and V3 connector for Ethereum Classic`
-- [ ] PR description includes:
+- [x] Clear PR title: `feat: add ETCswap V2 and V3 connector for Ethereum Classic`
+- [x] PR description includes:
   - Summary of changes
   - Networks supported (Classic, Mordor)
   - Trading types (Router, AMM, CLMM)
   - Test coverage percentage
   - Link to contract reference
-- [ ] Checklist in PR body per Hummingbot template
+- [x] PR submitted: https://github.com/hummingbot/gateway/pull/594
 
-### 5.3 Pre-submission Verification
+### 5.3 Pre-submission Verification - PASSED
 ```bash
-# Run all checks before submitting
-pnpm clean && pnpm install
-pnpm lint
-pnpm typecheck
-pnpm build
-pnpm test
-pnpm test:cov
+# All checks passed on feat/etcswap-connector branch
+pnpm lint      # ✓ Passed
+pnpm typecheck # ✓ Passed
+pnpm build     # ✓ Passed
+pnpm test      # ✓ 134 tests passing
 ```
 
 ---
@@ -241,26 +245,36 @@ gh pr create --base development
 
 | Category | Status | Notes |
 |----------|--------|-------|
-| Code Implementation | Complete | All routes implemented |
-| Configuration | Complete | Both networks configured |
-| Unit Tests | Partial | Core tests done, need more coverage |
-| Integration Tests | Not Started | Requires live RPC testing |
-| Code Quality | In Progress | Lint/typecheck need verification |
-| Documentation | Complete | Contract reference complete |
-| PR Branch | Not Started | Clean branch needed |
-| NCP Proposal | Pending | After PR merge |
+| Code Implementation | ✅ Complete | All routes implemented |
+| Configuration | ✅ Complete | Both networks configured |
+| Unit Tests | ✅ Complete | 100 unit tests passing |
+| Live Tests | ✅ Complete | 34 live tests (16 Mordor + 18 Classic) |
+| Code Quality | ✅ Complete | Lint/typecheck/build passing |
+| Documentation | ✅ Complete | Contract reference complete |
+| PR Branch | ✅ Complete | `feat/etcswap-connector` |
+| PR Submitted | ✅ Complete | PR #594 |
+| NCP Proposal | ⏳ Pending | After PR merge |
+
+---
+
+## Next Steps
+
+1. **PR Review:** Wait for Hummingbot team to review PR #594
+2. **Address Feedback:** Respond to any review comments
+3. **NCP Proposal:** After merge, submit New Connector Proposal on Snapshot
+   - Requires 200,000 HBOT tokens
+   - 7-day voting period
 
 ---
 
-## Contact & Resources
+## Resources
 
+- **Upstream PR:** https://github.com/hummingbot/gateway/pull/594
 - **ETCswap Website:** https://etcswap.org
-- **ETCswap V3 App:** https://v3.etcswap.org
-- **ETCswap V2 App:** https://v2.etcswap.org
 - **ETCswap SDKs:** https://github.com/etcswap/sdks
 - **Hummingbot Gateway:** https://github.com/hummingbot/gateway
-- **Hummingbot Docs:** https://hummingbot.org/gateway/
+- **NCP Snapshot Space:** https://snapshot.org/#/hbot-ncp.eth
 
 ---
 
-Last updated: 2025-01-21
+Last updated: 2026-01-22

docs/README.md

@@ -1,38 +1,36 @@
-# Hummingbot Gateway Documentation
+# ETCswap Connector Documentation
 
-This folder contains documentation specific to the ETCswap integration.
+Documentation for the ETCswap V2/V3 connector integration with Hummingbot Gateway.
 
-## Documents
-
-### [ETCSWAP-CONTRACTS.md](./ETCSWAP-CONTRACTS.md)
-Complete reference of all ETCswap contract addresses for:
-- Ethereum Classic (Chain ID: 61)
-- Mordor Testnet (Chain ID: 63)
+## PR Status
 
-Includes:
-- V2 contracts (Factory, Router, Multicall)
-- V3 contracts (Factory, SwapRouter, QuoterV2, NFT Position Manager, etc.)
-- Core tokens (WETC, USC)
-- Network configuration (RPC URLs, Chain IDs, Block Explorers)
+**Upstream PR #594:** https://github.com/hummingbot/gateway/pull/594
 
-## Implementation Status
+## Documents
 
-| Feature | Ethereum Classic | Mordor Testnet |
-|---------|-------------|----------------|
-| Chain Config | Pending | Pending |
-| Token List | Pending | Pending |
-| ETCswap V2 (AMM) | Pending | Pending |
-| ETCswap V3 (CLMM) | Pending | TBD |
+| Document | Description |
+|----------|-------------|
+| [ETCSWAP-CONTRACTS.md](./ETCSWAP-CONTRACTS.md) | Contract addresses and configuration |
+| [PR-SUBMISSION-CHECKLIST.md](./PR-SUBMISSION-CHECKLIST.md) | PR submission tracking |
+| [reports/ETCSWAP-TEST-REPORT.md](./reports/ETCSWAP-TEST-REPORT.md) | Test results (134 tests) |
+| [etcswap/GETTING-STARTED.md](./etcswap/GETTING-STARTED.md) | User setup guide |
+| [etcswap/API-REFERENCE.md](./etcswap/API-REFERENCE.md) | API documentation |
 
-## Quick Links
+## Implementation Status
 
-- [Main README](../README.md) - Project overview
-- [CLAUDE.md](../CLAUDE.md) - AI agent instructions
-- [CONTRIBUTING.md](../CONTRIBUTING.md) - Contribution guidelines
+| Feature | Classic | Mordor | Status |
+|---------|---------|--------|--------|
+| Chain Config | ✅ | ✅ | Complete |
+| Token List | ✅ | ✅ | Complete |
+| V2 AMM | ✅ | ✅ | Complete |
+| V3 CLMM | ✅ | ✅ | Complete |
+| Router | ✅ | ✅ | Complete |
+| Unit Tests | 100 | - | Passing |
+| Live Tests | 18 | 16 | Passing |
 
 ## ETCswap Resources
 
 - Website: https://etcswap.org
 - V2 App: https://v2.etcswap.org
 - V3 App: https://v3.etcswap.org
-- Twitter: https://x.com/ETCswap_org
+- SDKs: https://github.com/etcswap/sdks