How to Setup Environment

Tags

In order to set your environment up in preparation for following the Runbook to test a BIP, follow these steps:

Clone the Beanstalk GitHub repository and change directories into the new folder.

Suggestion: name the repository based on which BIP you are verifying. BIP-X will be the name of the directory on your computer after cloning the repository.

git clone git@github.com:BeanstalkFarms/Beanstalk.git BIP-X
cd BIP-X/

Checkout the branch in the GitHub pull request linked in the BIP runbook.

git checkout example-branch

Change directories into the protocol folder.

cd protocol/

Rename the .env-sample file to .env and set the FORKING_RPC, BLOCK_NUMBER and MAINNET_RPC environment variables.

mv .env-sample .env

FORKING_RPC and MAINNET_RPC should be set to the same RPC URL; we recommend getting an API key on Alchemy (this will be provided to BCM Signers). Choose a BLOCK_NUMBER after the facets being added/changed have already been deployed and before they are added to Beanstalk. This means if you are testing a BIP during the Voting Period, you can go to Etherscan and pick any recent block number. The following is an example .env file:

FORKING_RPC=https://eth-mainnet.g.alchemy.com/v2/api-key
BLOCK_NUMBER=17615293
MAINNET_RPC=https://eth-mainnet.g.alchemy.com/v2/api-key
ETHERSCAN_KEY=

Install all packages.

yarn install

Compile the Solidity code.

npx hardhat compile

Fork mainnet locally.

npx hardhat node

Open another terminal window in order to run commands against your mainnet fork. At this point you are ready to follow the Runbook for the given BIP.