Welcome to the Liquidity Health Dashboard Configuration Repo! This repository is dedicated to the manual addition and curation of EVM-compatible projects for accurate listing on ApeSwap's Liquidity Health Dashboard (link coming soon).
We're excited to have you on board as we strive to provide smooth and seamless liquidity health tracking for your project. Let's dive right in!
At ApeSwap, we understand the importance of accurate and reliable liquidity tracking for crypto projects. Our platform provides a comprehensive solution for tracking web3 projects' liquidity, ensuring that project leadership can focus on what matters most: building and growing. By following this guide, you'll be able to easily integrate your project with our platform and enjoy all the benefits that come with it.
Before you dive into submitting a PR, ensure you have the following prerequisites in place:
-
A Github account to create and submit PRs.
-
A local environment set up with
Node.jsandyarninstalled. -
Fork our repository into your own Github account.
Now, you're ready to submit your PR!
Submitting a PR is as simple as following these steps:
-
Clone the repository: Clone your forked repository to your local environment.
-
Install packages: Navigate to the project folder and run
yarnto install all applicable packages. -
Edit the
verifiedAssets.tsfile: Edit and locate your code block at the bottom of theverifiedAssets.tsfile inside theconfigfolder. Make sure to provide all the necessary information about your project. -
Add your logo Add your token's logo in .svg or .png format. The size of your logo should be 200 x 200 pixels, less than 50 KB and in the form of a circle.
-
Run configuration: Run
yarn configureto convert your TypeScript entry into a consumable JSON file. -
Commit and push: Commit your changes and push them to your forked repository.
-
Submit a PR: Create a new pull request in our
stagingrepository, targeting the staging branch.
And voilà! Your PR is submitted, and our team will review and merge it as soon as possible.
In that example, we'll add our native token, BANANA to the repo! We'll need to go to the src > constants folder and open addresMappingWhitelist.ts. And you'll notice the skeleton of the code block looks like this:
{
tokenSymbol: '',
tokenName: '',
tokenLogoUrl: '',
tokenAddresses: [
{ address: '', chainId: '' },
{ address: '', chainId: '' },
],
knownOwners: [
'',
'',
'',
],
tags: [''],
profileLinks: {
siteUrl: '',
twitterUrl: '',
telegramUrl: '',
discordUrl: '',
auditUrls: [''],
},
},Once you finish filling it, it should look like this:
{
tokenSymbol: 'BANANA',
tokenName: 'ApeSwap BANANA',
tokenLogoUrl: 'https://raw.githubusercontent.com/ApeSwapFinance/lhd-config/main/logos/BANANA.svg',
tokenAddresses: [
{ address: '0x603c7f932ed1fc6575303d8fb018fdcbb0f39a95', chainId: '56' },
{ address: '0xd978f8489e1245568704407a479a71fcce2afe8f', chainId: '42161' },
{ address: '0x5d47baba0d66083c52009271faf3f50dcc01023c', chainId: '137' },
{ address: '0x667fd83e24ca1d935d36717d305d54fa0cac991c', chainId: '40' },
{ address: '0x92df60c51c710a1b1c20e42d85e221f3a1bfc7f2', chainId: '1' },
],
knownOwners: [
'0x944694417a6ca0a70963d644a11d42c10e3af042',
'0xabd7853b79e488bc1bd9e238a870167b074eb714',
'0x71c0c1001520e1568e17836cc8a19d0dbdb2bd5f',
],
tags: ['DEX', 'Yield', 'Bond'],
profileLinks: {
siteUrl: 'https://apeswap.finance/',
twitterUrl: 'https://twitter.com/ape_swap',
telegramUrl: 'https://t.me/ape_swap',
discordUrl: 'https://discord.com/invite/ape-swap',
auditUrls: ['https://paladinsec.co/projects/apeswap/', 'https://de.fi/audit-database/ApeSwap%20Finance'],
},
},Lastly, upload your logo and locate it in the logos folder. Make sure it's at least 200 x 200 pixels, ideally has a size of less than 50 KB, and is in square or circular format. Please name your logo's image with all uppercase letters and update the last part of the tokenLogoUrl parameter.
tokenLogoUrl: 'https://raw.githubusercontent.com/ApeSwapFinance/lhd-config/main/logos/YOURLOGONAME.svg',Be Aware Of Those Important Details:
tokenSymbol has to be always uppercase.
All contract addresses should be lowercase at contract address needed variables such as tokenAddresses, knownOwners.
knownOwners should be a known liquidity holder wallet of the project. That can be a Safe multi-sig, locking contract, or other owned wallet. We will verify these!
Please don't forget to use Prettier before comitting your code.
Once you finish the code, run yarn configure to convert your TypeScript entry into a consumable JSON file and create a new pull request in our staging repository.
And finally, please make sure to add project-requests label to your PR for making tracking progrees easier for us.
A: Don't worry! Our team is here to help. Feel free to reach out to us via our Support channels, and we'll be happy to assist you.
A: We aim to review and merge PRs as quickly as possible. Please allow our team up to 3 business days to process your request.
A: Congratulations! Your project is now integrated with our liquidity tracking product. You can start monitoring your liquidity and leveraging our tools to make informed decisions for your project.
A: You can see a complete list of tags with their definitions in our docs here and also at src/types/index.ts!
We're committed to providing you with the best support possible. If you have any questions, issues, or concerns, feel free to reach out to us through the following channels:
Thank you for choosing ApeSwap! We're looking forward to working with you and helping your project thrive.