StrategyHypercertFractionOffer
LooksRare protocol team (👀,💎); bitbeckers;
StrategyHypercertFractionOffer
This contract offers a single execution strategy for users to bid on a specific amount of units in an hypercerts that's for sale. Example: Alice has 100 units of a hypercert (id: 42) for sale at a minimum price of 0.001 ETH/unit. Bob wants to buy 10 units. Bob can create a taker bid order with the following parameters: - unitAmount: 10000 // Total amount for sale; in amounts array - minUnitAmount: 100 // Minimum amount to buy; in additionalParameters - maxUnitAmount: 1000 // Maximum amount to buy; in additionalParameters - acceptedTokenAmount: 1000000000000000 (0.001 ETH in wei) - acceptedTokenAddress: 0x0000000000000000000000000000000000000000 - proof: [0xsdadfa....s9fds,0xdasdas...asff8e] This strategy will validate the available units and the price.This contract offers execution strategies for users to create maker bid offers for items in a collection. There are three available functions: 1. executeCollectionStrategyWithTakerAsk --> it applies to all itemIds in a collection 2. executeCollectionStrategyWithTakerAskWithAllowlist --> it allows adding merkle proof criteria for accounts.The bidder can only bid on 1 item id at a time. 1. If ERC721, the amount must be 1. 2. If ERC1155, the amount can be greater than 1. 3. If Hypercert, the amount can be greater than 1 because they represent units held by the hypercert.
Use cases can include tiered pricing; think early bird tickets.
Methods​
executeHypercertFractionStrategyWithTakerBid​
function executeHypercertFractionStrategyWithTakerBid(OrderStructs.Taker takerBid, OrderStructs.Maker makerAsk) external view returns (uint256 price, uint256[] itemIds, uint256[] amounts, bool isNonceInvalidated)
Parameters​
| Name | Type | Description |
|---|---|---|
| takerBid | OrderStructs.Taker | undefined |
| makerAsk | OrderStructs.Maker | undefined |
Returns​
| Name | Type | Description |
|---|---|---|
| price | uint256 | undefined |
| itemIds | uint256[] | undefined |
| amounts | uint256[] | undefined |
| isNonceInvalidated | bool | undefined |
executeHypercertFractionStrategyWithTakerBidWithAllowlist​
function executeHypercertFractionStrategyWithTakerBidWithAllowlist(OrderStructs.Taker takerBid, OrderStructs.Maker makerAsk) external view returns (uint256 price, uint256[] itemIds, uint256[] amounts, bool isNonceInvalidated)
Parameters​
| Name | Type | Description |
|---|---|---|
| takerBid | OrderStructs.Taker | undefined |
| makerAsk | OrderStructs.Maker | undefined |
Returns​
| Name | Type | Description |
|---|---|---|
| price | uint256 | undefined |
| itemIds | uint256[] | undefined |
| amounts | uint256[] | undefined |
| isNonceInvalidated | bool | undefined |
isLooksRareV2Strategy​
function isLooksRareV2Strategy() external pure returns (bool)
This function acts as a safety check for the protocol's owner when adding new execution strategies.
Returns​
| Name | Type | Description |
|---|---|---|
| _0 | bool | Whether it is a LooksRare V2 protocol strategy |
isMakerOrderValid​
function isMakerOrderValid(OrderStructs.Maker makerAsk, bytes4 functionSelector) external view returns (bool isValid, bytes4 errorSelector)
Parameters​
| Name | Type | Description |
|---|---|---|
| makerAsk | OrderStructs.Maker | undefined |
| functionSelector | bytes4 | undefined |
Returns​
| Name | Type | Description |
|---|---|---|
| isValid | bool | undefined |
| errorSelector | bytes4 | undefined |
Errors​
AmountInvalid​
error AmountInvalid()
It is returned if the amount is invalid. For ERC721, any number that is not 1. For ERC1155 and Hypercert, if amount is 0.
LengthsInvalid​
error LengthsInvalid()
It is returned if there is either a mismatch or an error in the length of the array(s).
MerkleProofInvalid​
error MerkleProofInvalid()
It is returned if the merkle proof provided is invalid.
OrderInvalid​
error OrderInvalid()
It is returned if the order is permanently invalid. There may be an issue with the order formatting.