Overview

Gem Farm lets you offer a yield-bearing facility to loyal NFT ("gem" 💎) stakers.

❗IMPORTANT: as it currently stands, Gem Farm is unaudited software. We're looking for community members to help review the protocol, or projects to help fund a professional audit. ❗

TLDR

• Anyone with a wallet can start a farm

• Each new farm automatically starts an instance of Gem Bank, used for storing the staked NFTs

• Each farm comes with a bunch of config knobs you can turn, such as minimum staking period, and cooldown period

• When starting a farm you can decide on up to 2 rewards. For each one you choose:

  • Reward mint

  • Reward type - fixed or variable

• As of right now, after the farm has been started, the above can't be changed. This is done for security reasons

  • Although the reward mint / type can't be changed - the actual schedules / amounts absolutely can!

  • Worst case you start a new farm with new mints / types

• After the farm is ready, you as the farm manager authorize one or multiple funders (could be just you), who fund the rewards pots with $$$ and configure the reward schedule

• Users show up and register as farmers. Once registered they can stake / unstake & claim rewards

  • Claiming can be done at any point without them having to unstake

• Any unused rewards can be cancelled

• There is also an option to lock rewards in place, to effectively "guarantee" them to users

• Reward distribution depends on both gems staked, and gem rarity

Farm Config

• As the farm manager it is possible to configure the following variables for the farm:

  • Min staking period - after staked, gems can't be unstaked until this number of seconds passes

  • Min cooldown period - after unstaked, gems can't be withdrawn until they complete a "cooldown" period of this many seconds

  • Unstaking fee - an additional fee, in lamports, charged on unstaking

• These are set at farm initialization, but can also be tweaked later (which would affect future stakers, but not past)

• Note: this is in addition to configuring reward schedules by funders, described below

Max Counts

• This is a new feature since Feb-22

• You can now set any of:

  • max farmer count per farm

  • max gem count per farm

  • max rarity point per farm

• All of the above are optional, but if you configure any of them they will be checked

  • Eg you could say you only want to allow 200 farmers to stake on your farm. Once that count is reached, further staking instructions will fail

• Max counts can be configured both during initialization of the farm - and during farm update

  • Both require farm manager to sign off

• To see how it works see this test file

Funder lifecycle

• A funder account needs to be authorized by the farm manager before they can deposit reward funds into one of the reward pots

• When depositing, the funder also specifies a funding schedule - which can be fixed or variable

  • Each comes with its own config knobs explained in detail below

• Regardless of the schedule, the Funder specifies 2 things:

  • Total reward amount

  • Total reward duration

• Amount -

  • Is added to any previously unused rewards (eg if 1000 was deposited, but only 200 accrued to stakers, 800 is available for next funding cycle)

  • Can limit the number of total stakers (fixed rewards)

• Duration -

  • Dictates for how long the current funding schedule will be active

  • Anyone who stakes before the end of the schedule, will get a proportional amount of rewards attributed to them - anyone who stakes after gets nothing

• After the initial funding, the farm manager / funder have a number of options:

  • Do nothing - farmers will be able to stake / unstake / claim current rewards

  • Cancel the reward - any rewards not yet accrued / promised (fixed rate concept) will be returned, and reward end will be set to current timestamp

  • Fund another reward - new duration can be specified, which can be shorter or longer than the current one, and new funding added to existing

  • Lock reward - this sets lock timestamp = reward end timestamp. After set, there is no way for the farm manager to withdraw the funding until after reward end passes

Farmer lifecycle

• The user (farmer) starts by initializing a new farmer acount. This is used to store all the data associated with them, such as how long they've been staking for

• Next they deposit their gems into the vault

  • You as the farm manager can restrict what NFTs can / can't go into the vault

  • That's because under the hood Gem Farm uses Gem Bank, with all of its wonderful features
• Finally they click "stake". This locks up the vault and starts accruing any rewards that are currently funded

• Farmers can claim their rewards anytime, without unstaking

  • There is no minimum claim amount, as long as it's >0, Farmer gets a payout

  • Both rewards are claimed at the same time, it's not possible to only do one

• When the farmer is done staking, they hit "unstake". This unlocks the vault and let's them withdraw their gems

• Note: the above steps map to how the code works, but as the front end dev you can hide many of these steps from the user. Eg you can init a new Farmer account, deposit their gems, and lock their vault all in a single click

Farm Treasury

• The only type of fee currently collected by the farm treasury is the unstaking fee

• Payouts can be made from the treasury to any address, for any amount (within what's accumulated ofc) by the farm manager