Frequently Asked Questions

This page answers the most common questions about ENSRainbow.

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?

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 (coming soon)

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

How can I create my own .ensrainbow file?

ENSRainbow provides two methods for creating .ensrainbow files:

Method 1: CSV Conversion (Recommended)

The convert command is the primary method for creating new .ensrainbow files from CSV data:

1. Prepare your data as a CSV file with labels (1 column) or labels and labelhashes (2 columns)
2. Run the convert command:

   pnpm run convert --input-file your_labels.csv --output-file custom.ensrainbow --label-set-id my-dataset --label-set-version 0

Method 2: SQL Conversion (Legacy)

For converting legacy ENS Subgraph data from PostgreSQL dumps:

pnpm run convert-sql --input-file ens_names.sql.gz --output-file custom.ensrainbow --label-set-id subgraph --label-set-version 0

Note: You can also download existing .ensrainbow files using the download scripts.

See the CLI Reference for detailed command usage.

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.