Sponsored
MoonPay
Buy, sell and swap Ethereum with MoonPay.Buy Now!
Spend less on fees, more on crypto. Buy crypto easily with MoonPay Balance. 20M+ users trust MoonPay worldwide.
MetaMask
Manage your web3 everything with MetaMask Portfolio. Try Now!
Ready to onboard to Ethereum? With MetaMask Portfolio, you're in control.
eToro
One-stop crypto shop: trusted, simple & safe.
Don’t invest unless you’re prepared to lose all the money you invest.
Sponsored
MetaMask
Meet MetaMask Portfolio - your key to getting more out of web3. Try Now
Ready to simplify your web3 experience? Try the all-in-one web3 app trusted by millions worldwide.
MetaMask
Swap directly on 9 networks Try Now
Available on 9 networks: Ethereum mainnet, Linea, Polygon, Optimism, BNB Chain, zkSync Era, Base, Avalanche.
Sponsored
Сoins.game
100 free spins for registration. Spin now!
Everyday giveaways up to 100 ETH, Lucky Spins. Deposit BONUS 300% and Cashbacks!
BC.GAME
- The Best ETH Casino Claim Now!
5000+ Slots & Live Casino Games, 50+cryptos. Register with Etherscan and get 760% deposit bonus. Win Big$, withdraw it fast.
Stake
200% Bonus, 100K Daily Giveaways, Instant Withdrawals Play Now!
Slots, Roulette, Poker & more - Proud sponsors of UFC, Everton & StakeF1 team!
Sponsored
BC.GAME
- The Best ETH Casino Claim Now!
5000+ Slots & Live Casino Games, 50+cryptos. Register with Etherscan and get 760% deposit bonus. Win Big$, withdraw it fast.
CryptoSlots
Play & Get 25 Free Spins at CryptoSlots Play Now
Anonymous play on awesome games - sign up now for 25 free jackpot spins - worth $100s!
CryptoWins
200% More Funds to Play on Us up to 4 BTC! Claim Now!
100s of games, generous bonuses, 20+ years of trusted gaming. Join CryptoWins & start winning today!
Feature Tip: Add private address tag to any address under My Name Tag !
ERC-721
Overview
Max Total Supply
0 FDQ
Holders
54
Market
Volume (24H)
N/A
Min Price (24H)
N/A
Max Price (24H)
N/A
Other Info
Token Contract
Balance
1 FDQLoading...
Loading
Loading...
Loading
Loading...
Loading
| # | Exchange | Pair | Price | 24H Volume | % Volume |
|---|
Contract Name:
DataQuiltRegistryV1
Compiler Version
v0.8.17+commit.8df45f5f
Optimization Enabled:
Yes with 200 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity)
/**
*Submitted for verification at Etherscan.io on 2023-03-30
*/
// SPDX-License-Identifier: MIT
pragma solidity 0.8.17;
// OpenZeppelin Contracts (last updated v4.8.2) (token/ERC721/ERC721.sol)
// OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/IERC721.sol)
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
/**
* @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);
}
/**
* @dev Required interface of an ERC721 compliant contract.
*/
interface IERC721 is IERC165 {
/**
* @dev Emitted when `tokenId` token is transferred from `from` to `to`.
*/
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
*/
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
*/
event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
/**
* @dev Returns the number of tokens in ``owner``'s account.
*/
function balanceOf(address owner) external view returns (uint256 balance);
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) external view returns (address owner);
/**
* @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.
*/
function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
/**
* @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 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.
*/
function safeTransferFrom(address from, address to, uint256 tokenId) external;
/**
* @dev Transfers `tokenId` token from `from` to `to`.
*
* WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
* or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
* understand this adds an external call which potentially creates a reentrancy vulnerability.
*
* 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.
*/
function transferFrom(address from, 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.
*/
function approve(address to, uint256 tokenId) external;
/**
* @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.
*/
function setApprovalForAll(address operator, bool approved) external;
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) external view returns (address operator);
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}
*/
function isApprovedForAll(address owner, address operator) external view returns (bool);
}
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)
/**
* @title ERC721 token receiver interface
* @dev Interface for any contract that wants to support safeTransfers
* from ERC721 asset contracts.
*/
interface IERC721Receiver {
/**
* @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 `IERC721Receiver.onERC721Received.selector`.
*/
function onERC721Received(
address operator,
address from,
uint256 tokenId,
bytes calldata data
) external returns (bytes4);
}
// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
/**
* @title ERC-721 Non-Fungible Token Standard, optional metadata extension
* @dev See https://eips.ethereum.org/EIPS/eip-721
*/
interface IERC721Metadata is IERC721 {
/**
* @dev Returns the token collection name.
*/
function name() external view returns (string memory);
/**
* @dev Returns the token collection symbol.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) external view returns (string memory);
}
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
/**
* @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
*
* Furthermore, `isContract` will also return true if the target contract within
* the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
* which only has an effect at the end of a transaction.
* ====
*
* [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.
* ====
*/
function isContract(address account) internal view returns (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://consensys.net/diligence/blog/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");
(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 functionCallWithValue(target, data, 0, "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");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, 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) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, 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) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) private pure {
// 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
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
/**
* @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.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
}
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol)
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol)
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library Math {
enum Rounding {
Down, // Toward negative infinity
Up, // Toward infinity
Zero // Toward zero
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds up instead
* of rounding down.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b - 1) / b can overflow on addition, so we distribute.
return a == 0 ? 0 : (a - 1) / b + 1;
}
/**
* @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
* @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
* with further edits by Uniswap Labs also under MIT license.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
unchecked {
// 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
// use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = prod1 * 2^256 + prod0.
uint256 prod0; // Least significant 256 bits of the product
uint256 prod1; // Most significant 256 bits of the product
assembly {
let mm := mulmod(x, y, not(0))
prod0 := mul(x, y)
prod1 := sub(sub(mm, prod0), lt(mm, prod0))
}
// Handle non-overflow cases, 256 by 256 division.
if (prod1 == 0) {
// Solidity will revert if denominator == 0, unlike the div opcode on its own.
// The surrounding unchecked block does not change this fact.
// See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
return prod0 / denominator;
}
// Make sure the result is less than 2^256. Also prevents denominator == 0.
require(denominator > prod1, "Math: mulDiv overflow");
///////////////////////////////////////////////
// 512 by 256 division.
///////////////////////////////////////////////
// Make division exact by subtracting the remainder from [prod1 prod0].
uint256 remainder;
assembly {
// Compute remainder using mulmod.
remainder := mulmod(x, y, denominator)
// Subtract 256 bit number from 512 bit number.
prod1 := sub(prod1, gt(remainder, prod0))
prod0 := sub(prod0, remainder)
}
// Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
// See https://cs.stackexchange.com/q/138556/92363.
// Does not overflow because the denominator cannot be zero at this stage in the function.
uint256 twos = denominator & (~denominator + 1);
assembly {
// Divide denominator by twos.
denominator := div(denominator, twos)
// Divide [prod1 prod0] by twos.
prod0 := div(prod0, twos)
// Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
twos := add(div(sub(0, twos), twos), 1)
}
// Shift in bits from prod1 into prod0.
prod0 |= prod1 * twos;
// Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
// that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
// four bits. That is, denominator * inv = 1 mod 2^4.
uint256 inverse = (3 * denominator) ^ 2;
// Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
// in modular arithmetic, doubling the correct bits in each step.
inverse *= 2 - denominator * inverse; // inverse mod 2^8
inverse *= 2 - denominator * inverse; // inverse mod 2^16
inverse *= 2 - denominator * inverse; // inverse mod 2^32
inverse *= 2 - denominator * inverse; // inverse mod 2^64
inverse *= 2 - denominator * inverse; // inverse mod 2^128
inverse *= 2 - denominator * inverse; // inverse mod 2^256
// Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
// This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
// less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
// is no longer required.
result = prod0 * inverse;
return result;
}
}
/**
* @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {
uint256 result = mulDiv(x, y, denominator);
if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
result += 1;
}
return result;
}
/**
* @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
*
* Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
*/
function sqrt(uint256 a) internal pure returns (uint256) {
if (a == 0) {
return 0;
}
// For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
//
// We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
// `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
//
// This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
// → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
// → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
//
// Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
uint256 result = 1 << (log2(a) >> 1);
// At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
// since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
// every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
// into the expected uint128 result.
unchecked {
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
return min(result, a / result);
}
}
/**
* @notice Calculates sqrt(a), following the selected rounding direction.
*/
function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = sqrt(a);
return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
}
}
/**
* @dev Return the log in base 2, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 128;
}
if (value >> 64 > 0) {
value >>= 64;
result += 64;
}
if (value >> 32 > 0) {
value >>= 32;
result += 32;
}
if (value >> 16 > 0) {
value >>= 16;
result += 16;
}
if (value >> 8 > 0) {
value >>= 8;
result += 8;
}
if (value >> 4 > 0) {
value >>= 4;
result += 4;
}
if (value >> 2 > 0) {
value >>= 2;
result += 2;
}
if (value >> 1 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 2, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log2(value);
return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 10, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >= 10 ** 64) {
value /= 10 ** 64;
result += 64;
}
if (value >= 10 ** 32) {
value /= 10 ** 32;
result += 32;
}
if (value >= 10 ** 16) {
value /= 10 ** 16;
result += 16;
}
if (value >= 10 ** 8) {
value /= 10 ** 8;
result += 8;
}
if (value >= 10 ** 4) {
value /= 10 ** 4;
result += 4;
}
if (value >= 10 ** 2) {
value /= 10 ** 2;
result += 2;
}
if (value >= 10 ** 1) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log10(value);
return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 256, rounded down, of a positive value.
* Returns 0 if given 0.
*
* Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
*/
function log256(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 16;
}
if (value >> 64 > 0) {
value >>= 64;
result += 8;
}
if (value >> 32 > 0) {
value >>= 32;
result += 4;
}
if (value >> 16 > 0) {
value >>= 16;
result += 2;
}
if (value >> 8 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 256, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log256(value);
return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);
}
}
}
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)
/**
* @dev Standard signed math utilities missing in the Solidity language.
*/
library SignedMath {
/**
* @dev Returns the largest of two signed numbers.
*/
function max(int256 a, int256 b) internal pure returns (int256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two signed numbers.
*/
function min(int256 a, int256 b) internal pure returns (int256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two signed numbers without overflow.
* The result is rounded towards zero.
*/
function average(int256 a, int256 b) internal pure returns (int256) {
// Formula from the book "Hacker's Delight"
int256 x = (a & b) + ((a ^ b) >> 1);
return x + (int256(uint256(x) >> 255) & (a ^ b));
}
/**
* @dev Returns the absolute unsigned value of a signed value.
*/
function abs(int256 n) internal pure returns (uint256) {
unchecked {
// must be unchecked in order to support `n = type(int256).min`
return uint256(n >= 0 ? n : -n);
}
}
}
/**
* @dev String operations.
*/
library Strings {
bytes16 private constant _SYMBOLS = "0123456789abcdef";
uint8 private constant _ADDRESS_LENGTH = 20;
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
unchecked {
uint256 length = Math.log10(value) + 1;
string memory buffer = new string(length);
uint256 ptr;
/// @solidity memory-safe-assembly
assembly {
ptr := add(buffer, add(32, length))
}
while (true) {
ptr--;
/// @solidity memory-safe-assembly
assembly {
mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
}
value /= 10;
if (value == 0) break;
}
return buffer;
}
}
/**
* @dev Converts a `int256` to its ASCII `string` decimal representation.
*/
function toString(int256 value) internal pure returns (string memory) {
return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMath.abs(value))));
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
unchecked {
return toHexString(value, Math.log256(value) + 1);
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
bytes memory buffer = new bytes(2 * length + 2);
buffer[0] = "0";
buffer[1] = "x";
for (uint256 i = 2 * length + 1; i > 1; --i) {
buffer[i] = _SYMBOLS[value & 0xf];
value >>= 4;
}
require(value == 0, "Strings: hex length insufficient");
return string(buffer);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
*/
function toHexString(address addr) internal pure returns (string memory) {
return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
}
/**
* @dev Returns true if the two strings are equal.
*/
function equal(string memory a, string memory b) internal pure returns (bool) {
return keccak256(bytes(a)) == keccak256(bytes(b));
}
}
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.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.
*/
abstract contract ERC165 is IERC165 {
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IERC165).interfaceId;
}
}
/**
* @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}.
*/
contract ERC721 is Context, ERC165, IERC721, IERC721Metadata {
using Address for address;
using Strings for uint256;
// Token name
string private _name;
// Token symbol
string private _symbol;
// Mapping from token ID to owner address
mapping(uint256 => address) private _owners;
// Mapping owner address to token count
mapping(address => uint256) private _balances;
// Mapping from token ID to approved address
mapping(uint256 => address) private _tokenApprovals;
// Mapping from owner to operator approvals
mapping(address => mapping(address => bool)) private _operatorApprovals;
/**
* @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
*/
constructor(string memory name_, string memory symbol_) {
_name = name_;
_symbol = symbol_;
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
return
interfaceId == type(IERC721).interfaceId ||
interfaceId == type(IERC721Metadata).interfaceId ||
super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC721-balanceOf}.
*/
function balanceOf(address owner) public view virtual override returns (uint256) {
require(owner != address(0), "ERC721: address zero is not a valid owner");
return _balances[owner];
}
/**
* @dev See {IERC721-ownerOf}.
*/
function ownerOf(uint256 tokenId) public view virtual override returns (address) {
address owner = _ownerOf(tokenId);
require(owner != address(0), "ERC721: invalid token ID");
return owner;
}
/**
* @dev See {IERC721Metadata-name}.
*/
function name() public view virtual override returns (string memory) {
return _name;
}
/**
* @dev See {IERC721Metadata-symbol}.
*/
function symbol() public view virtual override returns (string memory) {
return _symbol;
}
/**
* @dev See {IERC721Metadata-tokenURI}.
*/
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
_requireMinted(tokenId);
string memory baseURI = _baseURI();
return bytes(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 overridden in child contracts.
*/
function _baseURI() internal view virtual returns (string memory) {
return "";
}
/**
* @dev See {IERC721-approve}.
*/
function approve(address to, uint256 tokenId) public virtual override {
address owner = ERC721.ownerOf(tokenId);
require(to != owner, "ERC721: approval to current owner");
require(
_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
"ERC721: approve caller is not token owner or approved for all"
);
_approve(to, tokenId);
}
/**
* @dev See {IERC721-getApproved}.
*/
function getApproved(uint256 tokenId) public view virtual override returns (address) {
_requireMinted(tokenId);
return _tokenApprovals[tokenId];
}
/**
* @dev See {IERC721-setApprovalForAll}.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
_setApprovalForAll(_msgSender(), operator, approved);
}
/**
* @dev See {IERC721-isApprovedForAll}.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
return _operatorApprovals[owner][operator];
}
/**
* @dev See {IERC721-transferFrom}.
*/
function transferFrom(address from, address to, uint256 tokenId) public virtual override {
//solhint-disable-next-line max-line-length
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
_transfer(from, to, tokenId);
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/
function safeTransferFrom(address from, address to, uint256 tokenId) public virtual override {
safeTransferFrom(from, to, tokenId, "");
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/
function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public virtual override {
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or 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(address from, address to, uint256 tokenId, bytes memory data) internal virtual {
_transfer(from, to, tokenId);
require(_checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer");
}
/**
* @dev Returns the owner of the `tokenId`. Does NOT revert if token doesn't exist
*/
function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
return _owners[tokenId];
}
/**
* @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) internal view virtual returns (bool) {
return _ownerOf(tokenId) != address(0);
}
/**
* @dev Returns whether `spender` is allowed to manage `tokenId`.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
address owner = ERC721.ownerOf(tokenId);
return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == 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) internal virtual {
_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, bytes memory data) internal virtual {
_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) internal virtual {
require(to != address(0), "ERC721: mint to the zero address");
require(!_exists(tokenId), "ERC721: token already minted");
_beforeTokenTransfer(address(0), to, tokenId, 1);
// Check that tokenId was not minted by `_beforeTokenTransfer` hook
require(!_exists(tokenId), "ERC721: token already minted");
unchecked {
// Will not overflow unless all 2**256 token ids are minted to the same owner.
// Given that tokens are minted one by one, it is impossible in practice that
// this ever happens. Might change if we allow batch minting.
// The ERC fails to describe this case.
_balances[to] += 1;
}
_owners[tokenId] = to;
emit Transfer(address(0), to, tokenId);
_afterTokenTransfer(address(0), to, tokenId, 1);
}
/**
* @dev Destroys `tokenId`.
* The approval is cleared when the token is burned.
* This is an internal function that does not check if the sender is authorized to operate on the token.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits a {Transfer} event.
*/
function _burn(uint256 tokenId) internal virtual {
address owner = ERC721.ownerOf(tokenId);
_beforeTokenTransfer(owner, address(0), tokenId, 1);
// Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook
owner = ERC721.ownerOf(tokenId);
// Clear approvals
delete _tokenApprovals[tokenId];
unchecked {
// Cannot overflow, as that would require more tokens to be burned/transferred
// out than the owner initially received through minting and transferring in.
_balances[owner] -= 1;
}
delete _owners[tokenId];
emit Transfer(owner, address(0), tokenId);
_afterTokenTransfer(owner, address(0), tokenId, 1);
}
/**
* @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(address from, address to, uint256 tokenId) internal virtual {
require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
require(to != address(0), "ERC721: transfer to the zero address");
_beforeTokenTransfer(from, to, tokenId, 1);
// Check that tokenId was not transferred by `_beforeTokenTransfer` hook
require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
// Clear approvals from the previous owner
delete _tokenApprovals[tokenId];
unchecked {
// `_balances[from]` cannot overflow for the same reason as described in `_burn`:
// `from`'s balance is the number of token held, which is at least one before the current
// transfer.
// `_balances[to]` could overflow in the conditions described in `_mint`. That would require
// all 2**256 token ids to be minted, which in practice is impossible.
_balances[from] -= 1;
_balances[to] += 1;
}
_owners[tokenId] = to;
emit Transfer(from, to, tokenId);
_afterTokenTransfer(from, to, tokenId, 1);
}
/**
* @dev Approve `to` to operate on `tokenId`
*
* Emits an {Approval} event.
*/
function _approve(address to, uint256 tokenId) internal virtual {
_tokenApprovals[tokenId] = to;
emit Approval(ERC721.ownerOf(tokenId), to, tokenId);
}
/**
* @dev Approve `operator` to operate on all of `owner` tokens
*
* Emits an {ApprovalForAll} event.
*/
function _setApprovalForAll(address owner, address operator, bool approved) internal virtual {
require(owner != operator, "ERC721: approve to caller");
_operatorApprovals[owner][operator] = approved;
emit ApprovalForAll(owner, operator, approved);
}
/**
* @dev Reverts if the `tokenId` has not been minted yet.
*/
function _requireMinted(uint256 tokenId) internal view virtual {
require(_exists(tokenId), "ERC721: invalid token ID");
}
/**
* @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(
address from,
address to,
uint256 tokenId,
bytes memory data
) private returns (bool) {
if (to.isContract()) {
try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
return retval == IERC721Receiver.onERC721Received.selector;
} catch (bytes memory reason) {
if (reason.length == 0) {
revert("ERC721: transfer to non ERC721Receiver implementer");
} else {
/// @solidity memory-safe-assembly
assembly {
revert(add(32, reason), mload(reason))
}
}
}
} else {
return true;
}
}
/**
* @dev Hook that is called before any token transfer. This includes minting and burning. If {ERC721Consecutive} is
* used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`.
* - When `from` is zero, the tokens will be minted for `to`.
* - When `to` is zero, ``from``'s tokens will be burned.
* - `from` and `to` are never both zero.
* - `batchSize` is non-zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _beforeTokenTransfer(address from, address to, uint256 firstTokenId, uint256 batchSize) internal virtual {}
/**
* @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is
* used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`.
* - When `from` is zero, the tokens were minted for `to`.
* - When `to` is zero, ``from``'s tokens were burned.
* - `from` and `to` are never both zero.
* - `batchSize` is non-zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _afterTokenTransfer(address from, address to, uint256 firstTokenId, uint256 batchSize) internal virtual {}
/**
* @dev Unsafe write access to the balances, used by extensions that "mint" tokens using an {ownerOf} override.
*
* WARNING: Anyone calling this MUST ensure that the balances remain consistent with the ownership. The invariant
* being that for any address `a` the value returned by `balanceOf(a)` must be equal to the number of tokens such
* that `ownerOf(tokenId)` is `a`.
*/
// solhint-disable-next-line func-name-mixedcase
function __unsafe_increaseBalance(address account, uint256 amount) internal {
_balances[account] += amount;
}
}
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol)
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20 {
/**
* @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);
/**
* @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 `to`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address to, 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 `from` to `to` 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 from, address to, uint256 amount) external returns (bool);
}
// OpenZeppelin Contracts (last updated v4.8.0) (proxy/utils/Initializable.sol)
// OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol)
/**
* @dev Collection of functions related to the address type
*/
library AddressUpgradeable {
/**
* @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
*
* Furthermore, `isContract` will also return true if the target contract within
* the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
* which only has an effect at the end of a transaction.
* ====
*
* [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.
* ====
*/
function isContract(address account) internal view returns (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://consensys.net/diligence/blog/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");
(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 functionCallWithValue(target, data, 0, "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");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, 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) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) private pure {
// 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
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}
/**
* @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
* behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
* external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
* function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
*
* The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
* reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
* case an upgrade adds a module that needs to be initialized.
*
* For example:
*
* [.hljs-theme-light.nopadding]
* ```solidity
* contract MyToken is ERC20Upgradeable {
* function initialize() initializer public {
* __ERC20_init("MyToken", "MTK");
* }
* }
*
* contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
* function initializeV2() reinitializer(2) public {
* __ERC20Permit_init("MyToken");
* }
* }
* ```
*
* TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
* possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
*
* CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
* that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
*
* [CAUTION]
* ====
* Avoid leaving a contract uninitialized.
*
* An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
* contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
* the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
*
* [.hljs-theme-light.nopadding]
* ```
* /// @custom:oz-upgrades-unsafe-allow constructor
* constructor() {
* _disableInitializers();
* }
* ```
* ====
*/
abstract contract Initializable {
/**
* @dev Indicates that the contract has been initialized.
* @custom:oz-retyped-from bool
*/
uint8 private _initialized;
/**
* @dev Indicates that the contract is in the process of being initialized.
*/
bool private _initializing;
/**
* @dev Triggered when the contract has been initialized or reinitialized.
*/
event Initialized(uint8 version);
/**
* @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
* `onlyInitializing` functions can be used to initialize parent contracts.
*
* Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
* constructor.
*
* Emits an {Initialized} event.
*/
modifier initializer() {
bool isTopLevelCall = !_initializing;
require(
(isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
"Initializable: contract is already initialized"
);
_initialized = 1;
if (isTopLevelCall) {
_initializing = true;
}
_;
if (isTopLevelCall) {
_initializing = false;
emit Initialized(1);
}
}
/**
* @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
* contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
* used to initialize parent contracts.
*
* A reinitializer may be used after the original initialization step. This is essential to configure modules that
* are added through upgrades and that require initialization.
*
* When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
* cannot be nested. If one is invoked in the context of another, execution will revert.
*
* Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
* a contract, executing them in the right order is up to the developer or operator.
*
* WARNING: setting the version to 255 will prevent any future reinitialization.
*
* Emits an {Initialized} event.
*/
modifier reinitializer(uint8 version) {
require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
_initialized = version;
_initializing = true;
_;
_initializing = false;
emit Initialized(version);
}
/**
* @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
* {initializer} and {reinitializer} modifiers, directly or indirectly.
*/
modifier onlyInitializing() {
require(_initializing, "Initializable: contract is not initializing");
_;
}
/**
* @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
* Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
* to any version. It is recommended to use this to lock implementation contracts that are designed to be called
* through proxies.
*
* Emits an {Initialized} event the first time it is successfully executed.
*/
function _disableInitializers() internal virtual {
require(!_initializing, "Initializable: contract is initializing");
if (_initialized != type(uint8).max) {
_initialized = type(uint8).max;
emit Initialized(type(uint8).max);
}
}
/**
* @dev Returns the highest version that has been initialized. See {reinitializer}.
*/
function _getInitializedVersion() internal view returns (uint8) {
return _initialized;
}
/**
* @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
*/
function _isInitializing() internal view returns (bool) {
return _initializing;
}
}
// OpenZeppelin Contracts (last updated v4.8.0) (security/ReentrancyGuard.sol)
/**
* @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 ReentrancyGuardUpgradeable is Initializable {
// 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;
function __ReentrancyGuard_init() internal onlyInitializing {
__ReentrancyGuard_init_unchained();
}
function __ReentrancyGuard_init_unchained() internal onlyInitializing {
_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 making it call a
* `private` function that does the actual work.
*/
modifier nonReentrant() {
_nonReentrantBefore();
_;
_nonReentrantAfter();
}
function _nonReentrantBefore() private {
// On the first call to nonReentrant, _status will be _NOT_ENTERED
require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
// Any calls to nonReentrant after this point will fail
_status = _ENTERED;
}
function _nonReentrantAfter() private {
// By storing the original value once again, a refund is triggered (see
// https://eips.ethereum.org/EIPS/eip-2200)
_status = _NOT_ENTERED;
}
/**
* @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
* `nonReentrant` function in the call stack.
*/
function _reentrancyGuardEntered() internal view returns (bool) {
return _status == _ENTERED;
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[49] private __gap;
}
/**
*
* Each instance of a Crowd Financing Contract represents a single campaign with a goal
* of raising funds for a specific purpose. The contract is deployed by the creator through
* the CrowdFinancingV1Factory contract. The creator specifies the recipient address, the
* token to use for payments, the minimum and maximum funding goals, the minimum and maximum
* contribution amounts, and the start and end times.
*
* The campaign is deemed successful if the minimum funding goal is met by the end time, or the
* maximum funding goal is met before the end time.
*
* If the campaign is successful funds can be transferred to the recipient address. If the
* campaign is not successful the funds can be withdrawn by the contributors.
*
* @title Crowd Financing with Optional Yield
* @author Fabric Inc.
*
*/
contract CrowdFinancingV1 is Initializable, ReentrancyGuardUpgradeable, IERC20 {
/// @dev Guard to gate ERC20 specific functions
modifier erc20Only() {
require(_erc20, "erc20 only fn called");
_;
}
/// @dev Guard to gate ETH specific functions
modifier ethOnly() {
require(!_erc20, "ETH only fn called");
_;
}
/// @dev Guard to ensure yields are allowed
modifier yieldGuard(uint256 amount) {
require(_state == State.FUNDED, "Cannot accept payment");
require(amount > 0, "Amount is 0");
_;
}
/// @dev Guard to ensure contributions are allowed
modifier contributionGuard(uint256 amount) {
require(isContributionAllowed(), "Contributions are not allowed");
uint256 total = _contributions[msg.sender] + amount;
require(total >= _minContribution, "Contribution amount is too low");
require(total <= _maxContribution, "Contribution amount is too high");
require(_contributionTotal + amount <= _goalMax, "Contribution amount exceeds max goal");
_;
}
/// @dev Max campaign duration: 90 Days
uint256 private constant MAX_DURATION_SECONDS = 7776000;
/// @dev Min campaign duration: 30 minutes
uint256 private constant MIN_DURATION_SECONDS = 1800;
/// @dev Allow a campaign to be deployed where the start time is up to one minute in the past
uint256 private constant PAST_START_TOLERANCE_SECONDS = 60;
/// @dev Maximum fee basis points
uint16 private constant MAX_FEE_BIPS = 2500;
/// @dev Maximum basis points
uint16 private constant MAX_BIPS = 10_000;
/// @dev Emitted when an account contributions funds to the contract
event Contribution(address indexed account, uint256 numTokens);
/// @dev Emitted when an account withdraws their initial contribution or yield balance
event Withdraw(address indexed account, uint256 numTokens);
/// @dev Emitted when the funds are transferred to the recipient and when
/// fees are transferred to the fee collector, if specified
event TransferContributions(address indexed account, uint256 numTokens);
/// @dev Emitted on processing if time has elapsed and the target was not met
event Fail();
/// @dev Emitted when makePayment is invoked by the recipient
event Payout(address indexed account, uint256 numTokens);
/// @dev A state enum to track the current state of the campaign
enum State {
FUNDING,
FAILED,
FUNDED
}
/// @dev The current state of the contract
State private _state;
/// @dev The address of the recipient in the event of a successful campaign
address private _recipientAddress;
/// @dev The token used for payments (optional)
IERC20 private _token;
/// @dev The minimum funding goal to meet for a successful campaign
uint256 private _goalMin;
/// @dev The maximum funding goal. If this goal is met, funds can be transferred early
uint256 private _goalMax;
/// @dev The minimum tokens an account can contribute
uint256 private _minContribution;
/// @dev The maximum tokens an account can contribute
uint256 private _maxContribution;
/// @dev The start timestamp for the fund
uint256 private _startTimestamp;
/// @dev The end timestamp for the fund
uint256 private _endTimestamp;
/// @dev The total amount contributed by all accounts
uint256 private _contributionTotal;
/// @dev The total amount withdrawn by all accounts
uint256 private _withdrawTotal;
/// @dev The mapping from account to balance (contributions or transfers)
mapping(address => uint256) private _contributions;
/// @dev The mapping from account to withdraws
mapping(address => uint256) private _withdraws;
/// @dev ERC20 allowances
mapping(address => mapping(address => uint256)) private _allowances;
// Fee related items
/// @dev The optional address of the fee recipient
address private _feeRecipient;
/// @dev The fee in basis points, transferred to the fee recipient upon transfer
uint16 private _feeTransferBips;
/// @dev The fee in basis points, used to dilute the cap table upon transfer
uint16 private _feeYieldBips;
/// @dev Track the number of tokens sent via yield calls
uint256 private _yieldTotal;
/// @dev Flag indicating the contract works with ERC20 tokens rather than ETH
bool private _erc20;
/// @dev This contract is intended for use with proxies, so we prevent direct
/// initialization. This contract will fail to function properly without a proxy
constructor() {
_disableInitializers();
}
/**
* @dev Initialize acts as the constructor, as this contract is intended to work with proxy contracts.
*
* @param recipient the address of the recipient, where funds are transferred when conditions are met
* @param minGoal the minimum funding goal for the financing round
* @param maxGoal the maximum funding goal for the financing round
* @param minContribution the minimum contribution an account can make
* @param maxContribution the maximum contribution an account can make
* @param startTimestamp the UNIX time in seconds denoting when contributions can start
* @param endTimestamp the UNIX time in seconds denoting when contributions are no longer allowed
* @param erc20TokenAddr the address of the ERC20 token used for payments, or 0 address for native token (ETH)
* @param feeRecipientAddr the address of the fee recipient, or the 0 address if no fees are collected
* @param feeTransferBips the transfer fee in basis points, collected during the transfer call
* @param feeYieldBips the yield fee in basis points. Dilutes the cap table for the fee recipient.
*/
function initialize(
address recipient,
uint256 minGoal,
uint256 maxGoal,
uint256 minContribution,
uint256 maxContribution,
uint256 startTimestamp,
uint256 endTimestamp,
address erc20TokenAddr,
address feeRecipientAddr,
uint16 feeTransferBips,
uint16 feeYieldBips
) external initializer {
require(recipient != address(0), "Invalid recipient address");
require(startTimestamp + PAST_START_TOLERANCE_SECONDS >= block.timestamp, "Invalid start time");
require(startTimestamp + MIN_DURATION_SECONDS <= endTimestamp, "Invalid time range");
require(
endTimestamp > block.timestamp && (endTimestamp - startTimestamp) < MAX_DURATION_SECONDS, "Invalid end time"
);
require(minGoal > 0, "Min target must be > 0");
require(minGoal <= maxGoal, "Min target must be <= Max");
require(minContribution > 0, "Min contribution must be > 0");
require(minContribution <= maxContribution, "Min contribution must be <= Max");
require(minContribution <= maxGoal, "Min contribution must be <= Target Max");
require(minContribution < (maxGoal - minGoal), "Min contribution must be < (maxGoal - minGoal)");
require(feeTransferBips <= MAX_FEE_BIPS, "Transfer fee too high");
require(feeYieldBips <= MAX_FEE_BIPS, "Yield fee too high");
if (feeRecipientAddr != address(0)) {
require(feeTransferBips > 0 || feeYieldBips > 0, "Fees required when fee recipient is present");
} else {
require(feeTransferBips == 0 && feeYieldBips == 0, "Fees must be 0 when there is no fee recipient");
}
_recipientAddress = recipient;
_goalMin = minGoal;
_goalMax = maxGoal;
_minContribution = minContribution;
_maxContribution = maxContribution;
_startTimestamp = startTimestamp;
_endTimestamp = endTimestamp;
_token = IERC20(erc20TokenAddr);
_erc20 = erc20TokenAddr != address(0);
_feeRecipient = feeRecipientAddr;
_feeTransferBips = feeTransferBips;
_feeYieldBips = feeYieldBips;
_contributionTotal = 0;
_withdrawTotal = 0;
_state = State.FUNDING;
__ReentrancyGuard_init();
}
///////////////////////////////////////////
// Contributions
///////////////////////////////////////////
/**
* @notice Contribute ERC20 tokens into the contract
*
* #### Events
* - Emits a {Contribution} event
*
* #### Requirements
* - `amount` must be within range of min and max contribution for account
* - `amount` must not cause max goal to be exceeded
* - `amount` must be approved for transfer by the caller
* - contributions must be allowed
* - the contract must be configured to work with ERC20 tokens
*
* @param amount the amount of ERC20 tokens to contribute
*
*/
function contributeERC20(uint256 amount) external erc20Only contributionGuard(amount) nonReentrant {
_addContribution(msg.sender, _transferSafe(msg.sender, amount));
}
/**
* @notice Contribute ETH into the contract
*
* #### Events
* - Emits a {Contribution} event
*
* #### Requirements
* - `msg.value` must be within range of min and max contribution for account
* - `msg.value` must not cause max goal to be exceeded
* - contributions must be allowed
* - the contract must be configured to work with ETH
*/
function contributeEth() external payable ethOnly contributionGuard(msg.value) {
_addContribution(msg.sender, msg.value);
}
/**
* @dev Add a contribution to the account and update totals
*
* @param account the account to add the contribution to
* @param amount the amount of the contribution
*/
function _addContribution(address account, uint256 amount) private {
_contributions[account] += amount;
_contributionTotal += amount;
emit Contribution(account, amount);
}
/**
* @return true if contributions are allowed
*/
function isContributionAllowed() public view returns (bool) {
return _state == State.FUNDING && !isGoalMaxMet() && isStarted() && !isEnded();
}
///////////////////////////////////////////
// Transfer
///////////////////////////////////////////
/**
* @return true if the goal was met and funds can be transferred
*/
function isTransferAllowed() public view returns (bool) {
return ((isEnded() && isGoalMinMet()) || isGoalMaxMet()) && _state == State.FUNDING;
}
/**
* @notice Transfer funds to the recipient and change the state
*
* #### Events
* Emits a {TransferContributions} event if the target was met and funds transferred
*/
function transferBalanceToRecipient() external {
require(isTransferAllowed(), "Transfer not allowed");
_state = State.FUNDED;
uint256 feeAmount = calculateTransferFee();
uint256 transferAmount = _contributionTotal - feeAmount;
// This can mutate _contributionTotal, so that withdraws don't over withdraw
allocateYieldFee();
// If any transfer fee is present, pay that out to the fee recipient
if (feeAmount > 0) {
emit TransferContributions(_feeRecipient, feeAmount);
if (_erc20) {
require(_token.transfer(_feeRecipient, feeAmount), "ERC20: Fee transfer failed");
} else {
(bool sent,) = payable(_feeRecipient).call{value: feeAmount}("");
require(sent, "Failed to transfer Ether");
}
}
emit TransferContributions(_recipientAddress, transferAmount);
if (_erc20) {
require(_token.transfer(_recipientAddress, transferAmount), "ERC20: Transfer failed");
} else {
(bool sent,) = payable(_recipientAddress).call{value: transferAmount}("");
require(sent, "Failed to transfer Ether");
}
}
/**
* @dev Dilutes supply by allocating tokens to the fee collector, allowing for
* withdraws of yield
*/
function allocateYieldFee() private returns (uint256) {
if (_feeYieldBips == 0) {
return 0;
}
uint256 feeAllocation = (_contributionTotal * _feeYieldBips) / (MAX_BIPS);
_contributions[_feeRecipient] += feeAllocation;
_contributionTotal += feeAllocation;
return feeAllocation;
}
/**
* @dev Calculates a fee to transfer to the fee collector upon processing
*/
function calculateTransferFee() private view returns (uint256) {
if (_feeTransferBips == 0) {
return 0;
}
return (_contributionTotal * _feeTransferBips) / (MAX_BIPS);
}
/**
* @return true if the minimum goal was met
*/
function isGoalMinMet() public view returns (bool) {
return _contributionTotal >= _goalMin;
}
/**
* @return true if the maximum goal was met
*/
function isGoalMaxMet() public view returns (bool) {
return _contributionTotal >= _goalMax;
}
///////////////////////////////////////////
// Phase 3: Yield / Refunds / Withdraws
///////////////////////////////////////////
/**
* @notice Yield ERC20 tokens to all token holders in proportion to their balance
*
* #### Requirements
* - `amount` must be greater than 0
* - `amount` must be approved for transfer for the contract
*
* #### Events
* - Emits {Payout} event with amount = `amount`
*
* @param amount the amount of tokens to payout
*/
function yieldERC20(uint256 amount) external erc20Only yieldGuard(amount) nonReentrant {
_trackYield(msg.sender, _transferSafe(msg.sender, amount));
}
/**
* @notice Yield ETH to all token holders in proportion to their balance
*
* #### Requirements
* - `msg.value` must be greater than 0
*
* #### Events
* - Emits {Payout} event with amount = `msg.value`
*/
function yieldEth() external payable ethOnly yieldGuard(msg.value) nonReentrant {
_trackYield(msg.sender, msg.value);
}
/**
* @dev Emit a Payout event and increase yield total
*/
function _trackYield(address from, uint256 amount) private {
emit Payout(from, amount);
_yieldTotal += amount;
}
/**
* @return The total amount of tokens/wei paid back by the recipient
*/
function yieldTotal() public view returns (uint256) {
return _yieldTotal;
}
/**
* @param account the address of a contributor or token holder
*
* @return The total tokens withdrawn for a given account
*/
function withdrawsOf(address account) public view returns (uint256) {
return _withdraws[account];
}
/**
* @return true if the contract allows withdraws
*/
function isWithdrawAllowed() public view returns (bool) {
return state() == State.FUNDED || state() == State.FAILED || (isEnded() && !isGoalMinMet());
}
/**
* @return The total amount of tokens paid back to a given contributor
*/
function payoutsMadeTo(address account) private view returns (uint256) {
if (_contributionTotal == 0) {
return 0;
}
return (_contributions[account] * yieldTotal()) / _contributionTotal;
}
/**
* @param account the address of a token holder
*
* @return The withdrawable amount of tokens for a given account, attributable to yield
*/
function yieldBalanceOf(address account) public view returns (uint256) {
return payoutsMadeTo(account) - withdrawsOf(account);
}
/**
* @param account the address of a contributor
*
* @return The total amount of tokens earned by the given account through yield
*/
function yieldTotalOf(address account) public view returns (uint256) {
uint256 _payout = payoutsMadeTo(account);
if (_payout <= _contributions[account]) {
return 0;
}
return _payout - _contributions[account];
}
/**
* @notice Withdraw all available funds to the caller if withdraws are allowed and
* the caller has a contribution balance (failed), or a yield balance (funded)
*
* #### Events
* - Emits a {Withdraw} event with amount = the amount withdrawn
*/
function withdraw() external {
require(isWithdrawAllowed(), "Withdraw not allowed");
// Set the state to failed
if (isEnded() && _state == State.FUNDING && !isGoalMinMet()) {
_state = State.FAILED;
emit Fail();
}
address account = msg.sender;
if (_state == State.FUNDED) {
withdrawYieldBalance(account);
} else {
withdrawContribution(account);
}
}
/**
* @dev Withdraw the initial contribution for the given account
*/
function withdrawContribution(address account) private {
uint256 amount = _contributions[account];
require(amount > 0, "No balance");
_contributions[account] = 0;
emit Withdraw(account, amount);
if (_erc20) {
require(_token.transfer(account, amount), "ERC20 transfer failed");
} else {
(bool sent,) = payable(account).call{value: amount}("");
require(sent, "Failed to transfer Ether");
}
}
/**
* @dev Withdraw the available yield balance for the given account
*/
function withdrawYieldBalance(address account) private {
uint256 amount = yieldBalanceOf(account);
require(amount > 0, "No balance");
_withdraws[account] += amount;
_withdrawTotal += amount;
emit Withdraw(account, amount);
if (_erc20) {
require(_token.transfer(account, amount), "ERC20 transfer failed");
} else {
(bool sent,) = payable(account).call{value: amount}("");
require(sent, "Failed to transfer Ether");
}
}
///////////////////////////////////////////
// Utility Functions
///////////////////////////////////////////
/**
* @dev Token transfer function which leverages allowance. Additionally, it accounts
* for tokens which take fees on transfer. Fetch the balance of this contract
* before and after transfer, to determine the real amount of tokens transferred.
*
* @notice this contract is not compatible with tokens that rebase
*
* @return The amount of tokens transferred after fees
*/
function _transferSafe(address account, uint256 amount) private returns (uint256) {
uint256 allowed = _token.allowance(msg.sender, address(this));
require(amount <= allowed, "Amount exceeds token allowance");
uint256 priorBalance = _token.balanceOf(address(this));
require(_token.transferFrom(account, address(this), amount), "ERC20 transfer failed");
uint256 postBalance = _token.balanceOf(address(this));
return postBalance - priorBalance;
}
///////////////////////////////////////////
// IERC20 Implementation
///////////////////////////////////////////
/**
* @inheritdoc IERC20
* @dev Contributions mint tokens and increase the total supply
*/
function totalSupply() external view returns (uint256) {
return _contributionTotal;
}
/// @inheritdoc IERC20
function balanceOf(address account) external view returns (uint256) {
return _contributions[account];
}
/// @inheritdoc IERC20
function transfer(address to, uint256 amount) external returns (bool) {
_transfer(msg.sender, to, amount);
return true;
}
/**
* See ERC20._transfer
* @dev The primary difference here is that we also need to adjust withdraws
* to prevent over-withdrawal of yield/contribution
*/
function _transfer(address from, address to, uint256 amount) internal virtual {
require(from != address(0), "ERC20: transfer from the zero address");
require(to != address(0), "ERC20: transfer to the zero address");
uint256 fromBalance = _contributions[from];
require(fromBalance >= amount, "ERC20: transfer amount exceeds balance");
unchecked {
_contributions[from] = fromBalance - amount;
// Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by
// decrementing then incrementing.
_contributions[to] += amount;
}
// Transfer partial withdraws to balance payouts
if (_state == State.FUNDED) {
uint256 fromWithdraws = _withdraws[from];
uint256 withdrawAmount = ((fromBalance - amount) * fromWithdraws) / fromBalance;
unchecked {
_withdraws[from] = fromWithdraws - withdrawAmount;
_withdraws[to] += withdrawAmount;
}
}
emit Transfer(from, to, amount);
}
/// @inheritdoc IERC20
function allowance(address owner, address spender) public view returns (uint256) {
return _allowances[owner][spender];
}
/// @inheritdoc IERC20
function approve(address spender, uint256 amount) external returns (bool) {
_approve(msg.sender, spender, amount);
return true;
}
/// See ERC20._spendAllowance
function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {
uint256 currentAllowance = allowance(owner, spender);
if (currentAllowance != type(uint256).max) {
require(currentAllowance >= amount, "ERC20: insufficient allowance");
unchecked {
_approve(owner, spender, currentAllowance - amount);
}
}
}
/// See ERC20._approve
function _approve(address owner, address spender, uint256 amount) internal virtual {
require(owner != address(0), "ERC20: approve from the zero address");
require(spender != address(0), "ERC20: approve to the zero address");
_allowances[owner][spender] = amount;
emit Approval(owner, spender, amount);
}
/// @inheritdoc IERC20
function transferFrom(address from, address to, uint256 amount) external returns (bool) {
address spender = msg.sender;
_spendAllowance(from, spender, amount);
_transfer(from, to, amount);
return true;
}
///////////////////////////////////////////
// Public/External Views
///////////////////////////////////////////
/**
* @dev The values can be 0, indicating the account is not allowed to contribute.
* This method is helpful for preflight checks to ensure the amount is within the range.
*
* @return min The minimum contribution for the account
* @return max The maximum contribution for the account
*/
function contributionRangeFor(address account) external view returns (uint256 min, uint256 max) {
uint256 balance = _contributions[account];
if (balance >= _maxContribution || isGoalMaxMet()) {
return (0, 0);
}
int256 minContribution = int256(_minContribution) - int256(balance);
if (minContribution <= 0) {
minContribution = 1;
}
uint256 remainingGoal = _goalMax - _contributionTotal;
// If the remaining goal is less than the minimum contribution, then the account cannot contribute
// This can lead to a gap between the supply and max goal, but existing contributors can top it off if
// they are anxious to transfer early
if (remainingGoal < uint256(minContribution)) {
return (0, 0);
}
return (uint256(minContribution), Math.min(_maxContribution - balance, remainingGoal));
}
/**
* @return The current state of the campaign
*/
function state() public view returns (State) {
return _state;
}
/**
* @return The minimum allowed contribution of ERC20 tokens or WEI
*/
function minAllowedContribution() external view returns (uint256) {
return _minContribution;
}
/**
* @return The maximum allowed contribution of ERC20 tokens or WEI
*/
function maxAllowedContribution() external view returns (uint256) {
return _maxContribution;
}
/**
* @return The unix timestamp in seconds when the time window for contribution starts
*/
function startsAt() external view returns (uint256) {
return _startTimestamp;
}
/**
* @return true if the time window for contribution has started
*/
function isStarted() public view returns (bool) {
return block.timestamp >= _startTimestamp;
}
/**
* @return The unix timestamp in seconds when the contribution window ends
*/
function endsAt() external view returns (uint256) {
return _endTimestamp;
}
/**
* @return true if the time window for contribution has closed
*/
function isEnded() public view returns (bool) {
return block.timestamp >= _endTimestamp;
}
/**
* @return The address of the recipient
*/
function recipientAddress() external view returns (address) {
return _recipientAddress;
}
/**
* @return true if the contract is ETH denominated
*/
function isEthDenominated() public view returns (bool) {
return !_erc20;
}
/**
* @return The address of the ERC20 Token, or 0x0 if ETH
*/
function erc20Address() external view returns (address) {
return address(_token);
}
/**
* @return The minimum goal amount as ERC20 tokens or WEI
*/
function goalMin() external view returns (uint256) {
return _goalMin;
}
/**
* @return The maximum goal amount as ERC20 tokens or WEI
*/
function goalMax() external view returns (uint256) {
return _goalMax;
}
/**
* @return The transfer fee as basis points
*/
function transferFeeBips() external view returns (uint16) {
return _feeTransferBips;
}
/**
* @return The yield fee as basis points
*/
function yieldFeeBips() external view returns (uint16) {
return _feeYieldBips;
}
/**
* @return The address where the fees are transferred to, or 0x0 if no fees are collected
*/
function feeRecipientAddress() external view returns (address) {
return _feeRecipient;
}
}
/**
*
* @title DataQuilt NFT Contract for Fabric Campaigns
* @author Fabric Inc.
*
* ERC721 + Metadata, with custom minting functions for accounts which contributed to
* a Fabric campaign.
*
*/
contract DataQuiltRegistryV1 is ERC721 {
/// @dev Base URI for which we generate URIs for NFTs
string private _baseUri;
/// @dev Campaign specific double mint guard
mapping(address => mapping(address => bool)) private _campaignMints;
/**
* @param name the name of the token
* @param symbol the symbol of hte token
* @param baseUri the base URI, such as: `https://somehost.com/`
*/
constructor(string memory name, string memory symbol, string memory baseUri) ERC721(name, symbol) {
_baseUri = baseUri;
}
/**
* @dev Mint a contribution token using a tokenId, which encodes the campaign address and pattern configuration
*
* @param tokenId the id of the token, which is an abi packed [campaign address, uint64(0), uint32(variant)]
*/
function mint(uint256 tokenId) external {
address account = msg.sender;
address campaignAddress = address(uint160(tokenId >> 96));
require(canMint(campaignAddress, msg.sender), "Err: already minted or contribution not found");
_safeMint(account, tokenId);
_campaignMints[campaignAddress][account] = true;
}
/**
* @dev Check if an account can mint a token for a campaign
*
* @param campaignAddress the address of the campaign
* @param account the account to check
*
* @return true if the account can mint a token for the campaign
*/
function canMint(address campaignAddress, address account) public view returns (bool) {
if (_campaignMints[campaignAddress][account]) {
return false;
}
// Is it possible to verify this is a CFV1 contract?
return CrowdFinancingV1(payable(campaignAddress)).balanceOf(account) > 0;
}
/**
* @dev See {IERC721Metadata-tokenURI}.
*/
function _baseURI() internal view override returns (string memory) {
return _baseUri;
}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"string","name":"baseUri","type":"string"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"campaignAddress","type":"address"},{"internalType":"address","name":"account","type":"address"}],"name":"canMint","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
60806040523480156200001157600080fd5b50604051620017c3380380620017c3833981016040819052620000349162000135565b8282600062000044838262000255565b50600162000053828262000255565b5060069150620000669050828262000255565b5050505062000321565b634e487b7160e01b600052604160045260246000fd5b600082601f8301126200009857600080fd5b81516001600160401b0380821115620000b557620000b562000070565b604051601f8301601f19908116603f01168101908282118183101715620000e057620000e062000070565b81604052838152602092508683858801011115620000fd57600080fd5b600091505b8382101562000121578582018301518183018401529082019062000102565b600093810190920192909252949350505050565b6000806000606084860312156200014b57600080fd5b83516001600160401b03808211156200016357600080fd5b620001718783880162000086565b945060208601519150808211156200018857600080fd5b620001968783880162000086565b93506040860151915080821115620001ad57600080fd5b50620001bc8682870162000086565b9150509250925092565b600181811c90821680620001db57607f821691505b602082108103620001fc57634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156200025057600081815260208120601f850160051c810160208610156200022b5750805b601f850160051c820191505b818110156200024c5782815560010162000237565b5050505b505050565b81516001600160401b0381111562000271576200027162000070565b6200028981620002828454620001c6565b8462000202565b602080601f831160018114620002c15760008415620002a85750858301515b600019600386901b1c1916600185901b1785556200024c565b600085815260208120601f198616915b82811015620002f257888601518255948401946001909101908401620002d1565b5085821015620003115787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b61149280620003316000396000f3fe608060405234801561001057600080fd5b50600436106100f55760003560e01c806370a0823111610097578063b88d4fde11610066578063b88d4fde146101ff578063c87b56dd14610212578063e09276ba14610225578063e985e9c51461023857600080fd5b806370a08231146101b057806395d89b41146101d1578063a0712d68146101d9578063a22cb465146101ec57600080fd5b8063095ea7b3116100d3578063095ea7b31461016257806323b872dd1461017757806342842e0e1461018a5780636352211e1461019d57600080fd5b806301ffc9a7146100fa57806306fdde0314610122578063081812fc14610137575b600080fd5b61010d610108366004611005565b610274565b60405190151581526020015b60405180910390f35b61012a6102c6565b6040516101199190611072565b61014a610145366004611085565b610358565b6040516001600160a01b039091168152602001610119565b6101756101703660046110ba565b61037f565b005b6101756101853660046110e4565b610499565b6101756101983660046110e4565b6104ca565b61014a6101ab366004611085565b6104e5565b6101c36101be366004611120565b610545565b604051908152602001610119565b61012a6105cb565b6101756101e7366004611085565b6105da565b6101756101fa36600461113b565b61068c565b61017561020d36600461118d565b61069b565b61012a610220366004611085565b6106d3565b61010d610233366004611269565b61073a565b61010d610246366004611269565b6001600160a01b03918216600090815260056020908152604080832093909416825291909152205460ff1690565b60006001600160e01b031982166380ac58cd60e01b14806102a557506001600160e01b03198216635b5e139f60e01b145b806102c057506301ffc9a760e01b6001600160e01b03198316145b92915050565b6060600080546102d59061129c565b80601f01602080910402602001604051908101604052809291908181526020018280546103019061129c565b801561034e5780601f106103235761010080835404028352916020019161034e565b820191906000526020600020905b81548152906001019060200180831161033157829003601f168201915b5050505050905090565b6000610363826107e8565b506000908152600460205260409020546001600160a01b031690565b600061038a826104e5565b9050806001600160a01b0316836001600160a01b0316036103fc5760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b60648201526084015b60405180910390fd5b336001600160a01b038216148061041857506104188133610246565b61048a5760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c00000060648201526084016103f3565b610494838361084a565b505050565b6104a333826108b8565b6104bf5760405162461bcd60e51b81526004016103f3906112d6565b610494838383610937565b6104948383836040518060200160405280600081525061069b565b6000818152600260205260408120546001600160a01b0316806102c05760405162461bcd60e51b8152602060048201526018602482015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b60448201526064016103f3565b60006001600160a01b0382166105af5760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b60648201526084016103f3565b506001600160a01b031660009081526003602052604090205490565b6060600180546102d59061129c565b33606082901c6105ea818361073a565b61064c5760405162461bcd60e51b815260206004820152602d60248201527f4572723a20616c7265616479206d696e746564206f7220636f6e74726962757460448201526c1a5bdb881b9bdd08199bdd5b99609a1b60648201526084016103f3565b6106568284610a9b565b6001600160a01b039081166000908152600760209081526040808320949093168252929092529020805460ff1916600117905550565b610697338383610ab5565b5050565b6106a533836108b8565b6106c15760405162461bcd60e51b81526004016103f3906112d6565b6106cd84848484610b83565b50505050565b60606106de826107e8565b60006106e8610bb6565b905060008151116107085760405180602001604052806000815250610733565b8061071284610bc5565b604051602001610723929190611323565b6040516020818303038152906040525b9392505050565b6001600160a01b03808316600090815260076020908152604080832093851683529290529081205460ff1615610772575060006102c0565b6040516370a0823160e01b81526001600160a01b038381166004830152600091908516906370a0823190602401602060405180830381865afa1580156107bc573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107e09190611352565b119392505050565b6000818152600260205260409020546001600160a01b03166108475760405162461bcd60e51b8152602060048201526018602482015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b60448201526064016103f3565b50565b600081815260046020526040902080546001600160a01b0319166001600160a01b038416908117909155819061087f826104e5565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b6000806108c4836104e5565b9050806001600160a01b0316846001600160a01b0316148061090b57506001600160a01b0380821660009081526005602090815260408083209388168352929052205460ff165b8061092f5750836001600160a01b031661092484610358565b6001600160a01b0316145b949350505050565b826001600160a01b031661094a826104e5565b6001600160a01b0316146109705760405162461bcd60e51b81526004016103f39061136b565b6001600160a01b0382166109d25760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b60648201526084016103f3565b826001600160a01b03166109e5826104e5565b6001600160a01b031614610a0b5760405162461bcd60e51b81526004016103f39061136b565b600081815260046020908152604080832080546001600160a01b03199081169091556001600160a01b0387811680865260038552838620805460001901905590871680865283862080546001019055868652600290945282852080549092168417909155905184937fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef91a4505050565b610697828260405180602001604052806000815250610c58565b816001600160a01b0316836001600160a01b031603610b165760405162461bcd60e51b815260206004820152601960248201527f4552433732313a20617070726f766520746f2063616c6c65720000000000000060448201526064016103f3565b6001600160a01b03838116600081815260056020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b610b8e848484610937565b610b9a84848484610c8b565b6106cd5760405162461bcd60e51b81526004016103f3906113b0565b6060600680546102d59061129c565b60606000610bd283610d8c565b600101905060008167ffffffffffffffff811115610bf257610bf2611177565b6040519080825280601f01601f191660200182016040528015610c1c576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a8504945084610c2657509392505050565b610c628383610e64565b610c6f6000848484610c8b565b6104945760405162461bcd60e51b81526004016103f3906113b0565b60006001600160a01b0384163b15610d8157604051630a85bd0160e11b81526001600160a01b0385169063150b7a0290610ccf903390899088908890600401611402565b6020604051808303816000875af1925050508015610d0a575060408051601f3d908101601f19168201909252610d079181019061143f565b60015b610d67573d808015610d38576040519150601f19603f3d011682016040523d82523d6000602084013e610d3d565b606091505b508051600003610d5f5760405162461bcd60e51b81526004016103f3906113b0565b805181602001fd5b6001600160e01b031916630a85bd0160e11b14905061092f565b506001949350505050565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b8310610dcb5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef81000000008310610df7576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc100008310610e1557662386f26fc10000830492506010015b6305f5e1008310610e2d576305f5e100830492506008015b6127108310610e4157612710830492506004015b60648310610e53576064830492506002015b600a83106102c05760010192915050565b6001600160a01b038216610eba5760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f206164647265737360448201526064016103f3565b6000818152600260205260409020546001600160a01b031615610f1f5760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e7465640000000060448201526064016103f3565b6000818152600260205260409020546001600160a01b031615610f845760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e7465640000000060448201526064016103f3565b6001600160a01b038216600081815260036020908152604080832080546001019055848352600290915280822080546001600160a01b0319168417905551839291907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a45050565b6001600160e01b03198116811461084757600080fd5b60006020828403121561101757600080fd5b813561073381610fef565b60005b8381101561103d578181015183820152602001611025565b50506000910152565b6000815180845261105e816020860160208601611022565b601f01601f19169290920160200192915050565b6020815260006107336020830184611046565b60006020828403121561109757600080fd5b5035919050565b80356001600160a01b03811681146110b557600080fd5b919050565b600080604083850312156110cd57600080fd5b6110d68361109e565b946020939093013593505050565b6000806000606084860312156110f957600080fd5b6111028461109e565b92506111106020850161109e565b9150604084013590509250925092565b60006020828403121561113257600080fd5b6107338261109e565b6000806040838503121561114e57600080fd5b6111578361109e565b91506020830135801515811461116c57600080fd5b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b600080600080608085870312156111a357600080fd5b6111ac8561109e565b93506111ba6020860161109e565b925060408501359150606085013567ffffffffffffffff808211156111de57600080fd5b818701915087601f8301126111f257600080fd5b81358181111561120457611204611177565b604051601f8201601f19908116603f0116810190838211818310171561122c5761122c611177565b816040528281528a602084870101111561124557600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b6000806040838503121561127c57600080fd5b6112858361109e565b91506112936020840161109e565b90509250929050565b600181811c908216806112b057607f821691505b6020821081036112d057634e487b7160e01b600052602260045260246000fd5b50919050565b6020808252602d908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526c1c881bdc88185c1c1c9bdd9959609a1b606082015260800190565b60008351611335818460208801611022565b835190830190611349818360208801611022565b01949350505050565b60006020828403121561136457600080fd5b5051919050565b60208082526025908201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060408201526437bbb732b960d91b606082015260800190565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b6001600160a01b038581168252841660208201526040810183905260806060820181905260009061143590830184611046565b9695505050505050565b60006020828403121561145157600080fd5b815161073381610fef56fea264697066735822122090cfe4befb9a372055cde3df78109415770e8b746d9c58b6599b60a04f8842cb64736f6c63430008110033000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000000000001146616272696320446174617175696c747300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000034644510000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c68747470733a2f2f6e66742e776974686661627269632e78797a2f646174617175696c742f6d6574612f312f0000000000000000000000000000000000000000
Deployed Bytecode
0x608060405234801561001057600080fd5b50600436106100f55760003560e01c806370a0823111610097578063b88d4fde11610066578063b88d4fde146101ff578063c87b56dd14610212578063e09276ba14610225578063e985e9c51461023857600080fd5b806370a08231146101b057806395d89b41146101d1578063a0712d68146101d9578063a22cb465146101ec57600080fd5b8063095ea7b3116100d3578063095ea7b31461016257806323b872dd1461017757806342842e0e1461018a5780636352211e1461019d57600080fd5b806301ffc9a7146100fa57806306fdde0314610122578063081812fc14610137575b600080fd5b61010d610108366004611005565b610274565b60405190151581526020015b60405180910390f35b61012a6102c6565b6040516101199190611072565b61014a610145366004611085565b610358565b6040516001600160a01b039091168152602001610119565b6101756101703660046110ba565b61037f565b005b6101756101853660046110e4565b610499565b6101756101983660046110e4565b6104ca565b61014a6101ab366004611085565b6104e5565b6101c36101be366004611120565b610545565b604051908152602001610119565b61012a6105cb565b6101756101e7366004611085565b6105da565b6101756101fa36600461113b565b61068c565b61017561020d36600461118d565b61069b565b61012a610220366004611085565b6106d3565b61010d610233366004611269565b61073a565b61010d610246366004611269565b6001600160a01b03918216600090815260056020908152604080832093909416825291909152205460ff1690565b60006001600160e01b031982166380ac58cd60e01b14806102a557506001600160e01b03198216635b5e139f60e01b145b806102c057506301ffc9a760e01b6001600160e01b03198316145b92915050565b6060600080546102d59061129c565b80601f01602080910402602001604051908101604052809291908181526020018280546103019061129c565b801561034e5780601f106103235761010080835404028352916020019161034e565b820191906000526020600020905b81548152906001019060200180831161033157829003601f168201915b5050505050905090565b6000610363826107e8565b506000908152600460205260409020546001600160a01b031690565b600061038a826104e5565b9050806001600160a01b0316836001600160a01b0316036103fc5760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b60648201526084015b60405180910390fd5b336001600160a01b038216148061041857506104188133610246565b61048a5760405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c00000060648201526084016103f3565b610494838361084a565b505050565b6104a333826108b8565b6104bf5760405162461bcd60e51b81526004016103f3906112d6565b610494838383610937565b6104948383836040518060200160405280600081525061069b565b6000818152600260205260408120546001600160a01b0316806102c05760405162461bcd60e51b8152602060048201526018602482015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b60448201526064016103f3565b60006001600160a01b0382166105af5760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b60648201526084016103f3565b506001600160a01b031660009081526003602052604090205490565b6060600180546102d59061129c565b33606082901c6105ea818361073a565b61064c5760405162461bcd60e51b815260206004820152602d60248201527f4572723a20616c7265616479206d696e746564206f7220636f6e74726962757460448201526c1a5bdb881b9bdd08199bdd5b99609a1b60648201526084016103f3565b6106568284610a9b565b6001600160a01b039081166000908152600760209081526040808320949093168252929092529020805460ff1916600117905550565b610697338383610ab5565b5050565b6106a533836108b8565b6106c15760405162461bcd60e51b81526004016103f3906112d6565b6106cd84848484610b83565b50505050565b60606106de826107e8565b60006106e8610bb6565b905060008151116107085760405180602001604052806000815250610733565b8061071284610bc5565b604051602001610723929190611323565b6040516020818303038152906040525b9392505050565b6001600160a01b03808316600090815260076020908152604080832093851683529290529081205460ff1615610772575060006102c0565b6040516370a0823160e01b81526001600160a01b038381166004830152600091908516906370a0823190602401602060405180830381865afa1580156107bc573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107e09190611352565b119392505050565b6000818152600260205260409020546001600160a01b03166108475760405162461bcd60e51b8152602060048201526018602482015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b60448201526064016103f3565b50565b600081815260046020526040902080546001600160a01b0319166001600160a01b038416908117909155819061087f826104e5565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b6000806108c4836104e5565b9050806001600160a01b0316846001600160a01b0316148061090b57506001600160a01b0380821660009081526005602090815260408083209388168352929052205460ff165b8061092f5750836001600160a01b031661092484610358565b6001600160a01b0316145b949350505050565b826001600160a01b031661094a826104e5565b6001600160a01b0316146109705760405162461bcd60e51b81526004016103f39061136b565b6001600160a01b0382166109d25760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b60648201526084016103f3565b826001600160a01b03166109e5826104e5565b6001600160a01b031614610a0b5760405162461bcd60e51b81526004016103f39061136b565b600081815260046020908152604080832080546001600160a01b03199081169091556001600160a01b0387811680865260038552838620805460001901905590871680865283862080546001019055868652600290945282852080549092168417909155905184937fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef91a4505050565b610697828260405180602001604052806000815250610c58565b816001600160a01b0316836001600160a01b031603610b165760405162461bcd60e51b815260206004820152601960248201527f4552433732313a20617070726f766520746f2063616c6c65720000000000000060448201526064016103f3565b6001600160a01b03838116600081815260056020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b610b8e848484610937565b610b9a84848484610c8b565b6106cd5760405162461bcd60e51b81526004016103f3906113b0565b6060600680546102d59061129c565b60606000610bd283610d8c565b600101905060008167ffffffffffffffff811115610bf257610bf2611177565b6040519080825280601f01601f191660200182016040528015610c1c576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a8504945084610c2657509392505050565b610c628383610e64565b610c6f6000848484610c8b565b6104945760405162461bcd60e51b81526004016103f3906113b0565b60006001600160a01b0384163b15610d8157604051630a85bd0160e11b81526001600160a01b0385169063150b7a0290610ccf903390899088908890600401611402565b6020604051808303816000875af1925050508015610d0a575060408051601f3d908101601f19168201909252610d079181019061143f565b60015b610d67573d808015610d38576040519150601f19603f3d011682016040523d82523d6000602084013e610d3d565b606091505b508051600003610d5f5760405162461bcd60e51b81526004016103f3906113b0565b805181602001fd5b6001600160e01b031916630a85bd0160e11b14905061092f565b506001949350505050565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b8310610dcb5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef81000000008310610df7576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc100008310610e1557662386f26fc10000830492506010015b6305f5e1008310610e2d576305f5e100830492506008015b6127108310610e4157612710830492506004015b60648310610e53576064830492506002015b600a83106102c05760010192915050565b6001600160a01b038216610eba5760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f206164647265737360448201526064016103f3565b6000818152600260205260409020546001600160a01b031615610f1f5760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e7465640000000060448201526064016103f3565b6000818152600260205260409020546001600160a01b031615610f845760405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e7465640000000060448201526064016103f3565b6001600160a01b038216600081815260036020908152604080832080546001019055848352600290915280822080546001600160a01b0319168417905551839291907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a45050565b6001600160e01b03198116811461084757600080fd5b60006020828403121561101757600080fd5b813561073381610fef565b60005b8381101561103d578181015183820152602001611025565b50506000910152565b6000815180845261105e816020860160208601611022565b601f01601f19169290920160200192915050565b6020815260006107336020830184611046565b60006020828403121561109757600080fd5b5035919050565b80356001600160a01b03811681146110b557600080fd5b919050565b600080604083850312156110cd57600080fd5b6110d68361109e565b946020939093013593505050565b6000806000606084860312156110f957600080fd5b6111028461109e565b92506111106020850161109e565b9150604084013590509250925092565b60006020828403121561113257600080fd5b6107338261109e565b6000806040838503121561114e57600080fd5b6111578361109e565b91506020830135801515811461116c57600080fd5b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b600080600080608085870312156111a357600080fd5b6111ac8561109e565b93506111ba6020860161109e565b925060408501359150606085013567ffffffffffffffff808211156111de57600080fd5b818701915087601f8301126111f257600080fd5b81358181111561120457611204611177565b604051601f8201601f19908116603f0116810190838211818310171561122c5761122c611177565b816040528281528a602084870101111561124557600080fd5b82602086016020830137600060208483010152809550505050505092959194509250565b6000806040838503121561127c57600080fd5b6112858361109e565b91506112936020840161109e565b90509250929050565b600181811c908216806112b057607f821691505b6020821081036112d057634e487b7160e01b600052602260045260246000fd5b50919050565b6020808252602d908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526c1c881bdc88185c1c1c9bdd9959609a1b606082015260800190565b60008351611335818460208801611022565b835190830190611349818360208801611022565b01949350505050565b60006020828403121561136457600080fd5b5051919050565b60208082526025908201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060408201526437bbb732b960d91b606082015260800190565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b6001600160a01b038581168252841660208201526040810183905260806060820181905260009061143590830184611046565b9695505050505050565b60006020828403121561145157600080fd5b815161073381610fef56fea264697066735822122090cfe4befb9a372055cde3df78109415770e8b746d9c58b6599b60a04f8842cb64736f6c63430008110033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000000000001146616272696320446174617175696c747300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000034644510000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c68747470733a2f2f6e66742e776974686661627269632e78797a2f646174617175696c742f6d6574612f312f0000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : name (string): Fabric Dataquilts
Arg [1] : symbol (string): FDQ
Arg [2] : baseUri (string): https://nft.withfabric.xyz/dataquilt/meta/1/
-----Encoded View---------------
10 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000060
Arg [1] : 00000000000000000000000000000000000000000000000000000000000000a0
Arg [2] : 00000000000000000000000000000000000000000000000000000000000000e0
Arg [3] : 0000000000000000000000000000000000000000000000000000000000000011
Arg [4] : 46616272696320446174617175696c7473000000000000000000000000000000
Arg [5] : 0000000000000000000000000000000000000000000000000000000000000003
Arg [6] : 4644510000000000000000000000000000000000000000000000000000000000
Arg [7] : 000000000000000000000000000000000000000000000000000000000000002c
Arg [8] : 68747470733a2f2f6e66742e776974686661627269632e78797a2f6461746171
Arg [9] : 75696c742f6d6574612f312f0000000000000000000000000000000000000000
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A token is a representation of an on-chain or off-chain asset. The token page shows information such as price, total supply, holders, transfers and social links. Learn more about this page in our Knowledge Base.