Beanstalk
  • Farmers' Almanac
  • Disclosures
  • Developers
  • Whitepaper
  • 🌱Introduction
    • Why Beanstalk
    • How Beanstalk Works
  • 🌾Farm
    • Overview
    • Sun
    • Silo
      • Seed Gauge System
    • Field
    • Barn
    • Toolshed
      • Depot
      • Pod Market
      • Tractor
  • ⚖️Peg Maintenance
    • Overview
    • Temperature
    • Crop Ratio
    • Convert
    • Flood
  • 🔬Advanced
    • Stablecoin Overview
    • Types of Stablecoins
    • Economics
  • 🏦Governance
    • Beanstalk
      • BCM Process
      • BCM Dashboard
      • BIC Process
      • BICM Dashboard
    • Beanstalk Farms
      • BFM Dashboard
      • BFC Dashboard
    • BeaNFTs
      • BDM Dashboard
    • Proposals
  • 🗺️Guides
    • Directory
    • Getting Started
      • Where to Begin?
      • Connect to Beanstalk
      • Where Are My Assets and How to Use Them?
      • Approve Contracts
      • Add Bean to MetaMask
    • Sun
      • Understand the Bean Price
      • Understand the Sun
    • 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
    • Field
      • Sow Beans
      • Transfer Pods
      • Harvest Pods
    • Barn
      • Understand Fert vAPY
      • Buy Fertilizer
      • Rinse Sprouts
      • Transfer Fertilizer
      • Trade Fertilizer
    • Market
      • Buy Pods
      • Sell Pods
    • Balances
      • Understand My Balances
      • Migrate to Arbitrum
    • BeaNFTs
      • Mint BeaNFTs
    • Swap
      • Trade Beans
      • Transfer Balances
    • Governance
      • Vote on Governance Proposals
      • Delegate Votes
    • Unripe Assets
      • Chop Unripe Assets
  • 📖Protocol Resources
    • Glossary
    • Asset States
    • Contracts
    • Audits
    • Bug Bounty
  • 🌐Ecosystem
    • Basin
    • Pipeline
  • 🏫Community Resources
    • Discord
    • Notion
    • Contributing
    • Discord Roles
    • Content
    • Links
  • 📰Archives
    • Bean Sprout
      • BSM Dashboard
    • Governance Proposals (June 2023)
    • Fundraiser
Powered by GitBook
On this page
  • Tokens
  • Primary Facilities
  • Creating Stability
Edit on GitHub
Export as PDF
  1. Introduction

How Beanstalk Works

PreviousWhy BeanstalkNextOverview

Last updated 7 months ago

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
the Silo
Publius explains how Beanstalk works
Flood Whitelist
Soil
Minting Whitelist
Convert Whitelist
deltaB
Stalk
Seeds
Deposit Whitelist