feat(compound-v2-plugin): initial release v0.1.0 — Compound V2 exit tool

[GeoGu360]

Summary

Compound V2 (cToken-based) money market integration on Ethereum mainnet, positioned as an EXIT tool for legacy positions.

⚠️ Wind-down disclosure

As of 2026, all 6 major V2 markets (cDAI / cUSDC / cUSDT / cETH / cWBTC2 / cCOMP) have governance-paused both new supply (mintGuardianPaused = true) and new borrow (borrowGuardianPaused = true). Compound team's active development is on V3 (Comet).

This plugin's pre-flight short-circuits supply/borrow with structured MARKET_PAUSED_USE_V3 / BORROW_PAUSED_USE_V3 errors, redirecting users to compound-v3-plugin:

$ compound-v2-plugin supply --token USDC --amount 100 --confirm
{
  "ok": false,
  "error_code": "MARKET_PAUSED_USE_V3",
  "suggestion": "Install compound-v3-plugin: `npx skills add okx/plugin-store --skill compound-v3-plugin`"
}

10 commands

• Read: quickstart (6-state status enum) / markets / positions
• Write (exit flows, fully functional): withdraw (redeemUnderlying) / repay (uint256.max sentinel for dust-free --all) / claim-comp
• Write (governance-blocked, return V3 redirect): supply / borrow
• Collateral mgmt: enter-markets / exit-market

Highlights

• LEND-001 dust-free repay via Compound V2's native cToken.repayBorrow(uint256.max) sentinel — contract auto-caps to current debt at execution time. Single-tx, no decision-tree complexity (simpler than Dolomite's branching A/B/C since Compound's contract handles the cap internally).
• cETH payable handling — mint() no-args + value=amount, repayBorrow no-approve + value=amount. Distinct from ERC-20 mint(uint256) / repayBorrow(uint256) paths.
• Selectors verified on-chain — every selector via keccak256 + live eth_call smoke test. Critical bug caught in dev: initial guess for borrowGuardianPaused(address) (0x6d35bf91) was wrong; correct is 0x6d154ea5. Wrong selector silently reverted, which my fail-closed is_borrow_paused.unwrap_or(true) in write commands correctly trapped, but read-side displays were silently showing borrow_paused=false. Fixed; re-verified all 6 markets show borrow_paused=true post-fix.
• Comptroller is a Unitroller proxy — bytecode scan technique that worked for Dolomite's BorrowPositionProxyV2 (direct impl) didn't work here since Comptroller delegates to implementation at 0xbafe01ff…b526. Switched to live eth_call probe + keccak256-only verification.

Knowledge base compliance

GEN-001 ✓ ONB-001 ✓ ONC-001 ✓ EVM-001 ✓ EVM-002 ✓ EVM-006 ✓ EVM-014 (3 patterns) ✓ EVM-015 (80k/280k/450k/200k+70k×N) ✓ TX-001 ✓ GAS-001 (0.005 ETH floor for L1 mainnet) ✓ LEND-001 ✓

Test plan

• cargo build clean (warnings only — unused selector consts kept for reference)
• All 10 commands --help ↔ SKILL.md flag parity
• SUMMARY.md three-section (Overview / Prerequisites / Quick Start), 8 steps, status enum aligned src ↔ SKILL.md ↔ SUMMARY.md
• LICENSE present (CI E041)
• api_calls covers single https domain (ethereum-rpc.publicnode.com)
• 4-file version consistency at 0.1.0 (plugin.yaml, SKILL.md frontmatter, Cargo.toml, .claude-plugin/plugin.json)
• Live verified on Ethereum mainnet (wallet 0x87fb…1b90, no V2 history):
  • quickstart → status: protocol_winddown, next_command: npx skills add ... --skill compound-v3-plugin ✓
  • markets → 6 markets, all mint_paused=true && borrow_paused=true, real APRs (cUSDC 3.82%, cETH 1.74%) ✓
  • positions → position_count: 0, comp_accrued: 0, assets_in: [] ✓
  • supply --token USDC --amount 1 --confirm → MARKET_PAUSED_USE_V3 ✓
  • borrow --token DAI --amount 1 --confirm → BORROW_PAUSED_USE_V3 ✓
  • withdraw --token DAI --amount 1 --confirm → NO_SUPPLY ✓
  • repay --token USDC --all --confirm → NO_DEBT ✓
  • claim-comp --dry-run → compAccrued: 0 displayed ✓
  • enter-markets --ctokens cDAI --dry-run → preview correct, currently_entered: [] ✓
  • exit-market --ctoken cDAI --confirm → NOT_IN_MARKET ✓
• All errors return structured {ok:false, error_code, suggestion} JSON via stdout (GEN-001)

🤖 Generated with Claude Code

[github-actions]

📋 Phase 3: AI Code Review Report — Score: N/A/100

Plugin: compound-v2-plugin | Recommendation: 👤 Manual review required

🔗 Reviewed against latest onchainos source code (live from main branch) | Model: unavailable via Anthropic API | Cost: N/A

This is an advisory report. It does NOT block merging. Final decision is made by human reviewers.

---

❌ AI review FAILED (HTTP 400): Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.. Request size: 1246219 bytes, plugin content: 178604 bytes.

---

Generated by Claude AI via Anthropic API — review the full report before approving.

[github-actions]

🔨 Phase 2: Build Verification — ✅ PASSED

Plugin: compound-v2-plugin | Language: rust
Source: @

Compiled from developer source code by our CI. Users install our build artifacts.

Build succeeded. Compiled artifact uploaded as workflow artifact.

---

Source integrity: commit SHA `` is the content fingerprint.

[github-actions]

🔨 Phase 2: Build Verification — ✅ PASSED

Plugin: compound-v2-plugin | Language: rust
Source: @

Compiled from developer source code by our CI. Users install our build artifacts.

Build succeeded. Compiled artifact uploaded as workflow artifact.

---

Source integrity: commit SHA `` is the content fingerprint.

[github-actions]

✅ Phase 1: Structure Validation — PASSED

Linting skills/compound-v2-plugin...

  ⚠️  [W046] tag 'cToken' should be lowercase alphanumeric with hyphens

✓ Plugin 'compound-v2-plugin' passed with 1 warning(s)

→ Proceeding to Phase 2: Build Verification

[plugin-store-bot]

✅ Phase 4: Publish Complete

Plugins: compound-v2-plugin

• ✅ Build: 9 architectures compiled
• ✅ Release: GitHub Release created
• ✅ Pre-flight: injected into SKILL.md
• ✅ Registry: registry.json updated
• ✅ Merged to main

View workflow run

---

Published by Plugin Store CI