gitwtfhub

wtf is chainlist?

unionlabs/chainlist — explained in plain English

Analysis updated 2026-07-19 · repo last pushed 2024-03-14

TypeScriptAudience · pm founderComplexity · 1/5DormantSetup · easy

TL;DR

A shared directory of blockchain network info that helps crypto wallets and block explorers display correct token names, logos, fees, and connection details from one community-updated source.

Mindmap

Mindmap is still cooking. Refresh in a few.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Add a new token's details so it appears correctly in Cosmostation wallets and the Mintscan explorer.

REASON 2

Update a token's logo or metadata by editing config files and submitting a pull request.

REASON 3

Look up network connection points and validator details for supported blockchain networks.

REASON 4

Submit a new blockchain network's configuration so apps can connect and display its tokens.

What's in the stack?

TypeScriptJSONGitHub

How it stacks up

unionlabs/chainlist0xradioac7iv/tempfs7vignesh/pgpulse
Stars00
LanguageTypeScriptTypeScriptTypeScript
Last pushed2024-03-14
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity1/53/54/5
Audiencepm founderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

No build or infra needed, just edit structured text and image files, then submit a pull request.

Wtf does this do

The chainlist project is a shared directory that keeps track of useful information about different blockchain networks. It helps crypto wallets and block explorers show users the right token names, logos, validator details, transaction fees, and network connection points. Instead of each app maintaining its own separate list, they can all pull from this single, community-updated source. At its core, the repository is a collection of folders and configuration files organized by blockchain network. If a new token is created on a network, its developer can add an entry with the token's symbol, a short description, the number of decimals it uses, and a logo image. The repository also tracks how tokens move across different networks using various transfer methods, and it stores the network addresses that apps need to actually connect and read data. Anyone can contribute by copying the project, adding their token's details to the appropriate file, and submitting a pull request for the maintainers to review. This resource is primarily used by Cosmostation's own products, including their mobile crypto wallets and the Mintscan block explorer. A founder launching a new token, or a validator operating on a network, would use this project to make sure their token or logo appears correctly across these widely used platforms. Without adding their information here, their users might see missing logos or unrecognized token codes when checking their wallets. A notable aspect of this project is that it is built entirely on simple, structured text files and image uploads rather than a complex database. This approach makes it highly transparent, as anyone can view the raw data or suggest changes directly through GitHub. Updates are generally reviewed and made live within 24 hours, though the maintainers note that tokens on test networks may not be accepted into the main project.

Yoink these prompts

Prompt 1
I'm launching a new token on a Cosmos-based blockchain. Help me create the correct folder structure and config JSON entry for the chainlist repo, including fields for symbol, description, decimals, and logo path.
Prompt 2
Fork the unionlabs/chainlist repo and walk me through adding my token's logo image and metadata to the right network folder so I can submit a pull request.
Prompt 3
My token is showing a missing logo in Cosmostation wallet. What files do I need to update in the chainlist repo to fix it, and what image format and dimensions are expected?
Prompt 4
I want to add a new blockchain network to chainlist. Generate the config file template with all required fields like chain ID, connection points, and validator details based on a network I describe.

Frequently asked questions

wtf is chainlist?

A shared directory of blockchain network info that helps crypto wallets and block explorers display correct token names, logos, fees, and connection details from one community-updated source.

What language is chainlist written in?

Mainly TypeScript. The stack also includes TypeScript, JSON, GitHub.

Is chainlist actively maintained?

Dormant — no commits in 2+ years (last push 2024-03-14).

How hard is chainlist to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is chainlist for?

Mainly pm founder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.