How does Demeter Work?
- 1.Approve USDs spend
- 2.Input pool parameters and farm parameters and execute a transaction to create farm and pay the farm creation fee
- If pool does not exist then the transaction reverts.
- If the user does not have enough USDs for fee payment then the transaction reverts. The fee is 100 USDs. If one of the pool tokens is SPA or USDs, then a discounted fee of 50 USDs is applicable.
- 3.After creation of the farm contract, reward token managers can update reward related parameters.
- 4.After creation of the farm contract, the farm admin can manage some attributes of the farm like start date, cooldown period, close/pause farm etc.
- 1.Token address
- Token A
- Token B
- 2.Fee Tier
- 1.Farm admin: It is the address that will have admin control on the farm. It can be the same as the deployer’s address or any other desired address which will be used to manage the farm.
- 2.Price range for the LP
- 3.Reward tokens
- Token addresses
- Token address managers; Each token will have its own token manager
- Reward tokens have to be added at the time of farm creation and cant be added after the farm is created. Maximum 4 reward tokens are possible for a farm. SPA is added as a default reward token for farms on Arbitrum and Ethereum networks. So for these networks, 3 additional reward tokens can be added by the farm creator.
- 4.Cooldown Period for Locked Liquidity - It is the number of days users have to wait after initiating cooldown before they can unstake from a locked position. Only whole numbers are allowed for this parameter.
- If Cooldown Period = 0, then the farm only allows creation of unlocked positions. Unlocked positions can be unstaked anytime.
- If Cooldown Period > =1, the farm will allow creation of both locked and unlocked positions. For unstaking a locked position, users have to initiate cooldown and wait for cooldown period before unstaking. Farm
- 5.Start date time stamp - Reward emission starts from this date. This date can be changed by the farm admin using admin functions. However date change is not allowed after the farm starts.
- The farms start accepting liquidity immediately after the creation of the farm contract. However, the reward accrual starts from the farm start date time stamp.
Demeter will charge a flat $100 fee to launch the farm. When paired against USDs or SPA, the fee will discounted, only $50. The fee collected belongs to the SPA stakers and can be transferred directly to the wallet address where all Sperax protocol fees are collected. Fees have to be paid in USDs in the beginning, more payment methods can be added in future. Fee amount can be changed in future through governance.
No one can make changes to the farm contract once deployed. Farm admins can do the following:
- 1.Transfer farm ownership to another address
- 2.Change start date of the farm - Farm will emit rewards from this date. The date can be changed after farm creation. However date change is not allowed after the farm starts.
- 3.Update cooldown period of the locked positions
- 4.Pause or Unpause the farm
- Pause the farm - All reward distributions are paused, LPs do not earn any rewards during this period. Withdrawals are allowed (including lockup LPs) and users can also claim previously accrued rewards. Admin/managers can make changes to the distribution rates and the other parameters when the farm is paused.
- Unpause the farm - Resume the reward distribution. The reward distribution rate remains the same as set by the reward managers.
- 5.Close the farm - Once the farm is closed, all liquidity providers including lockup users can now unstake their liquidity pool tokens and claim the accrued rewards from the farm
Each reward token will be assigned a reward token manager. Farm admin cannot update the reward token manager once the farms are deployed. Reward token managers can do the following:
- 1.Add reward token balance
- 2.Update reward distribution rate per second for each token. Only future distribution rates can be affected through this. Reward distribution can be paused by setting the rate to 0. These actions can be done: For all liquidity providers For lockup liquidity providers (If cooldown period is greater than 0)
- 3.Withdraw reward tokens (Any rewards already accrued to LPs cannot be removed)
- 4.Transfer reward token management to another address
Protocols can call functions through non-EOA addresses and manage the farm. This is for multi-sigs or DAO’s to manage the pool and farm.
Protocols do not have the power to add or update the token reward manager for the SPA token. Once SPA gauge is launched, this functionality will be passed on to the SPA gauge.