// SPDX-License-Identifier: MIT// OpenZeppelin Contracts (last updated v4.5.0) (utils/Address.sol)pragmasolidity ^0.8.1;/**
* @dev Collection of functions related to the address type
*/libraryAddress{
/**
* @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
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/functionisContract(address account) internalviewreturns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0// for contracts in construction, since the code is only stored at the end// of the constructor execution.return account.code.length>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].
*/functionsendValue(addresspayable recipient, uint256 amount) internal{
require(address(this).balance>= amount, "Address: insufficient balance");
(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._
*/functionfunctionCall(address target, bytesmemory data) internalreturns (bytesmemory) {
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._
*/functionfunctionCall(address target,
bytesmemory data,
stringmemory errorMessage
) internalreturns (bytesmemory) {
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._
*/functionfunctionCallWithValue(address target,
bytesmemory data,
uint256 value
) internalreturns (bytesmemory) {
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._
*/functionfunctionCallWithValue(address target,
bytesmemory data,
uint256 value,
stringmemory errorMessage
) internalreturns (bytesmemory) {
require(address(this).balance>= value, "Address: insufficient balance for call");
require(isContract(target), "Address: call to non-contract");
(bool success, bytesmemory 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._
*/functionfunctionStaticCall(address target, bytesmemory data) internalviewreturns (bytesmemory) {
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._
*/functionfunctionStaticCall(address target,
bytesmemory data,
stringmemory errorMessage
) internalviewreturns (bytesmemory) {
require(isContract(target), "Address: static call to non-contract");
(bool success, bytesmemory 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._
*/functionfunctionDelegateCall(address target, bytesmemory data) internalreturns (bytesmemory) {
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._
*/functionfunctionDelegateCall(address target,
bytesmemory data,
stringmemory errorMessage
) internalreturns (bytesmemory) {
require(isContract(target), "Address: delegate call to non-contract");
(bool success, bytesmemory returndata) = target.delegatecall(data);
return verifyCallResult(success, returndata, errorMessage);
}
/**
* @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason using the provided one.
*
* _Available since v4.3._
*/functionverifyCallResult(bool success,
bytesmemory returndata,
stringmemory errorMessage
) internalpurereturns (bytesmemory) {
if (success) {
return returndata;
} else {
// Look for revert reason and bubble it up if presentif (returndata.length>0) {
// The easiest way to bubble the revert reason is using memory via assemblyassembly {
let returndata_size :=mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}
}
Contract Source Code
File 2 of 16: Context.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)pragmasolidity ^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 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.
*/abstractcontractContext{
function_msgSender() internalviewvirtualreturns (address) {
returnmsg.sender;
}
function_msgData() internalviewvirtualreturns (bytescalldata) {
returnmsg.data;
}
}
Contract Source Code
File 3 of 16: ERC165.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)pragmasolidity ^0.8.0;import"./IERC165.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
* for the additional interface id that will be supported. For example:
*
* ```solidity
* function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
* return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
* }
* ```
*
* Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
*/abstractcontractERC165isIERC165{
/**
* @dev See {IERC165-supportsInterface}.
*/functionsupportsInterface(bytes4 interfaceId) publicviewvirtualoverridereturns (bool) {
return interfaceId ==type(IERC165).interfaceId;
}
}
Contract Source Code
File 4 of 16: ERC721.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts (last updated v4.5.0) (token/ERC721/ERC721.sol)pragmasolidity ^0.8.0;import"./IERC721.sol";
import"./IERC721Receiver.sol";
import"./extensions/IERC721Metadata.sol";
import"../../utils/Address.sol";
import"../../utils/Context.sol";
import"../../utils/Strings.sol";
import"../../utils/introspection/ERC165.sol";
/**
* @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
* the Metadata extension, but not including the Enumerable extension, which is available separately as
* {ERC721Enumerable}.
*/contractERC721isContext, ERC165, IERC721, IERC721Metadata{
usingAddressforaddress;
usingStringsforuint256;
// Token namestringprivate _name;
// Token symbolstringprivate _symbol;
// Mapping from token ID to owner addressmapping(uint256=>address) private _owners;
// Mapping owner address to token countmapping(address=>uint256) private _balances;
// Mapping from token ID to approved addressmapping(uint256=>address) private _tokenApprovals;
// Mapping from owner to operator approvalsmapping(address=>mapping(address=>bool)) private _operatorApprovals;
/**
* @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
*/constructor(stringmemory name_, stringmemory symbol_) {
_name = name_;
_symbol = symbol_;
}
/**
* @dev See {IERC165-supportsInterface}.
*/functionsupportsInterface(bytes4 interfaceId) publicviewvirtualoverride(ERC165, IERC165) returns (bool) {
return
interfaceId ==type(IERC721).interfaceId||
interfaceId ==type(IERC721Metadata).interfaceId||super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC721-balanceOf}.
*/functionbalanceOf(address owner) publicviewvirtualoverridereturns (uint256) {
require(owner !=address(0), "ERC721: balance query for the zero address");
return _balances[owner];
}
/**
* @dev See {IERC721-ownerOf}.
*/functionownerOf(uint256 tokenId) publicviewvirtualoverridereturns (address) {
address owner = _owners[tokenId];
require(owner !=address(0), "ERC721: owner query for nonexistent token");
return owner;
}
/**
* @dev See {IERC721Metadata-name}.
*/functionname() publicviewvirtualoverridereturns (stringmemory) {
return _name;
}
/**
* @dev See {IERC721Metadata-symbol}.
*/functionsymbol() publicviewvirtualoverridereturns (stringmemory) {
return _symbol;
}
/**
* @dev See {IERC721Metadata-tokenURI}.
*/functiontokenURI(uint256 tokenId) publicviewvirtualoverridereturns (stringmemory) {
require(_exists(tokenId), "ERC721Metadata: URI query for nonexistent token");
stringmemory baseURI = _baseURI();
returnbytes(baseURI).length>0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
}
/**
* @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
* token will be the concatenation of the `baseURI` and the `tokenId`. Empty
* by default, can be overriden in child contracts.
*/function_baseURI() internalviewvirtualreturns (stringmemory) {
return"";
}
/**
* @dev See {IERC721-approve}.
*/functionapprove(address to, uint256 tokenId) publicvirtualoverride{
address owner = ERC721.ownerOf(tokenId);
require(to != owner, "ERC721: approval to current owner");
require(
_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
"ERC721: approve caller is not owner nor approved for all"
);
_approve(to, tokenId);
}
/**
* @dev See {IERC721-getApproved}.
*/functiongetApproved(uint256 tokenId) publicviewvirtualoverridereturns (address) {
require(_exists(tokenId), "ERC721: approved query for nonexistent token");
return _tokenApprovals[tokenId];
}
/**
* @dev See {IERC721-setApprovalForAll}.
*/functionsetApprovalForAll(address operator, bool approved) publicvirtualoverride{
_setApprovalForAll(_msgSender(), operator, approved);
}
/**
* @dev See {IERC721-isApprovedForAll}.
*/functionisApprovedForAll(address owner, address operator) publicviewvirtualoverridereturns (bool) {
return _operatorApprovals[owner][operator];
}
/**
* @dev See {IERC721-transferFrom}.
*/functiontransferFrom(addressfrom,
address to,
uint256 tokenId
) publicvirtualoverride{
//solhint-disable-next-line max-line-lengthrequire(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
_transfer(from, to, tokenId);
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/functionsafeTransferFrom(addressfrom,
address to,
uint256 tokenId
) publicvirtualoverride{
safeTransferFrom(from, to, tokenId, "");
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/functionsafeTransferFrom(addressfrom,
address to,
uint256 tokenId,
bytesmemory _data
) publicvirtualoverride{
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: transfer caller is not owner nor approved");
_safeTransfer(from, to, tokenId, _data);
}
/**
* @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
* are aware of the ERC721 protocol to prevent tokens from being forever locked.
*
* `_data` is additional data, it has no specified format and it is sent in call to `to`.
*
* This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
* implement alternative mechanisms to perform token transfer, such as signature-based.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/function_safeTransfer(addressfrom,
address to,
uint256 tokenId,
bytesmemory _data
) internalvirtual{
_transfer(from, to, tokenId);
require(_checkOnERC721Received(from, to, tokenId, _data), "ERC721: transfer to non ERC721Receiver implementer");
}
/**
* @dev Returns whether `tokenId` exists.
*
* Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
*
* Tokens start existing when they are minted (`_mint`),
* and stop existing when they are burned (`_burn`).
*/function_exists(uint256 tokenId) internalviewvirtualreturns (bool) {
return _owners[tokenId] !=address(0);
}
/**
* @dev Returns whether `spender` is allowed to manage `tokenId`.
*
* Requirements:
*
* - `tokenId` must exist.
*/function_isApprovedOrOwner(address spender, uint256 tokenId) internalviewvirtualreturns (bool) {
require(_exists(tokenId), "ERC721: operator query for nonexistent token");
address owner = ERC721.ownerOf(tokenId);
return (spender == owner || getApproved(tokenId) == spender || isApprovedForAll(owner, spender));
}
/**
* @dev Safely mints `tokenId` and transfers it to `to`.
*
* Requirements:
*
* - `tokenId` must not exist.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/function_safeMint(address to, uint256 tokenId) internalvirtual{
_safeMint(to, tokenId, "");
}
/**
* @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
* forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
*/function_safeMint(address to,
uint256 tokenId,
bytesmemory _data
) internalvirtual{
_mint(to, tokenId);
require(
_checkOnERC721Received(address(0), to, tokenId, _data),
"ERC721: transfer to non ERC721Receiver implementer"
);
}
/**
* @dev Mints `tokenId` and transfers it to `to`.
*
* WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
*
* Requirements:
*
* - `tokenId` must not exist.
* - `to` cannot be the zero address.
*
* Emits a {Transfer} event.
*/function_mint(address to, uint256 tokenId) internalvirtual{
require(to !=address(0), "ERC721: mint to the zero address");
require(!_exists(tokenId), "ERC721: token already minted");
_beforeTokenTransfer(address(0), to, tokenId);
_balances[to] +=1;
_owners[tokenId] = to;
emit Transfer(address(0), to, tokenId);
_afterTokenTransfer(address(0), to, tokenId);
}
/**
* @dev Destroys `tokenId`.
* The approval is cleared when the token is burned.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits a {Transfer} event.
*/function_burn(uint256 tokenId) internalvirtual{
address owner = ERC721.ownerOf(tokenId);
_beforeTokenTransfer(owner, address(0), tokenId);
// Clear approvals
_approve(address(0), tokenId);
_balances[owner] -=1;
delete _owners[tokenId];
emit Transfer(owner, address(0), tokenId);
_afterTokenTransfer(owner, address(0), tokenId);
}
/**
* @dev Transfers `tokenId` from `from` to `to`.
* As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
*
* Emits a {Transfer} event.
*/function_transfer(addressfrom,
address to,
uint256 tokenId
) internalvirtual{
require(ERC721.ownerOf(tokenId) ==from, "ERC721: transfer from incorrect owner");
require(to !=address(0), "ERC721: transfer to the zero address");
_beforeTokenTransfer(from, to, tokenId);
// Clear approvals from the previous owner
_approve(address(0), tokenId);
_balances[from] -=1;
_balances[to] +=1;
_owners[tokenId] = to;
emit Transfer(from, to, tokenId);
_afterTokenTransfer(from, to, tokenId);
}
/**
* @dev Approve `to` to operate on `tokenId`
*
* Emits a {Approval} event.
*/function_approve(address to, uint256 tokenId) internalvirtual{
_tokenApprovals[tokenId] = to;
emit Approval(ERC721.ownerOf(tokenId), to, tokenId);
}
/**
* @dev Approve `operator` to operate on all of `owner` tokens
*
* Emits a {ApprovalForAll} event.
*/function_setApprovalForAll(address owner,
address operator,
bool approved
) internalvirtual{
require(owner != operator, "ERC721: approve to caller");
_operatorApprovals[owner][operator] = approved;
emit ApprovalForAll(owner, operator, approved);
}
/**
* @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
* The call is not executed if the target address is not a contract.
*
* @param from address representing the previous owner of the given token ID
* @param to target address that will receive the tokens
* @param tokenId uint256 ID of the token to be transferred
* @param _data bytes optional data to send along with the call
* @return bool whether the call correctly returned the expected magic value
*/function_checkOnERC721Received(addressfrom,
address to,
uint256 tokenId,
bytesmemory _data
) privatereturns (bool) {
if (to.isContract()) {
try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, _data) returns (bytes4 retval) {
return retval == IERC721Receiver.onERC721Received.selector;
} catch (bytesmemory reason) {
if (reason.length==0) {
revert("ERC721: transfer to non ERC721Receiver implementer");
} else {
assembly {
revert(add(32, reason), mload(reason))
}
}
}
} else {
returntrue;
}
}
/**
* @dev Hook that is called before any token transfer. This includes minting
* and burning.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
* transferred to `to`.
* - When `from` is zero, `tokenId` will be minted for `to`.
* - When `to` is zero, ``from``'s `tokenId` will be burned.
* - `from` and `to` are never both zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/function_beforeTokenTransfer(addressfrom,
address to,
uint256 tokenId
) internalvirtual{}
/**
* @dev Hook that is called after any transfer of tokens. This includes
* minting and burning.
*
* Calling conditions:
*
* - when `from` and `to` are both non-zero.
* - `from` and `to` are never both zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/function_afterTokenTransfer(addressfrom,
address to,
uint256 tokenId
) internalvirtual{}
}
Contract Source Code
File 5 of 16: ERC721Burnable.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/ERC721Burnable.sol)pragmasolidity ^0.8.0;import"../ERC721.sol";
import"../../../utils/Context.sol";
/**
* @title ERC721 Burnable Token
* @dev ERC721 Token that can be irreversibly burned (destroyed).
*/abstractcontractERC721BurnableisContext, ERC721{
/**
* @dev Burns `tokenId`. See {ERC721-_burn}.
*
* Requirements:
*
* - The caller must own `tokenId` or be an approved operator.
*/functionburn(uint256 tokenId) publicvirtual{
//solhint-disable-next-line max-line-lengthrequire(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721Burnable: caller is not owner nor approved");
_burn(tokenId);
}
}
Contract Source Code
File 6 of 16: ERC721Enumerable.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/ERC721Enumerable.sol)pragmasolidity ^0.8.0;import"../ERC721.sol";
import"./IERC721Enumerable.sol";
/**
* @dev This implements an optional extension of {ERC721} defined in the EIP that adds
* enumerability of all the token ids in the contract as well as all token ids owned by each
* account.
*/abstractcontractERC721EnumerableisERC721, IERC721Enumerable{
// Mapping from owner to list of owned token IDsmapping(address=>mapping(uint256=>uint256)) private _ownedTokens;
// Mapping from token ID to index of the owner tokens listmapping(uint256=>uint256) private _ownedTokensIndex;
// Array with all token ids, used for enumerationuint256[] private _allTokens;
// Mapping from token id to position in the allTokens arraymapping(uint256=>uint256) private _allTokensIndex;
/**
* @dev See {IERC165-supportsInterface}.
*/functionsupportsInterface(bytes4 interfaceId) publicviewvirtualoverride(IERC165, ERC721) returns (bool) {
return interfaceId ==type(IERC721Enumerable).interfaceId||super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC721Enumerable-tokenOfOwnerByIndex}.
*/functiontokenOfOwnerByIndex(address owner, uint256 index) publicviewvirtualoverridereturns (uint256) {
require(index < ERC721.balanceOf(owner), "ERC721Enumerable: owner index out of bounds");
return _ownedTokens[owner][index];
}
/**
* @dev See {IERC721Enumerable-totalSupply}.
*/functiontotalSupply() publicviewvirtualoverridereturns (uint256) {
return _allTokens.length;
}
/**
* @dev See {IERC721Enumerable-tokenByIndex}.
*/functiontokenByIndex(uint256 index) publicviewvirtualoverridereturns (uint256) {
require(index < ERC721Enumerable.totalSupply(), "ERC721Enumerable: global index out of bounds");
return _allTokens[index];
}
/**
* @dev Hook that is called before any token transfer. This includes minting
* and burning.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be
* transferred to `to`.
* - When `from` is zero, `tokenId` will be minted for `to`.
* - When `to` is zero, ``from``'s `tokenId` will be burned.
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/function_beforeTokenTransfer(addressfrom,
address to,
uint256 tokenId
) internalvirtualoverride{
super._beforeTokenTransfer(from, to, tokenId);
if (from==address(0)) {
_addTokenToAllTokensEnumeration(tokenId);
} elseif (from!= to) {
_removeTokenFromOwnerEnumeration(from, tokenId);
}
if (to ==address(0)) {
_removeTokenFromAllTokensEnumeration(tokenId);
} elseif (to !=from) {
_addTokenToOwnerEnumeration(to, tokenId);
}
}
/**
* @dev Private function to add a token to this extension's ownership-tracking data structures.
* @param to address representing the new owner of the given token ID
* @param tokenId uint256 ID of the token to be added to the tokens list of the given address
*/function_addTokenToOwnerEnumeration(address to, uint256 tokenId) private{
uint256 length = ERC721.balanceOf(to);
_ownedTokens[to][length] = tokenId;
_ownedTokensIndex[tokenId] = length;
}
/**
* @dev Private function to add a token to this extension's token tracking data structures.
* @param tokenId uint256 ID of the token to be added to the tokens list
*/function_addTokenToAllTokensEnumeration(uint256 tokenId) private{
_allTokensIndex[tokenId] = _allTokens.length;
_allTokens.push(tokenId);
}
/**
* @dev Private function to remove a token from this extension's ownership-tracking data structures. Note that
* while the token is not assigned a new owner, the `_ownedTokensIndex` mapping is _not_ updated: this allows for
* gas optimizations e.g. when performing a transfer operation (avoiding double writes).
* This has O(1) time complexity, but alters the order of the _ownedTokens array.
* @param from address representing the previous owner of the given token ID
* @param tokenId uint256 ID of the token to be removed from the tokens list of the given address
*/function_removeTokenFromOwnerEnumeration(addressfrom, uint256 tokenId) private{
// To prevent a gap in from's tokens array, we store the last token in the index of the token to delete, and// then delete the last slot (swap and pop).uint256 lastTokenIndex = ERC721.balanceOf(from) -1;
uint256 tokenIndex = _ownedTokensIndex[tokenId];
// When the token to delete is the last token, the swap operation is unnecessaryif (tokenIndex != lastTokenIndex) {
uint256 lastTokenId = _ownedTokens[from][lastTokenIndex];
_ownedTokens[from][tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
_ownedTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index
}
// This also deletes the contents at the last position of the arraydelete _ownedTokensIndex[tokenId];
delete _ownedTokens[from][lastTokenIndex];
}
/**
* @dev Private function to remove a token from this extension's token tracking data structures.
* This has O(1) time complexity, but alters the order of the _allTokens array.
* @param tokenId uint256 ID of the token to be removed from the tokens list
*/function_removeTokenFromAllTokensEnumeration(uint256 tokenId) private{
// To prevent a gap in the tokens array, we store the last token in the index of the token to delete, and// then delete the last slot (swap and pop).uint256 lastTokenIndex = _allTokens.length-1;
uint256 tokenIndex = _allTokensIndex[tokenId];
// When the token to delete is the last token, the swap operation is unnecessary. However, since this occurs so// rarely (when the last minted token is burnt) that we still do the swap here to avoid the gas cost of adding// an 'if' statement (like in _removeTokenFromOwnerEnumeration)uint256 lastTokenId = _allTokens[lastTokenIndex];
_allTokens[tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
_allTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index// This also deletes the contents at the last position of the arraydelete _allTokensIndex[tokenId];
_allTokens.pop();
}
}
Contract Source Code
File 7 of 16: GhxstsComic.sol
// SPDX-License-Identifier: MITpragmasolidity ^0.8.9;import"@openzeppelin/contracts/access/Ownable.sol";
import"@openzeppelin/contracts/token/ERC721/extensions/ERC721Enumerable.sol";
import"@openzeppelin/contracts/token/ERC721/extensions/ERC721Burnable.sol";
import"@openzeppelin/contracts/token/ERC721/IERC721.sol";
import"@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";
import"@openzeppelin/contracts/utils/Strings.sol";
import"base64-sol/base64.sol";
//////////////////////////////////////////////////////////////////////////////////////////// //// //// @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ //// @@@@ @@@ @@@@ @@@ @@@@@ @ //// @@ // @@@ @@@@ @@ @@@@ @@@@ @@@ @@/ @@@* @ //// @ @@@@@@@@@@@ @@@@ @@ @@@ . @@@@@@@@@@ @@@@ @@@@@@ //// @ /@@@@@@@@@@@ @@@@ @@@/ / @@@ @@@@@@@@ @@@@@ @@@@ //// @@@@@ @ @@@@ @@@@@@@ @@@@@@ @@@@@@* @@ //// @@@@@@ @@ @@@@ @@@@ @@@@@@@@@@ .@@@@ @@@@@@@@@ @ //// @ @@@@@ @@ @@@@ @@@ @@@@@@@@@@& @@@@ @@@@@@@@@@ //// @ @@@@ @@ @@@@ @ @@@@@@@@@@@ @@@ @@@@@@@@@@@ //// @@( / @@ @@@@ @@@ @@@@% .@@@ @@@@ @@@@ #@@@ //// @@@@@ @@@ @@@@ @@@@@ (@@@% %@@@@ @@@@ @@ //// //// /////////////////////////////////////////////////////////////////////////////////////////////* Created with love for the Pxin Gxng, by Rxmmy */contractGhxstsComicisERC721Enumerable, Ownable, ERC721Burnable{
// Datapacking all chapter data.structChapter {
string name;
string image;
string description;
string metadataURI;
bytes32 merkleRoot; // Merkle root for each chapter.bool active;
bool frozen; // These chapters can no longer be minted or modified in any way.bool isSaleOpen; // Is the private sale open for a chapter.bool isPublicSaleOpen; // Is a public sale open for a chapter.uint256 price; // Max price: 10 ether or 10000000000000000000 weiuint256 discountPrice; // Max price: 10 ether or 10000000000000000000 weiuint256 supply; // Current supply for each chapter.uint256 maxSupply; // Max supply for each chapter.uint256 firstTokenId; // Starting tokenId for this chapter.
}
structChapterStrings {
string name;
string image;
string metadataURI;
string description;
bytes32 merkleRoot;
}
// Chapter data by ID.mapping(uint256=>uint256) public _chapterDetails;
mapping(uint256=> ChapterStrings) public _chapterStrings;
mapping(uint256=>string) public _customTokenURIs;
// Quantity of public mints claimed by wallet.// Address => Chapter => Quantitymapping(address=>mapping(uint256=>uint256)) public minted;
mapping(address=>mapping(uint256=>uint256)) public allowListMinted;
mapping(address=>mapping(uint256=>uint256)) public discountMinted;
mapping(address=>mapping(uint256=>uint256)) public auctionMinted;
// Max mint per wallet.uint256public MAX_MINT =4;
uint256public latestChapter;
stringpublic ghxstsWebsite ="https://ghxstscomics.com";
uint256public TOTAL_MINTED =0;
constructor() ERC721("Ghxsts Cxmics", "CXMIC") {}
modifiercallerIsUser() {
require(tx.origin==msg.sender, "The caller is another contract");
_;
}
modifierchapterExists(uint256 chapterId) {
require(_chapterDetails[chapterId] >0, "Chapter does not exist.");
_;
}
// Create datapacked values in the Chapter struct.functionsetChapter(Chapter memory chapter, uint256 chapterId) internal{
uint256 supply = chapter.supply;
uint256 maxSupply = chapter.maxSupply;
uint256 price = chapter.price;
uint256 discountPrice = chapter.discountPrice;
uint256 firstTokenId = chapter.firstTokenId;
require(supply <65535, "MaxSupply exceeds uint16.");
require(maxSupply <65535, "MaxSupply exceeds uint16.");
require(price <2**64, "Price exceeds uint64.");
require(discountPrice <2**64, "DiscountPrice exceeds uint64.");
require(firstTokenId <2**64, "FirstToken exceeds uint64.");
uint256 details = chapter.active ? uint256(1) : uint256(0);
details |= (chapter.frozen ? uint256(1) : uint256(0)) <<8;
details |= (chapter.isSaleOpen ? uint256(1) : uint256(0)) <<16;
details |= (chapter.isPublicSaleOpen ? uint256(1) : uint256(0)) <<24;
details |= supply <<32;
details |= maxSupply <<48;
details |= price <<64;
details |= discountPrice <<128;
details |= firstTokenId <<192;
// Save the chapter data
_chapterDetails[chapterId] = details;
}
// Retrieve datapacked values and build the Chapter struct.functiongetChapter(uint256 chapterId) publicviewreturns (Chapter memory _chapter) {
uint256 chapterDetails = _chapterDetails[chapterId];
_chapter.active =uint8(uint256(chapterDetails)) ==1;
_chapter.frozen =uint8(uint256(chapterDetails >>8)) ==1;
_chapter.isSaleOpen =uint8(uint256(chapterDetails >>16)) ==1;
_chapter.isPublicSaleOpen =uint8(uint256(chapterDetails >>24)) ==1;
_chapter.supply =uint256(uint16(chapterDetails >>32));
_chapter.maxSupply =uint256(uint16(chapterDetails >>48));
_chapter.price =uint256(uint64(chapterDetails >>64));
_chapter.discountPrice =uint256(uint64(chapterDetails >>128));
_chapter.firstTokenId =uint256(uint64(chapterDetails >>192));
// Get _chapterStrings
ChapterStrings memory chapterString = _chapterStrings[chapterId];
_chapter.name= chapterString.name;
_chapter.image = chapterString.image;
_chapter.description = chapterString.description;
_chapter.metadataURI = chapterString.metadataURI;
_chapter.merkleRoot = chapterString.merkleRoot;
return _chapter;
}
functioncreateChapter(uint256 chapterId,
stringcalldata name,
stringcalldata description,
stringcalldata image,
uint256 maxSupply,
uint256 price,
uint256 discountPrice
) externalonlyOwner{
require(_chapterDetails[chapterId] ==0, "Chapter already exists.");
if (chapterId >1) {
Chapter memory prevChapter = getChapter(chapterId -1);
require(prevChapter.frozen, "Previous chapter still open.");
}
Chapter memory newChapter;
newChapter.active =true;
newChapter.price = price;
newChapter.discountPrice = discountPrice;
newChapter.maxSupply = maxSupply;
newChapter.firstTokenId = TOTAL_MINTED;
setChapter(newChapter, chapterId);
_chapterStrings[chapterId].name= name;
_chapterStrings[chapterId].image = image;
_chapterStrings[chapterId].description = description;
latestChapter = chapterId;
}
// Update the supply of a chapter.functionupdateSupply(uint256 chapterId, uint256 supply) internal{
// Check supply sizerequire(supply <65535, "Supply exceeds uint16.");
Chapter memory chapter = getChapter(chapterId);
chapter.supply = chapter.supply + supply;
setChapter(chapter, chapterId);
}
/**
* @notice Set the max supply for a chapter.
*/functionupdateMaxSupply(uint256 chapterId, uint256 maxSupply) externalchapterExists(chapterId) onlyOwner{
require(maxSupply <65535, "maxSupply exceeds uint16.");
Chapter memory chapter = getChapter(chapterId);
require(chapter.supply <= maxSupply, "Must be higher than the existing supply");
chapter.maxSupply = maxSupply;
setChapter(chapter, chapterId);
}
/**
* @notice Set the price for a chapter.
*/functionupdatePrice(uint256 chapterId, uint256 price) externalchapterExists(chapterId) onlyOwner{
require(price <2**64, "Price exceeds uint64.");
Chapter memory chapter = getChapter(chapterId);
chapter.price = price;
setChapter(chapter, chapterId);
}
/**
* @notice Set the discount price for a chapter.
*/functionupdateDiscountPrice(uint256 chapterId, uint256 discountPrice) externalchapterExists(chapterId) onlyOwner{
require(discountPrice <2**64, "Price exceeds uint64.");
Chapter memory chapter = getChapter(chapterId);
chapter.discountPrice = discountPrice;
setChapter(chapter, chapterId);
}
/**
* @notice Toggle the allowList sale on / off.
*/functiontogglePrivateSale(uint256 chapterId) externalchapterExists(chapterId) onlyOwner{
Chapter memory chapter = getChapter(chapterId);
require(!chapter.frozen, "Chapter frozen.");
chapter.isSaleOpen = chapter.isSaleOpen ? false : true;
setChapter(chapter, chapterId);
}
/**
* @notice Toggle the public sale on / off.
*/functiontogglePublicSale(uint256 chapterId) externalchapterExists(chapterId) onlyOwner{
Chapter memory chapter = getChapter(chapterId);
require(!chapter.frozen, "Chapter frozen.");
require(chapter.maxSupply >0, "Max supply not set");
require(chapter.price >0, "Price not set");
chapter.isPublicSaleOpen = chapter.isPublicSaleOpen ? false : true;
setChapter(chapter, chapterId);
}
/**
* @notice Freeze a chapter forever. Irreversible.
*/functionfreezeChapterPermanently(uint256 chapterId) externalchapterExists(chapterId) onlyOwner{
Chapter memory chapter = getChapter(chapterId);
chapter.frozen =true; // Salute.gif
setChapter(chapter, chapterId);
}
/**
* @notice Update the name of a chapter.
*/functionupdateChapterName(uint256 chapterId, stringcalldata name) externalchapterExists(chapterId) onlyOwner{
Chapter memory chapter = getChapter(chapterId);
require(!chapter.frozen, "Chapter is frozen");
_chapterStrings[chapterId].name= name;
}
/**
* @notice Update the image URL of a chapter.
*/functionupdateChapterImage(uint256 chapterId, stringcalldata image) externalchapterExists(chapterId) onlyOwner{
Chapter memory chapter = getChapter(chapterId);
require(!chapter.frozen, "Chapter is frozen");
_chapterStrings[chapterId].image = image;
}
/**
* @notice Update the metadata URL of a chapter.
*/functionupdateChapterMetadataUri(uint256 chapterId, stringcalldata uri)
externalchapterExists(chapterId)
onlyOwner{
Chapter memory chapter = getChapter(chapterId);
require(!chapter.frozen, "Chapter is frozen");
_chapterStrings[chapterId].metadataURI = uri;
}
/**
* @notice Update the metadata URL of a single token.
*/functionupdateTokenMetadataUri(uint256 tokenId, stringcalldata uri) externalonlyOwner{
require(_exists(tokenId), "Token does not exist.");
Chapter memory chapter = findChapter(tokenId);
require(!chapter.frozen, "Chapter is frozen");
_customTokenURIs[tokenId] = uri;
}
/**
* @notice Update the description of a chapter.
*/functionupdateChapterDescription(uint256 chapterId, stringcalldata description)
externalchapterExists(chapterId)
onlyOwner{
Chapter memory chapter = getChapter(chapterId);
require(!chapter.frozen, "Chapter is frozen");
_chapterStrings[chapterId].description = description;
}
/**
* @notice Set the merkle root for a chapter.
*/functionupdateMerkleRoot(uint256 chapterId, bytes32 merkleRoot) externalchapterExists(chapterId) onlyOwner{
// chapterMerkle[chapterId] = merkleRoot;
_chapterStrings[chapterId].merkleRoot = merkleRoot;
}
/**
* @notice Mint for owner.
*/functionownerMint(uint256 quantity, uint256 chapterId) externalchapterExists(chapterId) onlyOwner{
Chapter memory chapter = getChapter(chapterId);
require(!chapter.frozen, "Chapter frozen.");
require((chapter.supply + quantity) <= chapter.maxSupply, "Exceeds chapter maximum supply.");
// Update the supply of this chapter.
updateSupply(chapterId, quantity);
for (uint256 i =0; i < quantity; i++) {
// Mint it.
_safeMint(msg.sender, TOTAL_MINTED);
TOTAL_MINTED++;
}
}
/**
* @notice Mint tokens.
*/functionmint(uint256 quantity, uint256 chapterId) externalpayablechapterExists(chapterId) callerIsUser{
Chapter memory chapter = getChapter(chapterId);
require(!chapter.frozen, "Chapter frozen.");
require(chapter.isPublicSaleOpen, "Public sale not open");
require(msg.value== (chapter.price * quantity), "Payment incorrect");
require((chapter.supply + quantity) <= chapter.maxSupply, "Max purchase supply exceeded");
require((minted[msg.sender][chapterId] + quantity) <= MAX_MINT, "Quantity exceeded");
minted[msg.sender][chapterId] = minted[msg.sender][chapterId] + quantity;
updateSupply(chapterId, quantity);
for (uint256 i; i < quantity; i++) {
_safeMint(msg.sender, TOTAL_MINTED);
TOTAL_MINTED++;
}
}
/**
* @notice Mint tokens.
*/functionallowListMint(uint256 chapterId,
uint256 amount,
uint256 discountAmount,
uint256 ticket,
uint256 maxQty,
uint256 maxDiscountQty,
bytes32[] calldata merkleProof
) externalpayablechapterExists(chapterId) callerIsUser{
Chapter memory chapter = getChapter(chapterId);
require(chapter.isSaleOpen, "Sale not open");
require((chapter.supply + amount + discountAmount) <= chapter.maxSupply, "Max purchase supply exceeded");
require((allowListMinted[msg.sender][chapterId] + amount) <= maxQty, "Amount exceeded.");
require((discountMinted[msg.sender][chapterId] + discountAmount) <= maxDiscountQty, "Discount amount exceeded.");
require(msg.value== (chapter.price * amount) + (chapter.discountPrice * discountAmount), "Payment incorrect");
bytes32 leaf =keccak256(abi.encodePacked(msg.sender, ticket, maxQty, maxDiscountQty));
require(MerkleProof.verify(merkleProof, chapter.merkleRoot, leaf), "Invalid proof.");
allowListMinted[msg.sender][chapterId] = allowListMinted[msg.sender][chapterId] + amount;
discountMinted[msg.sender][chapterId] = discountMinted[msg.sender][chapterId] + discountAmount;
// Update the supply of this chapter.
updateSupply(chapterId, amount + discountAmount);
for (uint256 i; i < amount + discountAmount; i++) {
_safeMint(msg.sender, TOTAL_MINTED);
TOTAL_MINTED++;
}
}
// ** - ADMIN - ** //functionwithdrawEther(addresspayable _to, uint256 _amount) externalonlyOwner{
_to.transfer(_amount);
}
/**
* @notice Set the maximum number of mints per wallet.
*/functionsetMAX_MINT(uint256 max) externalonlyOwner{
MAX_MINT = max;
}
/**
* @notice Updated the web URL.
*/functionsetWebsite(stringcalldata url) externalonlyOwner{
ghxstsWebsite = url;
}
/**
* @notice Find which chapter this token belongs to.
*/functionfindChapter(uint256 tokenId) publicviewreturns (Chapter memory chapter) {
for (uint256 i =1; i <= latestChapter; i++) {
chapter = getChapter(i);
if (chapter.firstTokenId <= tokenId && chapter.firstTokenId + chapter.maxSupply > tokenId) {
return chapter;
}
}
}
// ** - MISC - ** //functiontokenURI(uint256 tokenId) publicviewvirtualoverridereturns (stringmemory) {
require(_exists(tokenId), "URI query for nonexistent token");
Chapter memory chapter = findChapter(tokenId);
uint256 chapterStart = chapter.firstTokenId;
uint256 edition = tokenId - chapterStart;
stringmemory editionNumber = Strings.toString(edition);
stringmemory chapterUri = chapter.metadataURI;
stringmemory tokenUri = _customTokenURIs[tokenId];
// Check for token specific metadataif (bytes(tokenUri).length>0) {
return tokenUri;
}
// Check for chapter override metadataif (bytes(chapterUri).length>0) {
return chapterUri;
}
// Build default metadata.// Prepend any zeroes for edition numbers. Purely aesthetic.if (edition ==0) {
editionNumber ="0";
} elseif (edition <10) {
editionNumber =string(abi.encodePacked("00", editionNumber));
} elseif (edition <100) {
editionNumber =string(abi.encodePacked("0", editionNumber));
}
// Default metadatastringmemory json = Base64.encode(
bytes(
string(
abi.encodePacked(
'{"name": "',
chapter.name,
" - #",
editionNumber,
'", "description": "',
chapter.description,
'", "image": "',
chapter.image,
'", "external_url": "',
ghxstsWebsite,
'", "attributes": [{"trait_type": "Chapter","value": "',
chapter.name,
'"},{"trait_type": "Edition","value": "#',
editionNumber,
'"}]}'
)
)
)
);
returnstring(abi.encodePacked("data:application/json;base64,", json));
}
mapping(uint256=>uint256) public chapterAuctionSupply;
mapping(uint256=>uint256) public chapterAuctionMinted;
mapping(uint256=>uint32) public chapterAuctionStartTime;
mapping(uint256=>uint256) public chapterAuctionStartPrice;
mapping(uint256=>uint256) public chapterAuctionEndPrice;
mapping(uint256=>uint256) public chapterAuctionPriceCurveLength;
mapping(uint256=>uint256) public chapterAuctionDropInterval;
mapping(uint256=>uint256) public chapterAuctionDropPerStep;
functionauctionMint(uint256 chapterId, uint256 amount) externalpayablechapterExists(chapterId) callerIsUser{
uint256 _saleStartTime = chapterAuctionStartTime[chapterId];
require(_saleStartTime !=0&&block.timestamp>= _saleStartTime, "Sale has not started yet");
require(
chapterAuctionMinted[chapterId] + amount <= chapterAuctionSupply[chapterId],
"Max auction supply exceeded."
);
Chapter memory chapter = getChapter(chapterId);
require((chapter.supply + amount) <= chapter.maxSupply, "Max purchase supply exceeded");
require(auctionMinted[msg.sender][chapterId] + amount <= MAX_MINT, "Max mint qty exceeded");
uint256 totalCost = getAuctionPrice(chapterId, _saleStartTime) * amount;
auctionMinted[msg.sender][chapterId] = auctionMinted[msg.sender][chapterId] + amount;
// Update the supply of this chapter.
updateSupply(chapterId, amount);
for (uint256 i; i < amount; i++) {
_safeMint(msg.sender, TOTAL_MINTED);
TOTAL_MINTED++;
}
refundIfOver(totalCost);
}
functionrefundIfOver(uint256 price) private{
require(msg.value>= price, "Need to send more ETH.");
if (msg.value> price) {
payable(msg.sender).transfer(msg.value- price);
}
}
// getAuctionPricefunctiongetAuctionPrice(uint256 chapterId, uint256 _saleStartTime)
publicviewchapterExists(chapterId)
returns (uint256)
{
if (block.timestamp< _saleStartTime) {
return chapterAuctionStartPrice[chapterId];
}
if (block.timestamp- _saleStartTime >= chapterAuctionPriceCurveLength[chapterId]) {
return chapterAuctionEndPrice[chapterId];
} else {
uint256 steps = (block.timestamp- _saleStartTime) / chapterAuctionDropInterval[chapterId];
return chapterAuctionStartPrice[chapterId] - (steps * chapterAuctionDropPerStep[chapterId]);
}
}
functioncreateChapterAuction(uint256 chapterId,
uint256 auctionSupply,
uint32 startTime,
uint256 startPrice,
uint256 endPrice,
uint256 priceCurveLength,
uint256 dropInterval
) externalchapterExists(chapterId) onlyOwner{
chapterAuctionSupply[chapterId] = auctionSupply;
chapterAuctionStartTime[chapterId] = startTime;
chapterAuctionStartPrice[chapterId] = startPrice;
chapterAuctionEndPrice[chapterId] = endPrice;
chapterAuctionPriceCurveLength[chapterId] = priceCurveLength;
chapterAuctionDropInterval[chapterId] = dropInterval;
chapterAuctionDropPerStep[chapterId] = (startPrice - endPrice) / (priceCurveLength / dropInterval);
}
functionsupportsInterface(bytes4 interfaceId) publicviewvirtualoverride(ERC721, ERC721Enumerable) returns (bool) {
returnsuper.supportsInterface(interfaceId);
}
function_beforeTokenTransfer(addressfrom,
address to,
uint256 tokenId
) internalvirtualoverride(ERC721, ERC721Enumerable) {
super._beforeTokenTransfer(from, to, tokenId);
}
functiongetMintedQty(uint256 chapterId,
address addr,
uint256 mintType // 1: Minted, 2: allowListMinted, 3: discountMinted, 4: auctionMinted) externalviewchapterExists(chapterId) returns (uint256) {
if (mintType ==1) {
return minted[addr][chapterId];
} elseif (mintType ==2) {
return allowListMinted[addr][chapterId];
} elseif (mintType ==3) {
return discountMinted[addr][chapterId];
} else {
return auctionMinted[addr][chapterId];
}
}
}
Contract Source Code
File 8 of 16: IERC165.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)pragmasolidity ^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}.
*/interfaceIERC165{
/**
* @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.
*/functionsupportsInterface(bytes4 interfaceId) externalviewreturns (bool);
}
Contract Source Code
File 9 of 16: IERC721.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721.sol)pragmasolidity ^0.8.0;import"../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC721 compliant contract.
*/interfaceIERC721isIERC165{
/**
* @dev Emitted when `tokenId` token is transferred from `from` to `to`.
*/eventTransfer(addressindexedfrom, addressindexed to, uint256indexed tokenId);
/**
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
*/eventApproval(addressindexed owner, addressindexed approved, uint256indexed tokenId);
/**
* @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
*/eventApprovalForAll(addressindexed owner, addressindexed operator, bool approved);
/**
* @dev Returns the number of tokens in ``owner``'s account.
*/functionbalanceOf(address owner) externalviewreturns (uint256 balance);
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/functionownerOf(uint256 tokenId) externalviewreturns (address owner);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
* are aware of the ERC721 protocol to prevent tokens from being forever locked.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/functionsafeTransferFrom(addressfrom,
address to,
uint256 tokenId
) external;
/**
* @dev Transfers `tokenId` token from `from` to `to`.
*
* WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/functiontransferFrom(addressfrom,
address to,
uint256 tokenId
) external;
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/functionapprove(address to, uint256 tokenId) external;
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/functiongetApproved(uint256 tokenId) externalviewreturns (address operator);
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/functionsetApprovalForAll(address operator, bool _approved) external;
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}
*/functionisApprovedForAll(address owner, address operator) externalviewreturns (bool);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/functionsafeTransferFrom(addressfrom,
address to,
uint256 tokenId,
bytescalldata data
) external;
}
Contract Source Code
File 10 of 16: IERC721Enumerable.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts (last updated v4.5.0) (token/ERC721/extensions/IERC721Enumerable.sol)pragmasolidity ^0.8.0;import"../IERC721.sol";
/**
* @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
* @dev See https://eips.ethereum.org/EIPS/eip-721
*/interfaceIERC721EnumerableisIERC721{
/**
* @dev Returns the total amount of tokens stored by the contract.
*/functiontotalSupply() externalviewreturns (uint256);
/**
* @dev Returns a token ID owned by `owner` at a given `index` of its token list.
* Use along with {balanceOf} to enumerate all of ``owner``'s tokens.
*/functiontokenOfOwnerByIndex(address owner, uint256 index) externalviewreturns (uint256);
/**
* @dev Returns a token ID at a given `index` of all the tokens stored by the contract.
* Use along with {totalSupply} to enumerate all tokens.
*/functiontokenByIndex(uint256 index) externalviewreturns (uint256);
}
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts v4.4.1 (token/ERC721/IERC721Receiver.sol)pragmasolidity ^0.8.0;/**
* @title ERC721 token receiver interface
* @dev Interface for any contract that wants to support safeTransfers
* from ERC721 asset contracts.
*/interfaceIERC721Receiver{
/**
* @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
* by `operator` from `from`, this function is called.
*
* It must return its Solidity selector to confirm the token transfer.
* If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
*
* The selector can be obtained in Solidity with `IERC721.onERC721Received.selector`.
*/functiononERC721Received(address operator,
addressfrom,
uint256 tokenId,
bytescalldata data
) externalreturns (bytes4);
}
Contract Source Code
File 13 of 16: MerkleProof.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts (last updated v4.5.0) (utils/cryptography/MerkleProof.sol)pragmasolidity ^0.8.0;/**
* @dev These functions deal with verification of Merkle Trees proofs.
*
* The proofs can be generated using the JavaScript library
* https://github.com/miguelmota/merkletreejs[merkletreejs].
* Note: the hashing algorithm should be keccak256 and pair sorting should be enabled.
*
* See `test/utils/cryptography/MerkleProof.test.js` for some examples.
*/libraryMerkleProof{
/**
* @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree
* defined by `root`. For this, a `proof` must be provided, containing
* sibling hashes on the branch from the leaf to the root of the tree. Each
* pair of leaves and each pair of pre-images are assumed to be sorted.
*/functionverify(bytes32[] memory proof,
bytes32 root,
bytes32 leaf
) internalpurereturns (bool) {
return processProof(proof, leaf) == root;
}
/**
* @dev Returns the rebuilt hash obtained by traversing a Merklee tree up
* from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt
* hash matches the root of the tree. When processing the proof, the pairs
* of leafs & pre-images are assumed to be sorted.
*
* _Available since v4.4._
*/functionprocessProof(bytes32[] memory proof, bytes32 leaf) internalpurereturns (bytes32) {
bytes32 computedHash = leaf;
for (uint256 i =0; i < proof.length; i++) {
bytes32 proofElement = proof[i];
if (computedHash <= proofElement) {
// Hash(current computed hash + current element of the proof)
computedHash = _efficientHash(computedHash, proofElement);
} else {
// Hash(current element of the proof + current computed hash)
computedHash = _efficientHash(proofElement, computedHash);
}
}
return computedHash;
}
function_efficientHash(bytes32 a, bytes32 b) privatepurereturns (bytes32 value) {
assembly {
mstore(0x00, a)
mstore(0x20, b)
value :=keccak256(0x00, 0x40)
}
}
}
Contract Source Code
File 14 of 16: Ownable.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts v4.4.1 (access/Ownable.sol)pragmasolidity ^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.
*/abstractcontractOwnableisContext{
addressprivate _owner;
eventOwnershipTransferred(addressindexed previousOwner, addressindexed newOwner);
/**
* @dev Initializes the contract setting the deployer as the initial owner.
*/constructor() {
_transferOwnership(_msgSender());
}
/**
* @dev Returns the address of the current owner.
*/functionowner() publicviewvirtualreturns (address) {
return _owner;
}
/**
* @dev Throws if called by any account other than the owner.
*/modifieronlyOwner() {
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.
*/functionrenounceOwnership() publicvirtualonlyOwner{
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/functiontransferOwnership(address newOwner) publicvirtualonlyOwner{
require(newOwner !=address(0), "Ownable: new owner is the zero address");
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/function_transferOwnership(address newOwner) internalvirtual{
address oldOwner = _owner;
_owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
}
Contract Source Code
File 15 of 16: Strings.sol
// SPDX-License-Identifier: MIT// OpenZeppelin Contracts v4.4.1 (utils/Strings.sol)pragmasolidity ^0.8.0;/**
* @dev String operations.
*/libraryStrings{
bytes16privateconstant _HEX_SYMBOLS ="0123456789abcdef";
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/functiontoString(uint256 value) internalpurereturns (stringmemory) {
// Inspired by OraclizeAPI's implementation - MIT licence// https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.solif (value ==0) {
return"0";
}
uint256 temp = value;
uint256 digits;
while (temp !=0) {
digits++;
temp /=10;
}
bytesmemory buffer =newbytes(digits);
while (value !=0) {
digits -=1;
buffer[digits] =bytes1(uint8(48+uint256(value %10)));
value /=10;
}
returnstring(buffer);
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/functiontoHexString(uint256 value) internalpurereturns (stringmemory) {
if (value ==0) {
return"0x00";
}
uint256 temp = value;
uint256 length =0;
while (temp !=0) {
length++;
temp >>=8;
}
return toHexString(value, length);
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/functiontoHexString(uint256 value, uint256 length) internalpurereturns (stringmemory) {
bytesmemory buffer =newbytes(2* length +2);
buffer[0] ="0";
buffer[1] ="x";
for (uint256 i =2* length +1; i >1; --i) {
buffer[i] = _HEX_SYMBOLS[value &0xf];
value >>=4;
}
require(value ==0, "Strings: hex length insufficient");
returnstring(buffer);
}
}
Contract Source Code
File 16 of 16: base64.sol
// SPDX-License-Identifier: MITpragmasolidity >=0.6.0;/// @title Base64/// @author Brecht Devos - <brecht@loopring.org>/// @notice Provides functions for encoding/decoding base64libraryBase64{
stringinternalconstant TABLE_ENCODE ='ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
bytesinternalconstant TABLE_DECODE =hex"0000000000000000000000000000000000000000000000000000000000000000"hex"00000000000000000000003e0000003f3435363738393a3b3c3d000000000000"hex"00000102030405060708090a0b0c0d0e0f101112131415161718190000000000"hex"001a1b1c1d1e1f202122232425262728292a2b2c2d2e2f303132330000000000";
functionencode(bytesmemory data) internalpurereturns (stringmemory) {
if (data.length==0) return'';
// load the table into memorystringmemory table = TABLE_ENCODE;
// multiply by 4/3 rounded upuint256 encodedLen =4* ((data.length+2) /3);
// add some extra buffer at the end required for the writingstringmemory result =newstring(encodedLen +32);
assembly {
// set the actual output lengthmstore(result, encodedLen)
// prepare the lookup tablelet tablePtr :=add(table, 1)
// input ptrlet dataPtr := data
let endPtr :=add(dataPtr, mload(data))
// result ptr, jump over lengthlet resultPtr :=add(result, 32)
// run over the input, 3 bytes at a timefor {} lt(dataPtr, endPtr) {}
{
// read 3 bytes
dataPtr :=add(dataPtr, 3)
let input :=mload(dataPtr)
// write 4 charactersmstore8(resultPtr, mload(add(tablePtr, and(shr(18, input), 0x3F))))
resultPtr :=add(resultPtr, 1)
mstore8(resultPtr, mload(add(tablePtr, and(shr(12, input), 0x3F))))
resultPtr :=add(resultPtr, 1)
mstore8(resultPtr, mload(add(tablePtr, and(shr( 6, input), 0x3F))))
resultPtr :=add(resultPtr, 1)
mstore8(resultPtr, mload(add(tablePtr, and( input, 0x3F))))
resultPtr :=add(resultPtr, 1)
}
// padding with '='switchmod(mload(data), 3)
case1 { mstore(sub(resultPtr, 2), shl(240, 0x3d3d)) }
case2 { mstore(sub(resultPtr, 1), shl(248, 0x3d)) }
}
return result;
}
functiondecode(stringmemory _data) internalpurereturns (bytesmemory) {
bytesmemory data =bytes(_data);
if (data.length==0) returnnewbytes(0);
require(data.length%4==0, "invalid base64 decoder input");
// load the table into memorybytesmemory table = TABLE_DECODE;
// every 4 characters represent 3 bytesuint256 decodedLen = (data.length/4) *3;
// add some extra buffer at the end required for the writingbytesmemory result =newbytes(decodedLen +32);
assembly {
// padding with '='let lastBytes :=mload(add(data, mload(data)))
ifeq(and(lastBytes, 0xFF), 0x3d) {
decodedLen :=sub(decodedLen, 1)
ifeq(and(lastBytes, 0xFFFF), 0x3d3d) {
decodedLen :=sub(decodedLen, 1)
}
}
// set the actual output lengthmstore(result, decodedLen)
// prepare the lookup tablelet tablePtr :=add(table, 1)
// input ptrlet dataPtr := data
let endPtr :=add(dataPtr, mload(data))
// result ptr, jump over lengthlet resultPtr :=add(result, 32)
// run over the input, 4 characters at a timefor {} lt(dataPtr, endPtr) {}
{
// read 4 characters
dataPtr :=add(dataPtr, 4)
let input :=mload(dataPtr)
// write 3 byteslet output :=add(
add(
shl(18, and(mload(add(tablePtr, and(shr(24, input), 0xFF))), 0xFF)),
shl(12, and(mload(add(tablePtr, and(shr(16, input), 0xFF))), 0xFF))),
add(
shl( 6, and(mload(add(tablePtr, and(shr( 8, input), 0xFF))), 0xFF)),
and(mload(add(tablePtr, and( input , 0xFF))), 0xFF)
)
)
mstore(resultPtr, shl(232, output))
resultPtr :=add(resultPtr, 3)
}
}
return result;
}
}