how-to-add-a-new-blockchain.md

How to add a new Blockchain

{% hint style="info" %} For non-EVM chains just follow the same steps but instead of picking the shortName from chainlist, make one up that adjusts to your chain. {% endhint %}

1. Fork the DefiLlama-Adapters repo

https://github.com/DefiLlama/DefiLlama-Adapters

2. Add the Blockchain to chains.json

You need to add the name of the blockchain in the projects/helper/chains.json file to recognize it as a new supported chain.

Example Change:

"chains": [
  "ethereum",
  "binance-smart-chain",
  "polygon",
  "zklink",  // Add your new blockchain here. 
  "fraxtal",
  "zksync"
]

You should use the field shortName from https://chainlist.org/rpcs.json

---

3. Add Token Mappings in tokenMapping.js

Add the token mappings for the new blockchain to the projects/helper/tokenMapping.js file. This file maps token addresses to their respective identifiers for accurate tracking and handling.

Example Change:

const fixBalancesTokens = {
  zklink: {
    [ADDRESSES.zklink.WETH]: { coingeckoId: "ethereum", decimals: 18 },
  },
  ozone: {
     '0x83048f0bf34feed8ced419455a4320a735a92e9d': { coingeckoId: "ozonechain", decimals: 18 }, 
  },
};

This ensures tokens on the new blockchain (zklink) are properly recognized, including their coingeckoId for price tracking and their decimals.

---

4. Submit a Protocol using your blockchain (e.g., projects/savmswap/index.js)

Lastly, update the project’s configuration file to add your new blockchain as a valid supported chain. If we don´t track any protocol on your blockchain, we can not add it. So make sure to add the new chain under a current project or add a new adapter to track the project on your blockchain

Example Change:

const { uniTvlExport } = require('../helper/unknownTokens')

module.exports = uniTvlExport('zklink', '0x1842c9bD09bCba88b58776c7995A9A9bD220A925') //blockchain, factory address

5. Submit a Pull Request