// SPDX-License-Identifier: MIT
pragma solidity >=0.6.2 <0.8.0;
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize, which returns 0 for contracts in
// construction, since the code is only stored at the end of the
// constructor execution.
uint256 size;
// solhint-disable-next-line no-inline-assembly
assembly { size := extcodesize(account) }
return size > 0;
}
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
// solhint-disable-next-line avoid-low-level-calls, avoid-call-value
(bool success, ) = recipient.call{ value: amount }("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain`call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason, it is bubbled up by this
* function (like regular Solidity function calls).
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCall(target, data, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*
* _Available since v3.1._
*/
function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
require(isContract(target), "Address: call to non-contract");
// solhint-disable-next-line avoid-low-level-calls
(bool success, bytes memory returndata) = target.call{ value: value }(data);
return _verifyCallResult(success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {
require(isContract(target), "Address: static call to non-contract");
// solhint-disable-next-line avoid-low-level-calls
(bool success, bytes memory returndata) = target.staticcall(data);
return _verifyCallResult(success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
require(isContract(target), "Address: delegate call to non-contract");
// solhint-disable-next-line avoid-low-level-calls
(bool success, bytes memory returndata) = target.delegatecall(data);
return _verifyCallResult(success, returndata, errorMessage);
}
function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
if (success) {
return returndata;
} else {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
// solhint-disable-next-line no-inline-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
/*
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with GSN meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address payable) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes memory) {
this; // silence state mutability warning without generating bytecode - see https://github.com/ethereum/solidity/issues/2691
return msg.data;
}
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
import "./IERC165.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts may inherit from this and call {_registerInterface} to declare
* their support of an interface.
*/
abstract contract ERC165 is IERC165 {
/*
* bytes4(keccak256('supportsInterface(bytes4)')) == 0x01ffc9a7
*/
bytes4 private constant _INTERFACE_ID_ERC165 = 0x01ffc9a7;
/**
* @dev Mapping of interface ids to whether or not it's supported.
*/
mapping(bytes4 => bool) private _supportedInterfaces;
constructor () internal {
// Derived contracts need only register support for their own interfaces,
// we register support for ERC165 itself here
_registerInterface(_INTERFACE_ID_ERC165);
}
/**
* @dev See {IERC165-supportsInterface}.
*
* Time complexity O(1), guaranteed to always use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return _supportedInterfaces[interfaceId];
}
/**
* @dev Registers the contract as an implementer of the interface defined by
* `interfaceId`. Support of the actual ERC165 interface is automatic and
* registering its interface id is not required.
*
* See {IERC165-supportsInterface}.
*
* Requirements:
*
* - `interfaceId` cannot be the ERC165 invalid interface (`0xffffffff`).
*/
function _registerInterface(bytes4 interfaceId) internal virtual {
require(interfaceId != 0xffffffff, "ERC165: invalid interface id");
_supportedInterfaces[interfaceId] = true;
}
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.2 <0.8.0;
import "../../introspection/IERC165.sol";
/**
* @dev Required interface of an ERC1155 compliant contract, as defined in the
* https://eips.ethereum.org/EIPS/eip-1155[EIP].
*
* _Available since v3.1._
*/
interface IERC1155 is IERC165 {
/**
* @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
*/
event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
/**
* @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
* transfers.
*/
event TransferBatch(address indexed operator, address indexed from, address indexed to, uint256[] ids, uint256[] values);
/**
* @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
* `approved`.
*/
event ApprovalForAll(address indexed account, address indexed operator, bool approved);
/**
* @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
*
* If an {URI} event was emitted for `id`, the standard
* https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
* returned by {IERC1155MetadataURI-uri}.
*/
event URI(string value, uint256 indexed id);
/**
* @dev Returns the amount of tokens of token type `id` owned by `account`.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function balanceOf(address account, uint256 id) external view returns (uint256);
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
*
* Requirements:
*
* - `accounts` and `ids` must have the same length.
*/
function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids) external view returns (uint256[] memory);
/**
* @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
*
* Emits an {ApprovalForAll} event.
*
* Requirements:
*
* - `operator` cannot be the caller.
*/
function setApprovalForAll(address operator, bool approved) external;
/**
* @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address account, address operator) external view returns (bool);
/**
* @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - If the caller is not `from`, it must be have been approved to spend ``from``'s tokens via {setApprovalForAll}.
* - `from` must have a balance of tokens of type `id` of at least `amount`.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
* acceptance magic value.
*/
function safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes calldata data) external;
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `amounts` must have the same length.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
function safeBatchTransferFrom(address from, address to, uint256[] calldata ids, uint256[] calldata amounts, bytes calldata data) external;
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.2 <0.8.0;
import "./IERC1155.sol";
/**
* @dev Interface of the optional ERC1155MetadataExtension interface, as defined
* in the https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[EIP].
*
* _Available since v3.1._
*/
interface IERC1155MetadataURI is IERC1155 {
/**
* @dev Returns the URI for token type `id`.
*
* If the `\{id\}` substring is present in the URI, it must be replaced by
* clients with the actual token type ID.
*/
function uri(uint256 id) external view returns (string memory);
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
import "../../introspection/IERC165.sol";
/**
* _Available since v3.1._
*/
interface IERC1155Receiver is IERC165 {
/**
@dev Handles the receipt of a single ERC1155 token type. This function is
called at the end of a `safeTransferFrom` after the balance has been updated.
To accept the transfer, this must return
`bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
(i.e. 0xf23a6e61, or its own function selector).
@param operator The address which initiated the transfer (i.e. msg.sender)
@param from The address which previously owned the token
@param id The ID of the token being transferred
@param value The amount of tokens being transferred
@param data Additional data with no specified format
@return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
*/
function onERC1155Received(
address operator,
address from,
uint256 id,
uint256 value,
bytes calldata data
)
external
returns(bytes4);
/**
@dev Handles the receipt of a multiple ERC1155 token types. This function
is called at the end of a `safeBatchTransferFrom` after the balances have
been updated. To accept the transfer(s), this must return
`bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
(i.e. 0xbc197c81, or its own function selector).
@param operator The address which initiated the batch transfer (i.e. msg.sender)
@param from The address which previously owned the token
@param ids An array containing ids of each token being transferred (order and length must match values array)
@param values An array containing amounts of each token being transferred (order and length must match ids array)
@param data Additional data with no specified format
@return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
*/
function onERC1155BatchReceived(
address operator,
address from,
uint256[] calldata ids,
uint256[] calldata values,
bytes calldata data
)
external
returns(bytes4);
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20 {
/**
* @dev Returns the amount of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the amount of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves `amount` tokens from the caller's account to `recipient`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address recipient, uint256 amount) external returns (bool);
/**
* @dev Returns the remaining number of tokens that `spender` will be
* allowed to spend on behalf of `owner` through {transferFrom}. This is
* zero by default.
*
* This value changes when {approve} or {transferFrom} are called.
*/
function allowance(address owner, address spender) external view returns (uint256);
/**
* @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* IMPORTANT: Beware that changing an allowance with this method brings the risk
* that someone may use both the old and the new allowance by unfortunate
* transaction ordering. One possible solution to mitigate this race
* condition is to first reduce the spender's allowance to 0 and set the
* desired value afterwards:
* https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
*
* Emits an {Approval} event.
*/
function approve(address spender, uint256 amount) external returns (bool);
/**
* @dev Moves `amount` tokens from `sender` to `recipient` using the
* allowance mechanism. `amount` is then deducted from the caller's
* allowance.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
/**
* @dev Emitted when `value` tokens are moved from one account (`from`) to
* another (`to`).
*
* Note that `value` may be zero.
*/
event Transfer(address indexed from, address indexed to, uint256 value);
/**
* @dev Emitted when the allowance of a `spender` for an `owner` is set by
* a call to {approve}. `value` is the new allowance.
*/
event Approval(address indexed owner, address indexed spender, uint256 value);
}
// SPDX-License-Identifier: GPL-3.0
pragma solidity 0.7.6;
pragma experimental ABIEncoderV2;
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import "@openzeppelin/contracts/utils/ReentrancyGuard.sol";
import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
import "@openzeppelin/contracts/math/SafeMath.sol";
import "./base/Sweepable.sol";
import "./Super1155.sol";
import "./Staker.sol";
/**
@title A Shop contract for selling NFTs via direct minting through particular
pools with specific participation requirements.
@author Tim Clancy
This launchpad contract sells new items by minting them into existence. It
cannot be used to sell items that already exist.
*/
contract MintShop1155 is Sweepable, ReentrancyGuard {
using SafeERC20 for IERC20;
using SafeMath for uint256;
/// The public identifier for the right to set the payment receiver.
bytes32 public constant SET_PAYMENT_RECEIVER
= keccak256("SET_PAYMENT_RECEIVER");
/// The public identifier for the right to lock the payment receiver.
bytes32 public constant LOCK_PAYMENT_RECEIVER
= keccak256("LOCK_PAYMENT_RECEIVER");
/// The public identifier for the right to update the global purchase limit.
bytes32 public constant UPDATE_GLOBAL_LIMIT
= keccak256("UPDATE_GLOBAL_LIMIT");
/// The public identifier for the right to lock the global purchase limit.
bytes32 public constant LOCK_GLOBAL_LIMIT = keccak256("LOCK_GLOBAL_LIMIT");
/// The public identifier for the right to manage whitelists.
bytes32 public constant WHITELIST = keccak256("WHITELIST");
/// The public identifier for the right to manage item pools.
bytes32 public constant POOL = keccak256("POOL");
/// @dev A mask for isolating an item's group ID.
uint256 constant GROUP_MASK = uint256(uint128(~0)) << 128;
/// The item collection contract that minted items are sold from.
Super1155 public item;
/**
The address where the payment from each item buyer is sent. Care must be
taken that this address can actually take receipt of the Ether or ERC-20
earnings.
*/
address public paymentReceiver;
/**
A flag determining whether or not the `paymentReceiver` may be updated using
the `updatePaymentReceiver` function.
*/
bool public paymentReceiverLocked;
/**
A limit on the number of items that a particular address may purchase across
any number of pools in this shop.
*/
uint256 public globalPurchaseLimit;
/**
A flag determining whether or not the `globalPurchaseLimit` may be updated
using the `updateGlobalPurchaseLimit` function.
*/
bool public globalPurchaseLimitLocked;
/// A mapping of addresses to the number of items each has purchased globally.
mapping (address => uint256) public globalPurchaseCounts;
/**
The ID which should be taken by the next whitelist added. This value begins
at one in order to reserve the zero-identifier for representing no whitelist
at all, i.e. public.
*/
uint256 public nextWhitelistId = 1;
/**
A mapping of whitelist IDs to specific Whitelist elements. Whitelists may be
shared between pools via specifying their ID in a pool requirement.
*/
mapping (uint256 => Whitelist) public whitelists;
/// The next available ID to be assumed by the next pool added.
uint256 public nextPoolId;
/// A mapping of pool IDs to pools.
mapping (uint256 => Pool) public pools;
/**
This mapping relates each item group ID to the next item ID within that
group which should be issued, minus one.
*/
mapping (uint256 => uint256) public nextItemIssues;
/**
This struct is a source of mapping-free input to the `addPool` function.
@param name A name for the pool.
@param startTime The timestamp when this pool begins allowing purchases.
@param endTime The timestamp after which this pool disallows purchases.
@param purchaseLimit The maximum number of items a single address may
purchase from this pool.
@param singlePurchaseLimit The maximum number of items a single address may
purchase from this pool in a single transaction.
@param requirement A PoolRequirement requisite for users who want to
participate in this pool.
*/
struct PoolInput {
string name;
uint256 startTime;
uint256 endTime;
uint256 purchaseLimit;
uint256 singlePurchaseLimit;
PoolRequirement requirement;
}
/**
This struct tracks information about a single item pool in the Shop.
@param name A name for the pool.
@param startTime The timestamp when this pool begins allowing purchases.
@param endTime The timestamp after which this pool disallows purchases.
@param purchaseLimit The maximum number of items a single address may
purchase from this pool.
@param singlePurchaseLimit The maximum number of items a single address may
purchase from this pool in a single transaction.
@param purchaseCounts A mapping of addresses to the number of items each has
purchased from this pool.
@param requirement A PoolRequirement requisite for users who want to
participate in this pool.
@param itemGroups An array of all item groups currently present in this
pool.
@param currentPoolVersion A version number hashed with item group IDs before
being used as keys to other mappings. This supports efficient
invalidation of stale mappings.
@param itemCaps A mapping of item group IDs to the maximum number this pool
is allowed to mint.
@param itemMinted A mapping of item group IDs to the number this pool has
currently minted.
@param itemPricesLength A mapping of item group IDs to the number of price
assets available to purchase with.
@param itemPrices A mapping of item group IDs to a mapping of available
Price assets available to purchase with.
*/
struct Pool {
string name;
uint256 startTime;
uint256 endTime;
uint256 purchaseLimit;
uint256 singlePurchaseLimit;
mapping (address => uint256) purchaseCounts;
PoolRequirement requirement;
uint256[] itemGroups;
uint256 currentPoolVersion;
mapping (bytes32 => uint256) itemCaps;
mapping (bytes32 => uint256) itemMinted;
mapping (bytes32 => uint256) itemPricesLength;
mapping (bytes32 => mapping (uint256 => Price)) itemPrices;
}
/**
This enumeration type specifies the different access rules that may be
applied to pools in this shop. Access to a pool may be restricted based on
the buyer's holdings of either tokens or items.
@param Public This specifies a pool which requires no special asset holdings
to buy from.
@param TokenRequired This specifies a pool which requires the buyer to hold
some amount of ERC-20 tokens to buy from.
@param ItemRequired This specifies a pool which requires the buyer to hold
some amount of an ERC-1155 item to buy from.
@param PointRequired This specifies a pool which requires the buyer to hold
some amount of points in a Staker to buy from.
*/
enum AccessType {
Public,
TokenRequired,
ItemRequired,
PointRequired
}
/**
This struct tracks information about a prerequisite for a user to
participate in a pool.
@param requiredType The `AccessType` being applied to gate buyers from
participating in this pool. See `requiredAsset` for how additional data
can apply to the access type.
@param requiredAsset Some more specific information about the asset to
require. If the `requiredType` is `TokenRequired`, we use this address to
find the ERC-20 token that we should be specifically requiring holdings
of. If the `requiredType` is `ItemRequired`, we use this address to find
the item contract that we should be specifically requiring holdings of. If
the `requiredType` is `PointRequired`, we treat this address as the
address of a Staker contract. Do note that in order for this to work, the
Staker must have approved this shop as a point spender.
@param requiredAmount The amount of the specified `requiredAsset` required
for the buyer to purchase from this pool.
@param whitelistId The ID of an address whitelist to restrict participants
in this pool. To participate, a purchaser must have their address present
in the corresponding whitelist. Other requirements from `requiredType`
also apply. An ID of 0 is a sentinel value for no whitelist required.
*/
struct PoolRequirement {
AccessType requiredType;
address requiredAsset;
uint256 requiredAmount;
uint256 whitelistId;
}
/**
This enumeration type specifies the different assets that may be used to
complete purchases from this mint shop.
@param Point This specifies that the asset being used to complete
this purchase is non-transferrable points from a `Staker` contract.
@param Ether This specifies that the asset being used to complete
this purchase is native Ether currency.
@param Token This specifies that the asset being used to complete
this purchase is an ERC-20 token.
*/
enum AssetType {
Point,
Ether,
Token
}
/**
This struct tracks information about a single asset with the associated
price that an item is being sold in the shop for. It also includes an
`asset` field which is used to convey optional additional data about the
asset being used to purchase with.
@param assetType The `AssetType` type of the asset being used to buy.
@param asset Some more specific information about the asset to charge in.
If the `assetType` is Point, we use this address to find the specific
Staker whose points are used as the currency.
If the `assetType` is Ether, we ignore this field.
If the `assetType` is Token, we use this address to find the
ERC-20 token that we should be specifically charging with.
@param price The amount of the specified `assetType` and `asset` to charge.
*/
struct Price {
AssetType assetType;
address asset;
uint256 price;
}
/**
This struct is a source of mapping-free input to the `addWhitelist`
function.
@param expiryTime A block timestamp after which this whitelist is
automatically considered inactive, no matter the value of `isActive`.
@param isActive Whether or not this whitelist is actively restricting
purchases in blocks ocurring before `expiryTime`.
@param addresses An array of addresses to whitelist for participation in a
purchases guarded by a whitelist.
*/
struct WhitelistInput {
uint256 expiryTime;
bool isActive;
address[] addresses;
}
/**
This struct tracks information about a single whitelist known to this shop.
Whitelists may be shared across multiple different item pools.
@param expiryTime A block timestamp after which this whitelist is
automatically considered inactive, no matter the value of `isActive`.
@param isActive Whether or not this whitelist is actively restricting
purchases in blocks ocurring before `expiryTime`.
@param currentWhitelistVersion A version number hashed with item group IDs
before being used as keys to other mappings. This supports efficient
invalidation of stale mappings to easily clear the whitelist.
@param addresses A mapping of hashed addresses to a flag indicating whether
this whitelist allows the address to participate in a purchase.
*/
struct Whitelist {
uint256 expiryTime;
bool isActive;
uint256 currentWhitelistVersion;
mapping (bytes32 => bool) addresses;
}
/**
This struct tracks information about a single item being sold in a pool.
@param groupId The group ID of the specific NFT in the collection being sold
by a pool.
@param cap The maximum number of items that this shop may mint for the
specified `groupId`.
@param minted The number of items that a pool has currently minted of the
specified `groupId`.
@param prices The `Price` options that may be used to purchase this item
from its pool. A buyer may fulfill the purchase with any price option.
*/
struct PoolItem {
uint256 groupId;
uint256 cap;
uint256 minted;
Price[] prices;
}
/**
This struct contains the information gleaned from the `getPool` and
`getPools` functions; it represents a single pool's data.
@param name A name for the pool.
@param startTime The timestamp when this pool begins allowing purchases.
@param endTime The timestamp after which this pool disallows purchases.
@param purchaseLimit The maximum number of items a single address may
purchase from this pool.
@param singlePurchaseLimit The maximum number of items a single address may
purchase from this pool in a single transaction.
@param requirement A PoolRequirement requisite for users who want to
participate in this pool.
@param itemMetadataUri The metadata URI of the item collection being sold
by this launchpad.
@param items An array of PoolItems representing each item for sale in the
pool.
*/
struct PoolOutput {
string name;
uint256 startTime;
uint256 endTime;
uint256 purchaseLimit;
uint256 singlePurchaseLimit;
PoolRequirement requirement;
string itemMetadataUri;
PoolItem[] items;
}
/**
This struct contains the information gleaned from the `getPool` and
`getPools` functions; it represents a single pool's data. It also includes
additional information relevant to a user's address lookup.
@param name A name for the pool.
@param startTime The timestamp when this pool begins allowing purchases.
@param endTime The timestamp after which this pool disallows purchases.
@param purchaseLimit The maximum number of items a single address may
purchase from this pool.
@param singlePurchaseLimit The maximum number of items a single address may
purchase from this pool in a single transaction.
@param requirement A PoolRequirement requisite for users who want to
participate in this pool.
@param itemMetadataUri The metadata URI of the item collection being sold by
this launchpad.
@param items An array of PoolItems representing each item for sale in the
pool.
@param purchaseCount The amount of items purchased from this pool by the
specified address.
@param whitelistStatus Whether or not the specified address is whitelisted
for this pool.
*/
struct PoolAddressOutput {
string name;
uint256 startTime;
uint256 endTime;
uint256 purchaseLimit;
uint256 singlePurchaseLimit;
PoolRequirement requirement;
string itemMetadataUri;
PoolItem[] items;
uint256 purchaseCount;
bool whitelistStatus;
}
/**
An event to track an update to this shop's `paymentReceiver`.
@param updater The calling address which updated the payment receiver.
@param oldPaymentReceiver The address of the old payment receiver.
@param newPaymentReceiver The address of the new payment receiver.
*/
event PaymentReceiverUpdated(address indexed updater,
address indexed oldPaymentReceiver, address indexed newPaymentReceiver);
/**
An event to track future changes to `paymentReceiver` being locked.
@param locker The calling address which locked down the payment receiver.
*/
event PaymentReceiverLocked(address indexed locker);
/**
An event to track an update to this shop's `globalPurchaseLimit`.
@param updater The calling address which updated the purchase limit.
@param oldPurchaseLimit The value of the old purchase limit.
@param newPurchaseLimit The value of the new purchase limit.
*/
event GlobalPurchaseLimitUpdated(address indexed updater,
uint256 indexed oldPurchaseLimit, uint256 indexed newPurchaseLimit);
/**
An event to track future changes to `globalPurchaseLimit` being locked.
@param locker The calling address which locked down the purchase limit.
*/
event GlobalPurchaseLimitLocked(address indexed locker);
/**
An event to track a specific whitelist being updated. When emitted this
event indicates that a specific whitelist has had its settings completely
replaced.
@param updater The calling address which updated this whitelist.
@param whitelistId The ID of the whitelist being updated.
@param addresses The addresses that are now whitelisted with this update.
*/
event WhitelistUpdated(address indexed updater, uint256 indexed whitelistId,
address[] indexed addresses);
/**
An event to track the addition of addresses to a specific whitelist. When
emitted this event indicates that a specific whitelist has had `addresses`
added to it.
@param adder The calling address which added to this whitelist.
@param whitelistId The ID of the whitelist being added to.
@param addresses The addresses that were added in this update.
*/
event WhitelistAddition(address indexed adder, uint256 indexed whitelistId,
address[] indexed addresses);
/**
An event to track the removal of addresses to a specific whitelist. When
emitted this event indicates that a specific whitelist has had `addresses`
removed from it.
@param remover The calling address which removed from this whitelist.
@param whitelistId The ID of the whitelist being removed from.
@param addresses The addresses that were removed in this update.
*/
event WhitelistRemoval(address indexed remover, uint256 indexed whitelistId,
address[] indexed addresses);
/**
An event to track activating or deactivating a whitelist.
@param updater The calling address which updated this whitelist.
@param whitelistId The ID of the whitelist being removed from.
@param isActive The flag for whitelist activation.
*/
event WhitelistActiveUpdate(address indexed updater,
uint256 indexed whitelistId, bool indexed isActive);
/**
An event to track an item pool's data being updated. When emitted this event
indicates that a specific item pool's settings have been completely
replaced.
@param updater The calling address which updated this pool.
@param poolId The ID of the pool being updated.
@param pool The input data used to update the pool.
@param groupIds The groupIds that are now on sale in the item pool.
@param caps The caps, keyed to `groupIds`, of the maximum that each groupId
may mint up to.
@param prices The prices, keyed to `groupIds`, of the arrays for `Price`
objects that each item group may be able be bought with.
*/
event PoolUpdated(address indexed updater, uint256 poolId,
PoolInput indexed pool, uint256[] groupIds, uint256[] caps,
Price[][] indexed prices);
/**
An event to track the purchase of items from an item pool.
@param buyer The address that bought the item from an item pool.
@param poolId The ID of the item pool that the buyer bought from.
@param itemIds The array of item IDs that were purchased by the user.
@param amounts The keyed array of each amount of item purchased by `buyer`.
*/
event ItemPurchased(address indexed buyer, uint256 poolId,
uint256[] indexed itemIds, uint256[] amounts);
/**
Construct a new shop which can mint items upon purchase from various pools.
@param _owner The address of the administrator governing this collection.
@param _item The address of the Super1155 item collection contract that will
be minting new items in sales.
@param _paymentReceiver The address where shop earnings are sent.
@param _globalPurchaseLimit A global limit on the number of items that a
single address may purchase across all item pools in the shop.
*/
constructor(address _owner, Super1155 _item, address _paymentReceiver,
uint256 _globalPurchaseLimit) public {
// Do not perform a redundant ownership transfer if the deployer should
// remain as the owner of the collection.
if (_owner != owner()) {
transferOwnership(_owner);
}
// Continue initialization.
item = _item;
paymentReceiver = _paymentReceiver;
globalPurchaseLimit = _globalPurchaseLimit;
}
/**
Return a version number for this contract's interface.
*/
function version() external virtual override pure returns (uint256) {
return 1;
}
/**
Allow the shop owner or an approved manager to update the payment receiver
address if it has not been locked.
@param _newPaymentReceiver The address of the new payment receiver.
*/
function updatePaymentReceiver(address _newPaymentReceiver) external
hasValidPermit(UNIVERSAL, SET_PAYMENT_RECEIVER) {
require(!paymentReceiverLocked,
"MintShop1155: the payment receiver address is locked");
address oldPaymentReceiver = paymentReceiver;
paymentReceiver = _newPaymentReceiver;
emit PaymentReceiverUpdated(_msgSender(), oldPaymentReceiver,
_newPaymentReceiver);
}
/**
Allow the shop owner or an approved manager to lock the payment receiver
address against any future changes.
*/
function lockPaymentReceiver() external
hasValidPermit(UNIVERSAL, LOCK_PAYMENT_RECEIVER) {
paymentReceiverLocked = true;
emit PaymentReceiverLocked(_msgSender());
}
/**
Allow the shop owner or an approved manager to update the global purchase
limit if it has not been locked.
@param _newGlobalPurchaseLimit The value of the new global purchase limit.
*/
function updateGlobalPurchaseLimit(uint256 _newGlobalPurchaseLimit) external
hasValidPermit(UNIVERSAL, UPDATE_GLOBAL_LIMIT) {
require(!globalPurchaseLimitLocked,
"MintShop1155: the global purchase limit is locked");
uint256 oldGlobalPurchaseLimit = globalPurchaseLimit;
globalPurchaseLimit = _newGlobalPurchaseLimit;
emit GlobalPurchaseLimitUpdated(_msgSender(), oldGlobalPurchaseLimit,
_newGlobalPurchaseLimit);
}
/**
Allow the shop owner or an approved manager to lock the global purchase
limit against any future changes.
*/
function lockGlobalPurchaseLimit() external
hasValidPermit(UNIVERSAL, LOCK_GLOBAL_LIMIT) {
globalPurchaseLimitLocked = true;
emit GlobalPurchaseLimitLocked(_msgSender());
}
/**
Allow the owner or an approved manager to add a new whitelist.
@param _whitelist The WhitelistInput full of data defining the whitelist.
*/
function addWhitelist(WhitelistInput memory _whitelist) external
hasValidPermit(UNIVERSAL, WHITELIST) {
updateWhitelist(nextWhitelistId, _whitelist);
// Increment the ID which will be used by the next whitelist added.
nextWhitelistId = nextWhitelistId.add(1);
}
/**
Allow the owner or an approved manager to update a whitelist. This
completely replaces the existing content for that whitelist.
@param _id The whitelist ID to replace with the new whitelist.
@param _whitelist The WhitelistInput full of data defining the whitelist.
*/
function updateWhitelist(uint256 _id, WhitelistInput memory _whitelist)
public hasValidPermit(UNIVERSAL, WHITELIST) {
uint256 newWhitelistVersion =
whitelists[_id].currentWhitelistVersion.add(1);
// Immediately store some given information about this whitelist.
Whitelist storage whitelist = whitelists[_id];
whitelist.expiryTime = _whitelist.expiryTime;
whitelist.isActive = _whitelist.isActive;
whitelist.currentWhitelistVersion = newWhitelistVersion;
// Invalidate the old mapping and store the new address participation flags.
for (uint256 i = 0; i < _whitelist.addresses.length; i++) {
bytes32 addressKey = keccak256(abi.encode(newWhitelistVersion,
_whitelist.addresses[i]));
whitelists[_id].addresses[addressKey] = true;
}
// Emit an event to track the new, replaced state of the whitelist.
emit WhitelistUpdated(_msgSender(), _id, _whitelist.addresses);
}
/**
Allow the owner or an approved manager to add specified addresses to an
existing whitelist.
@param _id The ID of the whitelist to add users to.
@param _addresses The array of addresses to add.
*/
function addToWhitelist(uint256 _id, address[] calldata _addresses) external
hasValidPermit(UNIVERSAL, WHITELIST) {
uint256 whitelistVersion = whitelists[_id].currentWhitelistVersion;
for (uint256 i = 0; i < _addresses.length; i++) {
bytes32 addressKey = keccak256(abi.encode(whitelistVersion,
_addresses[i]));
whitelists[_id].addresses[addressKey] = true;
}
// Emit an event to track the addition of new addresses to the whitelist.
emit WhitelistAddition(_msgSender(), _id, _addresses);
}
/**
Allow the owner or an approved manager to remove specified addresses from an
existing whitelist.
@param _id The ID of the whitelist to remove users from.
@param _addresses The array of addresses to remove.
*/
function removeFromWhitelist(uint256 _id, address[] calldata _addresses)
external hasValidPermit(UNIVERSAL, WHITELIST) {
uint256 whitelistVersion = whitelists[_id].currentWhitelistVersion;
for (uint256 i = 0; i < _addresses.length; i++) {
bytes32 addressKey = keccak256(abi.encode(whitelistVersion,
_addresses[i]));
whitelists[_id].addresses[addressKey] = false;
}
// Emit an event to track the removal of addresses from the whitelist.
emit WhitelistRemoval(_msgSender(), _id, _addresses);
}
/**
Allow the owner or an approved manager to manually set the active status of
a specific whitelist.
@param _id The ID of the whitelist to update the active flag for.
@param _isActive The boolean flag to enable or disable the whitelist.
*/
function setWhitelistActive(uint256 _id, bool _isActive) external
hasValidPermit(UNIVERSAL, WHITELIST) {
whitelists[_id].isActive = _isActive;
// Emit an event to track whitelist activation status changes.
emit WhitelistActiveUpdate(_msgSender(), _id, _isActive);
}
/**
A function which allows the caller to retrieve whether or not addresses can
participate in some given whitelists.
@param _ids The IDs of the whitelists to check for `_addresses`.
@param _addresses The addresses to check whitelist eligibility for.
*/
function getWhitelistStatus(uint256[] calldata _ids,
address[] calldata _addresses) external view returns (bool[][] memory) {
bool[][] memory whitelistStatus;
for (uint256 i = 0; i < _ids.length; i++) {
uint256 id = _ids[i];
uint256 whitelistVersion = whitelists[id].currentWhitelistVersion;
for (uint256 j = 0; j < _addresses.length; j++) {
bytes32 addressKey = keccak256(abi.encode(whitelistVersion,
_addresses[j]));
whitelistStatus[j][i] = whitelists[id].addresses[addressKey];
}
}
return whitelistStatus;
}
/**
A function which allows the caller to retrieve information about specific
pools, the items for sale within, and the collection this shop uses.
@param _ids An array of pool IDs to retrieve information about.
*/
function getPools(uint256[] calldata _ids) external view
returns (PoolOutput[] memory) {
PoolOutput[] memory poolOutputs = new PoolOutput[](_ids.length);
for (uint256 i = 0; i < _ids.length; i++) {
uint256 id = _ids[i];
// Process output for each pool.
PoolItem[] memory poolItems = new PoolItem[](pools[id].itemGroups.length);
for (uint256 j = 0; j < pools[id].itemGroups.length; j++) {
uint256 itemGroupId = pools[id].itemGroups[j];
bytes32 itemKey = keccak256(abi.encodePacked(
pools[id].currentPoolVersion, itemGroupId));
// Parse each price the item is sold at.
Price[] memory itemPrices =
new Price[](pools[id].itemPricesLength[itemKey]);
for (uint256 k = 0; k < pools[id].itemPricesLength[itemKey]; k++) {
itemPrices[k] = pools[id].itemPrices[itemKey][k];
}
// Track the item.
poolItems[j] = PoolItem({
groupId: itemGroupId,
cap: pools[id].itemCaps[itemKey],
minted: pools[id].itemMinted[itemKey],
prices: itemPrices
});
}
// Track the pool.
poolOutputs[i] = PoolOutput({
name: pools[id].name,
startTime: pools[id].startTime,
endTime: pools[id].endTime,
purchaseLimit: pools[id].purchaseLimit,
singlePurchaseLimit: pools[id].singlePurchaseLimit,
requirement: pools[id].requirement,
itemMetadataUri: item.metadataUri(),
items: poolItems
});
}
// Return the pools.
return poolOutputs;
}
/**
A function which allows the caller to retrieve the number of items specific
addresses have purchased from specific pools.
@param _ids The IDs of the pools to check for addresses in `purchasers`.
@param _purchasers The addresses to check the purchase counts for.
*/
function getPurchaseCounts(uint256[] calldata _ids,
address[] calldata _purchasers) external view returns (uint256[][] memory) {
uint256[][] memory purchaseCounts;
for (uint256 i = 0; i < _ids.length; i++) {
uint256 id = _ids[i];
for (uint256 j = 0; j < _purchasers.length; j++) {
address purchaser = _purchasers[j];
purchaseCounts[j][i] = pools[id].purchaseCounts[purchaser];
}
}
return purchaseCounts;
}
/**
A function which allows the caller to retrieve information about specific
pools, the items for sale within, and the collection this launchpad uses.
A provided address differentiates this function from `getPools`; the added
address enables this function to retrieve pool data as well as whitelisting
and purchase count details for the provided address.
@param _ids An array of pool IDs to retrieve information about.
@param _address An address which enables this function to support additional
relevant data lookups.
*/
function getPoolsWithAddress(uint256[] calldata _ids, address _address)
external view returns (PoolAddressOutput[] memory) {
PoolAddressOutput[] memory poolOutputs =
new PoolAddressOutput[](_ids.length);
for (uint256 i = 0; i < _ids.length; i++) {
uint256 id = _ids[i];
// Process output for each pool.
PoolItem[] memory poolItems = new PoolItem[](pools[id].itemGroups.length);
for (uint256 j = 0; j < pools[id].itemGroups.length; j++) {
uint256 itemGroupId = pools[id].itemGroups[j];
bytes32 itemKey = keccak256(abi.encodePacked(
pools[id].currentPoolVersion, itemGroupId));
// Parse each price the item is sold at.
Price[] memory itemPrices =
new Price[](pools[id].itemPricesLength[itemKey]);
for (uint256 k = 0; k < pools[id].itemPricesLength[itemKey]; k++) {
itemPrices[k] = pools[id].itemPrices[itemKey][k];
}
// Track the item.
poolItems[j] = PoolItem({
groupId: itemGroupId,
cap: pools[id].itemCaps[itemKey],
minted: pools[id].itemMinted[itemKey],
prices: itemPrices
});
}
// Track the pool.
uint256 whitelistId = pools[id].requirement.whitelistId;
bytes32 addressKey = keccak256(
abi.encode(whitelists[whitelistId].currentWhitelistVersion, _address));
poolOutputs[i] = PoolAddressOutput({
name: pools[id].name,
startTime: pools[id].startTime,
endTime: pools[id].endTime,
purchaseLimit: pools[id].purchaseLimit,
singlePurchaseLimit: pools[id].singlePurchaseLimit,
requirement: pools[id].requirement,
itemMetadataUri: item.metadataUri(),
items: poolItems,
purchaseCount: pools[id].purchaseCounts[_address],
whitelistStatus: whitelists[whitelistId].addresses[addressKey]
});
}
// Return the pools.
return poolOutputs;
}
/**
Allow the owner of the shop or an approved manager to add a new pool of
items that users may purchase.
@param _pool The PoolInput full of data defining the pool's operation.
@param _groupIds The specific item group IDs to sell in this pool,
keyed to the `_amounts` array.
@param _issueNumberOffsets The offset for the next issue number minted for a
particular item group in `_groupIds`. This is *important* to handle
pre-minted or partially-minted item groups.
@param _caps The maximum amount of each particular groupId that can be sold
by this pool.
@param _prices The asset address to price pairings to use for selling each
item.
*/
function addPool(PoolInput calldata _pool, uint256[] calldata _groupIds,
uint256[] calldata _issueNumberOffsets, uint256[] calldata _caps,
Price[][] memory _prices) external hasValidPermit(UNIVERSAL, POOL) {
updatePool(nextPoolId, _pool, _groupIds, _issueNumberOffsets, _caps,
_prices);
// Increment the ID which will be used by the next pool added.
nextPoolId = nextPoolId.add(1);
}
/**
A private helper function for `updatePool` to prevent it from running too
deep into the stack. This function will store the amount of each item group
that this pool may mint.
@param _id The ID of the pool to update.
@param _groupIds The specific item group IDs to sell in this pool,
keyed to the `_amounts` array.
@param _issueNumberOffsets The offset for the next issue number minted for a
particular item group in `_groupIds`. This is *important* to handle
pre-minted or partially-minted item groups.
@param _caps The maximum amount of each particular groupId that can be sold
by this pool.
@param _prices The asset address to price pairings to use for selling each
item.
*/
function _updatePoolHelper(uint256 _id,
uint256[] calldata _groupIds, uint256[] calldata _issueNumberOffsets,
uint256[] calldata _caps, Price[][] memory _prices) private {
for (uint256 i = 0; i < _groupIds.length; i++) {
require(_caps[i] > 0,
"MintShop1155: cannot add an item group with no mintable amount");
bytes32 itemKey = keccak256(abi.encode(
pools[_id].currentPoolVersion, _groupIds[i]));
pools[_id].itemCaps[itemKey] = _caps[i];
// Pre-seed the next item issue IDs given the pool offsets.
nextItemIssues[_groupIds[i]] = _issueNumberOffsets[i];
// Store future purchase information for the item group.
for (uint256 j = 0; j < _prices[i].length; j++) {
pools[_id].itemPrices[itemKey][j] = _prices[i][j];
}
pools[_id].itemPricesLength[itemKey] = _prices[i].length;
}
}
/**
Allow the owner of the shop or an approved manager to update an existing
pool of items.
@param _id The ID of the pool to update.
@param _pool The PoolInput full of data defining the pool's operation.
@param _groupIds The specific item group IDs to sell in this pool,
keyed to the `_amounts` array.
@param _issueNumberOffsets The offset for the next issue number minted for a
particular item group in `_groupIds`. This is *important* to handle
pre-minted or partially-minted item groups.
@param _caps The maximum amount of each particular groupId that can be sold
by this pool.
@param _prices The asset address to price pairings to use for selling each
item.
*/
function updatePool(uint256 _id, PoolInput calldata _pool,
uint256[] calldata _groupIds, uint256[] calldata _issueNumberOffsets,
uint256[] calldata _caps, Price[][] memory _prices) public
hasValidPermit(UNIVERSAL, POOL) {
require(_id <= nextPoolId,
"MintShop1155: cannot update a non-existent pool");
require(_pool.endTime >= _pool.startTime,
"MintShop1155: cannot create a pool which ends before it starts");
require(_groupIds.length > 0,
"MintShop1155: must list at least one item group");
require(_groupIds.length == _issueNumberOffsets.length,
"MintShop1155: item groups length must equal issue offsets length");
require(_groupIds.length == _caps.length,
"MintShop1155: item groups length must equal caps length");
require(_groupIds.length == _prices.length,
"MintShop1155: item groups length must equal prices input length");
// Immediately store some given information about this pool.
Pool storage pool = pools[_id];
pool.name = _pool.name;
pool.startTime = _pool.startTime;
pool.endTime = _pool.endTime;
pool.purchaseLimit = _pool.purchaseLimit;
pool.singlePurchaseLimit = _pool.singlePurchaseLimit;
pool.itemGroups = _groupIds;
pool.currentPoolVersion = pools[_id].currentPoolVersion.add(1);
pool.requirement = _pool.requirement;
// Delegate work to a helper function to avoid stack-too-deep errors.
_updatePoolHelper(_id, _groupIds, _issueNumberOffsets, _caps, _prices);
// Emit an event indicating that a pool has been updated.
emit PoolUpdated(_msgSender(), _id, _pool, _groupIds, _caps, _prices);
}
/**
Allow a buyer to purchase an item from a pool.
@param _id The ID of the particular item pool that the user would like to
purchase from.
@param _groupId The item group ID that the user would like to purchase.
@param _assetIndex The selection of supported payment asset `Price` that the
buyer would like to make a purchase with.
@param _amount The amount of item that the user would like to purchase.
*/
function mintFromPool(uint256 _id, uint256 _groupId, uint256 _assetIndex,
uint256 _amount) external nonReentrant payable {
require(_amount > 0,
"MintShop1155: must purchase at least one item");
require(_id < nextPoolId,
"MintShop1155: can only purchase items from an active pool");
require(pools[_id].singlePurchaseLimit >= _amount,
"MintShop1155: cannot exceed the per-transaction maximum");
// Verify that the asset being used in the purchase is valid.
bytes32 itemKey = keccak256(abi.encode(pools[_id].currentPoolVersion,
_groupId));
require(_assetIndex < pools[_id].itemPricesLength[itemKey],
"MintShop1155: specified asset index is not valid");
// Verify that the pool is running its sale.
require(block.timestamp >= pools[_id].startTime
&& block.timestamp <= pools[_id].endTime,
"MintShop1155: pool is not currently running its sale");
// Verify that the pool is respecting per-address global purchase limits.
uint256 userGlobalPurchaseAmount =
_amount.add(globalPurchaseCounts[_msgSender()]);
require(userGlobalPurchaseAmount <= globalPurchaseLimit,
"MintShop1155: you may not purchase any more items from this shop");
// Verify that the pool is respecting per-address pool purchase limits.
uint256 userPoolPurchaseAmount =
_amount.add(pools[_id].purchaseCounts[_msgSender()]);
require(userPoolPurchaseAmount <= pools[_id].purchaseLimit,
"MintShop1155: you may not purchase any more items from this pool");
// Verify that the pool is either public, inactive, time-expired,
// or the caller's address is whitelisted.
{
uint256 whitelistId = pools[_id].requirement.whitelistId;
uint256 whitelistVersion =
whitelists[whitelistId].currentWhitelistVersion;
bytes32 addressKey = keccak256(abi.encode(whitelistVersion,
_msgSender()));
bool addressWhitelisted = whitelists[whitelistId].addresses[addressKey];
require(whitelistId == 0
|| !whitelists[whitelistId].isActive
|| block.timestamp > whitelists[whitelistId].expiryTime
|| addressWhitelisted,
"MintShop1155: you are not whitelisted on this pool");
}
// Verify that the pool is not depleted by the user's purchase.
uint256 newCirculatingTotal = pools[_id].itemMinted[itemKey].add(_amount);
require(newCirculatingTotal <= pools[_id].itemCaps[itemKey],
"MintShop1155: there are not enough items available for you to purchase");
// Verify that the user meets any requirements gating participation in this
// pool. Verify that any possible ERC-20 requirements are met.
PoolRequirement memory poolRequirement = pools[_id].requirement;
if (poolRequirement.requiredType == AccessType.TokenRequired) {
IERC20 requiredToken = IERC20(poolRequirement.requiredAsset);
require(requiredToken.balanceOf(_msgSender())
>= poolRequirement.requiredAmount,
"MintShop1155: you do not have enough required token for this pool");
// Verify that any possible ERC-1155 ownership requirements are met.
} else if (poolRequirement.requiredType == AccessType.ItemRequired) {
Super1155 requiredItem = Super1155(poolRequirement.requiredAsset);
require(requiredItem.totalBalances(_msgSender())
>= poolRequirement.requiredAmount,
"MintShop1155: you do not have enough required item for this pool");
// Verify that any possible Staker point threshold requirements are met.
} else if (poolRequirement.requiredType == AccessType.PointRequired) {
Staker requiredStaker = Staker(poolRequirement.requiredAsset);
require(requiredStaker.getAvailablePoints(_msgSender())
>= poolRequirement.requiredAmount,
"MintShop1155: you do not have enough required points for this pool");
}
// Process payment for the user, checking to sell for Staker points.
Price memory sellingPair = pools[_id].itemPrices[itemKey][_assetIndex];
if (sellingPair.assetType == AssetType.Point) {
Staker(sellingPair.asset).spendPoints(_msgSender(),
sellingPair.price.mul(_amount));
// Process payment for the user with a check to sell for Ether.
} else if (sellingPair.assetType == AssetType.Ether) {
uint256 etherPrice = sellingPair.price.mul(_amount);
require(msg.value >= etherPrice,
"MintShop1155: you did not send enough Ether to complete the purchase");
(bool success, ) = payable(paymentReceiver).call{ value: msg.value }("");
require(success,
"MintShop1155: payment receiver transfer failed");
// Process payment for the user with a check to sell for an ERC-20 token.
} else if (sellingPair.assetType == AssetType.Token) {
IERC20 sellingAsset = IERC20(sellingPair.asset);
uint256 tokenPrice = sellingPair.price.mul(_amount);
require(sellingAsset.balanceOf(_msgSender()) >= tokenPrice,
"MintShop1155: you do not have enough token to complete the purchase");
sellingAsset.safeTransferFrom(_msgSender(), paymentReceiver, tokenPrice);
// Otherwise, error out because the payment type is unrecognized.
} else {
revert("MintShop1155: unrecognized asset type");
}
// If payment is successful, mint each of the user's purchased items.
uint256[] memory itemIds = new uint256[](_amount);
uint256[] memory amounts = new uint256[](_amount);
uint256 nextIssueNumber = nextItemIssues[_groupId];
{
uint256 shiftedGroupId = _groupId << 128;
for (uint256 i = 1; i <= _amount; i++) {
uint256 itemId = shiftedGroupId.add(nextIssueNumber).add(i);
itemIds[i - 1] = itemId;
amounts[i - 1] = 1;
}
}
// Mint the items.
item.mintBatch(_msgSender(), itemIds, amounts, "");
// Update the tracker for available item issue numbers.
nextItemIssues[_groupId] = nextIssueNumber.add(_amount);
// Update the count of circulating items from this pool.
pools[_id].itemMinted[itemKey] = newCirculatingTotal;
// Update the pool's count of items that a user has purchased.
pools[_id].purchaseCounts[_msgSender()] = userPoolPurchaseAmount;
// Update the global count of items that a user has purchased.
globalPurchaseCounts[_msgSender()] = userGlobalPurchaseAmount;
// Emit an event indicating a successful purchase.
emit ItemPurchased(_msgSender(), _id, itemIds, amounts);
}
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
import "../utils/Context.sol";
/**
* @dev Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* By default, the owner account will be the one that deploys the contract. This
* can later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract Ownable is Context {
address private _owner;
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the deployer as the initial owner.
*/
constructor () internal {
address msgSender = _msgSender();
_owner = msgSender;
emit OwnershipTransferred(address(0), msgSender);
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
return _owner;
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
require(owner() == _msgSender(), "Ownable: caller is not the owner");
_;
}
/**
* @dev Leaves the contract without owner. It will not be possible to call
* `onlyOwner` functions anymore. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby removing any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
emit OwnershipTransferred(_owner, address(0));
_owner = address(0);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
require(newOwner != address(0), "Ownable: new owner is the zero address");
emit OwnershipTransferred(_owner, newOwner);
_owner = newOwner;
}
}
// SPDX-License-Identifier: GPL-3.0
pragma solidity 0.7.6;
pragma experimental ABIEncoderV2;
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/math/SafeMath.sol";
import "@openzeppelin/contracts/utils/Address.sol";
/**
@title An advanced permission-management contract.
@author Tim Clancy
This contract allows for a contract owner to delegate specific rights to
external addresses. Additionally, these rights can be gated behind certain
sets of circumstances and granted expiration times. This is useful for some
more finely-grained access control in contracts.
The owner of this contract is always a fully-permissioned super-administrator.
*/
abstract contract PermitControl is Ownable {
using SafeMath for uint256;
using Address for address;
/// A special reserved constant for representing no rights.
bytes32 public constant ZERO_RIGHT = hex"00000000000000000000000000000000";
/// A special constant specifying the unique, universal-rights circumstance.
bytes32 public constant UNIVERSAL = hex"FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF";
/*
A special constant specifying the unique manager right. This right allows an
address to freely-manipulate the `managedRight` mapping.
**/
bytes32 public constant MANAGER = hex"FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF";
/**
A mapping of per-address permissions to the circumstances, represented as
an additional layer of generic bytes32 data, under which the addresses have
various permits. A permit in this sense is represented by a per-circumstance
mapping which couples some right, represented as a generic bytes32, to an
expiration time wherein the right may no longer be exercised. An expiration
time of 0 indicates that there is in fact no permit for the specified
address to exercise the specified right under the specified circumstance.
@dev Universal rights MUST be stored under the 0xFFFFFFFFFFFFFFFFFFFFFFFF...
max-integer circumstance. Perpetual rights may be given an expiry time of
max-integer.
*/
mapping (address => mapping (bytes32 => mapping (bytes32 => uint256))) public
permissions;
/**
An additional mapping of managed rights to manager rights. This mapping
represents the administrator relationship that various rights have with one
another. An address with a manager right may freely set permits for that
manager right's managed rights. Each right may be managed by only one other
right.
*/
mapping (bytes32 => bytes32) public managerRight;
/**
An event emitted when an address has a permit updated. This event captures,
through its various parameter combinations, the cases of granting a permit,
updating the expiration time of a permit, or revoking a permit.
@param updator The address which has updated the permit.
@param updatee The address whose permit was updated.
@param circumstance The circumstance wherein the permit was updated.
@param role The role which was updated.
@param expirationTime The time when the permit expires.
*/
event PermitUpdated(address indexed updator, address indexed updatee,
bytes32 circumstance, bytes32 indexed role, uint256 expirationTime);
/**
An event emitted when a management relationship in `managerRight` is
updated. This event captures adding and revoking management permissions via
observing the update history of the `managerRight` value.
@param manager The address of the manager performing this update.
@param managedRight The right which had its manager updated.
@param managerRight The new manager right which was updated to.
*/
event ManagementUpdated(address indexed manager, bytes32 indexed managedRight,
bytes32 indexed managerRight);
/**
A modifier which allows only the super-administrative owner or addresses
with a specified valid right to perform a call.
@param _circumstance The circumstance under which to check for the validity
of the specified `right`.
@param _right The right to validate for the calling address. It must be
non-expired and exist within the specified `_circumstance`.
*/
modifier hasValidPermit(bytes32 _circumstance, bytes32 _right) {
require(_msgSender() == owner()
|| hasRightUntil(_msgSender(), _circumstance, _right) > block.timestamp,
"PermitControl: sender does not have a valid permit");
_;
}
/**
Return a version number for this contract's interface.
*/
function version() external virtual pure returns (uint256) {
return 1;
}
/**
Determine whether or not an address has some rights under the given
circumstance, and if they do have the right, until when.
@param _address The address to check for the specified `_right`.
@param _circumstance The circumstance to check the specified `_right` for.
@param _right The right to check for validity.
@return The timestamp in seconds when the `_right` expires. If the timestamp
is zero, we can assume that the user never had the right.
*/
function hasRightUntil(address _address, bytes32 _circumstance,
bytes32 _right) public view returns (uint256) {
return permissions[_address][_circumstance][_right];
}
/**
Set the permit to a specific address under some circumstances. A permit may
only be set by the super-administrative contract owner or an address holding
some delegated management permit.
@param _address The address to assign the specified `_right` to.
@param _circumstance The circumstance in which the `_right` is valid.
@param _right The specific right to assign.
@param _expirationTime The time when the `_right` expires for the provided
`_circumstance`.
*/
function setPermit(address _address, bytes32 _circumstance, bytes32 _right,
uint256 _expirationTime) external virtual hasValidPermit(UNIVERSAL,
managerRight[_right]) {
require(_right != ZERO_RIGHT,
"PermitControl: you may not grant the zero right");
permissions[_address][_circumstance][_right] = _expirationTime;
emit PermitUpdated(_msgSender(), _address, _circumstance, _right,
_expirationTime);
}
/**
Set the `_managerRight` whose `UNIVERSAL` holders may freely manage the
specified `_managedRight`.
@param _managedRight The right which is to have its manager set to
`_managerRight`.
@param _managerRight The right whose `UNIVERSAL` holders may manage
`_managedRight`.
*/
function setManagerRight(bytes32 _managedRight, bytes32 _managerRight)
external virtual hasValidPermit(UNIVERSAL, MANAGER) {
require(_managedRight != ZERO_RIGHT,
"PermitControl: you may not specify a manager for the zero right");
managerRight[_managedRight] = _managerRight;
emit ManagementUpdated(_msgSender(), _managedRight, _managerRight);
}
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
/**
* @dev Contract module that helps prevent reentrant calls to a function.
*
* Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
* available, which can be applied to functions to make sure there are no nested
* (reentrant) calls to them.
*
* Note that because there is a single `nonReentrant` guard, functions marked as
* `nonReentrant` may not call one another. This can be worked around by making
* those functions `private`, and then adding `external` `nonReentrant` entry
* points to them.
*
* TIP: If you would like to learn more about reentrancy and alternative ways
* to protect against it, check out our blog post
* https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
*/
abstract contract ReentrancyGuard {
// Booleans are more expensive than uint256 or any type that takes up a full
// word because each write operation emits an extra SLOAD to first read the
// slot's contents, replace the bits taken up by the boolean, and then write
// back. This is the compiler's defense against contract upgrades and
// pointer aliasing, and it cannot be disabled.
// The values being non-zero value makes deployment a bit more expensive,
// but in exchange the refund on every call to nonReentrant will be lower in
// amount. Since refunds are capped to a percentage of the total
// transaction's gas, it is best to keep them low in cases like this one, to
// increase the likelihood of the full refund coming into effect.
uint256 private constant _NOT_ENTERED = 1;
uint256 private constant _ENTERED = 2;
uint256 private _status;
constructor () internal {
_status = _NOT_ENTERED;
}
/**
* @dev Prevents a contract from calling itself, directly or indirectly.
* Calling a `nonReentrant` function from another `nonReentrant`
* function is not supported. It is possible to prevent this from happening
* by making the `nonReentrant` function external, and make it call a
* `private` function that does the actual work.
*/
modifier nonReentrant() {
// On the first call to nonReentrant, _notEntered will be true
require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
// Any calls to nonReentrant after this point will fail
_status = _ENTERED;
_;
// By storing the original value once again, a refund is triggered (see
// https://eips.ethereum.org/EIPS/eip-2200)
_status = _NOT_ENTERED;
}
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
import "./IERC20.sol";
import "../../math/SafeMath.sol";
import "../../utils/Address.sol";
/**
* @title SafeERC20
* @dev Wrappers around ERC20 operations that throw on failure (when the token
* contract returns false). Tokens that return no value (and instead revert or
* throw on failure) are also supported, non-reverting calls are assumed to be
* successful.
* To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
* which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
*/
library SafeERC20 {
using SafeMath for uint256;
using Address for address;
function safeTransfer(IERC20 token, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
}
function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
}
/**
* @dev Deprecated. This function has issues similar to the ones found in
* {IERC20-approve}, and its usage is discouraged.
*
* Whenever possible, use {safeIncreaseAllowance} and
* {safeDecreaseAllowance} instead.
*/
function safeApprove(IERC20 token, address spender, uint256 value) internal {
// safeApprove should only be called when setting an initial allowance,
// or when resetting it to zero. To increase and decrease it, use
// 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
// solhint-disable-next-line max-line-length
require((value == 0) || (token.allowance(address(this), spender) == 0),
"SafeERC20: approve from non-zero to non-zero allowance"
);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
}
function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
uint256 newAllowance = token.allowance(address(this), spender).add(value);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
}
function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
}
/**
* @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
* on the return value: the return value is optional (but if data is returned, it must not be false).
* @param token The token targeted by the call.
* @param data The call data (encoded using abi.encode or one of its variants).
*/
function _callOptionalReturn(IERC20 token, bytes memory data) private {
// We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
// we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
// the target address contains contract code and also asserts for success in the low-level call.
bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
if (returndata.length > 0) { // Return data is optional
// solhint-disable-next-line max-line-length
require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
}
}
}
// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.8.0;
/**
* @dev Wrappers over Solidity's arithmetic operations with added overflow
* checks.
*
* Arithmetic operations in Solidity wrap on overflow. This can easily result
* in bugs, because programmers usually assume that an overflow raises an
* error, which is the standard behavior in high level programming languages.
* `SafeMath` restores this intuition by reverting the transaction when an
* operation overflows.
*
* Using this library instead of the unchecked operations eliminates an entire
* class of bugs, so it's recommended to use it always.
*/
library SafeMath {
/**
* @dev Returns the addition of two unsigned integers, with an overflow flag.
*
* _Available since v3.4._
*/
function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
uint256 c = a + b;
if (c < a) return (false, 0);
return (true, c);
}
/**
* @dev Returns the substraction of two unsigned integers, with an overflow flag.
*
* _Available since v3.4._
*/
function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
if (b > a) return (false, 0);
return (true, a - b);
}
/**
* @dev Returns the multiplication of two unsigned integers, with an overflow flag.
*
* _Available since v3.4._
*/
function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
// Gas optimization: this is cheaper than requiring 'a' not being zero, but the
// benefit is lost if 'b' is also tested.
// See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
if (a == 0) return (true, 0);
uint256 c = a * b;
if (c / a != b) return (false, 0);
return (true, c);
}
/**
* @dev Returns the division of two unsigned integers, with a division by zero flag.
*
* _Available since v3.4._
*/
function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
if (b == 0) return (false, 0);
return (true, a / b);
}
/**
* @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
*
* _Available since v3.4._
*/
function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
if (b == 0) return (false, 0);
return (true, a % b);
}
/**
* @dev Returns the addition of two unsigned integers, reverting on
* overflow.
*
* Counterpart to Solidity's `+` operator.
*
* Requirements:
*
* - Addition cannot overflow.
*/
function add(uint256 a, uint256 b) internal pure returns (uint256) {
uint256 c = a + b;
require(c >= a, "SafeMath: addition overflow");
return c;
}
/**
* @dev Returns the subtraction of two unsigned integers, reverting on
* overflow (when the result is negative).
*
* Counterpart to Solidity's `-` operator.
*
* Requirements:
*
* - Subtraction cannot overflow.
*/
function sub(uint256 a, uint256 b) internal pure returns (uint256) {
require(b <= a, "SafeMath: subtraction overflow");
return a - b;
}
/**
* @dev Returns the multiplication of two unsigned integers, reverting on
* overflow.
*
* Counterpart to Solidity's `*` operator.
*
* Requirements:
*
* - Multiplication cannot overflow.
*/
function mul(uint256 a, uint256 b) internal pure returns (uint256) {
if (a == 0) return 0;
uint256 c = a * b;
require(c / a == b, "SafeMath: multiplication overflow");
return c;
}
/**
* @dev Returns the integer division of two unsigned integers, reverting on
* division by zero. The result is rounded towards zero.
*
* Counterpart to Solidity's `/` operator. Note: this function uses a
* `revert` opcode (which leaves remaining gas untouched) while Solidity
* uses an invalid opcode to revert (consuming all remaining gas).
*
* Requirements:
*
* - The divisor cannot be zero.
*/
function div(uint256 a, uint256 b) internal pure returns (uint256) {
require(b > 0, "SafeMath: division by zero");
return a / b;
}
/**
* @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
* reverting when dividing by zero.
*
* Counterpart to Solidity's `%` operator. This function uses a `revert`
* opcode (which leaves remaining gas untouched) while Solidity uses an
* invalid opcode to revert (consuming all remaining gas).
*
* Requirements:
*
* - The divisor cannot be zero.
*/
function mod(uint256 a, uint256 b) internal pure returns (uint256) {
require(b > 0, "SafeMath: modulo by zero");
return a % b;
}
/**
* @dev Returns the subtraction of two unsigned integers, reverting with custom message on
* overflow (when the result is negative).
*
* CAUTION: This function is deprecated because it requires allocating memory for the error
* message unnecessarily. For custom revert reasons use {trySub}.
*
* Counterpart to Solidity's `-` operator.
*
* Requirements:
*
* - Subtraction cannot overflow.
*/
function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
require(b <= a, errorMessage);
return a - b;
}
/**
* @dev Returns the integer division of two unsigned integers, reverting with custom message on
* division by zero. The result is rounded towards zero.
*
* CAUTION: This function is deprecated because it requires allocating memory for the error
* message unnecessarily. For custom revert reasons use {tryDiv}.
*
* Counterpart to Solidity's `/` operator. Note: this function uses a
* `revert` opcode (which leaves remaining gas untouched) while Solidity
* uses an invalid opcode to revert (consuming all remaining gas).
*
* Requirements:
*
* - The divisor cannot be zero.
*/
function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
require(b > 0, errorMessage);
return a / b;
}
/**
* @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
* reverting with custom message when dividing by zero.
*
* CAUTION: This function is deprecated because it requires allocating memory for the error
* message unnecessarily. For custom revert reasons use {tryMod}.
*
* Counterpart to Solidity's `%` operator. This function uses a `revert`
* opcode (which leaves remaining gas untouched) while Solidity uses an
* invalid opcode to revert (consuming all remaining gas).
*
* Requirements:
*
* - The divisor cannot be zero.
*/
function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
require(b > 0, errorMessage);
return a % b;
}
}
// SPDX-License-Identifier: GPL-3.0
pragma solidity 0.7.6;
pragma experimental ABIEncoderV2;
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/utils/ReentrancyGuard.sol";
import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
import "@openzeppelin/contracts/math/SafeMath.sol";
/**
@title An asset staking contract.
@author Tim Clancy
This staking contract disburses tokens from its internal reservoir according
to a fixed emission schedule. Assets can be assigned varied staking weights.
This code is inspired by and modified from Sushi's Master Chef contract.
https://github.com/sushiswap/sushiswap/blob/master/contracts/MasterChef.sol
*/
contract Staker is Ownable, ReentrancyGuard {
using SafeMath for uint256;
using SafeERC20 for IERC20;
// A user-specified, descriptive name for this Staker.
string public name;
// The token to disburse.
IERC20 public token;
// The amount of the disbursed token deposited by users. This is used for the
// special case where a staking pool has been created for the disbursed token.
// This is required to prevent the Staker itself from reducing emissions.
uint256 public totalTokenDeposited;
// A flag signalling whether the contract owner can add or set developers.
bool public canAlterDevelopers;
// An array of developer addresses for finding shares in the share mapping.
address[] public developerAddresses;
// A mapping of developer addresses to their percent share of emissions.
// Share percentages are represented as 1/1000th of a percent. That is, a 1%
// share of emissions should map an address to 1000.
mapping (address => uint256) public developerShares;
// A flag signalling whether or not the contract owner can alter emissions.
bool public canAlterTokenEmissionSchedule;
bool public canAlterPointEmissionSchedule;
// The token emission schedule of the Staker. This emission schedule maps a
// block number to the amount of tokens or points that should be disbursed with every
// block beginning at said block number.
struct EmissionPoint {
uint256 blockNumber;
uint256 rate;
}
// An array of emission schedule key blocks for finding emission rate changes.
uint256 public tokenEmissionBlockCount;
mapping (uint256 => EmissionPoint) public tokenEmissionBlocks;
uint256 public pointEmissionBlockCount;
mapping (uint256 => EmissionPoint) public pointEmissionBlocks;
// Store the very earliest possible emission block for quick reference.
uint256 MAX_INT = 2**256 - 1;
uint256 internal earliestTokenEmissionBlock;
uint256 internal earliestPointEmissionBlock;
// Information for each pool that can be staked in.
// - token: the address of the ERC20 asset that is being staked in the pool.
// - strength: the relative token emission strength of this pool.
// - lastRewardBlock: the last block number where token distribution occurred.
// - tokensPerShare: accumulated tokens per share times 1e12.
// - pointsPerShare: accumulated points per share times 1e12.
struct PoolInfo {
IERC20 token;
uint256 tokenStrength;
uint256 tokensPerShare;
uint256 pointStrength;
uint256 pointsPerShare;
uint256 lastRewardBlock;
}
IERC20[] public poolTokens;
// Stored information for each available pool per its token address.
mapping (IERC20 => PoolInfo) public poolInfo;
// Information for each user per staking pool:
// - amount: the amount of the pool asset being provided by the user.
// - tokenPaid: the value of the user's total earning that has been paid out.
// -- pending reward = (user.amount * pool.tokensPerShare) - user.rewardDebt.
// - pointPaid: the value of the user's total point earnings that has been paid out.
struct UserInfo {
uint256 amount;
uint256 tokenPaid;
uint256 pointPaid;
}
// Stored information for each user staking in each pool.
mapping (IERC20 => mapping (address => UserInfo)) public userInfo;
// The total sum of the strength of all pools.
uint256 public totalTokenStrength;
uint256 public totalPointStrength;
// The total amount of the disbursed token ever emitted by this Staker.
uint256 public totalTokenDisbursed;
// Users additionally accrue non-token points for participating via staking.
mapping (address => uint256) public userPoints;
mapping (address => uint256) public userSpentPoints;
// A map of all external addresses that are permitted to spend user points.
mapping (address => bool) public approvedPointSpenders;
// Events for depositing assets into the Staker and later withdrawing them.
event Deposit(address indexed user, IERC20 indexed token, uint256 amount);
event Withdraw(address indexed user, IERC20 indexed token, uint256 amount);
// An event for tracking when a user has spent points.
event SpentPoints(address indexed source, address indexed user, uint256 amount);
/**
Construct a new Staker by providing it a name and the token to disburse.
@param _name The name of the Staker contract.
@param _token The token to reward stakers in this contract with.
*/
constructor(string memory _name, IERC20 _token) public {
name = _name;
token = _token;
token.approve(address(this), MAX_INT);
canAlterDevelopers = true;
canAlterTokenEmissionSchedule = true;
earliestTokenEmissionBlock = MAX_INT;
canAlterPointEmissionSchedule = true;
earliestPointEmissionBlock = MAX_INT;
}
/**
Add a new developer to the Staker or overwrite an existing one.
This operation requires that developer address addition is not locked.
@param _developerAddress The additional developer's address.
@param _share The share in 1/1000th of a percent of each token emission sent
to this new developer.
*/
function addDeveloper(address _developerAddress, uint256 _share) external onlyOwner {
require(canAlterDevelopers,
"This Staker has locked the addition of developers; no more may be added.");
developerAddresses.push(_developerAddress);
developerShares[_developerAddress] = _share;
}
/**
Permanently forfeits owner ability to alter the state of Staker developers.
Once called, this function is intended to give peace of mind to the Staker's
developers and community that the fee structure is now immutable.
*/
function lockDevelopers() external onlyOwner {
canAlterDevelopers = false;
}
/**
A developer may at any time update their address or voluntarily reduce their
share of emissions by calling this function from their current address.
Note that updating a developer's share to zero effectively removes them.
@param _newDeveloperAddress An address to update this developer's address.
@param _newShare The new share in 1/1000th of a percent of each token
emission sent to this developer.
*/
function updateDeveloper(address _newDeveloperAddress, uint256 _newShare) external {
uint256 developerShare = developerShares[msg.sender];
require(developerShare > 0,
"You are not a developer of this Staker.");
require(_newShare <= developerShare,
"You cannot increase your developer share.");
developerShares[msg.sender] = 0;
developerAddresses.push(_newDeveloperAddress);
developerShares[_newDeveloperAddress] = _newShare;
}
/**
Set new emission details to the Staker or overwrite existing ones.
This operation requires that emission schedule alteration is not locked.
@param _tokenSchedule An array of EmissionPoints defining the token schedule.
@param _pointSchedule An array of EmissionPoints defining the point schedule.
*/
function setEmissions(EmissionPoint[] memory _tokenSchedule, EmissionPoint[] memory _pointSchedule) external onlyOwner {
if (_tokenSchedule.length > 0) {
require(canAlterTokenEmissionSchedule,
"This Staker has locked the alteration of token emissions.");
tokenEmissionBlockCount = _tokenSchedule.length;
for (uint256 i = 0; i < tokenEmissionBlockCount; i++) {
tokenEmissionBlocks[i] = _tokenSchedule[i];
if (earliestTokenEmissionBlock > _tokenSchedule[i].blockNumber) {
earliestTokenEmissionBlock = _tokenSchedule[i].blockNumber;
}
}
}
require(tokenEmissionBlockCount > 0,
"You must set the token emission schedule.");
if (_pointSchedule.length > 0) {
require(canAlterPointEmissionSchedule,
"This Staker has locked the alteration of point emissions.");
pointEmissionBlockCount = _pointSchedule.length;
for (uint256 i = 0; i < pointEmissionBlockCount; i++) {
pointEmissionBlocks[i] = _pointSchedule[i];
if (earliestPointEmissionBlock > _pointSchedule[i].blockNumber) {
earliestPointEmissionBlock = _pointSchedule[i].blockNumber;
}
}
}
require(tokenEmissionBlockCount > 0,
"You must set the point emission schedule.");
}
/**
Permanently forfeits owner ability to alter the emission schedule.
Once called, this function is intended to give peace of mind to the Staker's
developers and community that the inflation rate is now immutable.
*/
function lockTokenEmissions() external onlyOwner {
canAlterTokenEmissionSchedule = false;
}
/**
Permanently forfeits owner ability to alter the emission schedule.
Once called, this function is intended to give peace of mind to the Staker's
developers and community that the inflation rate is now immutable.
*/
function lockPointEmissions() external onlyOwner {
canAlterPointEmissionSchedule = false;
}
/**
Returns the length of the developer address array.
@return the length of the developer address array.
*/
function getDeveloperCount() external view returns (uint256) {
return developerAddresses.length;
}
/**
Returns the length of the staking pool array.
@return the length of the staking pool array.
*/
function getPoolCount() external view returns (uint256) {
return poolTokens.length;
}
/**
Returns the amount of token that has not been disbursed by the Staker yet.
@return the amount of token that has not been disbursed by the Staker yet.
*/
function getRemainingToken() external view returns (uint256) {
return token.balanceOf(address(this));
}
/**
Allows the contract owner to add a new asset pool to the Staker or overwrite
an existing one.
@param _token The address of the asset to base this staking pool off of.
@param _tokenStrength The relative strength of the new asset for earning token.
@param _pointStrength The relative strength of the new asset for earning points.
*/
function addPool(IERC20 _token, uint256 _tokenStrength, uint256 _pointStrength) external onlyOwner {
require(tokenEmissionBlockCount > 0 && pointEmissionBlockCount > 0,
"Staking pools cannot be addded until an emission schedule has been defined.");
uint256 lastTokenRewardBlock = block.number > earliestTokenEmissionBlock ? block.number : earliestTokenEmissionBlock;
uint256 lastPointRewardBlock = block.number > earliestPointEmissionBlock ? block.number : earliestPointEmissionBlock;
uint256 lastRewardBlock = lastTokenRewardBlock > lastPointRewardBlock ? lastTokenRewardBlock : lastPointRewardBlock;
if (address(poolInfo[_token].token) == address(0)) {
poolTokens.push(_token);
totalTokenStrength = totalTokenStrength.add(_tokenStrength);
totalPointStrength = totalPointStrength.add(_pointStrength);
poolInfo[_token] = PoolInfo({
token: _token,
tokenStrength: _tokenStrength,
tokensPerShare: 0,
pointStrength: _pointStrength,
pointsPerShare: 0,
lastRewardBlock: lastRewardBlock
});
} else {
totalTokenStrength = totalTokenStrength.sub(poolInfo[_token].tokenStrength).add(_tokenStrength);
poolInfo[_token].tokenStrength = _tokenStrength;
totalPointStrength = totalPointStrength.sub(poolInfo[_token].pointStrength).add(_pointStrength);
poolInfo[_token].pointStrength = _pointStrength;
}
}
/**
Uses the emission schedule to calculate the total amount of staking reward
token that was emitted between two specified block numbers.
@param _fromBlock The block to begin calculating emissions from.
@param _toBlock The block to calculate total emissions up to.
*/
function getTotalEmittedTokens(uint256 _fromBlock, uint256 _toBlock) public view returns (uint256) {
require(_toBlock >= _fromBlock,
"Tokens cannot be emitted from a higher block to a lower block.");
uint256 totalEmittedTokens = 0;
uint256 workingRate = 0;
uint256 workingBlock = _fromBlock;
for (uint256 i = 0; i < tokenEmissionBlockCount; ++i) {
uint256 emissionBlock = tokenEmissionBlocks[i].blockNumber;
uint256 emissionRate = tokenEmissionBlocks[i].rate;
if (_toBlock < emissionBlock) {
totalEmittedTokens = totalEmittedTokens.add(_toBlock.sub(workingBlock).mul(workingRate));
return totalEmittedTokens;
} else if (workingBlock < emissionBlock) {
totalEmittedTokens = totalEmittedTokens.add(emissionBlock.sub(workingBlock).mul(workingRate));
workingBlock = emissionBlock;
}
workingRate = emissionRate;
}
if (workingBlock < _toBlock) {
totalEmittedTokens = totalEmittedTokens.add(_toBlock.sub(workingBlock).mul(workingRate));
}
return totalEmittedTokens;
}
/**
Uses the emission schedule to calculate the total amount of points
emitted between two specified block numbers.
@param _fromBlock The block to begin calculating emissions from.
@param _toBlock The block to calculate total emissions up to.
*/
function getTotalEmittedPoints(uint256 _fromBlock, uint256 _toBlock) public view returns (uint256) {
require(_toBlock >= _fromBlock,
"Points cannot be emitted from a higher block to a lower block.");
uint256 totalEmittedPoints = 0;
uint256 workingRate = 0;
uint256 workingBlock = _fromBlock;
for (uint256 i = 0; i < pointEmissionBlockCount; ++i) {
uint256 emissionBlock = pointEmissionBlocks[i].blockNumber;
uint256 emissionRate = pointEmissionBlocks[i].rate;
if (_toBlock < emissionBlock) {
totalEmittedPoints = totalEmittedPoints.add(_toBlock.sub(workingBlock).mul(workingRate));
return totalEmittedPoints;
} else if (workingBlock < emissionBlock) {
totalEmittedPoints = totalEmittedPoints.add(emissionBlock.sub(workingBlock).mul(workingRate));
workingBlock = emissionBlock;
}
workingRate = emissionRate;
}
if (workingBlock < _toBlock) {
totalEmittedPoints = totalEmittedPoints.add(_toBlock.sub(workingBlock).mul(workingRate));
}
return totalEmittedPoints;
}
/**
Update the pool corresponding to the specified token address.
@param _token The address of the asset to update the corresponding pool for.
*/
function updatePool(IERC20 _token) internal {
PoolInfo storage pool = poolInfo[_token];
if (block.number <= pool.lastRewardBlock) {
return;
}
uint256 poolTokenSupply = pool.token.balanceOf(address(this));
if (address(_token) == address(token)) {
poolTokenSupply = totalTokenDeposited;
}
if (poolTokenSupply <= 0) {
pool.lastRewardBlock = block.number;
return;
}
// Calculate tokens and point rewards for this pool.
uint256 totalEmittedTokens = getTotalEmittedTokens(pool.lastRewardBlock, block.number);
uint256 tokensReward = totalEmittedTokens.mul(pool.tokenStrength).div(totalTokenStrength).mul(1e12);
uint256 totalEmittedPoints = getTotalEmittedPoints(pool.lastRewardBlock, block.number);
uint256 pointsReward = totalEmittedPoints.mul(pool.pointStrength).div(totalPointStrength).mul(1e30);
// Directly pay developers their corresponding share of tokens and points.
for (uint256 i = 0; i < developerAddresses.length; ++i) {
address developer = developerAddresses[i];
uint256 share = developerShares[developer];
uint256 devTokens = tokensReward.mul(share).div(100000);
tokensReward = tokensReward - devTokens;
uint256 devPoints = pointsReward.mul(share).div(100000);
pointsReward = pointsReward - devPoints;
token.safeTransferFrom(address(this), developer, devTokens.div(1e12));
userPoints[developer] = userPoints[developer].add(devPoints.div(1e30));
}
// Update the pool rewards per share to pay users the amount remaining.
pool.tokensPerShare = pool.tokensPerShare.add(tokensReward.div(poolTokenSupply));
pool.pointsPerShare = pool.pointsPerShare.add(pointsReward.div(poolTokenSupply));
pool.lastRewardBlock = block.number;
}
/**
A function to easily see the amount of token rewards pending for a user on a
given pool. Returns the pending reward token amount.
@param _token The address of a particular staking pool asset to check for a
pending reward.
@param _user The user address to check for a pending reward.
@return the pending reward token amount.
*/
function getPendingTokens(IERC20 _token, address _user) public view returns (uint256) {
PoolInfo storage pool = poolInfo[_token];
UserInfo storage user = userInfo[_token][_user];
uint256 tokensPerShare = pool.tokensPerShare;
uint256 poolTokenSupply = pool.token.balanceOf(address(this));
if (address(_token) == address(token)) {
poolTokenSupply = totalTokenDeposited;
}
if (block.number > pool.lastRewardBlock && poolTokenSupply > 0) {
uint256 totalEmittedTokens = getTotalEmittedTokens(pool.lastRewardBlock, block.number);
uint256 tokensReward = totalEmittedTokens.mul(pool.tokenStrength).div(totalTokenStrength).mul(1e12);
tokensPerShare = tokensPerShare.add(tokensReward.div(poolTokenSupply));
}
return user.amount.mul(tokensPerShare).div(1e12).sub(user.tokenPaid);
}
/**
A function to easily see the amount of point rewards pending for a user on a
given pool. Returns the pending reward point amount.
@param _token The address of a particular staking pool asset to check for a
pending reward.
@param _user The user address to check for a pending reward.
@return the pending reward token amount.
*/
function getPendingPoints(IERC20 _token, address _user) public view returns (uint256) {
PoolInfo storage pool = poolInfo[_token];
UserInfo storage user = userInfo[_token][_user];
uint256 pointsPerShare = pool.pointsPerShare;
uint256 poolTokenSupply = pool.token.balanceOf(address(this));
if (address(_token) == address(token)) {
poolTokenSupply = totalTokenDeposited;
}
if (block.number > pool.lastRewardBlock && poolTokenSupply > 0) {
uint256 totalEmittedPoints = getTotalEmittedPoints(pool.lastRewardBlock, block.number);
uint256 pointsReward = totalEmittedPoints.mul(pool.pointStrength).div(totalPointStrength).mul(1e30);
pointsPerShare = pointsPerShare.add(pointsReward.div(poolTokenSupply));
}
return user.amount.mul(pointsPerShare).div(1e30).sub(user.pointPaid);
}
/**
Return the number of points that the user has available to spend.
@return the number of points that the user has available to spend.
*/
function getAvailablePoints(address _user) public view returns (uint256) {
uint256 concreteTotal = userPoints[_user];
uint256 pendingTotal = 0;
for (uint256 i = 0; i < poolTokens.length; ++i) {
IERC20 poolToken = poolTokens[i];
uint256 _pendingPoints = getPendingPoints(poolToken, _user);
pendingTotal = pendingTotal.add(_pendingPoints);
}
uint256 spentTotal = userSpentPoints[_user];
return concreteTotal.add(pendingTotal).sub(spentTotal);
}
/**
Return the total number of points that the user has ever accrued.
@return the total number of points that the user has ever accrued.
*/
function getTotalPoints(address _user) external view returns (uint256) {
uint256 concreteTotal = userPoints[_user];
uint256 pendingTotal = 0;
for (uint256 i = 0; i < poolTokens.length; ++i) {
IERC20 poolToken = poolTokens[i];
uint256 _pendingPoints = getPendingPoints(poolToken, _user);
pendingTotal = pendingTotal.add(_pendingPoints);
}
return concreteTotal.add(pendingTotal);
}
/**
Return the total number of points that the user has ever spent.
@return the total number of points that the user has ever spent.
*/
function getSpentPoints(address _user) external view returns (uint256) {
return userSpentPoints[_user];
}
/**
Deposit some particular assets to a particular pool on the Staker.
@param _token The asset to stake into its corresponding pool.
@param _amount The amount of the provided asset to stake.
*/
function deposit(IERC20 _token, uint256 _amount) external nonReentrant {
PoolInfo storage pool = poolInfo[_token];
require(pool.tokenStrength > 0 || pool.pointStrength > 0,
"You cannot deposit assets into an inactive pool.");
UserInfo storage user = userInfo[_token][msg.sender];
updatePool(_token);
if (user.amount > 0) {
uint256 pendingTokens = user.amount.mul(pool.tokensPerShare).div(1e12).sub(user.tokenPaid);
token.safeTransferFrom(address(this), msg.sender, pendingTokens);
totalTokenDisbursed = totalTokenDisbursed.add(pendingTokens);
uint256 pendingPoints = user.amount.mul(pool.pointsPerShare).div(1e30).sub(user.pointPaid);
userPoints[msg.sender] = userPoints[msg.sender].add(pendingPoints);
}
pool.token.safeTransferFrom(address(msg.sender), address(this), _amount);
if (address(_token) == address(token)) {
totalTokenDeposited = totalTokenDeposited.add(_amount);
}
user.amount = user.amount.add(_amount);
user.tokenPaid = user.amount.mul(pool.tokensPerShare).div(1e12);
user.pointPaid = user.amount.mul(pool.pointsPerShare).div(1e30);
emit Deposit(msg.sender, _token, _amount);
}
/**
Withdraw some particular assets from a particular pool on the Staker.
@param _token The asset to withdraw from its corresponding staking pool.
@param _amount The amount of the provided asset to withdraw.
*/
function withdraw(IERC20 _token, uint256 _amount) external nonReentrant {
PoolInfo storage pool = poolInfo[_token];
UserInfo storage user = userInfo[_token][msg.sender];
require(user.amount >= _amount,
"You cannot withdraw that much of the specified token; you are not owed it.");
updatePool(_token);
uint256 pendingTokens = user.amount.mul(pool.tokensPerShare).div(1e12).sub(user.tokenPaid);
token.safeTransferFrom(address(this), msg.sender, pendingTokens);
totalTokenDisbursed = totalTokenDisbursed.add(pendingTokens);
uint256 pendingPoints = user.amount.mul(pool.pointsPerShare).div(1e30).sub(user.pointPaid);
userPoints[msg.sender] = userPoints[msg.sender].add(pendingPoints);
if (address(_token) == address(token)) {
totalTokenDeposited = totalTokenDeposited.sub(_amount);
}
user.amount = user.amount.sub(_amount);
user.tokenPaid = user.amount.mul(pool.tokensPerShare).div(1e12);
user.pointPaid = user.amount.mul(pool.pointsPerShare).div(1e30);
pool.token.safeTransfer(address(msg.sender), _amount);
emit Withdraw(msg.sender, _token, _amount);
}
/**
Allows the owner of this Staker to grant or remove approval to an external
spender of the points that users accrue from staking resources.
@param _spender The external address allowed to spend user points.
@param _approval The updated user approval status.
*/
function approvePointSpender(address _spender, bool _approval) external onlyOwner {
approvedPointSpenders[_spender] = _approval;
}
/**
Allows an approved spender of points to spend points on behalf of a user.
@param _user The user whose points are being spent.
@param _amount The amount of the user's points being spent.
*/
function spendPoints(address _user, uint256 _amount) external {
require(approvedPointSpenders[msg.sender],
"You are not permitted to spend user points.");
uint256 _userPoints = getAvailablePoints(_user);
require(_userPoints >= _amount,
"The user does not have enough points to spend the requested amount.");
userSpentPoints[_user] = userSpentPoints[_user].add(_amount);
emit SpentPoints(msg.sender, _user, _amount);
}
/**
Sweep all of a particular ERC-20 token from the contract.
@param _token The token to sweep the balance from.
*/
function sweep(IERC20 _token) external onlyOwner {
uint256 balance = _token.balanceOf(address(this));
_token.safeTransferFrom(address(this), msg.sender, balance);
}
}
// SPDX-License-Identifier: GPL-3.0
pragma solidity 0.7.6;
pragma experimental ABIEncoderV2;
/**
@title A proxy registry contract.
@author Protinam, Project Wyvern
@author Tim Clancy
This contract was originally developed by Project Wyvern
(https://github.com/ProjectWyvern/) where it currently enjoys great success as
a component of the primary exchange contract for OpenSea. It has been modified
to support a more modern version of Solidity with associated best practices.
The documentation has also been improved to provide more clarity.
*/
abstract contract StubProxyRegistry {
/**
This mapping relates an addresses to its own personal `OwnableDelegateProxy`
which allow it to proxy functionality to the various callers contained in
`authorizedCallers`.
*/
mapping(address => address) public proxies;
}
// SPDX-License-Identifier: GPL-3.0
pragma solidity 0.7.6;
pragma experimental ABIEncoderV2;
import "@openzeppelin/contracts/introspection/ERC165.sol";
import "@openzeppelin/contracts/token/ERC1155/IERC1155.sol";
import "@openzeppelin/contracts/token/ERC1155/IERC1155MetadataURI.sol";
import "@openzeppelin/contracts/token/ERC1155/IERC1155Receiver.sol";
import "@openzeppelin/contracts/math/SafeMath.sol";
import "@openzeppelin/contracts/utils/Address.sol";
import "./access/PermitControl.sol";
import "./proxy/StubProxyRegistry.sol";
/**
@title An ERC-1155 item creation contract.
@author Tim Clancy
This contract represents the NFTs within a single collection. It allows for a
designated collection owner address to manage the creation of NFTs within this
collection. The collection owner grants approval to or removes approval from
other addresses governing their ability to mint NFTs from this collection.
This contract is forked from the inherited OpenZeppelin dependency, and uses
ideas from the original ERC-1155 reference implementation.
July 19th, 2021.
*/
contract Super1155 is PermitControl, ERC165, IERC1155, IERC1155MetadataURI {
using Address for address;
using SafeMath for uint256;
/// The public identifier for the right to set this contract's metadata URI.
bytes32 public constant SET_URI = keccak256("SET_URI");
/// The public identifier for the right to set this contract's proxy registry.
bytes32 public constant SET_PROXY_REGISTRY = keccak256("SET_PROXY_REGISTRY");
/// The public identifier for the right to configure item groups.
bytes32 public constant CONFIGURE_GROUP = keccak256("CONFIGURE_GROUP");
/// The public identifier for the right to mint items.
bytes32 public constant MINT = keccak256("MINT");
/// The public identifier for the right to burn items.
bytes32 public constant BURN = keccak256("BURN");
/// The public identifier for the right to set item metadata.
bytes32 public constant SET_METADATA = keccak256("SET_METADATA");
/// The public identifier for the right to lock the metadata URI.
bytes32 public constant LOCK_URI = keccak256("LOCK_URI");
/// The public identifier for the right to lock an item's metadata.
bytes32 public constant LOCK_ITEM_URI = keccak256("LOCK_ITEM_URI");
/// The public identifier for the right to disable item creation.
bytes32 public constant LOCK_CREATION = keccak256("LOCK_CREATION");
/// @dev Supply the magic number for the required ERC-1155 interface.
bytes4 private constant INTERFACE_ERC1155 = 0xd9b67a26;
/// @dev Supply the magic number for the required ERC-1155 metadata extension.
bytes4 private constant INTERFACE_ERC1155_METADATA_URI = 0x0e89341c;
/// @dev A mask for isolating an item's group ID.
uint256 private constant GROUP_MASK = uint256(uint128(~0)) << 128;
/// The public name of this contract.
string public name;
/**
The ERC-1155 URI for tracking item metadata, supporting {id} substitution.
For example: https://token-cdn-domain/{id}.json. See the ERC-1155 spec for
more details: https://eips.ethereum.org/EIPS/eip-1155#metadata.
*/
string public metadataUri;
/// A proxy registry address for supporting automatic delegated approval.
address public proxyRegistryAddress;
/// @dev A mapping from each token ID to per-address balances.
mapping (uint256 => mapping(address => uint256)) private balances;
/// A mapping from each group ID to per-address balances.
mapping (uint256 => mapping(address => uint256)) public groupBalances;
/// A mapping from each address to a collection-wide balance.
mapping(address => uint256) public totalBalances;
/**
@dev This is a mapping from each address to per-address operator approvals.
Operators are those addresses that have been approved to transfer tokens on
behalf of the approver. Transferring tokens includes the right to burn
tokens.
*/
mapping (address => mapping(address => bool)) private operatorApprovals;
/**
This enumeration lists the various supply types that each item group may
use. In general, the administrator of this collection or those permissioned
to do so may move from a more-permissive supply type to a less-permissive.
For example: an uncapped or flexible supply type may be converted to a
capped supply type. A capped supply type may not be uncapped later, however.
@param Capped There exists a fixed cap on the size of the item group. The
cap is set by `supplyData`.
@param Uncapped There is no cap on the size of the item group. The value of
`supplyData` cannot be set below the current circulating supply but is
otherwise ignored.
@param Flexible There is a cap which can be raised or lowered (down to
circulating supply) freely. The value of `supplyData` cannot be set below
the current circulating supply and determines the cap.
*/
enum SupplyType {
Capped,
Uncapped,
Flexible
}
/**
This enumeration lists the various item types that each item group may use.
In general, these are static once chosen.
@param Nonfungible The item group is truly nonfungible where each ID may be
used only once. The value of `itemData` is ignored.
@param Fungible The item group is truly fungible and collapses into a single
ID. The value of `itemData` is ignored.
@param Semifungible The item group may be broken up across multiple
repeating token IDs. The value of `itemData` is the cap of any single
token ID in the item group.
*/
enum ItemType {
Nonfungible,
Fungible,
Semifungible
}
/**
This enumeration lists the various burn types that each item group may use.
These are static once chosen.
@param None The items in this group may not be burnt. The value of
`burnData` is ignored.
@param Burnable The items in this group may be burnt. The value of
`burnData` is the maximum that may be burnt.
@param Replenishable The items in this group, once burnt, may be reminted by
the owner. The value of `burnData` is ignored.
*/
enum BurnType {
None,
Burnable,
Replenishable
}
/**
This struct is a source of mapping-free input to the `configureGroup`
function. It defines the settings for a particular item group.
@param name A name for the item group.
@param supplyType The supply type for this group of items.
@param supplyData An optional integer used by some `supplyType` values.
@param itemType The type of item represented by this item group.
@param itemData An optional integer used by some `itemType` values.
@param burnType The type of burning permitted by this item group.
@param burnData An optional integer used by some `burnType` values.
*/
struct ItemGroupInput {
string name;
SupplyType supplyType;
uint256 supplyData;
ItemType itemType;
uint256 itemData;
BurnType burnType;
uint256 burnData;
}
/**
This struct defines the settings for a particular item group and is tracked
in storage.
@param initialized Whether or not this `ItemGroup` has been initialized.
@param name A name for the item group.
@param supplyType The supply type for this group of items.
@param supplyData An optional integer used by some `supplyType` values.
@param itemType The type of item represented by this item group.
@param itemData An optional integer used by some `itemType` values.
@param burnType The type of burning permitted by this item group.
@param burnData An optional integer used by some `burnType` values.
@param circulatingSupply The number of individual items within this group in
circulation.
@param mintCount The number of times items in this group have been minted.
@param burnCount The number of times items in this group have been burnt.
*/
struct ItemGroup {
bool initialized;
string name;
SupplyType supplyType;
uint256 supplyData;
ItemType itemType;
uint256 itemData;
BurnType burnType;
uint256 burnData;
uint256 circulatingSupply;
uint256 mintCount;
uint256 burnCount;
}
/// A mapping of data for each item group.
mapping (uint256 => ItemGroup) public itemGroups;
/// A mapping of circulating supplies for each individual token.
mapping (uint256 => uint256) public circulatingSupply;
/// A mapping of the number of times each individual token has been minted.
mapping (uint256 => uint256) public mintCount;
/// A mapping of the number of times each individual token has been burnt.
mapping (uint256 => uint256) public burnCount;
/**
A mapping of token ID to a boolean representing whether the item's metadata
has been explicitly frozen via a call to `lockURI(string calldata _uri,
uint256 _id)`. Do note that it is possible for an item's mapping here to be
false while still having frozen metadata if the item collection as a whole
has had its `uriLocked` value set to true.
*/
mapping (uint256 => bool) public metadataFrozen;
/**
A public mapping of optional on-chain metadata for each token ID. A token's
on-chain metadata is unable to be changed if the item's metadata URI has
been permanently fixed or if the collection's metadata URI as a whole has
been frozen.
*/
mapping (uint256 => string) public metadata;
/// Whether or not the metadata URI has been locked to future changes.
bool public uriLocked;
/// Whether or not the item collection has been locked to all further minting.
bool public locked;
/**
An event that gets emitted when the metadata collection URI is changed.
@param oldURI The old metadata URI.
@param newURI The new metadata URI.
*/
event ChangeURI(string indexed oldURI, string indexed newURI);
/**
An event that gets emitted when the proxy registry address is changed.
@param oldRegistry The old proxy registry address.
@param newRegistry The new proxy registry address.
*/
event ChangeProxyRegistry(address indexed oldRegistry,
address indexed newRegistry);
/**
An event that gets emitted when an item group is configured.
@param manager The caller who configured the item group `_groupId`.
@param groupId The groupId being configured.
@param newGroup The new group configuration.
*/
event ItemGroupConfigured(address indexed manager, uint256 groupId,
ItemGroupInput indexed newGroup);
/**
An event that gets emitted when the item collection is locked to further
creation.
@param locker The caller who locked the collection.
*/
event CollectionLocked(address indexed locker);
/**
An event that gets emitted when a token ID has its on-chain metadata
changed.
@param changer The caller who triggered the metadata change.
@param id The ID of the token which had its metadata changed.
@param oldMetadata The old metadata of the token.
@param newMetadata The new metadata of the token.
*/
event MetadataChanged(address indexed changer, uint256 indexed id,
string oldMetadata, string indexed newMetadata);
/**
An event that indicates we have set a permanent metadata URI for a token.
@param _value The value of the permanent metadata URI.
@param _id The token ID associated with the permanent metadata value.
*/
event PermanentURI(string _value, uint256 indexed _id);
/**
A modifier which allows only the super-administrative owner or addresses
with a specified valid right to perform a call on some specific item. Rights
can be applied to the universal circumstance, the item-group-level
circumstance, or to the circumstance of the item ID itself.
@param _id The item ID on which we check for the validity of the specified
`right`.
@param _right The right to validate for the calling address. It must be
non-expired and exist within the specified `_itemId`.
*/
modifier hasItemRight(uint256 _id, bytes32 _right) {
uint256 groupId = (_id & GROUP_MASK) >> 128;
if (_msgSender() == owner()) {
_;
} else if (hasRightUntil(_msgSender(), UNIVERSAL, _right)
> block.timestamp) {
_;
} else if (hasRightUntil(_msgSender(), bytes32(groupId), _right)
> block.timestamp) {
_;
} else if (hasRightUntil(_msgSender(), bytes32(_id), _right)
> block.timestamp) {
_;
}
}
/**
Construct a new ERC-1155 item collection.
@param _owner The address of the administrator governing this collection.
@param _name The name to assign to this item collection contract.
@param _uri The metadata URI to perform later token ID substitution with.
@param _proxyRegistryAddress The address of a proxy registry contract.
*/
constructor(address _owner, string memory _name, string memory _uri,
address _proxyRegistryAddress) public {
// Register the ERC-165 interfaces.
_registerInterface(INTERFACE_ERC1155);
_registerInterface(INTERFACE_ERC1155_METADATA_URI);
// Do not perform a redundant ownership transfer if the deployer should
// remain as the owner of the collection.
if (_owner != owner()) {
transferOwnership(_owner);
}
// Continue initialization.
name = _name;
metadataUri = _uri;
proxyRegistryAddress = _proxyRegistryAddress;
}
/**
Return a version number for this contract's interface.
*/
function version() external virtual override pure returns (uint256) {
return 1;
}
/**
Return the item collection's metadata URI. This implementation returns the
same URI for all tokens within the collection and relies on client-side
ID substitution per https://eips.ethereum.org/EIPS/eip-1155#metadata. Per
said specification, clients calling this function must replace the {id}
substring with the actual token ID in hex, not prefixed by 0x, and padded
to 64 characters in length.
@return The metadata URI string of the item with ID `_itemId`.
*/
function uri(uint256) external override view returns (string memory) {
return metadataUri;
}
/**
Allow the item collection owner or an approved manager to update the
metadata URI of this collection. This implementation relies on a single URI
for all items within the collection, and as such does not emit the standard
URI event. Instead, we emit our own event to reflect changes in the URI.
@param _uri The new URI to update to.
*/
function setURI(string calldata _uri) external virtual
hasValidPermit(UNIVERSAL, SET_URI) {
require(!uriLocked,
"Super1155: the collection URI has been permanently locked");
string memory oldURI = metadataUri;
metadataUri = _uri;
emit ChangeURI(oldURI, _uri);
}
/**
Allow the item collection owner or an approved manager to update the proxy
registry address handling delegated approval.
@param _proxyRegistryAddress The address of the new proxy registry to
update to.
*/
function setProxyRegistry(address _proxyRegistryAddress) external virtual
hasValidPermit(UNIVERSAL, SET_PROXY_REGISTRY) {
address oldRegistry = proxyRegistryAddress;
proxyRegistryAddress = _proxyRegistryAddress;
emit ChangeProxyRegistry(oldRegistry, _proxyRegistryAddress);
}
/**
Retrieve the balance of a particular token `_id` for a particular address
`_owner`.
@param _owner The owner to check for this token balance.
@param _id The ID of the token to check for a balance.
@return The amount of token `_id` owned by `_owner`.
*/
function balanceOf(address _owner, uint256 _id) public override view virtual
returns (uint256) {
require(_owner != address(0),
"ERC1155: balance query for the zero address");
return balances[_id][_owner];
}
/**
Retrieve in a single call the balances of some mulitple particular token
`_ids` held by corresponding `_owners`.
@param _owners The owners to check for token balances.
@param _ids The IDs of tokens to check for balances.
@return the amount of each token owned by each owner.
*/
function balanceOfBatch(address[] calldata _owners, uint256[] calldata _ids)
external override view virtual returns (uint256[] memory) {
require(_owners.length == _ids.length,
"ERC1155: accounts and ids length mismatch");
// Populate and return an array of balances.
uint256[] memory batchBalances = new uint256[](_owners.length);
for (uint256 i = 0; i < _owners.length; ++i) {
batchBalances[i] = balanceOf(_owners[i], _ids[i]);
}
return batchBalances;
}
/**
This function returns true if `_operator` is approved to transfer items
owned by `_owner`. This approval check features an override to explicitly
whitelist any addresses delegated in the proxy registry.
@param _owner The owner of items to check for transfer ability.
@param _operator The potential transferrer of `_owner`'s items.
@return Whether `_operator` may transfer items owned by `_owner`.
*/
function isApprovedForAll(address _owner, address _operator) public override
view virtual returns (bool) {
StubProxyRegistry proxyRegistry = StubProxyRegistry(proxyRegistryAddress);
if (address(proxyRegistry.proxies(_owner)) == _operator) {
return true;
}
// We did not find an explicit whitelist in the proxy registry.
return operatorApprovals[_owner][_operator];
}
/**
Enable or disable approval for a third party `_operator` address to manage
(transfer or burn) all of the caller's tokens.
@param _operator The address to grant management rights over all of the
caller's tokens.
@param _approved The status of the `_operator`'s approval for the caller.
*/
function setApprovalForAll(address _operator, bool _approved) external
override virtual {
require(_msgSender() != _operator,
"ERC1155: setting approval status for self");
operatorApprovals[_msgSender()][_operator] = _approved;
emit ApprovalForAll(_msgSender(), _operator, _approved);
}
/**
This private helper function converts a number into a single-element array.
@param _element The element to convert to an array.
@return The array containing the single `_element`.
*/
function _asSingletonArray(uint256 _element) private pure
returns (uint256[] memory) {
uint256[] memory array = new uint256[](1);
array[0] = _element;
return array;
}
/**
An inheritable and configurable pre-transfer hook that can be overridden.
It fires before any token transfer, including mints and burns.
@param _operator The caller who triggers the token transfer.
@param _from The address to transfer tokens from.
@param _to The address to transfer tokens to.
@param _ids The specific token IDs to transfer.
@param _amounts The amounts of the specific `_ids` to transfer.
@param _data Additional call data to send with this transfer.
*/
function _beforeTokenTransfer(address _operator, address _from, address _to,
uint256[] memory _ids, uint256[] memory _amounts, bytes memory _data)
internal virtual {
}
/**
ERC-1155 dictates that any contract which wishes to receive ERC-1155 tokens
must explicitly designate itself as such. This function checks for such
designation to prevent undesirable token transfers.
@param _operator The caller who triggers the token transfer.
@param _from The address to transfer tokens from.
@param _to The address to transfer tokens to.
@param _id The specific token ID to transfer.
@param _amount The amount of the specific `_id` to transfer.
@param _data Additional call data to send with this transfer.
*/
function _doSafeTransferAcceptanceCheck(address _operator, address _from,
address _to, uint256 _id, uint256 _amount, bytes calldata _data) private {
if (_to.isContract()) {
try IERC1155Receiver(_to).onERC1155Received(_operator, _from, _id,
_amount, _data) returns (bytes4 response) {
if (response != IERC1155Receiver(_to).onERC1155Received.selector) {
revert("ERC1155: ERC1155Receiver rejected tokens");
}
} catch Error(string memory reason) {
revert(reason);
} catch {
revert("ERC1155: transfer to non ERC1155Receiver implementer");
}
}
}
/**
Transfer on behalf of a caller or one of their authorized token managers
items from one address to another.
@param _from The address to transfer tokens from.
@param _to The address to transfer tokens to.
@param _id The specific token ID to transfer.
@param _amount The amount of the specific `_id` to transfer.
@param _data Additional call data to send with this transfer.
*/
function safeTransferFrom(address _from, address _to, uint256 _id,
uint256 _amount, bytes calldata _data) external override virtual {
require(_to != address(0),
"ERC1155: transfer to the zero address");
require(_from == _msgSender() || isApprovedForAll(_from, _msgSender()),
"ERC1155: caller is not owner nor approved");
// Validate transfer safety and send tokens away.
address operator = _msgSender();
_beforeTokenTransfer(operator, _from, _to, _asSingletonArray(_id),
_asSingletonArray(_amount), _data);
// Retrieve the item's group ID.
uint256 shiftedGroupId = (_id & GROUP_MASK);
uint256 groupId = shiftedGroupId >> 128;
// Update all specially-tracked group-specific balances.
balances[_id][_from] = balances[_id][_from].sub(_amount,
"ERC1155: insufficient balance for transfer");
balances[_id][_to] = balances[_id][_to].add(_amount);
groupBalances[groupId][_from] = groupBalances[groupId][_from].sub(_amount);
groupBalances[groupId][_to] = groupBalances[groupId][_to].add(_amount);
totalBalances[_from] = totalBalances[_from].sub(_amount);
totalBalances[_to] = totalBalances[_to].add(_amount);
// Emit the transfer event and perform the safety check.
emit TransferSingle(operator, _from, _to, _id, _amount);
_doSafeTransferAcceptanceCheck(operator, _from, _to, _id, _amount, _data);
}
/**
The batch equivalent of `_doSafeTransferAcceptanceCheck()`.
@param _operator The caller who triggers the token transfer.
@param _from The address to transfer tokens from.
@param _to The address to transfer tokens to.
@param _ids The specific token IDs to transfer.
@param _amounts The amounts of the specific `_ids` to transfer.
@param _data Additional call data to send with this transfer.
*/
function _doSafeBatchTransferAcceptanceCheck(address _operator, address _from,
address _to, uint256[] memory _ids, uint256[] memory _amounts, bytes memory
_data) private {
if (_to.isContract()) {
try IERC1155Receiver(_to).onERC1155BatchReceived(_operator, _from, _ids,
_amounts, _data) returns (bytes4 response) {
if (response != IERC1155Receiver(_to).onERC1155BatchReceived.selector) {
revert("ERC1155: ERC1155Receiver rejected tokens");
}
} catch Error(string memory reason) {
revert(reason);
} catch {
revert("ERC1155: transfer to non ERC1155Receiver implementer");
}
}
}
/**
Transfer on behalf of a caller or one of their authorized token managers
items from one address to another.
@param _from The address to transfer tokens from.
@param _to The address to transfer tokens to.
@param _ids The specific token IDs to transfer.
@param _amounts The amounts of the specific `_ids` to transfer.
@param _data Additional call data to send with this transfer.
*/
function safeBatchTransferFrom(address _from, address _to,
uint256[] memory _ids, uint256[] memory _amounts, bytes memory _data)
external override virtual {
require(_ids.length == _amounts.length,
"ERC1155: ids and amounts length mismatch");
require(_to != address(0),
"ERC1155: transfer to the zero address");
require(_from == _msgSender() || isApprovedForAll(_from, _msgSender()),
"ERC1155: caller is not owner nor approved");
// Validate transfer and perform all batch token sends.
_beforeTokenTransfer(_msgSender(), _from, _to, _ids, _amounts, _data);
for (uint256 i = 0; i < _ids.length; ++i) {
// Retrieve the item's group ID.
uint256 groupId = (_ids[i] & GROUP_MASK) >> 128;
// Update all specially-tracked group-specific balances.
balances[_ids[i]][_from] = balances[_ids[i]][_from].sub(_amounts[i],
"ERC1155: insufficient balance for transfer");
balances[_ids[i]][_to] = balances[_ids[i]][_to].add(_amounts[i]);
groupBalances[groupId][_from] = groupBalances[groupId][_from]
.sub(_amounts[i]);
groupBalances[groupId][_to] = groupBalances[groupId][_to]
.add(_amounts[i]);
totalBalances[_from] = totalBalances[_from].sub(_amounts[i]);
totalBalances[_to] = totalBalances[_to].add(_amounts[i]);
}
// Emit the transfer event and perform the safety check.
emit TransferBatch(_msgSender(), _from, _to, _ids, _amounts);
_doSafeBatchTransferAcceptanceCheck(_msgSender(), _from, _to, _ids,
_amounts, _data);
}
/**
Create a new NFT item group or configure an existing one. NFTs within a
group share a group ID in the upper 128-bits of their full item ID.
Within a group NFTs can be distinguished for the purposes of serializing
issue numbers.
@param _groupId The ID of the item group to create or configure.
@param _data The `ItemGroup` data input.
*/
function configureGroup(uint256 _groupId, ItemGroupInput calldata _data)
external virtual hasItemRight(_groupId, CONFIGURE_GROUP) {
require(_groupId != 0,
"Super1155: group ID 0 is invalid");
// If the collection is not locked, we may add a new item group.
if (!itemGroups[_groupId].initialized) {
require(!locked,
"Super1155: the collection is locked so groups cannot be created");
itemGroups[_groupId] = ItemGroup({
initialized: true,
name: _data.name,
supplyType: _data.supplyType,
supplyData: _data.supplyData,
itemType: _data.itemType,
itemData: _data.itemData,
burnType: _data.burnType,
burnData: _data.burnData,
circulatingSupply: 0,
mintCount: 0,
burnCount: 0
});
// Edit an existing item group. The name may always be updated.
} else {
itemGroups[_groupId].name = _data.name;
// A capped supply type may not change.
// It may also not have its cap increased.
if (itemGroups[_groupId].supplyType == SupplyType.Capped) {
require(_data.supplyType == SupplyType.Capped,
"Super1155: you may not uncap a capped supply type");
require(_data.supplyData <= itemGroups[_groupId].supplyData,
"Super1155: you may not increase the supply of a capped type");
// The flexible and uncapped types may freely change.
} else {
itemGroups[_groupId].supplyType = _data.supplyType;
}
// Item supply data may not be reduced below the circulating supply.
require(_data.supplyData >= itemGroups[_groupId].circulatingSupply,
"Super1155: you may not decrease supply below the circulating amount");
itemGroups[_groupId].supplyData = _data.supplyData;
// A nonfungible item may not change type.
if (itemGroups[_groupId].itemType == ItemType.Nonfungible) {
require(_data.itemType == ItemType.Nonfungible,
"Super1155: you may not alter nonfungible items");
// A semifungible item may not change type.
} else if (itemGroups[_groupId].itemType == ItemType.Semifungible) {
require(_data.itemType == ItemType.Semifungible,
"Super1155: you may not alter nonfungible items");
// A fungible item may change type if it is unique enough.
} else if (itemGroups[_groupId].itemType == ItemType.Fungible) {
if (_data.itemType == ItemType.Nonfungible) {
require(itemGroups[_groupId].circulatingSupply <= 1,
"Super1155: the fungible item is not unique enough to change");
itemGroups[_groupId].itemType = ItemType.Nonfungible;
// We may also try for semifungible items with a high-enough cap.
} else if (_data.itemType == ItemType.Semifungible) {
require(itemGroups[_groupId].circulatingSupply <= _data.itemData,
"Super1155: the fungible item is not unique enough to change");
itemGroups[_groupId].itemType = ItemType.Semifungible;
itemGroups[_groupId].itemData = _data.itemData;
}
}
}
// Emit the configuration event.
emit ItemGroupConfigured(_msgSender(), _groupId, _data);
}
/**
This is a private helper function to replace the `hasItemRight` modifier
that we use on some functions in order to inline this check during batch
minting and burning.
@param _id The ID of the item to check for the given `_right` on.
@param _right The right that the caller is trying to exercise on `_id`.
@return Whether or not the caller has a valid right on this item.
*/
function _hasItemRight(uint256 _id, bytes32 _right) private view
returns (bool) {
uint256 groupId = (_id & GROUP_MASK) >> 128;
if (_msgSender() == owner()) {
return true;
} else if (hasRightUntil(_msgSender(), UNIVERSAL, _right)
> block.timestamp) {
return true;
} else if (hasRightUntil(_msgSender(), bytes32(groupId), _right)
> block.timestamp) {
return true;
} else if (hasRightUntil(_msgSender(), bytes32(_id), _right)
> block.timestamp) {
return true;
} else {
return false;
}
}
/**
This is a private helper function to verify, according to all of our various
minting and burning rules, whether it would be valid to mint some `_amount`
of a particular item `_id`.
@param _id The ID of the item to check for minting validity.
@param _amount The amount of the item to try checking mintability for.
@return The ID of the item that should have `_amount` minted for it.
*/
function _mintChecker(uint256 _id, uint256 _amount) private view
returns (uint256) {
// Retrieve the item's group ID.
uint256 shiftedGroupId = (_id & GROUP_MASK);
uint256 groupId = shiftedGroupId >> 128;
require(itemGroups[groupId].initialized,
"Super1155: you cannot mint a non-existent item group");
// If we can replenish burnt items, then only our currently-circulating
// supply matters. Otherwise, historic mints are what determine the cap.
uint256 currentGroupSupply = itemGroups[groupId].mintCount;
uint256 currentItemSupply = mintCount[_id];
if (itemGroups[groupId].burnType == BurnType.Replenishable) {
currentGroupSupply = itemGroups[groupId].circulatingSupply;
currentItemSupply = circulatingSupply[_id];
}
// If we are subject to a cap on group size, ensure we don't exceed it.
if (itemGroups[groupId].supplyType != SupplyType.Uncapped) {
require(currentGroupSupply.add(_amount) <= itemGroups[groupId].supplyData,
"Super1155: you cannot mint a group beyond its cap");
}
// Do not violate nonfungibility rules.
if (itemGroups[groupId].itemType == ItemType.Nonfungible) {
require(currentItemSupply.add(_amount) <= 1,
"Super1155: you cannot mint more than a single nonfungible item");
// Do not violate semifungibility rules.
} else if (itemGroups[groupId].itemType == ItemType.Semifungible) {
require(currentItemSupply.add(_amount) <= itemGroups[groupId].itemData,
"Super1155: you cannot mint more than the alloted semifungible items");
}
// Fungible items are coerced into the single group ID + index one slot.
uint256 mintedItemId = _id;
if (itemGroups[groupId].itemType == ItemType.Fungible) {
mintedItemId = shiftedGroupId.add(1);
}
return mintedItemId;
}
/**
Mint a single token into existence and send it to the `_recipient` address.
In order to mint an item, its item group must first have been created using
the `configureGroup` function. Minting an item must obey both the
fungibility and size cap of its group.
@param _recipient The address to receive all NFTs within the newly-minted
group.
@param _id The item ID to mint.
@param _amount The amount of the corresponding item ID to mint.
@param _data Any associated data to use on items minted in this transaction.
*/
/*
This single-mint function is retained here for posterity but unfortunately
had to be disabled in order to let this contract slip in under the limit
imposed by Spurious Dragon.
function mint(address _recipient, uint256 _id, uint256 _amount,
bytes calldata _data) external virtual hasItemRight(_id, MINT) {
require(_recipient != address(0),
"ERC1155: mint to the zero address");
// Retrieve the group ID from the given item `_id` and check mint validity.
uint256 shiftedGroupId = (_id & GROUP_MASK);
uint256 groupId = shiftedGroupId >> 128;
uint256 mintedItemId = _mintChecker(_id, _amount);
// Validate and perform the mint.
address operator = _msgSender();
_beforeTokenTransfer(operator, address(0), _recipient,
_asSingletonArray(mintedItemId), _asSingletonArray(_amount), _data);
// Update storage of special balances and circulating values.
balances[mintedItemId][_recipient] = balances[mintedItemId][_recipient]
.add(_amount);
groupBalances[groupId][_recipient] = groupBalances[groupId][_recipient]
.add(_amount);
totalBalances[_recipient] = totalBalances[_recipient].add(_amount);
mintCount[mintedItemId] = mintCount[mintedItemId].add(_amount);
circulatingSupply[mintedItemId] = circulatingSupply[mintedItemId]
.add(_amount);
itemGroups[groupId].mintCount = itemGroups[groupId].mintCount.add(_amount);
itemGroups[groupId].circulatingSupply =
itemGroups[groupId].circulatingSupply.add(_amount);
// Emit event and handle the safety check.
emit TransferSingle(operator, address(0), _recipient, mintedItemId,
_amount);
_doSafeTransferAcceptanceCheck(operator, address(0), _recipient,
mintedItemId, _amount, _data);
}
*/
/**
Mint a batch of tokens into existence and send them to the `_recipient`
address. In order to mint an item, its item group must first have been
created. Minting an item must obey both the fungibility and size cap of its
group.
@param _recipient The address to receive all NFTs within the newly-minted
group.
@param _ids The item IDs for the new items to create.
@param _amounts The amount of each corresponding item ID to create.
@param _data Any associated data to use on items minted in this transaction.
*/
function mintBatch(address _recipient, uint256[] calldata _ids,
uint256[] calldata _amounts, bytes calldata _data)
external virtual {
require(_recipient != address(0),
"ERC1155: mint to the zero address");
require(_ids.length == _amounts.length,
"ERC1155: ids and amounts length mismatch");
// Validate and perform the mint.
address operator = _msgSender();
_beforeTokenTransfer(operator, address(0), _recipient, _ids, _amounts,
_data);
// Loop through each of the batched IDs to update storage of special
// balances and circulation balances.
for (uint256 i = 0; i < _ids.length; i++) {
require(_hasItemRight(_ids[i], MINT),
"Super1155: you do not have the right to mint that item");
// Retrieve the group ID from the given item `_id` and check mint.
uint256 shiftedGroupId = (_ids[i] & GROUP_MASK);
uint256 groupId = shiftedGroupId >> 128;
uint256 mintedItemId = _mintChecker(_ids[i], _amounts[i]);
// Update storage of special balances and circulating values.
balances[mintedItemId][_recipient] = balances[mintedItemId][_recipient]
.add(_amounts[i]);
groupBalances[groupId][_recipient] = groupBalances[groupId][_recipient]
.add(_amounts[i]);
totalBalances[_recipient] = totalBalances[_recipient].add(_amounts[i]);
mintCount[mintedItemId] = mintCount[mintedItemId].add(_amounts[i]);
circulatingSupply[mintedItemId] = circulatingSupply[mintedItemId]
.add(_amounts[i]);
itemGroups[groupId].mintCount = itemGroups[groupId].mintCount
.add(_amounts[i]);
itemGroups[groupId].circulatingSupply =
itemGroups[groupId].circulatingSupply.add(_amounts[i]);
}
// Emit event and handle the safety check.
emit TransferBatch(operator, address(0), _recipient, _ids, _amounts);
_doSafeBatchTransferAcceptanceCheck(operator, address(0), _recipient, _ids,
_amounts, _data);
}
/**
This is a private helper function to verify, according to all of our various
minting and burning rules, whether it would be valid to burn some `_amount`
of a particular item `_id`.
@param _id The ID of the item to check for burning validity.
@param _amount The amount of the item to try checking burning for.
@return The ID of the item that should have `_amount` burnt for it.
*/
function _burnChecker(uint256 _id, uint256 _amount) private view
returns (uint256) {
// Retrieve the item's group ID.
uint256 shiftedGroupId = (_id & GROUP_MASK);
uint256 groupId = shiftedGroupId >> 128;
require(itemGroups[groupId].initialized,
"Super1155: you cannot burn a non-existent item group");
// If we can burn items, then we must verify that we do not exceed the cap.
if (itemGroups[groupId].burnType == BurnType.Burnable) {
require(itemGroups[groupId].burnCount.add(_amount)
<= itemGroups[groupId].burnData,
"Super1155: you may not exceed the burn limit on this item group");
}
// Fungible items are coerced into the single group ID + index one slot.
uint256 burntItemId = _id;
if (itemGroups[groupId].itemType == ItemType.Fungible) {
burntItemId = shiftedGroupId.add(1);
}
return burntItemId;
}
/**
This function allows an address to destroy some of its items.
@param _burner The address whose item is burning.
@param _id The item ID to burn.
@param _amount The amount of the corresponding item ID to burn.
*/
function burn(address _burner, uint256 _id, uint256 _amount)
external virtual hasItemRight(_id, BURN) {
require(_burner != address(0),
"ERC1155: burn from the zero address");
// Retrieve the group ID from the given item `_id` and check burn validity.
uint256 shiftedGroupId = (_id & GROUP_MASK);
uint256 groupId = shiftedGroupId >> 128;
uint256 burntItemId = _burnChecker(_id, _amount);
// Validate and perform the burn.
address operator = _msgSender();
_beforeTokenTransfer(operator, _burner, address(0),
_asSingletonArray(burntItemId), _asSingletonArray(_amount), "");
// Update storage of special balances and circulating values.
balances[burntItemId][_burner] = balances[burntItemId][_burner]
.sub(_amount,
"ERC1155: burn amount exceeds balance");
groupBalances[groupId][_burner] = groupBalances[groupId][_burner]
.sub(_amount);
totalBalances[_burner] = totalBalances[_burner].sub(_amount);
burnCount[burntItemId] = burnCount[burntItemId].add(_amount);
circulatingSupply[burntItemId] = circulatingSupply[burntItemId]
.sub(_amount);
itemGroups[groupId].burnCount = itemGroups[groupId].burnCount.add(_amount);
itemGroups[groupId].circulatingSupply =
itemGroups[groupId].circulatingSupply.sub(_amount);
// Emit the burn event.
emit TransferSingle(operator, _burner, address(0), _id, _amount);
}
/**
This function allows an address to destroy multiple different items in a
single call.
@param _burner The address whose items are burning.
@param _ids The item IDs to burn.
@param _amounts The amounts of the corresponding item IDs to burn.
*/
function burnBatch(address _burner, uint256[] memory _ids,
uint256[] memory _amounts) external virtual {
require(_burner != address(0),
"ERC1155: burn from the zero address");
require(_ids.length == _amounts.length,
"ERC1155: ids and amounts length mismatch");
// Validate and perform the burn.
address operator = _msgSender();
_beforeTokenTransfer(operator, _burner, address(0), _ids, _amounts, "");
// Loop through each of the batched IDs to update storage of special
// balances and circulation balances.
for (uint i = 0; i < _ids.length; i++) {
require(_hasItemRight(_ids[i], BURN),
"Super1155: you do not have the right to burn that item");
// Retrieve the group ID from the given item `_id` and check burn.
uint256 shiftedGroupId = (_ids[i] & GROUP_MASK);
uint256 groupId = shiftedGroupId >> 128;
uint256 burntItemId = _burnChecker(_ids[i], _amounts[i]);
// Update storage of special balances and circulating values.
balances[burntItemId][_burner] = balances[burntItemId][_burner]
.sub(_amounts[i],
"ERC1155: burn amount exceeds balance");
groupBalances[groupId][_burner] = groupBalances[groupId][_burner]
.sub(_amounts[i]);
totalBalances[_burner] = totalBalances[_burner].sub(_amounts[i]);
burnCount[burntItemId] = burnCount[burntItemId].add(_amounts[i]);
circulatingSupply[burntItemId] = circulatingSupply[burntItemId]
.sub(_amounts[i]);
itemGroups[groupId].burnCount = itemGroups[groupId].burnCount
.add(_amounts[i]);
itemGroups[groupId].circulatingSupply =
itemGroups[groupId].circulatingSupply.sub(_amounts[i]);
}
// Emit the burn event.
emit TransferBatch(operator, _burner, address(0), _ids, _amounts);
}
/**
Set the on-chain metadata attached to a specific token ID so long as the
collection as a whole or the token specifically has not had metadata
editing frozen.
@param _id The ID of the token to set the `_metadata` for.
@param _metadata The metadata string to store on-chain.
*/
function setMetadata(uint256 _id, string memory _metadata)
external hasItemRight(_id, SET_METADATA) {
require(!uriLocked && !metadataFrozen[_id],
"Super1155: you cannot edit this metadata because it is frozen");
string memory oldMetadata = metadata[_id];
metadata[_id] = _metadata;
emit MetadataChanged(_msgSender(), _id, oldMetadata, _metadata);
}
/**
Allow the item collection owner or an associated manager to forever lock the
metadata URI on the entire collection to future changes.
@param _uri The value of the URI to lock for `_id`.
*/
function lockURI(string calldata _uri) external
hasValidPermit(UNIVERSAL, LOCK_URI) {
string memory oldURI = metadataUri;
metadataUri = _uri;
emit ChangeURI(oldURI, _uri);
uriLocked = true;
emit PermanentURI(_uri, 2 ** 256 - 1);
}
/**
Allow the item collection owner or an associated manager to forever lock the
metadata URI on an item to future changes.
@param _uri The value of the URI to lock for `_id`.
@param _id The token ID to lock a metadata URI value into.
*/
function lockURI(string calldata _uri, uint256 _id) external
hasItemRight(_id, LOCK_ITEM_URI) {
metadataFrozen[_id] = true;
emit PermanentURI(_uri, _id);
}
/**
Allow the item collection owner or an associated manager to forever lock
this contract to further item minting.
*/
function lock() external virtual hasValidPermit(UNIVERSAL, LOCK_CREATION) {
locked = true;
emit CollectionLocked(_msgSender());
}
}
// SPDX-License-Identifier: GPL-3.0
pragma solidity 0.7.6;
pragma experimental ABIEncoderV2;
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import "@openzeppelin/contracts/token/ERC20/SafeERC20.sol";
import "../access/PermitControl.sol";
/**
@title A base contract which supports an administrative sweep function wherein
authorized callers may transfer ERC-20 tokens out of this contract.
@author Tim Clancy
This is a base contract designed with the intent to support rescuing ERC-20
tokens which users might have wrongly sent to a contract.
*/
contract Sweepable is PermitControl {
using SafeERC20 for IERC20;
/// The public identifier for the right to sweep tokens.
bytes32 public constant SWEEP = keccak256("SWEEP");
/// The public identifier for the right to lock token sweeps.
bytes32 public constant LOCK_SWEEP = keccak256("LOCK_SWEEP");
/// A flag determining whether or not the `sweep` function may be used.
bool public sweepLocked;
/**
An event to track a token sweep event.
@param sweeper The calling address which triggered the sweeep.
@param token The specific ERC-20 token being swept.
@param amount The amount of the ERC-20 token being swept.
@param recipient The recipient of the swept tokens.
*/
event TokenSweep(address indexed sweeper, IERC20 indexed token,
uint256 amount, address indexed recipient);
/**
An event to track future use of the `sweep` function being locked.
@param locker The calling address which locked down sweeping.
*/
event SweepLocked(address indexed locker);
/**
Return a version number for this contract's interface.
*/
function version() external virtual override pure returns (uint256) {
return 1;
}
/**
Allow the owner or an approved manager to sweep all of a particular ERC-20
token from the contract and send it to another address. This function exists
to allow the shop owner to recover tokens that are otherwise sent directly
to this contract and get stuck. Provided that sweeping is not locked, this
is a useful tool to help buyers recover otherwise-lost funds.
@param _token The token to sweep the balance from.
@param _amount The amount of token to sweep.
@param _address The address to send the swept tokens to.
*/
function sweep(IERC20 _token, uint256 _amount, address _address) external
hasValidPermit(UNIVERSAL, SWEEP) {
require(!sweepLocked,
"MintShop1155: the sweep function is locked");
_token.safeTransferFrom(address(this), _address, _amount);
emit TokenSweep(_msgSender(), _token, _amount, _address);
}
/**
Allow the shop owner or an approved manager to lock the contract against any
future token sweeps.
*/
function lockSweep() external hasValidPermit(UNIVERSAL, LOCK_SWEEP) {
sweepLocked = true;
emit SweepLocked(_msgSender());
}
}
{
"compilationTarget": {
"contracts/MintShop1155.sol": "MintShop1155"
},
"evmVersion": "istanbul",
"libraries": {},
"metadata": {
"bytecodeHash": "ipfs"
},
"optimizer": {
"enabled": true,
"runs": 0
},
"remappings": []
}
[{"inputs":[{"internalType":"address","name":"_owner","type":"address"},{"internalType":"contract Super1155","name":"_item","type":"address"},{"internalType":"address","name":"_paymentReceiver","type":"address"},{"internalType":"uint256","name":"_globalPurchaseLimit","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"locker","type":"address"}],"name":"GlobalPurchaseLimitLocked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"updater","type":"address"},{"indexed":true,"internalType":"uint256","name":"oldPurchaseLimit","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"newPurchaseLimit","type":"uint256"}],"name":"GlobalPurchaseLimitUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"buyer","type":"address"},{"indexed":false,"internalType":"uint256","name":"poolId","type":"uint256"},{"indexed":true,"internalType":"uint256[]","name":"itemIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"ItemPurchased","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"manager","type":"address"},{"indexed":true,"internalType":"bytes32","name":"managedRight","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"managerRight","type":"bytes32"}],"name":"ManagementUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"locker","type":"address"}],"name":"PaymentReceiverLocked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"updater","type":"address"},{"indexed":true,"internalType":"address","name":"oldPaymentReceiver","type":"address"},{"indexed":true,"internalType":"address","name":"newPaymentReceiver","type":"address"}],"name":"PaymentReceiverUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"updator","type":"address"},{"indexed":true,"internalType":"address","name":"updatee","type":"address"},{"indexed":false,"internalType":"bytes32","name":"circumstance","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":false,"internalType":"uint256","name":"expirationTime","type":"uint256"}],"name":"PermitUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"updater","type":"address"},{"indexed":false,"internalType":"uint256","name":"poolId","type":"uint256"},{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"purchaseLimit","type":"uint256"},{"internalType":"uint256","name":"singlePurchaseLimit","type":"uint256"},{"components":[{"internalType":"enum MintShop1155.AccessType","name":"requiredType","type":"uint8"},{"internalType":"address","name":"requiredAsset","type":"address"},{"internalType":"uint256","name":"requiredAmount","type":"uint256"},{"internalType":"uint256","name":"whitelistId","type":"uint256"}],"internalType":"struct MintShop1155.PoolRequirement","name":"requirement","type":"tuple"}],"indexed":true,"internalType":"struct MintShop1155.PoolInput","name":"pool","type":"tuple"},{"indexed":false,"internalType":"uint256[]","name":"groupIds","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"caps","type":"uint256[]"},{"components":[{"internalType":"enum MintShop1155.AssetType","name":"assetType","type":"uint8"},{"internalType":"address","name":"asset","type":"address"},{"internalType":"uint256","name":"price","type":"uint256"}],"indexed":true,"internalType":"struct MintShop1155.Price[][]","name":"prices","type":"tuple[][]"}],"name":"PoolUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"locker","type":"address"}],"name":"SweepLocked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"sweeper","type":"address"},{"indexed":true,"internalType":"contract IERC20","name":"token","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":true,"internalType":"address","name":"recipient","type":"address"}],"name":"TokenSweep","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"updater","type":"address"},{"indexed":true,"internalType":"uint256","name":"whitelistId","type":"uint256"},{"indexed":true,"internalType":"bool","name":"isActive","type":"bool"}],"name":"WhitelistActiveUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"adder","type":"address"},{"indexed":true,"internalType":"uint256","name":"whitelistId","type":"uint256"},{"indexed":true,"internalType":"address[]","name":"addresses","type":"address[]"}],"name":"WhitelistAddition","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"remover","type":"address"},{"indexed":true,"internalType":"uint256","name":"whitelistId","type":"uint256"},{"indexed":true,"internalType":"address[]","name":"addresses","type":"address[]"}],"name":"WhitelistRemoval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"updater","type":"address"},{"indexed":true,"internalType":"uint256","name":"whitelistId","type":"uint256"},{"indexed":true,"internalType":"address[]","name":"addresses","type":"address[]"}],"name":"WhitelistUpdated","type":"event"},{"inputs":[],"name":"LOCK_GLOBAL_LIMIT","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"LOCK_PAYMENT_RECEIVER","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"LOCK_SWEEP","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MANAGER","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"POOL","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SET_PAYMENT_RECEIVER","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SWEEP","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"UNIVERSAL","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"UPDATE_GLOBAL_LIMIT","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WHITELIST","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"ZERO_RIGHT","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"purchaseLimit","type":"uint256"},{"internalType":"uint256","name":"singlePurchaseLimit","type":"uint256"},{"components":[{"internalType":"enum MintShop1155.AccessType","name":"requiredType","type":"uint8"},{"internalType":"address","name":"requiredAsset","type":"address"},{"internalType":"uint256","name":"requiredAmount","type":"uint256"},{"internalType":"uint256","name":"whitelistId","type":"uint256"}],"internalType":"struct MintShop1155.PoolRequirement","name":"requirement","type":"tuple"}],"internalType":"struct MintShop1155.PoolInput","name":"_pool","type":"tuple"},{"internalType":"uint256[]","name":"_groupIds","type":"uint256[]"},{"internalType":"uint256[]","name":"_issueNumberOffsets","type":"uint256[]"},{"internalType":"uint256[]","name":"_caps","type":"uint256[]"},{"components":[{"internalType":"enum MintShop1155.AssetType","name":"assetType","type":"uint8"},{"internalType":"address","name":"asset","type":"address"},{"internalType":"uint256","name":"price","type":"uint256"}],"internalType":"struct MintShop1155.Price[][]","name":"_prices","type":"tuple[][]"}],"name":"addPool","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"address[]","name":"_addresses","type":"address[]"}],"name":"addToWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"expiryTime","type":"uint256"},{"internalType":"bool","name":"isActive","type":"bool"},{"internalType":"address[]","name":"addresses","type":"address[]"}],"internalType":"struct MintShop1155.WhitelistInput","name":"_whitelist","type":"tuple"}],"name":"addWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"_ids","type":"uint256[]"}],"name":"getPools","outputs":[{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"purchaseLimit","type":"uint256"},{"internalType":"uint256","name":"singlePurchaseLimit","type":"uint256"},{"components":[{"internalType":"enum MintShop1155.AccessType","name":"requiredType","type":"uint8"},{"internalType":"address","name":"requiredAsset","type":"address"},{"internalType":"uint256","name":"requiredAmount","type":"uint256"},{"internalType":"uint256","name":"whitelistId","type":"uint256"}],"internalType":"struct MintShop1155.PoolRequirement","name":"requirement","type":"tuple"},{"internalType":"string","name":"itemMetadataUri","type":"string"},{"components":[{"internalType":"uint256","name":"groupId","type":"uint256"},{"internalType":"uint256","name":"cap","type":"uint256"},{"internalType":"uint256","name":"minted","type":"uint256"},{"components":[{"internalType":"enum MintShop1155.AssetType","name":"assetType","type":"uint8"},{"internalType":"address","name":"asset","type":"address"},{"internalType":"uint256","name":"price","type":"uint256"}],"internalType":"struct MintShop1155.Price[]","name":"prices","type":"tuple[]"}],"internalType":"struct MintShop1155.PoolItem[]","name":"items","type":"tuple[]"}],"internalType":"struct MintShop1155.PoolOutput[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"_ids","type":"uint256[]"},{"internalType":"address","name":"_address","type":"address"}],"name":"getPoolsWithAddress","outputs":[{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"purchaseLimit","type":"uint256"},{"internalType":"uint256","name":"singlePurchaseLimit","type":"uint256"},{"components":[{"internalType":"enum MintShop1155.AccessType","name":"requiredType","type":"uint8"},{"internalType":"address","name":"requiredAsset","type":"address"},{"internalType":"uint256","name":"requiredAmount","type":"uint256"},{"internalType":"uint256","name":"whitelistId","type":"uint256"}],"internalType":"struct MintShop1155.PoolRequirement","name":"requirement","type":"tuple"},{"internalType":"string","name":"itemMetadataUri","type":"string"},{"components":[{"internalType":"uint256","name":"groupId","type":"uint256"},{"internalType":"uint256","name":"cap","type":"uint256"},{"internalType":"uint256","name":"minted","type":"uint256"},{"components":[{"internalType":"enum MintShop1155.AssetType","name":"assetType","type":"uint8"},{"internalType":"address","name":"asset","type":"address"},{"internalType":"uint256","name":"price","type":"uint256"}],"internalType":"struct MintShop1155.Price[]","name":"prices","type":"tuple[]"}],"internalType":"struct MintShop1155.PoolItem[]","name":"items","type":"tuple[]"},{"internalType":"uint256","name":"purchaseCount","type":"uint256"},{"internalType":"bool","name":"whitelistStatus","type":"bool"}],"internalType":"struct MintShop1155.PoolAddressOutput[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"_ids","type":"uint256[]"},{"internalType":"address[]","name":"_purchasers","type":"address[]"}],"name":"getPurchaseCounts","outputs":[{"internalType":"uint256[][]","name":"","type":"uint256[][]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"_ids","type":"uint256[]"},{"internalType":"address[]","name":"_addresses","type":"address[]"}],"name":"getWhitelistStatus","outputs":[{"internalType":"bool[][]","name":"","type":"bool[][]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"globalPurchaseCounts","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"globalPurchaseLimit","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"globalPurchaseLimitLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_address","type":"address"},{"internalType":"bytes32","name":"_circumstance","type":"bytes32"},{"internalType":"bytes32","name":"_right","type":"bytes32"}],"name":"hasRightUntil","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"item","outputs":[{"internalType":"contract Super1155","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lockGlobalPurchaseLimit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"lockPaymentReceiver","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"lockSweep","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"managerRight","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"uint256","name":"_groupId","type":"uint256"},{"internalType":"uint256","name":"_assetIndex","type":"uint256"},{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"mintFromPool","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"nextItemIssues","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nextPoolId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nextWhitelistId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"paymentReceiver","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"paymentReceiverLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"bytes32","name":"","type":"bytes32"},{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"permissions","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"pools","outputs":[{"internalType":"string","name":"name","type":"string"},{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"purchaseLimit","type":"uint256"},{"internalType":"uint256","name":"singlePurchaseLimit","type":"uint256"},{"components":[{"internalType":"enum MintShop1155.AccessType","name":"requiredType","type":"uint8"},{"internalType":"address","name":"requiredAsset","type":"address"},{"internalType":"uint256","name":"requiredAmount","type":"uint256"},{"internalType":"uint256","name":"whitelistId","type":"uint256"}],"internalType":"struct MintShop1155.PoolRequirement","name":"requirement","type":"tuple"},{"internalType":"uint256","name":"currentPoolVersion","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"address[]","name":"_addresses","type":"address[]"}],"name":"removeFromWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"_managedRight","type":"bytes32"},{"internalType":"bytes32","name":"_managerRight","type":"bytes32"}],"name":"setManagerRight","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_address","type":"address"},{"internalType":"bytes32","name":"_circumstance","type":"bytes32"},{"internalType":"bytes32","name":"_right","type":"bytes32"},{"internalType":"uint256","name":"_expirationTime","type":"uint256"}],"name":"setPermit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"bool","name":"_isActive","type":"bool"}],"name":"setWhitelistActive","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract IERC20","name":"_token","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"address","name":"_address","type":"address"}],"name":"sweep","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"sweepLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_newGlobalPurchaseLimit","type":"uint256"}],"name":"updateGlobalPurchaseLimit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_newPaymentReceiver","type":"address"}],"name":"updatePaymentReceiver","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"uint256","name":"startTime","type":"uint256"},{"internalType":"uint256","name":"endTime","type":"uint256"},{"internalType":"uint256","name":"purchaseLimit","type":"uint256"},{"internalType":"uint256","name":"singlePurchaseLimit","type":"uint256"},{"components":[{"internalType":"enum MintShop1155.AccessType","name":"requiredType","type":"uint8"},{"internalType":"address","name":"requiredAsset","type":"address"},{"internalType":"uint256","name":"requiredAmount","type":"uint256"},{"internalType":"uint256","name":"whitelistId","type":"uint256"}],"internalType":"struct MintShop1155.PoolRequirement","name":"requirement","type":"tuple"}],"internalType":"struct MintShop1155.PoolInput","name":"_pool","type":"tuple"},{"internalType":"uint256[]","name":"_groupIds","type":"uint256[]"},{"internalType":"uint256[]","name":"_issueNumberOffsets","type":"uint256[]"},{"internalType":"uint256[]","name":"_caps","type":"uint256[]"},{"components":[{"internalType":"enum MintShop1155.AssetType","name":"assetType","type":"uint8"},{"internalType":"address","name":"asset","type":"address"},{"internalType":"uint256","name":"price","type":"uint256"}],"internalType":"struct MintShop1155.Price[][]","name":"_prices","type":"tuple[][]"}],"name":"updatePool","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"components":[{"internalType":"uint256","name":"expiryTime","type":"uint256"},{"internalType":"bool","name":"isActive","type":"bool"},{"internalType":"address[]","name":"addresses","type":"address[]"}],"internalType":"struct MintShop1155.WhitelistInput","name":"_whitelist","type":"tuple"}],"name":"updateWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"version","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"whitelists","outputs":[{"internalType":"uint256","name":"expiryTime","type":"uint256"},{"internalType":"bool","name":"isActive","type":"bool"},{"internalType":"uint256","name":"currentWhitelistVersion","type":"uint256"}],"stateMutability":"view","type":"function"}]