Overview
Gem Farm lets you offer a yield-bearing facility to loyal NFT ("gem" 💎) stakers.
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
Last updated