Add mantle-cli: standalone Mantle DeFi CLI for Mantle Squad Bounty

New crate: crates/mantle-cli/ — builds `mantle` binary
Reuses defi-core + defi-protocols (shared workspace)

8 commands, all Mantle-hardcoded (no --chain flag):
  mantle status     — 8 protocols, 12 tokens ecosystem overview
  mantle scan       — Oracle divergence + stablecoin depeg + exchange rate
  mantle swap       — ODOS aggregator best-price routing
  mantle bridge     — LI.FI cross-chain (--to/--from other chains)
  mantle whales     — Top token holders via routescan (free API)
  mantle positions  — Wallet token balances + lending positions
  mantle lending    — Aave V3/Lendle rates
  mantle yield      — Cross-protocol rate comparison

All commands tested live against Mantle mainnet.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Hiksang

.omc/project-memory.json

@@ -0,0 +1,241 @@
+{
+  "version": "1.0.0",
+  "lastScanned": 1773738547892,
+  "projectRoot": "/Users/hik/Documents/GitHub/defi-cli",
+  "techStack": {
+    "languages": [
+      {
+        "name": "Rust",
+        "version": "1.85",
+        "confidence": "high",
+        "markers": [
+          "Cargo.toml"
+        ]
+      }
+    ],
+    "frameworks": [],
+    "packageManager": "cargo",
+    "runtime": null
+  },
+  "build": {
+    "buildCommand": "cargo build",
+    "testCommand": "cargo test",
+    "lintCommand": "cargo clippy",
+    "devCommand": "cargo run",
+    "scripts": {}
+  },
+  "conventions": {
+    "namingStyle": null,
+    "importStyle": null,
+    "testPattern": null,
+    "fileOrganization": null
+  },
+  "structure": {
+    "isMonorepo": false,
+    "workspaces": [],
+    "mainDirectories": [
+      "docs",
+      "src",
+      "tests"
+    ],
+    "gitBranches": {
+      "defaultBranch": "main",
+      "branchingStrategy": null
+    }
+  },
+  "customNotes": [],
+  "directoryMap": {
+    "__pycache__": {
+      "path": "__pycache__",
+      "purpose": null,
+      "fileCount": 1,
+      "lastAccessed": 1773738547871,
+      "keyFiles": [
+        "prepare.cpython-314.pyc"
+      ]
+    },
+    "config": {
+      "path": "config",
+      "purpose": "Configuration files",
+      "fileCount": 1,
+      "lastAccessed": 1773738547872,
+      "keyFiles": [
+        "chains.toml"
+      ]
+    },
+    "crates": {
+      "path": "crates",
+      "purpose": null,
+      "fileCount": 0,
+      "lastAccessed": 1773738547872,
+      "keyFiles": []
+    },
+    "docs": {
+      "path": "docs",
+      "purpose": "Documentation",
+      "fileCount": 1,
+      "lastAccessed": 1773738547872,
+      "keyFiles": [
+        "DEFI_CATEGORIES.md"
+      ]
+    },
+    "src": {
+      "path": "src",
+      "purpose": "Source code",
+      "fileCount": 0,
+      "lastAccessed": 1773738547872,
+      "keyFiles": []
+    },
+    "target": {
+      "path": "target",
+      "purpose": null,
+      "fileCount": 2,
+      "lastAccessed": 1773738547873,
+      "keyFiles": [
+        "CACHEDIR.TAG"
+      ]
+    },
+    "tests": {
+      "path": "tests",
+      "purpose": "Test files",
+      "fileCount": 0,
+      "lastAccessed": 1773738547873,
+      "keyFiles": []
+    }
+  },
+  "hotPaths": [
+    {
+      "path": "crates/defi-core/src/registry/mod.rs",
+      "accessCount": 4,
+      "lastAccessed": 1773738642077,
+      "type": "file"
+    },
+    {
+      "path": "Cargo.toml",
+      "accessCount": 3,
+      "lastAccessed": 1773739684404,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/src/commands/positions.rs",
+      "accessCount": 2,
+      "lastAccessed": 1773739698658,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/src/commands/whales.rs",
+      "accessCount": 2,
+      "lastAccessed": 1773739699652,
+      "type": "file"
+    },
+    {
+      "path": "config/chains.toml",
+      "accessCount": 1,
+      "lastAccessed": 1773738612514,
+      "type": "file"
+    },
+    {
+      "path": "config/tokens/mantle.toml",
+      "accessCount": 1,
+      "lastAccessed": 1773738617241,
+      "type": "file"
+    },
+    {
+      "path": "crates/defi-cli/src/commands/mod.rs",
+      "accessCount": 1,
+      "lastAccessed": 1773738626904,
+      "type": "file"
+    },
+    {
+      "path": "crates/defi-cli/src/main.rs",
+      "accessCount": 1,
+      "lastAccessed": 1773738627126,
+      "type": "file"
+    },
+    {
+      "path": "config/protocols/dex/agni_mantle.toml",
+      "accessCount": 1,
+      "lastAccessed": 1773738629679,
+      "type": "file"
+    },
+    {
+      "path": "config/protocols/lending/aave_v3_mantle.toml",
+      "accessCount": 1,
+      "lastAccessed": 1773738630109,
+      "type": "file"
+    },
+    {
+      "path": "config/protocols/dex/fusionx_v3_mantle.toml",
+      "accessCount": 1,
+      "lastAccessed": 1773738634163,
+      "type": "file"
+    },
+    {
+      "path": "config/protocols/lending/compound_v3_mantle.toml",
+      "accessCount": 1,
+      "lastAccessed": 1773738634595,
+      "type": "file"
+    },
+    {
+      "path": "README.md",
+      "accessCount": 1,
+      "lastAccessed": 1773738645266,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/Cargo.toml",
+      "accessCount": 1,
+      "lastAccessed": 1773739460764,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/src/main.rs",
+      "accessCount": 1,
+      "lastAccessed": 1773739463244,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/src/commands/mod.rs",
+      "accessCount": 1,
+      "lastAccessed": 1773739486491,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/src/commands/status.rs",
+      "accessCount": 1,
+      "lastAccessed": 1773739497065,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/src/commands/scan.rs",
+      "accessCount": 1,
+      "lastAccessed": 1773739552645,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/src/commands/swap.rs",
+      "accessCount": 1,
+      "lastAccessed": 1773739586088,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/src/commands/bridge.rs",
+      "accessCount": 1,
+      "lastAccessed": 1773739604336,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/src/commands/lending.rs",
+      "accessCount": 1,
+      "lastAccessed": 1773739664927,
+      "type": "file"
+    },
+    {
+      "path": "crates/mantle-cli/src/commands/yield_cmd.rs",
+      "accessCount": 1,
+      "lastAccessed": 1773739672863,
+      "type": "file"
+    }
+  ],
+  "userDirectives": []
+}

.omc/specs/deep-interview-mantle-cli.md

@@ -0,0 +1,105 @@
+# Deep Interview Spec: Mantle CLI
+
+## Metadata
+- Rounds: 4
+- Final Ambiguity Score: 19.5%
+- Type: brownfield
+- Generated: 2026-03-17
+- Threshold: 20%
+- Status: PASSED
+
+## Clarity Breakdown
+| Dimension | Score | Weight | Weighted |
+|-----------|-------|--------|----------|
+| Goal Clarity | 0.90 | 35% | 0.315 |
+| Constraint Clarity | 0.70 | 25% | 0.175 |
+| Success Criteria | 0.75 | 25% | 0.1875 |
+| Context Clarity | 0.85 | 15% | 0.1275 |
+| **Total Clarity** | | | **0.805** |
+| **Ambiguity** | | | **19.5%** |
+
+## Goal
+Mantle 체인 전용 CLI 바이너리(`mantle`)를 기존 defi-cli workspace에 새 crate로 추가하여, Mantle Squad Bounty(~3/31)에 제출한다. `--chain` 플래그 없이 Mantle 하드코딩된 8개 핵심 커맨드를 제공하고, GitHub repo + X 스레드 + 데모 영상으로 제출한다.
+
+## Constraints
+- **마감**: 2026-03-31
+- **코드 구조**: defi-cli workspace에 `crates/mantle-cli/` 추가. defi-core + defi-protocols 공유.
+- **바이너리명**: `mantle`
+- **체인**: Mantle만 (chain_id: 5000). `--chain` 플래그 제거.
+- **의존성**: defi-core, defi-protocols, reqwest, clap, serde_json, tokio, alloy
+
+## Non-Goals
+- 다른 체인 지원 (Mantle 전용)
+- 신규 프로토콜 어댑터 개발
+- 웹 UI / TUI 대시보드
+- 실제 트랜잭션 브로드캐스트 (dry-run/시뮬레이션 중심)
+
+## Acceptance Criteria
+- [ ] `cargo build --bin mantle` 로 별도 바이너리 빌드
+- [ ] 8개 커맨드 동작: status, scan, swap, bridge, whales, positions, lending (rates), yield (compare)
+- [ ] 모든 커맨드에 `--json` 출력 지원
+- [ ] `--chain` 플래그 없이 Mantle 하드코딩
+- [ ] README.md: 설치법, 사용법, 스크린샷, Mantle 생태계 소개
+- [ ] CI 통과 (clippy, fmt, test, build)
+- [ ] 데모 실행 성공: scan→alert, whales→position, swap quote, bridge quote
+
+## Assumptions Exposed & Resolved
+| Assumption | Challenge | Resolution |
+|------------|-----------|------------|
+| 별도 repo 필요 | 유지보수 2배 문제 | 같은 workspace, crate만 분리 |
+| 전체 22개 커맨드 | bounty에 불필요한 것 많음 | 핵심 8개만 |
+| 코드 복사 필요 | defi-core 공유 가능 | workspace dependency로 해결 |
+
+## Technical Context
+- 기존 defi-cli workspace: 4 crates (defi-core, defi-protocols, defi-cli, defi-mcp)
+- Mantle 설정: 8 protocols, 12 tokens, chain config 이미 존재
+- 핵심 재사용: Registry, multicall_read(), Executor, OutputMode
+- 신규 작성: main.rs, commands/mod.rs (8개 커맨드 래퍼), README.md
+
+## Ontology (Key Entities)
+
+| Entity | Type | Fields | Relationships |
+|--------|------|--------|---------------|
+| MantleCLI | product | binary_name, commands[], version | uses defi-core, targets Bounty |
+| defi-cli | source | 22 commands, 11 chains | shares core with MantleCLI |
+| Bounty | external | deadline(3/31), prize($10K MNT), criteria[] | receives MantleCLI + XThread + DemoVideo |
+| Commands | feature set | scan, swap, bridge, whales, positions, lending, yield, status | belongs to MantleCLI |
+| MantleEcosystem | domain | 8 protocols, 12 tokens, chain_id=5000 | queried by Commands |
+| XThread | deliverable | text, screenshots, @Mantle_Official tag | part of Bounty submission |
+| DemoVideo | deliverable | 1-2min, scan/whales/swap/bridge demo | part of Bounty submission |
+| Workspace | architecture | Cargo workspace, shared crates | contains MantleCLI + defi-cli |
+
+## Ontology Convergence
+
+| Round | Entity Count | New | Changed | Stable | Stability Ratio |
+|-------|-------------|-----|---------|--------|----------------|
+| 1 | 3 | 3 | - | - | N/A |
+| 2 | 5 | 2 | 0 | 3 | 60% |
+| 3 | 7 | 2 | 0 | 5 | 71% |
+| 4 | 8 | 1 | 0 | 7 | 87.5% |
+
+## Implementation Plan
+
+### Phase 1: Crate 생성 (~30min)
+1. `crates/mantle-cli/Cargo.toml` 생성
+2. `crates/mantle-cli/src/main.rs` — Mantle 하드코딩 entry point
+3. `crates/mantle-cli/src/commands/mod.rs` — 8개 커맨드 등록
+4. 각 커맨드: defi-cli 로직 재사용, chain을 "mantle"로 고정
+
+### Phase 2: 커맨드 구현 (~1hr)
+- `status` → Mantle 프로토콜 현황
+- `scan` → Oracle 괴리 + 디페그 + exchange rate
+- `swap` → ODOS aggregator (Mantle)
+- `bridge` → LI.FI (from/to Mantle)
+- `whales` → routescan API (Mantle 무료)
+- `positions` → 토큰 잔고 + lending 포지션
+- `lending rates` → Aave V3/Lendle 이율
+- `yield compare` → 전체 프로토콜 이율 비교
+
+### Phase 3: README + 문서 (~30min)
+- README.md: 설치법, 사용법, 스크린샷
+- Mantle 생태계 소개 ($748M TVL, 8 protocols)
+
+### Phase 4: CI + 테스트 (~15min)
+- cargo build, clippy, fmt, test
+- 라이브 테스트 (scan, swap, bridge, whales)

.omc/state/agent-replay-2c019e77-806b-4a72-b477-db1f3b13fa91.jsonl

@@ -0,0 +1,4 @@
+{"t":0,"agent":"system","event":"keyword_detected","keyword":"deep-interview"}
+{"t":0,"agent":"a74e131","agent_type":"Explore","event":"agent_start","parent_mode":"none"}
+{"t":0,"agent":"a74e131","agent_type":"Explore","event":"agent_stop","success":true,"duration_ms":59492}
+{"t":0,"agent":"system","event":"skill_invoked","skill_name":"oh-my-claudecode:autopilot"}

.omc/state/hud-state.json

@@ -0,0 +1,6 @@
+{
+  "timestamp": "2026-03-17T08:52:16.882Z",
+  "backgroundTasks": [],
+  "sessionStartTimestamp": "2026-03-17T08:11:52.256Z",
+  "sessionId": "2c019e77-806b-4a72-b477-db1f3b13fa91"
+}

.omc/state/hud-stdin-cache.json

@@ -0,0 +1 @@
+{"session_id":"2c019e77-806b-4a72-b477-db1f3b13fa91","transcript_path":"/Users/hik/.claude/projects/-Users-hik-Documents-GitHub-defi-cli/2c019e77-806b-4a72-b477-db1f3b13fa91.jsonl","cwd":"/Users/hik/Documents/GitHub/defi-cli","model":{"id":"claude-opus-4-6[1m]","display_name":"Opus 4.6 (1M context)"},"workspace":{"current_dir":"/Users/hik/Documents/GitHub/defi-cli","project_dir":"/Users/hik/Documents/GitHub/defi-cli","added_dirs":[]},"version":"2.1.77","output_style":{"name":"default"},"cost":{"total_cost_usd":332.6627781500007,"total_duration_ms":95349070,"total_api_duration_ms":27594030,"total_lines_added":8521,"total_lines_removed":1085},"context_window":{"total_input_tokens":9141228,"total_output_tokens":1152114,"context_window_size":1000000,"current_usage":{"input_tokens":3,"output_tokens":1,"cache_creation_input_tokens":294,"cache_read_input_tokens":403160},"used_percentage":40,"remaining_percentage":60},"exceeds_200k_tokens":true}

.omc/state/last-tool-error.json

@@ -0,0 +1,7 @@
+{
+  "tool_name": "Bash",
+  "tool_input_preview": "{\"command\":\"cargo build --bin mantle 2>&1\",\"timeout\":120000,\"description\":\"Build mantle-cli\"}",
+  "error": "Exit code 101\n   Compiling mantle-cli v0.1.0 (/Users/hik/Documents/GitHub/defi-cli/crates/mantle-cli)\nerror[E0560]: struct `positions::IPool::getUserAccountDataCall` has no field named `_0`\n  --> crates/mantle-cli/src/commands/positions.rs:69:60\n   |\n69 |         calls.push((*pool, IPool::getUserAccountDataCall { _0: user }.abi_encode()));\n   |                                                            ^^ `positions::IPool::getUserAccountDataCall` does not have this field\n   |\n   = note: availab...",
+  "timestamp": "2026-03-17T09:28:12.854Z",
+  "retry_count": 1
+}