> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abs.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Abstract JSON-RPC API

> Single endpoint that accepts all JSON-RPC method calls



## OpenAPI

````yaml /api-reference/openapi.json post /
openapi: 3.0.0
info:
  title: Abstract JSON-RPC API
  description: JSON-RPC API documentation for Abstract blockchain
  version: 1.0.0
servers:
  - url: https://api.mainnet.abs.xyz
    description: Abstract Mainnet
security: []
tags:
  - name: Overview
    description: Overview of the Abstract JSON-RPC API
  - name: Ethereum API
    description: Standard Ethereum JSON-RPC methods
  - name: ZKSync API
    description: ZKSync-specific JSON-RPC methods
paths:
  /:
    post:
      tags:
        - Overview
      summary: Abstract JSON-RPC API
      description: Single endpoint that accepts all JSON-RPC method calls
      operationId: jsonrpc
      parameters:
        - name: method
          in: query
          schema:
            type: string
            enum:
              - eth_chainId
              - eth_call
              - eth_estimateGas
              - eth_gasPrice
              - eth_newFilter
              - eth_newBlockFilter
              - eth_uninstallFilter
              - eth_newPendingTransactionFilter
              - eth_getLogs
              - eth_getFilterLogs
              - eth_getFilterChanges
              - eth_getBalance
              - eth_getBlockByNumber
              - eth_getBlockByHash
              - eth_getBlockTransactionCountByNumber
              - eth_getBlockReceipts
              - eth_getBlockTransactionCountByHash
              - eth_getCode
              - eth_getStorageAt
              - eth_getTransactionCount
              - eth_getTransactionByHash
              - eth_getTransactionByBlockHashAndIndex
              - eth_getTransactionReceipt
              - eth_protocolVersion
              - eth_sendRawTransaction
              - eth_accounts
              - eth_feeHistory
              - web3_clientVersion
          description: The JSON-RPC method to call
          required: false
      requestBody:
        required: true
        content:
          application/json:
            schema:
              oneOf:
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_chainId
                      description: Gets the current chain ID
                    params:
                      type: array
                      items: {}
                      description: Parameters (empty for this method)
                      default: []
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_call
                      description: >-
                        Executes a new message call immediately without creating
                        a transaction
                    params:
                      type: array
                      items: {}
                      description: Call parameters
                      default:
                        - to: '0xc94770007dda54cF92009BFF0dE90c06F603a09f'
                        - latest
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_estimateGas
                      description: Estimates the amount of gas needed to execute a call
                    params:
                      type: array
                      items: {}
                      description: Parameters for gas estimation
                      default:
                        - to: '0xc94770007dda54cF92009BFF0dE90c06F603a09f'
                          data: 0x
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_gasPrice
                      description: Returns the current gas price in wei
                    params:
                      type: array
                      items: {}
                      description: No parameters
                      default: []
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_newFilter
                      description: Creates a filter object to notify when the state changes
                    params:
                      type: array
                      items: {}
                      description: Filter options
                      default:
                        - topics:
                            - >-
                              0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_newBlockFilter
                      description: Creates a filter to notify when a new block arrives
                    params:
                      type: array
                      items: {}
                      description: No parameters
                      default: []
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_uninstallFilter
                      description: Uninstalls a filter with the given ID
                    params:
                      type: array
                      items: {}
                      description: Filter ID
                      default:
                        - >-
                          0xb415d4b0e6ca750802be8c84c99a68170deeb9ed09c4e2eb0dc5299ab715e978
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_newPendingTransactionFilter
                      description: >-
                        Creates a filter to notify when new pending transactions
                        arrive
                    params:
                      type: array
                      items: {}
                      description: No parameters
                      default: []
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getLogs
                      description: Returns logs matching the filter criteria
                    params:
                      type: array
                      items: {}
                      description: Filter options
                      default:
                        - fromBlock: '0x1'
                          toBlock: '0x2'
                          address: '0x8320fe7702b96808f7bbc0d4a888ed1468216cfd'
                          topics:
                            - >-
                              0xd78a0cb8bb633d06981248b816e7bd33c2a35a6089241d099fa519e361cab902
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getFilterLogs
                      description: Returns logs for the specified filter
                    params:
                      type: array
                      items: {}
                      description: Filter ID
                      default:
                        - >-
                          0xb415d4b0e6ca750802be8c84c99a68170deeb9ed09c4e2eb0dc5299ab715e978
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getFilterChanges
                      description: Returns filter changes since last poll
                    params:
                      type: array
                      items: {}
                      description: Filter ID
                      default:
                        - >-
                          0xb415d4b0e6ca750802be8c84c99a68170deeb9ed09c4e2eb0dc5299ab715e978
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getBalance
                      description: Returns the balance of the given address
                    params:
                      type: array
                      items: {}
                      description: Address and block parameter
                      default:
                        - '0x8fe5810cd78eb8d8b9abad8527dfc1265bee6c56'
                        - latest
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getBlockByNumber
                      description: Returns information about a block by number
                    params:
                      type: array
                      items: {}
                      description: Block number and transaction details flag
                      default:
                        - '0x1b4'
                        - false
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getBlockByHash
                      description: Returns information about a block by hash
                    params:
                      type: array
                      items: {}
                      description: Block hash and transaction details flag
                      default:
                        - >-
                          0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae
                        - false
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getBlockTransactionCountByNumber
                      description: >-
                        Returns the number of transactions in a block by block
                        number
                    params:
                      type: array
                      items: {}
                      description: Block number
                      default:
                        - '0x1b4'
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getBlockReceipts
                      description: Returns all transaction receipts for a given block
                    params:
                      type: array
                      items: {}
                      description: Block parameter (number or hash)
                      default:
                        - '0x1b4'
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getBlockTransactionCountByHash
                      description: >-
                        Returns the number of transactions in a block by block
                        hash
                    params:
                      type: array
                      items: {}
                      description: Block hash
                      default:
                        - >-
                          0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getCode
                      description: Returns the code stored at the given address
                    params:
                      type: array
                      items: {}
                      description: Address and block parameter
                      default:
                        - '0x8fe5810cd78eb8d8b9abad8527dfc1265bee6c56'
                        - latest
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getStorageAt
                      description: >-
                        Returns the value from a storage position at a given
                        address
                    params:
                      type: array
                      items: {}
                      description: Address, storage position, and block parameter
                      default:
                        - '0x8fe5810cd78eb8d8b9abad8527dfc1265bee6c56'
                        - '0x0'
                        - latest
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getTransactionCount
                      description: Returns the number of transactions sent from an address
                    params:
                      type: array
                      items: {}
                      description: Address and block parameter
                      default:
                        - '0x8fe5810cd78eb8d8b9abad8527dfc1265bee6c56'
                        - latest
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getTransactionByHash
                      description: Returns information about a transaction by hash
                    params:
                      type: array
                      items: {}
                      description: Transaction hash
                      default:
                        - >-
                          0xef395f7a595f28e833583c50c2e1949a15516a2e0f346b8891024ecf8ca825ec
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getTransactionByBlockHashAndIndex
                      description: >-
                        Returns information about a transaction by block hash
                        and index
                    params:
                      type: array
                      items: {}
                      description: Block hash and transaction index
                      default:
                        - >-
                          0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae
                        - '0x0'
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_getTransactionReceipt
                      description: Returns the receipt of a transaction by hash
                    params:
                      type: array
                      items: {}
                      description: Transaction hash
                      default:
                        - >-
                          0x5e98cafbdbb08e77c77a942314c7dd45a6f0ba4ffcc4428303bf814e1a1645a9
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_protocolVersion
                      description: Returns the current Ethereum protocol version
                    params:
                      type: array
                      items: {}
                      description: No parameters
                      default: []
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_sendRawTransaction
                      description: Submits a pre-signed transaction for broadcast
                    params:
                      type: array
                      items: {}
                      description: Signed transaction data
                      default:
                        - >-
                          0xf86c808504a817c80082520894095e7baea6a6c7c4c2dfeb977efac326af552d870a8e8...
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_accounts
                      description: Returns a list of addresses owned by the client
                    params:
                      type: array
                      items: {}
                      description: No parameters
                      default: []
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                    - params
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - eth_feeHistory
                      description: Returns fee data for historical blocks
                    params:
                      type: array
                      items: {}
                      description: Block count, latest block, and reward percentiles
                      default:
                        - '10'
                        - '0x3039'
                        - - 25
                          - 50
                          - 75
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
                - type: object
                  required:
                    - jsonrpc
                    - method
                    - id
                  properties:
                    jsonrpc:
                      type: string
                      default: '2.0'
                      description: JSON-RPC version
                    method:
                      type: string
                      enum:
                        - web3_clientVersion
                      description: Returns the current client version
                    params:
                      type: array
                      items: {}
                      description: No parameters
                      default: []
                    id:
                      type: integer
                      default: 1
                      description: Request identifier
            examples:
              eth_chainId:
                value:
                  jsonrpc: '2.0'
                  id: 1
                  method: eth_chainId
                  params: []
              eth_call:
                value:
                  jsonrpc: '2.0'
                  id: 1
                  method: eth_call
                  params:
                    - to: '0xc94770007dda54cF92009BFF0dE90c06F603a09f'
                    - latest
              eth_estimateGas:
                value:
                  jsonrpc: '2.0'
                  id: 1
                  method: eth_estimateGas
                  params:
                    - to: '0xc94770007dda54cF92009BFF0dE90c06F603a09f'
                      data: 0x
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      jsonrpc:
                        type: string
                        example: '2.0'
                      id:
                        type: integer
                        example: 1
                      result:
                        type: string
                        description: Response for eth_chainId
                        example: '0x144'
                  - type: object
                    properties:
                      jsonrpc:
                        type: string
                        example: '2.0'
                      id:
                        type: integer
                        example: 1
                      result:
                        type: string
                        description: Response for eth_call
                        example: 0x
                  - type: object
                    properties:
                      jsonrpc:
                        type: string
                        example: '2.0'
                      id:
                        type: integer
                        example: 1
                      result:
                        type: string
                        description: Response for eth_estimateGas
                        example: '0x5cec'
                  - type: object
                    properties:
                      jsonrpc:
                        type: string
                        example: '2.0'
                      id:
                        type: integer
                        example: 1
                      result:
                        type: string
                        description: Response for eth_gasPrice
                        example: '0x17d7840'
                  - type: object
                    properties:
                      jsonrpc:
                        type: string
                        example: '2.0'
                      id:
                        type: integer
                        example: 1
                      error:
                        type: object
                        properties:
                          code:
                            type: integer
                          message:
                            type: string
              examples:
                eth_chainId:
                  value:
                    jsonrpc: '2.0'
                    result: '0x144'
                    id: 1
                eth_call:
                  value:
                    jsonrpc: '2.0'
                    result: 0x
                    id: 1
                eth_estimateGas:
                  value:
                    jsonrpc: '2.0'
                    id: 1
                    result: '0x5cec'
                eth_gasPrice:
                  value:
                    jsonrpc: '2.0'
                    result: '0x17d7840'
                    id: 1
                error:
                  value:
                    jsonrpc: '2.0'
                    id: 1
                    error:
                      code: -32602
                      message: Invalid params

````