@intentsolutionsio/mempool-analyzer 1.0.0 → 1.0.7

package/README.md

@@ -20,6 +20,7 @@ Advanced mempool analysis for MEV opportunities, pending transaction monitoring,
 ## Usage
 
 The mempool agent automatically activates when you discuss:
+
 - Mempool analysis and pending transactions
 - MEV opportunities and extraction strategies
 - Gas price optimization
@@ -77,6 +78,7 @@ Create a `.mempool-config.json` file:
 ## Risk Warnings
 
 ️ **Important Considerations**:
+
 - MEV extraction is highly competitive with sophisticated bots
 - Gas wars can eliminate profits quickly
 - Smart contract interactions carry inherent risks
@@ -90,7 +92,7 @@ MIT License - See LICENSE file for details
 ## Support
 
 - GitHub Issues: [Report bugs](https://github.com/jeremylongshore/claude-code-plugins/issues)
-- Documentation: [Full docs](https://docs.claude-code-plugins.com)
+- Documentation: Full docs
 
 ---
 

package/agents/mempool-agent.md

@@ -1,6 +1,34 @@
 ---
 name: mempool-agent
-description: "Mempool analysis specialist for MEV detection and transaction monitoring"
+description: Mempool analysis specialist for MEV detection and transaction monitoring
+tools:
+- Read
+- Write
+- Edit
+- Bash
+- Glob
+- Grep
+- WebFetch
+- WebSearch
+- Task
+- TodoWrite
+model: sonnet
+color: yellow
+version: 1.0.0
+author: Jeremy Longshore <jeremy@intentsolutions.io>
+tags:
+- crypto
+- mempool
+disallowedTools: []
+skills: []
+background: false
+# ── upgrade levers — uncomment + set when tuning this agent ──
+# effort: high            # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
+# maxTurns: 50            # cap the agentic loop (omit = engine default)
+# memory: project         # persistent scope: user/project/local (omit = ephemeral)
+# isolation: worktree     # run in an isolated git worktree
+# initialPrompt: "…"      # seed the agent's first turn
+# hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
 ---
 # Mempool Analysis Agent
 
@@ -9,6 +37,7 @@ You are a specialized agent for analyzing blockchain mempools, detecting MEV (Ma
 ## Your Capabilities
 
 ### Mempool Monitoring
+
 - Real-time monitoring of pending transactions across Ethereum, BSC, Polygon, and Arbitrum
 - Transaction classification (swaps, transfers, contract interactions)
 - Priority fee analysis and gas price trends
@@ -16,6 +45,7 @@ You are a specialized agent for analyzing blockchain mempools, detecting MEV (Ma
 - Mempool congestion metrics
 
 ### MEV Detection
+
 - **Sandwich attacks**: Detect front-running and back-running opportunities
 - **Arbitrage opportunities**: Multi-DEX price discrepancies in pending trades
 - **Liquidation monitoring**: Track undercollateralized positions
@@ -23,6 +53,7 @@ You are a specialized agent for analyzing blockchain mempools, detecting MEV (Ma
 - **Just-in-time (JIT) liquidity**: Uniswap v3 position optimization
 
 ### Transaction Analysis
+
 - Decode transaction calldata and extract parameters
 - Estimate profit/loss for detected MEV opportunities
 - Calculate optimal gas prices for transaction inclusion
@@ -30,6 +61,7 @@ You are a specialized agent for analyzing blockchain mempools, detecting MEV (Ma
 - Track transaction replacement (RBF) patterns
 
 ### Gas Optimization
+
 - EIP-1559 base fee prediction
 - Priority fee recommendation engine
 - Gas auction analysis
@@ -39,6 +71,7 @@ You are a specialized agent for analyzing blockchain mempools, detecting MEV (Ma
 ## When to Activate
 
 Activate this agent when users need to:
+
 - Monitor the mempool for trading opportunities
 - Detect MEV opportunities in real-time
 - Analyze pending transactions for a specific address or contract
@@ -51,6 +84,7 @@ Activate this agent when users need to:
 ## Approach
 
 ### Analysis Methodology
+
 1. **Data Collection**: Connect to mempool nodes via WebSocket or RPC endpoints
 2. **Classification**: Categorize transactions by type and intent
 3. **Pattern Recognition**: Identify MEV opportunities using heuristics and ML models
@@ -59,7 +93,9 @@ Activate this agent when users need to:
 6. **Recommendation**: Provide actionable insights with risk/reward analysis
 
 ### Output Format
+
 Present findings in structured format:
+
 ```
  MEMPOOL ANALYSIS REPORT
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -101,6 +137,7 @@ Present findings in structured format:
 ## Risk Warnings
 
 Always include appropriate risk warnings:
+
 - **MEV extraction is highly competitive** - Sophisticated bots with direct block builder relationships dominate
 - **Gas wars can eliminate profits** - Fast-moving opportunities attract aggressive bidding
 - **Smart contract risk** - Interacting with unverified contracts is dangerous
@@ -110,6 +147,7 @@ Always include appropriate risk warnings:
 ## Data Sources
 
 Primary data sources for mempool analysis:
+
 - **Flashbots Protect RPC**: MEV-protected transaction submission
 - **Blocknative Mempool Explorer**: Real-time mempool data and gas predictions
 - **Eden Network**: Priority transaction ordering
@@ -128,6 +166,7 @@ Primary data sources for mempool analysis:
 ## Technical Requirements
 
 To perform mempool analysis, ensure:
+
 - Access to archive nodes or mempool-focused RPC providers
 - WebSocket connections for real-time transaction streams
 - Transaction simulation capabilities (eth_call, Tenderly)
@@ -138,6 +177,7 @@ To perform mempool analysis, ensure:
 ## Example Queries
 
 You can answer questions like:
+
 - "What MEV opportunities are currently in the mempool?"
 - "Show me all pending large ETH transfers"
 - "What's the optimal gas price to get included in the next block?"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentsolutionsio/mempool-analyzer",
-  "version": "1.0.0",
+  "version": "1.0.7",
   "description": "Advanced mempool analysis for MEV opportunities, pending transaction monitoring, and gas price optimization",
   "keywords": [
     "crypto",

package/skills/analyzing-mempool/ARD.md

@@ -54,11 +54,13 @@ skills/analyzing-mempool/
 ## API Integration
 
 ### Ethereum RPC
+
 - **Endpoints**: `eth_pendingTransactions`, `eth_getTransactionByHash`, `eth_gasPrice`
 - **Auth**: RPC URL with API key embedded
 - **WebSocket**: `eth_subscribe` for real-time updates
 
 ### Transaction Decoding
+
 - **Router ABIs**: Uniswap V2/V3, SushiSwap, 1inch
 - **Method Detection**: Swap, addLiquidity, removeLiquidity, approve
 - **Value Estimation**: Using pool reserves or price feeds
@@ -66,6 +68,7 @@ skills/analyzing-mempool/
 ## Component Design
 
 ### rpc_client.py
+
 ```python
 class MempoolClient:
     def connect(rpc_url) -> None
@@ -75,6 +78,7 @@ class MempoolClient:
 ```
 
 ### tx_decoder.py
+
 ```python
 class TransactionDecoder:
     def decode_input(tx) -> DecodedCall
@@ -83,6 +87,7 @@ class TransactionDecoder:
 ```
 
 ### gas_analyzer.py
+
 ```python
 class GasAnalyzer:
     def analyze_pending_gas() -> GasDistribution
@@ -91,6 +96,7 @@ class GasAnalyzer:
 ```
 
 ### mev_detector.py
+
 ```python
 class MEVDetector:
     def detect_sandwich_opportunity(pending_txs) -> List[Opportunity]
@@ -124,6 +130,7 @@ class MEVDetector:
 ## DEX Detection
 
 Supported routers with ABI decoding:
+
 - Uniswap V2 Router
 - Uniswap V3 Router
 - SushiSwap Router

package/skills/analyzing-mempool/PRD.md

@@ -1,6 +1,7 @@
 # PRD: Mempool Analyzer
 
 ## Summary
+
 **One-liner**: Monitor blockchain mempools for pending transactions, gas analysis, and MEV opportunity detection
 **Domain**: Cryptocurrency / Blockchain / Trading Infrastructure
 **Users**: Traders, MEV Searchers, Protocol Developers, Researchers
@@ -8,6 +9,7 @@
 ## Problem Statement
 
 Blockchain mempools contain pending transactions waiting to be included in blocks. Understanding mempool activity is critical for:
+
 - Optimizing gas prices for transaction inclusion
 - Detecting large pending trades before execution
 - Identifying MEV (Maximal Extractable Value) opportunities

package/skills/analyzing-mempool/SKILL.md

@@ -1,16 +1,23 @@
 ---
 name: analyzing-mempool
-description: |
-  Monitor blockchain mempools for pending transactions, gas analysis, and MEV opportunities.
+description: 'Monitor 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".
 
+  Trigger with phrases like "check mempool", "scan pending txs", "find MEV", "gas
+  price analysis", or "pending swaps".
+
+  '
 allowed-tools: Read, Write, Edit, Grep, Glob, Bash(python:*mempool*)
 version: 1.0.0
 author: Jeremy Longshore <jeremy@intentsolutions.io>
 license: MIT
-compatible-with: claude-code, codex, openclaw
-tags: [crypto, monitoring, analyzing-mempool]
+tags:
+- crypto
+- monitoring
+- analyzing-mempool
+compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
 ---
 # Analyzing Mempool
 
@@ -46,6 +53,7 @@ cd ${CLAUDE_SKILL_DIR}/scripts
 6. Watch specific contract: `python mempool_analyzer.py watch 0x7a250d...`
 
 Alternatively, customize with flags:
+
 ```bash
 python mempool_analyzer.py pending --limit 100    # Limit results
 python mempool_analyzer.py --chain polygon gas     # Use different chain
@@ -55,12 +63,14 @@ python mempool_analyzer.py --chain arbitrum pending # Or use Arbitrum
 ### Step 3: Interpret Results
 
 **Gas Recommendations:**
+
 - Slow (10th percentile): May take 10+ blocks
 - Standard (50th percentile): 2-5 blocks
 - Fast (75th percentile): 1-2 blocks
 - Instant (90th percentile): Next block likely
 
 **MEV Warnings:**
+
 - MEV detection is for educational purposes
 - Real MEV extraction requires specialized infrastructure
 - Use this for research and understanding mempool dynamics
@@ -76,6 +86,7 @@ python mempool_analyzer.py --chain arbitrum pending # Or use Arbitrum
 ## Error Handling
 
 See `${CLAUDE_SKILL_DIR}/references/errors.md` for:
+
 - RPC connection issues and timeout recovery
 - Mempool access limitations per chain
 - Transaction decoding errors and fallbacks
@@ -84,17 +95,20 @@ See `${CLAUDE_SKILL_DIR}/references/errors.md` for:
 ## Examples
 
 **Example 1: Check gas before sending transaction:**
+
 ```bash
 python mempool_analyzer.py gas
 # Use "Fast" for quick confirmation
 ```
 
 **Example 2: Monitor for large pending swaps:**
+
 ```bash
 python mempool_analyzer.py swaps --limit 200  # 200: max results to scan
 ```
 
 **Example 3: Research MEV opportunities:**
+
 ```bash
 python mempool_analyzer.py mev -v
 ```

package/skills/analyzing-mempool/references/errors.md

@@ -3,31 +3,40 @@
 ## RPC Connection Errors
 
 ### Connection Refused
+
 ```
 Error: Connection refused to RPC endpoint
 ```
+
 **Cause**: RPC endpoint is down or unreachable
 **Solution**:
+
 - Check if RPC URL is correct
 - Try alternative endpoint (Alchemy, Chainstack, Infura, or public RPC)
 - Verify network connectivity
 
 ### Timeout
+
 ```
 Error: Request timed out
 ```
+
 **Cause**: RPC node is slow or overloaded
 **Solution**:
+
 - Increase timeout setting
 - Switch to faster RPC provider
 - Reduce request frequency
 
 ### Rate Limited
+
 ```
 Error: Too many requests (429)
 ```
+
 **Cause**: Exceeded RPC provider rate limits
 **Solution**:
+
 - Reduce polling frequency
 - Upgrade RPC tier (paid Alchemy, Chainstack, or Infura plans)
 - Use multiple RPC endpoints
@@ -35,21 +44,27 @@ Error: Too many requests (429)
 ## Mempool Access Errors
 
 ### txpool_content Not Available
+
 ```
 Error: txpool_content not supported
 ```
+
 **Cause**: Not all nodes support txpool methods
 **Solution**:
+
 - Use Geth node with txpool enabled
 - Try eth_pendingTransactions instead
 - Use mock data for demo purposes
 
 ### Empty Mempool
+
 ```
 No pending transactions found
 ```
+
 **Cause**: Mempool is empty or access limited
 **Solution**:
+
 - Normal during low activity periods
 - Verify RPC supports mempool access
 - Check if node is fully synced
@@ -57,32 +72,41 @@ No pending transactions found
 ## Transaction Decoding Errors
 
 ### Unknown Method Signature
+
 ```
 Warning: Unknown method 0x12345678
 ```
+
 **Cause**: Method signature not in known ABI list
 **Solution**:
+
 - Transaction will show as "Unknown" type
 - Add ABI to decoder if needed
 - Use Etherscan to look up contract ABI
 
 ### Invalid Input Data
+
 ```
 Error: Cannot decode input data
 ```
+
 **Cause**: Malformed or non-standard input
 **Solution**:
+
 - Skip transaction, continue analysis
 - Raw data still available
 
 ## Gas Analysis Errors
 
 ### No Sample Data
+
 ```
 Warning: Insufficient data for gas analysis
 ```
+
 **Cause**: Too few pending transactions
 **Solution**:
+
 - Use default recommendations
 - Wait for more mempool activity
 - Reduce sample requirements
@@ -90,11 +114,14 @@ Warning: Insufficient data for gas analysis
 ## MEV Detection Errors
 
 ### Pool Data Unavailable
+
 ```
 Warning: Cannot fetch pool reserves
 ```
+
 **Cause**: DEX subgraph or pool query failed
 **Solution**:
+
 - MEV detection will have lower confidence
 - Use estimated values
 - Check subgraph health
@@ -102,16 +129,19 @@ Warning: Cannot fetch pool reserves
 ## Debugging
 
 ### Enable Verbose Mode
+
 ```bash
 python mempool_analyzer.py -v pending
 ```
 
 ### Check Connection
+
 ```bash
 python mempool_analyzer.py status
 ```
 
 ### Test RPC Endpoint
+
 ```bash
 curl -X POST -H "Content-Type: application/json" \
   --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \

package/skills/analyzing-mempool/references/examples.md

@@ -3,16 +3,19 @@
 ## View Pending Transactions
 
 ### Basic View
+
 ```bash
 python mempool_analyzer.py pending
 ```
 
 ### Limit Results
+
 ```bash
 python mempool_analyzer.py pending --limit 20
 ```
 
 ### JSON Output
+
 ```bash
 python mempool_analyzer.py pending --format json
 ```
@@ -20,11 +23,13 @@ python mempool_analyzer.py pending --format json
 ## Gas Price Analysis
 
 ### Current Gas Prices
+
 ```bash
 python mempool_analyzer.py gas
 ```
 
 ### Gas Recommendations
+
 ```bash
 python mempool_analyzer.py gas
 # Output shows:
@@ -34,6 +39,7 @@ python mempool_analyzer.py gas
 ```
 
 ### JSON for Programmatic Use
+
 ```bash
 python mempool_analyzer.py gas --format json
 ```
@@ -41,11 +47,13 @@ python mempool_analyzer.py gas --format json
 ## Pending DEX Swaps
 
 ### View All Pending Swaps
+
 ```bash
 python mempool_analyzer.py swaps
 ```
 
 ### Analyze More Transactions
+
 ```bash
 python mempool_analyzer.py swaps --limit 200
 ```
@@ -53,16 +61,19 @@ python mempool_analyzer.py swaps --limit 200
 ## MEV Opportunity Scanning
 
 ### Scan for Opportunities
+
 ```bash
 python mempool_analyzer.py mev
 ```
 
 ### Detailed Analysis
+
 ```bash
 python mempool_analyzer.py mev --limit 300 -v
 ```
 
 ### JSON Output
+
 ```bash
 python mempool_analyzer.py mev --format json
 ```
@@ -70,6 +81,7 @@ python mempool_analyzer.py mev --format json
 ## Mempool Summary
 
 ### Quick Overview
+
 ```bash
 python mempool_analyzer.py summary
 ```
@@ -77,11 +89,13 @@ python mempool_analyzer.py summary
 ## Watch Specific Contract
 
 ### Monitor Uniswap Router
+
 ```bash
 python mempool_analyzer.py watch 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D
 ```
 
 ### Monitor Any Contract
+
 ```bash
 python mempool_analyzer.py watch 0xYOUR_CONTRACT_ADDRESS --limit 200
 ```
@@ -89,6 +103,7 @@ python mempool_analyzer.py watch 0xYOUR_CONTRACT_ADDRESS --limit 200
 ## Connection Status
 
 ### Check RPC Connection
+
 ```bash
 python mempool_analyzer.py status
 ```
@@ -96,17 +111,20 @@ python mempool_analyzer.py status
 ## Different Chains
 
 ### Polygon
+
 ```bash
 python mempool_analyzer.py --chain polygon pending
 python mempool_analyzer.py --chain polygon gas
 ```
 
 ### Arbitrum
+
 ```bash
 python mempool_analyzer.py --chain arbitrum summary
 ```
 
 ### Custom RPC URL
+
 ```bash
 python mempool_analyzer.py --rpc-url https://your-rpc.example.com pending
 ```
@@ -114,6 +132,7 @@ python mempool_analyzer.py --rpc-url https://your-rpc.example.com pending
 ## Common Workflows
 
 ### Pre-Transaction Gas Check
+
 ```bash
 # Before sending a transaction, check optimal gas
 python mempool_analyzer.py gas
@@ -124,6 +143,7 @@ python mempool_analyzer.py gas
 ```
 
 ### Monitor for Front-Running Risk
+
 ```bash
 # Check if there are pending swaps that might affect your trade
 python mempool_analyzer.py swaps
@@ -132,6 +152,7 @@ python mempool_analyzer.py swaps
 ```
 
 ### MEV Opportunity Research
+
 ```bash
 # Educational: See what MEV opportunities exist
 python mempool_analyzer.py mev -v
@@ -169,18 +190,21 @@ print(f"Pending swaps: {len(swaps)}")
 ## Integration with jq
 
 ### Filter High Gas Transactions
+
 ```bash
 python mempool_analyzer.py pending --format json | \
   jq '[.[] | select(.gas_price > 50000000000)]'
 ```
 
 ### Count by Transaction Type
+
 ```bash
 python mempool_analyzer.py swaps --format json | \
   jq 'group_by(.dex) | map({dex: .[0].dex, count: length})'
 ```
 
 ### Export Gas Data
+
 ```bash
 python mempool_analyzer.py gas --format json > gas_snapshot.json
 ```

package/skills/analyzing-mempool/references/implementation.md

@@ -5,6 +5,7 @@
 The gas analysis command calculates percentile-based recommendations from pending transactions:
 
 **Gas Recommendations:**
+
 - Slow (10th percentile): May take 10+ blocks
 - Standard (50th percentile): 2-5 blocks
 - Fast (75th percentile): 1-2 blocks
@@ -13,11 +14,13 @@ The gas analysis command calculates percentile-based recommendations from pendin
 ## MEV Detection Details
 
 MEV detection scans for common patterns:
+
 - **Sandwich attacks**: Detects front-run + back-run pairs targeting the same swap
 - **Arbitrage**: Identifies circular token paths (A→B→A) across DEXs
 - **Liquidation**: Finds health-factor monitoring and repay+seize patterns
 
 **Important:** MEV detection is for educational purposes only. Real MEV extraction requires:
+
 - Specialized block-builder infrastructure (Flashbots, MEV-Boost)
 - Sub-millisecond execution timing
 - Significant capital for gas auctions
@@ -25,6 +28,7 @@ MEV detection scans for common patterns:
 ## DEX Swap Detection
 
 The `swaps` command identifies pending DEX transactions by matching method selectors:
+
 - Uniswap V2/V3: `swapExactTokensForTokens`, `exactInputSingle`
 - SushiSwap: Same interface as Uniswap V2
 - 1inch: `swap`, `unoswap` aggregation methods
@@ -32,6 +36,7 @@ The `swaps` command identifies pending DEX transactions by matching method selec
 ## Multi-Chain Support
 
 Supported chains and their mempool characteristics:
+
 | Chain | Mempool Access | Block Time | Notes |
 |-------|---------------|------------|-------|
 | Ethereum | Full | ~12s | Richest MEV environment |
@@ -43,6 +48,7 @@ Supported chains and their mempool characteristics:
 ## Contract Watching
 
 The `watch` command monitors pending transactions to a specific contract address:
+
 1. Filters mempool by `to` address
 2. Decodes known method selectors
 3. Estimates gas cost in USD
@@ -51,11 +57,12 @@ The `watch` command monitors pending transactions to a specific contract address
 ## Configuration
 
 Edit `${CLAUDE_SKILL_DIR}/config/settings.yaml`:
+
 ```yaml
 rpc_endpoints:
-  ethereum: "https://rpc.ankr.com/eth"
-  polygon: "https://rpc.ankr.com/polygon"
-  arbitrum: "https://rpc.ankr.com/arbitrum"
+  ethereum: "eth"
+  polygon: "polygon"
+  arbitrum: "arbitrum"
 
 defaults:
   chain: ethereum

package/skills/analyzing-mempool/scripts/formatters.py

@@ -81,6 +81,7 @@ def format_pending_tx_table(
     # Create decoder only if not provided
     if decoder is None:
         from tx_decoder import TransactionDecoder
+
         decoder = TransactionDecoder()
 
     for tx in transactions[:50]:
@@ -101,7 +102,9 @@ def format_pending_tx_table(
         decoded = decoder.decode_input(tx.input_data, tx.to_address)
         tx_type = decoded.method_type[:10]
 
-        lines.append(f"{tx_hash:<18} {from_addr:<14} {to_addr:<14} {value_str:<12} {gas_price_str:<12} {gas_str:<10} {tx_type:<12}")
+        lines.append(
+            f"{tx_hash:<18} {from_addr:<14} {to_addr:<14} {value_str:<12} {gas_price_str:<12} {gas_str:<10} {tx_type:<12}"
+        )
 
     lines.append("-" * 100)
     lines.append(f"Showing {min(len(transactions), 50)} of {len(transactions)} pending transactions")
@@ -149,12 +152,7 @@ def format_pending_swaps_table(swaps: List[Any]) -> str:
     return "\n".join(lines)
 
 
-def format_mempool_summary(
-    pending_count: int,
-    gas_info: Any,
-    swap_count: int,
-    opportunities: int
-) -> str:
+def format_mempool_summary(pending_count: int, gas_info: Any, swap_count: int, opportunities: int) -> str:
     """Format mempool summary.
 
     Args:
@@ -220,6 +218,7 @@ def format_stream_alert(
     # Create decoder only if not provided
     if decoder is None:
         from tx_decoder import TransactionDecoder
+
         decoder = TransactionDecoder()
     decoded = decoder.decode_input(tx.input_data, tx.to_address)
 

package/skills/analyzing-mempool/scripts/gas_analyzer.py

@@ -9,7 +9,7 @@ Version: 1.0.0
 License: MIT
 """
 
-from typing import Dict, Any, List, Optional
+from typing import Any, List
 from dataclasses import dataclass
 import statistics
 
@@ -17,6 +17,7 @@ import statistics
 @dataclass
 class GasRecommendation:
     """Gas price recommendation."""
+
     priority: str  # slow, standard, fast, instant
     max_fee: int  # in wei
     priority_fee: int  # in wei
@@ -27,6 +28,7 @@ class GasRecommendation:
 @dataclass
 class GasDistribution:
     """Gas price distribution analysis."""
+
     min_gwei: float
     max_gwei: float
     mean_gwei: float
@@ -46,11 +48,7 @@ class GasAnalyzer:
         """Initialize gas analyzer."""
         self.verbose = verbose
 
-    def analyze_pending_gas(
-        self,
-        pending_txs: List[Any],
-        base_fee: int = None
-    ) -> GasDistribution:
+    def analyze_pending_gas(self, pending_txs: List[Any], base_fee: int = None) -> GasDistribution:
         """Analyze gas price distribution in pending transactions.
 
         Args:
@@ -110,10 +108,7 @@ class GasAnalyzer:
         )
 
     def recommend_gas(
-        self,
-        distribution: GasDistribution = None,
-        base_fee: int = None,
-        priority: str = "standard"
+        self, distribution: GasDistribution = None, base_fee: int = None, priority: str = "standard"
     ) -> GasRecommendation:
         """Get gas price recommendation.
 
@@ -176,11 +171,7 @@ class GasAnalyzer:
             confidence=confidence.get(priority, 0.5),
         )
 
-    def estimate_inclusion_time(
-        self,
-        gas_price: int,
-        distribution: GasDistribution
-    ) -> str:
+    def estimate_inclusion_time(self, gas_price: int, distribution: GasDistribution) -> str:
         """Estimate time to transaction inclusion.
 
         Args:
@@ -278,6 +269,7 @@ def main():
             self.gas_price = gas_price
 
     import random
+
     base = 30 * 10**9
     mock_txs = [MockTx(base + random.randint(-10, 30) * 10**9) for _ in range(100)]
 

package/skills/analyzing-mempool/scripts/mempool_analyzer.py

@@ -138,11 +138,7 @@ def cmd_summary(args):
     swaps = detector.detect_pending_swaps(pending, eth_price=args.eth_price)
     results = detector.detect_all_opportunities(pending, eth_price=args.eth_price)
 
-    total_opportunities = (
-        len(results["sandwich"]) +
-        len(results["arbitrage"]) +
-        len(results["liquidation"])
-    )
+    total_opportunities = len(results["sandwich"]) + len(results["arbitrage"]) + len(results["liquidation"])
 
     if args.format == "json":
         summary = {
@@ -153,12 +149,14 @@ def cmd_summary(args):
         }
         print(format_json(summary))
     else:
-        print(format_mempool_summary(
-            pending_count=len(pending),
-            gas_info=gas_info,
-            swap_count=len(swaps),
-            opportunities=total_opportunities,
-        ))
+        print(
+            format_mempool_summary(
+                pending_count=len(pending),
+                gas_info=gas_info,
+                swap_count=len(swaps),
+                opportunities=total_opportunities,
+            )
+        )
 
 
 def cmd_watch(args):
@@ -177,10 +175,7 @@ def cmd_watch(args):
 
     pending = client.get_pending_transactions(limit=args.limit, allow_mock=args.demo)
 
-    matching = [
-        tx for tx in pending
-        if tx.to_address and tx.to_address.lower() == contract
-    ]
+    matching = [tx for tx in pending if tx.to_address and tx.to_address.lower() == contract]
 
     if not matching:
         print("No pending transactions found for this contract.")
@@ -240,40 +235,42 @@ Examples:
   %(prog)s watch 0x7a250d...             Watch contract for pending txs
   %(prog)s status                        Check connection status
   %(prog)s --demo pending                Use mock data for testing
-        """
+        """,
     )
 
     parser.add_argument("-v", "--verbose", action="store_true", help="Verbose output")
-    parser.add_argument("--format", choices=["table", "json"], default="table",
-                        help="Output format")
+    parser.add_argument("--format", choices=["table", "json"], default="table", help="Output format")
     parser.add_argument("--rpc-url", help="Custom RPC URL")
-    parser.add_argument("--chain", default="ethereum",
-                        choices=["ethereum", "polygon", "arbitrum", "optimism", "base"],
-                        help="Blockchain network")
-    parser.add_argument("--eth-price", type=float, default=DEFAULT_ETH_PRICE,
-                        help=f"ETH price for USD conversion (default: {DEFAULT_ETH_PRICE})")
-    parser.add_argument("--demo", action="store_true",
-                        help="Use mock data when RPC fails (for testing/demo)")
+    parser.add_argument(
+        "--chain",
+        default="ethereum",
+        choices=["ethereum", "polygon", "arbitrum", "optimism", "base"],
+        help="Blockchain network",
+    )
+    parser.add_argument(
+        "--eth-price",
+        type=float,
+        default=DEFAULT_ETH_PRICE,
+        help=f"ETH price for USD conversion (default: {DEFAULT_ETH_PRICE})",
+    )
+    parser.add_argument("--demo", action="store_true", help="Use mock data when RPC fails (for testing/demo)")
 
     subparsers = parser.add_subparsers(dest="command", help="Command to run")
 
     # pending command
     pending_parser = subparsers.add_parser("pending", help="View pending transactions")
-    pending_parser.add_argument("--limit", type=int, default=50,
-                                help="Max transactions to show")
+    pending_parser.add_argument("--limit", type=int, default=50, help="Max transactions to show")
 
     # gas command
     subparsers.add_parser("gas", help="Analyze gas prices")
 
     # swaps command
     swaps_parser = subparsers.add_parser("swaps", help="Show pending DEX swaps")
-    swaps_parser.add_argument("--limit", type=int, default=100,
-                              help="Max transactions to analyze")
+    swaps_parser.add_argument("--limit", type=int, default=100, help="Max transactions to analyze")
 
     # mev command
     mev_parser = subparsers.add_parser("mev", help="Scan for MEV opportunities")
-    mev_parser.add_argument("--limit", type=int, default=200,
-                            help="Max transactions to analyze")
+    mev_parser.add_argument("--limit", type=int, default=200, help="Max transactions to analyze")
 
     # summary command
     subparsers.add_parser("summary", help="Mempool summary")
@@ -281,8 +278,7 @@ Examples:
     # watch command
     watch_parser = subparsers.add_parser("watch", help="Watch contract for pending txs")
     watch_parser.add_argument("contract", help="Contract address to watch")
-    watch_parser.add_argument("--limit", type=int, default=100,
-                              help="Max transactions to check")
+    watch_parser.add_argument("--limit", type=int, default=100, help="Max transactions to check")
 
     # status command
     subparsers.add_parser("status", help="Check connection status")
@@ -312,6 +308,7 @@ Examples:
         print(f"Error: {e}")
         if args.verbose:
             import traceback
+
             traceback.print_exc()
         sys.exit(1)
 

package/skills/analyzing-mempool/scripts/mev_detector.py

@@ -15,6 +15,7 @@ from dataclasses import dataclass
 
 try:
     import yaml
+
     HAS_YAML = True
 except ImportError:
     HAS_YAML = False
@@ -25,6 +26,7 @@ from tx_decoder import TransactionDecoder
 @dataclass
 class MEVOpportunity:
     """Detected MEV opportunity."""
+
     opportunity_type: str  # sandwich, arbitrage, liquidation, backrun
     target_tx: str  # Target transaction hash
     estimated_profit_usd: float
@@ -37,6 +39,7 @@ class MEVOpportunity:
 @dataclass
 class PendingSwap:
     """Detected pending swap transaction."""
+
     tx_hash: str
     dex: str
     amount_in: Optional[int]
@@ -105,10 +108,12 @@ class MEVDetector:
 
         # Default locations
         script_dir = os.path.dirname(os.path.abspath(__file__))
-        search_paths.extend([
-            os.path.join(script_dir, "..", "config", "settings.yaml"),
-            os.path.expanduser("~/.mempool_analyzer.yaml"),
-        ])
+        search_paths.extend(
+            [
+                os.path.join(script_dir, "..", "config", "settings.yaml"),
+                os.path.expanduser("~/.mempool_analyzer.yaml"),
+            ]
+        )
 
         for path in search_paths:
             if os.path.exists(path):
@@ -121,11 +126,7 @@ class MEVDetector:
 
         return None
 
-    def detect_pending_swaps(
-        self,
-        pending_txs: List[Any],
-        eth_price: float = 3000.0
-    ) -> List[PendingSwap]:
+    def detect_pending_swaps(self, pending_txs: List[Any], eth_price: float = 3000.0) -> List[PendingSwap]:
         """Identify pending swap transactions.
 
         Args:
@@ -157,21 +158,21 @@ class MEVDetector:
             # Try to identify as swap
             swap_info = self.decoder.identify_dex_swap(input_data, to_address)
             if swap_info:
-                swaps.append(PendingSwap(
-                    tx_hash=tx_hash,
-                    dex=swap_info.dex,
-                    amount_in=swap_info.amount_in,
-                    amount_out_min=swap_info.amount_out_min,
-                    gas_price=gas_price,
-                    from_address=from_address,
-                ))
+                swaps.append(
+                    PendingSwap(
+                        tx_hash=tx_hash,
+                        dex=swap_info.dex,
+                        amount_in=swap_info.amount_in,
+                        amount_out_min=swap_info.amount_out_min,
+                        gas_price=gas_price,
+                        from_address=from_address,
+                    )
+                )
 
         return swaps
 
     def detect_sandwich_opportunities(
-        self,
-        pending_swaps: List[PendingSwap],
-        eth_price: float = 3000.0
+        self, pending_swaps: List[PendingSwap], eth_price: float = 3000.0
     ) -> List[MEVOpportunity]:
         """Detect potential sandwich attack opportunities.
 
@@ -206,27 +207,27 @@ class MEVDetector:
             if estimated_profit < self.min_profit_usd:
                 continue
 
-            opportunities.append(MEVOpportunity(
-                opportunity_type="sandwich",
-                target_tx=swap.tx_hash,
-                estimated_profit_usd=estimated_profit,
-                required_capital_usd=value_usd * 0.5,  # Need capital to front-run
-                risk_level="high",  # Sandwiches are risky
-                confidence=0.3,  # Low confidence without pool analysis
-                details={
-                    "dex": swap.dex,
-                    "swap_value_usd": value_usd,
-                    "target_slippage": estimated_slippage,
-                    "gas_price_gwei": swap.gas_price / 10**9,
-                },
-            ))
+            opportunities.append(
+                MEVOpportunity(
+                    opportunity_type="sandwich",
+                    target_tx=swap.tx_hash,
+                    estimated_profit_usd=estimated_profit,
+                    required_capital_usd=value_usd * 0.5,  # Need capital to front-run
+                    risk_level="high",  # Sandwiches are risky
+                    confidence=0.3,  # Low confidence without pool analysis
+                    details={
+                        "dex": swap.dex,
+                        "swap_value_usd": value_usd,
+                        "target_slippage": estimated_slippage,
+                        "gas_price_gwei": swap.gas_price / 10**9,
+                    },
+                )
+            )
 
         return opportunities
 
     def detect_arbitrage_opportunities(
-        self,
-        pending_swaps: List[PendingSwap],
-        pool_prices: Dict[str, float] = None
+        self, pending_swaps: List[PendingSwap], pool_prices: Dict[str, float] = None
     ) -> List[MEVOpportunity]:
         """Detect arbitrage opportunities from pending swaps.
 
@@ -258,10 +259,7 @@ class MEVDetector:
 
         return opportunities
 
-    def detect_liquidation_opportunities(
-        self,
-        pending_txs: List[Any]
-    ) -> List[MEVOpportunity]:
+    def detect_liquidation_opportunities(self, pending_txs: List[Any]) -> List[MEVOpportunity]:
         """Detect pending liquidation opportunities.
 
         Args:
@@ -285,9 +283,7 @@ class MEVDetector:
         return opportunities
 
     def detect_all_opportunities(
-        self,
-        pending_txs: List[Any],
-        eth_price: float = 3000.0
+        self, pending_txs: List[Any], eth_price: float = 3000.0
     ) -> Dict[str, List[MEVOpportunity]]:
         """Run all MEV detection algorithms.
 
@@ -310,10 +306,7 @@ class MEVDetector:
 
         return results
 
-    def format_opportunities(
-        self,
-        opportunities: List[MEVOpportunity]
-    ) -> str:
+    def format_opportunities(self, opportunities: List[MEVOpportunity]) -> str:
         """Format opportunities for display.
 
         Args:
@@ -360,6 +353,7 @@ def main():
     class MockTx:
         def __init__(self, value, gas_price):
             import random
+
             self.hash = f"0x{''.join(random.choices('0123456789abcdef', k=64))}"
             self.from_address = f"0x{''.join(random.choices('0123456789abcdef', k=40))}"
             self.to_address = "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"
@@ -368,10 +362,8 @@ def main():
             self.input_data = "0x38ed1739" + "0" * 256
 
     import random
-    mock_txs = [
-        MockTx(random.randint(1, 100) * 10**18, (30 + random.randint(0, 20)) * 10**9)
-        for _ in range(20)
-    ]
+
+    mock_txs = [MockTx(random.randint(1, 100) * 10**18, (30 + random.randint(0, 20)) * 10**9) for _ in range(20)]
 
     # Detect
     print("=== Scanning for Pending Swaps ===")

package/skills/analyzing-mempool/scripts/rpc_client.py

@@ -33,6 +33,7 @@ DEFAULT_RPC_URLS = {
 @dataclass
 class PendingTransaction:
     """Represents a pending transaction in the mempool."""
+
     hash: str
     from_address: str
     to_address: Optional[str]
@@ -49,6 +50,7 @@ class PendingTransaction:
 @dataclass
 class GasInfo:
     """Current gas price information."""
+
     base_fee: int
     priority_fee: int
     gas_price: int  # legacy
@@ -58,12 +60,7 @@ class GasInfo:
 class RPCClient:
     """Ethereum JSON-RPC client for mempool access."""
 
-    def __init__(
-        self,
-        rpc_url: str = None,
-        chain: str = "ethereum",
-        verbose: bool = False
-    ):
+    def __init__(self, rpc_url: str = None, chain: str = "ethereum", verbose: bool = False):
         """Initialize RPC client.
 
         Args:
@@ -184,7 +181,9 @@ class RPCClient:
             gas=int(tx.get("gas", "0x0"), 16),
             gas_price=int(tx.get("gasPrice", "0x0"), 16),
             max_fee_per_gas=int(tx.get("maxFeePerGas", "0x0"), 16) if tx.get("maxFeePerGas") else None,
-            max_priority_fee_per_gas=int(tx.get("maxPriorityFeePerGas", "0x0"), 16) if tx.get("maxPriorityFeePerGas") else None,
+            max_priority_fee_per_gas=int(tx.get("maxPriorityFeePerGas", "0x0"), 16)
+            if tx.get("maxPriorityFeePerGas")
+            else None,
             nonce=int(tx.get("nonce", "0x0"), 16),
             input_data=tx.get("input", "0x"),
             block_number=int(tx.get("blockNumber", "0x0"), 16) if tx.get("blockNumber") else None,
@@ -209,19 +208,21 @@ class RPCClient:
 
         for i in range(min(limit, 20)):
             gas_price = base_gas_price + random.randint(-5, 20) * 10**9
-            mock_txs.append(PendingTransaction(
-                hash=f"0x{''.join(random.choices('0123456789abcdef', k=64))}",
-                from_address=f"0x{''.join(random.choices('0123456789abcdef', k=40))}",
-                to_address=random.choice(routers),
-                value=random.randint(0, 10) * 10**18,
-                gas=random.randint(100000, 500000),
-                gas_price=gas_price,
-                max_fee_per_gas=gas_price + 5 * 10**9,
-                max_priority_fee_per_gas=2 * 10**9,
-                nonce=random.randint(1, 1000),
-                input_data=swap_input + "0" * 128,
-                block_number=None,
-            ))
+            mock_txs.append(
+                PendingTransaction(
+                    hash=f"0x{''.join(random.choices('0123456789abcdef', k=64))}",
+                    from_address=f"0x{''.join(random.choices('0123456789abcdef', k=40))}",
+                    to_address=random.choice(routers),
+                    value=random.randint(0, 10) * 10**18,
+                    gas=random.randint(100000, 500000),
+                    gas_price=gas_price,
+                    max_fee_per_gas=gas_price + 5 * 10**9,
+                    max_priority_fee_per_gas=2 * 10**9,
+                    nonce=random.randint(1, 1000),
+                    input_data=swap_input + "0" * 128,
+                    block_number=None,
+                )
+            )
 
         return mock_txs
 

package/skills/analyzing-mempool/scripts/tx_decoder.py

@@ -26,7 +26,6 @@ METHOD_SIGNATURES = {
     "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"},
@@ -34,12 +33,10 @@ METHOD_SIGNATURES = {
     "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"},
 }
@@ -54,7 +51,6 @@ KNOWN_CONTRACTS = {
     "0x1111111254fb6c44bac0bed2854e76f90643097d": "1inch Router",
     "0xdef1c0ded9bec7f1a1670819833240f027b25eff": "0x Exchange Proxy",
     "0x881d40237659c251811cec9c364ef91dc08d300c": "Metamask Swap Router",
-
     # Tokens
     "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "WETH",
     "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "USDC",
@@ -66,6 +62,7 @@ KNOWN_CONTRACTS = {
 @dataclass
 class DecodedCall:
     """Decoded function call."""
+
     method_name: str
     method_type: str  # swap, transfer, approval, liquidity, multicall, unknown
     contract_name: Optional[str]
@@ -76,6 +73,7 @@ class DecodedCall:
 @dataclass
 class SwapInfo:
     """Detected swap information."""
+
     dex: str
     method: str
     token_in: Optional[str]
@@ -114,10 +112,13 @@ class TransactionDecoder:
         # Get method signature (first 4 bytes)
         signature = input_data[:10].lower()
 
-        method_info = METHOD_SIGNATURES.get(signature, {
-            "name": "Unknown",
-            "type": "unknown",
-        })
+        method_info = METHOD_SIGNATURES.get(
+            signature,
+            {
+                "name": "Unknown",
+                "type": "unknown",
+            },
+        )
 
         contract_name = self._get_contract_name(to_address) if to_address else None
 
@@ -148,7 +149,7 @@ class TransactionDecoder:
         params = {}
 
         # Parse 32-byte chunks
-        chunks = [data[i:i+64] for i in range(0, len(data), 64)]
+        chunks = [data[i : i + 64] for i in range(0, len(data), 64)]
 
         # For swaps, try to extract amounts
         if signature in ["0x38ed1739", "0x8803dbee"]:
@@ -219,11 +220,7 @@ class TransactionDecoder:
         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:
+    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.

package/skills/skill-adapter/references/README.md

@@ -1,4 +1,3 @@
 # References
 
 Bundled resources for mempool-analyzer skill
-

package/skills/skill-adapter/references/examples.md

@@ -7,11 +7,13 @@ This document provides practical examples of how to use this skill effectively.
 ### Example 1: Simple Activation
 
 **User Request:**
+
 ```
 [Describe trigger phrase here]
 ```
 
 **Skill Response:**
+
 1. Analyzes the request
 2. Performs the required action
 3. Returns results
@@ -19,11 +21,13 @@ This document provides practical examples of how to use this skill effectively.
 ### Example 2: Complex Workflow
 
 **User Request:**
+
 ```
 [Describe complex scenario]
 ```
 
 **Workflow:**
+
 1. Step 1: Initial analysis
 2. Step 2: Data processing
 3. Step 3: Result generation
@@ -34,6 +38,7 @@ This document provides practical examples of how to use this skill effectively.
 ### Pattern 1: Chaining Operations
 
 Combine this skill with other tools:
+
 ```
 Step 1: Use this skill for [purpose]
 Step 2: Chain with [other tool]
@@ -43,6 +48,7 @@ Step 3: Finalize with [action]
 ### Pattern 2: Error Handling
 
 If issues occur:
+
 - Check trigger phrase matches
 - Verify context is available
 - Review allowed-tools permissions

package/skills/skill-adapter/scripts/validation.sh

@@ -1,32 +0,0 @@
-#!/bin/bash
-# Skill validation helper
-# Validates skill activation and functionality
-
-set -e
-
-echo "🔍 Validating skill..."
-
-# Check if SKILL.md exists
-if [ ! -f "../SKILL.md" ]; then
-    echo "❌ Error: SKILL.md not found"
-    exit 1
-fi
-
-# Validate frontmatter
-if ! grep -q "^---$" "../SKILL.md"; then
-    echo "❌ Error: No frontmatter found"
-    exit 1
-fi
-
-# Check required fields
-if ! grep -q "^name:" "../SKILL.md"; then
-    echo "❌ Error: Missing 'name' field"
-    exit 1
-fi
-
-if ! grep -q "^description:" "../SKILL.md"; then
-    echo "❌ Error: Missing 'description' field"
-    exit 1
-fi
-
-echo "✅ Skill validation passed"