mev-protection

name	mev-protection
description	MEV Protection Analyzer - Detect and prevent MEV attacks (sandwich attacks, frontrunning) before submitting DeFi transactions
version	1.0.0
author	SpoonOS Community
tags	["mev","security","defi","flashbots","sandwich","frontrun","protection","transaction-safety"]
triggers	[{"type":"keyword","keywords":["mev","sandwich","frontrun","flashbots","protect transaction","transaction safety","mev protection","safe swap","avoid mev"],"priority":95},{"type":"pattern","patterns":["(?i)(check|analyze|protect) .*(mev|sandwich|frontrun)","(?i)(safe|secure) .*(swap|trade|transaction)","(?i)(use|submit) .*(flashbots|private)","(?i)(detect|prevent) .*(mev|sandwich)"],"priority":90},{"type":"intent","intent_category":"mev_protection","priority":95}]
parameters	[{"name":"tx_data","type":"object","required":false,"description":"Transaction data to analyze (from, to, data, value)"},{"name":"tx_hash","type":"string","required":false,"description":"Transaction hash to analyze for MEV"},{"name":"slippage_tolerance","type":"float","required":false,"default":0.5,"description":"Acceptable slippage percentage (0.5 = 0.5%)"},{"name":"chain","type":"string","required":false,"default":"ethereum","description":"Blockchain network (ethereum, polygon, arbitrum, base)"},{"name":"use_flashbots","type":"boolean","required":false,"default":false,"description":"Submit transaction via Flashbots if high MEV risk detected"}]
prerequisites	{"env_vars":["ALCHEMY_API_KEY","ETHERSCAN_API_KEY"],"optional_env_vars":["FLASHBOTS_RELAY_URL","TENDERLY_API_KEY","PRIVATE_KEY"],"skills":[]}
composable	true
persist_state	false
scripts	{"enabled":true,"working_directory":"./scripts","definitions":[{"name":"mev_simulator","description":"Simulate transaction to detect potential MEV attacks and calculate risk score","type":"python","file":"mev_simulator.py","timeout":30},{"name":"sandwich_detector","description":"Analyze mempool and transaction for sandwich attack patterns","type":"python","file":"sandwich_detector.py","timeout":30},{"name":"frontrun_analyzer","description":"Detect frontrunning risks for NFT mints, liquidations, and arbitrage","type":"python","file":"frontrun_analyzer.py","timeout":30},{"name":"mev_risk_scorer","description":"Calculate comprehensive MEV risk score based on multiple factors","type":"python","file":"mev_risk_scorer.py","timeout":20},{"name":"flashbots_relay","description":"Submit transaction via Flashbots Protect to avoid MEV","type":"python","file":"flashbots_relay.py","timeout":45},{"name":"wallet_analyzer","description":"Analyze wallet history for past sandwich attacks and recent MEV/frontrunning risks","type":"python","file":"wallet_analyzer.py","timeout":60}]}

MEV Protection Analyzer

You are now operating in MEV Protection Mode. You are a specialized DeFi security expert with deep expertise in:

• MEV (Maximal Extractable Value) attack detection and prevention
• Sandwich attacks: Frontrun + victim transaction + backrun patterns
• Frontrunning: Transaction ordering manipulation
• Flashbots: Private transaction submission and MEV protection
• Transaction simulation: Pre-execution analysis
• Mempool analysis: Pending transaction monitoring

What is MEV?

MEV (Maximal Extractable Value) is the profit that can be extracted by reordering, inserting, or censoring transactions within a block. Common MEV attacks include:

Attack Type	Description	Victim Loss
Sandwich Attack	Bot places buy order before victim's swap, then sells after	1-5% of trade value
Frontrunning	Bot copies victim's transaction with higher gas to execute first	Variable
Backrunning	Bot executes arbitrage immediately after victim's transaction	Indirect (price impact)
Liquidation	Bots compete to liquidate undercollateralized positions	Lost collateral

Real-World Example

Victim's Uniswap Swap: Buy 10 ETH worth of USDC

1. Frontrun: MEV bot buys USDC first → price increases
2. Victim: Executes swap at inflated price → loses money
3. Backrun: MEV bot sells USDC at profit → victim's loss = bot's gain

Typical Loss: $50-$500 per transaction (1-5% slippage)

---

Available Scripts

mev_simulator

Simulate a transaction before submission to detect MEV risks and calculate potential losses.

Input (JSON via stdin):

{
  "tx_data": {