Skip to content
ENSNode

Frequently Asked Questions

This page answers the most common questions about ENSRainbow.

Can I use ENSRainbow without running my own server?

Section titled “Can I use ENSRainbow without running my own server?”

Yes. NameHash Labs operates a free instance at https://api.ensrainbow.io.

How often are new labels added?

Section titled “How often are new labels added?”

New label-set versions are generated manually for now:

  • subgraph: data from the ENS Subgraph rainbow tables, no plans to update
  • discovery-a: may be updated periodically as new labels are dynamically discovered
  • ens-test-env: Static test dataset, no plans to update
  • searchlight: Enhanced discovery dataset with additional label discoveries beyond the subgraph

To stay informed about new versions, monitor the Available Label Sets documentation page.

How can I create my own .ensrainbow file?

Section titled “How can I create my own .ensrainbow file?”

ENSRainbow provides two methods for creating .ensrainbow files from different data sources:

Method 1: SQL Conversion

Section titled “Method 1: SQL Conversion”

The convert command converts PostgreSQL rainbow table dumps (.sql.gz format) into the binary protobuf format that ENSRainbow uses.

To create a custom .ensrainbow file from SQL:

  1. Prepare your data as a PostgreSQL dump file (.sql.gz) with ENS labels and labelhashes
  2. Run the convert command:
    Terminal window
    pnpm run convert \
      --input-file your_data.sql.gz \
      --output-file custom.ensrainbow \
      --label-set-id custom \
      --label-set-version 0

Method 2: CSV Conversion

Section titled “Method 2: CSV Conversion”

The convert-csv command converts CSV files (with 1 or 2 columns) into .ensrainbow format. This is ideal for custom datasets, test data, or external sources.

To create a custom .ensrainbow file from CSV:

  1. Prepare your data as a CSV file with labels (and optionally labelhashes)
  2. Run the convert-csv command:
    Terminal window
    pnpm run convert-csv \
      --input-file your_labels.csv \
      --output-file custom.ensrainbow \
      --label-set-id custom \
      --label-set-version 0

For complete instructions, examples, and workflow guidance, see the Creating ENSRainbow Files guide. See the CLI Reference for detailed command usage.

Does ENSRainbow normalise labels?

Section titled “Does ENSRainbow normalise labels?”

No. It returns labels exactly as stored. Your client should perform ENS Normalisation if required.

Have a question that isn’t answered here? Open an issue or hop into our Telegram group.