Silo Facet

{% hint style="warning" %} Note that this page has not been updated to reflect the current state of Beanstalk, but is left here as a reference. {% endhint %}

The Silo Facet handles Depositing, Withdrawing, and transferring Deposits (whitelisted assets in the Silo).

Stems keep track of when the Deposit was created. When the Deposit was created determines how much Grown Stalk per BDV the Deposit has.

Call Functions

Deposit

function deposit(
    address token,
    uint256 _amount,
    LibTransfer.From mode
) 
    external 
    payable 
    nonReentrant 
    mowSender(token)
    returns (uint256 amount, uint256 bdv, int96 stem);

Deposits ERC20 token into internal Farmer balances.

Parameter	Type	Description
`token`	`address`	Address of the token to Deposit.
`_amount`	`uint256`	Amount of the token to be Deposited.
`mode`	`From`	The balance to transfer the token from; see `LibTransfer.From`.

Return value	Type	Description
`amount`	`address`	Amount of the token Deposited.
`bdv`	`uint256`	BDV of the Deposit.
`stem`	`int96`	Stem of the Deposit.

Withdraw Deposit

function withdrawDeposit(
    address token,
    int96 stem,
    uint256 amount
    LibTransfer.To mode
) external payable mowSender(token) nonReentrant;

Withdraws a single Deposit.

Parameter	Type	Description
`token`	`address`	Address of ERC20 being Withdrawn.
`stem`	`int96`	Stem of the Deposit to Withdraw.
`amount`	`uint256`	Tokens to be Withdrawn.
`mode`	`To`	The balance to transfer the token to; see `LibTransfer.To`.

Withdraw Deposits

function withdrawDeposits(
    address token,
    int96[] calldata stems,
    uint256[] calldata amounts,
    LibTransfer.To mode
) external payable mowSender(token) nonReentrant;

Withdraws multiple Deposits.

Parameter	Type	Description
`token`	`address`	Address of ERC20 being Withdrawn.
`stems`	`int96[]`	Stems of the Deposits to Withdraw.
`amounts`	`uint256[]`	Array of token amounts to Withdraw from corresponding `stems`.
`mode`	`To`	The balance to transfer the token to; see `LibTransfer.To`.

Transfer Deposit

function transferDeposit(
    address sender,
    address recipient,
    address token,
    int96 stem,
    uint256 amount
) public payable nonReentrant returns (uint256 bdv);

Transfers single Farmer's Deposit.

Parameter	Type	Description
`sender`	`address`	Source of Deposit.
`recipient`	`address`	Destination of Deposit.
`token`	`address`	Address of Deposited ERC20 being transferred.
`stem`	`int96`	Stem of Deposit to Transfer.
`amount`	`uint256`	Amount of tokens to transfer.

Return Value	Type	Description
`bdv`	`uint256`	BDV now owned by `recipient`.

Transfer Deposits

function transferDeposits(
    address sender,
    address recipient,
    address token,
    int96[] calldata stem,
    uint256[] calldata amounts
) public payable nonReentrant returns (uint256[] memory bdvs);

Transfers multiple Farmer Deposits.

Parameter	Type	Description
`sender`	`address`	Source of Deposit.
`recipient`	`address`	Destination of Deposit.
`token`	`address`	Address of ERC20 being transferred.
`stem`	`int96[]`	Stems of Deposits to transfer.
`amounts`	`uint256[]`	Array of token amounts to transfer based on corresponding `stems`.

Return Value	Type	Description
`bdvs`	`uint256[]`	Array of BDVs of each Deposit transferred.

Safe Transfer From

function safeTransferFrom(
    address sender, 
    address recipient, 
    uint256 depositId, 
    uint256 amount,
    bytes calldata
) external;

Transfer a single Deposit, conforming to the ERC1155 standard.

Parameter	Type	Description
`sender`	`address`	Source of Deposit.
`recipient`	`address`	Destination of Deposit.
`depositId`	`uint256`	ID of Deposit to transfer.
`amount`	`uint256`	Amount of ERC1155 to transfer.

Safe Batch Transfer From

function safeBatchTransferFrom(
    address sender, 
    address recipient, 
    uint256[] calldata depositIds, 
    uint256[] calldata amounts, 
    bytes calldata
) external;

Transfer a single Deposit, conforming to the ERC1155 standard.

Parameter	Type	Description
`sender`	`address`	Source of Deposit.
`recipient`	`address`	Destination of Deposit.
`depositIds`	`uint256[]`	Array of IDs of Deposits to transfer.
`amounts`	`uint256[]`	Array of amounts of ERC1155 to transfer, corresponding to `depositIds`.

Yield Distribution

Mow

function mow(address account, address token) external payable;

Claim Grown Stalk for an account for a particular whitelisted asset.

Parameter	Type	Description
`account`	`address`	Address to Mow for.
`token`	`address`	Address of ERC20 Deposit to Mow for.

Mow Multiple

function mowMultiple(address account, address[] calldata tokens) external payable;

Mow for multiple whitelisted assets for an account.

Parameter	Type	Description
`account`	`address`	Address to Mow for.
`tokens`	`address[]`	Array of addresses of ERC20 Deposits to Mow for.

Plant

function plant() 
    external payable returns (uint256 beans, int96 stem);

Claim Earned Beans and their associated Stalk and Plantable Seeds for msg.sender.

Return Value	Type	Description
`beans`	`uint256`	Amount of Earned Beans given.
`stem`	`int96`	Stem of the new Deposit.

Claim Plenty

function claimPlenty() external payable;

Claims rewards from a Flood (Season of Plenty) for msg.sender.

View Functions

Utilities

Last Update

function lastUpdate(address account) public view returns (uint32);

Get the last Season in which account updated their Silo.

Return Type	Description
`uint32`	Last Season `account` updated their Silo.

Silo Totals

Total Stalk

function totalStalk() public view returns (uint256);

Returns the total supply of Stalk. Does NOT include Grown Stalk.

Return Type	Description
`uint256`	Total supply of Stalk.

Total Roots

function totalRoots() public view returns (uint256);

Returns the total supply of Roots.

Return Type	Description
`uint256`	The total supply of Roots.

Total Earned Beans

function totalEarnedBeans() public view returns (uint256);

Returns the total supply of Earned Beans.

Return Type	Description
`uint256`	Total supply of Earned Beans.

Silo Account Balances

Balance Of Stalk

function balanceOfStalk(address account) public view returns (uint256);

Returns the balance of Stalk for a particular Farmer. Does NOT include Grown Stalk; does include Earned Stalk.

Parameter	Type	Description
`account`	`address`	Farmer to get the Stalk balance for.

Return Type	Description
`uint256`	Stalk balance of `account`.

Balance Of Roots

function balanceOfRoots(address account) public view returns (uint256);

Returns the balance of Roots for a particular Farmer.

Parameter	Type	Description
`account`	`address`	Farmer to get the Roots balance for.

Return Type	Description
`uint256`	Roots balance of `account`.

Balance Of Grown Stalk

function balanceOfGrownStalk(address account, address token)
    public
    view
    returns (uint256);

Returns the balance of Grown Stalk for account. Grown Stalk is earned each Season from BDV and must be Mown to add it to a user's Stalk balance.

Parameter	Type	Description
`account`	`address`	Farmer to get the Grown Stalk balance for.

Return Type	Description
`uint256`	Grown Stalk balance of `account`.

Grown Stalk for Deposit

function grownStalkForDeposit(
    address account,
    address token,
    int96 stem
)
    public
    view
    returns (uint grownStalk);

Returns the balance of Grown Stalk for a single deposit of token in stem for account.

Parameter	Type	Description
`account`	`address`	Farmer that owns the Deposit to get the Grown Stalk balance for.
`token`	`address`	ERC20 token address of the Deposit.
`stem`	`int96`	Stem of the Deposit.

Return Value	Type	Description
`grownStalk`	`uint`	Grown Stalk for Deposit.

Balance Of Earned Beans

function balanceOfEarnedBeans(address account)
    public
    view
    returns (uint256 beans);

Returns the balance of Earned Beans for a Farmer.

Parameter	Type	Description
`account`	`address`	Farmer to get the Earned Bean balance for.

Return Value	Type	Description
`beans`	`uint256`	Earned Bean balance of `account`.

Balance Of Earned Stalk

function balanceOfEarnedStalk(address account)
    public
    view
    returns (uint256)

Return the account balance of Earned Stalk, the Stalk associated with Earned Beans.

Parameter	Type	Description
`account`	`address`	Farmer to get the Earned Stalk balance for.

Return Type	Description
`uint256`	Earned Stalk balance of `account`.

Balance Of Deposited BDV

function balanceOfDepositedBdv(address account, address token)
    external
    view
    returns (uint256 depositedBdv);

Return the balance of Deposited BDV of a whitelisted asset for a given Farmer.

Parameter	Type	Description
`account`	`address`	Farmer to get the Deposited BDV balance for.
`token`	`address`	Whitelisted asset to get the balance of Deposited BDV for.

Return Value	Type	Description	Description	Return Value
`depositedBdv`	`uint256`	Balance of Deposited BDV given `account` and `token`.	Earned Stalk balance of `account`.	`depositedBdv`

Get Last Mowed Stem

function getLastMowedStem(address account, address token)
    external
    view
    returns (int96 lastStem);

Return the Stem at the time that a Farmer last Mowed a particular whitelisted asset.

Parameter	Type	Description
`account`	`address`	Farmer to get the last Mowed Stem for.
`token`	`address`	Whitelisted asset to get the last Mowed Stem for.

Return Value		Description
`lastStem`	`int96`	Last Mowed Stem for `token` given `account`.

Get Mow Status

function getMowStatus(address account, address token)
    external
    view
    returns (Account.MowStatus memory mowStatus);

Return the Mow Status struct of token for a given account.

Parameter	Type	Description
`account`	`address`	Farmer to get the Mow Status of.
`token`	`address`	Token to get the Mow Status of `account` for.

Type	Description	Return Value
`Account.MowStatus`	Mow Status struct of `token` for `account`.	`mowStatus`

Season of Plenty (Flood)

Last Season Of Plenty

function lastSeasonOfPlenty() public view returns (uint32);

Returns the last Season that a Season of Plenty started.

Return Value	Description
`uint32`	The last Season it started Flooding.

Balance Of Plenty

function balanceOfPlenty(address account)
    public
    view
    returns (uint256 plenty);

Returns the Farmer's balance of unclaimed 3CRV earned from the Season of Plenty.

Parameter	Type	Description
`account`	`address`	Farmer to get the unclaimed 3CRV balance for.

Return Value	Type	Description
`plenty`	`uint256`	Unclaimed 3CRV balance of `account`.

Balance Of Rain Roots

function balanceOfRainRoots(address account) public view returns (uint256);

Returns the account balance of Roots the last time it was Raining during a Silo update.

Parameter	Type	Description
`account`	`address`	Farmer to get "Rain Roots" balance for.

Return Value	Description
`uint256`	Root balance last time it was Raining for `account`.

Balance of SOP

function balanceOfSop(address account)
    external
    view
    returns (AccountSeasonOfPlenty memory sop);

Returns the account Season of Plenty related state variables.

Parameter	Type	Description
`account`	`address`	Farmer to get SOP related state variables for.

Return Value	Type	Description
`sop`	`AccountSeasonOfPlenty`	Struct containing SOP related state variables.

Stems

Stem Tip for Token

function stemTipForToken(address token)
    public
    view
    returns (int96 _stemTip);

Returns the "stemTip", or cumulative Grown Stalk Per BDV of a given Deposited asset since whitelist, for a given whitelisted token.

Parameter	Type	Description
`token`	`address`	ERC20 token to get the Stem tip for.

Return Value	Type	Description
`_stemTip`	`int96`	Returns the Stem tip for `token`.

Season to Stem

function seasonToStem(address token, uint32 season)
    public
    view
    returns (int96 stem);

Get the Stem associated with a particular Deposit (via its token and Season). Kept for legacy reasons.

Parameter	Type	Description
`token`	`address`	ERC20 token of the Deposit.
`season`	`uint32`	Season of the Deposit.

Return Value	Type	Description
`stem`	`int96`	Stem of the Deposit.

Get Seeds per Token

function getSeedsPerToken(address token) public view virtual returns (uint256);

Gets the Seeds per token for legacy whitelisted assets. Calling with an non-legacy token will return 0, even after the token is whitelisted. Kept for legacy reasons.

Parameter	Type	Description
`token`	`address`	Legacy token to get the Seeds for.

Return Type	Description
`uint256`	Seeds for the legacy token.

Stem Start Season

function stemStartSeason() public view virtual returns (uint16);

Returns the Season in which Beanstalk initialized Silo V3, i.e., the Season in which Stems were initialized.

Return Type	Description
`uint16`	Season in which Stems were initialized.

Migration Needed

function migrationNeeded(address account) public view returns (bool);

Returns whether or not a Farmer needs to migrate to Silo V3.

Parameter	Type	Description
`account`	`address`	Farmer to check if migration is needed for.

Return Type	Description
`bool`	Whether or not `account` needs to migrate to Silo V3.

In Vesting Period

function inVestingPeriod() public view returns (bool);

Returns if Earned Beans from the previous gm call are still vesting. Vesting Earned Beans cannot be received via plant until the Vesting Period is over, and will be forfeited if a Farmer Withdraws during the Vesting Period.

Return Type	Description
`bool`	Whether or not Earned Beans from the previous `gm` function call are still vesting.

Getters

Get Deposit

function getDeposit(
    address account,
    address token,
    int96 stem
) external view returns (uint256, uint256)

Find the amount and BDV of token that a Farmer has Deposited in a given Stem.

Parameter	Type	Description
`account`	`address`	Farmer to get Deposit data for.
`token`	`address`	ERC20 token of the Deposit.
`stem`	`int96`	Stem of the Deposit.

Return Value	Description
`uint256`	Number of tokens in the Deposit.
`uint256`	BDV of the Deposit.

Get Total Deposited

function getTotalDeposited(address token) external view returns (uint256);

Get the total amount of token currently Deposited in the Silo across all Farmers.

Parameter	Type	Description
`token`	`address`	Whitelisted token address.

Return Type	Description
`uint256`	Total number of `token` Deposited in the Silo.

Get Total Deposited BDV

function getTotalDepositedBdv(address token) external view returns (uint256);

Get the total BDV of token currently Deposited in the Silo across all Farmers.

Parameter	Type	Description
`token`	`address`	Whitelisted token address.

Return Type	Description
`uint256`	Total BDV of `token` Deposited in the Silo.

Token Settings

function tokenSettings(address token)
    external
    view
    returns (Storage.SiloSettings memory);

Get the Storage.SiloSettings for a whitelisted token.

Parameter	Type	Description
`token`	`address`	Whitelisted token address.

Return Type	Description
`Storage.SiloSettings`	Struct with Silo variables for `token`.

BDV

function bdv(address token, uint256 amount)
    external
    view
    returns (uint256 _bdv);

Returns the total BDV of a number of tokens on the Deposit Whitelist.

Parameter	Type	Description
`token`	`address`	The whitelisted token address.
`amount`	`uint256`	The number of tokens.

Type	Description	Return Value
`uint256`	The total BDV of `amount` number of `token`.	`_bdv`

ERC-1155

Balance Of

function balanceOf(
    address account, 
    uint256 depositId
) external view returns (uint256 amount);

Gets the amount of tokens in a Deposit type for a given Farmer.

Parameter	Type	Description
`account`	`address`	Farmer to get Deposit amount for.
`depositId`	`uint256`	Deposit ID corresponding to `account`.

Return Type	Description
`amount`	Amount of tokens in a Deposit type for `account`.

Balance Of Batch

function balanceOfBatch(
    address[] calldata accounts, 
    uint256[] calldata depositIds
) external view returns (uint256[] memory);

Gets an array of amounts corresponding to Deposits.

Parameter	Type	Description
`accounts`	`address[]`	List of Farmers.
`depositIds`	`uint256[]`	List of Deposit IDs corresponding to `accounts`.

Return Type	Description
`uint256[]`	Array of amounts corresponding to the list of Deposits.

Get Deposit ID

function getDepositId(
    address token, 
    int96 stem
) external pure returns (uint256);

Gets the Deposit ID given an whitelisted token address and Stem.

Parameter	Type	Description
`token`	`address`	Whitelisted token address.
`stem`	`int96`	Stem of the Deposit.

Return Type	Description
`uint256`	Deposit ID of `token` with `stem`.

Events

Plant

event Plant(
    address indexed account,
    uint256 beans
);

Emitted when the deposit associated with the Earned Beans of account are Planted.

Parameter	Type	Description
`account`	`address`	Farmer that Planted their Earned Beans.
`beans`	`uint256`	The amount of Earned Beans claimed.

Claim Plenty

event ClaimPlenty(
    address indexed account,
    uint256 plenty
);

Emitted when 3CRV paid to account during a Flood is claimed.

Parameter	Type	Description
`account`	`address`	Farmer that claimed the assets.
`plenty`	`uint256`	The amount of 3CRV claimed by `account`.

Stalk Balance Changed

event StalkBalanceChanged(
    address indexed account,
    int256 delta,
    int256 deltaRoots
);

Emitted when account gains or loses Stalk.

Parameter	Type	Description
`account`	`address`	The Farmer whose Stalk balance changed.
`delta`	`int256`	The change in Stalk.
`deltaRoots`	`int256`	The change in Roots.

Add Deposit

event AddDeposit(
    address indexed account,
    address indexed token,
    int96 stem,
    uint256 amount,
    uint256 bdv
);

Emitted when account adds a single Deposit to the Silo. There is no AddDeposits event because there is currently no operation in which Beanstalk creates multiple Deposits in different Stems.

Parameter	Type	Description
`account`	`address`	The Farmer that added a Deposit to Beanstalk.
`token`	`address`	Whitelisted token address.
`stem`	`int96`	The Stem of the Deposit.
`amount`	`uint256`	Token amount of the Deposit.
`bdv`	`uint256`	The BDV associated with `amount` of `token` at the time of Deposit.

Remove Deposit

event RemoveDeposit(
    address indexed account,
    address indexed token,
    int96 stem,
    uint256 amount,
    uint256 bdv
);

Emitted when account removes a single Deposit from the Silo. Occurs during Withdraw and Convert.

Parameter	Type	Description
`account`	`address`	The Farmer whose Deposit was removed.
`token`	`address`	Whitelisted token address.
`stem`	`int96`	The Stem of the Deposit.
`amount`	`uint256`	The token amount of the Deposit.
`bdv`	`uint256`	The BDV associated with the Deposit.

Remove Deposits

event RemoveDeposits(
    address indexed account,
    address indexed token,
    int96[] stems,
    uint256[] amounts,
    uint256 amount,
    uint256[] bdvs
);

Emitted when account removes multiple Deposits from the Silo. Occurs during Withdraw and Convert.

Parameter	Type	Description
`account`	`address`	The Farmer whose Deposit was removed.
`token`	`address`	Whitelisted token address.
`stems`	`uint32[]`	Stems of the Deposits.
`amounts`	`uint256[]`	The token amounts of the Deposits, corresponding to `stems`.
`amount`	`uint256`	Sum of `amounts`.
`bdvs`	`uint256[]`	The BDVs associated with the Deposits, corresponding to `stems` and `amounts`.

Transfer Single

event TransferSingle(
    address indexed operator,
    address indexed from,
    address indexed to,
    uint256 id,
    uint256 value
);

ERC-1155 event. Emitted when a Deposit is created, removed, or transferred.

Parameter	Type	Description
`operator`	`address`	The address that performed the operation.
`from`	`address`	The address the Deposit is being transferred from.
`to`	`address`	The address the Deposit is being transferred to.
`id`	`uint256`	The Deposit ID of the Deposit.
`value`	`uint256`	The amount of the Deposit.

Transfer Batch

event TransferBatch(
    address indexed operator,
    address indexed from,
    address indexed to,
    uint256[] ids,
    uint256[] values
);

ERC-1155 event. Emitted when multiple deposits are withdrawn or transferred.

Parameter	Type	Description
`operator`	`address`	The address that performed the operation.
`from`	`address`	The address the Deposit is being transferred from.
`to`	`address`	The address the Deposit is being transferred to.
`ids`	`uint256[]`	The Deposit IDs of the Deposits.
`values`	`uint256[]`	The amounts of the Deposits.

Remove Withdrawals

event RemoveWithdrawals(
    address indexed account,
    address indexed token,
    uint32[] seasons,
    uint256 amount
);

Legacy event. This event is kept for backwards compatibility in order for the ABI to generate properly.

Parameter	Type	Description
`account`	`address`	Farmer that claimed the Withdrawals.
`token`	`address`	Whitelisted token address.
`seasons`	`uint32[]`	Seasons of claimed Withdrawn assets.
`amount`	`uint256`	Amount of claimed asset.

Remove Withdrawal

event RemoveWithdrawal(
    address indexed account,
    address indexed token,
    uint32 season,
    uint256 amount
);