[Grant Application] Event Based Architecture

1) Title

Event Based Architecture

2) Project Category

Infrastructure: for supporting the underlying code base of the blockchain - Infrastructure supporting tools, bug patches, node maintenance tools, etc.

3) Project Description

This project aims to bring event streaming support to the ICON ecosystem and enable a broad set of APIs to access the blockchain. It will take newly produced blocks and broadcast them to a configurable set of middleware layers and backends. Additional APIs such as REST and GraphQl will then be exposed on top of the newly created backend.

This service will enable events on ICON to integrate with numerous off-chain application architectures and infrastructure components. This is needed in any application where complex business logic needs to be processed off-chain, or representations of the chain can’t be easily queried with the standard JSON-RPC interface.

For event processing, in Ethereum the equivalent service is called eventeum which this project will replicate the functionality of with improvements in implementation. Instead of a monolithic application, the service will be decoupled into a streaming event producer and event registration and broadcasting service. Users will then have the option of running it as a standalone service or on top of kafka from which exactly-once messaging can be configured so that even in the event a service disruption that events will be processed.

Several projects under active development right now will benefit from this project including Balanced DEX API and Omm though we are confident many more exist (please leave comments to let us know others). This project will extend the existing icon-etl tool with streaming support to populate a kafka backend from which the event registration service can be built on top of.

4) Project Duration

3 months

5) Project Milestones

The project is broken down to 2 key phases for development: an event polling websocket agent, and an event registration plus broadcasting layer. Each development phase has been laid out in the following bottoms up task analysis for the first two milestones.

**Note the cache and JSON-RPC Proxy is waiting on the availability of websockets in 2.0 and is out of scope of this grant and in diagram only for demonstrative purposes.

Streaming Event Producer - 3 Weeks

Eventeum has two modes of operation, polling and websockets. Until websockets are released in ICON 2.0, the polling mode will be developed and later integrated with websockets when released. To do this, we will start by extending icon-etl to short poll a local citizen node on the order of every 100 milliseconds or less. When a new block is produced, transactions and receipts are extracted through a series of API calls and then forwarded on to a configurable set of broadcasters. For ethereum-etl, these include postgres and Google’s Pub/Sub. For icon-etl, we will extend into kafka which will be the primary message queue for consecutive broadcasts.

Event Registration and Broadcasting Service - 1 Month

Events need to be registered with a corresponding middleware to be broadcasted on. For eventeum, broadcast routes are set through a file and events are registered with both a config file and a REST API. ICON service will replicate this functionality. Each registered broadcast will create a kafka topic and a subscriber from which events will be broadcasted on. Each registered event will then subscribe to the main data feed and produce to the given broadcasting topics. Event subscriptions can be along blocks, transactions, or receipts and filtered based on a variety of useful parameters as exposed by the REST API including event logs from contracts and transactions from addresses. Eventlog registrations will be parsed based on a registered schema in either JSON Schema or OpenAPI.

REST and GraphQL APIs - 1 Month

Built on top of a postgres database populated with a live stream of block data, both REST and GraphQL APIs should then be exposed. Both endpoints will leverage FastAPI framework with GraphQL needing additional support from graphene. These endpoints will by no means be optimized and merely mark the start of building a full suite of developer tools. Beta testing will start with members of the community with the expectation that additional effort will need to be spent to bring to production. Infrastructure developed during the adjacent project, Autoscaling Endpoints, will be used to bring the endpoints into production with it’s associated logging and monitoring infrastructure.

6) Funding Amount Requested

We are requesting 30,000$ USD to complete this project.

7) Official Team Name


8) Team Contact Information (e.g. e-email, telegram id, social media)

Email: insighticon.prep@gmail.com

Telegram ID: @robcio

Social Media: twitter.com/icon_insight

GitHub: github.com/insight-icon

9) Public Address (To receive the grant)


Hash: SHA256

















Initial Review Result Comments

Review Result

Wait for CPS

Review Comments

  • Thank you for your effort in this proposal. We like your idea of using the CPS for this project. Since this project is helpful to community developers, it is a good idea to develop APIs that community developers require.
1 Like

Thanks @ICON_ADMIN - Totally understand and thought this might be for CPS as well. We’ll resubmit this then and will do a rescoping per whatever feedback we get from the community.

Thank you for your consideration.


Final Review Result Comments

Review Result


Reporting Period

Grant recipients should produce Periodic Reports in order to continue to receive grant funding. If the Periodic Report is showing that the initiative is not meeting expectations, the ICON Foundation has the option to halt continued funding. Please check the link (ICON Community Grant Program (“ICON CGP”)) and leave reports on this page (https://forum.icon.community/c/g/pr )

The team must submit the Periodic Report by the timeframes below (UTC):

  • 2021/01/23 02:00 AM (UTC)
  • 2021/02/22 02:00 AM (UTC)
  • 2021/03/22 02:00 AM (UTC)

Funding Amount

The ICON Foundation is going to give out $30,000 in 3 monthly installments based on the Periodic Report. The amount of ICX will be determined and paid according to the price at 02:00 AM (UTC) on the day of payment.

  • 2021/01/26 02:00 AM (UTC) - $10,000
  • 2021/02/24 02:00 AM (UTC) - $10,000
  • 2021/03/24 02:00 AM (UTC) - $10,000