Files
smom-dbis-138/docs/guides/ETHERSCAN_GAS_API_INTEGRATION.md
defiQUG 1fb7266469 Add Oracle Aggregator and CCIP Integration
- Introduced Aggregator.sol for Chainlink-compatible oracle functionality, including round-based updates and access control.
- Added OracleWithCCIP.sol to extend Aggregator with CCIP cross-chain messaging capabilities.
- Created .gitmodules to include OpenZeppelin contracts as a submodule.
- Developed a comprehensive deployment guide in NEXT_STEPS_COMPLETE_GUIDE.md for Phase 2 and smart contract deployment.
- Implemented Vite configuration for the orchestration portal, supporting both Vue and React frameworks.
- Added server-side logic for the Multi-Cloud Orchestration Portal, including API endpoints for environment management and monitoring.
- Created scripts for resource import and usage validation across non-US regions.
- Added tests for CCIP error handling and integration to ensure robust functionality.
- Included various new files and directories for the orchestration portal and deployment scripts.
2025-12-12 14:57:48 -08:00

1.8 KiB

Etherscan Gas API v2 Integration

Overview

The deployment cost estimation system now uses the correct Etherscan Gas API v2 endpoint for accurate gas price retrieval.

API Endpoint

Correct Endpoint: https://api.etherscan.io/v2/api?chainid=1&module=gastracker&action=gasoracle&apikey=YourApiKeyToken

Response Format

{
  "status": "1",
  "message": "OK",
  "result": {
    "LastBlock": "23788262",
    "SafeGasPrice": "0.111829336",
    "ProposeGasPrice": "0.11182936",
    "FastGasPrice": "0.123012296",
    "suggestBaseFee": "0.111829336",
    "gasUsedRatio": "..."
  }
}

Integration

Gas Price Sources (Priority Order)

  1. MetaMask (via ETHEREUM_MAINNET_RPC)
  2. Etherscan Gas API v2 (via ETHERSCAN_API_KEY)
  3. Default RPC (fallback)

Methodology

Conservative Gas Price = MIN(MAX(MetaMask Gas, Etherscan Gas), 2.5 gwei)
  • Fetches from both MetaMask and Etherscan
  • Selects the highest price
  • Caps at 2.5 gwei maximum

Usage

Get Conservative Gas Price

./scripts/deployment/get-conservative-gas-price.sh

Calculate Costs

./scripts/deployment/calculate-conservative-costs.sh

Test API

./scripts/deployment/test-etherscan-gas-api.sh

Configuration

Add to .env:

ETHERSCAN_API_KEY=your_api_key_here
ETHEREUM_MAINNET_RPC=https://...

Current Status

  • API endpoint corrected to v2 format
  • Response parsing handles both v1 and v2 formats
  • Gas price extraction working correctly
  • Display formatting improved
  • Conservative calculation using 2.5 gwei cap

Notes

  • Current gas prices (~0.1 gwei) are extremely low and not normal
  • System uses actual prices when below 2.5 gwei cap
  • For budgeting, consider normal market conditions (30-50 gwei)