evm-proxy-upgrade-analyzer

name	evm-proxy-upgrade-analyzer
track	web3-core-operations
version	0.1.0
summary	Detect EVM proxy patterns (EIP-1967, Beacon, EIP-1167 minimal proxy) and report implementation/admin/beacon addresses plus upgrade risk flags.
description	Detect common EVM proxy patterns and extract upgrade-related addresses and risk signals.
author	guangyusong
tags	["evm","proxy","eip-1967","uups","security"]

Description

Detect common EVM proxy patterns and report implementation/admin/beacon addresses along with basic upgrade risk flags.

Inputs

{
  "rpc_url": "https://...",
  "proxy_address": "0x...",
  "block": "latest",
  "timeout_seconds": 20,
  "check_uups": true,
  "check_beacon_impl": true
}

Outputs

Success:

{
  "ok": true,
  "data": {
    "demo": false,
    "proxy_address": "0x...",
    "proxy_type": "NOT_A_CONTRACT|EIP-1167_MINIMAL|EIP-1967_PROXY|EIP-1967_BEACON|UNKNOWN",
    "implementation_address": "0x..." ,
    "admin_address": "0x...",
    "beacon_address": "0x...",
    "beacon_implementation_address": "0x...",
    "is_uups": true,
    "risk_score": 0,
    "risk_flags": []
  }
}

Error:

{
  "ok": false,
  "error": "...",
  "details": {"message": "..."}
}

Usage

Demo mode (offline):

python3 scripts/main.py --demo

With parameters:

python3 scripts/main.py --params '{"rpc_url":"https://...","proxy_address":"0x..."}'

Via stdin:

echo '{"rpc_url":"https://...","proxy_address":"0x..."}' | python3 scripts/main.py

Error Handling

All errors return JSON with ok:false and exit with a non-zero code.