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
120 lines
4.1 KiB
Python
120 lines
4.1 KiB
Python
"""
|
|
Forensics API Router - Deep contract scan + cross-chain correlation + risk reports.
|
|
Connects to /api/v1/forensics/*
|
|
"""
|
|
|
|
from fastapi import APIRouter, HTTPException, Query
|
|
from pydantic import BaseModel
|
|
|
|
router = APIRouter(prefix="/api/v1/forensics", tags=["forensics"])
|
|
|
|
|
|
class DeepScanRequest(BaseModel):
|
|
contract_address: str
|
|
chain: str = "base"
|
|
|
|
|
|
class BatchScanRequest(BaseModel):
|
|
contracts: list[str]
|
|
chain: str = "base"
|
|
|
|
|
|
class RiskReportRequest(BaseModel):
|
|
token_address: str
|
|
chain: str = "solana"
|
|
include_graph: bool = False
|
|
|
|
|
|
class ThreatCheckRequest(BaseModel):
|
|
address: str
|
|
chain_id: str = "1" # 1=ethereum, 56=bsc, 8453=base, solana=solana
|
|
|
|
|
|
@router.post("/deep-scan")
|
|
async def deep_scan(req: DeepScanRequest):
|
|
"""Deep contract scan using slither/mythril."""
|
|
try:
|
|
from app.contract_deepscan import deep_scan_contract
|
|
|
|
result = deep_scan_contract(req.contract_address, chain=req.chain)
|
|
return {"contract": req.contract_address, "chain": req.chain, "scan": result}
|
|
except ImportError as e:
|
|
raise HTTPException(status_code=503, detail=f"Scanner unavailable: {e}") from e
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:500]) from e
|
|
|
|
|
|
@router.post("/batch-scan")
|
|
async def batch_deep_scan(req: BatchScanRequest):
|
|
"""Batch deep scan multiple contracts."""
|
|
try:
|
|
from app.contract_deepscan import batch_deep_scan
|
|
|
|
result = batch_deep_scan(req.contracts, chain=req.chain)
|
|
return {"contracts": len(req.contracts), "chain": req.chain, "results": result}
|
|
except ImportError as e:
|
|
raise HTTPException(status_code=503, detail=str(e)) from e
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:500]) from e
|
|
|
|
|
|
@router.post("/risk-report")
|
|
async def risk_report(req: RiskReportRequest):
|
|
"""Generate comprehensive rug risk report."""
|
|
try:
|
|
from app.advanced_analysis import RugRiskReport
|
|
|
|
report = RugRiskReport(token_address=req.token_address, chain=req.chain)
|
|
return {"token_address": req.token_address, "chain": req.chain, "report": str(report)}
|
|
except ImportError as e:
|
|
raise HTTPException(status_code=503, detail=str(e)) from e
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:500]) from e
|
|
|
|
|
|
@router.post("/cross-chain")
|
|
async def cross_chain_correlate(addresses: list[str] = Query(...), chains: list[str] | None = Query(None)):
|
|
"""Correlate wallets across chains using behavioral fingerprinting + CEX patterns."""
|
|
try:
|
|
from app.cross_chain_correlator import get_cross_chain_correlator
|
|
|
|
cc = get_cross_chain_correlator()
|
|
profiles = await cc.correlate(addresses=addresses, chains=chains)
|
|
return {
|
|
"addresses_scanned": len(addresses),
|
|
"profiles_found": len(profiles),
|
|
"profiles": [
|
|
{
|
|
"entity_id": p.entity_id,
|
|
"total_addresses": p.total_addresses,
|
|
"chains": dict(p.chains),
|
|
"links": len(p.links),
|
|
"risk_score": p.risk_score,
|
|
}
|
|
for p in profiles
|
|
],
|
|
}
|
|
except ImportError as e:
|
|
raise HTTPException(status_code=503, detail=str(e)) from e
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:500]) from e
|
|
|
|
|
|
@router.get("/health")
|
|
async def forensics_health():
|
|
return {"status": "ok", "service": "forensics-engine"}
|
|
|
|
|
|
@router.post("/threat-check")
|
|
async def threat_check(req: ThreatCheckRequest):
|
|
"""Multi-source threat intel check: CryptoScamDB + GoPlus + Januus (all free)."""
|
|
try:
|
|
from app.threat_feeds import get_threat_feeds
|
|
|
|
feeds = get_threat_feeds()
|
|
result = await feeds.full_check(address=req.address, chain_id=req.chain_id)
|
|
return result
|
|
except ImportError as e:
|
|
raise HTTPException(status_code=503, detail=str(e)) from e
|
|
except Exception as e:
|
|
raise HTTPException(status_code=500, detail=str(e)[:500]) from e
|