//SPDX-License-Identifier: MIT pragma solidity =0.7.6; pragma abicoder v2; import '@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol'; import '@uniswap/v3-core/contracts/interfaces/IUniswapV3Factory.sol'; import '@uniswap/v3-core/contracts/interfaces/IUniswapV3Pool.sol'; import '@uniswap/v3-core/contracts/interfaces/IERC20Minimal.sol'; import '@uniswap/v3-periphery/contracts/interfaces/INonfungiblePositionManager.sol'; import '@uniswap/v3-periphery/contracts/interfaces/IMulticall.sol'; /** * @title Uniswap V3 Staker Interface * @notice Allows staking nonfungible liquidity tokens in exchange for reward tokens */ interface IUniswapV3Staker is IERC721Receiver, IMulticall { /** * @param rewardToken The token being distributed as a reward * @param pool The Uniswap V3 pool * @param startTime The time when the incentive program begins * @param endTime The time when rewards stop accruing * @param refundee The address which receives any remaining reward tokens when the incentive is ended */ struct IncentiveKey { IERC20Minimal rewardToken; IUniswapV3Pool pool; uint256 startTime; uint256 endTime; address refundee; } /** * @notice The Uniswap V3 Factory */ function factory() external view returns (IUniswapV3Factory); /** * @notice The nonfungible position manager with which this staking contract is compatible */ function nonfungiblePositionManager() external view returns (INonfungiblePositionManager); /** * @notice The max duration of an incentive in seconds */ function maxIncentiveDuration() external view returns (uint256); /** * @notice The max amount of seconds into the future the incentive startTime can be set */ function maxIncentiveStartLeadTime() external view returns (uint256); /** * @notice Represents a staking incentive * @param incentiveId The ID of the incentive computed from its parameters * @return totalRewardUnclaimed The amount of reward token not yet claimed by users * @return totalSecondsClaimedX128 Total liquidity-seconds claimed, represented as a UQ32.128 * @return numberOfStakes The count of deposits that are currently staked for the incentive */ function incentives(bytes32 incentiveId) external view returns ( uint256 totalRewardUnclaimed, uint160 totalSecondsClaimedX128, uint96 numberOfStakes ); /** * @notice Returns information about a deposited NFT * @return owner The owner of the deposited NFT * @return numberOfStakes Counter of how many incentives for which the liquidity is staked * @return tickLower The lower tick of the range * @return tickUpper The upper tick of the range */ function deposits(uint256 tokenId) external view returns ( address owner, uint48 numberOfStakes, int24 tickLower, int24 tickUpper ); /** * @notice Returns information about a staked liquidity NFT * @param tokenId The ID of the staked token * @param incentiveId The ID of the incentive for which the token is staked * @return secondsPerLiquidityInsideInitialX128 secondsPerLiquidity represented as a UQ32.128 * @return liquidity The amount of liquidity in the NFT as of the last time the rewards were computed */ function stakes(uint256 tokenId, bytes32 incentiveId) external view returns (uint160 secondsPerLiquidityInsideInitialX128, uint128 liquidity); /** * @notice Returns amounts of reward tokens owed to a given address according to the last time all stakes were updated * @param rewardToken The token for which to check rewards * @param owner The owner for which the rewards owed are checked * @return rewardsOwed The amount of the reward token claimable by the owner */ function rewards(IERC20Minimal rewardToken, address owner) external view returns (uint256 rewardsOwed); /** * @notice Creates a new liquidity mining incentive program * @param key Details of the incentive to create * @param reward The amount of reward tokens to be distributed */ function createIncentive(IncentiveKey memory key, uint256 reward) external; /** * @notice Ends an incentive after the incentive end time has passed and all stakes have been withdrawn * @param key Details of the incentive to end * @return refund The remaining reward tokens when the incentive is ended */ function endIncentive(IncentiveKey memory key) external returns (uint256 refund); /** * @notice Transfers ownership of a deposit from the sender to the given recipient * @param tokenId The ID of the token (and the deposit) to transfer * @param to The new owner of the deposit */ function transferDeposit(uint256 tokenId, address to) external; /** * @notice Withdraws a Uniswap V3 LP token `tokenId` from this contract to the recipient `to` * @param tokenId The unique identifier of an Uniswap V3 LP token * @param to The address where the LP token will be sent * @param data An optional data array that will be passed along to the `to` address via the NFT safeTransferFrom */ function withdrawToken( uint256 tokenId, address to, bytes memory data ) external; /** * @notice Stakes a Uniswap V3 LP token * @param key The key of the incentive for which to stake the NFT * @param tokenId The ID of the token to stake */ function stakeToken(IncentiveKey memory key, uint256 tokenId) external; /** * @notice Unstakes a Uniswap V3 LP token * @param key The key of the incentive for which to unstake the NFT * @param tokenId The ID of the token to unstake */ function unstakeToken(IncentiveKey memory key, uint256 tokenId) external; /** * @notice Transfers `amountRequested` of accrued `rewardToken` rewards from the contract to the recipient `to` * @param rewardToken The token being distributed as a reward * @param to The address where claimed rewards will be sent to * @param amountRequested The amount of reward tokens to claim. Claims entire reward amount if set to 0. * @return reward The amount of reward tokens claimed */ function claimReward( IERC20Minimal rewardToken, address to, uint256 amountRequested ) external returns (uint256 reward); /** * @notice Calculates the reward amount that will be received for the given stake * @param key The key of the incentive * @param tokenId The ID of the token * @return reward The reward accrued to the NFT for the given incentive thus far */ function getRewardInfo(IncentiveKey memory key, uint256 tokenId) external returns (uint256 reward, uint160 secondsInsideX128); /** * @notice Event emitted when a liquidity mining incentive has been created * @param rewardToken The token being distributed as a reward * @param pool The Uniswap V3 pool * @param startTime The time when the incentive program begins * @param endTime The time when rewards stop accruing * @param refundee The address which receives any remaining reward tokens after the end time * @param reward The amount of reward tokens to be distributed */ event IncentiveCreated( IERC20Minimal indexed rewardToken, IUniswapV3Pool indexed pool, uint256 startTime, uint256 endTime, address refundee, uint256 reward ); /** * @notice Event that can be emitted when a liquidity mining incentive has ended * @param incentiveId The incentive which is ending * @param refund The amount of reward tokens refunded */ event IncentiveEnded(bytes32 indexed incentiveId, uint256 refund); /** * @notice Emitted when ownership of a deposit changes * @param tokenId The ID of the deposit (and token) that is being transferred * @param oldOwner The owner before the deposit was transferred * @param newOwner The owner after the deposit was transferred */ event DepositTransferred(uint256 indexed tokenId, address indexed oldOwner, address indexed newOwner); /** * @notice Event emitted when a Uniswap V3 LP token has been staked * @param tokenId The unique identifier of an Uniswap V3 LP token * @param liquidity The amount of liquidity staked * @param incentiveId The incentive in which the token is staking */ event TokenStaked(uint256 indexed tokenId, bytes32 indexed incentiveId, uint128 liquidity); /** * @notice Event emitted when a Uniswap V3 LP token has been unstaked * @param tokenId The unique identifier of an Uniswap V3 LP token * @param incentiveId The incentive in which the token is staking */ event TokenUnstaked(uint256 indexed tokenId, bytes32 indexed incentiveId); /** * @notice Event emitted when a reward token has been claimed * @param to The address where claimed rewards were sent to * @param reward The amount of reward tokens claimed */ event RewardClaimed(address indexed to, uint256 reward); }