jeremylongshore/tons-of-skills-marketplace / plugins/crypto/mempool-analyzer/skills/analyzing-mempool
analyzing-mempool
VerifiedMonitor blockchain mempools for pending transactions, gas analysis, and MEV opportunities. Use when analyzing pending transactions, optimizing gas prices, or researching MEV. Trigger with phrases like "check mempool", "scan pending txs", "find MEV", "gas price analysis", or "pending swaps".
| File | Kind | Size |
|---|---|---|
| ARD.md | markdown | 4.3 KB |
| PRD.md | markdown | 2.9 KB |
| SKILL.md | skill md | 3.7 KB |
| config/settings.yaml | config | 1004 B |
| references/errors.md | markdown | 2.6 KB |
| references/examples.md | markdown | 3.7 KB |
| references/implementation.md | markdown | 2.2 KB |
| scripts/formatters.py | script | 6.5 KB |
| scripts/gas_analyzer.py | script | 8.7 KB |
| scripts/mempool_analyzer.py | script | 9.9 KB |
| scripts/mev_detector.py | script | 12.2 KB |
| scripts/rpc_client.py | script | 10.2 KB |
| scripts/tx_decoder.py | script | 9.2 KB |
scripts/tx_decoder.py
View on GitHub#!/usr/bin/env python3
"""
Transaction Decoder
Decode Ethereum transaction input data using known ABIs.
Author: Jeremy Longshore <jeremy@intentsolutions.io>
Version: 1.0.0
License: MIT
"""
from typing import Any, Dict, Optional
from dataclasses import dataclass
# Common DEX method signatures (first 4 bytes of keccak256)
METHOD_SIGNATURES = {
# Uniswap V2 Router
"0x38ed1739": {"name": "swapExactTokensForTokens", "type": "swap"},
"0x8803dbee": {"name": "swapTokensForExactTokens", "type": "swap"},
"0x7ff36ab5": {"name": "swapExactETHForTokens", "type": "swap"},
"0x4a25d94a": {"name": "swapTokensForExactETH", "type": "swap"},
"0x18cbafe5": {"name": "swapExactTokensForETH", "type": "swap"},
"0xfb3bdb41": {"name": "swapETHForExactTokens", "type": "swap"},
"0xe8e33700": {"name": "addLiquidity", "type": "liquidity"},
"0xf305d719": {"name": "addLiquidityETH", "type": "liquidity"},
"0xbaa2abde": {"name": "removeLiquidity", "type": "liquidity"},
"0x02751cec": {"name": "removeLiquidityETH", "type": "liquidity"},
# Uniswap V3 Router
"0x414bf389": {"name": "exactInputSingle", "type": "swap"},
"0xc04b8d59": {"name": "exactInput", "type": "swap"},
"0xdb3e2198": {"name": "exactOutputSingle", "type": "swap"},
"0xf28c0498": {"name": "exactOutput", "type": "swap"},
"0x5ae401dc": {"name": "multicall", "type": "multicall"},
"0xac9650d8": {"name": "multicall", "type": "multicall"},
# ERC20
"0xa9059cbb": {"name": "transfer", "type": "transfer"},
"0x23b872dd": {"name": "transferFrom", "type": "transfer"},
"0x095ea7b3": {"name": "approve", "type": "approval"},
# Common
"0x": {"name": "ETH Transfer", "type": "transfer"},
}
# Known contract addresses
KNOWN_CONTRACTS = {
# Ethereum Mainnet
"0x7a250d5630b4cf539739df2c5dacb4c659f2488d": "Uniswap V2 Router",
"0xe592427a0aece92de3edee1f18e0157c05861564": "Uniswap V3 Router",
"0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45": "Uniswap Universal Router",
"0xd9e1ce17f2641f24ae83637ab66a2cca9c378b9f": "SushiSwap Router",
"0x1111111254fb6c44bac0bed2854e76f90643097d": "1inch Router",
"0xdef1c0ded9bec7f1a1670819833240f027b25eff": "0x Exchange Proxy",
"0x881d40237659c251811cec9c364ef91dc08d300c": "Metamask Swap Router",
# Tokens
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "WETH",
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "USDC",
"0xdac17f958d2ee523a2206206994597c13d831ec7": "USDT",
"0x6b175474e89094c44da98b954eedeac495271d0f": "DAI",
}
@dataclass
class DecodedCall:
"""Decoded function call."""
method_name: str
method_type: str # swap, transfer, approval, liquidity, multicall, unknown
contract_name: Optional[str]
raw_signature: str
params: Dict[str, Any]
@dataclass
class SwapInfo:
"""Detected swap information."""
dex: str
method: str
token_in: Optional[str]
token_out: Optional[str]
amount_in: Optional[int]
amount_out_min: Optional[int]
is_exact_input: bool
class TransactionDecoder:
"""Decode Ethereum transaction input data."""
def __init__(self, verbose: bool = False):
"""Initialize decoder."""
self.verbose = verbose
def decode_input(self, input_data: str, to_address: str = None) -> DecodedCall:
"""Decode transaction input data.
Args:
input_data: Transaction input (hex string)
to_address: Destination contract address
Returns:
DecodedCall with decoded information
"""
if not input_data or input_data == "0x":
return DecodedCall(
method_name="ETH Transfer",
method_type="transfer",
contract_name=self._get_contract_name(to_address) if to_address else None,
raw_signature="0x",
params={},
)
# Get method signature (first 4 bytes)
signature = input_data[:10].lower()
method_info = METHOD_SIGNATURES.get(
signature,
{
"name": "Unknown",
"type": "unknown",
},
)
contract_name = self._get_contract_name(to_address) if to_address else None
return DecodedCall(
method_name=method_info["name"],
method_type=method_info["type"],
contract_name=contract_name,
raw_signature=signature,
params=self._decode_params(input_data, signature),
)
def _get_contract_name(self, address: str) -> Optional[str]:
"""Get known contract name."""
if not address:
return None
return KNOWN_CONTRACTS.get(address.lower())
def _decode_params(self, input_data: str, signature: str) -> Dict[str, Any]:
"""Decode function parameters (simplified)."""
if len(input_data) < 10:
return {}
# Remove signature
data = input_data[10:]
if not data:
return {}
params = {}
# Parse 32-byte chunks
chunks = [data[i : i + 64] for i in range(0, len(data), 64)]
# For swaps, try to extract amounts
if signature in ["0x38ed1739", "0x8803dbee"]:
# swapExactTokensForTokens / swapTokensForExactTokens
if len(chunks) >= 2:
params["amountIn"] = int(chunks[0], 16) if chunks[0] else 0
params["amountOutMin"] = int(chunks[1], 16) if chunks[1] else 0
elif signature in ["0x7ff36ab5", "0xfb3bdb41"]:
# swapExactETHForTokens / swapETHForExactTokens
if len(chunks) >= 1:
params["amountOutMin"] = int(chunks[0], 16) if chunks[0] else 0
elif signature == "0xa9059cbb":
# transfer(address, uint256)
if len(chunks) >= 2:
params["to"] = "0x" + chunks[0][-40:]
params["amount"] = int(chunks[1], 16) if chunks[1] else 0
elif signature == "0x095ea7b3":
# approve(address, uint256)
if len(chunks) >= 2:
params["spender"] = "0x" + chunks[0][-40:]
params["amount"] = int(chunks[1], 16) if chunks[1] else 0
return params
def identify_dex_swap(self, input_data: str, to_address: str) -> Optional[SwapInfo]:
"""Identify if transaction is a DEX swap.
Args:
input_data: Transaction input data
to_address: Destination address
Returns:
SwapInfo if swap detected, None otherwise
"""
decoded = self.decode_input(input_data, to_address)
if decoded.method_type != "swap":
return None
dex = decoded.contract_name or "Unknown DEX"
is_exact_input = "exact" in decoded.method_name.lower() and "input" in decoded.method_name.lower()
return SwapInfo(
dex=dex,
method=decoded.method_name,
token_in=None, # Would need path decoding
token_out=None,
amount_in=decoded.params.get("amountIn"),
amount_out_min=decoded.params.get("amountOutMin"),
is_exact_input=is_exact_input,
)
def classify_transaction(self, tx: Dict) -> str:
"""Classify transaction type.
Args:
tx: Transaction dict with 'input' and 'to' fields
Returns:
Transaction type string
"""
input_data = tx.get("input_data", "") or tx.get("input", "")
to_address = tx.get("to_address", "") or tx.get("to", "")
decoded = self.decode_input(input_data, to_address)
return decoded.method_type
def estimate_attached_eth_usd_value(self, tx: Dict, eth_price: float = 3000.0) -> float:
"""Estimate USD value of ETH attached to transaction (msg.value).
Note: This only calculates the USD value of ETH sent with the transaction.
For token swaps, the actual value is in the tokens being exchanged,
not the attached ETH (which is often zero). Use this for ETH transfers
or transactions that include ETH payment.
Args:
tx: Transaction dict with 'value' field (in wei)
eth_price: Current ETH price in USD
Returns:
USD value of attached ETH (not the full transaction value for swaps)
"""
value_wei = tx.get("value", 0)
if isinstance(value_wei, str):
value_wei = int(value_wei, 16) if value_wei.startswith("0x") else int(value_wei)
value_eth = value_wei / 10**18
return value_eth * eth_price
# Backward compatibility alias
estimate_usd_value = estimate_attached_eth_usd_value
def main():
"""CLI entry point for testing."""
decoder = TransactionDecoder(verbose=True)
# Test decode
test_cases = [
("0x38ed1739" + "0" * 256, "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"),
("0xa9059cbb" + "0" * 128, "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"),
("0x", None),
]
print("=== Transaction Decoding Tests ===")
for input_data, to_addr in test_cases:
decoded = decoder.decode_input(input_data, to_addr)
print(f"\nInput: {input_data[:20]}...")
print(f" Method: {decoded.method_name}")
print(f" Type: {decoded.method_type}")
print(f" Contract: {decoded.contract_name or 'Unknown'}")
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |