Proposer

Beanstalk Farms

Summary

• Update various Beanstalk verbiage at the protocol, UI, and documentation level.

Proposal

Beanstalk Farms aims to make Beanstalk as easy as possible to understand. The farming metaphor is helpful for explaining novel concepts. Selecting clear, distinct names for each component in Beanstalk is part of that effort. In that spirit, Beanstalk Farms proposes a handful of terminology changes to Beanstalk and its associated documentation.

Most of these changes either require updates to documentation, the whitepaper and/or the Beanstalk UI.

Formatting tables in Snapshot proposals has some rough edges, so the proposal with the full table of rationales for each term change can be found at this Arweave link:

https://arweave.net/NjwRoYUfVVms2-y5BwI2cyKk8KgcXpxQNcmqZ4yUF6o

Previous term	New term
Rain	Downpour
Season of Plenty	Flood
N/A (Season where TWAP > 1)	Rainy Season
N/A (Season where TWAP <= 1)	Dry Season
Weather	Temperature
Earned Seeds (previously Farmable Seeds on the pre-exploit UI)	Plantable Seeds
Earn (previously Farm on the pre-exploit UI)	Plant
Ripen (in Barn Raise context)	Chop
N/A (pre-exploit Stalk that has vested)	Revitalized Stalk
N/A (pre-exploit Stalk that has not vested)	Unrevitalized Stalk
N/A (pre-exploit Seeds that have vested)	Revitalized Seeds
N/A (pre-exploit Seeds that have not vested)	Unrevitalized Seeds
N/A (Add Revitalized Stalk and Seeds to your Stalk and Seed balances)	Enroot
N/A (Beans/LP underlying Unripe Beans/LP)	Ripe Beans/LP
Whitelist	Add to Whitelist
Dewhitelist	Remove from Whitelist
Marketplace	Market
Farmers’ Market	Pod Market
Update (No previous term on the pre-exploit UI, Farm was the function that claimed both Grown Stalk and Farmable Seeds)	Mow
Claim non-Deposited Unripe assets	Pick
Unfertilized Beans	Sprouts
Fertilized Beans	Fertilized Sprouts
Claim Fertilized Sprouts	Rinse
Wrapped/Internal Beans	Farm Beans
Claimable Withdrawn Beans (timer has elapsed)	Receivable Beans
Claimable Beans + Wrapped Beans	Farmable Beans

With this new verbiage, it is more straightforward to create a taxonomy of different states that Beans can be in. A higher resolution version of this image can be found on the Arweave upload of this proposal here.

Bean State	Definition
Farm Beans	Beans stored in Beanstalk.
Harvestable Pods	Pods that are redeemable for 1 Bean each.
Fertilized Sprouts	Sprouts that are redeemable for 1 Bean each.
Receivable Beans	Withdrawn Beans after the Withdrawal timer has elapsed.
Circulating Beans	Beans in Farmers’ wallets.
Farmable Beans	Beans stored in Beanstalk that can be used in transactions.
Unused Beans	Beans that can be used within Beanstalk. These are the Beans that Farmers can use to Deposit, Order, etc.
Withdrawn Beans	Beans Withdrawn from the Silo before they are unfrozen.
Ordered Beans	Beans stored in Pod Orders.
Deposited Beans	Beans Deposited in the Silo. These Beans must be Withdrawn and the Withdrawal timer must elapse in order to use them.
Earned Beans	Beans paid to a Silo Member since the last Season the Silo Member interacted with the Silo.
Ripe Beans	Beans that are minted as Fertilizer is sold and debt to Fertilizer holders is repaid. Unripe Beans represent a pro rata share of underlying Ripe Beans.