EVM Query Language (EQL)

A SQL-like language for querying EVM chains with minimal boilerplate.

GitHub commits since latest release (branch) GitHub contributors GitHub Release Date

EQL provides a declarative way to query Ethereum Virtual Machine (EVM) chains. It enables developers and researchers to fetch blockchain data using familiar SQL-like syntax, eliminating the need for complex boilerplate code.

# Fetch Vitalik's balance across multiple chains
GET balance, balance FROM account vitalik.eth ON eth, base, arbitrum

Why EQL?

The Problem

Querying EVM chain data traditionally requires:

Writing extensive boilerplate code
Managing multiple RPC provider connections
Handling rate limits and retries
Dealing with different response formats

The Solution

EQL abstracts away the complexity by:

Providing a simple, SQL-like syntax
Managing RPC connections under the hood
Handling data formatting automatically
Supporting cross-chain queries in a single line

How It Works

EQL uses a two-phase interpreter to transform your queries into RPC calls:

Frontend Phase

- Tokenizes and parses your query - Validates syntax and semantics - Builds an Abstract Syntax Tree (AST)

Backend Phase

- Maps AST to appropriate JSON-RPC methods - Manages concurrent RPC requests - Formats responses into consistent structures

For example, this query:

GET balance, nonce FROM account vitalik.eth ON eth

Gets transformed into:

ENS resolution for "vitalik.eth"
eth_getBalance RPC call
eth_getTransactionCount RPC call
Results formatting into a structured response

Quick Start

Installation

# Install EQL version manager
curl https://raw.githubusercontent.com/iankressin/eql/main/eqlup/install.sh | sh
Install latest EQL version
eqlup

Usage

CLI Mode

# Run a query file
eql run query.eql
Interactive REPL
eql repl

Library Mode

# Cargo.toml
[dependencies]
eql_core = "0.1"

use eql_core::interpreter::Interpreter;
async fn main() {     let query = "GET balance FROM account vitalik.eth ON eth";     let result = Interpreter::run_program(query).await?; }