defi-omni-cli 0.2.0__tar.gz

defi_omni_cli-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 counterfactual5
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

defi_omni_cli-0.2.0/PKG-INFO

@@ -0,0 +1,282 @@
+Metadata-Version: 2.4
+Name: defi-omni-cli
+Version: 0.2.0
+Summary: 多链多协议 DeFi 自动化工具集 — 供应链借贷、Swap、质押于一体
+Author: counterfactual5
+License-Expression: MIT
+Project-URL: Repository, https://github.com/counterfactual5/defi-autopilot
+Project-URL: Issues, https://github.com/counterfactual5/defi-autopilot/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: web3>=6.15
+Requires-Dist: eth-account>=0.11
+Requires-Dist: eth-utils>=2.3
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.5
+Requires-Dist: requests>=2.31
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Dynamic: license-file
+
+# defi-autopilot
+
+> Multi-chain, multi-protocol DeFi automation toolkit
+
+<p align="center">
+  <img src="https://img.shields.io/badge/python-%E2%89%A53.10-blue" alt="Python">
+  <img src="https://img.shields.io/badge/License-MIT-green" alt="License">
+  <a href="https://github.com/counterfactual5/defi-autopilot/actions/workflows/test.yml"><img src="https://github.com/counterfactual5/defi-autopilot/actions/workflows/test.yml/badge.svg" alt="Tests"></a>
+</p>
+
+Supply, borrow, repay, collateral management, and DEX aggregation — all from one CLI. Extensible protocol architecture with Morpho Blue, Moonwell, Aave V3, and 1inch.
+
+## Architecture
+
+```
+defi-autopilot/
+├── defi_autopilot/
+│   ├── core/              # Shared infrastructure
+│   │   ├── chains.py      # Multi-chain configuration
+│   │   ├── rpc.py         # Web3 instance management
+│   │   ├── signer.py      # Transaction signer
+│   │   └── tx.py          # TX build/sign/broadcast + ERC20 approval
+│   ├── protocols/
+│   │   ├── morpho/        # Morpho Blue (isolated lending markets)
+│   │   ├── moonwell/      # Moonwell (Compound V2 fork)
+│   │   ├── aave/          # Aave V3 (lending)
+│   │   ├── uniswap/       # Uniswap V3 (DEX)
+│   │   ├── oneinch/       # 1inch (DEX aggregator)
+│   │   ├── lido/          # Lido (liquid staking)
+│   │   ├── compound/      # Compound V3 (lending)
+│   │   ├── curve/         # Curve Finance (DEX)
+│   │   ├── cctp/          # Circle CCTP — V1 + V2 (cross-chain USDC, resumable)
+│   │   └── debridge/      # deBridge DLN (arbitrary-token cross-chain swaps)
+│   └── cli.py             # Click CLI entry point
+└── tests/
+```
+
+## Supported Protocols
+
+| Protocol | Type | Chains | Operations |
+|----------|------|--------|------------|
+| **Morpho Blue** | Isolated Lending | Base, Ethereum, Arbitrum | supply, supplyCollateral, borrow, repay, withdraw, withdrawCollateral |
+| **Moonwell** | Lending (Compound V2) | Base | supply(mint), redeem, borrow, repayBorrow |
+| **Aave V3** | Lending | Base, Ethereum, Arbitrum, Optimism, Polygon | supply, withdraw, borrow, repay, collateral toggle |
+| **Uniswap V3** | DEX | Base, Ethereum, Arbitrum, Optimism, Polygon, Unichain | quote, swap, price |
+| **1inch** | DEX Aggregator | Base, Ethereum, Arbitrum, Optimism, Polygon | quote, swap |
+| **Lido** | Liquid Staking | Ethereum, Base, Arbitrum, Optimism, Polygon | stake ETH, wrap/unwrap stETH/wstETH |
+| **Compound V3** | Lending | Ethereum, Base, Arbitrum, Polygon | supply, withdraw, supplyCollateral, borrow, repay |
+| **Curve** | Stablecoin DEX | Ethereum, Base, Arbitrum, Optimism | swap, add/remove liquidity, quote |
+| **Circle CCTP** | Cross-chain USDC bridge | Ethereum, Optimism, Arbitrum, Base, Polygon, Unichain, Avalanche | transfer (burn→attest→mint), resumable; **V1** (default) + **V2** (Fast/Standard) |
+| **deBridge DLN** | Cross-chain swap (any token) | Ethereum, Base, Arbitrum, Optimism, Polygon, Avalanche, Unichain | quote, send (cross-chain order via DLN REST API) |
+
+## Quick Start
+
+### Install
+
+```bash
+pip install defi-autopilot
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/counterfactual5/defi-autopilot.git
+cd defi-autopilot
+pip install -e .
+```
+
+### Configure
+
+Copy `.env.example` to `.env` and fill in your values:
+
+```bash
+cp .env.example .env
+```
+
+```env
+# RPC endpoints
+RPC_BASE=https://mainnet.base.org
+RPC_ETHEREUM=https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY
+RPC_ARBITRUM=https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY
+
+# Signer private key (never commit to Git)
+SIGNER_PRIVATE_KEY=***
+
+# Optional: 1inch API key (free tier works without it)
+INCH_API_KEY=
+
+# Optional: seconds to wait for a tx receipt before timing out (default 120).
+# On timeout the tx is already broadcast; re-query the receipt later.
+TX_RECEIPT_TIMEOUT=120
+```
+
+RPC calls automatically retry transient failures (connection errors, HTTP 429
+rate-limits, and 5xx) up to 3 times with exponential backoff, respecting any
+`Retry-After` header.
+
+### Usage
+
+```bash
+# List all available markets
+defi markets
+
+# --- Morpho Blue ---
+defi morpho position --market USDC-WETH-77
+defi morpho supply --market USDC-WETH-77 --amount 1000000000
+defi morpho supply-collateral --market USDC-WETH-77 --amount 500000000000000000
+defi morpho borrow --market USDC-WETH-77 --amount 500000000
+defi morpho repay --market USDC-WETH-77 --amount 500000000
+defi morpho withdraw --market USDC-WETH-77 --amount 1000000000
+
+# --- Moonwell ---
+defi moonwell supply --token USDC --amount 1000000000
+defi moonwell borrow --token WETH --amount 500000000000000000
+defi moonwell repay --token WETH --amount 500000000000000000
+defi moonwell position --token USDC
+
+# --- Aave V3 ---
+defi aave supply --asset USDC --amount 1000000000
+defi aave borrow --asset WETH --amount 500000000000000000
+defi aave repay --asset WETH
+defi aave position
+
+# --- Uniswap V3 ---
+defi uniswap quote --in USDC --out WETH --amount 1000000000
+defi uniswap swap --in USDC --out WETH --amount 1000000000
+defi uniswap price --in WETH --out USDC
+
+# --- 1inch ---
+defi inch quote --src USDC --dst WETH --amount 1000000000
+defi inch swap --src USDC --dst WETH --amount 1000000000 --slippage 1.0
+
+# --- Circle CCTP (native cross-chain USDC) ---
+defi cctp domains                                    # list supported chains + domain IDs
+# Burn 10 USDC on Base (-c 8453) and mint on Arbitrum (--to 42161).
+# Amount is in USDC base units (6 decimals): 10 USDC = 10000000
+defi -c 8453 cctp transfer --to 42161 --amount 10000000 --run-id move-usdc-1
+defi cctp status --run-id move-usdc-1                 # inspect checkpoint
+# Interrupted mid-flight? Re-run the SAME command — it resumes at attest/mint,
+# never re-burning.
+defi -c 8453 cctp transfer --to 42161 --amount 10000000 --run-id move-usdc-1
+
+# CCTP V2 — Fast Transfer (~seconds, small fee; max fee auto-fetched from Circle)
+defi -c 8453 cctp transfer --v2 --fast --to 42161 --amount 10000000 --run-id fast-1
+# CCTP V2 — Standard Transfer (hard finality, usually fee-free)
+defi -c 8453 cctp transfer --v2 --standard --to 42161 --amount 10000000 --run-id std-1
+
+# --- Preflight doctor (no transactions sent) ---
+defi -c 8453 doctor                       # RPC, chainId, signer, gas balance
+defi -c 8453 doctor --policy --amount 1000 # also evaluate the risk policy
+defi -c 8453 cctp doctor --to 42161 --amount 10000000        # CCTP V1 route
+defi -c 8453 cctp doctor --v2 --fast --to 42161 --amount 10000000  # + fee quote
+
+# --- General ---
+defi -c 1 morpho position --market ...  # specify chain
+defi --dry-run morpho supply ...         # simulate only
+```
+
+## SDK Usage
+
+```python
+from defi_autopilot.protocols.morpho import MorphoClient, BASE_MARKETS
+from defi_autopilot.protocols.moonwell import MoonwellClient
+from defi_autopilot.protocols.aave import AaveV3Client, BASE_TOKENS_AAVE
+from defi_autopilot.protocols.oneinch import OneInchClient, BASE_TOKENS_INCH
+
+# Morpho Blue
+morpho = MorphoClient(8453)
+result = morpho.supply(BASE_MARKETS["USDC-WETH-77"], amount=1000000000)
+
+# Moonwell
+moonwell = MoonwellClient(8453)
+result = moonwell.supply("USDC", amount=1000000000)
+
+# Aave V3
+aave = AaveV3Client(8453)
+result = aave.supply(BASE_TOKENS_AAVE["USDC"], amount=1000000000)
+health = aave.get_user_account_data("0xYourAddress")
+
+# 1inch
+inch = OneInchClient(8453)
+quote = inch.get_quote(
+    BASE_TOKENS_INCH["USDC"],
+    BASE_TOKENS_INCH["WETH"],
+    amount=1000000000,
+)
+
+# Circle CCTP V1 — native cross-chain USDC, resumable via state machine
+from defi_autopilot.protocols.cctp import CCTPClient
+
+cctp = CCTPClient(8453)  # source = Base
+result = cctp.transfer(
+    amount=10_000_000,        # 10 USDC (6 decimals)
+    dest_chain_id=42161,      # Arbitrum
+    run_id="move-usdc-1",     # re-run with same id to resume after a crash
+)
+# {"status": "completed", "burn_tx": ..., "mint_tx": ...}
+
+# Circle CCTP V2 — Fast Transfer (~seconds) or Standard (hard finality)
+from defi_autopilot.protocols.cctp import CCTPv2Client
+
+cctp_v2 = CCTPv2Client(8453)
+result = cctp_v2.transfer(
+    amount=10_000_000,
+    dest_chain_id=42161,
+    fast=True,                # Fast Transfer; max_fee auto-fetched from Circle
+    run_id="fast-1",
+)
+# {"status": "completed", "version": "v2", "burn_tx": ..., "mint_tx": ..., "max_fee": ...}
+```
+
+## 🛠️ Development
+
+```bash
+git clone https://github.com/counterfactual5/defi-autopilot.git
+cd defi-autopilot
+uv pip install -e ".[dev]"
+uv run pytest tests/ -v
+```
+
+167 tests covering chain config, market params, ABI validation, client initialization, token mappings, the risk-policy gate (chokepoint + ERC-20 notional), the CCTP V1/V2 transfer state machine, the CCTP preflight doctor, the top-level chain/wallet preflight doctor, the estimateGas simulation gate, RPC retry/backoff, and the configurable receipt timeout.
+
+## 🗺️ Roadmap
+
+- [x] Morpho Blue lending operations
+- [x] Moonwell supply/borrow/repay
+- [x] Aave V3 lending + health factor
+- [x] 1inch DEX aggregation
+- [x] Multi-chain (Base, Ethereum, Arbitrum, Optimism, Polygon)
+- [x] Compound V3 integration
+- [x] Circle CCTP cross-chain USDC (resumable burn & mint) — V1 + V2 (Fast/Standard)
+- [ ] Uniswap V3/V4 LP management
+- [ ] Strategy automation (auto-compound, yield optimization)
+- [ ] Position monitoring & alerting
+- [ ] WebSocket support for real-time data
+
+## Security
+
+- Private keys loaded from environment variables (never hardcoded)
+- Transactions require explicit amounts (no default all-in operations)
+- Gas estimation with 10% buffer
+- EIP-1559 fee auto-fetch
+
+## License
+
+MIT
+
+---
+
+If this project helped you, please ⭐ star this repo — it helps others find it!
+
+### Related Projects
+
+- **[uniswap-autopilot](https://github.com/counterfactual5/uniswap-autopilot)** — Deep Uniswap SDK with LP management, V4 support, and 13K lines of battle-tested code. If you need advanced Uniswap features beyond basic swaps, use that.
+- **[evm-wallet-scanner](https://github.com/counterfactual5/evm-wallet-scanner)** — Multi-chain wallet balance scanner, transaction history, and gas analytics.
+- **[erc20-checker](https://github.com/counterfactual5/erc20-checker)** — Scan and revoke ERC20 approvals across chains.

defi_omni_cli-0.2.0/README.md

@@ -0,0 +1,256 @@
+# defi-autopilot
+
+> Multi-chain, multi-protocol DeFi automation toolkit
+
+<p align="center">
+  <img src="https://img.shields.io/badge/python-%E2%89%A53.10-blue" alt="Python">
+  <img src="https://img.shields.io/badge/License-MIT-green" alt="License">
+  <a href="https://github.com/counterfactual5/defi-autopilot/actions/workflows/test.yml"><img src="https://github.com/counterfactual5/defi-autopilot/actions/workflows/test.yml/badge.svg" alt="Tests"></a>
+</p>
+
+Supply, borrow, repay, collateral management, and DEX aggregation — all from one CLI. Extensible protocol architecture with Morpho Blue, Moonwell, Aave V3, and 1inch.
+
+## Architecture
+
+```
+defi-autopilot/
+├── defi_autopilot/
+│   ├── core/              # Shared infrastructure
+│   │   ├── chains.py      # Multi-chain configuration
+│   │   ├── rpc.py         # Web3 instance management
+│   │   ├── signer.py      # Transaction signer
+│   │   └── tx.py          # TX build/sign/broadcast + ERC20 approval
+│   ├── protocols/
+│   │   ├── morpho/        # Morpho Blue (isolated lending markets)
+│   │   ├── moonwell/      # Moonwell (Compound V2 fork)
+│   │   ├── aave/          # Aave V3 (lending)
+│   │   ├── uniswap/       # Uniswap V3 (DEX)
+│   │   ├── oneinch/       # 1inch (DEX aggregator)
+│   │   ├── lido/          # Lido (liquid staking)
+│   │   ├── compound/      # Compound V3 (lending)
+│   │   ├── curve/         # Curve Finance (DEX)
+│   │   ├── cctp/          # Circle CCTP — V1 + V2 (cross-chain USDC, resumable)
+│   │   └── debridge/      # deBridge DLN (arbitrary-token cross-chain swaps)
+│   └── cli.py             # Click CLI entry point
+└── tests/
+```
+
+## Supported Protocols
+
+| Protocol | Type | Chains | Operations |
+|----------|------|--------|------------|
+| **Morpho Blue** | Isolated Lending | Base, Ethereum, Arbitrum | supply, supplyCollateral, borrow, repay, withdraw, withdrawCollateral |
+| **Moonwell** | Lending (Compound V2) | Base | supply(mint), redeem, borrow, repayBorrow |
+| **Aave V3** | Lending | Base, Ethereum, Arbitrum, Optimism, Polygon | supply, withdraw, borrow, repay, collateral toggle |
+| **Uniswap V3** | DEX | Base, Ethereum, Arbitrum, Optimism, Polygon, Unichain | quote, swap, price |
+| **1inch** | DEX Aggregator | Base, Ethereum, Arbitrum, Optimism, Polygon | quote, swap |
+| **Lido** | Liquid Staking | Ethereum, Base, Arbitrum, Optimism, Polygon | stake ETH, wrap/unwrap stETH/wstETH |
+| **Compound V3** | Lending | Ethereum, Base, Arbitrum, Polygon | supply, withdraw, supplyCollateral, borrow, repay |
+| **Curve** | Stablecoin DEX | Ethereum, Base, Arbitrum, Optimism | swap, add/remove liquidity, quote |
+| **Circle CCTP** | Cross-chain USDC bridge | Ethereum, Optimism, Arbitrum, Base, Polygon, Unichain, Avalanche | transfer (burn→attest→mint), resumable; **V1** (default) + **V2** (Fast/Standard) |
+| **deBridge DLN** | Cross-chain swap (any token) | Ethereum, Base, Arbitrum, Optimism, Polygon, Avalanche, Unichain | quote, send (cross-chain order via DLN REST API) |
+
+## Quick Start
+
+### Install
+
+```bash
+pip install defi-autopilot
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/counterfactual5/defi-autopilot.git
+cd defi-autopilot
+pip install -e .
+```
+
+### Configure
+
+Copy `.env.example` to `.env` and fill in your values:
+
+```bash
+cp .env.example .env
+```
+
+```env
+# RPC endpoints
+RPC_BASE=https://mainnet.base.org
+RPC_ETHEREUM=https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY
+RPC_ARBITRUM=https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY
+
+# Signer private key (never commit to Git)
+SIGNER_PRIVATE_KEY=***
+
+# Optional: 1inch API key (free tier works without it)
+INCH_API_KEY=
+
+# Optional: seconds to wait for a tx receipt before timing out (default 120).
+# On timeout the tx is already broadcast; re-query the receipt later.
+TX_RECEIPT_TIMEOUT=120
+```
+
+RPC calls automatically retry transient failures (connection errors, HTTP 429
+rate-limits, and 5xx) up to 3 times with exponential backoff, respecting any
+`Retry-After` header.
+
+### Usage
+
+```bash
+# List all available markets
+defi markets
+
+# --- Morpho Blue ---
+defi morpho position --market USDC-WETH-77
+defi morpho supply --market USDC-WETH-77 --amount 1000000000
+defi morpho supply-collateral --market USDC-WETH-77 --amount 500000000000000000
+defi morpho borrow --market USDC-WETH-77 --amount 500000000
+defi morpho repay --market USDC-WETH-77 --amount 500000000
+defi morpho withdraw --market USDC-WETH-77 --amount 1000000000
+
+# --- Moonwell ---
+defi moonwell supply --token USDC --amount 1000000000
+defi moonwell borrow --token WETH --amount 500000000000000000
+defi moonwell repay --token WETH --amount 500000000000000000
+defi moonwell position --token USDC
+
+# --- Aave V3 ---
+defi aave supply --asset USDC --amount 1000000000
+defi aave borrow --asset WETH --amount 500000000000000000
+defi aave repay --asset WETH
+defi aave position
+
+# --- Uniswap V3 ---
+defi uniswap quote --in USDC --out WETH --amount 1000000000
+defi uniswap swap --in USDC --out WETH --amount 1000000000
+defi uniswap price --in WETH --out USDC
+
+# --- 1inch ---
+defi inch quote --src USDC --dst WETH --amount 1000000000
+defi inch swap --src USDC --dst WETH --amount 1000000000 --slippage 1.0
+
+# --- Circle CCTP (native cross-chain USDC) ---
+defi cctp domains                                    # list supported chains + domain IDs
+# Burn 10 USDC on Base (-c 8453) and mint on Arbitrum (--to 42161).
+# Amount is in USDC base units (6 decimals): 10 USDC = 10000000
+defi -c 8453 cctp transfer --to 42161 --amount 10000000 --run-id move-usdc-1
+defi cctp status --run-id move-usdc-1                 # inspect checkpoint
+# Interrupted mid-flight? Re-run the SAME command — it resumes at attest/mint,
+# never re-burning.
+defi -c 8453 cctp transfer --to 42161 --amount 10000000 --run-id move-usdc-1
+
+# CCTP V2 — Fast Transfer (~seconds, small fee; max fee auto-fetched from Circle)
+defi -c 8453 cctp transfer --v2 --fast --to 42161 --amount 10000000 --run-id fast-1
+# CCTP V2 — Standard Transfer (hard finality, usually fee-free)
+defi -c 8453 cctp transfer --v2 --standard --to 42161 --amount 10000000 --run-id std-1
+
+# --- Preflight doctor (no transactions sent) ---
+defi -c 8453 doctor                       # RPC, chainId, signer, gas balance
+defi -c 8453 doctor --policy --amount 1000 # also evaluate the risk policy
+defi -c 8453 cctp doctor --to 42161 --amount 10000000        # CCTP V1 route
+defi -c 8453 cctp doctor --v2 --fast --to 42161 --amount 10000000  # + fee quote
+
+# --- General ---
+defi -c 1 morpho position --market ...  # specify chain
+defi --dry-run morpho supply ...         # simulate only
+```
+
+## SDK Usage
+
+```python
+from defi_autopilot.protocols.morpho import MorphoClient, BASE_MARKETS
+from defi_autopilot.protocols.moonwell import MoonwellClient
+from defi_autopilot.protocols.aave import AaveV3Client, BASE_TOKENS_AAVE
+from defi_autopilot.protocols.oneinch import OneInchClient, BASE_TOKENS_INCH
+
+# Morpho Blue
+morpho = MorphoClient(8453)
+result = morpho.supply(BASE_MARKETS["USDC-WETH-77"], amount=1000000000)
+
+# Moonwell
+moonwell = MoonwellClient(8453)
+result = moonwell.supply("USDC", amount=1000000000)
+
+# Aave V3
+aave = AaveV3Client(8453)
+result = aave.supply(BASE_TOKENS_AAVE["USDC"], amount=1000000000)
+health = aave.get_user_account_data("0xYourAddress")
+
+# 1inch
+inch = OneInchClient(8453)
+quote = inch.get_quote(
+    BASE_TOKENS_INCH["USDC"],
+    BASE_TOKENS_INCH["WETH"],
+    amount=1000000000,
+)
+
+# Circle CCTP V1 — native cross-chain USDC, resumable via state machine
+from defi_autopilot.protocols.cctp import CCTPClient
+
+cctp = CCTPClient(8453)  # source = Base
+result = cctp.transfer(
+    amount=10_000_000,        # 10 USDC (6 decimals)
+    dest_chain_id=42161,      # Arbitrum
+    run_id="move-usdc-1",     # re-run with same id to resume after a crash
+)
+# {"status": "completed", "burn_tx": ..., "mint_tx": ...}
+
+# Circle CCTP V2 — Fast Transfer (~seconds) or Standard (hard finality)
+from defi_autopilot.protocols.cctp import CCTPv2Client
+
+cctp_v2 = CCTPv2Client(8453)
+result = cctp_v2.transfer(
+    amount=10_000_000,
+    dest_chain_id=42161,
+    fast=True,                # Fast Transfer; max_fee auto-fetched from Circle
+    run_id="fast-1",
+)
+# {"status": "completed", "version": "v2", "burn_tx": ..., "mint_tx": ..., "max_fee": ...}
+```
+
+## 🛠️ Development
+
+```bash
+git clone https://github.com/counterfactual5/defi-autopilot.git
+cd defi-autopilot
+uv pip install -e ".[dev]"
+uv run pytest tests/ -v
+```
+
+167 tests covering chain config, market params, ABI validation, client initialization, token mappings, the risk-policy gate (chokepoint + ERC-20 notional), the CCTP V1/V2 transfer state machine, the CCTP preflight doctor, the top-level chain/wallet preflight doctor, the estimateGas simulation gate, RPC retry/backoff, and the configurable receipt timeout.
+
+## 🗺️ Roadmap
+
+- [x] Morpho Blue lending operations
+- [x] Moonwell supply/borrow/repay
+- [x] Aave V3 lending + health factor
+- [x] 1inch DEX aggregation
+- [x] Multi-chain (Base, Ethereum, Arbitrum, Optimism, Polygon)
+- [x] Compound V3 integration
+- [x] Circle CCTP cross-chain USDC (resumable burn & mint) — V1 + V2 (Fast/Standard)
+- [ ] Uniswap V3/V4 LP management
+- [ ] Strategy automation (auto-compound, yield optimization)
+- [ ] Position monitoring & alerting
+- [ ] WebSocket support for real-time data
+
+## Security
+
+- Private keys loaded from environment variables (never hardcoded)
+- Transactions require explicit amounts (no default all-in operations)
+- Gas estimation with 10% buffer
+- EIP-1559 fee auto-fetch
+
+## License
+
+MIT
+
+---
+
+If this project helped you, please ⭐ star this repo — it helps others find it!
+
+### Related Projects
+
+- **[uniswap-autopilot](https://github.com/counterfactual5/uniswap-autopilot)** — Deep Uniswap SDK with LP management, V4 support, and 13K lines of battle-tested code. If you need advanced Uniswap features beyond basic swaps, use that.
+- **[evm-wallet-scanner](https://github.com/counterfactual5/evm-wallet-scanner)** — Multi-chain wallet balance scanner, transaction history, and gas analytics.
+- **[erc20-checker](https://github.com/counterfactual5/erc20-checker)** — Scan and revoke ERC20 approvals across chains.

defi_omni_cli-0.2.0/defi_autopilot/__init__.py

@@ -0,0 +1,3 @@
+"""defi-autopilot — Multi-chain, multi-protocol DeFi automation toolkit."""
+
+__version__ = "0.9.0"