Development Docs

Router Contracts

Whether you're testing your implementation on our testnet or mainnet, you can use our routers to ensure seamless connectivity on any of our supported networks.

Simply choose the appropriate router for the network you're using, and you're good to go! Happy testing!

When listing with Croswap and creating a new pair on our DEX, you have two options for seeding your initial liquidity, depending on whether you are already listed on another DEX.

Migrating an Existing Pair from Another DEX

When using existing LP, you can remove liquidity from the other dex and make a new pair with the same number of tokens you got from that transaction. This ensures that the price across both dexes remains the same.

You can also use new funds instead of taking liquidity from another pair. However, you must use the same token ratio as the other dex. If the ratio of tokens is not the same, arbitrage bots will most likely take advantage of the price differences, resulting in funds being drained.

Creating a Brand New Liquidity Pair

First, calculate the price you want your token to launch at. This is determined by the value of the token you are pairing your new token with.

For example, if you wanted to launch your token at a price of $0.25 and your second token in the pair is USDC, you would need to supply a ratio of 4 times as many of your tokens as USDC tokens.

As an extra security measure during this process, please:

  1. Disable transfers on your token.
    • This is to prevent someone from setting the price of your token before you do.
  2. Add a whitelist-only mode that restricts sending and receiving addresses.
    • Whitelist only the address for seeding the LP and the Croswap router address to send and receive.
  3. Create the liquidity pair with a small fraction of your funds in the correct ratios as discussed above.
  4. Once the price has been established and you’re happy, you can then add the remaining funds.
  5. Finally, you can enable transfers again and disable the whitelist-only mode. This will enable trading for your pair on the exchange, so only do this when you are ready to begin live trading.

If you take these extra steps, your price will match your desired price, and no one will be able to steal your liquidity.

Congratulations! You’ve successfully set up your token pair on Croswap. Please go back to your original listing ticket and send us the following:

  • Token image (format: SVG)
  • Token name (full name)
  • Token symbol
  • Token decimals
  • Token Economics (if applicable)
  • Pair creation transaction hash
  • Relevant token social media assets, such as:
    • Backgrounds
    • Mascot
    • Etc...
  • Relevant social media platforms

Once received, we will check to make sure that the information about your token is correct and then prepare to add it to our official list of tokens.