Data Source: Ethereum Blockchain

⚠ Warning
This data source adapter is still in alpha stage and may not be stable.

The Ethereum Blockchain data source adapter enables you to query the Ethereum blockchain.


To set up this adapter, follow these steps:

  1. Install GEth
  2. Start the GEth Client with RPC

With this setup, you are ready to query the Ethereum blockchain through the adapter.


When configuring the Ethereum adapter, you need to set the following parameters:

  • ClientUrl: The JSON RPC Endpoint. This is the endpoint provided by the GEth client.
  • Blocks: This parameter specifies the number of blocks to include in the running window. The adapter maintains a running window over the blockchain for queries. For instance, setting Blocks to 10 means that every query will be executed over the 10 most recent blocks.
  • ExperimentalFiltering: This parameter enables the adapter to fetch historical blocks beyond the Running Window. It does this by estimating the block numbers that can be fetched by the current query. It is important to note that this feature only works on BlockNumber fields, i.e., the number field in the blocks table and the blockNumber field in the transactions table. Please be aware that this is an experimental feature and may not yield expected results in all cases.


To deploy the Ethereum adapter, navigate to the Polypheny-UI (Adapters -> Sources), and provide the necessary parameter values.

Once successfully deployed, you can query the Ethereum blockchain as a table in Polypheny. Remember that due to the running window’s nature, the data available for querying is limited to the most recent blocks as specified by the Blocks parameter. The experimental filtering feature may allow queries beyond this range, but results are not guaranteed.


The initial version of this adapter has been implemented by Shubham Arawkar as part of his Google Summer of Code 2021 project, entitled Query the Blockchain.

© Polypheny GmbH. All Rights Reserved.