V1.1 UPDATE [12/20/23]: Read about the Crypto Ecosystems taxonomy's update to Version 1.1 here.
🌲 Crypto Ecosystems is a taxonomy for sharing data around open source blockchain, Web3, cryptocurrency, and decentralized ecosystems and tying them to GitHub organizations and code repositories. All of the ecosystems are specified in TOML configuration files.
This repository is not complete, and hopefully it never is as there are new ecosystems and repositories created everyday.
There's a couple of ways you can help grow this initiative.
You can make any .toml file for an ecosystem under the /data/ecosystems directory or edit an existing one to help improve data around an ecosystem.
You can fork this repository and open a PR from the forked repo to this repo. If you are not sure how to do that, you can follow the tutorial in this video.
An example configuration file for the Bitcoin ecosystem looks like this:
# Ecosystem Level Information
title = "Bitcoin"
# Sub Ecosystems
# These are the titles of other ecosystems in different .toml files in the /data/ecosystems directory
sub_ecosystems = [ "Lightning", "RSK Smart Bitcoin", "ZeroNet"]
# GitHub Organizations
# This is a list of links to associated GitHub organizations.
github_organizations = ["https://github.com/bitcoin", "https://github.com/bitcoin-core", "https://github.com/bitcoinj", "https://github.com
/btcsuite", "https://github.com/libbitcoin", "https://github.com/rust-bitcoin"]
# Repositories
# These are structs including a url and tags for a git repository. These URLs do not necessarily have to be on GitHub.
[[repo]]
url = "https://github.com/bitcoin/bitcoin"
tags = [ "Protocol"]
[[repo]]
url = "https://github.com/bitcoinbook/bitcoinbook"
tags = [ "Documentation"]
[[repo]]
url = "https://github.com/bitcoin-wallet/bitcoin-wallet"
tags = [ "Wallet"]
By specifying the data as evolving config files in git, we benefit from a long term, auditable database that is both human and machine readable.
If you are not a developer or you find making a commit too difficult, you can use this Airtable based alternative below.
You can visit the form here, fill it, submit it and we'll take care of the rest :)
To use the Electric Capital Crypto Ecosystems Map, you will need an attribution.
Attribution needs to have 3 components:
- Source: “Electric Capital Crypto Ecosystems Mapping”
- Link: https://github.com/electric-capital/crypto-ecosystems
- Logo: Link to logo
Optional: Everyone in the crypto ecosystem benefits from additions to this repository. It is a help to everyone to include an ask to contribute next to your attribution.
Sample request language: "If you’re working in open source crypto, submit your repository here to be counted."
Sample attribution
Data Source: Electric Capital Crypto Ecosystems Mapping
If you’re working in open source crypto, submit your repository here to be counted.
There are three types of contributions you can make to this data set:
- Adding a new ecosystem (e.g. a new layer 1 blockchain)
- Adding a new sub-ecosystem (e.g. a big organisation that has multiple repos within the above ecosystem)
- Adding a new repo (e.g. an individual project within the ecosystem/sub-ecosystem) or organization
This may sound confusing. It is perhaps even more confusing because whilst there are these different data sources/structures, all of them sit within one directory (data/ecosystems) as .toml files.
To make things easier, we've made the following roadmap for you to follow depending on which of the above 3 types of contributions you're trying to make.
If you're adding a totally new ecosystem that has no parents (e.g. Cosmos/Ethereum), then follow this path. You're most likely adding a new L1 blockchain, so let's take the fictitious example of a new chain called EasyA Chain. Follow these steps:
- Go to the
data/ecosystemsdirectory - Find the folder named the first letter of the ecosystem you're adding. Here, it's the letter
Ebecause our L1 is calledEasyA Chain. - Open the folder
- Inside the folder, create a new
.tomlfile named after your L1 in kebab-case. Here, it will be calledeasya-chain.toml. The full path will now bedata/ecosystems/e/easya-chain.toml. - Add the following 2 required fields:
# Required field number 1: Name of the ecosystem
title = "EasyA Chain"
# Required field number 2: List of associated GitHub organizations
github_organizations = ["https://github.com/EasyA-Tech"]- Make your PR! ✅
Remember that this is a hierarchy. If you're adding a Cosmos appchain, therefore, you should be following Option 2 below (since it will be a sub-ecosystem of Cosmos).
It's important to note also that you do not need to add all the repos within your GitHub organizations to the .toml file as individual repos, because the system automatically fetches all repos within the organization.
You may see other ecosystems that have done this:
title = "EasyA Chain"
github_organizations = ["https://github.com/EasyA-Tech"]
[[repo]]
url = "https://github.com/EasyA-Tech/Chain" # ❌ Don't do this ❌
tags = [ "Protocol"]This is unnecessary. It adds clutter and makes it harder for reviewers to approve your PR. We will explain below when and why you should add repos to an ecosystem.
If you're adding a new sub-ecosystem (in other words, it has a parent, like a blockchain or a layer 0), then follow these steps. Again, we'll be using the fictitious EasyA Chain L1 blockchain as an example. However, this time, we'll be adding the new EasyA Community Wallet sub-ecosystem to it.
- Go to the
data/ecosystemsdirectory - Find the folder named the first letter of the name of the ecosystem which the project you're adding is part of. Here, it's the letter
Ebecause our L1 is calledEasyA Chain. - Open the folder. Here, it's the
Efolder. - Inside the folder, find the
.tomlfile that has the ecosystem's name. Here, following ourEasyA Chainexample, it will beeasya-chain.toml. The full path to the ecosystem will bedata/ecosystems/e/easya-chain.toml. - Open this file. Inside the ecosystem file, you will see something that looks like this:
title = "EasyA Chain"
github_organizations = ["https://github.com/EasyA-Tech"]-
You will then need to do one of two things.
- If there are no sub-ecosystems yet, add your sub-ecosystem by adding the following line:
sub_ecosystems = ["EasyA Community Wallet"]
- If you see a line starting with
sub_ecosystemsalready, then simple add your sub-ecosystem to the list:
sub_ecosystems = ["Pre-existing Sub-Ecosystem", "EasyA Community Wallet"]
Overall, your file should then look something like this:
title = "EasyA Chain"
sub_ecosystems = ["EasyA Community Wallet"] # This is the line we changed
github_organizations = ["https://github.com/EasyA-Tech"]- Once you've added your sub-ecosystem's name to the parent ecosystem file, go back to the
data/ecosystemsdirectory. - This time, find the folder that is the first letter of the name of the sub-ecosystem you're adding. Here, it also happens to be the letter
Ebecause our sub-ecosystem is calledEasyA Community Wallet. - Open the folder. Here, it's the
Efolder. - Inside the folder, create the
.tomlfile that has the sub-ecosystem's name. Here, following ourEasyA Community Walletexample, it will beeasya-community-wallet.toml. The full path to the ecosystem will bedata/ecosystems/e/easya-community-wallet.toml. - Add the following 2 required fields:
# Required field number 1: Name of the sub-ecosystem
title = "EasyA Community Wallet"
# Required field number 2: List of associated GitHub organizations
github_organizations = ["https://github.com/EasyA-Community-Wallet"]- Make your PR! ✅
Please remember here too that the same note as in Option 1 applies: the system automatically pulls in the repos from your sub-ecosystem GitHub organization, so you don't need to list them all out individually.
If you prefer videos, you can also see the above steps done live here.
If you've been following along closely, you'll have noticed that the steps after adding the sub-ecosystem to the parent ecosystem are exactly the same a Option 1 (adding a totally new ecosystem that has no parents). That's because this taxonomy is based on ancestry. Any sub-ecosystem is basically just an ecosystem in its own right (it's not like a sub-ecosystem is any less valuable). The ecosystem and sub-ecosystem dichotomy is merely there so we can see the relationship between different ecosystems. You can keep adding sub-ecoystems to sub-ecosystems ad infinitum (forever).
The system automatically pulls in all repos listed under a GitHub organization within an ecosystem. For example, when the system sees the below ecosystem, it will automatically account for all the repos under the EasyA-Tech GitHub organization.
title = "EasyA Chain"
github_organizations = ["https://github.com/EasyA-Tech"]So don't worry! You don't need to add every single repo if it's already part of an organization that's in the data set.
To add a new organization, simply append its full GitHub URL to the list of organizations in the associated ecosystem. Let's take the example of adding an organization with the URL https://github.com/EasyA-Community as part of the EasyA Chain ecosystem.
You would follow these steps:
- Go to the
data/ecosystemsdirectory - Find the folder named the first letter of the name of the ecosystem which the organization you're adding is part of. Here, it's the letter
Ebecause our ecosystem is calledEasyA Chain. - Open the folder. Here, it's the
Efolder. - Inside the folder, find the
.tomlfile that has the ecosystem's name. Here, following ourEasyA Chainexample, it will beeasya-chain.toml. The full path to the ecosystem will bedata/ecosystems/e/easya-chain.toml. - Open this file. Inside the ecosystem file, you will see something that looks like this:
title = "EasyA Chain"
github_organizations = ["https://github.com/EasyA-Tech"]- Simply add your GitHub organization URL to the list. Here, ours is
https://github.com/EasyA-Communityso we'll add that:
title = "EasyA Chain"
github_organizations = ["https://github.com/EasyA-Tech", "https://github.com/EasyA-Community"]- Make your PR! ✅
When, then, should you add repos? You only need to add a repo directly to an ecosystem if:
- ✅ It is not owned by a GitHub organization already listed in an ecosystem file (those
.tomlfiles) - ✅ It is not itself an ecosystem/sub-ecosystem (in which case you'd be adding it as an ecosystem)
The types of projects that will commonly get added as individual repos are:
- Documentation
- Wallets
- Utility Libraries
- Smaller protocols
Usually these will be repos created by the community (so not already accounted for under the ecosystem/sub-ecosystem GitHub organization). Use that as a rough heuristic here. If the repo you're adding is actually one of many repos all in the same ecosystem, and in fact the organization only contributes to that one ecosystem, then you should almost certainly be adding your organization instead.
If you're happy that you should be adding this repo, then here's how to do it. Let's take the example of a community contributor with the GitHub handle Platonicsocrates who's created a helper library for the EasyA Chain but also contributes to other projects (so we shouldn't add their whole organization/profile). Their repo URL https://github.com/platonicsocrates/easya-helpers.
You would follow these steps to add it:
- Go to the
data/ecosystemsdirectory - Find the folder named the first letter of the name of the ecosystem which the repo you're adding is part of. Here, it's the letter
Ebecause our ecosystem is calledEasyA Chain. - Open the folder. Here, it's the
Efolder. - Inside the folder, find the
.tomlfile that has the ecosystem's name. Here, following ourEasyA Chainexample, it will beeasya-chain.toml. The full path to the ecosystem will bedata/ecosystems/e/easya-chain.toml. - Open this file. Inside the ecosystem file, you will see something that looks like this:
title = "EasyA Chain"
github_organizations = ["https://github.com/EasyA-Tech"]- Simply add the following three lines at the end of the
.tomlfile:
[[repo]]
url = "https://github.com/platonicsocrates/easya-helpers" # Replace this URL with your repo url
tags = [ "Library"] # This line is optionalIf there are already other repos in the ecosystem, just add the above as new lines (unlike adding organizations or sub-ecosystems, these aren't lists). For example, if the ecosystem already has a repo, we will just add it below as follows:
# Repo that's already been added
[[repo]]
url = "https://github.com/platonicsocrates/easya-js"
tags = [ "Library"]
# Our new repo
[[repo]]
url = "https://github.com/platonicsocrates/easya-helpers" # Replace this URL with your repo url
tags = [ "Library"] # This line is optional- Make your PR! ✅
Thank you for contributing and for reading the contribution guide! ❤️
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
