Convert
Conversions within the Silo between Bean and LP Deposits serve a major role in peg maintenance.
Conversions from one Deposited asset to another are permissioned by a Convert Whitelist. Conversions can be added or removed from the Convert Whitelist via Beanstalk governance.
When the Bean price is above peg (i.e., deltaB is positive), Deposited Beans may be Converted to Deposited LP tokens while retaining grown Stalk from Seeds. This Conversion allows the Silo Member to add Beans to liquidity pools, which has the practical effect of selling Beans above peg. In doing so, Beanstalk incentivizes Stalkholders to grow liquidity for Beans at the expense of additional Bean mints, as the Bean price is decreased back towards peg.
When the Bean price is below peg (i.e., deltaB is negative), Deposited LP tokens may be Converted to Deposited Beans without forfeiting grown Stalk from Seeds or any Stalk due to LP impermanent loss. This Conversion allows Stalkholders to remove excess Beans from liquidity pools and increase the price back towards peg without leaving the Silo, minimizing debt issuance.
Unripe Beans are also convertible to Unripe BEAN:ETH LP, and vice versa, in a similar fashion. See the Unripe Assets section of the Barn page for more info.
Convert Whitelist
In order for a Farmer to be able to Convert a Deposited asset to another, that Conversion must be on the Convert Whitelist.
Additional Conversions may be added to the Convert Whitelist via Beanstalk governance. In order for a Conversion to be added to the Convert Whitelist, Beanstalk requires:
The From token address;
The To token address;
Conditions under which the From token can be converted to the To token; and
A function to determine the number of To tokens received for Converting a given number of From tokens (see Section 14.4 in the whitepaper for complete formulas).
Current Convert Whitelist
From token | To token | Conditions |
---|---|---|
Any token on the Deposit Whitelist* | The same token as From token | Anytime |
Unripe token | Underlying token | Anytime |
BEAN:3CRV LP | Bean | deltaB in the BEAN:3CRV pool < 0 |
Unripe Bean | Unripe BEAN:wstETH LP | deltaB in the BEAN:wstETH Well > 0 |
Unripe BEAN:wstETH LP | Unripe Bean | deltaB in the BEAN:wstETH Well < 0 |
Bean | BEAN:ETH LP | deltaB in the BEAN:ETH Well > 0 |
BEAN:ETH LP | Bean | deltaB in the BEAN:ETH Well < 0 |
Bean | BEAN:wstETH LP | deltaB in the BEAN:wstETH Well > 0 |
BEAN:wstETH LP | Bean | deltaB in the BEAN:wstETH Well < 0 |
*Any token on the Deposit Whitelist can be Converted to the same token in order to allow Stalkholders to update the BDV of their LP tokens when their BDV increases due to impermanent loss.
Performance
Convert functionality was first added in BIP-7, and generalized to support a Convert Whitelist in BIP-21. Since BIP-7 was committed, Conversions by Stalkholders have played a significant role in peg maintenance.
Last updated