Arbitrum fork doesn't work with hardhat out of the box right now (probably because of a JSON-RPC incompatibility with Arbitrum node). We'll test using our own fork of hardhat that circumvents this issue.
Clone my fork of hardhat repo somewhere
git clone [email protected]:shuklaayush/hardhat.git
cd hardhat
git checkout fix/arbitrum
yarn build
cd packages/hardhat-core
yarn pack # Generate hardhat-v2.6.2.tgz
Clone this repo and install hardhat
git clone [email protected]:shuklaayush/WETH-Sushi-SLP-Arbitrum-Strategy.git
yarn add -D <path-to-hardhat-pack-file>
Import the fork network and run
brownie networks import network-config.yaml
brownie test
Alternatively, to test the strategy logic, use the feat/poly
branch which runs the same strategy on a polygon-fork (with polygon addresses).
See diff here: https://github.com/shuklaayush/WBTC-WETH-SLP-Arbitrum-Strategy/compare/main...shuklaayush:feat/poly?expand=1
This strategy takes Sushi's WBTC/WETH liquidity pool tokens as deposit and stakes it on Sushi's MiniChefV2 for yield. The rewards are in SUSHI. Half of the SUSHI rewards are distributed deposited to the WETH-SUSHI SLP Badger vault on behalf of the BadgerTree. The remaining SUSHI rewards are swapped for WBTC and WETH in equal parts and these tokens are deposited on the liquidity pool to obtain more want.
Deposit WBTC/WETH SLP tokens in Sushi's MiniChefV2, so that we earn interest as well as rewards in SUSHI.
If there's any WBTC/WETH SLP in the strategy, it will be deposited in the pool.
The Strategy will harvest SUSHI rewards, and forward half of them to the WETH-SUSHI SLP Badger vault on behalf of the BadgerTree. It will then swap the remaining half into WBTC and WETH in equal parts and deposit these tokens into the SLP to obtain more want.
In further detail:
- If no SUSHI reward, then do nothing.
- If reward is available, then:
- Swap 50% SUSHI rewards to WETH
- Add liquidity to Sushi's WETH/SUSHI pool using half of the WETH and half of the remaining SUSHI rewards. Process fees on the WETH/SUSHI SLP gained and deposit the rest into the WETH-SUSHI SLP Badger vault on behalf of the BadgerTree.
- Swap the remaining SUSHI rewards for WBTC. Use this and the reamaining WETH tokens to provide more liquidity to the WBTC/WETH pool. Also, process fees on the extra want obtained.
- SUSHI: 31.61%
-
Use this code by clicking on Use This Template
-
Download the code with
git clone URL_FROM_GITHUB
-
Install Brownie & Ganache-CLI, if you haven't already.
-
Copy the
.env.example
file, and rename it to.env
-
Sign up for Infura and generate an API key. Store it in the
WEB3_INFURA_PROJECT_ID
environment variable. -
Sign up for Etherscan and generate an API key. This is required for fetching source codes of the mainnet contracts we will be interacting with. Store the API key in the
ETHERSCAN_TOKEN
environment variable. -
Install the dependencies in the package
## Javascript dependencies
npm i
## Python Dependencies
pip install virtualenv
virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
To deploy the demo Badger Strategy in a development environment:
- Open the Brownie console. This automatically launches Ganache on a forked mainnet.
brownie console
- Run Scripts for Deployment
brownie run deploy
Deployment will set up a Vault, Controller and deploy your strategy
- Run the test deployment in the console and interact with it
brownie console
deployed = run("deploy")
## Takes a minute or so
Transaction sent: 0xa0009814d5bcd05130ad0a07a894a1add8aa3967658296303ea1f8eceac374a9
Gas price: 0.0 gwei Gas limit: 12000000 Nonce: 9
UniswapV2Router02.swapExactETHForTokens confirmed - Block: 12614073 Gas used: 88626 (0.74%)
## Now you can interact with the contracts via the console
>>> deployed
{
'controller': 0x602C71e4DAC47a042Ee7f46E0aee17F94A3bA0B6,
'deployer': 0x66aB6D9362d4F35596279692F0251Db635165871,
'lpComponent': 0x028171bCA77440897B824Ca71D1c56caC55b68A3,
'rewardToken': 0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9,
'sett': 0x6951b5Bd815043E3F842c1b026b0Fa888Cc2DD85,
'strategy': 0x9E4c14403d7d9A8A782044E86a93CAE09D7B2ac9,
'vault': 0x6951b5Bd815043E3F842c1b026b0Fa888Cc2DD85,
'want': 0x6B175474E89094C44Da98b954EedeAC495271d0F
}
>>>
## Deploy also uniswaps want to the deployer (accounts[0]), so you have funds to play with!
>>> deployed.want.balanceOf(a[0])
240545908911436022026
To ship a valid strategy, that will be evaluated to deploy on mainnet, with potentially $100M + in TVL, you need to:
- Add custom config in
/config/__init__.py
- Write the Strategy Code in MyStrategy.sol
- Customize the StrategyResolver in
/config/StrategyResolver.py
so that snapshot testing can verify that operations happened correctly - Write any extra test to confirm that the strategy is working properly
Most strategies have a:
- want the token you want to increase the balance of
- lpComponent the token representing how much you deposited in the yield source
- reward the token you are farming, that you'll swap into want
Set these up in /config/__init__.py
this mix will automatically be set up for testing and deploying after you do so
contracts/MyStrategy.sol
is where you implement your own logic for your strategy. In particular:
- Customize the
initialize
Method - Set a name in
MyStrategy.getName()
- Set a version in
MyStrategy.version()
- Write a way to calculate the want invested in
MyStrategy.balanceOfPool()
- Write a method that returns true if the Strategy should be tended in
MyStrategy.isTendable()
- Set a version in
MyStrategy.version()
- Invest your want tokens via
Strategy._deposit()
. - Take profits and repay debt via
Strategy.harvest()
. - Unwind enough of your position to payback withdrawals via
Strategy._withdrawSome()
. - Unwind all of your positions via
Strategy._withdrawAll()
. - Rebalance the Strategy positions via
Strategy.tend()
. - Make a list of all position tokens that should be protected against movements via
Strategy.protectedTokens()
.
In order to snapshot certain balances, we use the Snapshot manager. This class helps with verifying that ordinary procedures (deposit, withdraw, harvest), happened correctly.
See /helpers/StrategyCoreResolver.py
for the base resolver that all strategies use
Edit /config/StrategyResolver.py
to specify and verify how an ordinary harvest should behave
- Add Contract to check balances for in
get_strategy_destinations
(e.g. deposit pool, gauge, lpTokens) - Write
confirm_harvest
to verify that the harvest was profitable - Write
confirm_tend
to verify that tending will properly rebalance the strategy - Specify custom checks for ordinary deposits, withdrawals and calls to
earn
by setting uphook_after_confirm_withdraw
,hook_after_confirm_deposit
,hook_after_earn
Check the various tests under /tests
The file /tests/test_custom
is already set up for you to write custom tests there
See example tests in /tests/examples
All of the tests need to pass!
If a test doesn't pass, you better have a great reason for it!
To run the tests:
brownie test
Use the --interactive
flag to open a console immediatly after each failing test:
brownie test --interactive
Within the console, transaction data is available in the history
container:
>>> history
[<Transaction '0x50f41e2a3c3f44e5d57ae294a8f872f7b97de0cb79b2a4f43cf9f2b6bac61fb4'>,
<Transaction '0xb05a87885790b579982983e7079d811c1e269b2c678d99ecb0a3a5104a666138'>]
Examine the TransactionReceipt
for the failed test to determine what went wrong. For example, to view a traceback:
>>> tx = history[-1]
>>> tx.traceback()
To view a tree map of how the transaction executed:
>>> tx.call_trace()
See the Brownie documentation for more detailed information on debugging failed transactions.
When you are finished testing and ready to deploy to the mainnet:
- Import a keystore into Brownie for the account you wish to deploy from.
- Run
scripts/deploy.py
with the following command
$ brownie run deployment --network mainnet
You will be prompted to enter your keystore password, and then the contract will be deployed.
If you are using Ganache to fork a network, then you may have issues with the blockchain archive state every 30 minutes. This is due to your node provider (i.e. Infura) only allowing free users access to 30 minutes of archive state. To solve this, upgrade to a paid plan, or simply restart your ganache instance and redploy your contracts.
- Example Strategy https://github.com/Badger-Finance/wBTC-AAVE-Rewards-Farm-Badger-V1-Strategy
- Badger Builders Discord https://discord.gg/Tf2PucrXcE
- Badger Discord channel
- Yearn Discord channel
- Brownie Gitter channel
- Alex The Entreprenerd on Twitter