# SPDX-License-Identifier: CC-BY-NC-SA-4.0
openapi: 3.1.0
info:
  title: The Ethereum JSON-RPC Interface — API Commons profile
  summary: The JSON-RPC methods public EVM endpoints actually serve.
  description: '**This is a convenience wrapper, and the OpenRPC document beside it is the artifact of
    record.** JSON-RPC is a single endpoint and a method name in the request body, so there is exactly
    one path here and the method is a `const` in the body schema. A path per method would read more naturally
    and would describe an API that nobody serves.


    Every method carries `x-tier`, graded by how many public endpoints actually served it when called.
    See `profile.yml` for each grading and its evidence.


    Derived from https://github.com/ethereum/execution-apis (CC0-1.0, public domain). Ethereum JSON-RPC
    is a community specification; nothing here implies endorsement.'
  version: 1.0.0-beta.7
  contact:
    name: API Commons
    url: https://apicommons.org
  license:
    name: CC-BY-NC-SA-4.0
    url: https://creativecommons.org/licenses/by-nc-sa/4.0/
externalDocs:
  description: The profile on API Commons
  url: https://apicommons.org/standards/blockchain/
servers:
- url: https://{endpoint}
  variables:
    endpoint:
      default: rpc.example.org
      description: Any endpoint implementing this profile.
paths:
  /:
    post:
      operationId: jsonRpcCall
      summary: Call a JSON-RPC method.
      description: The method is named in the body. Each member of the `oneOf` below is one method's request
        envelope and carries its tier.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/debug_getBadBlocks'
              - $ref: '#/components/schemas/debug_getRawHeader'
              - $ref: '#/components/schemas/eth_accounts'
              - $ref: '#/components/schemas/eth_blobBaseFee'
              - $ref: '#/components/schemas/eth_blockNumber'
              - $ref: '#/components/schemas/eth_call'
              - $ref: '#/components/schemas/eth_capabilities'
              - $ref: '#/components/schemas/eth_chainId'
              - $ref: '#/components/schemas/eth_coinbase'
              - $ref: '#/components/schemas/eth_config'
              - $ref: '#/components/schemas/eth_createAccessList'
              - $ref: '#/components/schemas/eth_estimateGas'
              - $ref: '#/components/schemas/eth_feeHistory'
              - $ref: '#/components/schemas/eth_gasPrice'
              - $ref: '#/components/schemas/eth_getBalance'
              - $ref: '#/components/schemas/eth_getBlockByNumber'
              - $ref: '#/components/schemas/eth_getBlockTransactionCountByNumber'
              - $ref: '#/components/schemas/eth_getCode'
              - $ref: '#/components/schemas/eth_getFilterChanges'
              - $ref: '#/components/schemas/eth_getLogs'
              - $ref: '#/components/schemas/eth_getProof'
              - $ref: '#/components/schemas/eth_getTransactionCount'
              - $ref: '#/components/schemas/eth_maxPriorityFeePerGas'
              - $ref: '#/components/schemas/eth_newBlockFilter'
              - $ref: '#/components/schemas/eth_syncing'
              - $ref: '#/components/schemas/eth_uninstallFilter'
              - $ref: '#/components/schemas/net_version'
              - $ref: '#/components/schemas/txpool_status'
      responses:
        '200':
          description: A JSON-RPC response. Note that a method that does not exist also returns 200, carrying
            error -32601 — the status code says nothing about method support.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
components:
  schemas:
    debug_getBadBlocks:
      type: object
      title: debug_getBadBlocks
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: debug_getBadBlocks
        params:
          type: array
          title: debug_getBadBlocks params
          description: Returns an array of recent bad blocks that the client has seen on the network.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: extended
    debug_getRawHeader:
      type: object
      title: debug_getRawHeader
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: debug_getRawHeader
        params:
          type: array
          title: debug_getRawHeader params
          description: Returns an RLP-encoded header.
          minItems: 1
          maxItems: 1
          prefixItems:
          - oneOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            title: Block
          items: false
      additionalProperties: false
      x-tier: extended
    eth_accounts:
      type: object
      title: eth_accounts
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_accounts
        params:
          type: array
          title: eth_accounts params
          description: Returns a list of addresses owned by client.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: core
    eth_blobBaseFee:
      type: object
      title: eth_blobBaseFee
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_blobBaseFee
        params:
          type: array
          title: eth_blobBaseFee params
          description: Returns the base fee per blob gas in wei.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: core
    eth_blockNumber:
      type: object
      title: eth_blockNumber
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_blockNumber
        params:
          type: array
          title: eth_blockNumber params
          description: Returns the number of most recent block.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: core
    eth_call:
      type: object
      title: eth_call
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_call
        params:
          type: array
          title: eth_call params
          description: Executes a new message call immediately without creating a transaction on the block
            chain.
          minItems: 1
          maxItems: 2
          prefixItems:
          - additionalProperties: false
            properties:
              accessList:
                description: EIP-2930 access list
                items:
                  additionalProperties: false
                  properties:
                    address:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      title: hex encoded address
                      type: string
                    storageKeys:
                      items:
                        pattern: ^0x[0-9a-f]{64}$
                        title: 32 byte hex value
                        type: string
                      type: array
                  required:
                  - address
                  - storageKeys
                  title: Access list entry
                  type: object
                title: accessList
                type: array
              authorizationList:
                description: EIP-7702 authorization list
                items:
                  properties:
                    address:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      title: hex encoded address
                      type: string
                    chainId:
                      description: Chain ID on which this transaction is valid
                      pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                      title: chainId
                      type: string
                    nonce:
                      pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                      title: nonce
                      type: string
                    r:
                      pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$
                      title: r
                      type: string
                    s:
                      pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$
                      title: s
                      type: string
                    yParity:
                      description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1
                        signature
                      pattern: ^0x([0-9a-fA-F]?){1,2}$
                      title: yParity
                      type: string
                  required:
                  - chainId
                  - nonce
                  - address
                  - yParity
                  - r
                  - s
                  type: object
                title: authorizationList
                type: array
              blobVersionedHashes:
                description: List of versioned blob hashes associated with the transaction's EIP-4844
                  data blobs.
                items:
                  pattern: ^0x[0-9a-f]{64}$
                  title: 32 byte hex value
                  type: string
                title: blobVersionedHashes
                type: array
              blobs:
                description: Raw blob data.
                items:
                  pattern: ^0x[0-9a-f]*$
                  title: hex encoded bytes
                  type: string
                title: blobs
                type: array
              chainId:
                description: Chain ID that this transaction is valid on.
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: chainId
                type: string
              from:
                pattern: ^0x[0-9a-fA-F]{40}$
                title: from address
                type: string
              gas:
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: gas limit
                type: string
              gasPrice:
                description: The gas price willing to be paid by the sender in wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: gas price
                type: string
              input:
                pattern: ^0x[0-9a-f]*$
                title: input data
                type: string
              maxFeePerBlobGas:
                description: The maximum total fee per gas the sender is willing to pay for blob gas in
                  wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: max fee per blob gas
                type: string
              maxFeePerGas:
                description: The maximum total fee per gas the sender is willing to pay (includes the
                  network / base fee and miner / priority fee) in wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: max fee per gas
                type: string
              maxPriorityFeePerGas:
                description: Maximum fee per gas the sender is willing to pay to miners in wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: max priority fee per gas
                type: string
              nonce:
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: nonce
                type: string
              to:
                oneOf:
                - title: Contract Creation (null)
                  type: 'null'
                - pattern: ^0x[0-9a-fA-F]{40}$
                  title: Address
                  type: string
                title: to address
              type:
                pattern: ^0x([0-9a-fA-F]?){1,2}$
                title: type
                type: string
              value:
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: value
                type: string
            title: Transaction
            type: object
          - anyOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            - pattern: ^0x[0-9a-f]{64}$
              title: Block hash
              type: string
            title: Block
          items: false
      additionalProperties: false
      x-tier: core
    eth_capabilities:
      type: object
      title: eth_capabilities
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_capabilities
        params:
          type: array
          title: eth_capabilities params
          description: Returns effective capabilities for routing decisions.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: extended
    eth_chainId:
      type: object
      title: eth_chainId
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_chainId
        params:
          type: array
          title: eth_chainId params
          description: Returns the chain ID of the current network.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: core
    eth_coinbase:
      type: object
      title: eth_coinbase
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_coinbase
        params:
          type: array
          title: eth_coinbase params
          description: Returns the client coinbase address.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: extended
    eth_config:
      type: object
      title: eth_config
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_config
        params:
          type: array
          title: eth_config params
          description: Returns the client's current configuration including fork information.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: extended
    eth_createAccessList:
      type: object
      title: eth_createAccessList
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_createAccessList
        params:
          type: array
          title: eth_createAccessList params
          description: Generates an access list for a transaction.
          minItems: 1
          maxItems: 2
          prefixItems:
          - additionalProperties: false
            properties:
              accessList:
                description: EIP-2930 access list
                items:
                  additionalProperties: false
                  properties:
                    address:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      title: hex encoded address
                      type: string
                    storageKeys:
                      items:
                        pattern: ^0x[0-9a-f]{64}$
                        title: 32 byte hex value
                        type: string
                      type: array
                  required:
                  - address
                  - storageKeys
                  title: Access list entry
                  type: object
                title: accessList
                type: array
              authorizationList:
                description: EIP-7702 authorization list
                items:
                  properties:
                    address:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      title: hex encoded address
                      type: string
                    chainId:
                      description: Chain ID on which this transaction is valid
                      pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                      title: chainId
                      type: string
                    nonce:
                      pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                      title: nonce
                      type: string
                    r:
                      pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$
                      title: r
                      type: string
                    s:
                      pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$
                      title: s
                      type: string
                    yParity:
                      description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1
                        signature
                      pattern: ^0x([0-9a-fA-F]?){1,2}$
                      title: yParity
                      type: string
                  required:
                  - chainId
                  - nonce
                  - address
                  - yParity
                  - r
                  - s
                  type: object
                title: authorizationList
                type: array
              blobVersionedHashes:
                description: List of versioned blob hashes associated with the transaction's EIP-4844
                  data blobs.
                items:
                  pattern: ^0x[0-9a-f]{64}$
                  title: 32 byte hex value
                  type: string
                title: blobVersionedHashes
                type: array
              blobs:
                description: Raw blob data.
                items:
                  pattern: ^0x[0-9a-f]*$
                  title: hex encoded bytes
                  type: string
                title: blobs
                type: array
              chainId:
                description: Chain ID that this transaction is valid on.
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: chainId
                type: string
              from:
                pattern: ^0x[0-9a-fA-F]{40}$
                title: from address
                type: string
              gas:
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: gas limit
                type: string
              gasPrice:
                description: The gas price willing to be paid by the sender in wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: gas price
                type: string
              input:
                pattern: ^0x[0-9a-f]*$
                title: input data
                type: string
              maxFeePerBlobGas:
                description: The maximum total fee per gas the sender is willing to pay for blob gas in
                  wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: max fee per blob gas
                type: string
              maxFeePerGas:
                description: The maximum total fee per gas the sender is willing to pay (includes the
                  network / base fee and miner / priority fee) in wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: max fee per gas
                type: string
              maxPriorityFeePerGas:
                description: Maximum fee per gas the sender is willing to pay to miners in wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: max priority fee per gas
                type: string
              nonce:
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: nonce
                type: string
              to:
                oneOf:
                - title: Contract Creation (null)
                  type: 'null'
                - pattern: ^0x[0-9a-fA-F]{40}$
                  title: Address
                  type: string
                title: to address
              type:
                pattern: ^0x([0-9a-fA-F]?){1,2}$
                title: type
                type: string
              value:
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: value
                type: string
            title: Transaction
            type: object
          - oneOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            title: Block
          items: false
      additionalProperties: false
      x-tier: core
    eth_estimateGas:
      type: object
      title: eth_estimateGas
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_estimateGas
        params:
          type: array
          title: eth_estimateGas params
          description: Generates and returns an estimate of how much gas is necessary to allow the transaction
            to complete.
          minItems: 1
          maxItems: 2
          prefixItems:
          - additionalProperties: false
            properties:
              accessList:
                description: EIP-2930 access list
                items:
                  additionalProperties: false
                  properties:
                    address:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      title: hex encoded address
                      type: string
                    storageKeys:
                      items:
                        pattern: ^0x[0-9a-f]{64}$
                        title: 32 byte hex value
                        type: string
                      type: array
                  required:
                  - address
                  - storageKeys
                  title: Access list entry
                  type: object
                title: accessList
                type: array
              authorizationList:
                description: EIP-7702 authorization list
                items:
                  properties:
                    address:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      title: hex encoded address
                      type: string
                    chainId:
                      description: Chain ID on which this transaction is valid
                      pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                      title: chainId
                      type: string
                    nonce:
                      pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                      title: nonce
                      type: string
                    r:
                      pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$
                      title: r
                      type: string
                    s:
                      pattern: ^0x(0|[1-9a-f][0-9a-f]{0,63})$
                      title: s
                      type: string
                    yParity:
                      description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1
                        signature
                      pattern: ^0x([0-9a-fA-F]?){1,2}$
                      title: yParity
                      type: string
                  required:
                  - chainId
                  - nonce
                  - address
                  - yParity
                  - r
                  - s
                  type: object
                title: authorizationList
                type: array
              blobVersionedHashes:
                description: List of versioned blob hashes associated with the transaction's EIP-4844
                  data blobs.
                items:
                  pattern: ^0x[0-9a-f]{64}$
                  title: 32 byte hex value
                  type: string
                title: blobVersionedHashes
                type: array
              blobs:
                description: Raw blob data.
                items:
                  pattern: ^0x[0-9a-f]*$
                  title: hex encoded bytes
                  type: string
                title: blobs
                type: array
              chainId:
                description: Chain ID that this transaction is valid on.
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: chainId
                type: string
              from:
                pattern: ^0x[0-9a-fA-F]{40}$
                title: from address
                type: string
              gas:
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: gas limit
                type: string
              gasPrice:
                description: The gas price willing to be paid by the sender in wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: gas price
                type: string
              input:
                pattern: ^0x[0-9a-f]*$
                title: input data
                type: string
              maxFeePerBlobGas:
                description: The maximum total fee per gas the sender is willing to pay for blob gas in
                  wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: max fee per blob gas
                type: string
              maxFeePerGas:
                description: The maximum total fee per gas the sender is willing to pay (includes the
                  network / base fee and miner / priority fee) in wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: max fee per gas
                type: string
              maxPriorityFeePerGas:
                description: Maximum fee per gas the sender is willing to pay to miners in wei
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: max priority fee per gas
                type: string
              nonce:
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: nonce
                type: string
              to:
                oneOf:
                - title: Contract Creation (null)
                  type: 'null'
                - pattern: ^0x[0-9a-fA-F]{40}$
                  title: Address
                  type: string
                title: to address
              type:
                pattern: ^0x([0-9a-fA-F]?){1,2}$
                title: type
                type: string
              value:
                pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                title: value
                type: string
            title: Transaction
            type: object
          - oneOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            title: Block
          items: false
      additionalProperties: false
      x-tier: core
    eth_feeHistory:
      type: object
      title: eth_feeHistory
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_feeHistory
        params:
          type: array
          title: eth_feeHistory params
          description: Transaction fee history
          minItems: 3
          maxItems: 3
          prefixItems:
          - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
            title: blockCount
            type: string
            description: Requested range of blocks. Clients will return less than the requested range
              if not all blocks are available.
          - oneOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            title: newestBlock
            description: Highest block of the requested range.
          - items:
              description: Floating point value between 0 and 100.
              title: rewardPercentile
              type: number
            title: rewardPercentiles
            type: array
            description: A monotonically increasing list of percentile values. For each block in the requested
              range, the transactions will be sorted in ascending order by effective tip per gas and the
              corresponding effective tip for the percentile will be determined, accounting for gas consumed.
          items: false
      additionalProperties: false
      x-tier: core
    eth_gasPrice:
      type: object
      title: eth_gasPrice
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_gasPrice
        params:
          type: array
          title: eth_gasPrice params
          description: Returns the current price per gas in wei.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: core
    eth_getBalance:
      type: object
      title: eth_getBalance
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_getBalance
        params:
          type: array
          title: eth_getBalance params
          description: Returns the balance of the account of given address.
          minItems: 2
          maxItems: 2
          prefixItems:
          - pattern: ^0x[0-9a-fA-F]{40}$
            title: Address
            type: string
          - anyOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            - pattern: ^0x[0-9a-f]{64}$
              title: Block hash
              type: string
            title: Block
          items: false
      additionalProperties: false
      x-tier: core
    eth_getBlockByNumber:
      type: object
      title: eth_getBlockByNumber
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_getBlockByNumber
        params:
          type: array
          title: eth_getBlockByNumber params
          description: Returns information about a block by number.
          minItems: 2
          maxItems: 2
          prefixItems:
          - oneOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            title: Block
          - title: Hydrated transactions
            type: boolean
          items: false
      additionalProperties: false
      x-tier: core
    eth_getBlockTransactionCountByNumber:
      type: object
      title: eth_getBlockTransactionCountByNumber
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_getBlockTransactionCountByNumber
        params:
          type: array
          title: eth_getBlockTransactionCountByNumber params
          description: Returns the number of transactions in a block matching the given block number.
          minItems: 0
          maxItems: 1
          prefixItems:
          - oneOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            title: Block
          items: false
      additionalProperties: false
      x-tier: core
    eth_getCode:
      type: object
      title: eth_getCode
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_getCode
        params:
          type: array
          title: eth_getCode params
          description: Returns code at a given address.
          minItems: 2
          maxItems: 2
          prefixItems:
          - pattern: ^0x[0-9a-fA-F]{40}$
            title: Address
            type: string
          - anyOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            - pattern: ^0x[0-9a-f]{64}$
              title: Block hash
              type: string
            title: Block
          items: false
      additionalProperties: false
      x-tier: core
    eth_getFilterChanges:
      type: object
      title: eth_getFilterChanges
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_getFilterChanges
        params:
          type: array
          title: eth_getFilterChanges params
          description: Polling method for the filter with the given ID (created using `eth_newFilter`).
            Returns an array of logs, block hashes, or transaction hashes since last poll, depending on
            the installed filter.
          minItems: 1
          maxItems: 1
          prefixItems:
          - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
            title: Filter identifier
            type: string
          items: false
      additionalProperties: false
      x-tier: core
    eth_getLogs:
      type: object
      title: eth_getLogs
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_getLogs
        params:
          type: array
          title: eth_getLogs params
          description: Returns an array of all logs matching the specified filter.
          minItems: 1
          maxItems: 1
          prefixItems:
          - oneOf:
            - not:
                required:
                - blockHash
              properties:
                address:
                  oneOf:
                  - title: Any Address
                    type: 'null'
                  - pattern: ^0x[0-9a-fA-F]{40}$
                    title: Address
                    type: string
                  - items:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      title: hex encoded address
                      type: string
                    title: Addresses
                    type: array
                  title: Address(es)
                fromBlock:
                  pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                  title: from block
                  type: string
                toBlock:
                  pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
                  title: to block
                  type: string
                topics:
                  oneOf:
                  - title: Any Topic Match
                    type: 'null'
                  - items:
                      oneOf:
                      - pattern: ^0x[0-9a-f]{64}$
                        title: Single Topic Match
                        type: string
                      - items:
                          pattern: ^0x[0-9a-f]{64}$
                          title: 32 hex encoded bytes
                          type: string
                        title: Multiple Topic Match
                        type: array
                      title: Filter Topic List Entry
                    title: Specified Filter Topics
                    type: array
                  title: Topics
              title: Filter by block range
              type: object
            - properties:
                address:
                  oneOf:
                  - title: Any Address
                    type: 'null'
                  - pattern: ^0x[0-9a-fA-F]{40}$
                    title: Address
                    type: string
                  - items:
                      pattern: ^0x[0-9a-fA-F]{40}$
                      title: hex encoded address
                      type: string
                    title: Addresses
                    type: array
                  title: Address(es)
                blockHash:
                  pattern: ^0x[0-9a-f]{64}$
                  title: block hash
                  type: string
                topics:
                  oneOf:
                  - title: Any Topic Match
                    type: 'null'
                  - items:
                      oneOf:
                      - pattern: ^0x[0-9a-f]{64}$
                        title: Single Topic Match
                        type: string
                      - items:
                          pattern: ^0x[0-9a-f]{64}$
                          title: 32 hex encoded bytes
                          type: string
                        title: Multiple Topic Match
                        type: array
                      title: Filter Topic List Entry
                    title: Specified Filter Topics
                    type: array
                  title: Topics
              required:
              - blockHash
              title: Filter by block hash
              type: object
            title: Filter
          items: false
      additionalProperties: false
      x-tier: core
    eth_getProof:
      type: object
      title: eth_getProof
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_getProof
        params:
          type: array
          title: eth_getProof params
          description: Returns the merkle proof for a given account and optionally some storage keys.
          minItems: 3
          maxItems: 3
          prefixItems:
          - pattern: ^0x[0-9a-fA-F]{40}$
            title: Address
            type: string
          - items:
              pattern: ^0x[0-9a-f]{0,64}$
              title: 32 hex encoded bytes
              type: string
            title: StorageKeys
            type: array
          - anyOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            - pattern: ^0x[0-9a-f]{64}$
              title: Block hash
              type: string
            title: Block
          items: false
      additionalProperties: false
      x-tier: core
    eth_getTransactionCount:
      type: object
      title: eth_getTransactionCount
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_getTransactionCount
        params:
          type: array
          title: eth_getTransactionCount params
          description: 'Returns the nonce of an account in the state. NOTE: The name eth_getTransactionCount
            reflects the historical fact that an account''s nonce and sent transaction count were the
            same. After the Pectra fork, with the inclusion of EIP-7702, this is no longer true.'
          minItems: 2
          maxItems: 2
          prefixItems:
          - pattern: ^0x[0-9a-fA-F]{40}$
            title: Address
            type: string
          - anyOf:
            - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
              title: Block number
              type: string
            - description: '`earliest`: The lowest numbered block the client has available; `finalized`:
                The most recent crypto-economically secure block, cannot be re-orged outside of manual
                intervention driven by community coordination; `safe`: The most recent block that is safe
                from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The
                most recent block in the canonical chain observed by the client, this block may be re-orged
                out of the canonical chain even under healthy/normal conditions; `pending`: A sample next
                block built by the client on top of `latest` and containing the set of transactions usually
                taken from local mempool. Before the merge transition is finalized, any call querying
                for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error'
              enum:
              - earliest
              - finalized
              - safe
              - latest
              - pending
              title: Block tag
              type: string
            - pattern: ^0x[0-9a-f]{64}$
              title: Block hash
              type: string
            title: Block
          items: false
      additionalProperties: false
      x-tier: core
    eth_maxPriorityFeePerGas:
      type: object
      title: eth_maxPriorityFeePerGas
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_maxPriorityFeePerGas
        params:
          type: array
          title: eth_maxPriorityFeePerGas params
          description: Returns the current maxPriorityFeePerGas per gas in wei.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: core
    eth_newBlockFilter:
      type: object
      title: eth_newBlockFilter
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_newBlockFilter
        params:
          type: array
          title: eth_newBlockFilter params
          description: Creates a filter in the node, allowing for later polling. Registers client interest
            in new blocks, and returns an identifier.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: core
    eth_syncing:
      type: object
      title: eth_syncing
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_syncing
        params:
          type: array
          title: eth_syncing params
          description: Returns an object with data about the sync status or false.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: core
    eth_uninstallFilter:
      type: object
      title: eth_uninstallFilter
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: eth_uninstallFilter
        params:
          type: array
          title: eth_uninstallFilter params
          description: Uninstalls a filter with given id.
          minItems: 1
          maxItems: 1
          prefixItems:
          - pattern: ^0x(0|[1-9a-f][0-9a-f]*)$
            title: Filter identifier
            type: string
          items: false
      additionalProperties: false
      x-tier: core
    net_version:
      type: object
      title: net_version
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: net_version
        params:
          type: array
          title: net_version params
          description: Returns the current network ID. This is usually equivalent to the chainID, but
            may differ from it for some legacy networks or special testnets.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: core
    txpool_status:
      type: object
      title: txpool_status
      required:
      - jsonrpc
      - method
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        method:
          const: txpool_status
        params:
          type: array
          title: txpool_status params
          description: Returns the number of pending and queued transactions in the pool.
          minItems: 0
          maxItems: 0
          prefixItems: []
          items: false
      additionalProperties: false
      x-tier: extended
    JsonRpcResponse:
      type: object
      required:
      - jsonrpc
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id:
          type:
          - string
          - integer
        result: true
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: integer
              description: -32601 means the method is absent. Any other code means it exists and rejected
                the call.
            message:
              type: string
            data: true