BIP-11: Farmers Market

Proposed: February 2, 2022

Status: Passed

Link: GitHub PR


Proposer

Beanstalk Farms

Summary

Problem

Currently, there is no way to exchange Pods in a decentralized fashion. Accordingly, there is little liquidity around Pods, and trades require trusting a third party.

Proposed Solution

We propose the Farmers Market, a decentralized Pod exchange. The Farmers market will support Pod Orders to purchase Pods and Pod Listings to sell Pods.

Pod Orders

Anyone with Beans not in the Silo can Order Pods.

A Pod Order has three inputs: (1) the maximum number of Pods to be purchased, (2) the maximum price per Pod, denominated in Beans, and (3) the maximum place in the Pod Line (i.e., the number of Pods that will become Harvestable before a given Pod) to purchase from.

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. Beans can only be locked in a single Pod Order at a time.

Pod Listings

Pods that grow from Beans that were Sown in the same transaction form a Plot. Anyone with a Plot can List a whole or partial Plot for Beans. By default, the portion of a Plot in a partial Pod Listing that is farthest from the front of the Pod Line is Listed.

A Pod Listing has five inputs: (1) the Plot being Listed, (2) the difference between the front of the portion of the Plot included in the Pod Listing from the front of the whole Plot, denominated in Pods, where a null input Lists from the back of the Plot, (3) the number of Pods in the Plot for sale, where a null input Lists the whole Plot, (4) the minimum price per Pod, denominated in Beans, and (5) the maximum number of total Harvestable Pods over all Seasons before the Pod Listing expires.

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.

Clearance

An outstanding Pod Order can be entirely or partially Filled at any time by a seller. If the Pod Order is partially Filled, the rest of the Pod Order remains Listed. Similarly, an outstanding 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.

In instances where causes a Pod Order and Pod Listing that previously were not overlapping to overlap, either the buyer or seller can Fill their order at their preferred price.

Economic Rationale

Liquidity and price discovery for Pods is an important step in the evolution of the Beanstalk ecosystem.

Effective

Immediately upon commitment.

Award

4000 Beans to Beanstalk Farms and 1000 Beans to Dumpling to cover deployment costs.