optimizing-gas-fees

SKILL.md

Optimizing Gas Fees

Overview

Gas fee optimization skill that:

  • Fetches real-time gas prices from multiple sources
  • Estimates transaction costs in ETH and USD
  • Analyzes historical patterns to find optimal timing
  • Predicts future gas prices
  • Compares gas across multiple chains

Prerequisites

  • Python 3.8+ with requests library
  • Network access to RPC endpoints
  • Optional: ETHERSCAN_API_KEY for higher rate limits
  • Optional: Custom RPC URLs via environment variables

Instructions

  1. Check current gas prices (optionally for a specific chain):
    cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py current
    cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py current --chain polygon
    
  2. Estimate transaction cost for known operations or custom gas limits (available operations: eth_transfer, erc20_transfer, erc20_approve, uniswap_v2_swap, uniswap_v3_swap, sushiswap_swap, curve_swap, nft_mint, nft_transfer, opensea_listing, aave_deposit, aave_withdraw, compound_supply, compound_borrow, bridge_deposit):
    cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py estimate --operation uniswap_v2_swap --all-tiers
    cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py estimate --gas-limit 150000 --tier fast  # 150000 = configured value
    
  3. Find the optimal transaction window with lowest expected gas:
    cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py optimal
    
  4. View gas patterns (hourly or daily):
    cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py patterns
    cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py patterns --daily
    
  5. Predict future gas prices for a given hour:
    cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py predict --time 14
    
  6. Compare gas prices across multiple chains:
    cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py compare
    
  7. View base fee history for recent blocks:
    cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py history --blocks 50
    

Output

  • Current: Base fee, priority fee, and tier prices (slow/standard/fast/instant)
  • Estimate: Gas cost in native token and USD for each tier
  • Patterns: Historical hourly/daily patterns with low-gas markers
  • Optimal: Recommended transaction window with expected savings
  • Predict: Gas forecast for specific time with confidence
  • Compare: Side-by-side gas prices across chains

Supported Chains

Chain Native Token Block Time
Ethereum ETH ~12 sec
Polygon MATIC ~2 sec
Arbitrum ETH ~0.25 sec
Optimism ETH ~2 sec
Base ETH ~2 sec

Price Tiers

Tier Percentile Confirmation Time
Slow 10th 10+ blocks (~2+ min)
Standard 50th 3-5 blocks (~1 min)
Fast 75th 1-2 blocks (~30 sec)
Instant 90th Next block (~12 sec)

Error Handling

See ${CLAUDE_SKILL_DIR}/references/errors.md for:

  • RPC connection issues
  • API rate limiting
  • Price feed errors
  • Pattern analysis errors

Examples

See ${CLAUDE_SKILL_DIR}/references/examples.md for:

  • Quick start commands
  • Cost estimation scenarios
  • Multi-chain comparison
  • Practical workflows

Resources

Weekly Installs
18
GitHub Stars
1.6K
First Seen
Feb 4, 2026
Installed on
codex17
opencode16
gemini-cli16
cursor16
openclaw16
antigravity15