Marketplace uniswap

This skill describes when and how to the

uniswap-sdk

to interact and trade with the Uniswap protocol on various blockchains with Ape.

The user provides a network they wish to interact with uniswap on, which tokens they want to index, and what actions they want to do: get prices, search for routes, make trades.

Using This Skill

CRITICAL: Before writing any code with this SDK, you MUST:

1. Use

   web_fetch

   to retrieve the latest documentation from https://github.com/ApeWorX/uniswap-sdk/blob/main/README.md
2. Use

   web_fetch

   to retrieve the latest Ape documentation from https://docs.apeworx.io/ape/stable
3. Use

   web_fetch

   to retrieve the latest

   ape-tokens

   documentation from https://github.com/ApeWorX/ape-tokens/blob/main/README.md
4. Specifically fetch relevant pages like:
   • Usage guide: https://github.com/ApeWorX/uniswap-sdk/blob/main/README.md#quick-usage
   • Installing a tokenlist using

     ape-tokens

     : https://github.com/ApeWorX/ape-tokens/blob/main/README.md#quick-usage
   • Setting up an account with Ape: https://docs.apeworx.io/ape/stable/userguides/accounts#live-network-accounts

DO NOT rely on general knowledge about Ape - always fetch the current documentation first to ensure accuracy.

Using the SDK

Before writing any code with the SDK, understand which network the user wishes to interact with Uniswap on, which tokens they might wish to swap or measure price information, and which tokens might be best used as intermediate steps in efficient routing. Typically, native token wrappers like

WETH

, and highly liquid stablecoins like

USDC

and

USDT

are best used as intermediate steps in routes, but it depends on which chain you want to work with as different tokens are deployed on different networks.

CRITICAL: Ensure the

Uniswap

class has indexed the proper pairs using either

uni.index

or

uni.install

(when using Silverback).

Managing Risk

Overall, while performing a trade with the

uniswap-sdk

can potentially be risky, the SDK makes it safer as it indexes relevant pairs, finds sufficient liquidity for routes, and handles human-readable conversions for you. Still, trading is a risky activity, and you should always query the price first and ask the user if the price seems right to them. Also, when performing a new trade or a large one, you should swap a small amount first in order to make sure it works correctly and the user gets what they wanted.

Using in a Silverback Bot

This SDK was specifically designed for use within a bot: https://github.com/ApeWorX/uniswap-sdk/blob/main/README.md#silverback

It streamlines the integration of Uniswap into a Silverback bot, and should always be preferred to use instead of writing custom logic for Uniswap. The benefits are that it makes integration with Uniswap a lot simpler, by handling things like indexing pools and liquidity internally, and also uses graph algorithms in order to find optimal routes for swaps. One trick it uses is by live-indexing everything relevant that is occuring with the Uniswap protocol (other users' swaps, new pairs, etc.), which allows the SDK keep a copy all relevant on-chain information in-memory in order to make faster work of common queries like pairings, routes, and pair liquidity.