Beanstalk Notion
Beanstalk Notion
🏗️

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:

  1. Clone the Beanstalk GitHub repository.

    2. 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
  2. Checkout the branch in the GitHub pull request linked in the
    📖
    BIP Runbooks
     .
    3. git checkout example-branch
  3. Change directories into the protocol folder.
    4. cd protocol/
  4. Rename the .env-sample file to .env and set the FORKING_RPC, BLOCK_NUMBER and MAINNET_RPC environment variables.
    5. 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=16300774
MAINNET_RPC=https://eth-mainnet.g.alchemy.com/v2/api-key
ETHERSCAN_KEY=
  5. Install all packages.
    6. npm install
  6. Compile the Solidity code.
    7. npx hardhat compile
  7. Fork mainnet locally.
    8. npx hardhat node
  8. 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.