ENS Collections
ENS Collections are categories of ENS names based on specific patterns or predefined lists. This repository is an effort towards bringing all collections together into one place and standardizing their definition in order to facilitate consistent integrations across platforms and marketplaces.
This repo is maintained by: @zimtente (ENS.Vision) and @aoxborrow (ENS.Tools)
Metadata
The metadata for all collections in ens-collections.json:
name: collection name, e.g. "10K Club"slug: short, lowercase, url-friendly abbreviation (use hyphens instead of spaces), e.g. "10k-club"description: one sentence descriptiontwitter: twitter usernamewebsite: full website urlchat: link for group chat, e.g. discord/telegramlogo: logo file, use slug for filename, e.g. "three-letters.png"csv: array of csv files, use slug for filename, e.g. ["three-letters.csv"]
bold = required field.
CSV files
The .csv should include all names in the collection in ascending alphanumeric order. There are two columns: name and token ID. The names should not include the .eth extension and should be normalized using standard ENS normalization. New collections can be submitted without token IDs, or use the provided script to generate them.
name,token
vitalik,79233663829379634837589865448569342784712482819484549289560981379859480642508
ens,42033647921836720708986079437023664695436352815832009766988496528855301124570
0001,38764329101403256878217503524140705778209985981144907919668889447405219871633
Contributing
Please create issues or pull requests to contribute to this repo.
Proposing a New Collection
Here is a quick checklist when submitting a new collection:
- The collection must be significantly different from any existing collection.
- Provide all the required metadata fields (see above).
- CSVs should be properly formatted and use the slug for filename. New collections can be submitted without token IDs.
- (Optional) Logo files should be PNG with square dimensions that work with a circular crop (like Twitter). Logo files should be at least 500x500px, and no more than 1200x1200px. Logo files should use the slug for filename.
Example Collection Proposal:
Metadata content:
{
"name": "10k Club",
"slug": "10k-club"
"description": "Names with 4 digits, 0000-9999.",
"twitter": "10kClubOfficial",
"website": "https://10kClub.com",
"chat": "https://discord.gg/aUemBKUuZ5",
"logo": "10k-club.png",
"csv": ["10k-club.csv"]
}
.CSV content:
name,token
0000,105307555225596823162770746791279321249474694422393704130067750948958748271609
0001,38764329101403256878217503524140705778209985981144907919668889447405219871633
0002,37929174533718175565910670676525701091954781139941253617179119590462796771323
...
Adding or Removing Names from a Collection
To modify an existing collection, please create an issue or pull request and provide:
- Explanation why the item should be added/removed from a collection
- Collection Name
- Name of the item
- (Optional) Token ID of the item
Utils
Install
npm install
Generate Token IDs from Names
This takes any CSV file where the first column is the ENS name. The name will be normalized (.eth removed) and the token ID will be added as the second column in outfile.csv. Use this outfile for the collection CSV. It can replace the input file as well.
npm run get-tokens utils/example-names.csv outfile.csv
How to convert a name into a token ID:
https://docs.ens.domains/dapp-developer-guide/ens-as-nft
Verify All Lists and Logos
This verifies that all CSV files and logo files that are specified in ens-collections.json exist.
npm run verify-collections
Token ID :
56589133791182328990702452673238257733403652943033151989143761050156292487946
Token ID :
87545229799021085583596036775842462131122444202857375197806134421267815472168
Token ID :
69216462386432107027256187162500906081865641433858665291122930223284218630488
6 Aug 23, 2022
315 Dec 30, 2022
14 Dec 24, 2022
25 Jan 1, 2023
2 Dec 16, 2022
2 Mar 20, 2022
12 Dec 27, 2022
3 Sep 21, 2022
5 Feb 16, 2022
5 Nov 14, 2022
33 Nov 16, 2022
9 Jan 1, 2023
20 Dec 15, 2022
17 Jul 31, 2022
7 Sep 26, 2022
20 Nov 19, 2022
3 Dec 20, 2021
8 Sep 5, 2022
2 Jan 8, 2022