AMEN — Web3 Agent Analyzer

About AMEN

AMEN is a lightweight analyzer for Web3 agents. It scores execution performance, flags suspicious execution patterns, and highlights vulnerabilities in smart contract integration.

Core features

Performance scoring

Measures success rate, revert rate, gas consumption, latency, and reward efficiency.

Risk detection

Flags high error and revert rates, excessive slippage, and gas risk.

Contract analysis

Inspects smart contract source for unsafe patterns like delegatecall, tx.origin, and unchecked blocks.

AI summary

Optional OpenAI-powered summary makes findings easier to understand with a single look.

Get started

Run AMEN locally against a JSON report file containing agent metrics, transaction history, and contract source information.

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python -m web3_agent_analyzer.cli sample_agent_run.json

If you want an AI-powered summary, set OPENAI_API_KEY before running the analyzer.

Contract Analyzer

Paste a smart contract or agent data to scan for vulnerabilities and performance issues.

Sample input

AMEN analyzes structured JSON like this:

{
  "agent_name": "arb_bot_v2",
  "performance_metrics": {
    "error_rate": 0.15,
    "revert_rate": 0.08,
    "average_gas": 412000,
    "average_slippage": 0.035
  },
  "transaction_history": [ ... ],
  "smart_contracts": [ ... ]
}

Where AMEN helps

Spot agent failures before they cause financial loss.
Detect risky contract interactions and poor gas planning.
Validate on-chain automation behavior for DeFi and trading bots.

Web3 agent performance & vulnerability analyzer