ethereum-network-schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "chainID": { "type": "integer" },
    "nodeURL": { "type": "string" },
    "nativeCurrencySymbol": { "type": "string" },
    "geckoId": {
      "type": "string",
      "description": "GeckoTerminal network ID for this network (e.g., 'eth' for mainnet, 'base' for Base)"
    },
    "swapProvider": {
      "type": "string",
      "description": "Default swap provider used by the unified /trading/swap routes when no connector is specified (format: connector/type)",
      "enum": [
        "uniswap/router",
        "0x/router",
        "pancakeswap/router",
        "uniswap/amm",
        "uniswap/clmm",
        "pancakeswap/amm",
        "pancakeswap/clmm"
      ],
      "default": "uniswap/router"
    },
    "transactionExecutionTimeoutMs": {
      "type": "number",
      "description": " Timeout for waiting for transaction execution (in milliseconds)"
    },
    "gasPrice": {
      "type": ["number", "null"],
      "description": "Gas price in GWEI for legacy (non-EIP-1559) networks (optional, will fetch from network RPC if not set)"
    },
    "baseFee": {
      "type": ["number", "null"],
      "description": "EIP-1559 base fee in GWEI (optional, will fetch from network or Etherscan API if not set)"
    },
    "priorityFee": {
      "type": ["number", "null"],
      "description": "EIP-1559 priority fee in GWEI (optional, will fetch from network or Etherscan API if not set)"
    },
    "baseFeeMultiplier": {
      "type": "number",
      "description": "EIP-1559 base fee multiplier for maxFeePerGas calculation (default: 1.2)",
      "default": 1.2
    }
  },
  "required": ["chainID", "nodeURL", "nativeCurrencySymbol", "geckoId"],
  "additionalProperties": false
}