This repository has been archived by the owner on Apr 25, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 109
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat: update readme for migration to monorepo (#174)
- Loading branch information
Showing
1 changed file
with
4 additions
and
106 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,109 +1,7 @@ | ||
| # universal-router-sdk | ||
| This SDK facilitates interactions with the contracts in [Universal Router](https://github.com/Uniswap/universal-router) | ||
| # @uniswap/universal-router-sdk - Now at `Uniswap/sdks` | ||
|
|
||
| ## Usage | ||
| Install latest version of universal-router-sdk. Then import the corresponding Trade class and Data object for each protocol you'd like to interact with. | ||
| All versions after 1.9.0 of this SDK can be found in the [SDK monorepo](https://github.com/Uniswap/sdks/tree/main/sdks/universal-router-sdk)! Please file all future issues, PR’s, and discussions there. | ||
|
|
||
| ### Trading NFTs | ||
| warning: `swapNFTCallParameters()` to be deprecated in favor of `swapCallParameters()` | ||
| ```typescript | ||
| import { | ||
| LooksRareTrade, | ||
| LooksRareData, | ||
| SeaportTrade, | ||
| SeaportData | ||
| } from "@uniswap/universal-router-sdk"; | ||
| ### Old Issues and PR’s | ||
|
|
||
| // Each protocol data object contains 1 call to that protocol. Some protocols can fit | ||
| // many NFT purchase within 1 call, like seaport. Others require multiple calls per NFT (like LooksRare). | ||
| const looksRareTrades = new LooksRareTrade([looksrareData1, looksrareData2]) | ||
| const seaportTrades = new SeaportTrade([seaportData1]) | ||
|
|
||
| // Use the raw calldata and value returned to call into Universal Swap Router contracts | ||
| // Trades will happen in the order that they are handed in | ||
| const { calldata, value } = SwapRouter.swapCallParameters([looksRareTrades, seaportTrades]) | ||
| ``` | ||
|
|
||
| ### Trading ERC20s on Uniswap | ||
| warning: `swapERC20CallParameters()` to be deprecated in favor of `swapCallParameters()` | ||
| ```typescript | ||
| import { TradeType } from '@uniswap/sdk-core' | ||
| import { Trade as V2TradeSDK } from '@uniswap/v2-sdk' | ||
| import { Trade as V3TradeSDK } from '@uniswap/v3-sdk' | ||
| import { MixedRouteTrade, MixedRouteSDK, Trade as RouterTrade } from '@uniswap/router-sdk' | ||
|
|
||
| const options = { slippageTolerance, recipient } | ||
| const routerTrade = new UniswapTrade( | ||
| new RouterTrade({ v2Routes, v3Routes, mixedRoutes, tradeType: TradeType.EXACT_INPUT }, | ||
| options | ||
| ) | ||
| // Use the raw calldata and value returned to call into Universal Swap Router contracts | ||
| const { calldata, value } = SwapRouter.swapCallParameters(routerTrade) | ||
| ``` | ||
| ### Using Uniswap for ERC20 NFT Trades | ||
| Send ETH to the router by trading an ERC20 for ETH with a Uniswap Trade and encoding the swap recipient as `ROUTER_AS_RECIPIENT` in the trade. Then subsequently list the NFT trades to use the ETH output to buy NFTs. Trades happen in the order they are listed. | ||
| Use `trade_type: TradeType.EXACT_OUTPUT` to cover the entire NFT price, alternatively the transaction will send supplemental ETH to fulfill the entire price if the swap does not cover it in full. Keep in mind that `TradeType.EXACT_INPUT` trades are subject to slippage on output, and ETH will be sent to cover potential slippage and any remaining ETH will be returned to sender. | ||
| ```typescript | ||
| import { TradeType } from '@uniswap/sdk-core' | ||
| import { Trade as V2TradeSDK } from '@uniswap/v2-sdk' | ||
| import { Trade as V3TradeSDK } from '@uniswap/v3-sdk' | ||
| import { MixedRouteTrade, MixedRouteSDK, Trade as RouterTrade } from '@uniswap/router-sdk' | ||
| import { | ||
| ROUTER_AS_RECIPIENT, | ||
| UniswapTrade, | ||
| LooksRareTrade, | ||
| LooksRareData, | ||
| SeaportTrade, | ||
| SeaportData | ||
| } from "@uniswap/universal-router-sdk"; | ||
|
|
||
| const looksRareTrades = new LooksRareTrade([looksrareData1, looksrareData2]) | ||
| const seaportTrades = new SeaportTrade([seaportData1]) | ||
| // WARNING: never send funds to ROUTER_AS_RECIPIENT unless it is ETH that will be used in NFT trades, otherwise funds are lost. | ||
| const uniswapTrade = new UniswapTrade( | ||
| new RouterTrade({ v2Routes, v3Routes, mixedRoutes, tradeType: TradeType.EXACT_OUTPUT }), | ||
| { slippageTolerance, recipient: ROUTER_AS_RECIPIENT} | ||
| ) | ||
| // Use the raw calldata and value returned to call into Universal Swap Router contracts | ||
| const { calldata, value } = SwapRouter.swapCallParameters([uniswapTrade, seaportTrades, looksRareTrades]) | ||
| ``` | ||
| ### Using WETH for NFT Trades | ||
| The current router purchases all NFTs with ETH, but you can send WETH to the router to be unwrapped for ETH right before the NFT commands. Similar to ERC20 Uniswap Trades for NFTs, supplemental ETH will be sent in the transaction if the WETH amount will not cover the NFT buys. You can also use ERC20s and WETH to cover the transaction by including both commands before the NFT purchase. | ||
| ```typescript | ||
| import { | ||
| ROUTER_AS_RECIPIENT, | ||
| UniswapTrade, | ||
| LooksRareTrade, | ||
| LooksRareData, | ||
| SeaportTrade, | ||
| SeaportData | ||
| } from "@uniswap/universal-router-sdk"; | ||
|
|
||
| const looksRareTrades = new LooksRareTrade([looksrareData1, looksrareData2]) | ||
| const seaportTrades = new SeaportTrade([seaportData1]) | ||
| // if no Permit needed, omit the third var of type Permit2Permit | ||
| const unwrapWETH = new UnwrapWETH(amountWETH, chainId, optionalPermit2Params) | ||
|
|
||
| // Use the raw calldata and value returned to call into Universal Swap Router contracts | ||
| const { calldata, value } = SwapRouter.swapCallParameters([unwrapWETH, seaportTrades, looksRareTrades]) | ||
| ``` | ||
| ## Running this package | ||
| Make sure you are running `node v16` | ||
| Install dependencies and run typescript unit tests | ||
| ```bash | ||
| yarn install | ||
| yarn test:hardhat | ||
| ``` | ||
| Run forge integration tests | ||
| ```bash | ||
| yarn symlink # must install git submodules | ||
| forge install | ||
| yarn test:forge | ||
| ``` | ||
| If you have an issue or open PR that is still active on this SDK in this repository, please recreate it in the new repository. Some existing issues and PR’s may be automatically migrated by the Uniswap Labs team. |