MultiBuy
Smart contract allowing to purchase multiple veBoosts on Warden through one transaction
The Warden MultiBuy system allows any Buyer to purchase multiple veBoosts at once, by giving a total amount of veCRV directly.
This system can either be used through the Warden UI, or directly through smart contracts.
The MultiBuy system also allows the Buyer to set parameters to better fit the Order to its needs and to the maximum price willing to be paid for veBoosts.
The available parameters are:
- boostAmount: The total of veCRV Boost to purchase.
- maxPrice: The maximum price to pay for a veBoost. All Offers listing a higher price will be ignored.
- minRequiredAmount: The minimum size in veCRV a veBoost should have, allowing the purchase of less but bigger veBoosts.
- acceptableSlippage: The percentage of slippage acceptable on the total purchase of veBoosts. Because all veBoosts size are calculated in BPS, the total veCRV Boost purchased might not be exactly equal to the given boostAmount. This parameter allows to revert the execution is the total Boost received is too far from the asked amount.
The system currently offers 3 methods to purchase multiple veBoosts:
- The Simple Multi Buy: This method will go over all the Offers listed on Warden, without any sorting, to purchase veBoosts on any Offer fitting the given parameters (price & minRequiredAmount).
- The PreSorted MultiBuy: This method takes an array of Offer indexes in parameters, allowing to loop over a selection of Offers (sorted through any method) to purchase veBoost on valid Offers that fit the given parameters.
- The Sorted MultiBuy: This method will sort all the Offers listed on Warden, to loop over them from the lowest price to the highest, to purchase veBoosts on Offers that fit the given parameters.
The smart contract current internal sorting method is the Quicksort. Optimizations on this method, and on all of the MultiBuy system, are always considered, to bring the most efficient method to purchase multiple veBoosts.
For any integration of this system in external smart contracts, it is advised to set the multiBuy address as an updatable parameter, as it could be replaced by an optimized version in the future.
After any type of MultiBuy, the Buyer will then need to call the user_checkpoint() method on all Curve V4 & Factory Gauges currently farming, to apply the newly received Boost
simpleMultiBuy
function simpleMultiBuy(address receiver, uint256 duration, uint256 boostAmount, uint256 maxPrice, uint256 minRequiredAmount, uint256 totalFeesAmount, uint256 acceptableSlippage) external returns (bool)Loops over Warden Offers to purchase veBoosts depending on given parameters
Parameters :
name | type | desc |
receiver | address | Address of the veBoosts receiver |
duration | uint256 | Duration (in weeks) for the veBoosts to purchase |
boostAmount | uint256 | Total Amount of veCRV boost to purchase |
maxPrice | uint256 | Maximum price for veBoost purchase, any Offer with a higher price will be skipped |
minRequiredAmount | uint256 | Minimum size of the Boost to buy, smaller will be skipped |
totalFeesAmount | uint256 | Maximum total amount of feeToken available to pay to for veBoost purchases (in wei) |
acceptableSlippage | uint256 | Maximum acceptable slippage for the total Boost amount purchased (in BPS) |
preSortedMultiBuy
function preSortedMultiBuy(address receiver, uint256 duration, uint256 boostAmount, uint256 maxPrice, uint256 minRequiredAmount, uint256 totalFeesAmount, uint256 acceptableSlippage, uint256[] memory sortedOfferIndexes) external returns (bool)Loops over a given Array of Warden Offers (pre-sorted if possible) to purchase veBoosts depending on given parameters
Parameters :
name | type | desc |
receiver | address | Address of the veBoosts receiver |
duration | uint256 | Duration (in weeks) for the veBoosts to purchase |
boostAmount | uint256 | Total Amount of veCRV boost to purchase |
maxPrice | uint256 | Maximum price for veBoost purchase, any Offer with a higher price will be skipped |
minRequiredAmount | uint256 | Minimum size of the Boost to buy, smaller will be skipped |
totalFeesAmount | uint256 | Maximum total amount of feeToken available to pay to for veBoost purchases (in wei) |
acceptableSlippage | uint256 | Maximum acceptable slippage for the total Boost amount purchased (in BPS) |
sortedOfferIndexes | uint256[] | Array of Warden Offer indexes (that can be sorted/only containing a given set or Orders) |
sortingMultiBuy
function sortingMultiBuy(address receiver, uint256 duration, uint256 boostAmount, uint256 maxPrice, uint256 minRequiredAmount, uint256 totalFeesAmount, uint256 acceptableSlippage) external returns (bool)Loops over Warden Offers sorted through the Quicksort method, sorted by price, to purchase veBoosts depending on given parameters
Parameters :
name | type | desc |
receiver | address | Address of the veBoosts receiver |
duration | uint256 | Duration (in weeks) for the veBoosts to purchase |
boostAmount | uint256 | Total Amount of veCRV boost to purchase |
maxPrice | uint256 | Maximum price for veBoost purchase, any Offer with a higher price will be skipped |
minRequiredAmount | uint256 | Minimum size of the Boost to buy, smaller will be skipped |
totalFeesAmount | uint256 | Maximum total amount of feeToken available to pay to for veBoost purchases (in wei) |
acceptableSlippage | uint256 | Maximum acceptable slippage for the total Boost amount purchased (in BPS) |
Last modified 3mo ago