Skip to content
ENSNode

Available Label Sets

This page lists the currently available label set IDs and their versions that you can use with ENSRainbow’s download scripts and API.

Quick Reference

Section titled “Quick Reference”

Use these currently available identifiers with the download script:

Terminal window
# Syntax: download-ensrainbow-files.sh <LABEL_SET_ID> <LABEL_SET_VERSION>
./scripts/download-ensrainbow-files.sh subgraph 0        # Production dataset
./scripts/download-ensrainbow-files.sh ens-test-env 0    # Test dataset
./scripts/download-ensrainbow-files.sh discovery-a 0     # Discovery dataset

Available Label Sets

Section titled “Available Label Sets”

Currently Available

Section titled “Currently Available”

subgraph

Section titled “subgraph”

Source: The Graph’s official ENS Subgraph
Description: Main production dataset containing labelhash-to-label mappings from The Graph’s ENS subgraph.

VersionStatusDescription
0✅ AvailableInitial production dataset

ens-test-env

Section titled “ens-test-env”

Source: ens-test-env project
Description: Small, curated test dataset perfectly aligned with the ens-test-env labels for development and testing.

VersionStatusDescription
0✅ AvailableTest dataset for local development

discovery-a

Section titled “discovery-a”

Source: Dynamic discovery pipeline
Description: Dataset for dynamically discovered labels, initially empty but grows over time.

VersionStatusDescription
0✅ AvailableInitial empty dataset for dynamic discoveries

Planned/Coming Soon

Section titled “Planned/Coming Soon”

searchlight

Section titled “searchlight”

Source: Extended discovery mechanisms
Description: Enhanced dataset with additional label discoveries beyond the subgraph.

VersionStatusDescription
0🚧 Coming SoonExtended dataset with additional discoveries

Usage Examples

Section titled “Usage Examples”

For Local Development

Section titled “For Local Development”
Download test data
cd apps/ensrainbow
./scripts/download-ensrainbow-files.sh ens-test-env 0

For Production Use

Section titled “For Production Use”
Download production data
cd apps/ensrainbow
./scripts/download-ensrainbow-files.sh subgraph 0

For Discovery/Research

Section titled “For Discovery/Research”
Download discovery dataset
cd apps/ensrainbow
./scripts/download-ensrainbow-files.sh discovery-a 0

For API Configuration

Section titled “For API Configuration”
Environment variables
export LABEL_SET_ID=subgraph
export LABEL_SET_VERSION=0
export DB_SCHEMA_VERSION=3

Checking Availability

Section titled “Checking Availability”

Manual Verification

Section titled “Manual Verification”

You can manually verify if a label set is available by checking the ENSRainbow labelset server:

Check if a label set exists
# Replace with your desired LABEL_SET_ID and LABEL_SET_VERSION
LABEL_SET_ID="subgraph"
LABEL_SET_VERSION="0"
wget --spider "https://bucket.ensrainbow.io/labelsets/${LABEL_SET_ID}_${LABEL_SET_VERSION}.ensrainbow"

Understanding Versions

Section titled “Understanding Versions”
Label Sets & Versioning Learn more about how ENSRainbow's versioning system works

Key Points:

Section titled “Key Points:”
  • Version 0 is always the initial dataset for any label set
  • Higher versions contain incremental additions (not replacements)
  • Versions must be ingested sequentially (0 → 1 → 2, etc.)
  • Each label set ID maintains its own independent versioning sequence
Section titled “Related Resources”
Local Development Setup Step-by-step guide for setting up ENSRainbow locally
Configuration Guide Complete configuration options for ENSRainbow deployment
TypeScript Interfaces Type definitions for label sets in the ENSRainbow SDK