IAlgebraFarming
Algebra Farming Interface
Allows farming nonfungible liquidity tokens in exchange for reward tokens
Events
IncentiveDetached
event IncentiveDetached(contract IERC20Minimal rewardToken, contract IERC20Minimal bonusRewardToken, contract IAlgebraPool pool, address virtualPool, uint256 startTime, uint256 endTime)
Event emitted when a liquidity mining incentive has been stopped from the outside
rewardToken
contract IERC20Minimal
The token being distributed as a reward
bonusRewardToken
contract IERC20Minimal
The token being distributed as a bonus reward
pool
contract IAlgebraPool
The Algebra pool
virtualPool
address
The detached virtual pool address
startTime
uint256
The time when the incentive program begins
endTime
uint256
The time when rewards stop accruing
IncentiveAttached
event IncentiveAttached(contract IERC20Minimal rewardToken, contract IERC20Minimal bonusRewardToken, contract IAlgebraPool pool, address virtualPool, uint256 startTime, uint256 endTime)
Event emitted when a liquidity mining incentive has been runned again from the outside
rewardToken
contract IERC20Minimal
The token being distributed as a reward
bonusRewardToken
contract IERC20Minimal
The token being distributed as a bonus reward
pool
contract IAlgebraPool
The Algebra pool
virtualPool
address
The attached virtual pool address
startTime
uint256
The time when the incentive program begins
endTime
uint256
The time when rewards stop accruing
FarmEntered
event FarmEntered(uint256 tokenId, bytes32 incentiveId, uint128 liquidity, uint256 tokensLocked)
Event emitted when a Algebra LP token has been farmd
tokenId
uint256
The unique identifier of an Algebra LP token
incentiveId
bytes32
The incentive in which the token is farming
liquidity
uint128
The amount of liquidity farmd
tokensLocked
uint256
The amount of tokens locked for multiplier
FarmEnded
event FarmEnded(uint256 tokenId, bytes32 incentiveId, address rewardAddress, address bonusRewardToken, address owner, uint256 reward, uint256 bonusReward)
Event emitted when a Algebra LP token has been exitFarmingd
tokenId
uint256
The unique identifier of an Algebra LP token
incentiveId
bytes32
The incentive in which the token is farming
rewardAddress
address
The token being distributed as a reward
bonusRewardToken
address
The token being distributed as a bonus reward
owner
address
The address where claimed rewards were sent to
reward
uint256
The amount of reward tokens to be distributed
bonusReward
uint256
The amount of bonus reward tokens to be distributed
IncentiveMaker
event IncentiveMaker(address incentiveMaker)
Emitted when the incentive maker is changed
incentiveMaker
address
The incentive maker after the address was changed
FarmingCenter
event FarmingCenter(address farmingCenter)
Emitted when the farming center is changed
farmingCenter
address
The farming center after the address was changed
RewardsAdded
event RewardsAdded(uint256 rewardAmount, uint256 bonusRewardAmount, bytes32 incentiveId)
Event emitted when rewards were added
rewardAmount
uint256
The additional amount of main token
bonusRewardAmount
uint256
The additional amount of bonus token
incentiveId
bytes32
The ID of the incentive for which rewards were added
RewardClaimed
event RewardClaimed(address to, uint256 reward, address rewardAddress, address owner)
Event emitted when a reward token has been claimed
to
address
The address where claimed rewards were sent to
reward
uint256
The amount of reward tokens claimed
rewardAddress
address
The token reward address
owner
address
The address where claimed rewards were sent to
Functions
nonfungiblePositionManager
function nonfungiblePositionManager() external view returns (contract INonfungiblePositionManager)
view external
The nonfungible position manager with which this farming contract is compatible
Returns:
[0]
contract INonfungiblePositionManager
farmingCenter
function farmingCenter() external view returns (contract IFarmingCenter)
view external
The farming Center
Returns:
[0]
contract IFarmingCenter
deployer
function deployer() external returns (contract IAlgebraPoolDeployer)
external
The pool deployer
Returns:
[0]
contract IAlgebraPoolDeployer
setIncentiveMaker
function setIncentiveMaker(address _incentiveMaker) external
external
Updates the incentive maker
_incentiveMaker
address
The new incentive maker address
incentives
function incentives(bytes32 incentiveId) external view returns (uint256 totalReward, uint256 bonusReward, address virtualPoolAddress, uint24 minimalPositionWidth, uint224 totalLiquidity, address multiplierToken, struct IAlgebraFarming.Tiers tiers)
view external
Represents a farming incentive
incentiveId
bytes32
The ID of the incentive computed from its parameters
Returns:
totalReward
uint256
bonusReward
uint256
virtualPoolAddress
address
minimalPositionWidth
uint24
totalLiquidity
uint224
multiplierToken
address
tiers
struct IAlgebraFarming.Tiers
detachIncentive
function detachIncentive(struct IIncentiveKey.IncentiveKey key) external
external
Detach incentive from the pool
key
struct IIncentiveKey.IncentiveKey
The key of the incentive
attachIncentive
function attachIncentive(struct IIncentiveKey.IncentiveKey key) external
external
Attach incentive to the pool
key
struct IIncentiveKey.IncentiveKey
The key of the incentive
rewards
function rewards(address owner, contract IERC20Minimal rewardToken) external view returns (uint256 rewardsOwed)
view external
Returns amounts of reward tokens owed to a given address according to the last time all farms were updated
owner
address
The owner for which the rewards owed are checked
rewardToken
contract IERC20Minimal
The token for which to check rewards
Returns:
rewardsOwed
uint256
The amount of the reward token claimable by the owner
setFarmingCenterAddress
function setFarmingCenterAddress(address _farmingCenter) external
external
Updates farming center address
_farmingCenter
address
The new farming center contract address
enterFarming
function enterFarming(struct IIncentiveKey.IncentiveKey key, uint256 tokenId, uint256 tokensLocked) external
external
enter farming for Algebra LP token
key
struct IIncentiveKey.IncentiveKey
The key of the incentive for which to enterFarming the NFT
tokenId
uint256
The ID of the token to exitFarming
tokensLocked
uint256
The amount of tokens locked for boost
exitFarming
function exitFarming(struct IIncentiveKey.IncentiveKey key, uint256 tokenId, address _owner) external
external
exitFarmings for Algebra LP token
key
struct IIncentiveKey.IncentiveKey
The key of the incentive for which to exitFarming the NFT
tokenId
uint256
The ID of the token to exitFarming
_owner
address
Owner of the token
claimReward
function claimReward(contract IERC20Minimal rewardToken, address to, uint256 amountRequested) external returns (uint256 reward)
external
Transfers `amountRequested` of accrued `rewardToken` rewards from the contract to the recipient `to`
rewardToken
contract IERC20Minimal
The token being distributed as a reward
to
address
The address where claimed rewards will be sent to
amountRequested
uint256
The amount of reward tokens to claim. Claims entire reward amount if set to 0.
Returns:
reward
uint256
The amount of reward tokens claimed
claimRewardFrom
function claimRewardFrom(contract IERC20Minimal rewardToken, address from, address to, uint256 amountRequested) external returns (uint256 reward)
external
Transfers `amountRequested` of accrued `rewardToken` rewards from the contract to the recipient `to` only for FarmingCenter
rewardToken
contract IERC20Minimal
The token being distributed as a reward
from
address
The address of position owner
to
address
The address where claimed rewards will be sent to
amountRequested
uint256
The amount of reward tokens to claim. Claims entire reward amount if set to 0.
Returns:
reward
uint256
The amount of reward tokens claimed
getRewardInfo
function getRewardInfo(struct IIncentiveKey.IncentiveKey key, uint256 tokenId) external returns (uint256 reward, uint256 bonusReward)
external
Calculates the reward amount that will be received for the given farm
key
struct IIncentiveKey.IncentiveKey
The key of the incentive
tokenId
uint256
The ID of the token
Returns:
reward
uint256
The reward accrued to the NFT for the given incentive thus far
bonusReward
uint256
The bonus reward accrued to the NFT for the given incentive thus far