Module contract 

Smart contract analysis module.

Provides contract source retrieval, ABI decoding, proxy detection, access control mapping, vulnerability scanning, DeFi protocol checks, and external intelligence (GitHub linking, audit reports).

Smart Contract Analysis Module

Provides comprehensive contract analysis capabilities for EVM-compatible blockchain contracts, including:

• Source code retrieval from block explorers (Etherscan, Sourcify)
• ABI parsing and function signature decoding (4byte.directory)
• Proxy pattern detection (EIP-1967, EIP-1822, UUPS, Transparent)
• Access control mapping (Ownable, AccessControl, Roles)
• Vulnerability heuristics (reentrancy, unchecked calls, selfdestruct, etc.)
• DeFi protocol checks (oracle manipulation, flash loans, lending, swaps)
• External intelligence (GitHub linking, audit report discovery)

Architecture

The module is organized into submodules that build on each other:

contract::source       → Raw data retrieval (source, ABI, bytecode metadata)
contract::abi          → Function signature lookup and calldata decoding
contract::proxy        → Proxy pattern identification and implementation resolution
contract::access       → Access control and privilege mapping
contract::vulnerability → Security heuristic scanning
contract::defi         → DeFi-specific protocol analysis
contract::external     → GitHub repo linking and audit report discovery

Modules

abi

ABI Parsing and Function Signature Decoding

access

Access Control Mapping

defi

DeFi Protocol Analysis

external

External Intelligence

proxy

Proxy Pattern Detection

source

Contract Source Code Retrieval

vulnerability

Vulnerability Heuristic Scanner

Structs

ContractAnalysis

Complete contract analysis result aggregating all submodule outputs.

Functions

analyze_contract

Run a full contract analysis pipeline on an address.