majorfi / bowswap_ui

🏹 Bowswap

Setup

1. Install the dependencies with yarn
2. Create a .env file in the root directory with

ALCHEMY_KEY=YOUR_ALCHEMY_KEY

3. Start the dev project with yarn run dev
4. Go check the swap

How to generate the paths

Bowswap works by generating a path for each possible swap. Detecting the correct swap from one vault to another require some backtracking to try to find the correct, most optimal path.
Because of the number of possibilities, this is a very expensive operation.
From and To will always be Yearn Vaults, fetched directly from the Yearn API here: https://api.yearn.finance/v1/chains/1/vaults/all.
The possible paths (or listing) correspond to the possible pools from Curve Finance we could use to move from one specific LP token to another until we reach the underlying token of the To vault. The pools used are not limited to the one used in Yearn vaults, but integrates all the pools from Curve Finance, including the factory pools (ibBtc, ibEur for example).
All commands must be run in the root directory of the project.
Here are the steps to generate the paths. This can take a while.

1. Update the listings we can use. This can be updated every time a new curve pool is created to try to find new paths.

npx hardhat run scripts/detect_listing.js > scripts/detected_listing.json --network localhost

This will create a new json file with the detected listings. This will be used in next scripts.

2. The first feature of Bowswap is metapool_swaps. This is a way to swap 2 tokens belonging to the same metapool.

npx hardhat run scripts/detect_metapoolSwaps.js > utils/detected_metapoolSwaps.json --network localhost

The paths are generated by fetching all the vaults from Yearn and using the expect function from hardhat to try to perform the swap in a local fork with safe conditions. If the swap is successful, the path is saved in the utils/detected_metapoolSwaps.json file.

3. The second and main feature of Bowswap is the swap command. This command will try to find the best path to swap the tokens.

npx hardhat run scripts/detect_swaps.js > scripts/detected_swaps.json --network localhost

This is the big backtracking function that will try to find the valid path. Depending on the depth (see Line ~217 : for (let max = 0; max < 7; max++) { where 7 is depth) it can be very slow. A new file will be created in the scripts folder and will be used the next script.

4. A new feature was introduced to perform actual swap when possible and save 1 operation when possible. You can use this script to update the detected_swaps.json file.

node scripts/upgrade_swaps.js > utils/detected_swaps.json

Tests

You can test the paths with :

• npx hardhat test tests/00_metapoolswaps.js --network localhost
• npx hardhat test tests/01_swaps.js --network localhost

Links

• Yearn
• yCRV Metapool Swapper by @pandadefi

bowswap_ui's Issues

Add missing vaults

4 new compatible vaults are available on Yearn:

• 0x801Ab06154Bf539dea4385a39f5fa8534fB53073 - Curve EURS-USDC
• 0xBCBB5b54Fa51e7b7Dc920340043B203447842A6b - Curve EURT-USD
• 0xF59D66c1d593Fb10e2f8c2a6fD2C958792434B9c - Curve OUSD
• 0x5e69e8b51B71C8596817fD442849BD44219bb095 - Curve ibBTC

We need to add support for theses on the metapoolswap and the standard swap.

Add MIM to the vault list.

Check if it's possible to use yearn API to get the list of vaults

A possible improvement to #7 is to use yearn API to get the list of vaults: https://api.yearn.finance/v1/chains/1/vaults/all

Can we filter Curve Vaults using apy.fees.keep_crv in the API?

It's something to think about and check if it's doable/convenient.

Persistent FROM and TO

Keep vaults selected and amount persistent across reload

Feature request: Notification counter

In order to incentive the users to use yVempire, a notification counter, sush as the ones on IOS (mails/message) could be a nice thing to add:
When you are connected and in the bowswap swap page, this counter will be displayed based on the migration you could do to increase your yield

yVempire: YFI vault is old

In yVempire, the YFI vault seems to be an old one. Update to the new one: 0xdb25cA703181E7484a155DD612b06f57E12Be5F0

On yVempire only show vaults that have more APY on Yearn

When in yVempire, on the select box, only show that vaults that have a better APY in Yearn that the other

Change FROM and TO vault order

• Order FROM using balances (higher first)

• Order TO vault using APY (higher first)

• Autocomplete FROM with the max value from the higher balance token/vault

Remove notification badge for dust

Would be great to remove (1) for cases when user has dust amount – 100$ or lower?