mirror of
https://github.com/Instadapp/chains.git
synced 2024-07-29 22:37:19 +00:00
provides metadata for chains
e65a5dff3d
closes #1069 |
||
---|---|---|
_data | ||
.ci | ||
.github | ||
gradle/wrapper | ||
model | ||
processor | ||
.gitignore | ||
build.gradle | ||
gradlew | ||
gradlew.bat | ||
LICENSE | ||
README.md | ||
settings.gradle.kts |
EVM-based Chains
The source data is in _data/chains. Each chain has its own file with the filename being the CAIP-2 representation as name and .json
ans extension.
Example
{
"name": "Ethereum Mainnet",
"chain": "ETH",
"network": "mainnet",
"rpc": [
"https://mainnet.infura.io/v3/${INFURA_API_KEY}",
"https://api.mycryptoapi.com/eth"
],
"faucets": [],
"nativeCurrency": {
"name": "Ether",
"symbol": "ETH",
"decimals": 18
},
"infoURL": "https://ethereum.org",
"shortName": "eth",
"chainId": 1,
"networkId": 1,
"icon": "ethereum",
"explorers": [{
"name": "etherscan",
"url": "https://etherscan.io",
"icon": "etherscan",
"standard": "EIP3091"
}]
}
when an icon is used in either the network or a explorer there must be a json in _data/icons with the name used (e.g. in the above example there must be a ethereum.json
and a etherscan.json
in there) - the icon jsons look like this:
[
{
"url": "ipfs://QmdwQDr6vmBtXmK2TmknkEuZNoaDqTasFdZdu3DRw8b2wt",
"width": 1000,
"height": 1628,
"format": "png"
}
]
where:
- the URL must be a IPFS url that is publicly resolveable
- width and height are optional - but when one is there then the other must be there also
- format is either "png", "jpg" or "svg"
If the chain is an L2 or a shard of another chain you can link it to the parent chain like this:
{
...
"parent": {
"type" : "L2",
"chain": "eip155-1",
"bridges": [ {"url":"https://bridge.arbitrum.io"} ]
}
}
where you need to specify type 2 and the reference to an existing parent. The field about bridges is optional.
Aggregation
There are also aggregated json files with all chains automatically assembled:
- https://chainid.network/chains.json
- https://chainid.network/chains_mini.json (miniaturized - fewer fields for smaller filesize)
Collision management
If different chains have the same chainID we list the one with the oldest genesis.
Usages
- chainlist.org or networklist-org.vercel.app as a staging version with a more up-to-date list
- chainid.network
- WallETH
- TREZOR
- networks.vercel.app
- eth-chains
- EVM-BOX
- FaucETH
- Sourcify playground
- chaindirectory.xyz
- chain-list.org
- DefiLlama's chainlist
- chainlist.network
- evmchainlist.org
- evmchainlist.com
- thechainlist.io
- chainlist.info
- chainmap.io
- chainlist.in
- chainz.me
- Otterscan
- Your project - contact us to add it here!