Skip to content
ENSNode

ENSRainbow Architecture Overview

ENSRainbow consists of four primary layers working together to “heal” unknown labels:

  1. Data Generation & Conversion – CSV files are converted to the modern .ensrainbow format (SQL conversion is available only for migrating legacy ENS Subgraph data).
  2. Data Ingestion – the .ensrainbow files are ingested into a LevelDB database using the ingest-ensrainbow CLI.
  3. HTTP API Service – state in the database is exposed through a lightweight HTTP API.
  4. Client Integration – applications call the API directly or via the TypeScript SDK.
flowchart TD
    subgraph Data_Generation
        CSV["CSV files"]
        SQL[".sql.gz files<br/>(legacy only)"]
        ENSRB[".ensrainbow files"]
        CSV --> ConvertCSV["convert command"]
        SQL --> ConvertSQL["convert-sql command<br/>(legacy migration)"]
        ConvertCSV --> ENSRB
        ConvertSQL --> ENSRB
    end

    ENSRB --> Ingest["ingest-ensrainbow"]
    Ingest --> DB[(LevelDB)]

    DB --> API[["HTTP API /v1/*"]]
    API --> SDK["@ensnode/ensrainbow-sdk"]
    SDK --> App["Your app"]