Only this pageAll pages
Powered by GitBook
Couldn't generate the PDF for 102 pages, generation stopped at 100.
Extend with 50 more pages.
1 of 100

Farmers' Almanac

Loading...

Loading...

Introduction

Loading...

Loading...

Farm

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Peg Maintenance

Loading...

Loading...

Loading...

Loading...

Loading...

Advanced

Loading...

Loading...

Loading...

Governance

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Guides

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Protocol Resources

Loading...

Loading...

Loading...

Loading...

Loading...

Ecosystem

Loading...

Loading...

Community Resources

Loading...

Loading...

Loading...

Loading...

Archives

Loading...

Loading...

How Beanstalk Works

Beanstalk does not have any collateral requirements. Beanstalk uses credit instead of collateral to create Bean price stability relative to its value peg of $1. The practicality of using DeFi is currently limited by the lack of decentralized low-volatility assets with competitive carrying costs. Borrowing rates on USD stablecoins have historically been higher than borrowing rates on USD, even when supply increases rapidly. Non-competitive carrying costs are due to collateral requirements.

Beanstalk relies on three native assets and three interconnected facilities to regularly oscillate the price of Bean across its value peg:

Tokens

Beanstalk issues 3 tokens:

  1. Beans — Beanstalk ERC-20 fiat stablecoins;

Primary Facilities

1. The Sun

2. The Silo

To encourage consistent security:

  • Seeds yield Stalk every Season.

  • The associated amount of Stalk and Seeds from a given Deposit must be forfeited when it is Withdrawn from the Silo.

Deep and consistent liquidity in liquidity pools that Beans trade in improves stability. Liquidity providers to liquidity pools whose LP tokens are whitelisted can also Deposit their LP tokens in the Silo to earn Stalk and Seeds. At least 1 LP token Deposit type earns at least as many Seeds as Bean Deposits.

3. The Field

Soil is the number of Beans that can be lent to Beanstalk at any given time. Any time Beanstalk is willing to issue debt, there is Soil available in the Field. Any Beans not in the Silo can be Sown (lent) to Beanstalk in exchange for Pods.

Creating Stability

Beanstalk requires a diverse set of participants, including Silo Members (people who Deposit assets in the Silo), Sowers (people who lend Beans to Beanstalk), and arbitrageurs. Beanstalk aligns the incentives of every individual participant to maximize price stability and create a diverse, decentralized economy. Beanstalk-native financial incentives consistently increase censorship resistance, stability and liquidity over time.

At the beginning of each Season, the Sun calculates deltaB (the cumulative time-weighted average shortages or excesses of Beans across liquidity pools on the Minting Whitelist), Beanstalk's debt level, the change in demand for Soil over the previous 2 Seasons, and Beanstalk's liquidity level, and dynamically adjusts the Bean supply, Soil supply, Maximum Temperature and the Crop Ratio to bring the price back towards the peg.

When the price of Bean is too low (i.e., deltaB is negative), Beanstalk:

  • Raises the Maximum Temperature; and

  • Adjusts the Crop Ratio based on Beanstalk's debt and liquidity levels.

By increasing the Soil supply and raising the Maximum Temperature, Beanstalk can decrease the supply of Beans and therefore bring the price of Bean back up to its peg (assuming there are willing lenders at the given Temperature). In principle, a reasonable debt level and consistent credit history attracts lenders.

When the Bean price is too high (i.e., deltaB is positive), Beanstalk:

  • Increases the Bean supply by deltaB, subject to the cap in EBIP-2;

  • Lowers the Maximum Temperature; and

  • Lowers the Crop Ratio.

By increasing the Bean supply, lowering the Maximum Temperature and lowering the Crop Ratio, Beanstalk can bring the price of Bean back down to its peg.

— illiquid yield-generating governance tokens; and

— illiquid tokens which yield 1/10000 Stalk each Season.

Beanstalk uses to create a cost-efficient and protocol-native timekeeping mechanism. The Sun keeps time on the Farm in Seasons. Each Season is ~1 hour long. Beanstalk adjusts itself to return the Bean price to its value peg at the beginning of every Season.

In practice, Beanstalk does not calculate the price of 1 Bean. Instead, at the beginning of a Season, Beanstalk calculates , the sum of the time-weighted average shortages or excesses Beans across liquidity pools on the ;

The Sun uses deltaB to determine how to change the Bean supply and supply.

Beanstalk uses , the Beanstalk DAO, to create a robust decentralized governance mechanism. Farmers can earn yield from passive participation in Beanstalk governance by Depositing assets on the in the Silo to receive Stalk and Seeds.

Stalkholders can submit and vote on (BIPs) and collect a portion of Bean supply increases. A diverse community of Stalkholders creates decentralization.

The Bean vs LP Seed distribution, or more specifically, the , determines the relative benefits of holding Bean exposure vs exposure to at least 1 particular LP token in the Silo over time.

Conversions within the Silo between Bean and LP Deposits serve a major role in peg maintenance (see ).

is Beanstalk’s decentralized credit facility. Anytime the Bean price is too low, Beanstalk uses the Field to attract lenders who can lend their Beans to Beanstalk, which are subsequently burnt in exchange for Pods, Beanstalk’s native debt asset. Pods are paid out on a First In, First Out (FIFO) basis when new Beans are minted.

Pods have a fixed interest rate and unknown maturity date. The number of Pods that grow from 1 Sown Bean is determined by the — the Beanstalk-native interest rate — at the time of Sowing. Pods become Harvestable (redeemable) for 1 Bean on a First In, First Out (FIFO) basis when new Beans are minted.

Increases the Soil supply by deltaB, subject to the cap in ;

To align the interests of Stalkholders and Sowers, 1/3 of Bean supply increases are distributed to Stalkholders and 1/3 go to Pod Harvests. The other 1/3 are distributed to Active Fertilizer holders as part of Beanstalk’s recapitalization plan after the April 2022 governance exploit (see section).

In order to prevent inorganic growth, if the Bean price is too high and the debt level is excessively low for a Season, Beanstalk sells Beans directly in the liquidity pools on the with the highest deltaB until the cumulative deltaB across all pools is 0.

the Sun
Beanstalk Improvement Proposals
Crop Ratio
The Field
Temperature
EBIP-2
Barn
Publius explains how Beanstalk works

Sun

The Beanstalk peg maintenance mechanism requires a protocol-native timekeeping mechanism and regular code execution on Arbitrum. The Sun keeps time on the Farm in Seasons and incentivizes cost-efficient and timely calling of the gm function.

Beanstalk adjusts itself to return the Bean price to its value peg at the beginning of every Season. Each Season is ~1 hour long. The first Season began when Beanstalk was deployed on August 6, 2021 (initially on Ethereum).

The exact beginning of each Season may vary as Seasons do not begin until the gm function has been called through an Arbitrum transaction. The first transaction that successfully calls the gm function after the top of each hour UTC begins a new Season. Beanstalk only accepts one gm function call per Season.

Beanstalk covers the cost of calling the gm function by awarding the sender of an accepted gm function call with newly minted Beans. To encourage regular gm function calls even during periods of congestion on Arbitrum while minimizing cost, the award for successfully calling the gm function starts at 1 Bean and compounds 1.0201% every additional 2 seconds for 300 seconds.

Upon acceptance of the gm call, the Sun:

  1. Increments the Season number;

  2. Awards Beans to the address that successfully called the gm function.

Minting Whitelist

  1. The pool address; and

  2. A function to calculate the liquidity and time weighted average shortage or excess of Beans in the pool.

Current Minting Whitelist

Name
Address

BEAN:WETH Well

BEAN:wstETH Well

BEAN:weETH Well

BEAN:WBTC Well

BEAN:USDC Well

BEAN:USDT Well

Disclosures

Transparency is the cornerstone of DeFi. The Beanstalk DAO endeavors to be as transparent as possible, particularly as it pertains to communicating the risks of interacting with Beanstalk.

1. BEANSTALK WAS ATTACKED ON APRIL 17, 2022 VIA ON-CHAIN GOVERNANCE. ALL ~$77M IN NON-BEAN ASSETS WERE STOLEN. PROTOCOL GOVERNANCE HAS BEEN CHANGED TO A 5-OF-9 COMMUNITY MULTISIG.

On April 17, 2022, Beanstalk was attacked via on-chain governance resulting in a theft of all ~$77M in non-Beanstalk user assets. The attacker used a flash loan to compromise the governance mechanism and steal the assets deposited in the DAO.

Shortly after the attack, Beanstalk was Paused and on-chain governance was removed. Since the attack, governance votes have taken place on Snapshot. Beanstalk is now owned by a community-run multisig wallet (the Beanstalk Community Multisig, or BCM) responsible for executing the will of the DAO as indicated via Snapshot vote. The keys to the BCM are custodied by a group of nine anonymous Beanstalk community members and contributors. All contract changes under the BCM structure require the signature of 5-of-9 BCM signers. This serves as a temporary security measure until either (1) a secure and fully decentralized governance mechanism has been developed and sufficiently audited, or (2) governance is removed altogether.

More information:

2. THERE IS NO MAXIMUM BEAN SUPPLY. THE BEAN SUPPLY CAN GROW INFINITELY THROUGH DEMAND-BASED MINTING AND GOVERNANCE.

Beanstalk increases the Bean supply every Season where the time weighted average price of 1 Bean is greater than $1 over the previous Season. Enough Beans are minted such that if all the newly minted Beans were sold, the Bean price would return to $1. Those Beans are distributed to Stalkholders, Pod holders and Active Fertilizer holders.

More information:

3. BEANSTALK DID NOT HAVE A PRE-MINE, PRE-SALE, OR TEAM ALLOCATION. ALL BEANS HAVE BEEN MINTED IN ACCORDANCE WITH EITHER THE MINTING SCHEDULE OR GOVERNANCE.

Beanstalk did not have a pre-mine, pre-sale or team allocation of any kind. The first 100 Beans were minted when the init function was called to deploy Beanstalk.

More information:

4. BEANSTALK RELIES ON THIRD PARTIES TO PROVIDE CREDIT TO RETURN THE BEAN PRICE TO ITS PEG. THERE IS NO LENDER OF LAST RESORT.

Beanstalk uses a credit based model, allowing anyone to lend Beans to the protocol to participate in peg maintenance. Beanstalk burns any Beans it borrows. As a consequence, the ability of the protocol to return the price of a Bean to the peg relies on the availability of willing creditors, which is not guaranteed. The economic design of Beanstalk fails if it can no longer attract creditors.

More information:

5. BEANSTALK DOES NOT GUARANTEE THE BEAN PRICE. INSTEAD BEANSTALK INCENTIVIZES THE REGULAR OSCILLATION OF THE BEAN PRICE ABOVE AND BELOW ITS PEG THROUGH PROTOCOL-NATIVE INCENTIVES.

Bean is not a collateralized stablecoin and Beanstalk offers no guarantee of the value of Bean. Beanstalk was deployed on August 6, 2021, and since then, the Bean price has crossed its dollar peg thousands of times. Even so, Beanstalk is still in an early stage and various parts of its economic design continue to be improved through governance.

Beanstalk tries to incentivize the regular oscillation of the Bean price above and below its peg. While the protocol's incentives are designed to return the price of a Bean to its peg, the timing of oscillations is indeterminate. The price will almost never be exactly equal to its peg. Crossing the peg in the past is no guarantee of it happening again in the future.

More information:

6. BEANSTALK-NATIVE DEBT DOES NOT HAVE A MATURITY DATE AND THEREFORE MAY NEVER BECOME REDEEMABLE FOR BEANS.

Beanstalk borrows Beans from lenders in exchange for Pods and Sprouts. Bean loans have fixed interest rates but do not have fixed maturity dates.

More information:

7. STALKHOLDERS CAN MAKE ARBITRARY CHANGES TO BEANSTALK THROUGH GOVERNANCE, IF ENACTED BY THE BEANSTALK COMMUNITY MULTISIG. THERE IS NO GUARANTEE THE CHANGES WILL BE BENEFICIAL TO BEANSTALK.

More information:

8. ANYONE CAN RECEIVE STALK BY DEPOSITING WHITELISTED ASSETS IN THE SILO. EARLIER DEPOSITORS IN THE SILO HAVE PROPORTIONALLY GREATER GOVERNANCE POWER RELATIVE TO THE BEAN DENOMINATED VALUE ORIGINALLY DEPOSITED.

Depositors earn Stalk and Seeds. Seeds yield 1/10000 new Stalk every Season. Stalkholders participate in governance and earn Bean seigniorage. Stalk ownership, and thus governance power, decentralizes over time.

As earlier Depositors in the Silo have been accruing Stalk from Seeds for more Seasons compared to later Depositors, these Depositors have greater governance power in proportion to the Bean Denominated Value (BDV) of their original Deposits.

More information:

9. THE BEANSTALK CONTRACT IS OWNED BY THE BEANSTALK COMMUNITY MULTISIG. THE MULTISIG CAN MAKE ARBITRARY CHANGES TO BEANSTALK WITH 5-OF-9 SIGNATURES FROM THE ANONYMOUS SIGNERS. THERE IS NO GUARANTEE THE MULTISIG ENACTS THE GOVERNANCE DECISIONS OF THE DAO.

Ownership of the Beanstalk contracts is held by a 5-of-9 multisig known as the Beanstalk Community Multisig (BCM). The BCM is an extension of the Beanstalk DAO. The BCM's role is to enact on-chain the decisions Stalkholders make via off-chain voting on Snapshot. Besides Publius (one of the members), all members of the BCM are anonymous. Publius selects the other members, who Publius believes will act in the best interest of Beanstalk. This process was approved via governance.

Off-chain governance introduces significant risks related to security and censorship. The BCM is designed to mitigate as many of those risks as possible by distributing the multisig keys across reputable community members and Beanstalk core contributors, and collectively implementing and adhering to a set of best practices. There is no guarantee the BCM enacts the governance decisions the DAO voted on via Snapshot.

More information:

10. MOST BEANSTALK FUNCTIONS CAN BE ARBITRARILY REMOVED BY HYPERNATIVE, A PROACTIVE THREAT PREVENTION AND REAL-TIME MONITORING PLATFORM. THERE IS NO GUARANTEE THAT FUNCTIONS ARE ONLY REMOVED WHEN APPROPRIATE.

The Beanstalk DAO implemented Hypernative into Beanstalk, a proactive threat prevention and real-time monitoring platform. Hypernative has the ability to remove any Beanstalk function unrelated to the Arbitrum Diamond and upgradability of Beanstalk.

Hypernative introduces significant risks related to security and censorship. There is no guarantee that:

  • Hypernative only removes functions during high confidence pre-exploit and exploit-in-progress detections;

  • The BCM will remove Hypernative protections when necessary for the security or censorship resistance of Beanstalk; or that

  • The BCM only removes Hypernative protections when it beneficial to Beanstalk.

More information:

11. AS GOVERNANCE POWER IS DETERMINED THROUGH STALK OWNERSHIP, SUFFICIENT CAPITAL COULD PURCHASE SIGNIFICANT GOVERNANCE POWER AND TAKE OVER BEANSTALK.

More information:

12. A VULNERABILITY IN ETHEREUM OR ARBITRUM COULD RESULT IN A LOSS OF FUNDS. BEANSTALK ASSUMES THE SECURITY OF ETHEREUM AND ARBITRUM.

Ethereum is the largest smart contract blockchain by market capitalization, total value deposited, and dollar denominated transaction value. Arbitrum is the largest L2 on Ethereum by TVL. In general, open source networks with large amounts of value on them and long track records indicate security, but there is no guarantee. Beanstalk assumes the security of Ethereum and Arbitrum.

13. A VULNERABILITY IN BASIN OR ITS COMPONENTS COULD RESULT IN A LOSS OF FUNDS. BEANSTALK ASSUMES THE SECURITY OF BASIN AND ITS CORRESPONDING COMPONENTS.

More information:

14. A VULNERABILITY IN PIPELINE COULD RESULT IN A LOSS OF FUNDS. BEANSTALK ASSUMES THE SECURITY OF PIPELINE.

Through Beanstalk, users can perform complex, gas-efficient interactions with other Arbitrum-native protocols, like Pipeline. Pipeline is a sandbox contract allows anyone to perform an arbitrary series of actions in the EVM in a single transaction.

Pipeline was audited by Halborn, but there is no guarantee that Pipeline is secure. Beanstalk assumes the security of Pipeline.

More information:

15. THE BEAN PRICE IS DERIVED FROM THE VALUE OF ASSETS IT TRADES AGAINST IN DECENTRALIZED AMMS. THERE IS NO GUARANTEE ANY OF THESE ASSETS RETAIN VALUE.

The value of Beans is derived from the non-Bean assets trading against it in decentralized liquidity pools. Each of these assets have their own set of associated risks, unique to the asset. Beanstalk implicitly assumes risk associated with these assets.

16. BECAUSE BEANS DERIVE THEIR VALUE FROM THE ASSETS THEY TRADE AGAINST, AND NOT COLLATERAL, IT IS NOT POSSIBLE FOR ALL BEAN HOLDERS TO EXIT AT A DOLLAR OF VALUE FOR EVERY BEAN.

Beans are not redeemable for any other asset; they can only be traded for another asset that Beans are trading against. As Bean holders sell their Beans, there is less and less value trading against Beans. Thus, unlike collateralized stablecoins, it is not possible for the Bean supply to scale down to zero with every Bean holder getting a dollar of value for every Bean sold.

17. BEANSTALK REQUIRES TRUSTLESS AND RELIABLE ACCESS TO A MANIPULATION RESISTANT PRICE ORACLE FOR A DOLLAR. BEANSTALK USES A CHAINLINK DATA FEED AND THE ON-CHAIN PRICES OF OTHER STABLECOINS TO DETERMINE THE PRICE OF A DOLLAR. THERE IS RISK ASSOCIATED WITH BOTH OF THESE METHODS THAT CAN COMPROMISE THEIR INTEGRITY AS ACCURATE PRICE ORACLES.

Beanstalk's core objective is to oscillate the price of a Bean above and below its dollar peg. To do this, Beanstalk must be able to reliably measure the price of a dollar on-chain without trusting a centralized third-party to provide it. A robust, decentralized stablecoin requires a tamper-proof, manipulation resistant and decentralized price oracle.

A disruption in the reliability of various Chainlink data feeds could impact Bean minting, resulting in adverse consequences for Beanstalk. The Chainlink data feeds are inherently centralized.

More information:

18. BEANSTALK REQUIRES THAT THE GM FUNCTION IS CALLED AT THE TOP OF EACH HOUR ON ARBITRUM. FAILURE TO SUCCESSFULLY INCENTIVIZE THE CALLING OF THE GM FUNCTION COULD HAVE AN ADVERSE AFFECT ON BEANSTALK'S ABILITY TO OSCILLATE THE BEAN PRICE ABOVE AND BELOW ITS PEG.

Beans and/or Soil are minted upon a successful call of the gm function. Beanstalk covers the cost of gm by awarding the sender of an accepted gm function call with newly minted Beans. The failure of Beanstalk to successfully incentivize the calling of gm would effectively result in the failure of Beanstalk to influence the size of the Bean supply, and thereby the Bean price.

More information:

19. THE BEANSTALK CONTRACTS ARE OPEN SOURCE. ANYONE CAN VIEW THE SOURCE CODE AND ATTEMPT TO FIND VULNERABILITIES.

More information:

20. BEANSTALK IS AUDITED BUT AUDITS CANNOT GUARANTEE SECURITY. IT IS ANTICIPATED THAT FUTURE CODE WILL NOT BE AUDITED BEFORE BEING COMMITTED BY THE DAO.

In the future, it is anticipated that the DAO will vote to commit unaudited code. There is always additional risk associated with implementing unaudited code.

There is no guarantee that interacting with Beanstalk through the Beanstalk UI and SDK is secure. Any issues could lead to a loss of funds.

More information:

21. THE APP.BEAN.MONEY FRONTEND CAN BE CENSORED AS IT IS HOSTED ON A CLOUD PROVIDER.

There have been multiple instances of Netlify getting compromised, resulting in phishing attacks. There is no guarantee that the Beanstalk UI will not be subjected to similar attacks.

More information:

22. THE APP.BEAN.MONEY FRONTEND DEPENDS ON THE SUBGRAPHS FOR DISPLAYING VARIOUS ON-CHAIN DATA. THERE IS NO GUARANTEE THAT SUBGRAPH DATA IS ACCURATE OR AVAILABLE.

By default the Beanstalk UI uses a version of the subgraph hosted on Hetzner, a privately held, Germany based cloud provider. Hetzner could censor the subgraph or a technical disruption could prevent access.

More information:

23. REGULATORY INTEREST IN STABLECOINS AND DECENTRALIZED FINANCE WILL RESULT IN NEW INDUSTRY REGULATIONS. THE IMPACT OF FUTURE REGULATIONS ON BEANSTALK IS UNCERTAIN.

In alignment with the ethos of DeFi, Beanstalk has been designed to be permissionless and censorship resistant, without the requirement for any trust-providing intermediary.

It is unclear what regulations, if any, governments will attempt to impose on DeFi. Therefore, it is impossible to predict how any new government regulations of DeFi will affect Beanstalk, or any of the protocols or networks Beanstalk relies on as part of its ecosystem.

24. BEANSTALK IS NOT A FINISHED PROTOCOL AND REQUIRES ONGOING DEVELOPMENT. THERE IS NO GUARANTEE OF FURTHER DEVELOPMENT.

Beanstalk is likely not at a point where it can sustain itself in perpetuity without additional development of itself and the surrounding ecosystem. High quality improvements are essential but are not guaranteed.

Publius, the pseudonym for the three co-founders of Beanstalk, continues to be influential within the Beanstalk DAO. The identities of Publius are public. The identities of most of the remaining Beanstalk contributors are anonymous.

Why Beanstalk

Beanstalk is designed from first principles to issue capital-efficient, decentralized stablecoins that are accessible to anyone with an internet connection.

Today’s predominant stablecoins suffer from one or more fundamental issues, primarily centralization and non-competitive carrying costs.

Centralization

Centralized stablecoins are currently the most widely used stablecoins by market capitalization. The businesses that issue these stablecoins are subject to external oversight and governmental coercion, and have the unilateral power to freeze their stablecoins.

Carrying Costs

Real economic activity built on DeFi requires low-volatility assets for users to hold and transact with. However, borrowing rates of low-volatility on-chain assets exceed those of the off-chain assets to which they are pegged. This is due primarily to collateral requirements — there is an opportunity cost associated with locking up collateral to issue stablecoins.

These collateralized stablecoins suffer from what’s known as negative carry—a condition in which the cost of holding an asset exceeds the yield earned while holding it. In other words, holding the collateral has an inherent inflation-adjusted cost, whether explicit in the form of an interest rate on a loan, or implicit in the form of an opportunity cost to lend it out to borrowers. Issuance and use of collateralized stablecoins is greatly inhibited by non-competitive carrying costs.

Beanstalk is designed to incentivize all capital entering the protocol to continuously maintain exposure to the Bean stablecoin, and in doing so, participate in the growth of Beanstalk. Volatility and yield are baked into the Bean token itself—when the Bean price is too high, Beanstalk mints new Beans and distributes them to various ecosystem participants in a deterministic fashion. This seigniorage is the positive carry that the Beanstalk economy is based on.

Additional resources:

Field

The Field is Beanstalk's credit facility. Beanstalk relies on a decentralized set of creditors to maintain Bean price stability.

Farmers who Sow Beans (lend Beans to Beanstalk) in exchange for Pods are known as Sowers. The Temperature is the interest rate on Bean loans.

The Morning is the first 5 minutes of each Season. Beanstalk changes the Soil and Temperature throughout the Morning according to the peg maintenance mechanism.

Soil

Anytime Beanstalk is willing to issue debt, there is Soil in the Field. Soil represents the number of Beans that Beanstalk is currently willing to borrow.

When Beans are Sown, Beanstalk burns them, permanently removing the Sown Beans from the Bean supply. For example, if there's 10 Soil available and 10 Beans are Sown, the Soil supply becomes 0 and 10 Beans are removed from the Bean supply. If the market is in some sort of equilibrium, Beans are bought to be Sown, which drives the Bean price upward towards its value peg.

Pods

Beans are Sown in exchange for Pods, the Beanstalk-native debt asset. Loans to Beanstalk are issued with a fixed interest rate, known as Temperature, and an unknown maturity date.

Temperature

The Temperature is the interest rate for Sowing Beans in the Field. At 500% Temperature, 1 Bean can be Sown in exchange for 6 Pods. Once those Pods become Harvestable, they can be Harvested in exchange for 6 Beans.

Field Process

  1. Beans are Sown in exchange for Pods.

  2. Pods Ripen into Harvestable Pods on a FIFO basis when Beanstalk mints new Beans according to the peg maintenance mechanism.

  3. Harvestable Pods can be Harvested into Beans.

Economics

Beanstalk is credit based and only fails if it can no longer attract creditors. A reasonable level of debt, a strong credit history and a competitive interest rate attract creditors.

The combination of non-expiry, the FIFO Harvest schedule and transferability encourages Farmers to Sow Beans as efficiently as possible. By maximizing the efficiency of the Soil market, Beanstalk minimizes its cost to attract creditors, the durations and magnitudes of price deviations below its value peg, and excess Bean minting.

Barn

On April 17, 2022, Beanstalk was exploited via a governance attack. The attacker used a flash loan to exploit the protocol’s then on-chain governance mechanism and transferred all of the Deposited assets in the Silo to an address they controlled, resulting in a theft of ~$77M in non-Bean assets.

The Barn is the Beanstalk recapitalization facility used to Replant Beanstalk. The Barn Raise started on June 6, 2022 while the protocol was offline.

Timeline

  • April 17, 2022: Governance exploit

  • June 6, 2022: Barn Raise starts

  • August 6, 2022: Beanstalk Replant

  • October 20, 2023: Migration of Unripe liquidity from BEAN:3CRV to the BEAN:ETH Well

  • July 26, 2024: Migration of Unripe liquidity from BEAN:ETH to BEAN:wstETH

Fertilizer

Fertilizer is a semi-fungible limited debt issuance to recapitalize $77M in stolen liquidity.

At the beginning of the Barn Raise, there was 77M Available Fertilizer. Available Fertilizer is the number of Fertilizer that can be bought from Beanstalk in exchange for 1 USD worth of wstETH each. Fertilizer becomes Active when it is bought, at which point the ERC-1155 Fertilizer token is minted.

Active Fertilizer comes with an associated number of Sprouts. Sprouts represent the debt left to be repaid to Active Fertilizer holders. Fertilizer becomes Used after all of its associated Sprouts are Fertilized into Rinsable Sprouts that can be Rinsed (redeemed) for 1 Bean each.

  • If Fertilizer is not sold yet, it’s Available.

  • If Fertilizer still has Sprouts (is owed Bean mints), it’s Active.

  • If Fertilizer has no more Sprouts (is done earning Bean mints), it’s Used.

When Fertilizer is sold, Beanstalk adds liquidity to the BEAN:wstETH Well at a ratio of 1:0.866616. Adding liquidity at this ratio causes the deltaB in the BEAN:wstETH Well to trend towards the pre-exploit deltaB.

Humidity

The Humidity is the interest rate on Fertilizer purchases. At 200% Humidity, each Fertilizer purchased comes with 3 Sprouts.

Barn Process

  1. Fertilizer is bought with wstETH. Active Fertilizer comes with Sprouts.

  2. Rinsable Sprouts can be Rinsed to be redeemed for Beans.

Unripe Assets

Beanstalk uses the proceeds from the Fertilizer sales to recapitalize liquidity stolen from Silo Members in the April 17th, 2022 governance exploit. Beanstalk will sell enough Fertilizer to fully recapitalize all non-Bean liquidity stolen from Silo Members.

Prior to Replant, Farmers who held Beans in the block prior to the exploit received 1 Unripe Bean for every pre-exploit Bean; Farmers who held whitelisted LP Tokens in the block prior to the exploit received 1 Unripe LP for every 1 Bean Denominated Value (BDV) of each pre-exploit whitelisted LP Token.

For example, a Farmer with 1000 Beans and 2000 BDV of whitelisted LP tokens in the block prior to the exploit received 1000 Unripe Beans and 2000 Unripe LP.

Unripe assets are placed on a vesting schedule in accordance with the success of the Barn Raise and growth of the Bean supply thereafter.

Ripe Assets

More specifically, Unripe assets entitle holders to an associated number of underlying Ripe assets. Ripe Beans and Ripe BEAN:wstETH are minted as Fertilizer is sold.

Chopping

The percentage of Ripe assets that can be claimed by Chopping a pro rata portion of Unripe assets is a the [% recapitalization]^2, where the % recapitalization represents the amount of Ripe assets per Unripe.

Chopped Unripe assets are burned. Beans and BEAN:wstETH LP received for Chopping are distributed from the set of Ripe Beans and Ripe BEAN:wstETH LP, respectively.

For example, if there are 0.22 Ripe Beans for every Unripe Bean, an Unripe Bean can be Chopped in exchange for 0.0484 Ripe Beans.

Because Available Fertilizer is a function of how much non-Bean liquidity still needs to be recapitalized, if Available Fertilizer is non-zero and Unripe BEAN:wstETH LP is Chopped, the amount of Available Fertilizer (and thus how much non-Bean liquidity Beanstalk needs to recapitalize) decreases. The same is true of Conversions from Unripe BEAN:wstETH LP to Unripe Beans in the Silo, while the converse is true of Conversions from Unripe Beans to Unripe BEAN:wstETH LP.

For example, say there’s 50M Available Fertilizer and a Farmer Chops 2M Unripe BEAN:wstETH LP in exchange for 1M BEAN:wstETH Well LP. If non-Beans make up 50% of the BEAN:wstETH Well by dollar value, then 500k less Fertilizer needs to be sold, resulting in 49.5M Available Fertilizer.

Revitalized Assets

Upon Replant, Silo Members in the block prior to the exploit received a portion of their Stalk and Seeds based on the percentage of Fertilizer sold prior to Replant. As the BDV of Unripe assets increases, additional Stalk and Seeds become Revitalized and can be Enrooted. Revitalized Stalk and Seeds start earning Bean seigniorage and Grown Stalk, respectively, upon being Enrooted.

If 20% of total Fertilizer has sold before Replant, a Silo Member receives 20% of their Stalk, Seed and Plantable Seed balances at the time of the Replant. As an example, if the percentage of Fertilizer sold increases by 5%, the additional 5% is distributed to the Silo Member in the form of Revitalized Stalk and Seeds. Once Enrooted, a Silo Member brings their balances to 25% of their pre-exploit Stalk and Seed balances, independent of any Stalk or Seeds they may have earned since Replant.

Silo

The Silo is the Beanstalk DAO. The Silo uses the Stalk System to create protocol-native financial incentives that improve Beanstalk’s security and Bean’s liquidity and stability.

Anyone can become a Silo Member by Depositing whitelisted assets in the Silo to earn Stalk and Seeds. Neither Stalk nor Seeds are liquid. Deposits are represented as ERC-1155 standard tokens.

Deposit Whitelist

To be Deposited into the Silo, an ERC-20 standard token must be on the Deposit Whitelist.

  1. The token address;

  2. A function to calculate the Bean Denominated Value (BDV) of the token; and

  3. The number of Stalk issued per BDV;

  4. The number of initial Gauge Points (which determine Grown Stalk issuance across various LP tokens);

  5. An oracle for calculating the price on the non-Bean asset in the Well;

  6. A function to calculate how the Gauge Points change each Season;

  7. The optimal percentage of Deposited LP BDV.

Current Deposit Whitelist

The Stalk System

Stalkholders are entitled to participate in Beanstalk governance and earn a portion of Bean mints. Governance power and distribution of Bean mints are proportional to each Stalkholder's Stalk balance relative to total outstanding Stalk.

Older Deposits have their Stalk ownership diluted by newer Deposits upon Deposit. Stalk ownership, and each Stalkholder's share of Beanstalk governance voting power, decentralizes over time. Therefore, newly minted Beans are more widely distributed over time. A design that lowers the Gini coefficient of Beans and Stalk is essential to censorship resistance.

Germination

*Stalk is rewarded to a Deposit 2 gm calls after Deposit. In the interim, new Deposits are considered Germinating. Germinating Deposits can be Withdrawn or Transferred, but cannot be Converted.

Germination adds flash loan and inter-block MEV manipulation resistance to the calculation of Deposited BDV (used by the Seed Gauge System). By preventing the accrual of Earned Beans for 1 full Season, Beanstalk further disincentivizes inorganic demand.

The Seed Gauge System

Seeds generate opportunity cost for Withdrawing assets that have been Deposited for longer and marginal benefit for holding particular assets in the Silo in the form of Grown Stalk.

There are 3 new primary tools that Beanstalk has at its disposal as a result of the Seed Gauge System:

  1. The Target Seasons to Catch Up, which determines the target number of Seasons for a new Deposit with an average number of Seeds to catch up to the average Grown Stalk per BDV of existing Deposits at the time of Deposit;

  2. LP vs LP Seed distribution, which determines relative benefits of holding a given non-Bean asset in the Silo over time.

Withdraw

The associated amount of Stalk, Seeds, and Stalk from Seeds from a given Deposit must be forfeited when the Deposit is Withdrawn from the Silo. The requirement to forfeit Stalk that has grown from Seeds over time creates an opportunity cost to leave the Silo, thereby increasing the stickiness of Deposits the longer they stay Deposited.

Deposits can be Withdrawn from the Silo at any time. Deposits can be Transferred to another address directly without the loss of Stalk, Seeds, and Stalk from Seeds.

Convert

Conversions within the Silo between Bean and LP Deposits serve a major role in peg maintenance. LP Deposits can also be Converted to other LP Deposit types for a potential gain in Stalk and/or Seeds. Conversions from one Deposited asset to another are permissioned by a Convert Whitelist.

Governance

Silo Rewards

Earned Beans are Beans that have been paid to a Silo Member since the last Season the Silo Member Planted their Plantable Seeds (defined below). Upon Plant, Earned Beans are Deposited in the current Season.

Earned Stalk are Stalk earned from Earned Beans. Earned Stalk automatically contribute to Stalk ownership and do not require any action to claim them.

Grown Stalk is the Stalk earned from Seeds. Grown Stalk does not contribute to Stalk ownership until it is Mown. Mow can be called on its own, and it is also called at the beginning of any Silo interaction (Depositing, Withdrawing, Converting, Planting, etc.).

Plantable Seeds are Seeds earned in conjunction with Earned Beans. Plantable Seeds must be Planted in order to grow Stalk.

Farmers' Almanac

Beanstalk is a permissionless fiat stablecoin protocol built on Arbitrum.

Beanstalk forms the monetary basis of an Arbitrum-native, rent-free economy facilitated by the seigniorage of its native fiat currency, a stablecoin called Bean.

A stablecoin that does not compromise on decentralization nor require collateral, has competitive carrying costs, and trends toward more stability and liquidity, will unlock the potential of DeFi. Beanstalk's primary objective is to incentivize independent market participants to regularly cross the price of 1 Bean over its dollar peg in a sustainable fashion.

You can find an overview of why Beanstalk was created here:

Links

Overview

The Farm is the Beanstalk ecosystem. Anyone can become a Farmer by interacting with Beanstalk.

The Farm has four primary components: the Sun, Silo, Field and Toolshed.

the Silo
Minting Whitelist

Calculates deltaB, the sum of the time-weighted average shortages or excesses Beans across liquidity pools on the ;

if necessary and checks for ;

Changes the (and updates the Gauge Points of each whitelisted asset);

Sets the initial;

if necessary; and

To be included in the calculation of , a liquidity pool must be on the Minting Whitelist.

Additional liquidity pools may be added to the Minting Whitelist via . In order for a liquidity pool to be added to the Minting Whitelist, Beanstalk requires:

Before interacting with Beanstalk, consider reading the following disclosures prepared by the Beanstalk DAO. This document can be found on Arweave .

Interacting with Beanstalk involves many risks. Before interacting with Beanstalk, you should review the relevant documentation to make sure you understand how Beanstalk works, as well as information about the current state of Beanstalk. The Beanstalk DAO has created this set of disclosures to assist in the educational process. These disclosures are not exhaustive. The , the , and other Beanstalk resources, as well as participating in the Beanstalk community, can help to understand the protocol. Before participating in the protocol, everyone should do their own research, investigation and analysis.

The was replaced with , which was then replaced with . The obsolete tokens have no value according to Beanstalk.

The Bean supply is uncapped and grows as demand for Beans increases. Beans can also be minted arbitrarily through governance (see ).

Beanstalk launched without the need to raise capital. However, after an on-chain governance attack on April 17, 2022 (see ), a fundraiser known as the Barn Raise is being used to recapitalize the non-Bean funds stolen in the exploit. The terms offered in the fundraiser are available to any Arbitrum address.

Pods and Sprouts are repaid when the time weighted average price of 1 Bean is greater than $1 over the previous Season, but there is no guarantee this will continue until all Pods and Sprouts become redeemable (see ). Governance may also arbitrarily modify the redeemability of Beanstalk debt (see ).

Beanstalk is governed by the Beanstalk DAO—the Silo, which is comprised of Stalkholders. Stalkholders vote on Beanstalk Improvement Proposals (BIPs), which can arbitrarily change Beanstalk. Voting rights come from Stalk ownership (see for details on Stalk).

Any community member that meets a certain Stalk ownership threshold may propose a BIP. If the BIP passes, the Beanstalk Community Multisig (see for details on the BCM) executes the will of the DAO based on the results of the vote, unless the Stalk distribution is compromised in a flash loan or other governance attack. Through this governance process, Stalkholders may make arbitrary changes to Beanstalk.

Beanstalk is governed by Stalkholders, as described in . Stalk ownership, and thus governance power, decentralizes over time given the inflationary nature of Stalk. However, there is no maximum Stalk supply. Stalk is minted for Deposits based on the Bean Denominated Value (BDV) of the Deposit, up to any arbitrary BDV.

Stalk ownership was previously compromised via flash loan, which enabled the on-chain governance attack on April 17, 2022 (see ). The Beanstalk Community Multisig serves as a temporary security measure until either (1) a secure and fully decentralized governance mechanism has been developed and sufficiently audited, or (2) governance is removed altogether.

Beans trade in Wells on Basin. Well LP tokens are whitelisted in the Silo and used by Beanstalk to determine how many Beans and/or Soil to mint. Basin and the corresponding components that Beanstalk uses (the Constant Product Well Function, the Stable Well Function, the Well Implementation, Multi Flow, etc.) were audited by , and . While all are reputable auditors, there is no guarantee that Basin or its components are secure. Beanstalk assumes the security of Basin and its corresponding components.

The Beanstalk contracts are open source and deployed on Arbitrum. There may be bugs, flaws, or other unintended consequences from using open source code to govern irreversible financial transactions on a decentralized network. These issues may lead to a loss of funds if present and discovered by malicious actors, and has in the past (see ).

Security is paramount to Beanstalk's success. Prior to Replant in August 2022, the majority of Beanstalk’s code was audited by Halborn and . Up to October 2024, the majority of new Beanstalk code since Replant has been audited by Halborn, Cyfrin and Codehawks. While all are reputable audit firms, there is no guarantee Beanstalk is secure. Beanstalk was audited by prior to the April 2022 governance exploit.

The Beanstalk UI hosted at is hosted on Netlify, a privately held, United States based cloud provider. Netlify could censor the frontend at will, or a technical disruption could prevent access. In either scenario, Beanstalk would not be accessible from a web browser until (1) Beanstalk Farms, the decentralized development organization that manages the site, could deploy the frontend elsewhere, or (2) other parties could use the open source code to deploy their own frontends to interact with the Beanstalk contracts.

The Beanstalk UI hosted at depends on the Beanstalk and Bean Subgraphs for displaying various data.

Beanstalk, on the other hand, is governed by a DAO and uses an on-chain price oracle to determine the price of a dollar. The yield-bearing governance token, known as , becomes more distributed over time. Beanstalk is highly resistant to censorship by design such that anyone, anywhere can access low-volatility assets in a fully permissionless manner.

Instead, Beanstalk utilizes a credit-based model to create endogenous value. By relying on its own creditworthiness to expand supply and maintain Bean price stability, rather than collateral, Beanstalk creates a scalable, capital-efficient alternative. Furthermore, because Beans require no collateral and Bean seigniorage is partially distributed to Bean holders in the , Beans have positive carry.

For guides on interacting with the Field through the Beanstalk UI, go .

When P ≥ 1 (i.e., ≥ 0), the Soil supply decreases logarithmically at the beginning of each block in the Morning. When P < 1 (i.e., deltaB < 0), Beanstalk sets the Soil supply to the minimum of (1) the deltaB calculated using the instantaneous reserves from and (2) the time-weighted deltaB over the previous Season. See the section.

The number of Pods received from 1 Sown Bean is determined by the Temperature at the time of Sowing. Newly issued Pods accumulate in the back of the Pod Line. The front of the Pod Line receives 1/3 of new Bean mints when there are more than zero Unfertilized Sprouts (Sprouts are issued by the ). If there are no Unfertilized Sprouts, the front of the Pod Line receives 1/2 of new Bean mints.

Pods Ripen into Harvestable Pods that can be Harvested (redeemed) for 1 Bean each on a First In, First Out () basis. There is no penalty for waiting to Harvest Pods.

Pods are tradeable on the . Pods can also be Transferred to another address directly.

Beanstalk it is willing to offer each Season at the beginning of each Season according to the peg maintenance mechanism.

of each Season, the Temperature is the result of a Dutch auction, where the Temperature increases logarithmically from 1% in the block of a successful gm function call up to the Maximum Temperature over the course of 5 minutes. During times of short-term excess demand for Soil, the Morning results in Beanstalk paying significantly less to attract creditors.

Beanstalk never defaults on debt (although in the event of Beanstalk no longer attracting creditors, the loan maturity date would become infinitely far in the future—see ). Beanstalk is willing to issue Pods every Season.

Upon exploit, Beanstalk was Paused and the on-chain governance mechanism was removed. Stalkholders voted on how Beanstalk should proceed.

For guides on interacting with the Barn through the Beanstalk UI, go .

When there are more than zero Unfertilized Sprouts, 1/3 of new Bean mints are allocated towards Fertilizer on a basis. This is in contrast to the FIFO Harvest schedule of the Pod Line in the Field.

The Humidity is constant each . The Humidity was 500% prior to Replant, after which it dropped to 250% and then decreased by an additional 0.5% each Season until it reached 20%. The Humidity will remain at 20% until all Available Fertilizer is purchased.

Sprouts become Rinsable on a pari passu basis when Beanstalk according to the peg maintenance mechanism.

On October 20th, 2023 Ripe BEAN:3CRV LP was migrated to Ripe BEAN:ETH LP. As a result, Unripe BEAN:3CRV LP became Unripe BEAN:ETH LP (with the same token address). See .

On July 26, 2024 Ripe BEAN:ETH LP was migrated to Ripe BEAN:wstETH LP. As a result, Unripe BEAN:ETH LP became Unripe BEAN:wstETH LP (with the same token address). See .

For guides on interacting with the Silo through the Beanstalk UI, go .

Additional tokens may be added to the Deposit Whitelist via . In order for a token to be added to the Deposit Whitelist, Beanstalk requires:

A function to calculate what portion of liquidity counts towards the calculation (i.e., Liquidity Weight); and

*See the section of the page for more info.

When whitelisted assets are Deposited into the Silo, Beanstalk rewards the Depositor with Stalk* and Seeds. Seeds yield 1/10000 new Stalk every .

Stalkholders can submit and vote on Beanstalk Improvement Proposals (BIPs). Stalkholders receive 1/3 of new Bean mints while there are more than zero Unfertilized Sprouts (Sprouts are issued by the ). If there are no Unfertilized Sprouts, Stalkholders receive 1/2 of new Bean mints.

Bean vs LP Seed distribution, or more specifically, the , which determines the relative benefits of holding Bean exposure vs exposure to at least 1 particular LP token in the Silo over time; and

See section for more information.

See section for more information.

See section for more information.

Revitalized Stalk are Stalk that have vested for Unripe asset holders. Revitalized Stalk are minted as the BDV of Unripe assets increases. Revitalized Stalk does not contribute to Stalk ownership until Enrooted. See the section of the page for more info.

Revitalized Seeds are Seeds that have vested for Unripe asset holders. Revitalized Seeds are minted as the BDV of Unripe assets increases. Revitalized Seeds do not generate Stalk until Enrooted. See the section of the page for more info.

Beanstalk is an experiment. Before interacting with Beanstalk, consider reading the prepared by the DAO.

If you are looking for complete formulas behind the different mechanisms of Beanstalk, check out the (being updated to reflect and the migration to Arbitrum).

If you have any other questions while browsing the Farmers' Almanac, join the and ask in the (#❓・questions) channel!

Please share any feedback on the Farmers' Almanac in the (#📜・docs-feedback) channel in Discord. You can submit a pull request to the Farmers' Almanac yourself .

The offers payment for participation in timekeeping and regular code execution. Time on the Farm is kept in Seasons.

The —the Beanstalk DAO—offers passive yield opportunities to owners of Bean and other whitelisted assets for participation in governance of Beanstalk upgrades and contribution to security, liquidity and stability.

The offers yield opportunities to creditors for participating in peg maintenance.

The offers a suite of tools for efficient use of Beanstalk and other Arbitrum-native protocols.

The is the Beanstalk recapitalization facility being used to Replant Beanstalk but is not a primary component of the Farm.

Changes the Maximum Temperature
Flood
Crop Ratio
Beanstalk governance
here
Beanstalk whitepaper
Farmers' Almanac
old Bean token
another token on Ethereum
the latest Bean token on Arbitrum
Past BIPs
Beanstalk Governance Exploit
BCM Process
Whitepaper, Section 8.10, Bean Supply
BFP-72: The Path Forward, No Haircuts
Whitepaper, Section 7, Barn
Barn Raise Documentation
Whitepaper, Section 6, Field
Field Documentation
Whitepaper, Section 8.1, Ideal Equilibrium
Peg Maintenance Documentation
Whitepaper, Section 11.2, Strong Credit
Economics Documentation
Beanstalk DAO Snapshot
Past BIPs
Whitepaper, Section 5.1, The Stalk System
BFP-73: Beanstalk Community Multisig
BCM Dashboard
Hypernative
BIP-46: Hypernative
Whitepaper, Section 5.1, The Stalk System
BCM Process
Halborn
Cyfrin
Code4rena
BIP-37: Basin Integration
Basin Audit Reports
Basin Whitepaper
Multi Flow Pump Whitepaper
BIP-30: Generalized Pipeline
Pipeline Audit Report
Pipeline Whitepaper
Whitepaper, Section 10, Depot
Whitepaper, Section 8.2, Decentralized Price Oracle
Whitepaper, Section 4, Sun
Sun Documentation
Beanstalk on GitHub
Trail of Bits
Omniscia
Beanstalk Audits
app.bean.money
Beanstalk UI on GitHub
Beanstalk Farms Documentation
app.bean.money
Beanstalk Subgraph on GitHub
Silo
Beanstalk Whitepaper
Bank Runs, Airplanes, and Beanstalk
Thoughts Before the Barn Raise from Publius
#7
#1
#4
#7
#8
#9
#7
#1
#1
Soil
Stalk
Seeds
Deposit Whitelist
The Stalk System Documentation
Stalk
0xBeA00Aa8130aCaD047E137ec68693C005f8736Ce
0xBEa00BbE8b5da39a3F57824a1a13Ec2a8848D74F
0xBeA00Cc9F93E9a8aC0DFdfF2D64Ba38eb9C2e48c
0xBea00DDe4b34ACDcB1a30442bD2B39CA8Be1b09c
0xBea00ee04D8289aEd04f92EA122a96dC76A91bd7
0xbEA00fF437ca7E8354B174339643B4d1814bED33
here
Barn
changes the Maximum Temperature
via Snapshot
here
Season
BIP-38
BIP-
48
here
Beanstalk governance
Season
Barn
Crop Ratio
Seed Gauge System
Convert
Governance
Disclosures
Beanstalk whitepaper
BIP-50
Beanstalk Discord
here
Introduction
Beanstalk Mechanics
Guides to Using Beanstalk
Peg Maintenance
Governance
Glossary
Contracts
Other Links
Sun
Silo
Field
Toolshed
Barn
Disclosures
Barn
Unripe Assets
Barn
Revitalized Assets
Barn
Revitalized Assets
Pod Market
During the Morning
Soil supply
Mints Beans
Bean Supply Documentation
Decentralized Price Oracle Documentation
mints new Beans
Liquidity to Supply Ratio

Whitelisted asset

Stalk per BDV

Optimal % Deposited LP BDV

Liquidity weight

1

N/A

N/A

1

16%

100%

1

26%

100%

1

14%

100%

1

20%

100%

1

12%

100%

1

12%

100%\

1

N/A

N/A

1

N/A

N/A

Pod Market

Pods

Sellers can List Pods or Fill open Pod Orders placed by buyers.

Buyers can Order Pods or Fill open Pod Listings placed by sellers.

Pod Listings

Pods from Beans Sown in a single transaction form a Plot. Anyone with a Plot can List a whole or partial Plot for sale in exchange for Beans. This is known as a Pod Listing. Pod Listings have the following inputs:

Pod Listing Inputs

Example

1. Plot

Place in Line: 140M, Pods: 4,000

2. Position within the Plot

2,000 to 4,000

3. Price per Pod

0.80 Beans

4. Expiration

30M Pods

1. Plot

Farmers may own multiple Plots. Plots are identified by their place in the Pod Line.

2. Position within the Plot

As Pods are Harvested on a First In, First Out (FIFO) basis, if less than a whole Plot is Listed, the seller must choose which Pods within the Plot to List. A seller can List any contiguous set of Pods within a Plot. If only a portion of a Plot is Listed, the seller must choose which subset of Pods within that Plot are for sale. In the example above, the last 2,000 Beans in the Plot are Listed, while the first 2,000 (i.e. Pods 0 - 2,000) remain in the seller’s possession.

3. Price per Pod

The sale price of each Pod, denominated in Beans.

4. Expiration

The number of Pods that can Harvest before the expiration of the Listing. Setting this input to 30M Pods would remove this Listing from the Pod Market once 30M Pods are Harvested after the creation of the Listing.

A Pod Listing can be Cancelled at any time until it is entirely Filled. Plots can only be Listed in a single Pod Listing at a time. Pod Listings are automatically Cancelled if the owner of the Plot transfers or re-Lists any Pods in the Plot.

A Pod Listing can be entirely or partially Filled at any time by a buyer. If the Pod Listing is partially Filled, the rest of the Pod Listing remains Listed.

Pod Orders

A Pod Order is an offer to buy Pods at a given price, before a given place in the Pod Line. Any seller may Fill a Pod Order by selling Pods according to the terms of the Order.

Anyone with Beans can Order Pods by creating a Pod Order. A Pod Order has the following inputs:

Pod Order Inputs

Example

1. Maximum number of Pods to be purchased

4,000 Pods

2. Price per Pod

0.80 Beans

3. Maximum place in the Pod Line

140.0M

1. Maximum number of Pods to be purchased

Because Pod Orders can be partially or entirely Filled at any time by a seller, a Pod Order defines the maximum number of Pods the buyer would like to purchase at a given price.

2. Price per Pod

The price to be paid for each Pod, denominated in Beans.

3. Maximum place in the Pod Line

A Pod Order with a maximum place in the Pod Line of 140.0M could be Filled by any Pods with a position in the Pod Line of 140.0M or earlier. In general, Pods closer to the front of the Pod Line are more valuable, as they become Harvestable for Beans sooner due to the FIFO Harvest schedule.

A Pod Order can be Cancelled at any time until it is Filled. To facilitate instant clearance, Beans are locked in a Pod Order until it is entirely Filled or Cancelled. If the Pod Order is partially Filled, the rest of the Pod Order remains Listed.

Depot

Current complex interactions with Arbitrum-native protocols are tedious, cumbersome and expensive. The Depot facilitates complex, gas-efficient interactions with other Arbitrum-native protocols in a single transaction.

Pipeline

  • pipe(...)

  • multiPipe(...)

  • advancedPipe(...)

Temperature

Direction

The current state of Beanstalk is in part determined by the direction of change with respect to ideal equilibrium.

When the deltaB over the previous Season is > 0, debt is paid back. Therefore, if there is more debt than optimal, Beanstalk is moving toward the ideal equilibrium. If there is less debt than optimal, Beanstalk is moving away from the ideal equilibrium.

When the deltaB over the previous Season is < 0, debt can only increase or remain constant. Therefore, if there is more debt than optimal, Beanstalk is moving away from ideal equilibrium. If there is less debt than optimal, Beanstalk is moving toward ideal equilibrium.

Demand for Soil

Demand for Soil is a factor in the acceleration of Beanstalk with respect to ideal equilibrium, which affects Maximum Temperature changes. Demand for Soil is considered decreasing, steady or increasing.

Based on this ratio of the number of Sown Beans over the prior two Seasons, or Delta Demand:

  • If Delta Demand < 95%, demand for Soil is decreasing.

  • If 95% ≤ Delta Demand < 105%, demand for Soil is steady.

  • If 105% ≤ Delta Demand, demand for Soil is increasing.

However, when there is between 0 and 1 Soil remaining at the end of any Season, the ratio is not used. Instead, Beanstalk checks the following conditions to determine the current demand for Soil:

  • After one or more Seasons in which there was > 1 Soil remaining, if there is between 0 and 1 Soil remaining at the end of the latest Season, demand for Soil is increasing.

  • When there is at most 1 Soil remaining in consecutive Seasons, the difference in time it takes for the excess Soil (S > 1) to be Sown over the previous two Seasons can provide a more accurate measurement.

    • If S > 1 was Sown in the first 10 minutes of the previous Season, demand for Soil is increasing.

Acceleration

The current state of Beanstalk with respect to ideal equilibrium is in part determined by the acceleration of change.

The acceleration of Beanstalk affects the magnitude of Maximum Temperature changes and is considered decelerating, steady or accelerating based on the price over the previous Season and the demand for Soil.

Current and Optimal State

Based on a combination of Beanstalk’s direction and acceleration, Beanstalk has six potential current states:

  • Accelerating away from ideal equilibrium;

  • Accelerating toward ideal equilibrium;

  • Steady away from ideal equilibrium;

  • Steady toward ideal equilibrium;

  • Decelerating away from ideal equilibrium; and

  • Decelerating toward ideal equilibrium.

Beanstalk’s optimal state is that which moves Beanstalk toward ideal equilibrium in the healthiest fashion, given the current position.

When the debt level is excessively high or low, an optimal state is accelerating toward ideal equilibrium. When the debt level is reasonably high or low, an optimal state is either steady or decelerating toward ideal equilibrium.

Considering the current state and the debt level, Beanstalk adjusts the Maximum Temperature to move toward the optimal state:

Morning

Overview

Beanstalk faces the fundamental limitation that it cannot fix the Bean price at its value peg, but instead must encourage widespread participation in peg maintenance through protocol-native financial incentives. Stability is a function of how regularly the price of a Bean oscillates across its peg and the magnitude of price deviations from it.

Beanstalk has five direct peg maintenance tools available:

Ideal Equilibrium

Beanstalk is in ideal equilibrium when the Bean price, the debt level and liquidity level are all stable at their optimal levels. In practice, this requires that four conditions are met:

  1. The price of Bean is regularly oscillating around the peg;

  2. The Beanstalk debt level is optimal;

  3. The Beanstalk liquidity level is optimal; and

  4. Demand for Soil is steady.

In order to return to ideal equilibrium, Beanstalk affects the supply of and demand for Beans in response to the Bean price, the Beanstalk debt level, the Beanstalk liquidity level and changing demand for Soil. It does so by adjusting the Bean supply, Soil supply, Temperature and Crop Ratio.

Bean supply increases primarily affect the Bean price. Soil supply impacts the Bean supply and the debt level. Temperature changes primarily affect demand for Soil. Crop Ratio changes primarily affect demand for Conversions.

In order to make the proper adjustments, Beanstalk reassesses the states of both the Bean and Soil markets at the beginning of each Season.

In practice, maintaining ideal equilibrium is impossible. Deviations from ideal equilibrium are normal and expected. As Beanstalk grows, the durations and magnitudes of deviations are expected to decrease.

Decentralized Price Oracle

Beanstalk's core objective is to oscillate the price of Bean above and below its dollar peg. To do this, Beanstalk must be able to reliably measure the price of a dollar on-chain without trusting a centralized third-party to provide it. A robust, decentralized stablecoin requires a tamper-proof, manipulation-resistant and decentralized price oracle.

P > Q

Price spikes makes Beans less attractive to borrow and price other assets against. Beanstalk should be more aggressive in returning the price to peg when the price reaches a particular threshold above $1. Currently Q is set to $1.05, a reasonable threshold while the Bean supply is small. It does not seem that there is a natural opposite to Q when P < 1.


Debt Level

Beanstalk defines a handful of Pod Rate ranges that it uses as an input to determine how to change the Temperature:

  • Excessively low debt: Pod Rate < 5%

  • Reasonably low debt: 5% ≤ Pod Rate < 15%

  • Optimal level of debt: Pod Rate = 15%

  • Reasonably high debt: 15% < Pod Rate ≤ 25%

  • Excessively high debt: Pod Rate > 25%

Liquidity Level

The Liquidity to Supply Ratio (L2SR) represents the Beanstalk liquidity level relative to the Bean supply. The L2SR is a useful indicator of Beanstalk's health.

In the context of the L2SR, liquidity is defined as the sum of the USD values of the non-Bean assets in each whitelisted liquidity pool multiplied by their respective liquidity weights. Supply is defined as the total Bean supply minus Locked Beans (defined below).

Beanstalk can be in 4 different states in relation to its L2SR:

  • Excessively low liquidity: L2SR < 12%;

  • Reasonably low liquidity: 12% ≤ L2SR < 40%;

  • Optimal level of liquidity: L2SR = 40%

  • Reasonably high liquidity: 40% < L2SR ≤ 80%; or

  • Excessively high liquidity: L2SR > 80%.

Locked Beans

Due to the Barn Raise and the associated Beans underlying Unripe assets, the number of tradable Beans does not equal the total Bean supply. As of May 2024, ~0.224 Beans underlying each Unripe Bean, but holders can only redeem ~0.0102 Beans per Unripe Bean. Thus, ~0.2138 Beans Per Unripe are considered not tradable.

By excluding Locked Beans from the Bean supply in the L2SR calculation, Beanstalk can determine its health in terms of liquidity based on only the number of Beans that can reasonably be sold. This is preferable over factoring in Beans that cannot be sold.

Bean Supply

Soil Supply

Convert

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.

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.

  1. The From token address;

  2. The To token address;

  3. Conditions under which the From token can be converted to the To token; and

Current Convert Whitelist

Performance

Generalized Convert

Stalk Penalty

Generalized Convert introduced the ability to Convert against peg and a Stalk penalty for doing so. The penalty applies a 100% reduction in Grown Stalk of the Converted Deposit based on the amount that was Converted against peg.

For example, if 20 BDV is Converted, and only 10 of the BDV Converted is against peg, then 50% of the Grown Stalk associated with Deposit will be burned. No penalty is applied if the Convert brings the cumulative deltaB closer to 0.

Convert Capacity

To prevent flash loan attacks that allow Converting against peg without incurring the Stalk penalty, a Convert capacity mechanism was introduced.

Every Convert updates the amount of BDV Converted per block on a per Well and overall basis. The total capacity available before a penalty applies is based on deltaB for each corresponding Well and the overall deltaB.

Flood

Current Flood Whitelist

Toolshed

The Toolshed offers a suite of tools for efficient use of Beanstalk and other Arbitrum-native protocols.

Multi Flow
Soil Supply

*

*

For guides on interacting with the Market through the Beanstalk UI, go .

can be bought and sold in a decentralized, trustless fashion on the Market. The Market creates liquidity for Pods through an on-chain order book.

Any protocol with a Pipeline to the Depot can be used via Beanstalk in a single transaction. Pipelines to the Depot can be added via .

The Pipeline allows anyone to perform an arbitrary series of actions in the EVM in a single transaction by using as a sandbox for execution.

The following functions to interact with Pipeline can be called through the Pipeline.

Beanstalk relies on a decentralized set of creditors to maintain Bean price stability. Anytime Beanstalk is willing to issue debt, it issues . Soil represents the number of Beans that Beanstalk is currently willing to borrow. Loans to Beanstalk are issued with a fixed interest rate, known as Temperature. If the Temperature is 500%, 1 Bean can be Sown in exchange for 6 Pods. Once those Pods become Harvestable, they can be Harvested in exchange for 6 Beans.

At the beginning of each , Beanstalk changes the Maximum Temperature depending on its position ( and ) and current state ( and ) with respect to its .

The Temperature increases at the beginning of each block of the of each Season (25 blocks) according to a Dutch auction.

The direction of change of Beanstalk with respect to ideal equilibrium is considered either toward or away from ideal equilibrium, based on the current debt level and the over the previous Season.

The number of Sown Beans each Season (utu_tut​) indicated demand for Soil over the course of that Season.

The rate of change in the number of Sown Beans each Season (Delta Demand) is calculated as the number of Sown Beans in the previous Season (ut−1u_{t-1}ut−1​) divided by the number of Sown Beans two Seasons ago (ut−2u_{t-2}ut−2​).

If S > 1 was not Sown in the first 10 minutes of the previous Season, Beanstalk compares the time it took for all S > 1 to be Sown in the previous two Seasons (ut−1u_{t-1}ut−1​ and ut−2u_{t-2}ut−2​).

If it took less than one minute longer for all S > 1 to be Sown in ut−2u_{t-2}ut−2​ than ut−1u_{t-1}ut−1​, demand for Soil is decreasing. If it took longer than one minute, demand for Soil is increasing. Otherwise, demand for Soil is steady.

The contains a graphical representation of each possible state and an explanation for each Maximum Temperature adjustment.

During the Morning of each Season (the first 5 minutes), the Temperature increases logarithmically from 1% in the block of a successful gm function call up to the Maximum Temperature over the course of 5 minutes (See for complete formulas). During times of short-term excess demand for Soil, the Morning results in Beanstalk paying significantly less to attract creditors.

Increase the ;

Change the ;

Change the ;

Change the ; and

Sell Beans ().

At the beginning of every , Beanstalk evaluates its position (i.e., price, debt level and liquidity level) and current state (i.e., direction and acceleration) with respect to ideal equilibrium, and dynamically adjusts the Bean supply, Soil supply, Temperature and Crop Ratio to move closer to ideal equilibrium.

within the between Bean and LP Deposits serve a major role in peg maintenance.

Using , Beanstalk can calculate an inter-block MEV manipulation resistant price in Wells.

In practice, Beanstalk does not calculate the price of 1 Bean. Instead, at the beginning of each Season, Beanstalk calculates the sum of the time weighted average shortages or excesses of Beans across the liquidity pools on the over the previous Season (i.e., ).

The Pod Rate represents the Beanstalk debt level relative to the Bean supply. The Pod Rate is often used as a proxy for Beanstalk’s health. If the Bean supply is 1000 and there are 2000 , the Pod Rate is 200%.

At the beginning of each Season, Beanstalk increases the Bean supply by deltaB if there was a time weighted average shortages of Beans across the pools in the over the previous Season, subject to the cap in . Essentially, Beanstalk will mint the number of Beans that need to be sold in the pools on the Minting Whitelist to return the Bean price to a dollar.

, Pod holders, and holders receive 1/3 of new Bean mints each while there are outstanding. If there is no Active Fertilizer, Stalkholders and Pod holders receive 1/2 of new Bean mints each. If there are neither Pods nor Active Fertilizer, Stalkholders receive 100% of new Bean mints.

When P < 1 over the previous Season (i.e., deltaB < 0), the Soil supply is equal to the minimum of (1) cumulative deltaB calculated using the instantaneous reserves from Multi Flow and (2) the cumulative TWA deltaB, the sum of the time-weighted average excess of Beans across the liquidity pools on the over the previous Season, subject to the cap in EBIP-2.

When P ≥ 1 over the previous Season (i.e., deltaB ≥ 0), Beanstalk is still willing to issue debt in order to measure changing demand for . The Soil supply is based on the number of Pods that Ripen and become Harvestable at the beginning of the Season, the Temperature (see section), and the Beanstalk debt level. A greater number of Pods Ripening increases the Soil supply. Higher Temperature and debt level decrease the Soil supply. See for complete formulas.

Conversions within the 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 .

When the Bean price is above peg (i.e., 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.

Unripe Beans are also convertible to Unripe BEAN:ETH LP, and vice versa, in a similar fashion. See the section of the page for more info.

Additional Conversions may be added to the Convert Whitelist via . In order for a Conversion to be added to the Convert Whitelist, Beanstalk requires:

A function to determine the number of To tokens received for Converting a given number of From tokens (see for complete formulas).

From token
To token
Conditions

*Any token on the 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.

Convert functionality was first added in , and generalized to support a Convert Whitelist in . Since BIP-7 was committed, Conversions by Stalkholders have played a significant role in peg maintenance.

With the introduction of Generalized Convert in , which supports LP token -> LP token Converts as well as Converts against peg (with an associated Stalk penalty). A per-block Convert cap mechanism protects against flash loan attacks.

Beanstalk sells newly minted Beans on the open market during long run increases in demand for Beans when , and have not crossed the Bean price over its peg.

At the beginning of a , if it is currently Raining (the previous Season P > 1), and the is less than 5%, it Floods at the beginning of the next Season.

At the beginning of a Season during a Flood, Beanstalk mints additional Beans and sells them directly in pools on the Flood Whitelist with the highest shortage of Beans at the end of the previous Season. Liquidity pools can be added to and removed from the Flood Whitelist via . Proceeds from the sale are distributed to Stalkholders at the beginning of Season in proportion to their Stalk holdings when it began to Rain. At the beginning of each Season in which it Floods, up to 0.1% of the Bean supply worth of Pods that grew from Beans Sown before it began to Rain Ripen and become Harvestable.

Name
Address

Bean
BEAN:WETH Well
BEAN:wstETH Well
BEAN:weETH Well
BEAN:WBTC Well
BEAN:USDC Well
BEAN:USDT Well
Unripe Bean
Unripe LP
here
Beanstalk governance
Pipeline
0xb1bE000644bD25996b0d9C2F7a6D6BA3954c91B0
Pipeline
Maximum Temperature Flow Chart
Section 8.12.2 of the whitepaper
Temperature
Crop Ratio
Flood
Season
Conversions
Silo
Multi Flow
Pods
Soil
Pods
Bean supply
Soil supply
Season
price
debt level
ideal equilibrium
direction
acceleration
Morning
Section 8.11 in the whitepaper
Soil
Morning
EBIP-2
Minting Whitelist
Minting Whitelist
Stalkholders
Active Fertilizer
Unfertilized Sprouts

Any token on the Deposit Whitelist*

The same token as From token

Anytime

Unripe token

Underlying token

Anytime

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

Whitelisted Well LP token

deltaB in the given Well > 0

Whitelisted Well LP token

Bean

deltaB in the given Well < 0

Convert Whitelist
Flood Whitelist
Silo
Beanstalk governance
Beanstalk governance
Section 14.4 in the whitepaper
BIP-7
BIP-21
BIP-50
Beanstalk governance
Depot
Pod Market
Tractor
Barn
Unripe Assets
Deposit Whitelist
lowering the Maximum Temperature
lowering the Crop Ratio
increasing the Bean supply
Season
Pod Rate

BIC Process

The Beanstalk Immunefi Committee, or BIC, determines the categorization and payout of bug bounties in accordance with the bug bounty program structure approved by the Beanstalk DAO.

The Immunefi Bug Bounty Program is primarily focused preventing loss of Farmers' Beanstalk assets in Beanstalk and other ecosystem smart contracts.

Immunefi Program

In summary:

  • The max bounty is 1,100,000 Beans;

  • Bugs are categorized as Critical, High or Medium severity;

  • The BIC determines whether a whitehat is entitled to a bug bounty/reward, and if so, the amount of such bounty/reward according to the defined bug bounty program structure; and

  • Immunefi serves as a mediator in cases where a whitehat disputes the BIC's determination of whether the whitehat is entitled to any bug bounty/reward, or what the appropriate bounty/reward should be within each Impact range.

Security is paramount to the success of Beanstalk. Immunefi is crypto's leading bug bounty platform that many other well-known DeFi protocols use to facilitate their bug bounty programs. This bounty program is competitive with the largest programs currently on Immunefi.

This program establishes a method for the reporting and fixing bugs in a way that minimizes the risk to Beanstalk (and other ecosystem contracts) between the report and the fix, as well as the fair and transparent compensation for the reporting of bugs. The program gives bounty hunters a clear process and structure in order to increase the likelihood they attempt to find issues with Beanstalk and its related contracts and code.

Having several members on the BIC and requiring a majority vote to execute bug bounty payments increases decentralization.

Responsibilities

The BIC has the following primary responsibilities:

  • Following the processes outlined in Response Process; and

  • Updating the Immunefi Bug Bounty Program when necessary.

The BIC may update the Immunefi Bug Bounty Program without a proposal in the following cases:

  • Adding/removing assets as in scope, particularly adding contracts that have been audited and/or have attracted large amounts of Beans/BDV;

  • Adding/removing impacts as in scope;

  • Adding/removing rules to the Out of Scope section;

  • Adding documentation and links; and

  • Updating language to improve clarity.

Any other changes to the Immunefi Bug Bounty Program require a BOP (or BIP).

Changing Members

In the event that one or more members are deemed unfit for the BIC (or a member voluntarily chooses to be removed), the BIC will rotate them out and replace them with a backup member approved by the DAO (no Snapshot proposal required).

Response Process

The following outlines the process that the BIC follows upon receipt of a bug report.

Immediate Response

After a bug report is submitted through the Immunefi Dashboard, all BIC Members are notified via email.

As mentioned in the bug bounty program, in order to be considered for the maximum potential reward, bug reports must come with a Proof of Concept (PoC).

In response to each bug report, the BIC will immediately evaluate the validity and severity of the bug, as well as the PoC if included in the bug report.

Bug Fix

For Beanstalk and Basin UI bug reports, the BIC will work with Beanstalk Farms to resolve the issue.

BIR Proposal

As soon as possible after completing the above, the BIC will prepare, but not publish, a BIR, which includes:

  • Whether the bug report qualifies for a Critical, High or Medium Impact bounty/reward;

  • What the potential practicable economic damage of the bug is (if categorized as Critical or High Impact);

  • What the appropriate bounty/reward should be within the Impact range; and

  • Whether the whitehat is entitled to a bug bounty/reward, and if so, the amount of such bounty/reward.

In instances where there are multiple bugs reported in the same report, a BIR will be prepared for each bug.

Before a BIR is proposed, its contents are confirmed with the submitter of the bug report via the Immunefi platform. As outlined in the bug bounty structure, in certain instances where the submitting party disputes the BIC’s proposal, Immunefi mediates.

If the bounty/reward is less than 50,000 Beans, the BIC may pay the bounty without formally voting on the BIR on Snapshot.

If the bounty/reward is greater than or equal to 50,000 Beans, as soon as possible after the implementation of a fix by the BCM, the BIC will:

  • Publish the BIR to Snapshot;

  • Announce the existence of the BIR to the Beanstalk community via the Discord; and

  • Vote on the BIR.

BIR Exection

Once a BIR passes, the BICM executes it by:

  • Transferring Beans in the Immunefi Vault to the submitting party’s address.

Types of Stablecoins

    • Examples: USD Coin, Tether, BinanceUSD

    • Examples: wETH, Liquity, MakerDAO, Abracadabra

    • Examples: N/A

    • Examples: Olympus

    • Examples: N/A

    • Examples: Terra

    • Examples: US Dollars

    • Examples: Beanstalk, Ampleforth

Additionally, implementations of exogenous value convertible stablecoin protocols with fractional reserves are considered:

    • Examples: Bank Notes

    • Examples: Frax

Exogenous Value Stablecoins

Non-network-native exogenous value convertible stablecoin protocols

Non-network-native exogenous value convertible stablecoin protocols issue tokens that are supposedly collateralized by, and require a custodian that facilitates the convertibility to, non-network-native exogenous value worth at least 100% of total outstanding protocol liabilities. These protocols function as low-volatility permissioned bridges between their respective networks and the rest of the world.

Users of non-network-native exogenous value convertible stablecoins sacrifice trustlessness and carry: third parties custody the non-network-native assets, can freeze the network-native assets unilaterally and can retain yield earned on collateral. The absence of protocol-native opportunities for carry limits liquidity.

Trustlessness: Permissioned

Carrying Costs: Non-competitive as compared to the asset being pegged to, but best among exogenous value convertible stablecoins

Volatility: Best among exogenous value stablecoins, but frictions around convertibility remain significant, leading to imperfect peg maintenance

Liquidity: Best among exogenous value stablecoins, but limited by opportunity cost of using off-chain collateral as capital

Network-native exogenous value convertible stablecoin protocols

Network-native exogenous value convertible stablecoin protocols use excess network-native collateral to remove most points of centralization. Overcollateralization removes most risk associated with the volatility of the collateral but by necessity requires the introduction of rent payments in order to prevent the value of the stablecoin from trending towards the value of the underlying collateral. The combination of collateral requirements and rent payments significantly limits the potential liquidity of these stablecoins.

Trustlessness: Can be totally permissionless; collateral distribution is the primary determinant of trustlessness

Carrying Costs: Non-competitive as compared to the asset being pegged to, unless at the expense of volatility

Volatility: Very low volatility when factoring in frictions around convertibility, unless in order to improve the competitivity of carrying costs

Liquidity: Limited by available network-native collateral, particularly trustless network-native collateral

Non-network-native exogenous value non-convertible stablecoin protocols

Examples: N/A

Convertibility is the main source of low price volatility and confidence in the custodian. Therefore, it is unlikely that a non-network-native exogenous value non-convertible stablecoin protocol will find product market fit.

Trustlessness: Permissioned

Carrying Costs: Non-competitive as compared to the asset being pegged to

Volatility: Speculation on the trustworthiness of the custodian of collateral will be higher due to the lack of convertibility, which should lead to more price volatility

Liquidity: Limited by opportunity cost of using off-chain collateral as capital, but less so because the custodian is unencumbered by the limited asset allocations necessary to facilitate convertibility

Network-native exogenous value non-convertible stablecoin protocols

Convertibility is the main source of low price volatility. The main benefit of collateralization is low price volatility, the majority of which is forfeited in the absence of convertibility. Therefore, it is unlikely that a network-native exogenous value non-convertible stablecoin protocol will find product market fit.

Trustlessness: Can be totally permissionless; collateral distribution is the primary determinant of trustlessness

Carrying Costs: Non-competitive as compared to the asset being pegged to, but potentially better than network-native exogenous value convertible stablecoin protocols because of the ability to take more risk with the underlying collateral at the cost of volatility

Volatility: There exists some tradeoff between carrying costs and volatility, dependent on protocol design

Liquidity: Limited by available network-native collateral, particularly trustless network-native collateral

Non-network-native exogenous value fractional reserve convertible stablecoin protocols

Examples: Bank Notes (not implemented on any decentralized networks to date)

Credit-based non-network-native exogenous value convertible stablecoin protocols most closely resemble traditional bank notes. The introduction of fractional reserves to create competitive carrying costs is a well documented historical phenomenon. The lending out of collateral creates yield that can be passed onto the users of the fractional reserve notes. However, the combination of convertibility and fractional reserves creates an asset liability duration mismatch that can lead to complete collapse. Fractional reserves are another example of currencies trading volatility for carry.

Trustlessness: Permissioned

Carrying Costs: Competitive as compared to the asset being pegged to, at the expense of tail risk in volatility

Volatility: Low volatility when factoring in frictions around convertibility; exposure to bank runs

Liquidity: Limited by available collateral

Network-native exogenous value fractional reserve convertible stablecoin protocols

The use of fractional reserves by network-native exogenous value convertible stablecoin protocols has been used in an attempt to help remediate the negative effect on carrying costs of collateral requirements. However, the network-native nature of the system makes lowering the collateralization ratio difficult without spurring a bank run. While fractional reserve implementations of network-native exogenous value convertible stablecoins offer competitive carrying costs as compared to non-fractional reserve implementations, they do so at the cost of tail risk in volatility.

Trustlessness: Can be totally permissionless; collateral distribution is the primary determinant of trustlessness

Carrying Costs: Can be competitive as compared to the asset being pegged to at lower collateralization ratios

Volatility: Low volatility when factoring in frictions around convertibility; exposure to bank runs

Liquidity: Limited by available network-native collateral, particularly trustless network-native collateral

Summary

Convertibility to exogenous value is the primary source of low price volatility, but it comes at the cost of competitive carrying costs and liquidity. In most implementations, trustlessness is sacrificed for deeper liquidity.

Businesses built on trustless primitives cannot compete with businesses built on centralized systems due to non-competitive carrying costs on low-volatility network-native trustless assets.

Endogenous Value Stablecoins

Non-network-native endogenous value convertible stablecoin protocols

Examples: N/A

It is difficult for network-native protocols to create and facilitate the conversion to non-network-native value. Therefore, it is unlikely that non-network-native endogenous value convertible stablecoin protocols find product market fit.

In theory, this would be like a private company issuing a stablecoin that is convertible to company stock at market price.

Trustlessness: Permissioned

Carrying Costs: Can be competitive as compared to the asset being pegged to, but the issuer must create more than enough endogenous value to facilitate the carry

Volatility: Likely to maintain a tight peg due to convertibility, but exposed to collapse in the instance the issuer’s endogenous value source falters, or is expected to falter

Liquidity: Limited by the endogenous value of the issuer

Network-native endogenous value convertible stablecoin protocols

To date, implementations of network-native endogenous value convertible stablecoin protocols have failed to regularly cross their stablecoin price over their value peg. This is primarily due to the fluctuation in value of endogenous value. The convertibility to endogenous value typically correlates with decreases in endogenous value, which creates excess reflexivity. It is unclear whether network-native endogenous value convertible stablecoin protocols can succeed.

Trustlessness: Permissionless

Carrying Costs: Can be competitive as compared to the asset being pegged to, but the issuer must create more than enough endogenous value to facilitate the carry

Volatility: Likely to maintain a tight peg due to convertibility, but exposed to collapse in the instance the issuer’s endogenous value source falters, or is expected to falter

Liquidity: Limited by the endogenous value of the issuer

Non-network-native endogenous value non-convertible stablecoin protocols

Examples: US Dollars

The current financial system (i.e., fiat money) can be thought of as an implementation of credit-based non-network-native endogenous value non-convertible stablecoin protocols, where the fiat money is pegged to a time-weighted discount of its current purchasing power. The non-network-native nature of the credit of the issuer introduces significant sacrifices to trustlessness.

Trustlessness: Permissioned

Carrying Costs: Very competitive

Volatility: Determined by a variety of factors; sufficiently low volatility is a prerequisite to adoption

Liquidity: Limited by the creditworthiness of the issuer

Network-native endogenous value non-convertible stablecoin protocols

The value of fiat currency is derived from its utility and the credit of its issuer. Utility of fiat currency is a function of trustlessness, carrying costs, stability and liquidity. Decentralized credit can be used to issue a permissionless fiat stablecoin with competitive carrying costs, low volatility and deep liquidity.

Credit-based network-native endogenous value non-convertible stablecoin protocols are network-native implementations of fiat currency. The value of such assets derive from the credit of its issuer, which exists in a network-native capacity. The network-native nature of the credit creates value in a trustless fashion. The creation of endogenous value through credit facilitates competitive carrying costs. A strong series of network-native incentives and diverse network of creditors can create price stability and deep liquidity without collateral requirements.

Credit-based network-native endogenous value non-convertible stablecoin protocols present an opportunity to achieve trustlessness, competitive carrying costs, low price volatility and deep liquidity. The use of network-native credit can eliminate the negative carrying costs and reduce the excess price volatility associated with rebasing stablecoin protocols.

Summary

Convertibility to endogenous value prioritizes low price volatility at the expense of long term sustainability.

Rebasing tokens have shown some efficacy and peg maintenance, but not enough to create utility. The introduction of network-native credit can reduce volatility.

The current financial system runs on credit-based non-network-native endogenous value non-convertible stablecoin protocols.

Implementations of network-native endogenous value non-convertible stablecoin protocols present a viable option for the creation of trustless currency with competitive carrying costs, low price volatility and deep liquidity that can facilitate the competition between businesses built on decentralized primitives against businesses built on centralized ones.

BCM Process

The BCM is not intended to have decision making power. Its role is to enact on-chain the decisions Stalkholders make via off-chain voting and review and verify proposals to ensure the suggested changes are truthfully represented.

USDC from Fertilizer sales were custodied by the BCM between the beginning of the Barn Raise on June 6, 2022 and Replant on August 4, 2022.

Multisig Powers

The following functions are only callable from the owner address:

  • diamondCut — Add, replace and/or remove any function(s) and/or execute an init function with a delegatecall.

  • whitelistToken — Add a token to the Deposit Whitelist.

  • dewhitelistToken — Remove a token from the Deposit Whitelist.

  • pause — Pause Beanstalk, which makes it such that the gm function cannot be successfully called.

  • unpause — Unpause Beanstalk, which allows the gm function to be successfully called at the top of the 2nd hour. The TWAP oracle and Season timer are reset as well.

  • createFundraiser — Create a Fundraiser.

  • transferOwnership — Transfer ownership of the Beanstalk contract to a new address.

  • addUnripeToken — Add an Unripe token to Beanstalk.

Snapshot Usage

The BCM is an extension of the Beanstalk DAO. As such, the role of the BCM is to (1) enact on-chain the decisions Stalkholders make via off-chain voting and (2) review and verify proposals to ensure the suggested changes are truthfully represented.

The BCM shall not execute transactions until an associated Snapshot proposal successfully passes, apart from the exceptions outlined in the table below:

BIP Proposal and Voting

Beanstalk's governance is designed to be as permissionless as possible. Any Stalkholder with 0.1% of total Stalk may propose BIPs. If a Stalkholder wishes to propose a BIP they must complete a public proposal process before the BCM will submit a Snapshot proposal and an on-chain transaction to the BCM on their behalf.

BIP Proposal Content

BIPs can propose to (1) change the Beanstalk protocol, (2) mint Beans and/or (3) change Beanstalk governance. BIPs consist of a pull request on the Beanstalk GitHub repo that includes the following:

  • A written proposal of the changes that would be implemented in the BIP, which must include:

    • A Contract Changes section that includes the facets and the init contract address in the diamondCut call, if applicable; and

    • A Beans Minted section that describes the number of Beans minted by the BIP, if applicable.

BIPs may have multiple transactions if made explicit in the written proposal.

BIP Proposal Process

The following are the processes in place for a Stalkholder to propose a BIP:

  1. Submit a pull request on the public Beanstalk GitHub repo with a written proposal of the changes that would be implemented in the BIP.

  2. Tag the @BCM Liaison user in the (#🏛・governance) channel in the Beanstalk Discord to create a dedicated discussion channel for the BIP.

  3. Share a link to the GitHub PR and the written proposal in the newly created dedicated discussion channel.

  4. Allow sufficient time for discussion of the proposal. What constitutes sufficient is at the sole discretion of the BCM.

  5. Tag the @BCM Liaison user to request that the BIP be formally proposed.

  6. The BCM shall then formally propose the BIP by submitting the on-chain transaction and Snapshot proposal.

  7. If the BIP passes, the Signers will sign m/n signatures and execute the on-chain transaction as soon as possible. If the BIP fails to pass, the Signers will submit and execute a cancel transaction with the same nonce as soon as possible.

BIP Voting

Voting for BIPs takes place on Snapshot using Stalk at the beginning of the Voting Period that still exists.

Any Stalkholder can vote For, Abstain or Against on any BIP. In all instances, 1 Stalk equals 1 vote, and not voting or voting Abstain is equivalent to voting Against.

The Voting Period opens when the Snapshot proposal for a BIP can be voted on and ends after 7 days or once a two-thirds supermajority is reached.

If at the end of the Voting Period:

  • Less than or equal to one-third of the total outstanding Stalk, plus the amount of Stalk voting Against, is voting For, it fails, or

  • More than one-third of the total outstanding Stalk, plus the amount of Stalk voting Against, is voting For, or more than half of total outstanding Stalk is voting For, it passes.

If at any time 24 hours or more after the beginning and before the end of the Voting Period more than two-thirds of the Stalk supply votes in favor of the BIP, the BCM can execute the BIP on-chain.

BOP Proposal and Voting

Any Stalkholder with 0.1% of total Stalk may propose BOPs. If a Stalkholder wishes to propose a BOP they must complete a public proposal process before the BCM will submit a Snapshot proposal on their behalf.

BOP Proposal Content

BOPs can propose for the DAO to agree on processes that do not involve (1) changing the Beanstalk protocol, (2) minting Beans or (3) changing Beanstalk governance. BOPs consist of a pull request on the Beanstalk GitHub repo that includes the following:

BOP Proposal Process

The following are the processes in place for a Stalkholder to propose a BOP:

  1. Submit a pull request on the public Beanstalk GitHub repo with a written proposal of the changes that would be implemented in the BOP.

  2. Tag the @BCM Liaison user in the (#🏛・governance) channel in the Beanstalk Discord to create a dedicated discussion channel for the BOP.

  3. Share a link to the GitHub PR and the written proposal in the dedicated discussion channel.

  4. Allow sufficient time for discussion of the proposal. What constitutes sufficient is at the sole discretion of the BCM.

  5. Tag the @BCM Liaison user to request that the BOP be formally proposed.

  6. The BCM shall then formally propose the BOP by submitting the Snapshot proposal.

BOP Voting

Voting for BOPs takes place on Snapshot using Stalk at the beginning of the Voting Period that still exists.

Any Stalkholder can vote For or Against on any BOP. The Voting Period opens when the Snapshot proposal for a BOP can be voted on and closes after 7 days.

If at the end of the Voting Period:

  • Less than or equal to 25% of the total outstanding Stalk, plus the amount of Stalk voting Against, is voting For, it fails, or

  • More than 25% of the total outstanding Stalk, plus the amount of Stalk voting Against, is voting For, or more than half of total outstanding Stalk is voting For, it passes.

BIR Proposal and Voting

BIR Proposal Content

BIRs can propose to mint Beans to reward valid bug reports on Immunefi. BIRs consist of a Snapshot proposal that includes information about the bug report and has a Beans Minted section that describes the number of Beans minted to both the whitehat and Immunefi.

BIR Proposal Process

BIR Voting

The following are the processes in place for the BIC to propose and have the BCM execute a BIR:

  1. The BIC shares BIR info with the BCM for them to submit a corresponding on-chain transaction.

  2. The BCM shall then formally propose the BIR by submitting the on-chain transaction.

  3. If the BIR passes (two-thirds majority of BIC members voting For), the Signers will sign m/n signatures and execute the on-chain transaction as soon as possible. If the BIR fails to pass, the Signers will submit and execute a cancel transaction with the same nonce as soon as possible.

Signer Best Practices

BCM Signers shall follow the best practices outlined below. It is of paramount importance that Beanstalk limits key man risk by implementing best practices with respect to multisig key custody. Signers are expected to:

  1. Regularly check in with the rest of the BCM and confirm access to their wallet;

  2. Maintain active communication regarding travel plans and availability in order to ensure that there are always enough Signers on call; and

  3. Acknowledge their Signer duties and processes for signing off on BIPs and BIRs.

In addition to the above expectations, Signers shall follow the BCM's wallet security best practices:

  1. Use a reputable hardware wallet like Trezor or Ledger;

  2. Use a fresh address that doesn't have any pre-existing transactions or balances on it;

  3. Set up a new passphrase on their hardware wallet device when selecting a new address to be the signing address; and

Signer Duties

Signers are expected to follow best practices and maintain active communication in order to ensure that there are always enough Signers available to execute transactions in case of an emergency. Signer duties are broken down into three stages: (1) confirming access to their wallet, (2) verifying proposed transactions and (3) executing transactions on the BCM.

As soon as possible after the Voting Period:

  • If the proposal passed, Signers who have verified the transaction will sign and execute the transaction; or

  • If the proposal failed, Signers with sign and execute a cancel transaction with the same nonce.

A Signer shall lose their role on the BCM (by the remaining Signers removing them) if they:

  • Act against Stalkholders' off-chain voting (or the BIC's off-chain voting in the case of BIRs);

  • Get through 2 votes without performing any of their Signer duties.

Verifying and Signing Transactions

All BCM Signers are expected to know how to verify diamondCut data and confirm they have verified transactions by creating an Etherscan verified message.

The following should be used as a guide for the minimum review criteria in cases where a diamondCut is being executed:

  • Performing the diamondCut on a local mainnet fork and confirm that the facet addresses, function selectors and facet cut actions are correct;

  • Confirming that the _init address and _calldata are correct; and

  • Confirming that the deployed bytecode for changed facets matches the corresponding bytecode compiled from the GitHub PR branch.

If a situation arises where not all Signers submit a verification, the BCM may continue with execution if the Signer:

  1. Was not responsive during the draft phase of the proposal or Voting Period;

  2. Notified the rest of the BCM during the draft phase of the proposal that they would not be able to verify, sign or execute the transaction;

  3. Missed 2 verifications;

  4. Was not responsive in 2 months; or

  5. Votes against the outcome of any proposal, in which case the Signer would be subject to removal immediately.

Problems During Verification

The BCM will not execute a transaction that was misrepresented in the Snapshot proposal.

In the case that any Signer during the verification process determines that a Snapshot proposal does not accurately represent the transaction, that Signer will sign an Etherscan verified message indicating as such with context on the issue.

The BCM will respond as follows:

  • If the BCM determines that the Signer is "rogue" and attempting to censor the transaction, the BCM will indicate that by continuing to verify (and ultimately sign and execute, in the case that the proposal passes) the transaction; or

  • If the BCM determines that the Signer is not rogue, the BCM will indicate that by submitting, signing and executing a cancel transaction with the same nonce.

In cases where the BCM cancels a transaction, the community will be notified via the Beanstalk Discord and the BCM will work with the proposer to resolve the issue. Once resolved, a new BIP will be proposed on Snapshot with its associated transaction.

Emergency Response Procedures

Although the BCM's role is to enact on-chain the decisions Stalkholders make via off-chain voting, it is of critical importance that the BCM take swift action to protect Beanstalk in the event of a bug or vulnerability. Emergency upgrades to Beanstalk submitted by the BCM are known as EBIPs.

Bugs or security vulnerabilities qualify as emergencies. Emergency action will not be taken for any reason related to the economic health of Beanstalk.

Depending on the severity of a given emergency, BCM members shall swiftly decide the best course of action:

  • If a bug or vulnerability is severe and requires significant code changes to fix, the BCM may remove functions from Beanstalk and take any necessary extra action to mitigate further damage; or

  • If a bug or vulnerability is minor and does not require significant code changes to fix, a hotfix may be implemented by the BCM.

After emergency action is taken, the BCM shall swiftly issue a summarized report to the community via the Beanstalk Discord detailing:

  1. The administrative permissions that were used (e.g., which functions were removed);

  2. The context and severity of the issue; and

  3. The next steps and decisions, if any, that the community must agree on in order to proceed.

EBIP During Voting Period

In the event that an EBIP must be executed during the Voting Period of another proposal, the on-chain transaction for the outstanding proposal must be canceled.

In order avoid the need to revote on a proposal in this situation, the BCM will repropose the on-chain transaction for the outstanding proposal after the successful execution of the EBIP.

Hypernative

The BCM continues to be the owner of and the sole address capable of adding and updating functions on Beanstalk. Instances where Hypernative removes all non-diamond functions will be considered EBIPs, i.e., they will be documented as such and follow the DAO-approved procedures outlined above.

Rotating Signers

Anonymous Signers

The most significant risk associated with off-chain governance is the potential corruption of the BCM from an outside party. In order to minimize the chances of this, the Signers are anonymous. The anonymous Signers are selected by Publius. Signers will be anonymous to each other as well, apart from Publius.

In no instance shall a majority of the BCM keys be held by Beanstalk Farms contributors. Publius will collectively hold at most 1 key. The remaining keys will be held by reputable members of the Beanstalk community.

Malicious Key Holder Risk

Under this structure, it’s important to acknowledge the risk of anonymous key holders conspiring to attack Beanstalk. Because only Publius knows the identities of the anonymous Signers, Publius would be the main attack vector. If a malicious actor were to compromise Publius before conspiring to attack Beanstalk, they could be reasonably sure that their identity would never be revealed.

In order to mitigate this attack vector, the BCM institutes the following process whenever the m-of-n configuration of the BCM is changed:

  • Publius will share the list of Signers and their wallets with their personal legal counsel, to be released in the event that Publius is compromised such that they cannot publicly share the list themselves. This makes Publius and their personal legal counsel the only parties with access to the list.

In the event that Publius' counsel publicly shares the list of Signers and their wallets, anyone could verify that it's the correct list by hashing it and comparing it with the hash on Etherscan. This creates accountability for the anonymous Signers.

Beanstalk Farms

Beanstalk Farms is a decentralized development organization of core contributors working on Beanstalk, operating across the stack on technical and non-technical problems.

Funding

Past BIPs that funded Beanstalk Farms:

Beanstalk Farms Committee

The Beanstalk Farms Committee (BFC) is the group of Beanstalk Farms contributors that has discretion over the Beanstalk Farms budget, including contributor compensation. The BFC hires at and dismisses contributors from Beanstalk Farms.

Beanstalk Farms Committee Proposals, or BFCPs, are proposals related to personnel on the BFC. The Beanstalk DAO governs the BFC. The Beanstalk DAO adds contributors to the BFC via BFCP-As, removes contributors from the BFC via BFCP-Bs, and renews the terms of existing BFC members via BFCP-Cs.

Any Stalkholder with 0.1% of the Stalk supply can propose a BFCP-A or BFCP-B. There is no maximum number of BFC members, which facilitates permissionlessness.

Beanstalk Farms Budget Proposals, or BFBPs, are proposals related to the use of the Beanstalk Farms budget. Only BFC members can propose and vote on BFBPs.

The BFC hires contributors via BFBP-As, dismisses contributors via BFBP-Bs, and otherwise uses the Beanstalk Farms budget via BFBP-Cs.

BICM Dashboard

The Beanstalk Immunefi Committee (BIC) has the exclusive ability to determine the categorization and payout of bug bounties in accordance with the bug bounty program structure approved by the DAO. BIC members serve as signers on the BICM. The BICM is deployed using Safe. Its m-of-n configuration is currently 4-of-7 on Arbitrum.

BICM Signers

The current BICM signers are as follows, in no particular order:

  • aloceros

  • Brean

  • Chaikitty

  • deadmanwalking

  • funderberker

  • mod323

  • pizzaman1337

The following Farmers serve as backups for the BICM, in no particular order:

  • uncoolzero

  • MrMochi

  • guy

Rotating members (to a backup member listed here) on the BIC requires a majority vote of the BIC, for which a Snapshot proposal is not necessary.

Beans Paid

Total to Whitehats: 1,536,350 Beans

Remaining in Immunefi Vault: 2,447,000 Beans

Bugs found: 21

Links

Minting Whitelist

BEAN:WETH Well

BEAN:wstETH Well

BEAN:weETH Well

BEAN:WBTC Well

BEAN:USDC Well

BEAN:USDT Well

This document can be found on Arweave .

You can read more about the current BIC Members and data on past Beans minted for bounties on the in the Farmers' Almanac. All Immunefi bug reports and their responses are logged .

You can read the full program and submit bug reports on the page. The latest version of the program approved by the DAO can be found on Arweave .

The BIC structure of community-known members (see ) and public Snapshot proposals (see ) allows the Beanstalk community to scrutinize decisions, while still allowing the BIC to move swiftly in response to bug reports. The BIC consists of technical members of the Beanstalk community due to the nature of the BIC. The BIC can keep the bug information private while the bug is unfixed, and then has a clear process to disclose the bug to the public and compensate the whitehat.

If it is determined that the bug report is invalid, the BIC will close the report on the Immunefi Dashboard. BIC responses to all bug reports are logged .

If it is determined that the bug report is valid, the BIC will work with the corresponding party (the , etc.) to resolve the issue as soon as possible via an emergency upgrade. The fix will be forwarded to an auditor for review, if applicable.

BIR voting takes place on the and lasts for 3 days. Only BIC members propose and vote on BIRs, and each member has one vote. BIC members can either vote For or Against a BIR, and a majority of the BIC voting For is required to pass.

Transferring Beans from the BICM to the , if necessary and to the extent that Beans remain available in the BICM; and

The three axes in (value source, convertibility and network nativity) present a classification of 8 potential stablecoin types, some of which currently lack successful implementations:

Examples: , ,

Examples: , , ,

is an ideal simple iteration of this type of stablecoin protocol, without any points of centralization and with protocol-native positive carry (via ). In order to remove rent payments, Liquity does not target an exact price for its stablecoin, LUSD. The potential supply of LUSD is limited by the value of trustless network-native value.

Examples: (convertible under certain market conditions)

Examples:

Despite the shortcomings of exogenous value convertible stablecoin implementations, demand for their USD implementations continues to increase rapidly. Over the twelve months prior to the initial deployment of Beanstalk, the total market capitalization of exogenous value convertible USD stablecoins .

However, despite this rapid increase in supply, the have historically been higher than . Non-competitive carrying costs are structural due to the opportunity costs associated with requirements of exogenous value collateral. Attempts to improve carrying costs through the introduction of fractional reserves have failed to do so.

Examples:

Examples: ,

Rebasing stablecoin protocols (e.g., have shown efficacy at crossing stablecoin prices over their value pegs, but without the regularity, low volatility or liquidity necessary to create utility. Extreme negative carrying costs during decreases in demand exacerbate difficulty of use.

This document can be found on Arweave .

The Beanstalk Community Multisig, or BCM, custodies ownership of the . The BCM has the exclusive and unilateral ability upgrade Beanstalk. In the future, it is expected that BIPs remove governance entirely, revoking these abilities from the BCM.

The BCM is deployed using , the most battle-tested multisig contract on Arbitrum. Its m-of-n configuration is 5-of-9. Parameters m and n are each ultimately defined by Stalkholders and may evolve in the future via Beanstalk Improvement Proposal (BIP).

BCM Signers are an and diverse set of reputable community members and Beanstalk core contributors.

Beanstalk implements the , a standard for fully-upgradeable smart contracts.

The mechanism for upgrading a Diamond is by calling , which takes arguments of functions to replace and which functions to replace them with. The diamondCut function is only callable by the owner of Beanstalk, which is the BCM.

Upgrades should only be executed after a proposal has passed and Signers have manually reviewed the transaction. However, in the case of an emergency (like a bug or vulnerability), the BCM may execute an Emergency BIP (EBIP) to protect the Beanstalk contract. The best practices for emergency response handling are outlined in the section.

If a Stalkholder wants to propose a BIP, they can create a pull request to the and begin a formal proposal process outlined in the section.

The BCM also executes the will of the as determined by Beanstalk Immunefi Responses (BIRs). See .

BIPs are voted on at the .

Transaction
Snapshot?
Voting Period

Past BIPs can be found .

Code implementing the proposed changes (or simply a change to the file if there are no associated code changes);

A Proposer section that includes an (or an Arweave upload if the proposing wallet is a multisig) confirming the proposer of the BIP;

Before the BCM formally proposes the BIP, they shall verify that the written proposal contains all the necessary content per .

During the Voting Period (1-7 days), every BCM Signer shall verify the transaction per . If not all Signers verify the transaction, the BCM may still continue per the process outlined in .

Past BOPs can be found .

Updates to the file;

A written proposal of the changes that would be implemented in the BOP, which must include a Proposer section that has an (or an Arweave upload if the proposing wallet is a multisig) confirming the proposer of the BOP.

Before the BCM formally proposes the BOP, they shall verify that the written proposal contains all the necessary content per .

The BIC determines the categorization and payout of bug bounties in accordance with the approved by the Beanstalk DAO. The BCM executes the will of the BIC as determined by BIRs.

Any BIC member may propose BIRs. Past BIRs can be found .

See .

The BIC shall then formally propose the BIR on the .

During the 3 day Voting Period, every BCM Signer shall verify the transaction per . If not all Signers verify the transaction, the BCM may still continue per the process outlined in .

Follow the standard self-custody best practice guide .

Once the Voting Period for a proposal begins on Snapshot, all Signers are expected to promptly review and verify that the proposed transaction accurately reflects the Snapshot proposal per . This limits blind signing and encourages each Signer to independently verify that a proposed transaction is accurately represented. Anyone can verify that a Signer verified a proposed transaction during the Voting Period.

Do not follow best practices outlined in the section; or

Once Signers have verified the transaction, they shall sign a message indicating that they have verified the transaction by creating an . This process must be completed for each transaction in a BIP or BIR. See the page for more information on how BCM Signers verify transactions.

Past EBIPs can be found .

In cases where functions must be removed immediately to protect Beanstalk, BCM Signers are not required to submit an Etherscan verified message as outlined in .

actively detects and responds to high confidence pre-exploit and exploit-in-progress detections on Beanstalk. Hypernative custodies that has the ability to call functions on added to the BCM. This module has the ability to remove all functions from Beanstalk except for diamondCut, facetAddress, facetAddresses, facetFunctionSelectors and facets. Removing all other functions protects the protocol in the event of an attack.

In the event that one or more Signers are compromised, vote against the outcome of any proposal, voluntarily choose to be removed from the BCM, or are otherwise removed in accordance with , the BCM will rotate them out of the multisig and replace them with another Signer. In no instance shall a majority of the BCM keys be held by Beanstalk Farms contributors, nor shall more than 1 key be held by Publius.

Off-chain governance introduces significant risks related to security and censorship. The BCM is designed to mitigate as many of those risks as possible by distributing the multisig keys across reputable community members and Beanstalk core contributors, and collectively adhering to .

Publius will publish a hash of the list of Signers and their corresponding wallets on Etherscan (you can find these under the Signer Hashes section of the ); and

The Beanstalk DAO is responsible for the formation of two independent, symbiotic organizations with distinct mandates: Beanstalk Farms and (a Beanstalk accelerator program).

Neither Beanstalk Farms nor Beanstalk have a treasury. Beanstalk Farms has historically been funded by the Beanstalk DAO. Beanstalk Farms proposes budget BIPs that mint Beans to cover operating expenses and compensate contributors. Budget funds are custodied by the . Larger payments in non-Bean assets like audits have historically been paid for via .

(included Beanstalk Farms and Bean Sprout)

Monthly reports on how Beanstalk Farms is spending its budget can be found .

See for more info on each BFCP proposal type. BFCPs are proposed on the . Stalkholders can vote on BFCPs on the . Past BFCPs can be read .

See for more info on each BFBP proposal type. BFBPs are proposed on the , which is where BFC members vote. Past BFBPs can be read .

See for more information.

Beanstalk Community Multisig Safe address:

Address

Total to Immunefi: 138,335 Beans (excluding the annual Immunefi subscription fee beginning after )

Response
Beans to Whitehat
Beans to Immunefi
Transaction

0xBeA00Aa8130aCaD047E137ec68693C005f8736Ce
0xBEa00BbE8b5da39a3F57824a1a13Ec2a8848D74F
0xBeA00Cc9F93E9a8aC0DFdfF2D64Ba38eb9C2e48c
0xBea00DDe4b34ACDcB1a30442bD2B39CA8Be1b09c
0xBea00ee04D8289aEd04f92EA122a96dC76A91bd7
0xbEA00fF437ca7E8354B174339643B4d1814bED33
here
BICM Dashboard
here
Immunefi Bug Bounty Program
here
BICM Dashboard
Beanstalk Bug Bounty Snapshot space
here
BCM
Beanstalk Bug Bounty Snapshot space
Immunefi Vault
USD Coin
Tether
BinanceUSD
wETH
Liquity
MakerDAO
Abracadabra
Liquity
the Stability Pool
Olympus
Frax
increased more than 500% to over $100 billion
borrowing rates on exogenous value convertible USD stablecoins
borrowing rates on USD
Terra
Beanstalk
Ampleforth
Ampleforth)
Non-network-native exogenous value convertible stablecoin protocols
Network-native exogenous value convertible stablecoin protocols
Non-network-native exogenous value non-convertible stablecoin protocols
Network-native exogenous value non-convertible stablecoin protocols
Non-network-native endogenous value convertible stablecoin protocols
Network-native endogenous value convertible stablecoin protocols
Non-network-native endogenous value non-convertible stablecoin protocols
Network-native endogenous value non-convertible stablecoin protocols
Non-network-native exogenous value fractional reserve convertible stablecoin protocols
Network-native exogenous value fractional reserve convertible stablecoin protocols

Executing BIP

Yes, requires a passed BIP

Up to 7 days as outlined in BIP Voting

Non-emergency change to the m-of-n BCM configuration

Yes, requires a passed BIP

Up to 7 days as outlined in BIP Voting

Executing BIR

Yes, requires a passed BIR

3 days

Executing EBIP (emergency hotfix, etc.)

No, but requires public notification via Discord

N/A

Rotating BCM Signers

No

N/A

Emergency change to the m-of-n BCM configuration to remove rogue Signers

No

N/A

Cancel transaction

No

N/A

BCM Multisig Powers Documentation
Anonymous Multisig Signers Documentation
Emergency Response Procedures Documentation
Emergency Response Procedures
BIP Proposal Content
Verifying and Signing Transactions
Rotating Signers
BOP Proposal Content
Verifying and Signing Transactions
Rotating Signers
Verifying and Signing Transactions
Signer Best Practices
Verifying and Signing Transactions
Signer Duties
Signer Best Practices
LogoSafe{Wallet}safe
here
Beanstalk contract
Safe
EIP-2535 Diamond Standard
diamondCut
BIP Proposal Process
Beanstalk GitHub repo
BIR Proposal and Voting
Beanstalk Immunefi Committee (BIC)
Beanstalk DAO Snapshot space
here
PROPOSALS.md
Etherscan verified message
here
PROPOSALS.md
Etherscan verified message
Immunefi Bug Bounty Program
here
BIC Process
Beanstalk Bug Bounty Snapshot space
here
Etherscan verified message
BCM Verification
here
Hypernative
an EOA
the Hypernative module
BCM Dashboard
Bean Sprout
Beanstalk Farms Multisig (BFM)
Fundraiser
BIP-1: Beanstalk Farms Q4 2021 Dev and Marketing Budget
BIP-8: Beanstalk Q1 2022 Budget
BIP-14: Beanstalk Farms Q2 2022 Budget
BIP-22: Beanstalk Farms Q3 2022 Budget
BIP-25: Beanstalk Farms Q4 2022 Budget
BIP-33: Beanstalk Farms H1 2023 Budget
BIP-40: Beanstalk Farms 2024 Development Budget
here
Beanstalk Farms Committee Proposal
Beanstalk Farms Snapshot page
Beanstalk UI Governance page
here
Beanstalk Farms Budget Proposal
Beanstalk Farms Budget Snapshot page
here
BIC Process
0x390b023d316c2e92dd96A9bcC7fAe8dB12A2fBC1
BIP-41
Past BIRs
Bug Reports
anonymous
Multisig Powers
Snapshot Usage
BIP Proposal and Voting
BOP Proposal and Voting
BIR Proposal and Voting
Signer Best Practices
Signer Duties
Verifying and Signing Transactions
Emergency Response Procedures
Rotating Signers
Anonymous Signers

7,500

750

11,000

1,100

181,850

18,185

10,000

1,000

100,000

-

10,000

1,000

1,100,000

110,000

1,000

100

1,000

100

1,000

100

50,000

5,000

10,000

1,000

10,000

-

1,000

-

10,000

-

10,000

-

10,000

-

3,000

-

3,000

-

5,000

-

1,000

-

Beanstalk

A robust decentralized governance mechanism must balance the principles of decentralization with resistance to attempted protocol changes, both malicious and ignorant, and the ability to quickly adapt to changing information. In practice, Beanstalk must balance ensuring sufficient time for all ecosystem participants to consider a Beanstalk Improvement Proposal (BIP) with the ability to be quickly upgraded in cases of emergency.

Participation

Anyone can become a Stalkholder and participate in Beanstalk governance by Depositing whitelisted assets in the Silo to earn Stalk.

A Stalkholder’s voting power is proportional to their Stalk balance relative to the total Stalk supply. Any Stalkholder can vote For or Against on any BIP. A Stalkholder's vote for a given proposal is counted as their Stalk at the beginning of the Voting Period that still exists. Stalkholders have the ability to delegate their vote to any other user.

Any Stalkholder that owns more than 0.1% of total outstanding Stalk can submit a BIP per the BIP Proposal Process. The submitter of a BIP must still own more than 0.1% of Stalk at the end of the Voting Period for the BIP to be able to pass.

Voting Period

The Voting Period opens when the Snapshot proposal for a BIP can be voted on and ends 7 days later or when it is committed with a supermajority.

If at the end of the Voting Period:

  • Less than or equal to one-third of the total outstanding Stalk, plus the amount of Stalk voting Against, is voting For, it fails, or

  • More than one-third of the total outstanding Stalk, plus the amount of Stalk voting Against, is voting For, or more than half of total outstanding Stalk is voting For, it passes.

If at any time 24 hours or more after the beginning and before the end of the Voting Period more than two-thirds of the total outstanding Stalk is voting in favor of the BIP, the BCM can execute the BIP on-chain.

Beanstalk governance is designed to move slow and steady. When trying to become an issuer of money, the potential for rapid monetary policy changes is unattractive. By requiring more than one-third of Stalk to vote in favor of a BIP for it to pass, it is quite difficult for a BIP to pass. Therefore, unless the proposed change is significantly preferred by Stalkholders, it is unlikely to pass.

Pause

When Paused, Beanstalk does not accept a gm function call. Once Unpaused, the gm function can be called at the beginning of the next hour.

Commit

BDM Dashboard

BeaNFT contracts are custodied by the BeaNFT DAO Multisig, or BDM. The BDM is deployed using Safe. Its m-of-n configuration is currently 4-of-7 on Ethereum mainnet. This means any upgrade of the BeaNFT contracts must be approved by at least 4 of the 7 signers.

BDM Signers

The current BDM signers are as follows, in no particular order:

  • blc

  • Brean

  • Safisynai

  • guy

  • Rex

  • pizzaman1337

  • MrMochi

The following people serve as backup signers for the BDM, in no particular order:

  • Silo Chad

  • Sowphocles

  • CanadianBennett

Address

Proposals

This page is a comprehensive overview of all proposals types in Beanstalk-related governance.

Table of Contents

Notes

In all proposals where Stalkholders vote:

  • A Stalkholder's vote for a given proposal is counted as their Stalk at the beginning of the Voting Period that still exists;

  • 1 Stalk equals 1 vote; and

  • The proposer must have at least 0.1% of total Stalk at the beginning and end of the Voting Period (including delegated Stalk) in order for the proposal to pass.

Any proposal that proposes for another party to perform work upon, or at any point after, the passage of the proposal must have that party's explicit approval.

Beanstalk Improvement Proposal

Beanstalk Improvement Proposals, or BIPs, are proposals to:

  • Change the Beanstalk protocol;

  • Mint Beans; and/or

  • Change Beanstalk governance.

Any Stalkholder that owns at least 0.1% of total Stalk can propose a BIP. Any Stalkholder can vote For or Against a BIP.

The Voting Period opens when the Snapshot proposal for a BIP can be voted on and closes after 7 days or when it is committed with a supermajority.

If at the end of the Voting Period:

  • Less than or equal to one-third of the total outstanding Stalk, plus the amount of Stalk voting Against, is voting For, it fails, or

  • More than one-third of the total outstanding Stalk, plus the amount of Stalk voting Against, is voting For, or more than half of total outstanding Stalk is voting For, it passes.

Beanstalk Operations Proposal

Beanstalk Operations Proposals, or BOPs, are proposals for the DAO to agree on processes that do not involve (1) changing the Beanstalk protocol, (2) minting Beans or (3) changing Beanstalk governance. A BIP can include any changes that would otherwise be in a BOP.

Any Stalkholder that owns at least 0.1% of total Stalk can propose a BOP. Any Stalkholder can vote For or Against.

The Voting Period opens when the Snapshot proposal for a BOP can be voted on and closes after 7 days.

If at the end of the Voting Period:

  • Less than or equal to 25% of the total outstanding Stalk, plus the amount of Stalk voting Against, is voting For, it fails, or

  • More than 25% of the total outstanding Stalk, plus the amount of Stalk voting Against, is voting For, or more than half of total outstanding Stalk is voting For, it passes.

Emergency Beanstalk Improvement Proposal

Emergency Beanstalk Improvement Proposals, or EBIPs, are emergency upgrades to Beanstalk. EBIPs are submitted and executed by the BCM in order to protect Beanstalk.

Beanstalk Farms Committee Proposal

Stalkholders vote to:

The Voting Period opens when the Snapshot proposal for a BFCP can be voted on and closes after 7 days.

BFCP-A

BFCP-As are proposals to add someone to the BFC. Any Stalkholder that owns at least 0.1% of total Stalk can propose a BFCP-A. Any Stalkholder can vote For or Against.

If at the end of the Voting Period:

  • Less than or equal to 25% of total Stalk is voting For or the majority of participating Stalk is voting Against the BFCP-A, it fails, or

  • More than 25% of total Stalk is voting For and the majority of participating Stalk is voting For the BFCP-A, it passes.

The term of a BFC member whose BFCP-A passes ends two quarters after the end of the current quarter (end of March, June, September or December). There is no guarantee that payment terms in a BFCP-A can be fulfilled until the end of a BFC member's term given that the Beanstalk DAO must continually choose to fund Beanstalk Farms.

A BFCP-A is also the proposed BFC member's hiring proposal. Therefore, a BFCP-A must contain payment information at minimum, but should also contain information about what makes the person a good candidate for the BFC, their proposed responsibilities within Beanstalk Farms, etc.

BFCP-B

BFCP-Bs are proposals to remove someone from the BFC. Any Stalkholder that owns at least 0.1% of total Stalk can propose a BFCP-B. Any Stalkholder can vote For or Against.

If at the end of the Voting Period:

  • Less than or equal to 35% of total Stalk is voting For or the majority of participating Stalk is voting Against the BFCP-B, it fails, or

  • More than 35% of total Stalk votes For and the majority of participating Stalk is voting For the BFCP-B, it passes.

A BFCP-B is not required if the BFC member voluntarily leaves Beanstalk Farms or the BFC.

BFCP-C

BFCP-Cs are proposals to extend the terms of current BFC members. Only BFC members can propose a BFCP-C.

BFCP-Cs are multi-choice votes where each voting choice corresponds to extending the term of a current BFC member (approval voting style).

If at the end of the Voting Period:

  • Less than or equal to 25% of total Stalk is voting For a BFC member's proposal, that BFC member's proposal fails, or

  • More than 25% of total Stalk is voting For a BFC member's proposal, that BFC member's proposal passes.

BFC members whose BFCP-C passes shall have their term extended by two quarters after the end of their current term, with a maximum term length of three quarters after the end of the current quarter. There is no term limit for BFC members.

BFC members have the option to update their previous hiring proposal terms in a BFCP-C. There is no guarantee that payment terms in a BFCP-C can be fulfilled until the end of a BFC member's term given that the Beanstalk DAO must continually choose to fund Beanstalk Farms.

Beanstalk Farms Budget Proposal

Only BFC members can propose and vote on BFBPs and each member has 1 vote. Any BFC member can vote For or Against.

BFC members vote to:

The Voting Period opens when the Snapshot proposal for a BFBP can be voted on and closes after 2 days.

BFBP-A

BFBP-As are proposals to hire a contributor to Beanstalk Farms.

A BFBP-A passes if at the end of the Voting Period there are at least 3 votes For, but this can be vetoed by a majority of the BFC voting Against.

Once hired via BFBP-A, a contributor's term length is indefinite unless otherwise specified. There is no guarantee that payment terms in a BFBP-A can be fulfilled indefinitely given that the Beanstalk DAO must continually choose to fund Beanstalk Farms.

Current (non-BFC) contributors only require another BFBP-A if their pay rate has increased or role/commitment has significantly changed since the terms of the proposal in effect.

BFBP-B

BFBP-Bs are proposals to dismiss a contributor from Beanstalk Farms.

If at the end of the Voting Period:

  • Less than a majority of the BFC is voting For the BFBP-B, it fails, or

  • At least a majority of the BFC is voting For the BFBP-B, it passes.

A BFBP-B is not required in circumstances where a contributor is leaving Beanstalk Farms voluntarily or gracefully.

BFBP-Bs shall not mention the contributor's name, but instead shall include a hash, where the input of the hash indicates the contributor being dismissed. The input of the hash shall only be shared with the BFC and the contributor in question. This allows the contributor to verify the result of the vote while preserving their privacy during the Voting Period and if the vote fails.

BFBP-C

BFBP-Cs are proposals to use the Beanstalk Farms budget outside of hiring contributors.

A BFBP-C passes if at the end of the Voting Period there are at least 3 votes For, but this can be vetoed by a majority of the BFC voting Against.

A BFBP-C is not required for payments valued at less than or equal to 25,000 Beans or USDC.

Beanstalk Immunefi Response

The Voting Period opens when the Snapshot proposal for a BIR can be voted on and closes after 3 days.

If at the end of the Voting Period:

  • Less than a two-thirds majority of the BIC is voting For the BIR, it fails, or

  • At least a two-thirds majority of the BIC is voting For the BIR, it passes.

BeaNFT Proposal

BeaNFT Proposals, or BNPs, are proposals through which the BeaNFT DAO votes on the direction of BeaNFTs (new collections, collection upgrades, etc.).

Anyone with 0.1% of the BeaNFT supply can propose a BNP. BNPs are voted on by BeaNFT holders and have two voting choices: For and Against. The Voting Period for BNPs is 7 days.

If at the end of the Voting Period:

  • Less than or equal to 15% of the BeaNFT supply is voting For or the majority of participating BeaNFTs is voting Against the BNP, it fails, or

  • More than 15% of the BeaNFT supply is voting For and the majority of participating BeaNFTs is voting For the BNP, it passes.

A BNP to create a new BeaNFT collection should include, at a minimum: (1) criteria to qualify for a BeaNFT in the new collection and (2) any rarity boost criteria. Including high level information about the theme of the collection, whether qualifying Farmers will be required to mint them, etc. is recommended. After the passage of the BNP, it is on the proposer to see through the completion of the art, the creation and deployment of the contracts, etc. Due to this, there is no guarantee that a new collection gets created after the passage of this type of BNP.

A BNP seeking to upgrade an existing BeaNFT collection should outline (1) the proposed upgrade, (2) the rationale for the upgrade and (3) any technical criteria required to be implement the upgrade.

BeaNFTs

You can read more about them here:

OpenSea:

Governance

BeaNFT Proposals, or BNPs, are proposals through which the BeaNFT DAO votes on the direction of BeaNFTs (new collections, collection upgrades, etc.).

Anyone with 0.1% of the BeaNFT supply can propose a BNP. BNPs are voted on by BeaNFT holders and have two voting choices: For and Against. The Voting Period for BNPs is 7 days.

If at the end of the Voting Period:

  • Less than or equal to 15% of the BeaNFT supply is voting For or the majority of participating BeaNFTs is voting Against the BNP, it fails, or

  • More than 15% of the BeaNFT supply is voting For and the majority of participating BeaNFTs is voting For the BNP, it passes.

A BNP to create a new BeaNFT collection should include, at a minimum: (1) criteria to qualify for a BeaNFT in the new collection and (2) any rarity boost criteria. Including high level information about the theme of the collection, whether qualifying Farmers will be required to mint them, etc. is recommended. After the passage of the BNP, it is on the proposer to see through the completion of the art, the creation and deployment of the contracts, etc. Due to this, there is no guarantee that a new collection gets created after the passage of this type of BNP.

A BNP seeking to upgrade an existing BeaNFT collection should outline (1) the proposed upgrade, (2) the rationale for the upgrade and (3) any technical criteria required to be implement the upgrade.

Understand the Bean Price

Selecting the Bean price displays more detail of the liquidity pools that Beans trade in.

The detail view shows the:

  • USD denominated price of Bean in the liquidity pool;

  • USD denominated total liquidity in the liquidity pool, including non-Bean assets; and

Connect to Beanstalk

In addition to an internet connection, interacting with Beanstalk requires:

  1. A supported Arbitrum wallet with an ETH balance.

  2. Connecting your Arbitrum wallet to Beanstalk.

Selecting and Funding a Wallet

Arbitrum wallets are applications that let you manage your Arbitrum account. Your wallet lets you connect to decentralized applications such as Beanstalk and authorize transactions. On Arbitrum, you are responsible for the security of your own funds. If you are new to decentralized finance, it strongly recommend to research best practices in wallet security before proceeding.

Some wallets allow purchasing ETH directly within the wallet. Alternatively, send ETH from a cryptocurrency exchange to your wallet address. Make sure both sending and receiving addresses are on the Arbitrum network.

Connect to Beanstalk with MetaMask - Desktop

1. Create a MetaMask Wallet

MetaMask is an Arbitrum wallet that facilitates interaction with the Beanstalk website.

  1. Select "Install MetaMask For [your browser]".

  2. Select "Add to [your browser]".

  3. Select "Add Extension".

  4. Select "Get Started".

  5. Follow the instructions to set up your MetaMask wallet. Be sure to save your Secret Recovery Phrase somewhere safe! For better security, use a hardware wallet.

  6. In the top right of your browser, click the "Puzzle Piece" icon and then click the "Pin" next to the MetaMask icon to pin MetaMask to your browser toolbar. The MetaMask icon should now appear next to the puzzle piece icon.

2. Optional: Connect Your Hardware Wallet to MetaMask

  1. Select the MetaMask icon and then click the circle to the right of your MetaMask address.

  2. Select "Connect Hardware Wallet".

  3. Select your hardware wallet.

  4. Select "Connect."

  5. Connect and unlock your hardware wallet.

  6. Select the wallet address(es) you want to pair with MetaMask.

  7. Select "Unlock".

3. Fund Your MetaMask Wallet with ETH

This step may be unnecessary if you performed Step 2.

  1. Copy your MetaMask Arbitrum wallet address.

  2. Send your ETH to your MetaMask wallet address from your current ETH wallet or an exchange.

4. Connect Your MetaMask Wallet to Beanstalk

  1. Select "Connect Wallet" in the top right of the page.

  2. Click the MetaMask icon and confirm that you are on the Arbitrum network. If not, click the down arrow at the top of the window and click "Arbitrum".

  3. Congratulations, you are now connected to Beanstalk. Double check that your wallet address in the top right of the website is the same as your MetaMask wallet address.

Connect to Beanstalk with MetaMask - Mobile

  1. Follow the instructions to set up your MetaMask wallet. Be sure to save your Secret Recovery Phrase somewhere safe! For better security, use a hardware wallet.

  2. Select "Connect Wallet" in the top right of the page and select "MetaMask". Confirm the connection in MetaMask.

  3. The "Connect" button will change into an icon representing your wallet. Congratulations, you are now connected to Beanstalk.

Connect to Beanstalk with WalletConnect

  1. Click “Connect Wallet” in the top right of the page.

  2. Click “WalletConnect”.

  3. Scan the QR code with your mobile wallet and tap “Connect”. Or, select “Desktop” in the toggle and select your wallet of choice and follow the necessary flow.

Confirm that you are on the Arbitrum network via the network dropdown in the top right. If so, congratulations, you are now connected to Beanstalk. Double check that your wallet address in the top right of the website is the address you connected through WalletConnect.

Connect to Beanstalk with Coinbase Wallet

  1. Click “Connect Wallet” in the top right of the page.

  2. Click “Coinbase Wallet”.

  3. If you are using the Coinbase Wallet mobile app, scan the QR code.

Confirm that you are on the Arbitrum network via the network dropdown in the top right. If so, congratulations, you are now connected to Beanstalk. Double check that your wallet address in the top right of the website is the same as your Coinbase Wallet address.

Approve Contracts

Certain transactions require approving certain smart contracts to process your transaction. When a mode is selected that requires an approval, if you have not yet approved the contract, a special notice will appear and the module will be unusable until you send an approve.

To send an approval for the transaction in question:

  1. Select "Approve [Token]".

Add Bean to MetaMask

  1. At the bottom of the “Assets” tab in MetaMask, select “import tokens”.

  2. Select the “Custom Token” tab.

  3. Under “Token Contract Address”, enter “0xBEA0005B8599265D41256905A9B3073D397812E4”. “Token Symbol” will automatically be filled with “BEAN”.

  4. Select “Add Custom Token”.

  5. Select “Import Tokens”.

Silo

Understand Silo vAPY

The APY calculation has two parts:

  1. Estimating the number of Beans that will be minted per Season using recent historical data.

Bean vAPY vs Stalk vAPY

Seeds grow Stalk each Season, regardless of deltaB. Estimated annual Stalk growth for a Stalkholder is called the Stalk vAPY.

Estimating Earned Beans per Season

The current EMA value can be located on the Silo page by hovering over the Bean vAPY values for any whitelisted asset.

Estimating vAPY for Silo Deposits

The vAPY calculations make the following assumptions:

  • No new assets are Deposited into or Withdrawn from the Silo;

  • No liquidity is added or removed from liquidity pools that Beans trade in;

  • There are 30-day EMA of Beans earned by Stalkholders each Season (which assumes that the Bean to Max LP Seed Ratio will approach its max value if there are any Seasons where Stalkholders earned Beans in the last 30 days); and

  • Every Stalkholder Mows their Grown Stalk and Plants their Plantable Seeds each Season.

Calculations

Exponential Moving Average (EMA)

Strategy

The Beanstalk UI shows the vAPYs for a Deposit with the average amount of Grown Stalk* based on a simulation of the Farmer's increase in Bean and Stalk positions compounded over the next year.

Understand the Sun

Selecting the Sun displays more detail on historical Seasons and a forecast for the next Season. The following information is shown for each Season:

  • Number of new Beans minted,

Sun

Etherscan ,

Prior to Beanstalk’s April 17, 2022 exploit, Beanstalk Improvement Proposals (BIPs) were entirely on-chain and autonomous. However, after the exploit, Beanstalk was Paused and the ability to propose BIPs on-chain halted. Until governance is removed entirely, BIPs will be voted on off-chain via Snapshot and will be executed on-chain by the . Stalkholders are able to vote on BIPs via Snapshot.

BIPs are proposed on the . Stalkholders can vote on BIPs on the . Past BIPs can be read .

In case of a particularly dangerous vulnerability to Beanstalk, the BCM can Pause Beanstalk without a Snapshot. You can read more about which actions the BCM can take without a Snapshot proposal . The Beanstalk DAO can also Pause Beanstalk via BIP.

The BCM address has the exclusive and unilateral ability to Pause or Unpause Beanstalk, and commit a BIP. In the future, it is expected that BIPs will remove governance entirely, revoking these abilities from the BCM. You can read more about the BCM .

BeaNFT DAO Multisig Safe address:

Rotating BDM signers requires a unless a signer voluntarily leaves the BDM or for rotating in a backup signer.

(BIP)

(EBIP)

(BOP)

(BFCP)

(BFBP)

(BIR)

(BSP)

(BNP)

All past proposals can be read .

If at any time 24 hours or more after the beginning and before the end of the Voting Period more than two-thirds of the total Stalk is voting For the BIP, the can execute the BIP.

BIPs are proposed on the . Stalkholders can vote on BIPs on the . Past BIPs can be read .

See for more information on proposing a BIP.

BOPs are proposed on the . Stalkholders can vote on BOPs on the . Past BOPs can be read .

See for more information on proposing a BOP.

EBIPs are shared with the Beanstalk community after commitment. Past EBIPs can be read .

See for more information.

Beanstalk Farms Committee Proposals, or BFCPs, are proposals related to personnel on the . The BFC is the group of Beanstalk Farms contributors that has discretion over the Beanstalk Farms budget, including contributor compensation.

Add members to the BFC via ;

Remove members from the BFC via ; and

Extend the terms of existing BFC members via .

BFCPs are proposed on the . Stalkholders can vote on BFCPs on the . Past BFCPs can be read .

Beanstalk Farms Budget Proposals, or BFBPs, are proposals related to the use of the Beanstalk Farms budget. The Beanstalk Farms budget is custodied by the . The BFM executes the will of the BFC.

Hire contributors to Beanstalk Farms via ;

Dismiss contributors from Beanstalk Farms via ; and

Otherwise use the Beanstalk Farms budget via .

BFBPs are proposed on the , which is where BFC members vote. Past BFBPs can be read .

Beanstalk Immunefi Responses, or BIRs, are responses to bug reports on . Only BIC members can propose and vote on BIRs and each member has 1 vote. Any BIC member can vote For or Against.

See for more information.

BIRs are proposed on the , which is where BIC members vote. Past BIRs can be read .

A BNP can also be used to change the configuration or signers on the .

BNPs are proposed on the . BeaNFT holders can vote on BNPs on the . Past BNPs can be read .

BeaNFTs were the first project built on top of Beanstalk. BeaNFTs have historically been awarded to Farmers for interacting with Beanstalk during certain time periods. BeaNFT contract addresses can be found on the page.

A BNP can also be used to change the configuration or signers on the .

BNPs are proposed on the . BeaNFT holders can vote on BNPs on the . Past BNPs can be read .

Beanstalk uses credit instead of collateral to create Bean price stability relative to its value peg of $1. In practice, this means the protocol incentivizes the regular oscillation of the Bean price above and below its peg. The Bean price will almost never be exactly equal to its peg. Read more about or an in-depth overview of the .

You can view the current Bean price in US dollars at the upper left corner of .

deltaB, the shortage or excess of Beans in the liquidity pool. Read more about how deltaB impacts the and .

Beanstalk officially supports MetaMask, WalletConnect and Coinbase Wallet on desktop and mobile. WalletConnect is a protocol supported by many wallet applications. Although not officially supported, you may be able to connect other wallets such as Brave, Frame or Rabby by selecting MetaMask on .

Visit .

Visit .

Download MetaMask from the or .

From the menu, select "Browser" and visit .

Visit .

Visit .

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

If you have Beans in your wallet but they do not appear under “Assets” in MetaMask, you can add the Bean ERC-20 token contract as a so that MetaMask will recognize your Bean holdings. Note that MetaMask will only show your —your balances within Beanstalk can be seen on the page.

Guides on interacting with .

The Beanstalk UI displays vAPY (variable APY) statistics for each asset on the . APYs are called variable because they are not enforced by Beanstalk in any way. Rather, the APY uses historical data about Beans earned by Stalkholders to estimate future returns for Depositing in the Silo.

Estimating the number of Beans and Stalk that a Farmer will receive over time for Depositing their whitelisted assets in the Silo. This takes into account the Stalk supply and Seed supply and makes some about Stalkholder behavior.

Stalkholders earn Bean seignorage when is greater than 0 over the previous Season. Estimated annual Beans earned by a Stalkholder is called the Bean vAPY.

The Beanstalk UI and Subgraph use a 30-day (EMA) of Beans earned by Stalkholders to estimate future Beans earned by Stalkholders. The formula uses a weighted average in which recent Seasons are weighted more heavily.

The vAPY for Depositing a whitelisted asset in the Silo is determined by the value of 1 newly Deposited in 8760 Seasons (1 year).

The window of the EMA (), i.e., the number of Seasons in 30 days:

The weighting multiplier (); a constant between 0 and 1 that determines how much weight is given to the most recent data point:

The 30-day exponential moving average at Season ():

The complete formulas for the vAPYs can be read in the code .

*The are based on a new Deposit with no Grown Stalk.

The Sun keeps time on the Farm in and incentivizes cost-efficient and timely calling of the function.

You can view at the upper left corner of .

The Sun displays the current Season, which is the number of Seasons completed since gm was called for the first time. If during the current Season based on the , the Sun will appear as a rain cloud icon.

made available in the ,

for ,

, and

, if it was used to measure Demand for Soil. If there is between 0 and 1 Soil remaining at the end of any Season, .

Guides on understanding the Bean price and how affects Beanstalk.

0x2CC7554bc906e52e1B39dA62D6271f95e239DF8d
0xAbdD39129af9DEAeE7c1Ca3268D69F4850292cAB
0x6e7308fd175b51c4eee8a422a4219d8b9c380a0b
0xd1f4544975D265f1c87f618351e8BFa8f4EEd77E
0x8C0AEd103709f44888476f5B5A13E9AAf2831511
0x5f6a6c6E242eDe2020008c4137e239A80590ddF5
0x243CbEd862854262eD3d617f7d19277A787A4148
BIR-1
1
2
BIR-2
Etherscan
BIR-3
Etherscan
BIR-4
Etherscan
BIR-5
Etherscan
BIR-6
Etherscan
BIR-7
Etherscan
BIR-8
Etherscan
BIR-9
Etherscan
BIR-11
Etherscan
BIR-12
Etherscan
BIR-13
Etherscan
BIR-14
Etherscan
BIR-15
Etherscan
BIR-16
Etherscan
BIR-17
Etherscan
BIR-18
Etherscan
BIR-19
Etherscan
BIR-20
Etherscan
BIR-21
Arbiscan
BIR-22
Arbiscan
Beanstalk Community Multisig (BCM)
Beanstalk DAO Snapshot page
Beanstalk UI Governance page
here
here
0x2D92a7Ba42472001111C1A1614EF6A8737bDf278
here
Beanstalk Community Multisig (BCM)
Beanstalk DAO Snapshot space
Beanstalk UI Governance page
here
Beanstalk DAO Snapshot space
Beanstalk UI Governance page
here
here
Beanstalk Farms Committee (BFC)
Beanstalk Farms Snapshot space
Beanstalk UI Governance page
here
Beanstalk Farms Multisig (BFM)
Beanstalk Farms Budget Snapshot page
here
Immunefi
BIC Process
Beanstalk Bug Bounty Snapshot page
here
BeaNFT DAO Multisig (BDM)
BeaNFT DAO Snapshot space
Beanstalk UI Governance page
here
Contracts
Announcing the BeaNFT Genesis Collection
BeaNFT Genesis: Utility, Structure and Rarity
The BeaNFT Winter Collection
The BeaNFT Barn Raise Collection
The Basin BeaNFT Collection
Genesis Collection
Winter Collection
Barn Raise Collection
Basin Collection
BeaNFT DAO Multisig (BDM)
BeaNFT DAO Snapshot space
Beanstalk UI Governance page
here
how Beanstalk works
peg maintenance mechanism
app.bean.money
here
BIP Proposal Process
BOP Proposal Process
Emergency Response Procedures
BNP
Notes
Beanstalk Improvement Proposal
Emergency Beanstalk Improvement Proposal
Beanstalk Operations Proposal
Beanstalk Farms Committee Proposal
Beanstalk Farms Budget Proposal
Beanstalk Immunefi Response
Bean Sprout Proposal
BeaNFT Proposal
BFCP-A
BFCP-B
BFCP-C
BFBP-A
BFBP-B
BFBP-C
Bean supply
Soil supply
uuu
u=24∗30=720u = 24 * 30 = 720u=24∗30=720
β\betaβ
β=2(u+1)\beta=\frac{2}{(u+1)}β=(u+1)2​
ttt
nˉte\bar{n}^e_tnˉte​
nˉte=β∑i=t−u+1i≤t(1−β)t−inie\bar{n}^e_t = \beta \sum_{i=t-u+1}^{i \leq t}(1-\beta)^{t-i} n^e_{i}nˉte​=βi=t−u+1∑i≤t​(1−β)t−inie​
0xee7cbf28a01fb4285ac0b5c5a9f367d76fc30015
0x5513946107b5389ffc5e638b8a351f8bf9a40bfa
0x198eCE0f3584210cAf2a511224Ca418EDab98335
0xb83a613cf24a62175e37776a7dbbeed7d9114338
0x5ba7d66a03f8361e0c982e159757f64508bf0185
0xdb2Fd876B27657449b05A04AE1040d0aA26D5154
0x97dae5976ee1d6409f44906bea9bf88fee0bf672
app.bean.money
metamask.io/download
app.bean.money
App Store
Google Play
app.bean.money
app.bean.money
app.bean.money
correct contract
custom token
Circulating Beans
Balances
the Silo
Understand Silo vAPY
Deposit in the Silo
Understand Silo Deposit Performance
Convert in the Silo
Transfer Deposits
Withdraw from the Silo
Claim Silo Rewards
exponential moving average
here
APYs on DeFiLlama
the Sun
app.bean.money
the Sun
Understand the Bean Price
Understand the Sun
Selecting and Funding a Wallet
Connect to Beanstalk with MetaMask - Desktop
Connect to Beanstalk with MetaMask - Mobile
Connect to Beanstalk with WalletConnect
Connect to Beanstalk with Coinbase Wallet
Deposit Whitelist
assumptions
peg maintenance mechanism
Beans were minted
Field
Soil

Transfer Deposits

  1. Navigate to the “Silo” page.

  2. Select the Deposited asset you want to Transfer.

  3. Enter the Ethereum address to Transfer to under “Transfer to”.

  4. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  5. Select “Transfer”.

  6. After the transaction has been confirmed by the network, the Transferred Deposit will appear at the recipient’s address on the “Silo” page for the asset that was Transferred.

Understand Silo Deposit Performance

The first module provides an overview of your Silo Deposits and their performance over time.

  • The "Stalk" tab shows your total "Stalk Balance" and a chart of historical Stalk balances, "Stalk Ownership" and "Stalk Grown per Day".

    • "Stalk Ownership" is your current ownership of Beanstalk displayed as a percentage. Ownership is determined by your proportional ownership of the total Stalk supply.

  • The "Seeds" tab shows your "Seeds Balance" and a chart of historical Seed balances.

    • Seeds are received by Depositing assets on the Deposit Whitelist and yield 1/10,000 Stalk each Season.

  • Earned Beans are the number of Beans earned since your last Plant. Upon Plant, Earned Beans are Deposited in the current Season.

  • Earned Stalk is the Stalk associated with Earned Beans. Earned Stalk automatically contribute to Stalk ownership and do not require any action to claim them.

The third module provides information on Deposits categorized by asset. This module can be switched between USD and BDV by selecting your wallet address, "Settings", and choosing a "Fiat display" option.

  • The "Rewards" column shows the number of Stalk and Seeds per Bean denominated value (BDV) Deposited. Hover over the column to see the BDV of each asset.

  • The "Amount Deposited" is your amount of Beans or LP Deposited. Note that one unit of LP is not expected to be equal to one Bean. See the current BDV under the "Rewards" column.

  • The "Value Deposited" is the value of your Deposits in USD or BDV. Unripe Assets are calculated after the Chop Penalty.

Field

Withdraw from the Silo

  1. Navigate to the “Silo” page.

  2. Select the asset you want to Withdraw. You must already have a Deposit of this asset in order to Withdraw.

  3. Select the “Withdraw” tab and enter the amount of the Deposited asset you would like to Withdraw. You may Withdraw any amount up to your “Deposited Balance” shown below the input box.

  4. LP Tokens have a “Claim as” option that allows you to receive the asset in a different form. For example, BEAN:3CRV LP may be Withdrawn as BEAN:3CRV, Bean or 3CRV. If the option selected is different from the Withdrawn asset, the transaction will convert the Withdrawn asset.

    • If the transaction involves trading between assets, you may select a slippage tolerance by selecting the gear icon. The default slippage tolerance is 0.1%.

  5. Select “Withdraw”.

  6. After the transaction has been confirmed by the network, the location of your assets will depend on the option selected in Step 6:

Claim Silo Rewards

Mow

Note: The “Mow” function is called anytime a Farmer interacts with the Silo.

  1. Navigate to the “Silo” page.

  2. Select the green “Claim” button.

    • Note: You must have Grown Stalk in order to Mow.

  3. Check “Mow” for the Silo assets you would like to Mow.

  4. Select the green “Claim Rewards” button. An estimated transaction fee based on current gas costs is displayed below.

  5. After the transaction has been confirmed by the network, your Grown Stalk will be added to the Stalk balance at the top of the "Silo" page.

Plant

  1. Navigate to the “Silo” page.

  2. Select the green “Claim" button.

    • Note: You must have Plantable Seeds in order to “Plant”.

  3. Check the items you would like to Plant.

  4. Select the green “Claim Rewards” button. An estimated transaction fee based on current gas costs is displayed below.

  5. After the transaction has been confirmed by the network, your Plantable Seeds will be added to the Seed balance at the top of the "Silo" page.

Enroot

  1. Navigate to the “Silo” page.

  2. Select the green “Claim” button.

    • Note: You must have Revitalized Stalk and Seeds in order to Enroot.

  3. Select to Enroot your Revitalized Stalk and/or Revitalized Seeds.

  4. Select the green “Claim Rewards” button. An estimated transaction fee based on current gas costs is displayed below.

  5. After the transaction has been confirmed by the network, your Revitalized Stalk and Seeds will be added to the Stalk and Seed balances on the top of the "Silo" page, respectively.

Claim all Silo Rewards

  1. Navigate to the “Silo” page.

  2. Select the green “Claim” button.

    • Note: You must have claimable Silo Rewards.

  3. All Claimable Silo Rewards are selected by default.

  4. Select the green “Claim Rewards” button. An estimated transaction fee based on current gas costs is displayed below.

  5. After the transaction has been confirmed by the network, your Silo Rewards will be added to your Stalk and Seed balances on the top of the "Silo" page, respectively.

Add Additional Transactions to Save Gas

  1. An alternative way to Claim Silo Rewards is as an add-on to another Beanstalk transaction.

  2. If eligible, an "Add additional transactions to save gas" dropdown menu will appear under the primary transaction.

  3. Select "Mow", "Plant", "Enroot" or use the "Claim All" toggle.

  4. The Silo Rewards transaction will appear under "Transaction Details".

Transfer Pods

  1. Navigate to the “Field” page.

  2. Enter the number of Pods you want to Transfer, up to the “Plot Size” shown below the input box.

  3. Transfers of partial Plots send the end of the Plot by default.

    • To specify the portion of the Plot to send, select “Advanced”. Use the slider or text boxes to select the portion of the Plot to Transfer.

  4. Enter the Ethereum address to Transfer the Pods to under “Transfer to”.

  5. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  6. Select “Transfer”.

  7. After the transaction has been confirmed by the network, the Transferred Pods will appear at the recipient’s address on the “Field” page under the “Pod Balance” component.

Harvest Pods

  1. Navigate to the “Field” page.

  2. Select the “Harvest” tab. The amount of “Harvestable Balance” will be shown. These are the Pods that can be Harvested in exchange for Beans.

  3. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  4. Select “Harvest”.

  5. After the transaction has been confirmed by the network, the location of the Beans from your Harvestable Pods will depend on the option selected in Step 4:

Barn

Understand Fert vAPY

The Beanstalk UI displays vAPY (variable APY) statistics for Fertilizer. APYs are called variable because they are not enforced by Beanstalk in any way. Rather, the APY uses historical data about Beans earned by Fertilizer holders to estimate future returns.

The APY calculation has two parts:

  1. Estimating the number of Beans that will be minted per Season using recent historical data.

Fert vAPY

Estimating Sprouts Fertilized per Season

The current EMA value can be located on the Barn page by hovering over the Fert vAPY.

Estimating vAPY for Fertilizer

The vAPY is determined by the estimated return of holding Fertilizer in 8760 Seasons (1 year).

The vAPY calculation makes the following assumptions:

  • No more Available Fertilizer is purchased; and

  • No Active Fertilizer becomes Used.

Calculations

Exponential Moving Average (EMA)

Fert vAPY

Sow Beans

  1. Navigate to the “Field” page.

    • During the first five minutes of each Season, the Temperature ramps from 1% to 100% of the Maximum Temperature in a Dutch auction known as the Morning Auction.

  2. In the “Sow” tab, there is a dropdown menu to select the token you would like to use to buy and Sow Beans.

  3. Enter the amount of the selected token you want to use to buy and Sow Beans.

    • If you are Sowing during the Morning Auction, the number of Pods to be received will increase in real time on the UI with the increasing Temperature. The actual amount of Pods you receive depends upon Soil availability and the Temperature at the time your transaction is confirmed.

  4. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  5. You may select a slippage tolerance by selecting the gear icon. The default slippage tolerance is 0.1%.

  6. If you are buying and Sowing Beans with ETH or have previously approved the asset being spent, skip to Step 10. For all other assets, select “Approve [Token]”. This allows the Beanstalk contract to spend the asset, but does not use it to buy and Sow Beans yet.

  7. Select “Sow”.

  8. After the transaction has been confirmed by the network, your Pods will appear in the “Pod Balance” table at the bottom of the “Field” page.

Buy Fertilizer

Beanstalk is hosting the Barn Raise — a fundraiser to restore $77M in non-Bean liquidity stolen from the Silo. The Barn Raise started on June 6, 2022.

  1. Navigate to the “Barn” page.

  2. In the “Buy” tab, there is a dropdown menu to select the token you would like to use to buy Fertilizer.

  3. Enter the amount of the selected token you want to use to buy Fertilizer.

    • The amount of Fertilizer received rounds down to the nearest dolalr.

  4. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  5. You may select a slippage tolerance by selecting the gear icon. The default slippage tolerance is 0.1%.

  6. If you are buying Fertilizer with ETH or have previously approved the asset being spent, skip to Step 10. For all other assets, select “Approve [Token]”. This allows the Beanstalk contract to spend the asset, but does not use it to buy and Sow Beans yet.

  7. Select “Buy”.

  8. After the transaction has been confirmed by the network, your Fertilizer and associated Sprouts will appear in the “Fertilizer” component at the bottom of the “Barn” page.

Transfer Fertilizer

  1. Select the Fertilizer you would like to transfer.

  2. On the top right of the page, select the send icon that says "Transfer" upon hover.

  3. In the "Quantity" field, enter how many Fertilizer tokens you would like to transfer.

  4. Enter the recipient address in the "Address" field.

  5. Select "Transfer".

  6. After the transaction has been confirmed by the network, the transferred Fertilizer (and associated Sprouts) will appear at the recipient’s address on the “Barn” page of the Beanstalk UI.

Temperature
Delta Demand is not used

Deposits can be from one address to another without the loss of Stalk and Seeds.

Make sure you are on and .

At the bottom of the page, there is a table showing the various assets on the .

Select “Transfer” and enter the amount of the Deposit you want to Transfer, up to the “Deposited Balance” shown below the input box. More recent Deposits are Transferred first to minimize the loss of by the sender. No net Stalk or Seeds are lost in a Transfer.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

The page is a dashboard for monitoring the balances and performance of your .

After on , navigate to the "Silo" page.

The "Deposits" tab shows your current USD denominated "Value Deposited" and a chart of historical value. As Silo Deposits generate , them will increase "Value Deposited".

For pre-exploit Farmers, the value of is calculated after the .

is the governance token of the received by Depositing assets on the and from . Your "Stalk Balance" will grow as your Seeds yield more Stalk.

Stalk entitles holders to passive interest in the form of a share of future , and the right to propose and vote in . Your Stalk is forfeited when you your Deposited assets from the Silo.

"Stalk Grown per Day" is the amount of Stalk grown each day from Seeds. Seeds yield 1/10,000 Stalk each .

The second module provides an overview of your . Read how to .

are Seeds earned in conjunction with Earned Beans. Plantable Seeds must be Planted in order to grow Stalk.

are Stalk earned from Seeds. Grown Stalk does not contribute to Stalk ownership until it is . Grown Stalk is Mown at the beginning of any Silo interaction.

are Stalk that have vested for pre-exploit Silo Members. Revitalized Stalk are minted as the percentage of sold increases. Revitalized Stalk does not contribute to Stalk ownership until .

are Seeds that have vested for pre-exploit Silo Members. Revitalized Seeds are minted as the percentage of Fertilizer sold increases. Revitalized Seeds do not generate Stalk until Enrooted.

See for details on the Variable APY calculation.

"TVD" is the Total Value Deposited from all Depositors. Unripe Assets are scaled by the USD value of the underlying Beans or LP as recapitalized through the .

Guides on interacting with .

The associated amount of Stalk, Seeds, and Stalk from Seeds from a given Deposit must be forfeited when the Deposit is Withdrawn from the Silo. You can find more information about Withdrawals .

Make sure you are on and .

At the bottom of the page, there is a table showing the various assets on the .

Under “Destination”, select “Circulating Balance” or “Farm Balance”. Selecting Circulating Balance returns Withdrawn assets to your wallet. Selecting Farm Balance keeps the asset stored in Beanstalk which can save gas fees in future transactions. See for more information.

A transaction preview showing the will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should that the transaction is interacting with the correct contract before signing it.

If “Circulating Balance” was selected, the assets will be in your wallet. Your Circulating Balance is also shown on the page.

If “Farm Balance” was selected, the assets will be shown on the page.

Assets on the can be Deposited in to earn Stalk and Seeds. You can find more information about Silo Rewards .

Mowing adds the Grown Stalk to your Stalk balance, which determines your governance power and portion of Bean seigniorage earned.

Make sure you are on and .

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Planting adds them to your Seed balance, which determines how many Grown Stalk you receive each Season. Planting also Deposits your in the current Season. already contributes to your Stalk ownership and does not need to be claimed, but is claimed upon Plant.

Make sure you are on and .

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

adds to your Stalk and Seed balances, respectively.

Make sure you are on and .

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Claiming all Silo Rewards calls , and in one transaction.

Make sure you are on and .

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Pods can be from one address to another directly. Note that Pods can be exchanged in a trustless fashion on .

Make sure you are on and .

In the “Transfer” tab, there is a dropdown menu to select the Plot you would like to transfer. The menu lists all Plots ordered by place in the .

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Once reached the front of the Pod Line, they become Harvestable. Harvestable Pods are redeemable for 1 Bean each.

Make sure you are on and .

Under “Destination”, select “Circulating Balance” or “Farm Balance”. Circulating Balance sends the Beans to your wallet, separate from Beanstalk. keeps the Beans stored in Beanstalk which can save gas fees in future transactions. See for more information.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

If “Circulating Balance” was selected, the Beans will be in your wallet. Your Circulating Balance is also shown on the page.

If “Farm Balance” was selected, the Beans will be shown on the page.

Guides on interacting with .

is an ERC-1155 token, so it can be transferred and traded on .

Estimating the number of Beans that a Farmer will receive over time for holding Fertilizer. This takes some about Fertilizer holder behavior.

Fertilizer holder earn Bean seignorage when is greater than 0 over the previous Season. Estimated annual Beans earned by a Fertilizer holder is called the Fert vAPY.

The Beanstalk UI and Subgraph use a 30-day (EMA) of Beans earned by Fertilizer holders to estimate future returns. The formula uses a weighted average in which recent Seasons are weighted more heavily.

The window of the EMA (), i.e., the number of Seasons in 30 days:

The weighting multiplier (); a constant between 0 and 1 that determines how much weight is given to the most recent data point:

The 30-day exponential moving average at Season ():

The formulas for the Fert vAPY (​) take the following variables as inputs:

, the 30-day EMA of Beans earned by Fertilizer holders at Season ​;

, the Humidity at Season ​; and

, the Active Fertilizer supply.

​ is calculated using the estimated number of Beans owned by the Fertilizer holder a year from now (8760 Seasons from now).

First, calculate the delta Beans earned per Fertilizer (​):

We define ​ as:

When there is in , Farmers can lend their Beans to Beanstalk for an interest rate known as the .

Make sure you are on and .

The Available Soil and Temperature are displayed in the “Field Conditions” component. The Soil supply is set by the Beanstalk peg maintenance mechanism. See for additional information.

The Soil available when preparing to buy and Sow Beans may not still be available at the time the transaction is confirmed by the network. If a transaction is submitted to Sow a greater amount of Soil than is available, the remaining Soil will be Sown, and all remaining Beans from the transaction will be sent to your .

Confirm the approval transaction in your wallet, and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Active Fertilizer holders receive Sprouts. Sprouts become redeemable for Beans on a basis. See the page for more info.

Make sure you are on and .

The Available Fertilizer is displayed in the "Barn Conditions" component. Available Fertilizer is a function of how much Unripe LP is left to be recapitalized. See for additional information.

Confirm the approval transaction in your wallet, and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Active Fertilizer is an ERC-1155 token. ERC-1155 tokens can be transferred on OpenSea. Transferring Fertilizer to another address transfers the associated Sprouts as well. See the page for more info.

Go your account and connect your wallet.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

app.bean.money
connect your wallet
correct contract
connecting a wallet
app.bean.money
Understand vAPY
Barn
the Field
Sow Beans
Transfer Pods
Harvest Pods
app.bean.money
connect your wallet
Asset States
verify
Balances
Balances
app.bean.money
connect your wallet
correct contract
app.bean.money
connect your wallet
correct contract
app.bean.money
connect your wallet
correct contract
app.bean.money
connect your wallet
correct contract
app.bean.money
connect your wallet
correct contract
app.bean.money
connect your wallet
Farm Balance
Asset States
correct contract
Balances
Balances
the Barn
Understand Fert vAPY
Buy Fertilizer
Rinse Sprouts
Transfer Fertilizer
Trade Fertilizer
Deposit Whitelist
Stalk and Seeds
here
Deposit Whitelist
decrease in Stalk and Seeds
the Silo
Deposit Whitelist
here
Mow Grown Stalk
Plant Plantable Seeds
Enroot Revitalized Stalk and Seeds
Claim all Silo Rewards
Add Additional Transactions to Save Gas
Mow
Plant
Enroot
OpenSea
Fertilizer
Pods
uuu
u=24∗30=720u = 24 * 30 = 720u=24∗30=720
β\betaβ
β=2(u+1)\beta=\frac{2}{(u+1)}β=(u+1)2​
ttt
nˉte\bar{n}^e_tnˉte​
nˉte=β∑i=t−ui≤t(1−β)t−inie\bar{n}^e_t = \beta \sum_{i=t-u}^{i \leq t}(1-\beta)^{t-i} n^e_{i}nˉte​=βi=t−u∑i≤t​(1−β)t−inie​
vAPYFert\text{vAPY}^{\text{Fert}}vAPYFert
nˉte\bar{n}^e_tnˉte​
ttt
hhh
ttt
FFF
vAPYFert\text{vAPY}^{\text{Fert}}vAPYFert
dBPF\text{dBPF}dBPF
dBPF=nˉteF\text{dBPF}=\frac{\bar{n}^e_t}{F}dBPF=Fnˉte​​
vAPYFert\text{vAPY}^{\text{Fert}}vAPYFert
vAPYFert=(h1+hBPF÷8760)\text{vAPY}^{\text{Fert}}=(\frac{h}{ \frac{1 + h}{\text{BPF}} \div 8760})vAPYFert=(BPF1+h​÷8760h​)
exponential moving average
app.bean.money
connect your wallet
Farm Balance
correct contract
correct contract
app.bean.money
connect your wallet
correct contract
correct contract
Barn
OpenSea
correct contract
assumptions
the Field
Temperature
Soil
Soil Supply
Fertilizer

Migrate to Arbitrum

Many users were automatically migrated, however, given that Beanstalk does not have control of Beans outside of the Beanstalk contract, Circulating Beans need to be manually migrated to Arbitrum.

Beanstalk assets in smart contract accounts could not be automatically migrated given that Beanstalk cannot assume an owner of a smart contract is able to gain ownership of the same address on Arbitrum.

If you need to manually migrate to Arbitrum:

  1. Enter the wallet address on Arbitrum One to receive your Beanstalk assets.

  2. Select "Delegate Beanstalk Balances".

For contract migrations only:

  1. Connect the Arbitrum One wallet entered in step #2.

  2. Select "Claim Beanstalk Balances".

Market

Understand My Balances

Overview

The top of the Balances page displays your Stalk, Seeds, Pods and Sprouts:

Total Deposited Value

  • The "Amount Deposited" is your amount of Beans or LP Deposited. Note that one unit of LP is not expected to be equal to one Bean due to BDV differences.

  • The "Value Deposited" is the value of your Deposits in USD or BDV. Unripe Assets are calculated after the Chop Penalty.

Quick Rinse / Quick Harvest

  • Select “Rinse” or "Harvest".

  • After the transaction has been confirmed by the network, the location of your assets will depend on the "Destination" selected.

Rewards

  • Earned Beans are the number of Beans earned since your last Plant. Upon Plant, Earned Beans are Deposited in the current Season.

  • Earned Stalk is the Stalk associated with Earned Beans. Earned Stalk automatically contribute to Stalk ownership and do not require any action to claim them.

  • Plantable Seeds are Seeds earned in conjunction with Earned Beans. Plantable Seeds must be Planted in order to grow Stalk.

  • Grown Stalk are Stalk earned from Seeds. Grown Stalk does not contribute to Stalk ownership until it is Mown. Grown Stalk is Mown at the beginning of any Silo interaction.

  • Revitalized Stalk are Stalk that have vested for pre-exploit Silo Members. Revitalized Stalk are minted as the percentage of Fertilizer sold increases. Revitalized Stalk does not contribute to Stalk ownership until Enrooted.

  • Revitalized Seeds are Seeds that have vested for pre-exploit Silo Members. Revitalized Seeds are minted as the percentage of Fertilizer sold increases. Revitalized Seeds do not generate Stalk until Enrooted.

Farm Balance / Circulating Balance

These modules display your current Farm and Circulating balances for all tokens that can be used within the Beanstalk UI.

Sell Pods

List Pods

  1. Navigate to the “Market” page.

  2. Select “Create New” then select the “List” tab.

    • The “Select Plot” dropdown shows all your Plots. Select the Plot that has the Pods you would like to List and enter the number of Pods to List.

      • By default, Listing less than an entire Plot Lists the Pods at the end of the Plot. If you would like to choose the Pods to List, select “Advanced”.

    • “Price per Pod” is how much to sell each Pod for, denominated in Beans.

    • If the Pod Line moves forward by the amount in “Expires in”, the Pod Listing will automatically expire.

  3. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  4. Select “List”.

  5. When your Pod Listing is Filled, the location of your Beans will depend on the option selected in Step 7:

Fill Pod Order

  1. Navigate to the “Market” page.

    • You may customize the sorting, display, or filtering of any column by selecting it.

    • The “Order” ID is a unique identifier for each Pod Order.

    • Any Pods within the Pod Line range listed under “Place in Line” are eligible to be sold to the Pod Order.

    • “Pods Requested” is the number of Pods left to be sold to the Pod Order.

  2. Select a Pod Order to view details or to sell Pods to a Pod Order.

  3. Under the “Fill” modal, select the Plot you would like to use to Fill the Pod Order, and enter the number of Pods you would like to sell. You may sell up to the “Pods Requested” to the Pod Order.

  4. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  5. Select “Fill”.

  6. After the transaction has been confirmed by the network, the location of your Beans will depend on the option selected in Step 6:

Seed Gauge System

Seeds generate opportunity cost for Withdrawing assets that have been Deposited for longer and marginal benefit for holding particular assets in the Silo in the form of Grown Stalk.

There are 3 new primary tools that Beanstalk has at its disposal as a result of implementing the Seed Gauge System:

  1. The Target Seasons to Catchup, which determines the target number of Seasons for a new Deposit with an average number of Seeds to catch up to the average Grown Stalk per BDV of existing Deposits at the time of Deposit;

  2. LP vs LP Seed distribution, which determines relative benefits of holding a given non-Bean asset in the Silo over time.

Grown Stalk Inflation Rate

The Grown Stalk per BDV for a Deposit can be thought of as the age of that Deposit—the longer the Deposit has been in the Silo, the higher its Grown Stalk is relative to its BDV. Thus, the average Grown Stalk per BDV is a measure for how old Deposits are across the entire Silo relative to the total BDV in the Silo.

The Seed Gauge System enables Beanstalk to target an amount of Grown Stalk per BDV that should be issued each Season. In particular, Beanstalk sets the target number of Seasons for a new Deposit with an average number of Seeds to catch up to the average Grown Stalk per BDV of existing Deposits at the time of Deposit, or in other words, the Target Seasons to Catch Up. The Target Seasons to Catchup is currently set to 4320 Seasons, or ~6 months.

Gauge Points

Gauge Points determine how the Grown Stalk issued in a Season should be distributed between whitelisted LP tokens. Only whitelisted LP tokens have Gauge Points.

Every Season, Beanstalk calculates the new amount of Gauge Points an LP token should have by calling each whitelisted LP token's Gauge Point function. Currently all whitelisted LP tokens use the same Gauge Point function that increases or decreases the Gauge Points based on whether the current Deposited BDV is lower or higher than optimal.

Crop Ratio

Gauge Points per BDV is the amount of Gauge Points allocated to a whitelisted LP token divided by the total BDV of that LP token Deposited in the Silo. The whitelisted LP token with the largest Gauge Points per BDV is used to determine the distribution of Grown Stalk to Beans in the Silo in order to ensure that at least 1 LP token always receives at least as much Grown Stalk as Deposited Beans. Ensuring that 1 whitelisted LP token (i.e., the LP token with the highest Gauge Points per BDV) is always allocated at least as many Seeds as Beans ensures that Beanstalk never incentivizes holding Beans over providing liquidity.

Governance

Trade Beans

    • Circulating Balance is the balance in your wallet, separate from Beanstalk.

  1. In the second field, select the output token, or the asset you would like to buy.

    • Note: Swap must be used to buy or sell Beans, or to wrap or unwrap ETH. Trading between other pairs is not currently supported.

  2. Enter the amount of the input token to sell, up to the amount held in your Farm or Circulating balances.

    • Note: The Beanstalk UI first spends the balance that is most gas-efficient based on the specified amount.

  3. Verify the amount of the output token you will receive in the output field.

  4. Under “Destination”, select “Farm Balance” or “Circulating Balance”.

  5. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  6. You may select a slippage tolerance by selecting the gear icon. The default slippage tolerance is 0.1%.

  7. If you are trading ETH or have previously approved the token being spent, skip to Step 12. For all other tokens, select “Approve [Token]”. This allows the Beanstalk contract to spend the token, but does not execute the trade yet.

  8. Select “Swap”.

  9. After the transaction has been confirmed by the network, the location of your tokens will depend on the option selected in Step 7:

Swap

Guides on trading and transferring Beans.

Transfer Balances

  1. In the first field select the token you would like to transfer and its location:

    • "Circulating Balance" is the balance in your wallet, separate from Beanstalk.

    • "Farm Balance" is the balance stored in Beanstalk, which can save gas fees in future transactions.

    • "Combined Balance" is the sum of Circulating Balance and Farm Balance. Note Combined Balance cannot be used when transferring to yourself.

  2. Enter the amount of the token to transfer, up to the amount held in your Farm, Circulating or Combined balances.

  3. Under “Transfer to”, enter the address to transfer the tokens to, or select "Me" to move your Farm Balance to Circulating Balance or vice versa.

  4. Under "Destination Balance" select either "Circulating Balance" or "Farm Balance".

    • If "Transfer to" is set to "Me", if the source of the token was “Farm Balance”, the “Destination” will be “Circulating Balance” and vice versa.

  5. A transaction preview will appear below the inputs. Select the “Transfer Details” dropdown to review each step of the transaction.

  6. If you are transferring a non-ETH token from your Circulating Balance and have not previously approved that token, select “Approve [Token]”. This allows the Beanstalk contract to move the token, but does not execute the transfer yet. Otherwise, skip to Step 10.

  7. Select “Transfer”.

  8. After the transaction has been confirmed by the network, the location of your tokens will depend on the option selected in Step 6:

BeaNFTs

Guides on minting BeaNFTs.

Mint BeaNFTs

  1. Switch the current tab to the collection in which you have an unminted BeaNFT.

  2. If you would like to mint a single BeaNFT from the selected collection, select an unminted BeaNFT and select "Mint" in the modal. If you would like to mint all unminted BeaNFTs in the selected collection, select "Mint All [Collection]" in the top right of the component.

Silo
Beanstalk DAO
Deposit Whitelist
governance
Bean mints
Claim Silo Rewards
Revitalized Stalk and Seeds
the Pod Market
Barn

migrated Beanstalk from Ethereum mainnet to Arbitrum One.

Make sure you are on and .

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should that the transaction is interacting with the correct contract before signing it.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should that the transaction is interacting with the correct contract before signing it.

Guides on using .

The page is a dashboard for all Beanstalk-related holdings by wallet address.

After on , navigate to the "Balances" page.

- Your total Stalk balance. Stalk is the governance token of the Beanstalk DAO. Stalk entitles holders to passive interest in the form of a share of future Bean mints, and the right to propose and vote on . Your Stalk is forfeited when you Withdraw your Deposited assets from the Silo.

- Your total Seed balance. Each Seed yields 1/10000 each Season. Grown Stalk must be to add it to your Stalk balance. Your Seeds are forfeited when you Withdraw your Deposited assets from the Silo.

- Your total Pod Balance. Pods become on a basis. For more information on your place in the , head over to the .

- Your total Sprout balance. The number of Beans left to be earned from your . Sprouts become on a basis. For more information on your Sprouts, head over to the .

Shows the current USD denominated value of your Silo Deposits and a chart of historical value. As Silo Deposits generate , them will increase "Total Deposited Value".

For pre-exploit Farmers, the value of is calculated after the .

The module below provides information on Deposits categorized by asset. This module can be switched between USD and by selecting your wallet address, "Settings", and choosing a "Fiat display" option.

The "Stalk" is the amount of Stalk associated with each Deposited asset. Stalk will increase as Grown Stalk is Mown and with .

Pre-exploit Farmers receive . Revitalized Stalk are minted as the percentage of sold increases. Revitalized Stalk does not contribute to Stalk ownership until .

The "Seeds" is the amount of Seeds associated with each Deposited asset. Seeds will increase as are .

Pre-exploit Farmers receive . Revitalized Seeds are minted as the percentage of Fertilizer sold increases. Revitalized Seeds do not generate Stalk until Enrooted.

These modules appear if you have or .

Under “Destination”, select “Circulating Balance” or “Farm Balance”. sends the Rinsed or Harvested Beans to your wallet, separate from Beanstalk. keeps the asset stored in Beanstalk which can save gas fees in future transactions. See for more information.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

You can confirm the location in the .

This module displays and allows claiming of .

See the for detailed instructions.

Farm Balances are assets stored in Beanstalk. can be used in transactions on the Farm. Circulating balances are Beanstalk assets in your wallet.

See for more info on the different states Beanstalk assets can be in.

Pods can be exchanged in a trustless fashion on the Pod Market. Read the docs first for an introduction to Pod Market mechanics, and .

Make sure you are on and .

Under “Send proceeds to”, select “Circulating Balance” or “Farm Balance”. Circulating Balance sends the proceeds to your wallet, separate from Beanstalk. keeps the proceeds stored in Beanstalk which can save gas fees in future transactions. See for more information.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

After the transaction has been confirmed by the network, your Pod Listing will be shown on the page on the “Listings” tab, where you can check the status of your Pod Listing or cancel it.

If “Circulating Balance” was selected, the Beans will be in your wallet. Your Circulating Balance is also shown on the page.

If “Farm Balance” was selected, the Beans will be shown on the page.

Make sure you are on and .

Below “Overview”, switch to the Pod Order modal by selecting “Sell Now”. This view displays all the active Pod Orders, sorted by ascending .

Under “Destination”, select “Circulating Balance” or “Farm Balance”. Circulating Balance sends the proceeds to your wallet, separate from Beanstalk. keeps the proceeds stored in Beanstalk which can save gas fees in future transactions. See for more information.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

If “Circulating Balance” was selected, the Beans will be in your wallet. Your Circulating Balance is also shown on the page.

If “Farm Balance” was selected, the Beans will be shown on the page.

Bean vs LP Seed distribution, or more specifically, the , which determines the relative benefits of holding Bean exposure vs exposure to at least 1 particular LP token in the Silo over time; and

The Crop Scalar () is a scalar between 0 and 1 that is adjusted by the peg maintenance mechanism. The Crop Ratio has a minimum () and maximum value (). Currently, and are set to 1:2 (i.e., 50%) and 1:1 (i.e., 100%), respectively.

At , the Crop Ratio is at its minimum value (i.e., at 1:2, 1 Bean Deposited in the Silo receives half the amount of Grown Stalk as 1 BDV of the Max LP token), and at , the Crop Ratio is at its maximum value (i.e., at 1:1, 1 Bean Deposited in the Silo receives the same amount of Grown Stalk as 1 BDV of the the Max LP token).

Guides on participating in .

Beans can be bought and sold on the page. To transfer between Farm and Circulating balances, see .

Make sure you are on and .

Select “More” then “Swap” to navigate to the page.

In the first field select the input token, or the asset you would like to sell. The dropdown menu will show each available input token and your total and .

Farm Balance is the balance stored in Beanstalk, which can save gas fees in future transactions. See for more information.

Confirm the approval transaction in your wallet, and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

If “Farm Balance” was selected, the tokens will be shown on the page.

If “Circulating Balance” was selected, the tokens will be in your wallet. Your Circulating Balance is also shown on the page.

The page can be used to transfer tokens between a Farmer’s and and between wallets.

Make sure you are on and .

Select “More” then “Swap” to navigate to the page. Select the "Transfer" tab.

Confirm the approval transaction in your wallet, and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

If the “Destination” is “Farm Balance”, the tokens will be shown on the page.

If the “Destination” is “Circulating Balance”, the tokens will be in the destination wallet. The Circulating Balance is also shown on the page.

BeaNFTs can be viewed and minted on the page. See the for more info.

Make sure you are on and .

Select “More” then “BeaNFTs” to navigate to the page.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

After the transaction has been confirmed by the network, the minted BeaNFT(s) will be sent to your wallet. You can still view them on the page or on a site like .

BIP-50
app.bean.money
connect your wallet
verify
verify
Buy Pods
Sell Pods
Balances
connecting a wallet
app.bean.money
correct contract
Claim Silo Rewards guide
Asset States
app.bean.money
connect your wallet
correct contract
My Pod Market
Balances
Balances
app.bean.money
connect your wallet
correct contract
Balances
Balances
the Pod Market
Overview
Total Deposited Value
Quick Rinse / Quick Harvest
Rewards
Farm Balance / Circulating Balance
"Farm Balance" and "Circulating Balance" modules
Silo Rewards
List Pods
Fill Pod Order
LLL
YYY
ZZZ
YYY
ZZZ
BeanToMaxLPSeedRatio=Y+L(Z−Y)Bean To Max LP Seed Ratio = Y + L(Z - Y)BeanToMaxLPSeedRatio=Y+L(Z−Y)
L=0L = 0L=0
L=1L = 1L=1
Crop Ratio
Beanstalk governance
Vote on Governance Proposals
Delegate Votes
Swap
Transfer Farm Balance
app.bean.money
connect your wallet
Swap
Asset States
correct contract
correct contract
Balances
Balances
Trade Beans
Transfer Balances
app.bean.money
connect your wallet
Swap
correct contract
correct contract
Balances
Balances
Mint BeaNFTs
BeaNFTs
BeaNFT documentation
app.bean.money
connect your wallet
BeaNFTs
correct contract
BeaNFT
OpenSea

Asset States

Understanding the various states that Beanstalk assets can be in can help Farmers understand their balances on the Beanstalk UI.

Balances

Deposited Balances

Assets that are Deposited in the Silo.

Farm Balances

Assets stored in Beanstalk. Farm assets can be used in transactions on the Farm.

Circulating Balances

Beanstalk assets in your wallet.

Bean states

Pooled Beans

Beans in all liquidity pools. The Beanstalk UI does not include Beans that make up Ripe BEAN:wstETH under this category.

Deposited Beans

Beans Deposited in the Silo. Includes Earned Beans.

Farm Beans

Beans stored in Beanstalk. Farm Beans can be used in transactions on the Farm.

Circulating Beans

Beans in Farmers’ wallets.

Ripe Beans

Beans that are minted as Fertilizer is sold. Unripe Beans represent a pro rata share of underlying Ripe Beans. The Beanstalk UI does not include Beans that make up Ripe BEAN:wstETH under this category.

Ripe Pooled Beans

Pooled Beans that make up Ripe BEAN:wstETH.

Earned Beans

Beans that have been paid to a Silo Member since the last Season the Silo Member Planted their Plantable Seeds. Upon Plant, Earned Beans are Deposited in the current Season.

Harvestable Pods

Pods that are redeemable for 1 Bean each. Harvestable Pods must be Harvested in order to use them.

Rinsable Sprouts

Sprouts that are redeemable for 1 Bean each. Rinsable Sprouts must be Rinsed in order to use them.

LP Token states

LP Tokens can be in the following states, which are identical to the equivalent Bean states described above:

  • Deposited

  • Farm

  • Circulating

  • Ripe

Unripe asset states

Unripe assets can be in the following states, which are identical to the equivalent Bean states described above:

  • Deposited

  • Farm

  • Circulating

Stalk states

Earned Stalk are Stalk earned from Earned Beans. Earned Stalk automatically contribute to Stalk ownership and do not require any action to claim them.

Grown Stalk is the Stalk earned from Seeds. Grown Stalk does not contribute to Stalk ownership until it is Mown. Mow can be called on its own, and it is also called at the beginning of any Silo interaction (Depositing, Withdrawing, Converting, etc.).

Seed states

Plantable Seeds are Seeds earned in conjunction with Earned Beans. Plantable Seeds must be Planted in order to grow Stalk.

Delegate Votes

  1. Under the "DAO", "Beanstalk Farms" and "Bean Sprout" tabs the Stalk you own and any Stalk that has been delegated to you is shown. Under the "BeanNFT DAO" tab the BeaNFTs you own and any BeaNFTs that have been delegated to you is shown.

  2. To delegate your Stalk or BeaNFTs to another Farmer, select "Delegate your [Stalk/BeaNFT] votes to another Farmer on [Snapshot space]".

    • If Farmer A delegates to Farmer B and both of them vote, then the delegated voting power is not calculated—in this instance the votes of the two Farmers will be calculated as if the delegation did not happen. The vote of B will be counted if A does not vote.

  3. Select "Set Delegate".

  4. After the transaction has been confirmed by the network, the Delegation page for the Snapshot space you delegated will reflect the delegation.

    • Stalk must be delegated on each Snapshot space individually.

Tractor

Tractor is currently not supported in the Beanstalk UI.

Maintaining and optimizing a position in Beanstalk requires manual intervention (Mowing, Planting, Harvesting Pods and Depositing the Beans, etc.). Smaller Farmers do not necessarily have the resources to automate the execution of their Beanstalk transactions, and existing generalized function call systems (i.e., smart contract accounts, Depot + Pipeline) only support the use of assets from the sender of the transaction.

Tractor is a peer-to-peer transaction marketplace that allows third party operators to perform Beanstalk actions on behalf of a Farmer.

Blueprints contain the Publisher, an Advanced Farm function call containing an arbitrary sequence of internal function calls, a set of copy instructions that define how to interpret Operator calldata, expiry parameters and the EIP-712 signature from the Publisher. Any Tractor Operator can execute any Blueprint with any calldata at anytime through the tractor(...) function provided that the Blueprint does not revert.

Junctions are contracts that are contain basic operations as external functions that are used by Tractor orders. Junctions allow Farmers to define Blueprints that will fail under a predefined set of conditions, such as balance limits, price thresholds, etc.

Examples

  • A Farmer creates a Blueprint for an Operator to Plant on their behalf any time they have more than 100 Earned Beans and will pay the caller 1 Earned Bean.

  • A Farmer creates a Blueprint for an Operator to Mow on their behalf any time that P > 1 and will pay the caller 5 USDC.

Stablecoin Overview

What is a Stablecoin?

A stablecoin is a fungible asset intended to maintain low price volatility relative to an arbitrary value peg. Oftentimes, stablecoins are pegged to the price of an off-chain currency.

A currency’s utility is a function of:

  • Trustlessness;

  • Carrying costs;

  • Low volatility; and

  • Liquidity.

The history of money tells a story of markets seeking out the least volatile assets to use as currency. The relatively brief history of DeFi tells the same story.

What is the Problem with Current Implementations of Stablecoins?

While the market has demonstrated clear demand for low volatility blockchain-native assets, the vast majority of current implementations suffer from a variety of risks and drawbacks, primarily with regard to a lack of trustlessness, negative carrying costs and thin liquidity. In other words, the only utility that has been created by current stablecoin implementations is low volatility. The absence of a decentralized currency with competitive carrying costs and deep liquidity is the main issue – in addition to high blockchain transaction costs – holding businesses producing real economic activity back from adopting decentralized financial primitives.

Businesses built exclusively on decentralized primitives have struggled to compete with businesses built on centralized financial systems like fiat USD because DeFi lacks a trustless and liquid currency with sufficiently low price volatility and competitive carrying costs.

Stablecoin Features

Current implementations of stablecoins can be conceptualized along the following three axes: value source, convertibility and network nativity.

1. Value Source: Exogenous value vs. Endogenous value

Stablecoin value can come from exogenous assets or endogenous value creation.

A stablecoin with exogenous value is one whose value is derived from another asset or basket of assets which are held by the issuer as collateral. Reliance on exogenous value generates opportunity costs associated with collateral requirements, which creates non-competitive carrying costs.

A stablecoin with endogenous value is one whose value is derived from demand for the currency. Endogenous value has the potential to facilitate the creation of trustless currency with low price volatility, competitive carrying costs and deep liquidity.

2. Convertibility: Convertible vs. Non-convertible

Convertibility is the option to exchange an asset for its underlying collateral.

A convertible stablecoin protocol is one that facilitates convertibility between its stablecoin and its underlying collateral. Arbitrage opportunities created by convertibility ensure that the stablecoin price is rarely above or below the value of the underlying collateral, once frictions around convertibility are accounted for. Convertibility comes at the expense of low liquidity and non-competitive carrying costs because of the opportunity cost associated with locking up collateral to facilitate it.

A non-convertible stablecoin protocol is one that does not facilitate convertibility between its stablecoin and any form of underlying collateral. It is impossible to keep a stablecoin price equal to its value peg at all times without low-friction convertibility. Non-convertible stablecoin protocols without collateral requirements have the potential to create endogenous value that facilitates trustlessness, competitive carrying costs and deep liquidity at the expense of volatility.

3. Network Nativity: Network-native vs. Non-network native

Network nativity refers to the source of a stablecoin’s value with regard to its network.

A network-native stablecoin is one that derives its value exclusively from the network to which it is native. Network-nativity eliminates most points of centralization from a stablecoin’s value chain.

A non-network-native stablecoin is one that does not exclusively derive its value from the network to which it is native. Non-network-nativity requires a custodian that facilitates a bridge to the network, which can introduce significant costs, complexities and points of centralization.

BCM Dashboard

The Beanstalk contract is guarded by a 5-of-9 multisig. This means any changes to the Beanstalk contract must be approved by at least 5 of the 9 signers.

BCM Signers

Signer Hashes

Glossary

Barn

Barn Raise

Bean Denominated Value (BDV)

Bean Sprout (BS)

Bean Sprout Multisig (BSM)

Bean

The ERC-20 fiat stablecoin issued by Beanstalk.

Beanstalk

The Ethereum-native, decentralized fiat stablecoin protocol that issues Beans.

Beanstalk Community Multisig (BCM)

Beanstalk Farms (BF)

Beanstalk Farms Budget Proposal (BFBP)

Beanstalk Farms Committee (BFC)

Beanstalk Farms Committee Proposal (BFCP)

Beanstalk Farms Multisig (BFM)

Beanstalk Immunefi Committee (BIC)

Beanstalk Immunefi Responses (BIR)

Beanstalk Improvement Proposal (BIP)

Beanstalk Operations Proposal (BOP)

Cancel

Chop

Chop Penalty

Circulating Beans

Beans in Farmers' wallets.

Convert

Convert Whitelist

Crop Ratio

deltaB

The shortage or excess of Beans in a liquidity pool Beans trade in.

Delta Demand

Deposit

Deposit Whitelist

Deposited Assets

Depot

Earned Beans

Earned Stalk

Emergency Beanstalk Improvement Proposal (EBIP)

Enroot

Farm

Farm Assets

Farmers

Users of Beanstalk.

Fertilize

Fertilizer

Field

FIFO

Fill

Flood

Gauge Points

Germination

gm

Grown Stalk

Harvest

Redeem Harvestable Pods for 1 Bean each.

Harvestable Pods

Humidity

Jack

Liquidity to Supply Ratio (L2SR)

Represents the Beanstalk liquidity level relative to the Bean supply. The L2SR is a useful indicator of Beanstalk's health.

Liquidity Weight

Maximum Temperature

Minting Whitelist

Morning

Mow

Ordered Beans

Pari passu

Pause

Pipeline

Plant

Plantable Seeds

Plot

Pod Line

Pod Listing

Pod Market

Pod Order

Pod Rate

Pods

Publius

The pseudonym of Beanstalk’s founders.

Real Rate of Return (RRoR)

The return for Sowing Beans, accounting for the Bean price. RRoR = (1 + Temperature) / TWAP.

Replant

The relaunch of Beanstalk post-exploit.

Revitalized Stalk

Revitalized Seeds

Rinsable Sprouts

Rinse

Redeem Rinsable Sprouts for 1 Bean each.

Ripe Assets

Ripen

Season

Seed Gauge System

Seeds

Silo

Silo Members

Silo Rewards

Soil

Sow

Sprouts

Stalk

Stalkholders

Holders of the Stalk token. Stalkholders participate in governance and earn Bean seigniorage.

Sun

Target Seasons to Catch Up

Temperature

Toolshed

Total Value Deposited (TVD)

Tractor

Transfer

Unpause

Unripe Assets

urBEAN

Voting Period

Withdraw

Audits

Basin

Basin is a composable EVM-native decentralized exchange protocol.

Well designed open source protocols enable anyone to (1) compose existing components together, (2) develop new components when existing ones fail to meet the needs of users or are cost-inefficient and (3) verify the proper use of existing components in a simple fashion. Basin allows for anyone to compose new and existing (1) Well Functions (i.e. exchange functions), (2) Pumps (i.e., network native oracles) and (3) Well Implementations (i.e., exchange implementations) to create a Well (i.e., a customized liquidity pool). Aquifers (i.e., Well registries) store a mapping from Well addresses to Well Implementations to enable verification of a Well Implementation given a Well address.

Links

Field page
Barn page
Farm Balance
Asset States
Asset States
Asset States
Pod Market
Swap

Revitalized Stalk are Stalk that have vested for Unripe asset holders. Revitalized Stalk are minted as the BDV of Unripe assets increases. Revitalized Stalk does not contribute to Stalk ownership until Enrooted. See the section of the page for more info.

Revitalized Seeds are Seeds that have vested for Unripe asset holders. Revitalized Seeds are minted as the BDV of Unripe assets increases. Revitalized Seeds do not generate Stalk until Enrooted. See the section of the page for more info.

and can delegate their Stalk and BeaNFTs in the , , and Snapshot spaces to any other Farmer. The delegate can then vote on their behalf in governance proposals. Stalk must be delegated on each Snapshot space individually.

Make sure you are on and .

Select “More” then “Governance” to navigate to the page.

Enter the address to delegate to. View delegate applications on the or you may delegate to any Arbitrum address.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

You can also verify your delegations on .

Blueprints are off-chain data structures that are signed to verify the intent of the publishing Farmer. Blueprints allow Farmers to define arbitrary sequences of on-chain function calls, which can be executed permissionlessly by other Farmers known as Tractor Operators.

Low volatility is essential to the utility of a currency. Without looking at the theoretical reasons for why this is the case, the market has clearly demonstrated its value. Since its inception with the creation of Tether – a historically very – in 2014, the stablecoin industry has grown from a fringe backwater to a decentralized finance (“DeFi”) behemoth.

For example, historically, have significantly exceeded . Until network-native borrowing rates are comparable to or lower than off-chain borrowing rates, DeFi will continue to struggle to attract meaningful economic activity away from TradFi.

The Beanstalk Community Multisig (BCM) custodies ownership of the . The BCM has the exclusive ability upgrade Beanstalk. In the future, it is expected that BIPs will remove governance entirely, revoking these abilities from the BCM.

Beanstalk Community Multisig Safe address:

Publius currently holds 1 of the 9 keys on the BCM. The identities of the remaining signers are anonymous per .

See the page for more information on how the BCM is verifying transactions.

Address
Verifications
Date of Last Verification

Signers hashes are published from , the address that Publius used to on August 6, 2021.

Check out the page to better understand your on the Beanstalk UI.

The Beanstalk recapitalization facility being used to Beanstalk. Read more .

A fundraiser to restore $77M in non-Bean liquidity stolen from the in the April 2022 governance exploit. Participants in the Barn Raise receive and .

The value of an asset denominated in Beans. Used to calculate how many and are rewarded to Depositors of a whitelisted asset. Abbreviated as BDV.

A Beanstalk accelerator program to facilitate development on and around Beanstalk in a decentralized fashion. Read more .

The multisig that custodies the Bean Sprout budget funds. Abbreviated as BSM. Read more .

The multisig that will custody ownership of the Beanstalk contract until on-chain governance can be reimplemented. The BCM will be able to propose and execute upgrades to Beanstalk. Abbreviated as BCM. Read more .

A decentralized team of core contributors to Beanstalk, operating across the stack on technical and non-technical problems. Read more .

A proposal related to the use of the Beanstalk Farms budget. Abbreviated as BFBP. Read more .

The group of Beanstalk Farms contributors that has discretion over the Beanstalk Farms budget, including contributor compensation. The Beanstalk Farms Committee hires and dismisses contributors at Beanstalk Farms. Abbreviated as BFC. Read more .

A proposal related to the Beanstalk Farms Committee. Abbreviated as BFCP. Read more .

The multisig that custodies the Beanstalk Farms budget funds. Abbreviated as BFM. Read more .

A committee to determine the categorization and payout of bug bounties in accordance with the bug bounty program. Read more .

Responses to bug reports on Immunefi in accordance with the bug bounty program. Read more .

A proposal to change Beanstalk. Abbreviated as BIP. Read more .

A proposal for having the Beanstalk DAO vote on things other than protocol changes. Abbreviated as BOP. Read more .

Remove a or from the .

Burning in exchange for underlying . Read more .

The percentage claim to future forfeited by .

Changing one asset for another within the . Read more .

The generalized whitelist that determines which within the are permitted under certain conditions. Read more .

Determines the relative benefits of holding Bean exposure vs exposure to at least 1 particular LP token in the Silo over time. More specifically, the ratio of Seed rewards between Beans and the LP token with the highest Gauge Points per BDV. Adjusted via the Seed Gauge System. Read more .

The ratio of the change in over the prior two . Used to measure .

Assets on the can be Deposited in the at any time to earn and . Read more .

The whitelist of ERC-20 tokens that can be Deposited in the Silo. Any ERC-20 token can be added or removed from the Deposit Whitelist via governance. Beans are always whitelisted. Read more .

Assets Deposited in the .

The component of the that facilitates interactions with other protocols through Beanstalk in a single transaction. Read more .

Beans that have been paid to a since the last the Silo Member their . Upon Plant, Earned Beans are .

earned from Earned Beans. Earned Stalk automatically contribute to Stalk ownership and do not require any action to claim them.

An emergency proposal to change Beanstalk that is decided on and committed by the . Abbreviated as EBIP. Read more .

Adds and to your and balances, respectively.

The Beanstalk ecosystem. The Farm has five primary components: the , , , , and .

Assets stored in Beanstalk. Farm Assets can be used in transactions on the and may be more gas efficient than . Read more about .

are Fertilized by Active Fertilizer, at which point they become .

An ERC-1155 token that Beanstalk mints in exchange for USDC. Fertilizer comes with , which represent debt to be repaid by Beanstalk in the form of new Beans. Fertilizer has no fixed maturity. Fertilizer can be Available, Active or Used. Read more .

The Beanstalk credit facility. Read more .

First in, first out. become on a FIFO basis. This means that Pods closer to the front of the become Harvestable before Pods farther back in the Pod Line.

Match a with an overlapping .

If P > 1 over the previous and the is less than 5%, there is a Flood. At the beginning of a Season where it Floods, Beanstalk mints additional Beans and sells them in Wells on the .

Determine issuance across various LP tokens.

Germinating are Deposits that are <2 gm calls old. Germinating Deposits can be or , but cannot be . Germination exists to add flash loan and inter-block MEV manipulation resistance to the calculation of Deposited . By preventing the accrual of for 1 full , Beanstalk further disincentivizes inorganic demand.

Beanstalk accepts one gm function call every . Upon the gm call, Beanstalk , , distributes Beans to , adjusts the , etc.

earned from . Grown Stalk does not contribute to Stalk ownership until it is . Mow can be called on its own, and it is also called at the beginning of any interaction (, , , etc.).

that are redeemable for 1 Bean each. Harvestable Pods must be Harvested in order to use them.

The interest rate on purchases. Read more .

chopped down Beanstalk on April 17, 2022.

The portion of liquidity in a whitelisted liquidity pool that counts towards the calculation.

The maximum Beanstalk is willing to offer during a . Read more .

The whitelist of liquidity pools whose are summed to calculate a cumulative deltaB. Read more .

The first 25 blocks of each .

Mowing adds it to your balance. Called upon any interaction with the .

Beans stored in .

Fertilizer is paid back on a pari passu basis. Active Fertilizer Fertilizes a pro-rata portion of Sprouts, by Fertilizer. This is in contrast to the first in, first out (FIFO) schedule of the in the .

Temporarily prevent the function call from being accepted. Read more .

A sandbox contract that can execute an arbitrary number of actions within the EVM from an EOA in a single transaction (see more on the page). Note that this also currently refers to functionality in Beanstalk that is a channel from the to another protocol. Pipelines can be added to the Depot via Beanstalk governance. Read more .

Planting adds Plantable Seeds to your total balance.

earned in conjunction with . Plantable Seeds must be Planted in order to grow .

that grow from Beans that were in the same transaction form a Plot.

The order will become based on the Harvest schedule.

An offer to sell on the . Read more .

The decentralized, trustless market that can be bought and sold on. Read more .

An order to buy on the . Read more .

The Beanstalk debt level ( supply) relative to the Bean supply. The Pod Rate is often used as a proxy for Beanstalk's health.

The Beanstalk-native debt asset, redeemable for 1 Bean each once into . Read more .

that have vested for Unripe asset holders. Revitalized Stalk are minted as the BDV of Unripe assets increases. Revitalized Stalk does not contribute to ownership until . Read more .

that have vested for Unripe asset holders. Revitalized Seeds are minted as the BDV of Unripe assets increases. Revitalized Seeds do not generate until . Read more .

that are redeemable for 1 Bean each. Rinsable Sprouts must be Rinsed in order to use them.

Assets that are minted as is sold. represent a pro rata share of underlying Ripe assets.

When passively turn into , they Ripen.

Seasons are Beanstalk-native time. Every Season is approximately 1 hour. Each Season begins when the function is successfully called on Ethereum.

The component of Beanstalk responsible for dynamically adjusting the rewards for different assets whitelisted in the . Read more .

An internal token that yields 1/10000 every Season.

The Beanstalk DAO. Read more .

in the Silo.

Rewards earned by Silo Members in the form of , , , , , and . Read more .

The current number of Beans that can be in exchange for . Read more .

Lend. Used in the context of Sowing Beans, or lending Beans to Beanstalk when there is .

Sprouts represent how many Beans there are left to be earned from .

The Beanstalk governance token. Stalk entitles the holder to a pro rata share of future Bean mints and participation in Beanstalk governance. Read more .

The component of the Farm that keeps time in and incentivizes cost-efficient and timely calling of the function. Read more .

Determines the target number of for a new with an average number of to catch up to the average per of existing Deposits at the time of Deposit.

The interest rate for Beans. Read more .

The Toolshed offers a suite of tools for efficient use of Beanstalk and other Arbitrum-native protocols. Read more .

The value of assets Deposited in the . Abbreviated as TVD.

A peer-to-peer transaction marketplace that allows third party operators to perform Beanstalk actions on behalf of a Farmer. Read more .

Moving , or from one address to another. Deposits can be Transferred without the loss of , , or Stalk from Seeds. Assets can be transferred between and .

Resume the acceptance of function calls. When Beanstalk is Unpaused, the gm function can be called at the beginning of the next hour.

Unripe assets represent a pro rata share of minted as is sold and debt is repaid to Fertilizer. Read more .

Unripe Beans. See .

The time interval in which a (BIP) is considered by . Read more .

can be Withdrawn from the at any time. The number of , , and Stalk from Seeds rewarded for a Deposited asset must be forfeited upon its Withdrawal from the Silo. Read more .

Codehawks completed its audit of on August 9, 2024, identifying 8 findings. The final report can be found .

Codehawks completed its audit of on May 30, 2024, identifying 4 findings. The final report can be found .

Codehawks completed its audit of on May 4, 2024, identifying 8 findings. The final report can be found .

Codehawks completed its audit of on April 6, 2024, identifying 8 findings. The final report can be found .

completed its audit of on October 13, 2023, identifying 16 findings that were solved or acknowledged prior to the release of the report. The final report can be found .

Cyfrin complete its audit of on September 12, 2023, identifying 63 findings. The final report can be found .

completed its audit of on July 24, 2023, identifying 3 findings that were solved or acknowledged prior to the release of the report. The final report can be found .

Halborn completed its audit of on June 30, 2023, identifying 4 findings that were solved or acknowledged prior to the release of the report. The final report can be found .

Halborn completed its audit of on April 18, 2023, identifying 2 findings that were solved prior to the release of the report. The final report can be found .

Halborn completed another audit of on December 13, 2022, identifying 12 findings that were solved or acknowledged prior to the release of the report. The final report can be found .

Halborn completed its audit of on December 1, 2022, identifying 9 findings that were acknowledged prior to the release of the report. The final report can be found .

Halborn completed its audit of on November 4, 2022, identifying 3 findings that were solved prior to the release of the report (one additional issue was reported by Beanstalk Farms). The final report can be found .

Halborn completed its penetration testing of the on October 19, 2022, identifying 5 findings that were solved or acknowledged prior to the release of the report. The final report can be found .

Halborn completed its audit of on September 23, 2022, identifying 5 findings that were solved or acknowledged prior to the release of the report. The final report can be found .

completed its audit of on July 22, 2022, identifying 13 findings that were solved or acknowledged prior to the release of the report. The final report can be found and the fix review can be found .

Halborn completed its audit of on July 13, 2022, identifying 17 findings that were solved or acknowledged prior to the release of the report. The final report can be found .

completed its audit of on April 2, 2022, identifying 8 findings using statistical analysis and 68 findings during the manual review. All 76 findings were promptly alleviated prior to the release of the audit report. The final report can be found .

All audit reports are uploaded to the .

Website:

Basin Whitepaper:

Multi Flow Pump Whitepaper:

Basin GitHub:

Discord:

Twitter:

Docs:

Halborn Audit Report:

Cyfrin Audit Report:

Code4rena Audit Report:

Stalkholders
BeaNFT holders
beanstalkdao.eth
beanstalkfarms.eth
wearebeansprout.eth
beanft.eth
app.bean.money
connect your wallet
Governance
Beanstalk Discord
correct contract
Snapshot
Barn
Revitalized Assets
Barn
Revitalized Assets
the previous section
deltaB
Minting Whitelist
deltaB
deltaB
FIFO
pari passu
deltaB
deltaB
deltaB
deltaB
BDV
Seasons
gm
Sowing Beans
Pod Rate
Delta Demand
Transferred
Silo Deposits
Earned Beans
Planting
Unripe Assets
Chop Penalty
Stalk
Seeds
Withdraw
Season
Silo Rewards
Plantable Seeds
Grown Stalk
Mown
Revitalized Stalk
Fertilizer
Enrooted
Revitalized Seeds
Grown Stalk
Plantable Seeds
Earned Beans
Earned Stalk
Enrooting
Transferred
Pod Line
deltaB
pari passu
Stalk
BIPs
Seeds
Grown Stalk
Mown
Pods
Harvestable
FIFO
Pod Line
Sprouts
Fertilizer
Rinsable
pari passu
Earned Beans
Planting
Unripe Assets
Chop Penalty
BDV
Earned Stalk
Revitalized Stalk
Fertilizer
Enrooted
Plantable Seeds
Planted
Revitalized Seeds
Rinsable Sprouts
Harvestable Pods
Circulating Balance
Farm assets
Pod Listings
Pod Orders
Farm Balance
Place in Line
Farm Balance
Farm Balance
Circulating Balance
Farm Balance
Circulating Balance
Anonymous Signers
LogoSafe{Wallet}safe
EIP-712
low volatility asset
$150B market cap
borrowing rates on USD stablecoins
borrowing rates on fiat USD
Beanstalk contract
0xDd5b31E73dB1c566Ca09e1F1f74Df34913DaaF69
BCM Verification
0x925753106fcdb6d2f30c3db295328a0a1c5fd1d1
deploy Beanstalk
05/24/2024 Signer Hash
07/22/2023 Signer Hash
09/16/2022 Signer Hash
06/13/2022 Signer Hash
06/06/2022 Signer Hash
Asset States
Balances
here
here
here
here
here
here
here
here
Jack
here
here
here
BIP-50
here
BIP-49
here
BIP-48
here
BIP-45
here
Cyfrin
BIP-38
here
Beanstalk
here
Halborn
BIP-37
here
BIP-36
here
BIP-34
here
Beanstalk
here
BIP-30
here
BIP-29
here
Beanstalk UI
here
BIP-24
here
Trail of Bits
Beanstalk
here
here
Beanstalk
here
Omniscia
Beanstalk
here
Beanstalk Audits GitHub repo
https://basin.exchange
https://basin.exchange/basin.pdf
https://basin.exchange/multi-flow-pump.pdf
https://github.com/BeanstalkFarms/Basin
https://basin.exchange/discord
https://twitter.com/basinexchange
https://docs.basin.exchange
https://basin.exchange/halborn-basin-audit.pdf
https://basin.exchange/cyfrin-basin-audit.pdf
https://code4rena.com/reports/2023-07-basin
Beanstalk Community Multisig (BCM)
here
here
Replant
Silo
Fertilizer
Sprouts
Stalk
Seeds
Pod Order
Pod Listing
Pod Market
Ripe assets
Chopping
Silo
here
Farm
Silo Member
Season
Planted
Plantable Seeds
Deposited
Stalk
Revitalized Stalk
Seeds
Stalk
Seed
Sun
Silo
Field
Market
Depot
Asset States
Farm
Circulating Assets
Sprouts
Rinsable Sprouts
Pods
Harvestable
Pod Line
Pod Listing
Pod Order
Flood Whitelist
Season
Pod Rate
Grown Stalk
Deposits
Withdrawn
Transferred
Converted
BDV
Earned Beans
Season
Season
Ripens Pods
Fertilizes Sprouts
Stalkholders
Temperature
Stalk
Seeds
Mown
Silo
Depositing
Withdrawing
Converting
Pods
Liquidity to Supply Ratio
here
Temperature
Season
Season
Grown Stalk
Stalk
Silo
Pod Orders
Harvest
Pod Line
Field
here
Pipeline
Depot
Seed
Seeds
Earned Beans
Stalk
Pods
Sown
Pods
Harvestable
FIFO
Pod
Sprouts
Fertilizer
Unripe assets
Pods
Harvestable Pods
gm
here
Seed
Silo
Grown Stalk
Depositors
Soil
Fertilizer
here
Seasons
gm
Seasons
Deposit
Seeds
Grown Stalk
BDV
Silo
Deposits
Plots
Fertilizer
Stalk
Seeds
Farm Balances
Circulating Balances
gm
Unripe Assets
here
here
here
here
here
here
Unripe assets
Ripe assets
here
Sprouts
here
Fertilizer
here
Stalk
Stalk
Enrooted
here
Seeds
Stalk
Enrooted
here
Ripe assets
Fertilizer
here
Deposited
Silo
here
Conversions
Silo
here
Deposit Whitelist
Silo
Stalk
Seeds
here
here
Earned Beans
Earned Stalk
Grown Stalk
Revitalized Stalk
Plantable Seeds
Revitalized Seeds
here
here
Deposited assets
Silo
Stalk
Seeds
here
Soil
Seasons
Demand for Soil
deltaB’s
here
gm
here
Beanstalk Improvement Proposal
Stalkholders
here
Pods
Pod Market
here
Pods
here
Pods
Pod Market
here
Ripened
Harvestable Pods
here
Sown
Pods
here
Sowing
here
Beanstalk Analytics Links

07/20/24

07/26/24

05/30/24

10/04/24

10/02/24

05/30/24

07/25/24

10/04/24

10/05/24

Crop Ratio

However, with the successful addition of Conversions within the Silo in December 2021, a second peg maintenance mechanism was discovered. The ability to add and remove Beans from liquidity pools to decrease and increase the Bean price, respectively, changes the Bean price without any outflows or inflows from the system. Currently, Converts are limited in that Depositors can only Convert between Beans and LP tokens, and vice versa (i.e., not across LP tokens). Furthermore, the incentives for Converting in a given direction with respect to peg (in particular, Seed allocations to the various assets whitelisted for Deposit) are not adjusted autonomously in response to Beanstalk's state.

With the introduction of the Seed Gauge System, now Beanstalk also measures its liquidity level (in practice, the Liquidity to Supply Ratio, or L2SR).


In order to adjust the Crop Ratio, in practice Beanstalk adjusts a scalar (the Crop Scalar) between 0 and 1, where 0 results in the minimum Bean to Max LP Ratio and 1 results in the maximum Bean to Max LP Ratio. Therefore, the peg maintenance mechanism can adjust the Bean to Max LP Ratio independently of the minimum and maximum values (set to 50% and 100%, respectively).

Considering the current state and the liquidity level, Beanstalk adjusts the Crop Scalar to move toward the optimal state:

Excessively Low L2SR

No matter the L2SR, when P > Q, Beanstalk should maximally incentivize Converting to LP Deposits by aggressively decreasing the Crop Ratio. By decreasing the scalar by 0.5 each Season, the Crop Ratio returns to the minimum value within 2 Seasons.

When L2SR is excessively low, in all cases, Beanstalk should be similarly aggressive in incentivizing Conversions to LP Deposits by quickly reaching the minimum Crop Ratio.

Reasonably Low L2SR

When the L2SR is reasonably low and Pod Rate is low, Beanstalk should be similarly aggressive in reaching the minimum Crop Ratio given that, at the margin, Beanstalk would rather take on debt than lose liquidity. When the L2SR is reasonably low and Pod Rate is high, Beanstalk should gradually increase the Crop Ratio when P > 1 (to incentivize Conversions above peg) and gradually decrease it when P < 1 (to incentivize Conversions below peg). By changing the scalar by 0.01 each Season, the Crop Ratio can change from the maximum to the minimum value (or vice versa) within 100 Seasons.

Reasonably High L2SR

When L2SR is reasonably high and P < 1, Beanstalk should similarly gradually increase the Crop Ratio to incentivize Converting from LP Deposits to Bean Deposits, and vice versa when P > 1.

Excessively High L2SR

When L2SR is excessively high, Beanstalk should be more willing to accept a loss of liquidity rather than an increase in debt level at the margin. Therefore, it should adjust the Crop Scalar just as it does when L2SR is reasonably high, except it can be slightly more aggressive when P < 1 and the Pod Rate is high. By increasing the Crop Scalar by 0.02, the Crop Ratio can change from the minimum to the maximum value within 50 Seasons.

Links

Development

Pipeline

Basin

Analytics

Listings

Documentation

Notion

Security

Governance

Social

Recordings and Meeting Notes

OpenSea

Inactive

Contracts

Arbitrum

Beanstalk

Contract
Address

Beanstalk

Bean ERC-20 Token

Unripe Bean ERC-20 Token

Unripe LP ERC-20 Token

Deposit ERC-1155 Token

Fertilizer ERC-1155 Token

Fertilizer Implementation

Shipment Planner

Deposit Whitelist

Contract
Address

Bean ERC-20 Token

BEAN:WETH LP Token

BEAN:wstETH LP Token

BEAN:weETH LP Token

BEAN:WBTC LP Token

BEAN:USDC LP Token

BEAN:USDT LP Token

Unripe Bean ERC-20 Token

Unripe LP ERC-20 Token

Facets

Non-Bean Assets

Contract
Address

WETH

wstETH

weETH

WBTC

USDC

USDT

Oracles

Contract
Address

ETH/USD Chainlink Data Feed

LSD Chainlink Oracle

wstETH/ETH Chainlink Data Feed

weETH/ETH Chainlink Data Feed

WBTC/USD Chainlink Data Feed

USDC/USD Chainlink Data Feed

USDT/USD Chainlink Data Feed

Multisigs

Contract
Address

TBD

Hypernative

Contract
Address

Ecosystem

Contract
Address

Misc.

Contract
Address

Bean Price Contract

Junctions

Unwrap and Send ETH Helper

Ethereum L1

Beanstalk on L1

Contract
Address

L1 Beanstalk

BeaNFTs on L1

Contract
Address

BeaNFT Winter Admin

BeaNFT Winter Implementation

BeaNFT Barn Raise Implementation

BeaNFT Basin Implementation

Contracts on L1

Contract
Address

Q4 2021 Budget

Old Bean Price Contract

Old USD Oracle Contract

Base Fee Contract

InitMint Contract

Unwrap and Send ETH Junction

Hypernative Module

Hypernative EOA

Beanstalk Community Multisig (BCM)

Beanstalk Farms Multisig (BFM)

Beanstalk Immunefi Committee Multisig (BICM)

Immunefi Vault

Beanstalk Farms Subgraph Multisig (BFSM)

Fertilizer Admin

Fertilizer Implementation

Deprecated L1 Contracts

The addresses below refer to pre-L2 migration tokens. Do not buy these tokens. A new Bean token was issued on Arbitrum—you can find it at the top of this page.

Contract
Address

Previous Bean ERC-20 Token

Previous Unripe Bean ERC-20 Token

Previous Unripe LP ERC-20 Token

Previous Fertilizer ERC-1155 Token

Previous BEAN:WETH Well LP Token

Previous BEAN:wstETH Well LP Token

Previous BEAN:3CRV LP Token

Pre-Exploit Contracts on L1

The addresses below refer to the exploited Bean token (0xDC59). Do not buy these tokens. A new Bean token was issued at Replant—you can find it at the top of this page.

Contract
Address

Content

Beanstalk Farms Authored Articles

Publius Authored Articles

Community Authored Content

Podcasts

Media

Discord Roles

Farmers in the Beanstalk Discord can earn various roles. Roles are given out based on the following criteria at the discretion of the Mods.

Publius

The pseudonym of Beanstalk’s founders.

Mods

Community members that enforce the Discord rules and update roles at their discretion. Mods are selected by Beanstalk Farms.

Contributors

Beanstalk contributors.

Master Farmer

Expert Farmer

A Farmer that has demonstrated an extensive understanding of Beanstalk through their commitment to answering questions and helping Farmers in their Beanstalk journey.

BeaNFT Club Member

A Farmer who has a BeaNFT and has verified in the (# • collabland-join) channel in Discord.

Journeyman Farmer

A Farmer who is a longtime community member and has contributed to multiple high quality discussions. Also given to community members who have hosted podcasts, Twitter spaces or other events about Beanstalk.

Humble Farmer

A Farmer that has demonstrated interest in and/or understanding of Beanstalk and participated in community discussions in a constructive fashion.

Local Farmer

A new Farmer who has accepted the rules and completed the Discord verification process.

Pipeline

Pipeline is a sandbox contract that can execute an arbitrary number of actions within the EVM from an EOA in a single transaction.

Pipeline enables the execution an arbitrary composition of valid actions within the EVM in a single transaction using Ether. Depot is a wrapper for Pipeline that supports (1) loading Ether and non-Ether assets into Pipeline, (2) using them and (3) unloading them from Pipeline, in a single transaction. Clipboard defines an Advanced Function Call (AFC) architecture that allows subsequent function calls to use the returnData of previous ones in a configurable fashion. The combination of Pipeline, Depot and Clipboard allows EVM users to perform arbitrary valid actions, through arbitrarily many protocols, in a single transaction.

Links

Bug Bounty

A bug bounty program with Immunefi was launched on October 11, 2022. This bug bounty program is focused on the Beanstalk smart contracts and preventing the loss of user funds. The maximum bounty is 1,100,000 Beans.

In order to be considered for the maximum potential reward, bug reports must come with (1) a Proof of Concept (PoC), and (2) code implementing the fix.

Bug reports that do not come with a PoC and code implementing a fix may qualify for a maximum of up to 30% of the potential reward outlined below, as determined by the Beanstalk Immunefi Committee (BIC). You can read more about the BIC here:

BFC Dashboard

BFC Members

There currently no BFC members.

BFM Dashboard

Beanstalk Farms budget funds are custodied by the Beanstalk Farms Multisig, or BFM. The BFM is deployed using Safe. Its m-of-n configuration is currently 4-of-7 on Arbitrum. This means any use of the budget funds must be approved by at least 4 of the 7 signers.

BFM Signers

The current BFM signers are as follows, in no particular order:

  • Michael Montoya

  • Brean

  • guy

  • sweetredbeans

  • mod323

  • aloceros

  • Cujo

The following Farmers serve as backup signers for the BFM, in no particular order:

  • pizzaman1337

  • CanadianBennett

  • MrMochi

Address

Economics

Ownership Concentration

Beanstalk does not require a pre-mine. The first 100 Beans are created when the init function is called to deploy Beanstalk.

Strong Credit

Beanstalk is credit based and only fails if it can no longer attract creditors. A reasonable level of debt, strong credit history and competitive interest rate attract creditors.

Marginal Rate of Substitution

Low Friction

By maximizing the efficiency of the Soil market, Beanstalk minimizes its cost to attract creditors, the durations and magnitudes of price deviations below its value peg, and excess Pod issuance.

Equilibrium

Equilibrium is a state of equivalent marginal quantity supplied and demanded. Beanstalk affects the supply of and demand for Beans to regularly cross the equilibrium price of 1 Bean over its value peg.

Incentives

Beanstalk-native financial incentives consistently increase trustlessness, stability and liquidity over time by coordinating independently financially motivated actors (i.e., Stalkholders and Sowers).

Beanstalk is governed by Stalkholders. Anyone with Stalk stands to profit from future growth of Beanstalk, but are not owed anything by Beanstalk.

When the Bean price is below $1, there is an incentive to Withdraw assets from the Silo. The combination of the Stalk System and Withdrawal Freeze reduces this incentive significantly.

Thus, Beanstalk consistently increases trustlessness, stability and liquidity over time.

BSM Dashboard

Bean Sprout is currently inactive.

Bean Sprout budget funds are custodied by the Bean Sprout Multisig, or BSM. The BSM is deployed using Safe. Its m-of-n configuration is currently 4-of-7 on Ethereum mainnet. This means any use of the budget funds must be approved by at least 4 of the 7 signers.

BSM Signers

The current BSM signers are as follows, in no particular order:

  • mistermanifold

  • guy

  • Bean Merchant

  • Brean

  • Michael Montoya

  • MarcoOnMulberry (ereal)

  • aloceros

The following Farmers serve as backup signers for the BSM, in no particular order:

  • mod323

  • sweetredbeans

Getting Started

Introductory guides on connecting to and interacting with Beanstalk.

Where to Begin?

Directory

The Beanstalk UI facilitates easy, fee efficient use of Beanstalk. The following guides have step-by-step walkthroughs for connecting to and interacting with Beanstalk on your desktop internet browser or mobile phone.

Getting Started

Sun

Silo

Field

Barn

Market

Balances

BeaNFTs

Swap

Governance

Unripe Assets

Beanstalk is a credit-based stablecoin protocol. The main goal of Beanstalk is to regularly oscillate the Bean price across $1, indefinitely. Beanstalk's primary peg maintenance mechanism, and theoretical basis for existence, is the (i.e., the Beanstalk credit facility). The ability for Beanstalk to borrow Beans from the open market at a reasonable interest rate is essential for long term peg maintenance.

At the beginning of each , Beanstalk changes the Crop Scalar depending on its position (, and ) with respect to its .

Beanstalk Farms , , ,

RadioDeFi , , ,

The Bean Pod , , ,

Beanstalk is a . You can explore the current list of Arbitrum Beanstalk facets on , an interface for inspecting Diamonds.

See

You can explore the current list of L1 Beanstalk facets on , an interface for inspecting Diamonds.

See

For more content, check out the page, the or the .

May 26th, 2022 —

June 29th, 2022 —

November 1st, 2022 —

January 1st, 2023 —

September 24, 2021 —

June 5th, 2022 —

January 6th, 2023 —

January 6th, 2023 —

August 11th, 2022 —

August 24th, 2022 —

September 9th, 2022 —

October 1st, 2022 —

April 22nd, 2022 —

April 27th, 2022 —

June 2nd, 2022 —

July 26th, 2022 —

July 27th, 2022 —

August 6th, 2022 —

August 6th, 2022 —

August 8th, 2022 —

August 8th, 2022 —

September 28th, 2022 —

September 29th, 2022 —

The most prestigious role a Farmer can achieve. Master Farmers have demonstrated a deep understanding of both the ethos of Beanstalk and the protocol itself. Also given to Nick Mudge, the creator of the .

Website:

Whitepaper:

Pipeline GitHub:

Halborn Audit Report:

You can find the bug bounty program and submit bug reports :

All vulnerabilities noted in (or otherwise known by the BIC or ) are not eligible for a reward.

The Beanstalk Farms Committee, or BFC, is the group of Beanstalk Farms contributors that has discretion over the Beanstalk Farms budget, including contributor compensation. The BFC hires contributors at and dismisses contributors from Beanstalk Farms. Read more .

Adding members to the BFC requires a BFCP-A and removing BFC members requires a BFCP-B. You can read more about BFCPs .

Beanstalk Farms Multisig Safe address:

Rotating BFM signers requires a (or ) unless a signer voluntarily leaves the BFM or for rotating in a backup signer.

Beanstalk is designed from economic first principles to create a useful trustless fiat currency. Over time, trustlessness, stability and liquidity increase, while decrease but remain competitive. The following principles inspire Beanstalk:

;

;

;

;

; and

.

A design that lowers the of Beans and Stalk over time is essential to censorship resistance.

Older have their diluted relative to newer Deposits every . Therefore, newly minted Beans are more widely distributed over time.

Beanstalk changes the to return the Pod Rate to the while regularly crossing the Bean price over its value peg. Beanstalk acts more aggressively when .

Beanstalk never defaults on debt (although in the event of Beanstalk no longer attracting creditors, the loan maturity date would become infinitely far in the future—see ). Beanstalk is willing to issue Pods every Season.

There are a wide variety of opportunities Beanstalk has to compete with for creditors. Therefore, Beanstalk does not define an optimal Temperature, but instead .

Minimizing the cost of using Beans and barriers to the maximizes utility for users and appeal to creditors. The realizes the full benefits of composability on Arbitrum.

The Pod Harvest schedule allows smaller to participate in peg maintenance and decreases the benefit of large scale price manipulation. The combination of non-expiry, the FIFO Harvest schedule, transferability and a enables Sowers to Sow Beans as efficiently as possible.

While Beanstalk can when the Bean price is above its value peg, Beanstalk cannot arbitrarily decrease the Bean supply when the Bean price is below it. Beanstalk relies on the codependence between the equilibria of Beans and Soil to work around this limitation.

In order to Sow Beans, they must be acquired (i.e., marginal demand for affects marginal demand for Beans). The marginal demand for Soil and Beans are functions of the Temperature and the Bean price. By , Beanstalk affects decreases in the Bean supply and changes in demand for Beans.

incentivizes (1) leaving assets Deposited in the Silo continuously by creating opportunity cost to assets from the Silo, (2) adding value to liquidity pools with Beans by than Deposited Beans, and (3) returning the Bean price to its value peg by allowing within the Silo without forfeiting Stalk.

When the Bean price is above $1, there is an incentive to buy Beans to earn a portion of the upcoming Bean seigniorage. This is exacerbated when the Pod Rate is lower. The commitment to automatically return the Bean price to its value peg and distribute proceeds from the sale to current Stalkholders based on Stalk ownership when the Farm became Oversaturated () and the Withdrawal Freeze, removes this incentive entirely during Seasons where the previous Season's Pod Rate was excessively low, and reduces it significantly otherwise.

Bean Sprout Multisig Safe address:

Rotating BSM signers requires a (or ) unless a signer voluntarily leaves the BSM or for rotating in a backup signer.

Address

New to Beanstalk? Learn the basics by reading and .

The is the authoritative source of protocol documentation while the is more accessible.

If you prefer audio content, check out the Beanstalk University recordings .

Ready to use Beans? Participate in Beanstalk and earn yield through different components of :

Silo: Earn yield and participate in Beanstalk governance by whitelisted assets. Silo Deposits earn a portion of new Bean mints. Learn more and how to .

Field: Earn yield by (lending) Beans to Beanstalk. Lenders receive , which are placed in a First In, First Out (FIFO) line that earns a portion of new Bean mints. Pods become (redeemable) at an indeterminate future time for a fixed number of Beans. Learn more and how to .

Barn: Earn yield and recapitalize Beanstalk with . Fertilizer earns a portion of new Bean mints up to a fixed return. Learn more and how to .

Market: Trade , the Beanstalk-native debt asset, redeemable for Beans. Learn more and how to .

Returning to Beanstalk as a pre-exploit Farmer? Your pre-exploit assets regain value in accordance with the success of the and growth of the Bean supply thereafter. Learn more and how to .

Have questions? for anything not covered in the Farmers' Almanac!

0x0451c257e4f5035532cd0bdc7ca1ad78487574c4
Etherscan
0x8078974b59204fbA16Fc0186E7a2CD8AF88eD600
Etherscan
0x66ddd36c7c211244117d2464cb90699caaeb78a5
Etherscan
0x44e05045853027c0e9b7ab03b33a42da6337faf7
Etherscan
0x47a473Eb2bDfe6599dac638FFFE0D427d8Ad6888
Etherscan
0xDdafb4ad2db5828199fae64878F848F75509Cae7
Etherscan
0x29f8f1edf070af11e7cdf5759010ec711411f538
Etherscan
0x25f32ae88e433770dd95e683b5f182a1e914e745
Etherscan
0x08ee6140804917e6f95334781597ee9ae3ecb13f
Etherscan
Field
Website
Beanstalk UI
Whitepaper
Discord
GitHub
Beanstalk State Space
Blog
Bug Bounty Program
Beanstalk GitHub
Beanstalk Protocol
Beanstalk UI
Beanstalk SDK
Beanstalk Subgraph
Bean Subgraph
Beanstalk SDK on npm
Beanstalk Py (Bot Tooling) Repo
Beanstalk Landing Page Repo
Pipeline Repositories
Basin Repositories
Beanstalk UI Analytics Page
Beanstalk Farms Dune
Beanstalk Dashboard
Bean on CoinGecko
Bean on DeFi Llama
Beanstalk on DeFi Llama
Farmers' Almanac (non-technical docs)
Beanstalk State Space
Farmers' Almanac Repo
Beanstalk Whitepaper Repo
Pipeline Whitepaper Repo
Beanstalk Governance Proposals Repo
Beanstalk Farms Operations Repo
Beanstalk Brand Assets Repo
Beanstalk Notion
Recordings
Past Community Grants
Bug Reports
BCM Verification
Immunefi Bug Bounty Program
Beanstalk Audits Repo
Beanstalk UI Governance Page
Beanstalk DAO Snapshot
Beanstalk Farms Snapshot
Beanstalk Farms Budget Snapshot
Beanstalk Bug Bounty Snapshot
BeaNFT DAO Snapshot
Beanstalk Discord
Beanstalk Twitter
Beanstalk Farms Twitter
Beanstalk Farms YouTube
Beanstalk Telegram
Beanstalk Telegram Tracker
Beanstalk Recordings
YouTube
Anchor
Spotify
Apple Podcasts
BeaNFT Genesis Collection
BeaNFT Winter Collection
BeaNFT Barn Raise Collection
BeaNFT Basin Collection
Fertilizer
Silo Deposits
Commonwealth
Reddit
TikTok
Layer3
BeaNFT Twitter
Bean Sprout Snapshot
Bean Sprout Twitter
Bi-Weekly Bean Newsletter
RadioDeFi Website
RadioDeFi Twitter
YouTube
Anchor
Spotify
Apple Podcasts
The Bean Pod Twitter
YouTube Playlist
Anchor
Spotify
Apple Podcasts
Bean Price Tracker Chrome Extension
ERC-2535 Diamond
Louper
Louper
Recordings
blog
Beanstalk Farms YouTube channel
Bank Runs, Airplanes, and Beanstalk
Water Clocks and the Beanstalk Helmsman
A Framework for Stablecoins
Beanstalk Farms' 2022 Roundup
🌱 Beanstalk 🤝 EIP-2535 💎
Thoughts Before the Barn Raise
Beanstalk Development Update
Worthless Tech
stablecoins.wtf Analysis
RadioDeFi
The Bean Pod
Beanstalk Songs
Hash Rate
MarketCapping
MissionDeFi
The Block Runner
Wall Street Journal
Wall Street Journal
CoinDesk
The Block
Blockworks
The Block
Decrypt
Blockworks
Cointelegraph
New York Times
Blockworks
EIP-2535 Diamond Standard
https://evmpipeline.org
https://evmpipeline.org/pipeline.pdf
https://github.com/BeanstalkFarms/Pipeline
https://bean.money/11-15-22-pipeline-halborn-report
here
BIC Process
BICM Dashboard
any audit reports in the Beanstalk Audits repository
BCM
0xd39A31e5f23D90371D61A976cACb728842e04ca9
Gini coefficient
Farm
Depot
Flood
Season
price
debt level
liquidity level
ideal equilibrium
arbitrarily increase the Bean supply
here
here
BOP
BIP
carrying costs
Low concentration of ownership
Strong credit
The marginal rate of substitution
Low friction
Equilibrium
Incentive structures determine behaviors of financially motivated actors
Conversions
The Stalk System
Withdraw
rewarding more Seeds to Deposited LP tokens
Deposits
Stalk from Seeds
Season
optimal Pod Rate
the Pod Rate is excessively high or low
Temperature
Sowers
liquid secondary market
FIFO
Disclosures
adjusts it to move closer to ideal equilibrium
changing the Temperature
Soil
LogoSafesafe
0xD1A0060ba708BC4BCD3DA6C37EFa8deDF015FB70
0xBEA0005B8599265D41256905A9B3073D397812E4
0x1BEA054dddBca12889e07B3E076f511Bf1d27543
0x1BEA059c3Ea15F6C10be1c53d70C75fD1266D788
0xD1A0060ba708BC4BCD3DA6C37EFa8deDF015FB70
0xFEFEFECA5375630d6950F40e564A27f6074845B5
0xFEFEFE2cfb089aEF0b0578573eF3CFAbC15f1490
0x555555987d98079b9f43CDcDBD52DbB24FfEEef5
0xBEA0005B8599265D41256905A9B3073D397812E4
0xBeA00Aa8130aCaD047E137ec68693C005f8736Ce
0xBEa00BbE8b5da39a3F57824a1a13Ec2a8848D74F
0xBeA00Cc9F93E9a8aC0DFdfF2D64Ba38eb9C2e48c
0xBea00DDe4b34ACDcB1a30442bD2B39CA8Be1b09c
0xBea00ee04D8289aEd04f92EA122a96dC76A91bd7
0xbEA00fF437ca7E8354B174339643B4d1814bED33
0x1BEA054dddBca12889e07B3E076f511Bf1d27543
0x1BEA059c3Ea15F6C10be1c53d70C75fD1266D788
0x82aF49447D8a07e3bd95BD0d56f35241523fBab1
0x5979D7b546E38E414F7E9822514be443A4800529
0x35751007a407ca6FEFfE80b3cB397736D2cf4dbe
0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f
0xaf88d065e77c8cC2239327C5EDb3A432268e5831
0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9
0x639Fe6ab55C921f74e7fac1ee960C0B6293ba612
0xCCCCCC35b53c8a16404Ae414AFa31F30A5B35626
0xb523AE262D20A936BC152e6023996e46FDC2A95D
0xE141425bc1594b8039De6390db1cDaf4397EA22b
0xd0C7101eACbB49F3deCcCc166d238410D6D46d57
0x50834F3163758fcC1Df9973b6e91f0F0F0434aD3
0x3f3f5dF88dC9F13eac63DF89EC16ef6e7E25DdE7
Beanstalk Community Multisig (BCM)
0xDd5b31E73dB1c566Ca09e1F1f74Df34913DaaF69
Beanstalk Farms Multisig (BFM)
0x390b023d316c2e92dd96A9bcC7fAe8dB12A2fBC1
Beanstalk Immunefi Committee Multisig (BICM)
0xd39A31e5f23D90371D61A976cACb728842e04ca9
Immunefi Vault
Hypernative Module
0xbBAd3c5D8B87Fd485c48d6Da7599FBBE33A079fe
Hypernative Response Wallet
0x5F0F0860DF2714f708B4a3C221C36658E3627203
Basin
Basin Docs
Pipeline
0xb1bE000644bD25996b0d9C2F7a6D6BA3954c91B0
Depot
0xdeb0f082ed3b0efe9257aea9f2e6e974aa4120c3
0xC218F5a782b0913931DCF502FA2aA959b36Ac9E7
0x5A5A5ADe4C9713172a5228703213d4D39608E2cD
0xD6Fc4a63d7E93267c3007eA176081052369A4749
0xC1E088fC1323b20BCBee9bd1B9fC9546db5624C5
BeaNFT DAO Multisig (BDM)
0x2D92a7Ba42472001111C1A1614EF6A8737bDf278
BeaNFT Genesis ERC-721 Token
0xa755A670Aaf1FeCeF2bea56115E65e03F7722A79
BeaNFT Winter ERC-721 Token
0x459895483556dad32526efa461f75e33e458d9e9
0x30980396e7A1C3b9272B948483694fAF057DB32B
0xd23CA44dAdf271C7f0d540a571864043C36c1F27
BeaNFT Barn Raise ERC-721 Token
0xa969bb19b1d35582ded7ea869cecd60a3bd5d1e8
0xa560c3afceb9a046573bf6f401134a6837f6d321
BeaNFT Basin ERC-721 Token
0x191b7D1CfA89c9389BbF5f7F49F4B8F93eC3740F
0x1DD0dEFe25dad4003DB39EBd618D3cCbAC288804
Beanstalk Budget Q4 2021
Ethical Return Contract
0xf96681781cd426d25dd3ee45fe77ba5763ae24e4
Bean Sprout Multisig (BSM)
0xb7ab3f0667eFF5e2299d39C23Aa0C956e8982235
0x4BEd6cb142b7d474242d87F4796387DEB9E1E1B4
0xb24a70b71e4cca41eb114c2f61346982aa774180
0x84292919cB64b590C0131550483707E43Ef223aC
0x077495925c17230E5e8951443d547ECdbB4925Bb
0x737cad465b75cdc4c11b3e312eb3fe5bef793d96
0x59c78c1c2b4b03b4530d5f46f02362e4a03efe4d
0xd7E13e49e467637D75C43D917d98d69049a19bFF
0xa9bA2C40b263843C04d344727b954A545c81D043
0x21DE18B6A8f78eDe6D16C50A167f6B222DC08DF7
0x879c8B99430F28C4d297BD479Cd43396b4aCF697
0x66Efac6e6d58D4058CF017E66a0039315a3eb29C
0xe1c3aEf912eCBF766155100038994c3FE880dB02
0xfECB01359263C12Aa9eD838F878A596F0064aa6e
0x5f68B4614DDAAd4eD1088E9E706efDFf66be5812
0xBEA0000029AD1c77D3d5D23Ba2D8893dB9d1Efab
0x1BEA0050E63e05FBb5D8BA2f10cf5800B6224449
0x1BEA3CcD22F4EBd3d37d731BA31Eeca95713716D
0x402c84de2ce49af88f5e2ef3710ff89bfed36cb6
0xBEA0e11282e2bB5893bEcE110cF199501e872bAd
0xbea0000113b0d182f4064c86b71c315389e4715d
0xc9C32cd16Bf7eFB85Ff14e0c8603cc90F6F2eE49
Old Bean ERC-20 Token
0xDC59ac4FeFa32293A95889Dc396682858d52e5Db
Old BEAN:ETH Uniswap V2 Pair
0x87898263B6C5BABe34b4ec53F22d98430b91e371
Old BEAN:3CRV Metapool
0x3a70DfA7d2262988064A2D051dd47521E43c9BdD
Old BEAN:LUSD Plain Pool
0xD652c40fBb3f06d6B58Cb9aa9CFF063eE63d465D
0x696a43f4Bf353685E1666f700bB929b8042E5e1b
0x0703B2b27Ee333B3f5249f7C96ad1445D4A09A17
0x6D1E1EC2891EdC25fdB3E3D0f7E02F469Cc1Bcbb
0xABf65fD0D887235D45898B09D66a67871EC23d1a
0xcFDC487C7a347aA7B275221c2A663e1004f656b8
0x336C5185B9f27b40fcD8E852d4B9e15A08084743
0x2e4Ea01753f30B837813EF14CC547674AeA1fe88
0xb7ab3f0667eFF5e2299d39C23Aa0C956e8982235
Where to Begin?
Connect to Beanstalk
Where Are My Assets and How to Use Them?
Approve Contracts
Add Bean to MetaMask
Why Beanstalk
How Beanstalk Works
Beanstalk Whitepaper
Farmers' Almanac
here
the Farm
Join our Discord
Where to Begin?
Connect to Beanstalk
Where Are My Assets and How to Use Them?
Approve Contracts
Add Bean to MetaMask
Understand the Bean Price
Understand the Sun
Understand Silo vAPY
Deposit in the Silo
Understand Silo Deposit Performance
Convert in the Silo
Transfer Deposits
Withdraw from the Silo
Claim Silo Rewards
Sow Beans
Transfer Pods
Harvest Pods
Understand Fert vAPY
Buy Fertilizer
Rinse Sprouts
Transfer Fertilizer
Trade Fertilizer
Buy Pods
Sell Pods
Understand My Balances
Migrate to Arbitrum
Mint BeaNFTs
Trade Beans
Transfer Balances
Vote on Governance Proposals
Delegate Votes
Chop Unripe Assets
BOP
BIP
about the Silo
Deposit in the Silo
Depositing
about the Field
Sow Beans
Sowing
Pods
Harvestable
about the Barn
Buy Fertilizer
Fertilizer
about the Market
Buy Pods
Pods
about the Barn
Barn Raise
Enroot your Revitalized Stalk and Seeds

Deposit in the Silo

  1. Select the asset you want to Deposit.

  2. In the “Deposit” tab, there is a drop down menu to select the token you would like to Deposit.

    • For example, a Bean Deposit can be made in either Beans or ETH. ETH will be converted to Beans during the Deposit transaction.

  3. You may select a slippage tolerance by selecting the gear icon. The default slippage tolerance is 0.1%.

  4. If you are Depositing ETH or have previously approved the asset being spent, skip to Step 10. For all other assets, select “Approve [Token]”. This allows the Beanstalk contract to spend the asset, but does not Deposit it yet.

  5. Select “Deposit”.

  6. After the transaction has been confirmed by the network, your Deposit will appear in the “Deposits” table at the bottom of the current page.

Where Are My Assets and How to Use Them?

Silo

Field

Barn

Use Claimable Beans

    • If you do not have any Rinsable Sprouts, Harvestable Pods, or Claimable Beans, you will not see this option on the UI.

  1. Open the "Use Claimable Beans" dropdown using the arrow icon.

  2. Under "Which Beans would you like to Claim?" select from Rinsable Sprouts, Harvestable Pods, or Claimable Beans. You may select more than one.

  3. Enter the amount of Claimable Beans to add to the transaction.

  4. Close the "Use Claimable Beans" dropdown to proceed with the transaction. The amount of Claimable Beans added will be shown in "Transaction Details".

Use Earned Beans

    • If you do not have any Earned Beans, you will not see this option on the UI.

  1. Toggle "Use Earned Beans". The amount of Earned Beans added will be shown in "Transaction Details".

Convert in the Silo

  1. Navigate to the “Silo” page.

  2. Select “Convert” and enter the amount of the Deposited asset you would like to Convert.

  3. You may select a slippage tolerance by selecting the gear icon. The default slippage tolerance is 0.1%.

  4. Select “Convert”.

  5. After the transaction has been confirmed by the network, your Converted Deposit will appear at the “Silo” page for the asset you Converted to under the “Deposits” table.

Assets on the can be Deposited in to earn Stalk and Seeds. You can find more information about Depositing in the Silo .

Make sure you are on and .

Navigate to the “Silo” page. At the bottom of the page, there is a table showing the various assets on the .

Enter the amount you want to Deposit. A transaction preview showing the to be rewarded will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

Confirm the approval transaction in your wallet, and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Assets used in Beanstalk may be in various states. For example, they may be Deposited in the , stored in Beanstalk (known as and used to save gas fees), in your wallet (known as ), or waiting for you to Claim them (known as Claimable Beans). For more information, learn about .

View a dashboard for all Beanstalk-related holdings by wallet address in .

Buy and sell Beans in and between your Farm Balance and Circulating Balance and between wallets.

Learn how to .

Once you have Deposited in the Silo, you will begin to receive . Learn about the performance of your Silo Deposit in and and collect your Silo Rewards in .

between Bean and LP Deposits can benefit both the Silo Member converting and peg maintenance. Learn how to .

If you want to send your Silo Deposit to another address, .

If you want to Withdraw your Deposit from the Silo, .

Learn how to for Pods.

If you want to send your Pods to another address, .

Once your Pods advance in the and become , .

or in the .

Learn how to and receive .

Once your Sprouts become , .

If you want to transfer your Fertilizer to another address, .

Learn how to sell Fertilizer on OpenSea in .

Pre-exploit Farmers can .

When you , , or , you can "Use Claimable Beans" to add to the transaction total with your , , and .

If less than the total amount of Claimable Beans is entered, choose whether to send the remaining balance to your Farm Balance or Circulating Balance. Learn more about .

When you from Beans, , or , you can "Use Earned Beans" to add to the transaction total with your .

Silo Members can participate in peg maintenance by Converting certain Deposited assets to others within the Silo. You can find more information about Conversions .

Make sure you are on and .

At the bottom of the page, there is a table showing the various assets on the .

Select the asset you want to Convert from. For example, to Convert from Bean to another asset, select Bean. You must already have a Deposit of this asset in order to Convert from it. Assets may or may not be convertible at a given time based on . See for additional information.

Below the input box, select the asset to “Convert to”. Available pairs are listed in the .

A transaction preview will appear below the inputs showing the change in asset and change in . Select the “Transaction Details'' dropdown to review each step of the transaction.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

0x0F53F811f603449293840DcE4CE981493569C262
0x3E5de69794E023757a4995Cfe97eAF399de7BbED
0x336C5185B9f27b40fcD8E852d4B9e15A08084743
0xfcf646f41Da372f0b2bd7f1C56895b379fB86c23
0xF808adAAb2B3A2dfa1d658cB9E187fF3b74CC0aC
0x063272862c4A2CA153123c7D31342E15053b9460
0x2e4Ea01753f30B837813EF14CC547674AeA1fe88
app.bean.money
connect your wallet
correct contract
correct contract
the Silo
Deposit Whitelist
here
Deposit Whitelist
Stalk and Seeds
Understand My Balances
Trade Beans
Transfer Balances
Deposit in the Silo
Converting
Convert in the Silo
Transfer Deposits
Withdraw from the Silo
Sow Beans
Transfer Pods
Buy Pods
Sell Pods
Market
Transfer Fertilizer
Trade Fertilizer
Chop Unripe Assets
Asset States
here
app.bean.money
connect your wallet
correct contract
Silo
Asset States
Farm Balance
Circulating Balance
Harvest Pods
Pod Line
Harvestable
Buy Fertilizer
Sprouts
Rinse Sprouts
Rinsable
Deposit in the Silo
Sow Beans
Buy Fertilizer
Rinsable Sprouts
Harvestable Pods
Claimable Beans
Convert in the Silo
Transfer Deposits
Withdraw from the Silo
Earned Beans
Silo
Field
Barn
Use Claimable Beans
Use Earned Beans
Understand vAPY
Understand Silo Deposit Performance
Claim Silo Rewards
Silo Rewards
Deposit Whitelist
Stalk and Seeds
deltaB
Convert Whitelist
Current Convert Whitelist

Rinse Sprouts

  1. Navigate to the “Barn” page.

  2. Select the “Rinse” tab. The “Rinsable Balance” will be shown. These are the Sprouts that are eligible to be Rinsed for Beans.

  3. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  4. Select “Rinse Sprouts”.

  5. After the transaction has been confirmed by the network, the location of your assets will depend on the option selected in Step 4:

Balances

Guides on understanding your Beanstalk balances.

Trade Fertilizer

Buy

  1. Go to the Bean Fertilizer collection on OpenSea and connect your wallet.

  2. Under "Status", check the "Buy Now" checkbox to filter for listed Fertilizer that can be cleared immediately.

    • Fertilizer in this view is grouped by Humidity (i.e. the Season in which it was minted).

  3. Select a given Fertilizer card to view details and buy Fertilizer from the listings.

  4. Select the "Boosts" dropdown to see the Humidity this Fertilizer was purchased at, as well as how many Sprouts are left to be paid per Fertilizer (or BPF Remaining—Beans Per Fertilizer Remaining).

  5. Under the "Listings" section, you can see how much Fertilizer is being listed at what price for what token.

  6. Select "Buy" on the listing you would like to fill.

  7. In the "Complete checkout" modal, enter the amount of Fertilizer you'd like to buy in the "Quantity" field.

  8. Optionally, you can specify that the purchased Fertilizer be sent to a different wallet.

  9. Select "Complete purchase".

Sell

  1. Select the Fertilizer you would like to sell.

  2. On the top right of the page, select "Sell".

  3. Under "Quantity" (only appears if you have >1 of a given Fertilizer), select how many Fertilizer you would like to list for sale.

  4. Under "Price", select the token and token amount you would like to sell the Fertilizer for.

  5. Under "Duration", select the duration in which you would like the listing to be open.

  6. Select "Complete listing".

  7. After the transaction has been confirmed by the network, you'll automatically be prompted to sign a message to list the Fertilizer. Sign the message in your wallet and your hardware wallet, if applicable.

  8. After signing the message, your listed Fertilizer will appear under the "Listings" section. Select "Cancel" to cancel a listing.

Buy Pods

Fill Pod Listing

  1. Navigate to the “Market” page.

    • You may customize the sorting, display, or filtering of any column by selecting it.

    • The “Listing” # is a unique identifier for each Pod Listing.

    • The “Place in Line” is the position in the Pod Line when the Pods in the Pod Listing will start to become Harvestable.

    • The “Price per Pod” is the number of Beans requested per Pod.

    • The “Amount” is the number of Pods left to be purchased from the Pod Listing.

    • If the Pod Line moves forward by the amount in the “Expires in” field, the Pod Listing will automatically expire.

  2. Select a Pod Listing to view details and to buy Pods from a Pod Listing.

  3. Under the “Fill” component, select the token you would like to use to buy Pods, and enter the amount you would like to buy. You may buy up to the “Amount” of Pods available from the Pod Listing.

  4. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  5. You may select a slippage tolerance by selecting the gear icon. The default slippage tolerance is 0.1%.

  6. If you are buying Pods with ETH, skip to Step 10. For all other assets, select “Approve [Token]”. This allows the Beanstalk contract to spend the asset, but does not buy Pods yet.

  7. Select “Fill”.

  8. After the transaction has been confirmed by the network, your Pods will appear in the “Pod Balance” table at the bottom of the “Field” page.

Order Pods

  1. Navigate to the “Market” page.

  2. Select “Create New”. “Order” is selected by default, allowing you to create a Pod Order.

    • “Price per Pod” is how much you will pay for each Pod, denominated in Beans.

    • “Order using” specifies the amount and the asset to be used to buy Pods. This amount will be locked in the Pod Order to allow for instant settlement. Pod Orders may be partially filled.

  3. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  4. You may select a slippage tolerance by selecting the gear icon. The default slippage tolerance is 0.1%.

  5. If you are buying Pods with ETH or have previously approved the asset being spent, skip to Step 8. For all other assets, select “Approve [Token]”. This allows the Beanstalk contract to spend the asset, but does not create the Pod Order yet.

  6. Select “Order”.

Active Fertilizer holders receive Sprouts. Sprouts become Rinsable on a basis. Once Sprouts become Rinsable, they are redeemable for 1 Bean each. See the page for more info.

Make sure you are on and .

Under “Destination”, select “Circulating Balance” or “Farm Balance”. Circulating Balance sends the Rinsed Beans to your wallet, separate from Beanstalk. keeps the asset stored in Beanstalk which can save gas fees in future transactions. See for more information.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

If “Circulating Balance” was selected, the Beans will be in your wallet. Your Circulating Balance is also shown on the page.

If “Farm Balance” was selected, the Beans will be shown on the page.

Active Fertilizer is an ERC-1155 token. ERC-1155 tokens can be traded on OpenSea. Transferring Fertilizer to another address transfers the associated Sprouts as well. See the page for more info.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

After the transaction has been confirmed by the network, the Fertilizer will appear in your and on the "Barn" page of the Beanstalk UI.

Go your account and connect your wallet.

Optionally, you can sell your Fertilizer as a or reserve it for a specific buyer.

If this is your first time listing Fertilizer on OpenSea, an approval transaction will be required. Confirm the approval transaction in your wallet, and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Pods can be exchanged in a trustless fashion on the Pod Market. Read the docs first for an introduction to Pod Market mechanics, and .

Make sure you are on and .

Open Pod Listings appear below the “Buy Now” tab. This view displays all the Pod Listings, sorted by ascending .

Confirm the approval transaction in your wallet, and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Make sure you are on and .

“Max Place in Line” is the maximum at which you are willing to buy Pods at the specified price. Any Pods at a lower Place in Line than the maximum Place in Line will be eligible to Fill the Pod Order.

Confirm the approval transaction in your wallet, and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

After the transaction has been confirmed by the network, your Pod Order will be shown on the page under the “Orders” tab, where you can check the status of your Pod Order or Cancel it.

app.bean.money
connect your wallet
Farm Balance
Asset States
correct contract
Balances
Balances
Barn
pari passu
Understand My Balances
Barn
correct contract
OpenSea account
OpenSea
bundle
correct contract
app.bean.money
connect your wallet
correct contract
correct contract
app.bean.money
connect your wallet
correct contract
correct contract
My Pod Market
Pod Market
Pod Listings
Pod Orders
Place in Line
Place in Line
Fill Pod Listing
Order Pods

Unripe Assets

Guides on claiming and redeeming your .

Chop Unripe Assets
Unripe assets

Chop Unripe Assets

  1. Select your wallet address on the top right of the page and in the dropdown menu select “Chop Unripe Assets”.

  2. Select the asset you want to Chop using the drop down menu and enter the amount to Chop, up to the “Balance” shown below the input box.

  3. A transaction preview will appear below the inputs. Select the “Transaction Details” dropdown to review each step of the transaction.

  4. Select “Chop”.

  5. After the transaction has been confirmed by the network, the location of your assets will depend on the option selected in Step 5:

can be Chopped in exchange for the underlying. You can find more information about Chopping .

Make sure you are on and .

The “Chop Conditions” component shows the current “”. Note that Chopping with a greater than 0% Chop Penalty forfeits a claim to future Ripe assets.

Under “Destination”, select “Circulating Balance” or “Farm Balance”. Circulating Balance sends the Chopped assets to your wallet, separate from Beanstalk. keeps the assets stored in Beanstalk which can save gas fees in future transactions. See for more information.

Confirm the transaction in your wallet and your hardware wallet, if applicable. You should verify that the transaction is interacting with the before signing it.

If “Circulating Balance” was selected, the Chopped assets will be in your wallet. Your Circulating Balance is also shown on the page.

If “Farm Balance” was selected, the Chopped assets will be shown on the page.

app.bean.money
connect your wallet
Farm Balance
Asset States
correct contract
Balances
Balances
Unripe assets
here
Chop Penalty

Contributing

Beanstalk belongs to the Beanstalk DAO and is developed as an open source, permissionless public good. Anyone can contribute to Beanstalk and the Bean-based economy by:

Participating in Beanstalk governance

Building with Beanstalk and Beans

Discuss business ideas in the (#💡・business-ideas) channel on the Beanstalk Discord.

Submitting improvements to the Beanstalk protocol

Submitting improvements to Beanstalk development tooling

Leave feedback on the Beanstalk UI in the (#🌐・ui-feedback) channel and discuss improvements to Beanstalk development tooling in the (#🪵・development) channel in the Beanstalk Discord.

Submitting improvements to Beanstalk documentation

Documentation around Beanstalk is continually improving and help is more than welcome.

Leave feedback in the (#📜・docs-feedback) channel on the Beanstalk Discord or make a pull request directly to:

Becoming a member of the Beanstalk Farms Committee

Funding your own development organization

;

;

;

;

;

; or

.

Become a and participate in Beanstalk governance by in the to earn .

Read more about and the various.

Each governance proposal has a channel for discussion on the .

Beanstalk's is designed to facilitate a Bean-based economy of protocols and businesses benefiting from building on Beanstalk and using Beans. Beanstalk welcomes builders and provides a competitive edge to your project.

The Beanstalk protocol is deployed on Ethereum mainnet. The code base is open source and developed on . Discuss improvements to Beanstalk in the (#💡・beanstalk-ideas) channel in the Beanstalk Discord.

Protocol changes are submitted as (BIPs) and are committed if passed by Stalkholders.

All Beanstalk development tooling, such as the , and , are open source.

the ;

the ; or

the .

Hiring for Beanstalk Farms is performed by the (BFC). You can join the BFC yourself through a .

Decentralization of development of the Beanstalk protocol is critical to the long term success of Beanstalk. Anyone can propose a to the DAO in order to mint Beans to fund their own organization.

Beanstalk governance
proposals
Beanstalk Discord
capital efficient model
GitHub
Beanstalk UI
SDK
Subgraph
Farmers' Almanac repository
Beanstalk Whitepaper repository
Pipeline Whitepaper repository
Participating in Beanstalk governance
Building with Beanstalk and Beans
Submitting improvements to the Beanstalk protocol
Submitting improvements to Beanstalk development tooling
Submitting improvements to Beanstalk documentation
Becoming a member of the Beanstalk Farms Committee
Funding your own development organization
Silo
Stalkholder
Depositing whitelisted assets
Stalk
Beanstalk Improvement Proposals
BIP
BFCP-A proposal
Beanstalk Farms Committee

Vote on Governance Proposals

  1. Your voting power in Stalk is listed under "Stalkholder".

  2. Active governance proposals are listed first and have a green circle. Closed governance proposals have a gray circle. Select the active governance proposal you want to vote on.

  3. Under the “Results” section select the choice you want to vote for.

    • Note: Selecting the “Abstain” choice on a BIP or BOP is the same as not voting. It is not possible to remove a vote on Snapshot, so the “Abstain” choice exists on some proposals to allow Farmers to unvote after voting.

  4. Select “Vote”.

  5. After signing, it may take some time for your vote to appear on the Beanstalk UI. Check Snapshot by selecting "View on Snapshot" for the latest results.

  6. You may change your vote by repeating this process before the proposal is closed at the time specified in "Vote ends in". The exact time a proposal closes is viewable by selecting "View on Snapshot".

Example Snapshot Vote Signature

{
 "types": {
  "Vote": [
   {
    "name": "from",
    "type": "address"
   },
   {
    "name": "space",
    "type": "string"
   },
   {
    "name": "timestamp",
    "type": "uint64"
   },
   {
    "name": "proposal",
    "type": "bytes32"
   },
   {
    "name": "choice",
    "type": "uint32"
   },
   {
    "name": "app",
    "type": "string"
   }
  ]
 },
 "domain": {
  "name": "snapshot",
  "version": "0.1.4"
 },
 "primaryType": "Vote",
 "message": {
  "from": "[Arbitrum address]",
  "space": "beanstalkdao.eth",
  "timestamp": "1661055899",
  "proposal": "0x7b2d54f3691fa65fc784e3398425d518eab93d233f3ad0abd3d87b572cf5ab2f",
  "choice": "2",
  "app": "snapshot"
 }
}

Beanstalk is by Stalkholders. Anyone with Stalk can vote for (BIPs), (BOPs), (BFCPs) and (BSPs).

View past governance proposals .

Make sure you are on and .

Select “More” then “Governance” to navigate to the page.

Select "", "" or "" to view governance proposals. A green circle will appear by the category if there are active governance proposals.

Sign the message in your wallet and your hardware wallet, if applicable. You should verify the message before signing it. Snapshot votes are plain text messages. An example is shown .

here
app.bean.money
connect your wallet
Governance
DAO
Beanstalk Farms
Bean Sprout
governed
Beanstalk Improvement Proposals
Beanstalk Operations Proposals
Beanstalk Farms Committee Proposals
Bean Sprout Proposals
below

Bean Sprout

Bean Sprout is currently inactive.

Funding

Past BIPs that funded Beanstalk Sprout:

Spending

BSPs that propose to spend less than or equal to 25,000 Beans are optimistically approved unless a quorum of 10% of the Stalk supply is reached, after which the majority vote determines the outcome of the vote. BSPs that propose to spend more than 25,000 Beans must reach a quorum of 10% of the Stalk supply and a majority vote For in order to pass.

A BSP is not required for the BSM to send payments valued at under 4,000 Beans.

Bean Sprout is a Beanstalk accelerator program to facilitate rapid development on and around Beanstalk in a decentralized fashion. Bean Sprout is responsible for the incubation of .

Like Beanstalk Farms, Bean Sprout does not have a treasury and has historically been minted a a budget by the Beanstalk DAO via BIP. Budget funds are custodied by the .

(included Beanstalk Farms and Bean Sprout)

Monthly reports on how Bean Sprout spent its budget can be found .

Currently, Bean Sprout is not actively funded. The last Bean Sprout budget was the Q4 2022 budget. Past BSPs can be read .

Bean Sprout Proposals, or BSPs, are proposals to use the Bean Sprout budget. Anyone with 0.1% of the Stalk supply or signers can propose a BSP. BSPs are voted on by Stalkholders.

LogoSafesafe
LogoLouper - The Ethereum Diamond Inspector
Root
Bean Sprout Multisig (BSM)
BIP-8: Beanstalk Q1 2022 Budget
BIP-23: Bean Sprout Q3 2022 Budget
BIP-27: Bean Sprout Q4 2022 Budget
here
here
BSM
LogoLouper - The Ethereum Diamond Inspector
LogoBeanstalk Bug Bounties | ImmunefiImmunefi
This screenshot of the Bean price chart is from September 12, 2022. See for the latest data.
LogoSafe{Wallet}safe
app.bean.money