cryptorugmunch
628c1d2a10
Some checks failed
CI / build (push) Failing after 3s
PHASE 2.3 (AUDIT-2026-Q3.md):
Task 1 — Wire-in Wave 3 (1 router mounted, 2 deferred):
- app.routers.unified_scanner_router mounted at /api/v2/scanner/* (2 routes:
POST /api/v2/scanner/token/scan, POST /api/v2/scanner/wallet/scan).
Refactored prefix from /api/v2 -> /api/v2/scanner to avoid future conflicts
with the v1 /api/v1/scanner/ stub.
- app.routers.unified_wallet_scanner DEFERRED (no router APIRouter attribute;
library module consumed by unified_scanner_router via get_wallet_scanner()).
- app.routers.admin_extensions DEFERRED (DORMANT per audit; 25 routes at
/api/v1/admin/* would shadow /api/v1/admin/alerts_webhook).
Task 2 — Archive 136 dead-code files to app/_archive/legacy_2026_07/:
- 73 routers in app/routers/ (reach graph showed zero reach into mount.py).
- 63 flat app/*.py (domain modules never imported by live code).
- 1 file RESTORED post-archive: app/routers/x402_bridge_health.py (caught by
tests/unit/test_bridge_health.py which directly imports it; reach graph
considered tests/ only as transitive reach — to be patched in next cycle).
Forced-LIVE (NOT archived per user directive):
- app/ai_pipeline_v3.py (3 importers in audit window, importers themselves DEAD)
- app/splade_bm25.py (LIVE via app.rag_service)
- app/wallet_manager_v2.py (LIVE via x402_enforcement, x402_tools, sweep_all, sweep_now)
- app/crypto_embeddings.py (NOT in audit ARCHIVE list; heavy import graph)
Verification (forward-import closure from mount.py + main.py + factory.py + lifespan.py):
- imports = 348 app.* modules
- reached = 194 files reachable from roots
- archive set = audit_dead (186) - reached - forced_live (4) - test_live (1) = 136
- Net delta: 136 files moved, 44,932 LOC reduction, 293->295 active routes (+2 from Wave 3)
pyproject.toml updates:
- setuptools.packages.find: added exclude for app._archive*
- ruff.extend-exclude: added "app/_archive/"
- mypy.exclude: added "app/_archive/"
Smoke test: pytest tests/ — 817 passed, 3 pre-existing failures unchanged
(0 new failures; 0 routes lost; all 4 forced-LIVE files still importable).
Restoration: git mv app/_archive/legacy_2026_07/<name>.py <original-path>
and add the import to app/mount.py ROUTER_MODULES.
Refs: AUDIT-2026-Q3.md /home/dev/pry/rmi-final-deadcode-2026-07-06.md
273 lines
9.8 KiB
Python
273 lines
9.8 KiB
Python
"""
|
|
Etherscan Family API Router - EVM Block Explorers.
|
|
Single API for: Ethereum, BSC, Polygon, Avalanche, Fantom, Arbitrum, Optimism, Base.
|
|
"""
|
|
|
|
import logging
|
|
|
|
from fastapi import APIRouter, HTTPException
|
|
from pydantic import BaseModel
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
router = APIRouter(prefix="/api/v1/etherscan", tags=["etherscan"])
|
|
|
|
|
|
# ── Models ───────────────────────────────────────────────────
|
|
|
|
|
|
class AccountQuery(BaseModel):
|
|
address: str
|
|
network: str = "eth" # eth, bsc, polygon, avalanche, fantom, arbitrum, optimism, base
|
|
page: int = 1
|
|
offset: int = 100
|
|
|
|
|
|
class TokenBalanceQuery(BaseModel):
|
|
contract: str
|
|
address: str
|
|
network: str = "eth"
|
|
|
|
|
|
class ContractQuery(BaseModel):
|
|
contract: str
|
|
network: str = "eth"
|
|
|
|
|
|
class LogsQuery(BaseModel):
|
|
from_block: int
|
|
to_block: int
|
|
address: str | None = None
|
|
topic0: str | None = None
|
|
network: str = "eth"
|
|
|
|
|
|
# ── Account API ──────────────────────────────────────────────
|
|
|
|
|
|
@router.get("/balance")
|
|
async def get_balance(address: str, network: str = "eth"):
|
|
"""Get native token balance (ETH/BNB/MATIC/etc)."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
balance = await ec.get_balance(address, network)
|
|
# Convert wei to native token
|
|
try:
|
|
native = int(balance) / 1e18 if balance else 0
|
|
except Exception:
|
|
native = 0
|
|
return {
|
|
"address": address,
|
|
"network": network,
|
|
"balance_wei": balance,
|
|
"balance_native": native,
|
|
}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
@router.get("/transactions")
|
|
async def get_transactions(address: str, network: str = "eth", page: int = 1, offset: int = 100):
|
|
"""Get transaction list for address."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
txs = await ec.get_tx_list(address, network, page=page, offset=offset)
|
|
return {
|
|
"address": address,
|
|
"network": network,
|
|
"transactions": txs[:offset],
|
|
"count": len(txs),
|
|
}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
@router.get("/token-transfers")
|
|
async def get_token_transfers(
|
|
address: str,
|
|
network: str = "eth",
|
|
contract: str | None = None,
|
|
page: int = 1,
|
|
offset: int = 100,
|
|
):
|
|
"""Get ERC-20 token transfer events."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
transfers = await ec.get_token_transfers(address, network, contract_address=contract, page=page, offset=offset)
|
|
return {
|
|
"address": address,
|
|
"network": network,
|
|
"transfers": transfers[:offset],
|
|
"count": len(transfers),
|
|
}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
@router.get("/token-balance")
|
|
async def get_token_balance(contract: str, address: str, network: str = "eth"):
|
|
"""Get ERC-20 token balance for address."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
balance = await ec.get_token_balance(contract, address, network)
|
|
return {
|
|
"contract": contract,
|
|
"address": address,
|
|
"network": network,
|
|
"balance_wei": balance,
|
|
}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
@router.get("/nft-transfers")
|
|
async def get_nft_transfers(address: str, network: str = "eth", page: int = 1, offset: int = 100):
|
|
"""Get ERC-721 NFT transfer events."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
transfers = await ec.get_erc721_transfers(address, network, page=page, offset=offset)
|
|
return {
|
|
"address": address,
|
|
"network": network,
|
|
"transfers": transfers[:offset],
|
|
"count": len(transfers),
|
|
}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
# ── Contract API ─────────────────────────────────────────────
|
|
|
|
|
|
@router.get("/contract/abi")
|
|
async def get_contract_abi(contract: str, network: str = "eth"):
|
|
"""Get contract ABI."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
abi = await ec.get_contract_abi(contract, network)
|
|
return {"contract": contract, "network": network, "abi": abi}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
@router.get("/contract/source")
|
|
async def get_contract_source(contract: str, network: str = "eth"):
|
|
"""Get contract source code."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
source = await ec.get_contract_source(contract, network)
|
|
return {"contract": contract, "network": network, "source": source}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
@router.get("/contract/verify")
|
|
async def verify_contract(contract: str, network: str = "eth"):
|
|
"""Check if contract is verified."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
result = await ec.verify_contract(contract, network)
|
|
return {"contract": contract, "network": network, **result}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
# ── Transaction API ──────────────────────────────────────────
|
|
|
|
|
|
@router.get("/tx/{tx_hash}/status")
|
|
async def get_tx_status(tx_hash: str, network: str = "eth"):
|
|
"""Get transaction status (success/fail)."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
status = await ec.get_transaction_status(tx_hash, network)
|
|
return {"tx_hash": tx_hash, "network": network, "status": status}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
# ── Block API ────────────────────────────────────────────────
|
|
|
|
|
|
@router.get("/block/latest")
|
|
async def get_latest_block(network: str = "eth"):
|
|
"""Get latest block number."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
block = await ec.get_block_number(network)
|
|
return {"network": network, "block_number": block}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
# ── Logs API ─────────────────────────────────────────────────
|
|
|
|
|
|
@router.post("/logs")
|
|
async def get_logs(req: LogsQuery):
|
|
"""Get event logs (filtered by address/topic)."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
logs = await ec.get_logs(req.from_block, req.to_block, req.address, req.topic0, req.network)
|
|
return {"network": req.network, "logs": logs, "count": len(logs)}
|
|
except ImportError:
|
|
raise HTTPException(status_code=503, detail="Etherscan connector not available") from None
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:200]) from e
|
|
|
|
|
|
# ── Health ────────────────────────────────────────────────────
|
|
|
|
|
|
@router.get("/health")
|
|
async def etherscan_health():
|
|
"""Etherscan connector status."""
|
|
try:
|
|
from app.etherscan_connector import get_etherscan_connector
|
|
|
|
ec = get_etherscan_connector()
|
|
return {"status": "ok", "service": "etherscan-connector", **ec.status()}
|
|
except ImportError:
|
|
return {"status": "ok", "service": "etherscan-connector", "networks_active": 0}
|