apeswap-lists

How to Manage this Repo

When you would like to make an edit to one of the lists in this repo, please only edit the .ts files. This is for better type control and to reduce the chance of errors. To apply the changes run yarn build (which also includes yarn legacy-build) in the console.

For example, to edit a farm:

1. Open the constants/farms.ts file.
2. Make the edits & save
3. Run yarn build to apply these changes to the corresponding JSON files
4. Run yarn test to make sure the JSON files are valid
5. Commit to the Github repo

Humans interact with the TypeScript files & our services pull in the JSON files! ❤️

Testing Locally

yalc

1. yalc publish (in package)
2. yalc add <package-name> (in package consumer repo)
   • yalc link is another option
3. yalc remove <package-name>
   • yalc remove --all another option

yalc installation

Using NPM:
npm i yalc -g
Using Yarn:
yarn global add yalc

npm link

1. yarn (Install latest deps)
2. Update lists as needed
3. yarn build
4. npm link
5. Go to frontend repo locally npm link @ape.swap/apeswap-lists

Updating while linked

1. Update lists as needed
2. yarn build
3. The changes should then be reflected on the local linked repo.

Unlink

1. Go to frontend repo locally npm unlink @ape.swap/apeswap-lists
2. Still on local frontend: yarn install (Reinstall package)
3. npm unlink

Publishing Test Packages

Sometimes a package needs to be deployed with test tokens. We suggest using a --tag test tag scheme to denote this packages have test tokens included in them

# no need to run yarn build as it's included in the prepublishOnly script
yarn publish --tag test

yarn publish command will prompt you for a new version. We suggest using X.X.X-test.0 version scheme. It will automatically bump the version for you and create a commit with the new version.

Publishing Alpha Packages

We could apply the same logic to deploy alpha packages with --tag alpha and so on.

# no need to run yarn build as it's included in the prepublishOnly script
yarn publish --tag alpha

yarn publish command will prompt you for a new version. We suggest using X.X.X-alpha.0 version scheme. It will automatically bump the version for you and create a commit with the new version.

Config

Token

This is the current interface of Token

export interface Token {
  symbol: string
  address: Partial<Record<ChainId, string>>
  active: boolean
  decimals?: Partial<Record<ChainId, number | null>>
  dontFetch?: boolean
  lpToken?: boolean
  price?: number
  liquidityDex?: Partial<Record<ChainId, LiquidityDex>>
  getLpUrl?: Partial<Record<ChainId, string>>
}

With more recently added properties liquidityDex and getLpUrl

LiquidityDex

This property was added because of us introducing different non ApeLP bonds. For example QS (Algebra) and PCS. This is a way of telling FE that the bond is a non ApeLP and the pricing of the LP should be retrieved differently. Besides that we also have different zapping strategies so this also makes sure the right zap strategy is used.

liquidityDex: {
      [ChainId.BSC]: LiquidityDex.PancakeSwapV2,
      [ChainId.Polygon]: LiquidityDex.Algebra,
    },

getLpUrl

For some non ApeLP bonds we don't have a working zap strategy and we should send users to an external url to get the right LPs. This is the url the users will be send to.

Only used and a must when zap version for liquidityDex is ZapVersion.External. Check dexToZapMapping.ts for what strategy is used for what LiquidityDex.

getLpUrl: {
      [ChainId.BSC]: "https://www.{url}.com",
      [ChainId.Polygon]: "https://www.{url}.com",
    },

Example config

  pcsBnbUsdt: {
    symbol: 'BNB-USDT',
    address: {
      [ChainId.BSC]: '0x16b9a82891338f9bA80E2D6970FddA79D1eb0daE',
    },
    decimals: {
      [ChainId.BSC]: 18,
    },
    active: false,
    lpToken: true,
    liquidityDex: {
      [ChainId.BSC]: LiquidityDex.PancakeSwapV2,
    },
    getLpUrl: {
      [ChainId.BSC]: 'https://pancakeswap.finance/v2/add/0x55d398326f99059fF775485246999027B3197955/0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c',
    },
  },

Bills/Bonds

This is the current interface for Bills

export interface BillsConfig {
  index: number
  contractAddress: Partial<Record<ChainId, string>>
  billVersion: BillVersion
  billType: 'liquidity' | 'reserve' | 'launch'
  token: Token
  quoteToken: Token
  lpToken: Token
  earnToken: Token
  billNnftAddress: Partial<Record<ChainId, string>>
  hide?: boolean
  projectLink?: string
  twitter?: string
  initTime?: Partial<Record<ChainId, number>>
  initPrice?: Partial<Record<ChainId, number>>
  audit?: string
  soldOut?: boolean
  billArt?: {
    collection: BillArtCollection // i.e. BillArtCollection.ApeSwap_Collection1
  }
}

With more recently added property billArt

billArt

This property was added to be able to support multiple bond arts. Currently the supported bill arts are ApeSwap and Quickswap with default ApeSwap if nothing is specified.

export enum BillArtCollection {
  ApeSwap_Collection1 = 'ApeSwap_Collection1',
  Quickswap_Collection1 = 'Quickswap_Collection1',
}

billArt: {
  collection: BillArtCollection.Quickswap_Collection1
}

billVersion

This property was added to be able to support multiple bonds ABIs. We should use as follows:

• V2
  • BSC
  • MATIC
  • ARBITRUM
  • LINEA
  • LIGHTLINK
  • IOTA
  • BASE
• V3
  • MAINNET
  • INEVM
  • every new chain we support in the future
• V1 (legacy, not used anymore)
• FixedPrice (used for Migration Bonds and Cex Fund Bonds)
• TieredSale (used for Launchpad Bonds)
• FlashTieredSale (used for Flash Bonds)

export enum BillVersion {
  V1 = 'V1',
  V2 = 'V2',
  FixedPrice = 'FixedPrice',
  V3 = 'V3',
  TieredSale = 'TieredSale',
  FlashTieredSale = 'FlashTieredSale',
}

billVersion: BillVersion.V3

Example

  {
    index: 16543,
    contractAddress: {
      [ChainId.MATIC]: '0xa54d14007bdc29d1d2ff0607efac0bae9ecaf9b9',
    },
    billType: 'liquidity',
    billVersion: BillVersion.V2,
    token: tokens.quick,
    quoteToken: tokens.wpol,
    lpToken: tokens.quickPol,
    earnToken: tokens.TTT,
    billNnftAddress: {
      [ChainId.MATIC]: '0xa1c78af783fb9ea7be790cbbd01abff63beae769',
    },
    hide: false,
    projectLink: 'https://www.quickswap.app/',
    twitter: 'https://twitter.com/',
    audit: 'Add audit link',
    initTime: { [ChainId.MATIC]: 1690287710 },
    initPrice: { [ChainId.MATIC]: 0.00123 },
    billArt: { collection: BillArtCollection.Quickswap_Collection1 },
  },

tokensSimplified.json

The tokensSimplified.json file is a streamlined version of the tokens list that includes only tokens used in bills (bonds). This file is automatically generated during the build process and offers several advantages:

Key Features

• Bills-only tokens: Contains only tokens that are used as lpToken or earnToken in bills
• Chain-specific filtering: For each token, only includes addresses and decimals for chains where the token is actually used in bills
• Smaller file size: Reduced from 637 tokens to ~401 tokens, with optimized chain data
• Consistent key format: Uses the exact same property names as defined in tokens.ts

Example

Original tokens.json might have USDC with addresses for 18 chains, but tokensSimplified.json only includes the 13 chains where USDC is actually used in bills:

{
  "usdc": {
    "symbol": "USDC",
    "address": {
      "1": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "56": "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
      "137": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174"
      // ... only chains used in bills
    },
    "decimals": {
      "1": 6,
      "56": 18,
      "137": 6
      // ... corresponding decimals for used chains only
    },
    "active": true
  }
}

Usage

The file is automatically generated when running yarn build and can be found at config/tokensSimplified.json. Use this file when you need a lightweight token list that focuses specifically on tokens used in the bills ecosystem.