Token
Polygon Sponsored slots available. Book your slot here!
Overview ERC-1155
Total Supply:
0 N/A
Holders:
721,534 addresses
Contract:
Balance
0 N/A
[ Download CSV Export ]
# | Exchange | Pair | Price | 24H Volume | % Volume |
---|
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Similar Match Source Code
Note: This contract matches the deployed ByteCode of the Source Code for Contract 0xAfB5643B6169cB5d7358362461532e88da90a88E
Contract Name:
LazyMintERC1155
Compiler Version
v0.8.9+commit.e5eed63a
Optimization Enabled:
Yes with 800 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: Apache-2.0 pragma solidity ^0.8.0; // Interface import { ILazyMintERC1155 } from "./ILazyMintERC1155.sol"; // Token import "@openzeppelin/contracts/token/ERC1155/ERC1155.sol"; // Protocol control center. import { ProtocolControl } from "../../ProtocolControl.sol"; // Royalties import "@openzeppelin/contracts/interfaces/IERC2981.sol"; // Access Control + security import "@openzeppelin/contracts/security/ReentrancyGuard.sol"; import "@openzeppelin/contracts/access/AccessControlEnumerable.sol"; // Meta transactions import "@openzeppelin/contracts/metatx/ERC2771Context.sol"; // Utils import "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol"; import "@openzeppelin/contracts/utils/Multicall.sol"; import "@openzeppelin/contracts/utils/Strings.sol"; // Helper interfaces import { IWETH } from "../../interfaces/IWETH.sol"; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; contract LazyMintERC1155 is ILazyMintERC1155, ERC1155, ERC2771Context, IERC2981, AccessControlEnumerable, ReentrancyGuard, Multicall { using Strings for uint256; /// @dev Only TRANSFER_ROLE holders can have tokens transferred from or to them, during restricted transfers. bytes32 public constant TRANSFER_ROLE = keccak256("TRANSFER_ROLE"); /// @dev Only MINTER_ROLE holders can lazy mint NFTs (i.e. can call functions prefixed with `lazyMint`). bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE"); /// @dev The address interpreted as native token of the chain. address public constant NATIVE_TOKEN = 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE; /// @dev The address of the native token wrapper contract. address public immutable nativeTokenWrapper; /// @dev Owner of the contract (purpose: OpenSea compatibility, etc.) address private _owner; /// @dev The adress that receives all primary sales value. address public defaultSaleRecipient; /// @dev The next token ID of the NFT to "lazy mint". uint256 public nextTokenIdToMint; /// @dev Contract interprets 10_000 as 100%. uint64 private constant MAX_BPS = 10_000; /// @dev The % of secondary sales collected as royalties. See EIP 2981. uint64 public royaltyBps; /// @dev The % of primary sales collected by the contract as fees. uint120 public feeBps; /// @dev Whether transfers on tokens are restricted. bool public transfersRestricted; /// @dev Contract level metadata. string public contractURI; /// @dev The protocol control center. ProtocolControl internal controlCenter; uint256[] private baseURIIndices; /// @dev End token Id => URI that overrides `baseURI + tokenId` convention. mapping(uint256 => string) private baseURI; /// @dev Token ID => total circulating supply of tokens with that ID. mapping(uint256 => uint256) public totalSupply; /// @dev Token ID => public claim conditions for tokens with that ID. mapping(uint256 => ClaimConditions) public claimConditions; /// @dev Token ID => the address of the recipient of primary sales. mapping(uint256 => address) public saleRecipient; /// @dev Checks whether caller has DEFAULT_ADMIN_ROLE on the protocol control center. modifier onlyProtocolAdmin() { require(controlCenter.hasRole(controlCenter.DEFAULT_ADMIN_ROLE(), _msgSender()), "not protocol admin."); _; } /// @dev Checks whether caller has DEFAULT_ADMIN_ROLE. modifier onlyModuleAdmin() { require(hasRole(DEFAULT_ADMIN_ROLE, _msgSender()), "not module admin."); _; } /// @dev Checks whether caller has MINTER_ROLE. modifier onlyMinter() { require(hasRole(MINTER_ROLE, _msgSender()), "not minter."); _; } constructor( string memory _contractURI, address payable _controlCenter, address _trustedForwarder, address _nativeTokenWrapper, address _saleRecipient, uint128 _royaltyBps, uint128 _feeBps ) ERC1155("") ERC2771Context(_trustedForwarder) { controlCenter = ProtocolControl(_controlCenter); nativeTokenWrapper = _nativeTokenWrapper; defaultSaleRecipient = _saleRecipient; contractURI = _contractURI; royaltyBps = uint64(_royaltyBps); feeBps = uint120(_feeBps); address deployer = _msgSender(); _owner = deployer; _setupRole(DEFAULT_ADMIN_ROLE, deployer); _setupRole(MINTER_ROLE, deployer); _setupRole(TRANSFER_ROLE, deployer); } /// ===== Public functions ===== /** * @dev Returns the address of the current owner. */ function owner() public view returns (address) { return hasRole(DEFAULT_ADMIN_ROLE, _owner) ? _owner : address(0); } /// @dev Returns the URI for a given tokenId. function uri(uint256 _tokenId) public view override returns (string memory _tokenURI) { for (uint256 i = 0; i < baseURIIndices.length; i += 1) { if (_tokenId < baseURIIndices[i]) { return string(abi.encodePacked(baseURI[baseURIIndices[i]], _tokenId.toString())); } } return ""; } /// @dev Returns the URI for a given tokenId. function tokenURI(uint256 _tokenId) public view returns (string memory _tokenURI) { return uri(_tokenId); } /// @dev At any given moment, returns the uid for the active mint condition for a given tokenId. function getIndexOfActiveCondition(uint256 _tokenId) public view returns (uint256) { uint256 totalConditionCount = claimConditions[_tokenId].totalConditionCount; require(totalConditionCount > 0, "no public mint condition."); for (uint256 i = totalConditionCount; i > 0; i -= 1) { if (block.timestamp >= claimConditions[_tokenId].claimConditionAtIndex[i - 1].startTimestamp) { return i - 1; } } revert("no active mint condition."); } /// ===== External functions ===== /** * @dev Lets an account with `MINTER_ROLE` mint tokens of ID from `nextTokenIdToMint` * to `nextTokenIdToMint + _amount - 1`. The URIs for these tokenIds is baseURI + `${tokenId}`. */ function lazyMint(uint256 _amount, string calldata _baseURIForTokens) external onlyMinter { uint256 startId = nextTokenIdToMint; uint256 baseURIIndex = startId + _amount; nextTokenIdToMint = baseURIIndex; baseURI[baseURIIndex] = _baseURIForTokens; baseURIIndices.push(baseURIIndex); emit LazyMintedTokens(startId, startId + _amount - 1, _baseURIForTokens); } /// @dev Lets an account claim a given quantity of tokens, of a single tokenId. function claim( uint256 _tokenId, uint256 _quantity, bytes32[] calldata _proofs ) external payable nonReentrant { // Get the claim conditions. uint256 activeConditionIndex = getIndexOfActiveCondition(_tokenId); ClaimCondition memory condition = claimConditions[_tokenId].claimConditionAtIndex[activeConditionIndex]; // Verify claim validity. If not valid, revert. verifyClaimIsValid(_tokenId, _quantity, _proofs, activeConditionIndex, condition); // If there's a price, collect price. collectClaimPrice(condition, _quantity, _tokenId); // Mint the relevant tokens to claimer. transferClaimedTokens(activeConditionIndex, _tokenId, _quantity); emit ClaimedTokens(activeConditionIndex, _tokenId, _msgSender(), _quantity); } // @dev Lets a module admin update mint conditions without resetting the restrictions. function updateClaimConditions(uint256 _tokenId, ClaimCondition[] calldata _conditions) external onlyModuleAdmin { resetClaimConditions(_tokenId, _conditions); emit NewClaimConditions(_tokenId, _conditions); } /// @dev Lets a module admin set mint conditions. function setClaimConditions(uint256 _tokenId, ClaimCondition[] calldata _conditions) external onlyModuleAdmin { uint256 numOfConditionsSet = resetClaimConditions(_tokenId, _conditions); resetTimestampRestriction(_tokenId, numOfConditionsSet); emit NewClaimConditions(_tokenId, _conditions); } /// @dev See EIP 2981 function royaltyInfo(uint256, uint256 salePrice) external view virtual override returns (address receiver, uint256 royaltyAmount) { receiver = controlCenter.getRoyaltyTreasury(address(this)); royaltyAmount = (salePrice * royaltyBps) / MAX_BPS; } // ===== Setter functions ===== /// @dev Lets a module admin set the default recipient of all primary sales. function setDefaultSaleRecipient(address _saleRecipient) external onlyModuleAdmin { defaultSaleRecipient = _saleRecipient; emit NewSaleRecipient(_saleRecipient, type(uint256).max, true); } /// @dev Lets a module admin set the recipient of all primary sales for a given token ID. function setSaleRecipient(uint256 _tokenId, address _saleRecipient) external onlyModuleAdmin { saleRecipient[_tokenId] = _saleRecipient; emit NewSaleRecipient(_saleRecipient, _tokenId, false); } /// @dev Lets a module admin update the royalties paid on secondary token sales. function setRoyaltyBps(uint256 _royaltyBps) public onlyModuleAdmin { require(_royaltyBps <= MAX_BPS, "bps <= 10000."); royaltyBps = uint64(_royaltyBps); emit RoyaltyUpdated(_royaltyBps); } /// @dev Lets a module admin update the fees on primary sales. function setFeeBps(uint256 _feeBps) public onlyModuleAdmin { require(_feeBps <= MAX_BPS, "bps <= 10000."); feeBps = uint120(_feeBps); emit PrimarySalesFeeUpdates(_feeBps); } /// @dev Lets a module admin restrict token transfers. function setRestrictedTransfer(bool _restrictedTransfer) external onlyModuleAdmin { transfersRestricted = _restrictedTransfer; emit TransfersRestricted(_restrictedTransfer); } /// @dev Lets a module admin set a new owner for the contract. The new owner must be a module admin. function setOwner(address _newOwner) external onlyModuleAdmin { require(hasRole(DEFAULT_ADMIN_ROLE, _newOwner), "new owner not module admin."); address _prevOwner = _owner; _owner = _newOwner; emit NewOwner(_prevOwner, _newOwner); } /// @dev Lets a module admin set the URI for contract-level metadata. function setContractURI(string calldata _uri) external onlyModuleAdmin { contractURI = _uri; } // ===== Getter functions ===== /// @dev Returns the current active mint condition for a given tokenId. function getTimestampForNextValidClaim( uint256 _tokenId, uint256 _index, address _claimer ) public view returns (uint256 nextValidTimestampForClaim) { uint256 timestampIndex = _index + claimConditions[_tokenId].timstampLimitIndex; uint256 timestampOfLastClaim = claimConditions[_tokenId].timestampOfLastClaim[_claimer][timestampIndex]; unchecked { nextValidTimestampForClaim = timestampOfLastClaim + claimConditions[_tokenId].claimConditionAtIndex[_index].waitTimeInSecondsBetweenClaims; if (nextValidTimestampForClaim < timestampOfLastClaim) { nextValidTimestampForClaim = type(uint256).max; } } } /// @dev Returns the mint condition for a given tokenId, at the given index. function getClaimConditionAtIndex(uint256 _tokenId, uint256 _index) external view returns (ClaimCondition memory mintCondition) { mintCondition = claimConditions[_tokenId].claimConditionAtIndex[_index]; } // ===== Internal functions ===== /// @dev Lets a module admin set mint conditions for a given tokenId. function resetClaimConditions(uint256 _tokenId, ClaimCondition[] calldata _conditions) internal returns (uint256 indexForCondition) { // make sure the conditions are sorted in ascending order uint256 lastConditionStartTimestamp; for (uint256 i = 0; i < _conditions.length; i++) { require( lastConditionStartTimestamp == 0 || lastConditionStartTimestamp < _conditions[i].startTimestamp, "startTimestamp must be in ascending order." ); require(_conditions[i].maxClaimableSupply > 0, "max mint supply cannot be 0."); require(_conditions[i].quantityLimitPerTransaction > 0, "quantity limit cannot be 0."); claimConditions[_tokenId].claimConditionAtIndex[indexForCondition] = ClaimCondition({ startTimestamp: _conditions[i].startTimestamp, maxClaimableSupply: _conditions[i].maxClaimableSupply, supplyClaimed: 0, quantityLimitPerTransaction: _conditions[i].quantityLimitPerTransaction, waitTimeInSecondsBetweenClaims: _conditions[i].waitTimeInSecondsBetweenClaims, pricePerToken: _conditions[i].pricePerToken, currency: _conditions[i].currency, merkleRoot: _conditions[i].merkleRoot }); indexForCondition += 1; lastConditionStartTimestamp = _conditions[i].startTimestamp; } uint256 totalConditionCount = claimConditions[_tokenId].totalConditionCount; if (indexForCondition < totalConditionCount) { for (uint256 j = indexForCondition; j < totalConditionCount; j += 1) { delete claimConditions[_tokenId].claimConditionAtIndex[j]; } } claimConditions[_tokenId].totalConditionCount = indexForCondition; } /// @dev Updates the `timstampLimitIndex` to reset the time restriction between claims, for a claim condition. function resetTimestampRestriction(uint256 _tokenId, uint256 _factor) internal { claimConditions[_tokenId].timstampLimitIndex += _factor; } /// @dev Checks whether a request to claim tokens obeys the active mint condition. function verifyClaimIsValid( uint256 _tokenId, uint256 _quantity, bytes32[] calldata _proofs, uint256 _conditionIndex, ClaimCondition memory _mintCondition ) internal view { require(_quantity > 0 && _quantity <= _mintCondition.quantityLimitPerTransaction, "invalid quantity claimed."); require( _mintCondition.supplyClaimed + _quantity <= _mintCondition.maxClaimableSupply, "exceed max mint supply." ); uint256 timestampIndex = _conditionIndex + claimConditions[_tokenId].timstampLimitIndex; uint256 timestampOfLastClaim = claimConditions[_tokenId].timestampOfLastClaim[_msgSender()][timestampIndex]; uint256 nextValidTimestampForClaim = getTimestampForNextValidClaim(_tokenId, _conditionIndex, _msgSender()); require(timestampOfLastClaim == 0 || block.timestamp >= nextValidTimestampForClaim, "cannot claim yet."); if (_mintCondition.merkleRoot != bytes32(0)) { bytes32 leaf = keccak256(abi.encodePacked(_msgSender())); require(MerkleProof.verify(_proofs, _mintCondition.merkleRoot, leaf), "not in whitelist."); } } /// @dev Collects and distributes the primary sale value of tokens being claimed. function collectClaimPrice( ClaimCondition memory _mintCondition, uint256 _quantityToClaim, uint256 _tokenId ) internal { if (_mintCondition.pricePerToken <= 0) { return; } uint256 totalPrice = _quantityToClaim * _mintCondition.pricePerToken; uint256 fees = (totalPrice * feeBps) / MAX_BPS; if (_mintCondition.currency == NATIVE_TOKEN) { require(msg.value == totalPrice, "must send total price."); } else { validateERC20BalAndAllowance(_msgSender(), _mintCondition.currency, totalPrice); } transferCurrency(_mintCondition.currency, _msgSender(), controlCenter.getRoyaltyTreasury(address(this)), fees); address recipient = saleRecipient[_tokenId]; transferCurrency( _mintCondition.currency, _msgSender(), recipient == address(0) ? defaultSaleRecipient : recipient, totalPrice - fees ); } /// @dev Transfers the tokens being claimed. function transferClaimedTokens( uint256 _claimConditionIndex, uint256 _tokenId, uint256 _quantityBeingClaimed ) internal { // Update the supply minted under mint condition. claimConditions[_tokenId].claimConditionAtIndex[_claimConditionIndex].supplyClaimed += _quantityBeingClaimed; // Update the claimer's next valid timestamp to mint. If next mint timestamp overflows, cap it to max uint256. uint256 timestampIndex = _claimConditionIndex + claimConditions[_tokenId].timstampLimitIndex; claimConditions[_tokenId].timestampOfLastClaim[_msgSender()][timestampIndex] = block.timestamp; _mint(_msgSender(), _tokenId, _quantityBeingClaimed, ""); } /// @dev Transfers a given amount of currency. function transferCurrency( address _currency, address _from, address _to, uint256 _amount ) internal { if (_amount == 0) { return; } if (_currency == NATIVE_TOKEN) { if (_from == address(this)) { IWETH(nativeTokenWrapper).withdraw(_amount); safeTransferNativeToken(_to, _amount); } else if (_to == address(this)) { require(_amount == msg.value, "native token value does not match bid amount."); IWETH(nativeTokenWrapper).deposit{ value: _amount }(); } else { safeTransferNativeToken(_to, _amount); } } else { safeTransferERC20(_currency, _from, _to, _amount); } } /// @dev Validates that `_addrToCheck` owns and has approved contract to transfer the appropriate amount of currency function validateERC20BalAndAllowance( address _addrToCheck, address _currency, uint256 _currencyAmountToCheckAgainst ) internal view { require( IERC20(_currency).balanceOf(_addrToCheck) >= _currencyAmountToCheckAgainst && IERC20(_currency).allowance(_addrToCheck, address(this)) >= _currencyAmountToCheckAgainst, "insufficient currency balance or allowance." ); } /// @dev Transfers `amount` of native token to `to`. function safeTransferNativeToken(address to, uint256 value) internal { (bool success, ) = to.call{ value: value }(""); if (!success) { IWETH(nativeTokenWrapper).deposit{ value: value }(); safeTransferERC20(nativeTokenWrapper, address(this), to, value); } } /// @dev Transfer `amount` of ERC20 token from `from` to `to`. function safeTransferERC20( address _currency, address _from, address _to, uint256 _amount ) internal { if (_from == _to) { return; } uint256 balBefore = IERC20(_currency).balanceOf(_to); bool success = _from == address(this) ? IERC20(_currency).transfer(_to, _amount) : IERC20(_currency).transferFrom(_from, _to, _amount); uint256 balAfter = IERC20(_currency).balanceOf(_to); require(success && balAfter == balBefore + _amount, "failed to transfer currency."); } /// ===== ERC 1155 functions ===== /// @dev Lets a token owner burn the tokens they own (i.e. destroy for good) function burn( address account, uint256 id, uint256 value ) public virtual { require( account == _msgSender() || isApprovedForAll(account, _msgSender()), "ERC1155: caller is not owner nor approved." ); _burn(account, id, value); } /// @dev Lets a token owner burn multiple tokens they own at once (i.e. destroy for good) function burnBatch( address account, uint256[] memory ids, uint256[] memory values ) public virtual { require( account == _msgSender() || isApprovedForAll(account, _msgSender()), "ERC1155: caller is not owner nor approved." ); _burnBatch(account, ids, values); } /** * @dev See {ERC1155-_beforeTokenTransfer}. */ function _beforeTokenTransfer( address operator, address from, address to, uint256[] memory ids, uint256[] memory amounts, bytes memory data ) internal virtual override { super._beforeTokenTransfer(operator, from, to, ids, amounts, data); // if transfer is restricted on the contract, we still want to allow burning and minting if (transfersRestricted && from != address(0) && to != address(0)) { require(hasRole(TRANSFER_ROLE, from) || hasRole(TRANSFER_ROLE, to), "restricted to TRANSFER_ROLE holders."); } if (from == address(0)) { for (uint256 i = 0; i < ids.length; ++i) { totalSupply[ids[i]] += amounts[i]; } } if (to == address(0)) { for (uint256 i = 0; i < ids.length; ++i) { totalSupply[ids[i]] -= amounts[i]; } } } /// ===== Low level overrides ===== function supportsInterface(bytes4 interfaceId) public view virtual override(ERC1155, AccessControlEnumerable, IERC165) returns (bool) { return interfaceId == type(IERC1155).interfaceId || interfaceId == type(IERC2981).interfaceId; } function _msgSender() internal view virtual override(Context, ERC2771Context) returns (address sender) { return ERC2771Context._msgSender(); } function _msgData() internal view virtual override(Context, ERC2771Context) returns (bytes calldata) { return ERC2771Context._msgData(); } }
// SPDX-License-Identifier: Apache-2.0 pragma solidity ^0.8.0; /** * `LazyMintERC1155` is an ERC 1155 contract. It takes in a base URI in its * constructor (e.g. "ipsf://Qmece.../"), and the URI for each token of ID * `tokenId` is baseURI + `${tokenId}` (e.g. "ipsf://Qmece.../1"). * * For each token with a unique ID, the module admin (account with `DEFAULT_ADMIN ROLE`) * can create mint conditions with non-overlapping time windows, and accounts can claim * the NFTs, in a given time window, according to that time window's mint conditions. */ interface ILazyMintERC1155 { /** * @notice The mint conditions for a given tokenId x time window. * * @param startTimestamp The unix timestamp after which the mint conditions last. * The same mint conditions last until the `startTimestamp` * of the next mint condition. * * @param maxClaimableSupply The maximum number of tokens of the same `tokenId` that can * be claimed under the mint condition. * * @param supplyClaimed At any given point, the number of tokens of the same `tokenId` * that have been claimed. * * @param quantityLimitPerTransaction The maximum number of tokens a single account can * claim in a single transaction. * * @param waitTimeInSecondsBetweenClaims The least number of seconds an account must wait * after claiming tokens, to be able to claim again. * * @param merkleRoot Only accounts whose address is a leaf of `merkleRoot` can claim tokens * under the mint condition. * * @param pricePerToken The price per token that can be claimed. * * @param currency The currency in which `pricePerToken` must be paid. */ struct ClaimCondition { uint256 startTimestamp; uint256 maxClaimableSupply; uint256 supplyClaimed; uint256 quantityLimitPerTransaction; uint256 waitTimeInSecondsBetweenClaims; bytes32 merkleRoot; uint256 pricePerToken; address currency; } /** * @notice The set of all mint conditions for a given tokenId. * * @dev In the contract, we use this in a mapping: tokenId => mint conditions i.e. * mapping(uint256 => PublicMintConditions) public mintConditions; * * @param totalConditionCount The uid for each mint condition. Incremented * by one every time a mint condition is created. * * @param claimConditionAtIndex The mint conditions at a given uid. Mint conditions * are ordered in an ascending order by their `startTimestamp`. * * @param nextValidTimestampForClaim Account => uid for a mint condition => timestamp after * which the account can claim tokens again. */ struct ClaimConditions { uint256 totalConditionCount; uint256 timstampLimitIndex; mapping(uint256 => ClaimCondition) claimConditionAtIndex; mapping(address => mapping(uint256 => uint256)) timestampOfLastClaim; } /// @dev Emitted when tokens are lazy minted. event LazyMintedTokens(uint256 startTokenId, uint256 endTokenId, string baseURI); /// @dev Emitted when tokens are claimed. event ClaimedTokens( uint256 indexed claimConditionIndex, uint256 indexed tokenId, address indexed claimer, uint256 quantityClaimed ); /// @dev Emitted when new mint conditions are set for a token. event NewClaimConditions(uint256 indexed tokenId, ClaimCondition[] claimConditions); /// @dev Emitted when a new sale recipient is set. event NewSaleRecipient(address indexed recipient, uint256 indexed _tokenId, bool isDefaultRecipient); /// @dev Emitted when the royalty fee bps is updated event RoyaltyUpdated(uint256 newRoyaltyBps); /// @dev Emitted when fee on primary sales is updated. event PrimarySalesFeeUpdates(uint256 newFeeBps); /// @dev Emitted when transfers are set as restricted / not-restricted. event TransfersRestricted(bool restricted); /// @dev Emitted when a new Owner is set. event NewOwner(address prevOwner, address newOwner); /// @dev The next token ID of the NFT to "lazy mint". function nextTokenIdToMint() external returns (uint256); /** * @notice Lets an account with `MINTER_ROLE` mint tokens of ID from `nextTokenIdToMint` * to `nextTokenIdToMint + _amount - 1`. The URIs for these tokenIds is baseURI + `${tokenId}`. * * @param _amount The amount of tokens (each with a unique tokenId) to lazy mint. */ function lazyMint(uint256 _amount, string calldata _baseURIForTokens) external; /** * @notice Lets an account claim a given quantity of tokens, of a single tokenId. * * @param _tokenId The unique ID of the token to claim. * @param _quantity The quantity of tokens to claim. * @param _proofs The proof required to prove the account's inclusion in the merkle root whitelist * of the mint conditions that apply. */ function claim( uint256 _tokenId, uint256 _quantity, bytes32[] calldata _proofs ) external payable; /** * @notice Lets a module admin (account with `DEFAULT_ADMIN_ROLE`) set mint conditions for a given token ID. * * @param _tokenId The token ID for which to set mint conditions. * @param _conditions Mint conditions in ascending order by `startTimestamp`. */ function setClaimConditions(uint256 _tokenId, ClaimCondition[] calldata _conditions) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC1155/ERC1155.sol) pragma solidity ^0.8.0; import "./IERC1155.sol"; import "./IERC1155Receiver.sol"; import "./extensions/IERC1155MetadataURI.sol"; import "../../utils/Address.sol"; import "../../utils/Context.sol"; import "../../utils/introspection/ERC165.sol"; /** * @dev Implementation of the basic standard multi-token. * See https://eips.ethereum.org/EIPS/eip-1155 * Originally based on code by Enjin: https://github.com/enjin/erc-1155 * * _Available since v3.1._ */ contract ERC1155 is Context, ERC165, IERC1155, IERC1155MetadataURI { using Address for address; // Mapping from token ID to account balances mapping(uint256 => mapping(address => uint256)) private _balances; // Mapping from account to operator approvals mapping(address => mapping(address => bool)) private _operatorApprovals; // Used as the URI for all token types by relying on ID substitution, e.g. https://token-cdn-domain/{id}.json string private _uri; /** * @dev See {_setURI}. */ constructor(string memory uri_) { _setURI(uri_); } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) { return interfaceId == type(IERC1155).interfaceId || interfaceId == type(IERC1155MetadataURI).interfaceId || super.supportsInterface(interfaceId); } /** * @dev See {IERC1155MetadataURI-uri}. * * This implementation returns the same URI for *all* token types. It relies * on the token type ID substitution mechanism * https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP]. * * Clients calling this function must replace the `\{id\}` substring with the * actual token type ID. */ function uri(uint256) public view virtual override returns (string memory) { return _uri; } /** * @dev See {IERC1155-balanceOf}. * * Requirements: * * - `account` cannot be the zero address. */ function balanceOf(address account, uint256 id) public view virtual override returns (uint256) { require(account != address(0), "ERC1155: balance query for the zero address"); return _balances[id][account]; } /** * @dev See {IERC1155-balanceOfBatch}. * * Requirements: * * - `accounts` and `ids` must have the same length. */ function balanceOfBatch(address[] memory accounts, uint256[] memory ids) public view virtual override returns (uint256[] memory) { require(accounts.length == ids.length, "ERC1155: accounts and ids length mismatch"); uint256[] memory batchBalances = new uint256[](accounts.length); for (uint256 i = 0; i < accounts.length; ++i) { batchBalances[i] = balanceOf(accounts[i], ids[i]); } return batchBalances; } /** * @dev See {IERC1155-setApprovalForAll}. */ function setApprovalForAll(address operator, bool approved) public virtual override { _setApprovalForAll(_msgSender(), operator, approved); } /** * @dev See {IERC1155-isApprovedForAll}. */ function isApprovedForAll(address account, address operator) public view virtual override returns (bool) { return _operatorApprovals[account][operator]; } /** * @dev See {IERC1155-safeTransferFrom}. */ function safeTransferFrom( address from, address to, uint256 id, uint256 amount, bytes memory data ) public virtual override { require( from == _msgSender() || isApprovedForAll(from, _msgSender()), "ERC1155: caller is not owner nor approved" ); _safeTransferFrom(from, to, id, amount, data); } /** * @dev See {IERC1155-safeBatchTransferFrom}. */ function safeBatchTransferFrom( address from, address to, uint256[] memory ids, uint256[] memory amounts, bytes memory data ) public virtual override { require( from == _msgSender() || isApprovedForAll(from, _msgSender()), "ERC1155: transfer caller is not owner nor approved" ); _safeBatchTransferFrom(from, to, ids, amounts, data); } /** * @dev Transfers `amount` tokens of token type `id` from `from` to `to`. * * Emits a {TransferSingle} event. * * Requirements: * * - `to` cannot be the zero address. * - `from` must have a balance of tokens of type `id` of at least `amount`. * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the * acceptance magic value. */ function _safeTransferFrom( address from, address to, uint256 id, uint256 amount, bytes memory data ) internal virtual { require(to != address(0), "ERC1155: transfer to the zero address"); address operator = _msgSender(); _beforeTokenTransfer(operator, from, to, _asSingletonArray(id), _asSingletonArray(amount), data); uint256 fromBalance = _balances[id][from]; require(fromBalance >= amount, "ERC1155: insufficient balance for transfer"); unchecked { _balances[id][from] = fromBalance - amount; } _balances[id][to] += amount; emit TransferSingle(operator, from, to, id, amount); _doSafeTransferAcceptanceCheck(operator, from, to, id, amount, data); } /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_safeTransferFrom}. * * Emits a {TransferBatch} event. * * Requirements: * * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the * acceptance magic value. */ function _safeBatchTransferFrom( address from, address to, uint256[] memory ids, uint256[] memory amounts, bytes memory data ) internal virtual { require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch"); require(to != address(0), "ERC1155: transfer to the zero address"); address operator = _msgSender(); _beforeTokenTransfer(operator, from, to, ids, amounts, data); for (uint256 i = 0; i < ids.length; ++i) { uint256 id = ids[i]; uint256 amount = amounts[i]; uint256 fromBalance = _balances[id][from]; require(fromBalance >= amount, "ERC1155: insufficient balance for transfer"); unchecked { _balances[id][from] = fromBalance - amount; } _balances[id][to] += amount; } emit TransferBatch(operator, from, to, ids, amounts); _doSafeBatchTransferAcceptanceCheck(operator, from, to, ids, amounts, data); } /** * @dev Sets a new URI for all token types, by relying on the token type ID * substitution mechanism * https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP]. * * By this mechanism, any occurrence of the `\{id\}` substring in either the * URI or any of the amounts in the JSON file at said URI will be replaced by * clients with the token type ID. * * For example, the `https://token-cdn-domain/\{id\}.json` URI would be * interpreted by clients as * `https://token-cdn-domain/000000000000000000000000000000000000000000000000000000000004cce0.json` * for token type ID 0x4cce0. * * See {uri}. * * Because these URIs cannot be meaningfully represented by the {URI} event, * this function emits no events. */ function _setURI(string memory newuri) internal virtual { _uri = newuri; } /** * @dev Creates `amount` tokens of token type `id`, and assigns them to `to`. * * Emits a {TransferSingle} event. * * Requirements: * * - `to` cannot be the zero address. * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the * acceptance magic value. */ function _mint( address to, uint256 id, uint256 amount, bytes memory data ) internal virtual { require(to != address(0), "ERC1155: mint to the zero address"); address operator = _msgSender(); _beforeTokenTransfer(operator, address(0), to, _asSingletonArray(id), _asSingletonArray(amount), data); _balances[id][to] += amount; emit TransferSingle(operator, address(0), to, id, amount); _doSafeTransferAcceptanceCheck(operator, address(0), to, id, amount, data); } /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_mint}. * * Requirements: * * - `ids` and `amounts` must have the same length. * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the * acceptance magic value. */ function _mintBatch( address to, uint256[] memory ids, uint256[] memory amounts, bytes memory data ) internal virtual { require(to != address(0), "ERC1155: mint to the zero address"); require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch"); address operator = _msgSender(); _beforeTokenTransfer(operator, address(0), to, ids, amounts, data); for (uint256 i = 0; i < ids.length; i++) { _balances[ids[i]][to] += amounts[i]; } emit TransferBatch(operator, address(0), to, ids, amounts); _doSafeBatchTransferAcceptanceCheck(operator, address(0), to, ids, amounts, data); } /** * @dev Destroys `amount` tokens of token type `id` from `from` * * Requirements: * * - `from` cannot be the zero address. * - `from` must have at least `amount` tokens of token type `id`. */ function _burn( address from, uint256 id, uint256 amount ) internal virtual { require(from != address(0), "ERC1155: burn from the zero address"); address operator = _msgSender(); _beforeTokenTransfer(operator, from, address(0), _asSingletonArray(id), _asSingletonArray(amount), ""); uint256 fromBalance = _balances[id][from]; require(fromBalance >= amount, "ERC1155: burn amount exceeds balance"); unchecked { _balances[id][from] = fromBalance - amount; } emit TransferSingle(operator, from, address(0), id, amount); } /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_burn}. * * Requirements: * * - `ids` and `amounts` must have the same length. */ function _burnBatch( address from, uint256[] memory ids, uint256[] memory amounts ) internal virtual { require(from != address(0), "ERC1155: burn from the zero address"); require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch"); address operator = _msgSender(); _beforeTokenTransfer(operator, from, address(0), ids, amounts, ""); for (uint256 i = 0; i < ids.length; i++) { uint256 id = ids[i]; uint256 amount = amounts[i]; uint256 fromBalance = _balances[id][from]; require(fromBalance >= amount, "ERC1155: burn amount exceeds balance"); unchecked { _balances[id][from] = fromBalance - amount; } } emit TransferBatch(operator, from, address(0), ids, amounts); } /** * @dev Approve `operator` to operate on all of `owner` tokens * * Emits a {ApprovalForAll} event. */ function _setApprovalForAll( address owner, address operator, bool approved ) internal virtual { require(owner != operator, "ERC1155: setting approval status for self"); _operatorApprovals[owner][operator] = approved; emit ApprovalForAll(owner, operator, approved); } /** * @dev Hook that is called before any token transfer. This includes minting * and burning, as well as batched variants. * * The same hook is called on both single and batched variants. For single * transfers, the length of the `id` and `amount` arrays will be 1. * * Calling conditions (for each `id` and `amount` pair): * * - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens * of token type `id` will be transferred to `to`. * - When `from` is zero, `amount` tokens of token type `id` will be minted * for `to`. * - when `to` is zero, `amount` of ``from``'s tokens of token type `id` * will be burned. * - `from` and `to` are never both zero. * - `ids` and `amounts` have the same, non-zero length. * * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks]. */ function _beforeTokenTransfer( address operator, address from, address to, uint256[] memory ids, uint256[] memory amounts, bytes memory data ) internal virtual {} function _doSafeTransferAcceptanceCheck( address operator, address from, address to, uint256 id, uint256 amount, bytes memory data ) private { if (to.isContract()) { try IERC1155Receiver(to).onERC1155Received(operator, from, id, amount, data) returns (bytes4 response) { if (response != IERC1155Receiver.onERC1155Received.selector) { revert("ERC1155: ERC1155Receiver rejected tokens"); } } catch Error(string memory reason) { revert(reason); } catch { revert("ERC1155: transfer to non ERC1155Receiver implementer"); } } } function _doSafeBatchTransferAcceptanceCheck( address operator, address from, address to, uint256[] memory ids, uint256[] memory amounts, bytes memory data ) private { if (to.isContract()) { try IERC1155Receiver(to).onERC1155BatchReceived(operator, from, ids, amounts, data) returns ( bytes4 response ) { if (response != IERC1155Receiver.onERC1155BatchReceived.selector) { revert("ERC1155: ERC1155Receiver rejected tokens"); } } catch Error(string memory reason) { revert(reason); } catch { revert("ERC1155: transfer to non ERC1155Receiver implementer"); } } } function _asSingletonArray(uint256 element) private pure returns (uint256[] memory) { uint256[] memory array = new uint256[](1); array[0] = element; return array; } }
// SPDX-License-Identifier: Apache-2.0 pragma solidity ^0.8.0; // Access Control import "@openzeppelin/contracts/access/AccessControlEnumerable.sol"; import "@openzeppelin/contracts/proxy/utils/Initializable.sol"; import "@openzeppelin/contracts/utils/Multicall.sol"; // Registry import { Registry } from "./Registry.sol"; import { Royalty } from "./Royalty.sol"; import "@openzeppelin/contracts/token/ERC20/IERC20.sol"; contract ProtocolControl is AccessControlEnumerable, Multicall, Initializable { /// @dev Contract version string public constant version = "1"; /// @dev MAX_BPS for the contract: 10_000 == 100% uint256 public constant MAX_BPS = 10000; /// @dev The address interpreted as native token of the chain. address public constant NATIVE_TOKEN = 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE; /// @dev Module ID => Module address. mapping(bytes32 => address) public modules; /// @dev Module type => Num of modules of that type. mapping(uint256 => uint256) public numOfModuleType; /// @dev module address => royalty address mapping(address => address) private moduleRoyalty; /// @dev The top level app registry. address public registry; /// @dev Deployer's treasury address public royaltyTreasury; /// @dev The Forwarder for this app's modules. address private _forwarder; /// @dev Contract level metadata. string public contractURI; /// @dev Events. event ModuleUpdated(bytes32 indexed moduleId, address indexed module); event TreasuryUpdated(address _newTreasury); event ForwarderUpdated(address _newForwarder); event FundsWithdrawn(address indexed to, address indexed currency, uint256 amount, uint256 fee); event EtherReceived(address from, uint256 amount); event RoyaltyTreasuryUpdated( address indexed protocolControlAddress, address indexed moduleAddress, address treasury ); /// @dev Check whether the caller is a protocol admin modifier onlyProtocolAdmin() { require( hasRole(DEFAULT_ADMIN_ROLE, msg.sender), "ProtocolControl: Only protocol admins can call this function." ); _; } constructor() initializer {} function initialize( address _registry, address _admin, string memory _uri ) external initializer { // Set contract URI contractURI = _uri; // Set top level ap registry registry = _registry; // Set default royalty treasury address royaltyTreasury = address(this); // Set access control roles _setupRole(DEFAULT_ADMIN_ROLE, _admin); } /// @dev Lets the contract receive ether. receive() external payable { emit EtherReceived(msg.sender, msg.value); } /// @dev Initialize treasury payment royalty splitting pool function setRoyaltyTreasury(address payable _treasury) external onlyProtocolAdmin { require(_isRoyaltyTreasuryValid(_treasury), "ProtocolControl: provider shares too low."); royaltyTreasury = _treasury; emit RoyaltyTreasuryUpdated(address(this), address(0), _treasury); } /// @dev _treasury must be PaymentSplitter compatible interface. function setModuleRoyaltyTreasury(address moduleAddress, address payable _treasury) external onlyProtocolAdmin { require(_isRoyaltyTreasuryValid(_treasury), "ProtocolControl: provider shares too low."); moduleRoyalty[moduleAddress] = _treasury; emit RoyaltyTreasuryUpdated(address(this), moduleAddress, _treasury); } /// @dev validate to make sure protocol provider (the registry) gets enough fees. function _isRoyaltyTreasuryValid(address payable _treasury) private view returns (bool) { // Get `Royalty` and `Registry` instances Royalty royalty = Royalty(_treasury); Registry _registry = Registry(registry); // Calculate the protocol provider's shares. uint256 royaltyRegistryShares = royalty.shares(_registry.treasury()); uint256 royaltyTotalShares = royalty.totalShares(); uint256 registryCutBps = (royaltyRegistryShares * MAX_BPS) / royaltyTotalShares; // 10 bps (0.10%) tolerance in case of precision loss // making sure registry treasury gets at least the fee's worth of shares. uint256 feeBpsTolerance = 10; return registryCutBps >= (_registry.getFeeBps(address(this)) - feeBpsTolerance); } /// @dev Returns the Royalty payment splitter for a particular module. function getRoyaltyTreasury(address moduleAddress) external view returns (address) { address moduleRoyaltyTreasury = moduleRoyalty[moduleAddress]; if (moduleRoyaltyTreasury == address(0)) { return royaltyTreasury; } return moduleRoyaltyTreasury; } /// @dev Lets a protocol admin add a module to the protocol. function addModule(address _newModuleAddress, uint256 _moduleType) external onlyProtocolAdmin returns (bytes32 moduleId) { // `moduleId` is collision resitant -- unique `_moduleType` and incrementing `numOfModuleType` moduleId = keccak256(abi.encodePacked(numOfModuleType[_moduleType], _moduleType)); numOfModuleType[_moduleType] += 1; modules[moduleId] = _newModuleAddress; emit ModuleUpdated(moduleId, _newModuleAddress); } /// @dev Lets a protocol admin change the address of a module of the protocol. function updateModule(bytes32 _moduleId, address _newModuleAddress) external onlyProtocolAdmin { require(modules[_moduleId] != address(0), "ProtocolControl: a module with this ID does not exist."); modules[_moduleId] = _newModuleAddress; emit ModuleUpdated(_moduleId, _newModuleAddress); } /// @dev Sets contract URI for the contract-level metadata of the contract. function setContractURI(string calldata _URI) external onlyProtocolAdmin { contractURI = _URI; } /// @dev Lets the admin set a new Forwarder address [NOTE: for off-chain convenience only.] function setForwarder(address forwarder) external onlyProtocolAdmin { _forwarder = forwarder; emit ForwarderUpdated(forwarder); } /// @dev Returns all addresses for a module type function getAllModulesOfType(uint256 _moduleType) external view returns (address[] memory allModules) { uint256 numOfModules = numOfModuleType[_moduleType]; allModules = new address[](numOfModules); for (uint256 i = 0; i < numOfModules; i += 1) { bytes32 moduleId = keccak256(abi.encodePacked(i, _moduleType)); allModules[i] = modules[moduleId]; } } /// @dev Returns the forwarder address stored on the contract. function getForwarder() public view returns (address) { if (_forwarder == address(0)) { return Registry(registry).forwarder(); } return _forwarder; } /// @dev Lets a protocol admin withdraw tokens from this contract. function withdrawFunds(address to, address currency) external onlyProtocolAdmin { Registry _registry = Registry(registry); IERC20 _currency = IERC20(currency); address registryTreasury = _registry.treasury(); uint256 amount; bool isNativeToken = _isNativeToken(address(_currency)); if (isNativeToken) { amount = address(this).balance; } else { amount = _currency.balanceOf(address(this)); } uint256 registryTreasuryFee = (amount * _registry.getFeeBps(address(this))) / MAX_BPS; amount -= registryTreasuryFee; bool transferSuccess; if (isNativeToken) { (transferSuccess, ) = payable(to).call{ value: amount }(""); require(transferSuccess, "failed to withdraw funds"); (transferSuccess, ) = payable(registryTreasury).call{ value: registryTreasuryFee }(""); require(transferSuccess, "failed to withdraw funds to registry"); emit FundsWithdrawn(to, currency, amount, registryTreasuryFee); } else { transferSuccess = _currency.transfer(to, amount); require(transferSuccess, "failed to transfer payment"); transferSuccess = _currency.transfer(registryTreasury, registryTreasuryFee); require(transferSuccess, "failed to transfer payment to registry"); emit FundsWithdrawn(to, currency, amount, registryTreasuryFee); } } /// @dev Checks whether an address is to be interpreted as the native token function _isNativeToken(address _toCheck) internal pure returns (bool) { return _toCheck == NATIVE_TOKEN || _toCheck == address(0); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (interfaces/IERC2981.sol) pragma solidity ^0.8.0; import "./IERC165.sol"; /** * @dev Interface for the NFT Royalty Standard */ interface IERC2981 is IERC165 { /** * @dev Called with the sale price to determine how much royalty is owed and to whom. * @param tokenId - the NFT asset queried for royalty information * @param salePrice - the sale price of the NFT asset specified by `tokenId` * @return receiver - address of who should be sent the royalty payment * @return royaltyAmount - the royalty payment amount for `salePrice` */ function royaltyInfo(uint256 tokenId, uint256 salePrice) external view returns (address receiver, uint256 royaltyAmount); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (security/ReentrancyGuard.sol) pragma solidity ^0.8.0; /** * @dev Contract module that helps prevent reentrant calls to a function. * * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier * available, which can be applied to functions to make sure there are no nested * (reentrant) calls to them. * * Note that because there is a single `nonReentrant` guard, functions marked as * `nonReentrant` may not call one another. This can be worked around by making * those functions `private`, and then adding `external` `nonReentrant` entry * points to them. * * TIP: If you would like to learn more about reentrancy and alternative ways * to protect against it, check out our blog post * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul]. */ abstract contract ReentrancyGuard { // Booleans are more expensive than uint256 or any type that takes up a full // word because each write operation emits an extra SLOAD to first read the // slot's contents, replace the bits taken up by the boolean, and then write // back. This is the compiler's defense against contract upgrades and // pointer aliasing, and it cannot be disabled. // The values being non-zero value makes deployment a bit more expensive, // but in exchange the refund on every call to nonReentrant will be lower in // amount. Since refunds are capped to a percentage of the total // transaction's gas, it is best to keep them low in cases like this one, to // increase the likelihood of the full refund coming into effect. uint256 private constant _NOT_ENTERED = 1; uint256 private constant _ENTERED = 2; uint256 private _status; constructor() { _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() { // On the first call to nonReentrant, _notEntered will be true require(_status != _ENTERED, "ReentrancyGuard: reentrant call"); // Any calls to nonReentrant after this point will fail _status = _ENTERED; _; // By storing the original value once again, a refund is triggered (see // https://eips.ethereum.org/EIPS/eip-2200) _status = _NOT_ENTERED; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/AccessControlEnumerable.sol) pragma solidity ^0.8.0; import "./IAccessControlEnumerable.sol"; import "./AccessControl.sol"; import "../utils/structs/EnumerableSet.sol"; /** * @dev Extension of {AccessControl} that allows enumerating the members of each role. */ abstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl { using EnumerableSet for EnumerableSet.AddressSet; mapping(bytes32 => EnumerableSet.AddressSet) private _roleMembers; /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IAccessControlEnumerable).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Returns one of the accounts that have `role`. `index` must be a * value between 0 and {getRoleMemberCount}, non-inclusive. * * Role bearers are not sorted in any particular way, and their ordering may * change at any point. * * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure * you perform all queries on the same block. See the following * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post] * for more information. */ function getRoleMember(bytes32 role, uint256 index) public view override returns (address) { return _roleMembers[role].at(index); } /** * @dev Returns the number of accounts that have `role`. Can be used * together with {getRoleMember} to enumerate all bearers of a role. */ function getRoleMemberCount(bytes32 role) public view override returns (uint256) { return _roleMembers[role].length(); } /** * @dev Overload {_grantRole} to track enumerable memberships */ function _grantRole(bytes32 role, address account) internal virtual override { super._grantRole(role, account); _roleMembers[role].add(account); } /** * @dev Overload {_revokeRole} to track enumerable memberships */ function _revokeRole(bytes32 role, address account) internal virtual override { super._revokeRole(role, account); _roleMembers[role].remove(account); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (metatx/ERC2771Context.sol) pragma solidity ^0.8.0; import "../utils/Context.sol"; /** * @dev Context variant with ERC2771 support. */ abstract contract ERC2771Context is Context { address private _trustedForwarder; constructor(address trustedForwarder) { _trustedForwarder = trustedForwarder; } function isTrustedForwarder(address forwarder) public view virtual returns (bool) { return forwarder == _trustedForwarder; } function _msgSender() internal view virtual override returns (address sender) { if (isTrustedForwarder(msg.sender)) { // The assembly code is more direct than the Solidity version using `abi.decode`. assembly { sender := shr(96, calldataload(sub(calldatasize(), 20))) } } else { return super._msgSender(); } } function _msgData() internal view virtual override returns (bytes calldata) { if (isTrustedForwarder(msg.sender)) { return msg.data[:msg.data.length - 20]; } else { return super._msgData(); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/cryptography/MerkleProof.sol) pragma solidity ^0.8.0; /** * @dev These functions deal with verification of Merkle Trees proofs. * * The proofs can be generated using the JavaScript library * https://github.com/miguelmota/merkletreejs[merkletreejs]. * Note: the hashing algorithm should be keccak256 and pair sorting should be enabled. * * See `test/utils/cryptography/MerkleProof.test.js` for some examples. */ library MerkleProof { /** * @dev Returns true if a `leaf` can be proved to be a part of a Merkle tree * defined by `root`. For this, a `proof` must be provided, containing * sibling hashes on the branch from the leaf to the root of the tree. Each * pair of leaves and each pair of pre-images are assumed to be sorted. */ function verify( bytes32[] memory proof, bytes32 root, bytes32 leaf ) internal pure returns (bool) { return processProof(proof, leaf) == root; } /** * @dev Returns the rebuilt hash obtained by traversing a Merklee tree up * from `leaf` using `proof`. A `proof` is valid if and only if the rebuilt * hash matches the root of the tree. When processing the proof, the pairs * of leafs & pre-images are assumed to be sorted. * * _Available since v4.4._ */ function processProof(bytes32[] memory proof, bytes32 leaf) internal pure returns (bytes32) { bytes32 computedHash = leaf; for (uint256 i = 0; i < proof.length; i++) { bytes32 proofElement = proof[i]; if (computedHash <= proofElement) { // Hash(current computed hash + current element of the proof) computedHash = keccak256(abi.encodePacked(computedHash, proofElement)); } else { // Hash(current element of the proof + current computed hash) computedHash = keccak256(abi.encodePacked(proofElement, computedHash)); } } return computedHash; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Multicall.sol) pragma solidity ^0.8.0; import "./Address.sol"; /** * @dev Provides a function to batch together multiple calls in a single external call. * * _Available since v4.1._ */ abstract contract Multicall { /** * @dev Receives and executes a batch of function calls on this contract. */ function multicall(bytes[] calldata data) external returns (bytes[] memory results) { results = new bytes[](data.length); for (uint256 i = 0; i < data.length; i++) { results[i] = Address.functionDelegateCall(address(this), data[i]); } return results; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Strings.sol) pragma solidity ^0.8.0; /** * @dev String operations. */ library Strings { bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef"; /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { // Inspired by OraclizeAPI's implementation - MIT licence // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol if (value == 0) { return "0"; } uint256 temp = value; uint256 digits; while (temp != 0) { digits++; temp /= 10; } bytes memory buffer = new bytes(digits); while (value != 0) { digits -= 1; buffer[digits] = bytes1(uint8(48 + uint256(value % 10))); value /= 10; } return string(buffer); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { if (value == 0) { return "0x00"; } uint256 temp = value; uint256 length = 0; while (temp != 0) { length++; temp >>= 8; } return toHexString(value, length); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ 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] = _HEX_SYMBOLS[value & 0xf]; value >>= 4; } require(value == 0, "Strings: hex length insufficient"); return string(buffer); } }
// SPDX-License-Identifier: Apache-2.0 pragma solidity ^0.8.0; interface IWETH { function deposit() external payable; function withdraw(uint256 amount) external; function transfer(address to, uint256 value) external returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC20/IERC20.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20 { /** * @dev Returns the amount of tokens in existence. */ function totalSupply() external view returns (uint256); /** * @dev Returns the amount of tokens owned by `account`. */ function balanceOf(address account) external view returns (uint256); /** * @dev Moves `amount` tokens from the caller's account to `recipient`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address recipient, uint256 amount) external returns (bool); /** * @dev Returns the remaining number of tokens that `spender` will be * allowed to spend on behalf of `owner` through {transferFrom}. This is * zero by default. * * This value changes when {approve} or {transferFrom} are called. */ function allowance(address owner, address spender) external view returns (uint256); /** * @dev Sets `amount` as the allowance of `spender` over the caller's tokens. * * Returns a boolean value indicating whether the operation succeeded. * * IMPORTANT: Beware that changing an allowance with this method brings the risk * that someone may use both the old and the new allowance by unfortunate * transaction ordering. One possible solution to mitigate this race * condition is to first reduce the spender's allowance to 0 and set the * desired value afterwards: * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 * * Emits an {Approval} event. */ function approve(address spender, uint256 amount) external returns (bool); /** * @dev Moves `amount` tokens from `sender` to `recipient` using the * allowance mechanism. `amount` is then deducted from the caller's * allowance. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transferFrom( address sender, address recipient, uint256 amount ) external returns (bool); /** * @dev Emitted when `value` tokens are moved from one account (`from`) to * another (`to`). * * Note that `value` may be zero. */ event Transfer(address indexed from, address indexed to, uint256 value); /** * @dev Emitted when the allowance of a `spender` for an `owner` is set by * a call to {approve}. `value` is the new allowance. */ event Approval(address indexed owner, address indexed spender, uint256 value); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC1155/IERC1155.sol) pragma solidity ^0.8.0; import "../../utils/introspection/IERC165.sol"; /** * @dev Required interface of an ERC1155 compliant contract, as defined in the * https://eips.ethereum.org/EIPS/eip-1155[EIP]. * * _Available since v3.1._ */ interface IERC1155 is IERC165 { /** * @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`. */ event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value); /** * @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all * transfers. */ event TransferBatch( address indexed operator, address indexed from, address indexed to, uint256[] ids, uint256[] values ); /** * @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to * `approved`. */ event ApprovalForAll(address indexed account, address indexed operator, bool approved); /** * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI. * * If an {URI} event was emitted for `id`, the standard * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value * returned by {IERC1155MetadataURI-uri}. */ event URI(string value, uint256 indexed id); /** * @dev Returns the amount of tokens of token type `id` owned by `account`. * * Requirements: * * - `account` cannot be the zero address. */ function balanceOf(address account, uint256 id) external view returns (uint256); /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}. * * Requirements: * * - `accounts` and `ids` must have the same length. */ function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids) external view returns (uint256[] memory); /** * @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`, * * Emits an {ApprovalForAll} event. * * Requirements: * * - `operator` cannot be the caller. */ function setApprovalForAll(address operator, bool approved) external; /** * @dev Returns true if `operator` is approved to transfer ``account``'s tokens. * * See {setApprovalForAll}. */ function isApprovedForAll(address account, address operator) external view returns (bool); /** * @dev Transfers `amount` tokens of token type `id` from `from` to `to`. * * Emits a {TransferSingle} event. * * Requirements: * * - `to` cannot be the zero address. * - If the caller is not `from`, it must be have been approved to spend ``from``'s tokens via {setApprovalForAll}. * - `from` must have a balance of tokens of type `id` of at least `amount`. * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the * acceptance magic value. */ function safeTransferFrom( address from, address to, uint256 id, uint256 amount, bytes calldata data ) external; /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}. * * Emits a {TransferBatch} event. * * Requirements: * * - `ids` and `amounts` must have the same length. * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the * acceptance magic value. */ function safeBatchTransferFrom( address from, address to, uint256[] calldata ids, uint256[] calldata amounts, bytes calldata data ) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC1155/IERC1155Receiver.sol) pragma solidity ^0.8.0; import "../../utils/introspection/IERC165.sol"; /** * @dev _Available since v3.1._ */ interface IERC1155Receiver is IERC165 { /** @dev Handles the receipt of a single ERC1155 token type. This function is called at the end of a `safeTransferFrom` after the balance has been updated. To accept the transfer, this must return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` (i.e. 0xf23a6e61, or its own function selector). @param operator The address which initiated the transfer (i.e. msg.sender) @param from The address which previously owned the token @param id The ID of the token being transferred @param value The amount of tokens being transferred @param data Additional data with no specified format @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed */ function onERC1155Received( address operator, address from, uint256 id, uint256 value, bytes calldata data ) external returns (bytes4); /** @dev Handles the receipt of a multiple ERC1155 token types. This function is called at the end of a `safeBatchTransferFrom` after the balances have been updated. To accept the transfer(s), this must return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` (i.e. 0xbc197c81, or its own function selector). @param operator The address which initiated the batch transfer (i.e. msg.sender) @param from The address which previously owned the token @param ids An array containing ids of each token being transferred (order and length must match values array) @param values An array containing amounts of each token being transferred (order and length must match ids array) @param data Additional data with no specified format @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed */ function onERC1155BatchReceived( address operator, address from, uint256[] calldata ids, uint256[] calldata values, bytes calldata data ) external returns (bytes4); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC1155/extensions/IERC1155MetadataURI.sol) pragma solidity ^0.8.0; import "../IERC1155.sol"; /** * @dev Interface of the optional ERC1155MetadataExtension interface, as defined * in the https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[EIP]. * * _Available since v3.1._ */ interface IERC1155MetadataURI is IERC1155 { /** * @dev Returns the URI for token type `id`. * * If the `\{id\}` substring is present in the URI, it must be replaced by * clients with the actual token type ID. */ function uri(uint256 id) external view returns (string memory); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Address.sol) pragma solidity ^0.8.0; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize, which returns 0 for contracts in // construction, since the code is only stored at the end of the // constructor execution. uint256 size; assembly { size := extcodesize(account) } return size > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCall(target, data, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value ) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); require(isContract(target), "Address: call to non-contract"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { require(isContract(target), "Address: static call to non-contract"); (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { return functionDelegateCall(target, data, "Address: low-level delegate call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function functionDelegateCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { require(isContract(target), "Address: delegate call to non-contract"); (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Context.sol) pragma solidity ^0.8.0; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract Context { function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol) pragma solidity ^0.8.0; import "./IERC165.sol"; /** * @dev Implementation of the {IERC165} interface. * * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check * for the additional interface id that will be supported. For example: * * ```solidity * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId); * } * ``` * * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation. */ abstract contract ERC165 is IERC165 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IERC165).interfaceId; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[EIP]. * * Implementers can declare support of contract interfaces, which can then be * queried by others ({ERC165Checker}). * * For an implementation, see {ERC165}. */ interface IERC165 { /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (proxy/utils/Initializable.sol) pragma solidity ^0.8.0; import "../../utils/Address.sol"; /** * @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 a proxied contract can't have 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. * * 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 initialize the implementation contract, you can either invoke the * initializer manually, or you can include a constructor to automatically mark it as initialized when it is deployed: * * [.hljs-theme-light.nopadding] * ``` * /// @custom:oz-upgrades-unsafe-allow constructor * constructor() initializer {} * ``` * ==== */ abstract contract Initializable { /** * @dev Indicates that the contract has been initialized. */ bool private _initialized; /** * @dev Indicates that the contract is in the process of being initialized. */ bool private _initializing; /** * @dev Modifier to protect an initializer function from being invoked twice. */ modifier initializer() { // If the contract is initializing we ignore whether _initialized is set in order to support multiple // inheritance patterns, but we only do this in the context of a constructor, because in other contexts the // contract may have been reentered. require(_initializing ? _isConstructor() : !_initialized, "Initializable: contract is already initialized"); bool isTopLevelCall = !_initializing; if (isTopLevelCall) { _initializing = true; _initialized = true; } _; if (isTopLevelCall) { _initializing = false; } } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} modifier, directly or indirectly. */ modifier onlyInitializing() { require(_initializing, "Initializable: contract is not initializing"); _; } function _isConstructor() private view returns (bool) { return !Address.isContract(address(this)); } }
// SPDX-License-Identifier: Apache-2.0 pragma solidity ^0.8.0; // CREATE2 -- contract deployment. import "@openzeppelin/contracts/utils/Create2.sol"; // Access Control import "@openzeppelin/contracts/access/Ownable.sol"; // Protocol Components import { IControlDeployer } from "./interfaces/IControlDeployer.sol"; import { Forwarder } from "./Forwarder.sol"; import { ProtocolControl } from "./ProtocolControl.sol"; contract Registry is Ownable { uint256 public constant MAX_PROVIDER_FEE_BPS = 1000; // 10% uint256 public defaultFeeBps = 500; // 5% /// @dev service provider / admin treasury address public treasury; /// @dev `Forwarder` for meta-transacitons address public forwarder; /// @dev The Create2 `ProtocolControl` contract factory. IControlDeployer public deployer; struct ProtocolControls { // E.g. if `latestVersion == 2`, there are 2 `ProtocolControl` contracts deployed. uint256 latestVersion; // Mapping from version => contract address. mapping(uint256 => address) protocolControlAddress; } /// @dev Mapping from app deployer => versions + app addresses. mapping(address => ProtocolControls) private _protocolControls; /// @dev Mapping from app (protocol control) => protocol provider fees for the app. mapping(address => uint256) private protocolControlFeeBps; /// @dev Emitted when the treasury is updated. event TreasuryUpdated(address newTreasury); /// @dev Emitted when a new deployer is set. event DeployerUpdated(address newDeployer); /// @dev Emitted when the default protocol provider fees bps is updated. event DefaultFeeBpsUpdated(uint256 defaultFeeBps); /// @dev Emitted when the protocol provider fees bps for a particular `ProtocolControl` is updated. event ProtocolControlFeeBpsUpdated(address indexed control, uint256 feeBps); /// @dev Emitted when an instance of `ProtocolControl` is migrated to this registry. event MigratedProtocolControl(address indexed deployer, uint256 indexed version, address indexed controlAddress); /// @dev Emitted when an instance of `ProtocolControl` is deployed. event NewProtocolControl( address indexed deployer, uint256 indexed version, address indexed controlAddress, address controlDeployer ); constructor( address _treasury, address _forwarder, address _deployer ) { treasury = _treasury; forwarder = _forwarder; deployer = IControlDeployer(_deployer); } /// @dev Deploys `ProtocolControl` with `_msgSender()` as admin. function deployProtocol(string memory uri) external { // Get deployer address caller = _msgSender(); // Get version for deployment uint256 version = getNextVersion(caller); // Deploy contract and get deployment address. address controlAddress = deployer.deployControl(version, caller, uri); _protocolControls[caller].protocolControlAddress[version] = controlAddress; emit NewProtocolControl(caller, version, controlAddress, address(deployer)); } /// @dev Returns the latest version of protocol control. function getProtocolControlCount(address _deployer) external view returns (uint256) { return _protocolControls[_deployer].latestVersion; } /// @dev Returns the protocol control address for the given version. function getProtocolControl(address _deployer, uint256 index) external view returns (address) { return _protocolControls[_deployer].protocolControlAddress[index]; } /// @dev Lets the owner migrate `ProtocolControl` instances from a previous registry. function addProtocolControl(address _deployer, address _protocolControl) external onlyOwner { // Get version for protocolControl uint256 version = getNextVersion(_deployer); _protocolControls[_deployer].protocolControlAddress[version] = _protocolControl; emit MigratedProtocolControl(_deployer, version, _protocolControl); } /// @dev Sets a new `ProtocolControl` deployer in case `ProtocolControl` is upgraded. function setDeployer(address _newDeployer) external onlyOwner { deployer = IControlDeployer(_newDeployer); emit DeployerUpdated(_newDeployer); } /// @dev Sets a new protocol provider treasury address. function setTreasury(address _newTreasury) external onlyOwner { treasury = _newTreasury; emit TreasuryUpdated(_newTreasury); } /// @dev Sets a new `defaultFeeBps` for protocol provider fees. function setDefaultFeeBps(uint256 _newFeeBps) external onlyOwner { require(_newFeeBps <= MAX_PROVIDER_FEE_BPS, "Registry: provider fee cannot be greater than 10%"); defaultFeeBps = _newFeeBps; emit DefaultFeeBpsUpdated(_newFeeBps); } /// @dev Sets the protocol provider fee for a particular instance of `ProtocolControl`. function setProtocolControlFeeBps(address protocolControl, uint256 _newFeeBps) external onlyOwner { require(_newFeeBps <= MAX_PROVIDER_FEE_BPS, "Registry: provider fee cannot be greater than 10%"); protocolControlFeeBps[protocolControl] = _newFeeBps; emit ProtocolControlFeeBpsUpdated(protocolControl, _newFeeBps); } /// @dev Returns the protocol provider fee for a particular instance of `ProtocolControl`. function getFeeBps(address protocolControl) external view returns (uint256) { uint256 fees = protocolControlFeeBps[protocolControl]; if (fees == 0) { return defaultFeeBps; } return fees; } /// @dev Returns the next version of `ProtocolControl` for the given `_deployer`. function getNextVersion(address _deployer) internal returns (uint256) { // Increment version _protocolControls[_deployer].latestVersion += 1; return _protocolControls[_deployer].latestVersion; } }
// SPDX-License-Identifier: Apache-2.0 pragma solidity ^0.8.0; // Base import "./openzeppelin-presets/finance/PaymentSplitter.sol"; // Meta transactions import "@openzeppelin/contracts/metatx/ERC2771Context.sol"; import "@openzeppelin/contracts/utils/Multicall.sol"; import "@openzeppelin/contracts/access/AccessControlEnumerable.sol"; import { Registry } from "./Registry.sol"; import { ProtocolControl } from "./ProtocolControl.sol"; /** * Royalty automatically adds protocol provider (the registry) of protocol control to the payees * and shares that represent the fees. */ contract Royalty is PaymentSplitter, AccessControlEnumerable, ERC2771Context, Multicall { /// @dev The protocol control center. ProtocolControl private controlCenter; /// @dev Contract level metadata. string private _contractURI; modifier onlyModuleAdmin() { require(hasRole(DEFAULT_ADMIN_ROLE, _msgSender()), "only module admin role"); _; } /// @dev shares_ are scaled by 10,000 to prevent precision loss when including fees constructor( address payable _controlCenter, address _trustedForwarder, string memory _uri, address[] memory payees, uint256[] memory shares_ ) PaymentSplitter() ERC2771Context(_trustedForwarder) { require(payees.length == shares_.length, "Royalty: unequal number of payees and shares provided."); require(payees.length > 0, "Royalty: no payees provided."); // Set contract metadata _contractURI = _uri; // Set the protocol's control center. controlCenter = ProtocolControl(_controlCenter); Registry registry = Registry(controlCenter.registry()); uint256 feeBps = registry.getFeeBps(_controlCenter); uint256 totalScaledShares = 0; uint256 totalScaledSharesMinusFee = 0; // Scaling the share, so we don't lose precision on division for (uint256 i = 0; i < payees.length; i++) { uint256 scaledShares = shares_[i] * 10000; totalScaledShares += scaledShares; uint256 feeFromScaledShares = (scaledShares * feeBps) / 10000; uint256 scaledSharesMinusFee = scaledShares - feeFromScaledShares; totalScaledSharesMinusFee += scaledSharesMinusFee; // WARNING: Do not call _addPayee outside of this constructor. _addPayee(payees[i], scaledSharesMinusFee); } // WARNING: Do not call _addPayee outside of this constructor. uint256 totalFeeShares = totalScaledShares - totalScaledSharesMinusFee; _addPayee(registry.treasury(), totalFeeShares); _setupRole(DEFAULT_ADMIN_ROLE, _msgSender()); } /// @dev See ERC2771 function _msgSender() internal view virtual override(Context, ERC2771Context) returns (address sender) { return ERC2771Context._msgSender(); } /// @dev See ERC2771 function _msgData() internal view virtual override(Context, ERC2771Context) returns (bytes calldata) { return ERC2771Context._msgData(); } /// @dev Sets contract URI for the contract-level metadata of the contract. function setContractURI(string calldata _URI) external onlyModuleAdmin { _contractURI = _URI; } /// @dev Returns the URI for the contract-level metadata of the contract. function contractURI() public view returns (string memory) { return _contractURI; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/IAccessControlEnumerable.sol) pragma solidity ^0.8.0; import "./IAccessControl.sol"; /** * @dev External interface of AccessControlEnumerable declared to support ERC165 detection. */ interface IAccessControlEnumerable is IAccessControl { /** * @dev Returns one of the accounts that have `role`. `index` must be a * value between 0 and {getRoleMemberCount}, non-inclusive. * * Role bearers are not sorted in any particular way, and their ordering may * change at any point. * * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure * you perform all queries on the same block. See the following * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post] * for more information. */ function getRoleMember(bytes32 role, uint256 index) external view returns (address); /** * @dev Returns the number of accounts that have `role`. Can be used * together with {getRoleMember} to enumerate all bearers of a role. */ function getRoleMemberCount(bytes32 role) external view returns (uint256); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/AccessControl.sol) pragma solidity ^0.8.0; import "./IAccessControl.sol"; import "../utils/Context.sol"; import "../utils/Strings.sol"; import "../utils/introspection/ERC165.sol"; /** * @dev Contract module that allows children to implement role-based access * control mechanisms. This is a lightweight version that doesn't allow enumerating role * members except through off-chain means by accessing the contract event logs. Some * applications may benefit from on-chain enumerability, for those cases see * {AccessControlEnumerable}. * * Roles are referred to by their `bytes32` identifier. These should be exposed * in the external API and be unique. The best way to achieve this is by * using `public constant` hash digests: * * ``` * bytes32 public constant MY_ROLE = keccak256("MY_ROLE"); * ``` * * Roles can be used to represent a set of permissions. To restrict access to a * function call, use {hasRole}: * * ``` * function foo() public { * require(hasRole(MY_ROLE, msg.sender)); * ... * } * ``` * * Roles can be granted and revoked dynamically via the {grantRole} and * {revokeRole} functions. Each role has an associated admin role, and only * accounts that have a role's admin role can call {grantRole} and {revokeRole}. * * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means * that only accounts with this role will be able to grant or revoke other * roles. More complex role relationships can be created by using * {_setRoleAdmin}. * * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to * grant and revoke this role. Extra precautions should be taken to secure * accounts that have been granted it. */ abstract contract AccessControl is Context, IAccessControl, ERC165 { struct RoleData { mapping(address => bool) members; bytes32 adminRole; } mapping(bytes32 => RoleData) private _roles; bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00; /** * @dev Modifier that checks that an account has a specific role. Reverts * with a standardized message including the required role. * * The format of the revert reason is given by the following regular expression: * * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/ * * _Available since v4.1._ */ modifier onlyRole(bytes32 role) { _checkRole(role, _msgSender()); _; } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Returns `true` if `account` has been granted `role`. */ function hasRole(bytes32 role, address account) public view override returns (bool) { return _roles[role].members[account]; } /** * @dev Revert with a standard message if `account` is missing `role`. * * The format of the revert reason is given by the following regular expression: * * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/ */ function _checkRole(bytes32 role, address account) internal view { if (!hasRole(role, account)) { revert( string( abi.encodePacked( "AccessControl: account ", Strings.toHexString(uint160(account), 20), " is missing role ", Strings.toHexString(uint256(role), 32) ) ) ); } } /** * @dev Returns the admin role that controls `role`. See {grantRole} and * {revokeRole}. * * To change a role's admin, use {_setRoleAdmin}. */ function getRoleAdmin(bytes32 role) public view override returns (bytes32) { return _roles[role].adminRole; } /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) { _grantRole(role, account); } /** * @dev Revokes `role` from `account`. * * If `account` had been granted `role`, emits a {RoleRevoked} event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) { _revokeRole(role, account); } /** * @dev Revokes `role` from the calling account. * * Roles are often managed via {grantRole} and {revokeRole}: this function's * purpose is to provide a mechanism for accounts to lose their privileges * if they are compromised (such as when a trusted device is misplaced). * * If the calling account had been revoked `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. */ function renounceRole(bytes32 role, address account) public virtual override { require(account == _msgSender(), "AccessControl: can only renounce roles for self"); _revokeRole(role, account); } /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. Note that unlike {grantRole}, this function doesn't perform any * checks on the calling account. * * [WARNING] * ==== * This function should only be called from the constructor when setting * up the initial roles for the system. * * Using this function in any other way is effectively circumventing the admin * system imposed by {AccessControl}. * ==== * * NOTE: This function is deprecated in favor of {_grantRole}. */ function _setupRole(bytes32 role, address account) internal virtual { _grantRole(role, account); } /** * @dev Sets `adminRole` as ``role``'s admin role. * * Emits a {RoleAdminChanged} event. */ function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual { bytes32 previousAdminRole = getRoleAdmin(role); _roles[role].adminRole = adminRole; emit RoleAdminChanged(role, previousAdminRole, adminRole); } /** * @dev Grants `role` to `account`. * * Internal function without access restriction. */ function _grantRole(bytes32 role, address account) internal virtual { if (!hasRole(role, account)) { _roles[role].members[account] = true; emit RoleGranted(role, account, _msgSender()); } } /** * @dev Revokes `role` from `account`. * * Internal function without access restriction. */ function _revokeRole(bytes32 role, address account) internal virtual { if (hasRole(role, account)) { _roles[role].members[account] = false; emit RoleRevoked(role, account, _msgSender()); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/structs/EnumerableSet.sol) pragma solidity ^0.8.0; /** * @dev Library for managing * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive * types. * * Sets have the following properties: * * - Elements are added, removed, and checked for existence in constant time * (O(1)). * - Elements are enumerated in O(n). No guarantees are made on the ordering. * * ``` * contract Example { * // Add the library methods * using EnumerableSet for EnumerableSet.AddressSet; * * // Declare a set state variable * EnumerableSet.AddressSet private mySet; * } * ``` * * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`) * and `uint256` (`UintSet`) are supported. */ library EnumerableSet { // To implement this library for multiple types with as little code // repetition as possible, we write it in terms of a generic Set type with // bytes32 values. // The Set implementation uses private functions, and user-facing // implementations (such as AddressSet) are just wrappers around the // underlying Set. // This means that we can only create new EnumerableSets for types that fit // in bytes32. struct Set { // Storage of set values bytes32[] _values; // Position of the value in the `values` array, plus 1 because index 0 // means a value is not in the set. mapping(bytes32 => uint256) _indexes; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function _add(Set storage set, bytes32 value) private returns (bool) { if (!_contains(set, value)) { set._values.push(value); // The value is stored at length-1, but we add 1 to all indexes // and use 0 as a sentinel value set._indexes[value] = set._values.length; return true; } else { return false; } } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function _remove(Set storage set, bytes32 value) private returns (bool) { // We read and store the value's index to prevent multiple reads from the same storage slot uint256 valueIndex = set._indexes[value]; if (valueIndex != 0) { // Equivalent to contains(set, value) // To delete an element from the _values array in O(1), we swap the element to delete with the last one in // the array, and then remove the last element (sometimes called as 'swap and pop'). // This modifies the order of the array, as noted in {at}. uint256 toDeleteIndex = valueIndex - 1; uint256 lastIndex = set._values.length - 1; if (lastIndex != toDeleteIndex) { bytes32 lastvalue = set._values[lastIndex]; // Move the last value to the index where the value to delete is set._values[toDeleteIndex] = lastvalue; // Update the index for the moved value set._indexes[lastvalue] = valueIndex; // Replace lastvalue's index to valueIndex } // Delete the slot where the moved value was stored set._values.pop(); // Delete the index for the deleted slot delete set._indexes[value]; return true; } else { return false; } } /** * @dev Returns true if the value is in the set. O(1). */ function _contains(Set storage set, bytes32 value) private view returns (bool) { return set._indexes[value] != 0; } /** * @dev Returns the number of values on the set. O(1). */ function _length(Set storage set) private view returns (uint256) { return set._values.length; } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function _at(Set storage set, uint256 index) private view returns (bytes32) { return set._values[index]; } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function _values(Set storage set) private view returns (bytes32[] memory) { return set._values; } // Bytes32Set struct Bytes32Set { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _add(set._inner, value); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _remove(set._inner, value); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) { return _contains(set._inner, value); } /** * @dev Returns the number of values in the set. O(1). */ function length(Bytes32Set storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) { return _at(set._inner, index); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(Bytes32Set storage set) internal view returns (bytes32[] memory) { return _values(set._inner); } // AddressSet struct AddressSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(AddressSet storage set, address value) internal returns (bool) { return _add(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(AddressSet storage set, address value) internal returns (bool) { return _remove(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(AddressSet storage set, address value) internal view returns (bool) { return _contains(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns the number of values in the set. O(1). */ function length(AddressSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(AddressSet storage set, uint256 index) internal view returns (address) { return address(uint160(uint256(_at(set._inner, index)))); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(AddressSet storage set) internal view returns (address[] memory) { bytes32[] memory store = _values(set._inner); address[] memory result; assembly { result := store } return result; } // UintSet struct UintSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(UintSet storage set, uint256 value) internal returns (bool) { return _add(set._inner, bytes32(value)); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(UintSet storage set, uint256 value) internal returns (bool) { return _remove(set._inner, bytes32(value)); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(UintSet storage set, uint256 value) internal view returns (bool) { return _contains(set._inner, bytes32(value)); } /** * @dev Returns the number of values on the set. O(1). */ function length(UintSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(UintSet storage set, uint256 index) internal view returns (uint256) { return uint256(_at(set._inner, index)); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(UintSet storage set) internal view returns (uint256[] memory) { bytes32[] memory store = _values(set._inner); uint256[] memory result; assembly { result := store } return result; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol) pragma solidity ^0.8.0; /** * @dev External interface of AccessControl declared to support ERC165 detection. */ interface IAccessControl { /** * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole` * * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite * {RoleAdminChanged} not being emitted signaling this. * * _Available since v3.1._ */ event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole); /** * @dev Emitted when `account` is granted `role`. * * `sender` is the account that originated the contract call, an admin role * bearer except when using {AccessControl-_setupRole}. */ event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender); /** * @dev Emitted when `account` is revoked `role`. * * `sender` is the account that originated the contract call: * - if using `revokeRole`, it is the admin role bearer * - if using `renounceRole`, it is the role bearer (i.e. `account`) */ event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender); /** * @dev Returns `true` if `account` has been granted `role`. */ function hasRole(bytes32 role, address account) external view returns (bool); /** * @dev Returns the admin role that controls `role`. See {grantRole} and * {revokeRole}. * * To change a role's admin, use {AccessControl-_setRoleAdmin}. */ function getRoleAdmin(bytes32 role) external view returns (bytes32); /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function grantRole(bytes32 role, address account) external; /** * @dev Revokes `role` from `account`. * * If `account` had been granted `role`, emits a {RoleRevoked} event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function revokeRole(bytes32 role, address account) external; /** * @dev Revokes `role` from the calling account. * * Roles are often managed via {grantRole} and {revokeRole}: this function's * purpose is to provide a mechanism for accounts to lose their privileges * if they are compromised (such as when a trusted device is misplaced). * * If the calling account had been granted `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. */ function renounceRole(bytes32 role, address account) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Create2.sol) pragma solidity ^0.8.0; /** * @dev Helper to make usage of the `CREATE2` EVM opcode easier and safer. * `CREATE2` can be used to compute in advance the address where a smart * contract will be deployed, which allows for interesting new mechanisms known * as 'counterfactual interactions'. * * See the https://eips.ethereum.org/EIPS/eip-1014#motivation[EIP] for more * information. */ library Create2 { /** * @dev Deploys a contract using `CREATE2`. The address where the contract * will be deployed can be known in advance via {computeAddress}. * * The bytecode for a contract can be obtained from Solidity with * `type(contractName).creationCode`. * * Requirements: * * - `bytecode` must not be empty. * - `salt` must have not been used for `bytecode` already. * - the factory must have a balance of at least `amount`. * - if `amount` is non-zero, `bytecode` must have a `payable` constructor. */ function deploy( uint256 amount, bytes32 salt, bytes memory bytecode ) internal returns (address) { address addr; require(address(this).balance >= amount, "Create2: insufficient balance"); require(bytecode.length != 0, "Create2: bytecode length is zero"); assembly { addr := create2(amount, add(bytecode, 0x20), mload(bytecode), salt) } require(addr != address(0), "Create2: Failed on deploy"); return addr; } /** * @dev Returns the address where a contract will be stored if deployed via {deploy}. Any change in the * `bytecodeHash` or `salt` will result in a new destination address. */ function computeAddress(bytes32 salt, bytes32 bytecodeHash) internal view returns (address) { return computeAddress(salt, bytecodeHash, address(this)); } /** * @dev Returns the address where a contract will be stored if deployed via {deploy} from a contract located at * `deployer`. If `deployer` is this contract's address, returns the same value as {computeAddress}. */ function computeAddress( bytes32 salt, bytes32 bytecodeHash, address deployer ) internal pure returns (address) { bytes32 _data = keccak256(abi.encodePacked(bytes1(0xff), deployer, salt, bytecodeHash)); return address(uint160(uint256(_data))); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/Ownable.sol) pragma solidity ^0.8.0; import "../utils/Context.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * By default, the owner account will be the one that deploys the contract. This * can later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract Ownable is Context { address private _owner; event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the deployer as the initial owner. */ constructor() { _transferOwnership(_msgSender()); } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { require(owner() == _msgSender(), "Ownable: caller is not the owner"); _; } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions anymore. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby removing any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { require(newOwner != address(0), "Ownable: new owner is the zero address"); _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } }
// SPDX-License-Identifier: Apache-2.0 pragma solidity ^0.8.0; interface IControlDeployer { /// @dev Emitted when an instance of `ProtocolControl` is deployed. event DeployedControl(address indexed registry, address indexed deployer, address indexed control); /// @dev Deploys an instance of `ProtocolControl` function deployControl( uint256 nonce, address deployer, string memory uri ) external returns (address); }
// SPDX-License-Identifier: Apache-2.0 pragma solidity ^0.8.0; import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol"; import "@openzeppelin/contracts/utils/cryptography/draft-EIP712.sol"; /* * @dev Minimal forwarder for GSNv2 */ contract Forwarder is EIP712 { using ECDSA for bytes32; struct ForwardRequest { address from; address to; uint256 value; uint256 gas; uint256 nonce; bytes data; } bytes32 private constant TYPEHASH = keccak256("ForwardRequest(address from,address to,uint256 value,uint256 gas,uint256 nonce,bytes data)"); mapping(address => uint256) private _nonces; constructor() EIP712("GSNv2 Forwarder", "0.0.1") {} function getNonce(address from) public view returns (uint256) { return _nonces[from]; } function verify(ForwardRequest calldata req, bytes calldata signature) public view returns (bool) { address signer = _hashTypedDataV4( keccak256(abi.encode(TYPEHASH, req.from, req.to, req.value, req.gas, req.nonce, keccak256(req.data))) ).recover(signature); return _nonces[req.from] == req.nonce && signer == req.from; } function execute(ForwardRequest calldata req, bytes calldata signature) public payable returns (bool, bytes memory) { require(verify(req, signature), "MinimalForwarder: signature does not match request"); _nonces[req.from] = req.nonce + 1; // solhint-disable-next-line avoid-low-level-calls (bool success, bytes memory result) = req.to.call{ gas: req.gas, value: req.value }( abi.encodePacked(req.data, req.from) ); if (!success) { // Next 5 lines from https://ethereum.stackexchange.com/a/83577 if (result.length < 68) revert("Transaction reverted silently"); assembly { result := add(result, 0x04) } revert(abi.decode(result, (string))); } // Check gas: https://ronan.eth.link/blog/ethereum-gas-dangers/ assert(gasleft() > req.gas / 63); return (success, result); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/cryptography/ECDSA.sol) pragma solidity ^0.8.0; import "../Strings.sol"; /** * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations. * * These functions can be used to verify that a message was signed by the holder * of the private keys of a given address. */ library ECDSA { enum RecoverError { NoError, InvalidSignature, InvalidSignatureLength, InvalidSignatureS, InvalidSignatureV } function _throwError(RecoverError error) private pure { if (error == RecoverError.NoError) { return; // no error: do nothing } else if (error == RecoverError.InvalidSignature) { revert("ECDSA: invalid signature"); } else if (error == RecoverError.InvalidSignatureLength) { revert("ECDSA: invalid signature length"); } else if (error == RecoverError.InvalidSignatureS) { revert("ECDSA: invalid signature 's' value"); } else if (error == RecoverError.InvalidSignatureV) { revert("ECDSA: invalid signature 'v' value"); } } /** * @dev Returns the address that signed a hashed message (`hash`) with * `signature` or error string. This address can then be used for verification purposes. * * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures: * this function rejects them by requiring the `s` value to be in the lower * half order, and the `v` value to be either 27 or 28. * * IMPORTANT: `hash` _must_ be the result of a hash operation for the * verification to be secure: it is possible to craft signatures that * recover to arbitrary addresses for non-hashed data. A safe way to ensure * this is by receiving a hash of the original message (which may otherwise * be too long), and then calling {toEthSignedMessageHash} on it. * * Documentation for signature generation: * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js] * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers] * * _Available since v4.3._ */ function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) { // Check the signature length // - case 65: r,s,v signature (standard) // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._ if (signature.length == 65) { bytes32 r; bytes32 s; uint8 v; // ecrecover takes the signature parameters, and the only way to get them // currently is to use assembly. assembly { r := mload(add(signature, 0x20)) s := mload(add(signature, 0x40)) v := byte(0, mload(add(signature, 0x60))) } return tryRecover(hash, v, r, s); } else if (signature.length == 64) { bytes32 r; bytes32 vs; // ecrecover takes the signature parameters, and the only way to get them // currently is to use assembly. assembly { r := mload(add(signature, 0x20)) vs := mload(add(signature, 0x40)) } return tryRecover(hash, r, vs); } else { return (address(0), RecoverError.InvalidSignatureLength); } } /** * @dev Returns the address that signed a hashed message (`hash`) with * `signature`. This address can then be used for verification purposes. * * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures: * this function rejects them by requiring the `s` value to be in the lower * half order, and the `v` value to be either 27 or 28. * * IMPORTANT: `hash` _must_ be the result of a hash operation for the * verification to be secure: it is possible to craft signatures that * recover to arbitrary addresses for non-hashed data. A safe way to ensure * this is by receiving a hash of the original message (which may otherwise * be too long), and then calling {toEthSignedMessageHash} on it. */ function recover(bytes32 hash, bytes memory signature) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, signature); _throwError(error); return recovered; } /** * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately. * * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures] * * _Available since v4.3._ */ function tryRecover( bytes32 hash, bytes32 r, bytes32 vs ) internal pure returns (address, RecoverError) { bytes32 s; uint8 v; assembly { s := and(vs, 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff) v := add(shr(255, vs), 27) } return tryRecover(hash, v, r, s); } /** * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately. * * _Available since v4.2._ */ function recover( bytes32 hash, bytes32 r, bytes32 vs ) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, r, vs); _throwError(error); return recovered; } /** * @dev Overload of {ECDSA-tryRecover} that receives the `v`, * `r` and `s` signature fields separately. * * _Available since v4.3._ */ function tryRecover( bytes32 hash, uint8 v, bytes32 r, bytes32 s ) internal pure returns (address, RecoverError) { // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most // signatures from current libraries generate a unique signature with an s-value in the lower half order. // // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept // these malleable signatures as well. if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) { return (address(0), RecoverError.InvalidSignatureS); } if (v != 27 && v != 28) { return (address(0), RecoverError.InvalidSignatureV); } // If the signature is valid (and not malleable), return the signer address address signer = ecrecover(hash, v, r, s); if (signer == address(0)) { return (address(0), RecoverError.InvalidSignature); } return (signer, RecoverError.NoError); } /** * @dev Overload of {ECDSA-recover} that receives the `v`, * `r` and `s` signature fields separately. */ function recover( bytes32 hash, uint8 v, bytes32 r, bytes32 s ) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, v, r, s); _throwError(error); return recovered; } /** * @dev Returns an Ethereum Signed Message, created from a `hash`. This * produces hash corresponding to the one signed with the * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] * JSON-RPC method as part of EIP-191. * * See {recover}. */ function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) { // 32 is the length in bytes of hash, // enforced by the type signature above return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash)); } /** * @dev Returns an Ethereum Signed Message, created from `s`. This * produces hash corresponding to the one signed with the * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] * JSON-RPC method as part of EIP-191. * * See {recover}. */ function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) { return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", Strings.toString(s.length), s)); } /** * @dev Returns an Ethereum Signed Typed Data, created from a * `domainSeparator` and a `structHash`. This produces hash corresponding * to the one signed with the * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`] * JSON-RPC method as part of EIP-712. * * See {recover}. */ function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) { return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/cryptography/draft-EIP712.sol) pragma solidity ^0.8.0; import "./ECDSA.sol"; /** * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data. * * The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible, * thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding * they need in their contracts using a combination of `abi.encode` and `keccak256`. * * This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding * scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA * ({_hashTypedDataV4}). * * The implementation of the domain separator was designed to be as efficient as possible while still properly updating * the chain id to protect against replay attacks on an eventual fork of the chain. * * NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method * https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask]. * * _Available since v3.4._ */ abstract contract EIP712 { /* solhint-disable var-name-mixedcase */ // Cache the domain separator as an immutable value, but also store the chain id that it corresponds to, in order to // invalidate the cached domain separator if the chain id changes. bytes32 private immutable _CACHED_DOMAIN_SEPARATOR; uint256 private immutable _CACHED_CHAIN_ID; address private immutable _CACHED_THIS; bytes32 private immutable _HASHED_NAME; bytes32 private immutable _HASHED_VERSION; bytes32 private immutable _TYPE_HASH; /* solhint-enable var-name-mixedcase */ /** * @dev Initializes the domain separator and parameter caches. * * The meaning of `name` and `version` is specified in * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]: * * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol. * - `version`: the current major version of the signing domain. * * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart * contract upgrade]. */ constructor(string memory name, string memory version) { bytes32 hashedName = keccak256(bytes(name)); bytes32 hashedVersion = keccak256(bytes(version)); bytes32 typeHash = keccak256( "EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)" ); _HASHED_NAME = hashedName; _HASHED_VERSION = hashedVersion; _CACHED_CHAIN_ID = block.chainid; _CACHED_DOMAIN_SEPARATOR = _buildDomainSeparator(typeHash, hashedName, hashedVersion); _CACHED_THIS = address(this); _TYPE_HASH = typeHash; } /** * @dev Returns the domain separator for the current chain. */ function _domainSeparatorV4() internal view returns (bytes32) { if (address(this) == _CACHED_THIS && block.chainid == _CACHED_CHAIN_ID) { return _CACHED_DOMAIN_SEPARATOR; } else { return _buildDomainSeparator(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION); } } function _buildDomainSeparator( bytes32 typeHash, bytes32 nameHash, bytes32 versionHash ) private view returns (bytes32) { return keccak256(abi.encode(typeHash, nameHash, versionHash, block.chainid, address(this))); } /** * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this * function returns the hash of the fully encoded EIP712 message for this domain. * * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example: * * ```solidity * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode( * keccak256("Mail(address to,string contents)"), * mailTo, * keccak256(bytes(mailContents)) * ))); * address signer = ECDSA.recover(digest, signature); * ``` */ function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) { return ECDSA.toTypedDataHash(_domainSeparatorV4(), structHash); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol"; import "@openzeppelin/contracts/utils/Address.sol"; import "@openzeppelin/contracts/utils/Context.sol"; /** * Changelog: * 1. Remove add payees and shares in the constructor, so inherited class is responsible for adding. * 2. Change _addPayee(...) visibility to internal. DANGEROUS: Make sure it is not called outside from constructor * initialization. * 3. Add distribute(...) to distribute all owed amount to all payees. * 4. Add payeeCount() view to returns the number of payees. */ /** * @title PaymentSplitter * @dev This contract allows to split Ether payments among a group of accounts. The sender does not need to be aware * that the Ether will be split in this way, since it is handled transparently by the contract. * * The split can be in equal parts or in any other arbitrary proportion. The way this is specified is by assigning each * account to a number of shares. Of all the Ether that this contract receives, each account will then be able to claim * an amount proportional to the percentage of total shares they were assigned. * * `PaymentSplitter` follows a _pull payment_ model. This means that payments are not automatically forwarded to the * accounts but kept in this contract, and the actual transfer is triggered as a separate step by calling the {release} * function. * * NOTE: This contract assumes that ERC20 tokens will behave similarly to native tokens (Ether). Rebasing tokens, and * tokens that apply fees during transfers, are likely to not be supported as expected. If in doubt, we encourage you * to run tests before sending real value to this contract. */ contract PaymentSplitter is Context { event PayeeAdded(address account, uint256 shares); event PaymentReleased(address to, uint256 amount); event ERC20PaymentReleased(IERC20 indexed token, address to, uint256 amount); event PaymentReceived(address from, uint256 amount); uint256 private _totalShares; uint256 private _totalReleased; mapping(address => uint256) private _shares; mapping(address => uint256) private _released; address[] private _payees; mapping(IERC20 => uint256) private _erc20TotalReleased; mapping(IERC20 => mapping(address => uint256)) private _erc20Released; /** * @dev Creates an instance of `PaymentSplitter` where each account in `payees` is assigned the number of shares at * the matching position in the `shares` array. * * All addresses in `payees` must be non-zero. Both arrays must have the same non-zero length, and there must be no * duplicates in `payees`. */ constructor() payable {} /** * @dev The Ether received will be logged with {PaymentReceived} events. Note that these events are not fully * reliable: it's possible for a contract to receive Ether without triggering this function. This only affects the * reliability of the events, and not the actual splitting of Ether. * * To learn more about this see the Solidity documentation for * https://solidity.readthedocs.io/en/latest/contracts.html#fallback-function[fallback * functions]. */ receive() external payable virtual { emit PaymentReceived(_msgSender(), msg.value); } /** * @dev Getter for the total shares held by payees. */ function totalShares() public view returns (uint256) { return _totalShares; } /** * @dev Getter for the total amount of Ether already released. */ function totalReleased() public view returns (uint256) { return _totalReleased; } /** * @dev Getter for the total amount of `token` already released. `token` should be the address of an IERC20 * contract. */ function totalReleased(IERC20 token) public view returns (uint256) { return _erc20TotalReleased[token]; } /** * @dev Getter for the amount of shares held by an account. */ function shares(address account) public view returns (uint256) { return _shares[account]; } /** * @dev Getter for the amount of Ether already released to a payee. */ function released(address account) public view returns (uint256) { return _released[account]; } /** * @dev Getter for the amount of `token` tokens already released to a payee. `token` should be the address of an * IERC20 contract. */ function released(IERC20 token, address account) public view returns (uint256) { return _erc20Released[token][account]; } /** * @dev Getter for the address of the payee number `index`. */ function payee(uint256 index) public view returns (address) { return _payees[index]; } /** * @dev Getter for getting the number of payee */ function payeeCount() public view returns (uint256) { return _payees.length; } /** * @dev Triggers a transfer to `account` of the amount of Ether they are owed, according to their percentage of the * total shares and their previous withdrawals. */ function release(address payable account) public virtual { require(_shares[account] > 0, "PaymentSplitter: account has no shares"); uint256 totalReceived = address(this).balance + totalReleased(); uint256 payment = _pendingPayment(account, totalReceived, released(account)); require(payment != 0, "PaymentSplitter: account is not due payment"); _released[account] += payment; _totalReleased += payment; Address.sendValue(account, payment); emit PaymentReleased(account, payment); } /** * @dev Triggers a transfer to `account` of the amount of `token` tokens they are owed, according to their * percentage of the total shares and their previous withdrawals. `token` must be the address of an IERC20 * contract. */ function release(IERC20 token, address account) public virtual { require(_shares[account] > 0, "PaymentSplitter: account has no shares"); uint256 totalReceived = token.balanceOf(address(this)) + totalReleased(token); uint256 payment = _pendingPayment(account, totalReceived, released(token, account)); require(payment != 0, "PaymentSplitter: account is not due payment"); _erc20Released[token][account] += payment; _erc20TotalReleased[token] += payment; SafeERC20.safeTransfer(token, account, payment); emit ERC20PaymentReleased(token, account, payment); } /** * @dev Release the owed amount of token to all of the payees. */ function distribute() public virtual { for (uint256 i = 0; i < _payees.length; i++) { release(payable(_payees[i])); } } /** * @dev Release owed amount of the `token` to all of the payees. */ function distribute(IERC20 token) public virtual { for (uint256 i = 0; i < _payees.length; i++) { release(token, _payees[i]); } } /** * @dev internal logic for computing the pending payment of an `account` given the token historical balances and * already released amounts. */ function _pendingPayment( address account, uint256 totalReceived, uint256 alreadyReleased ) private view returns (uint256) { return (totalReceived * _shares[account]) / _totalShares - alreadyReleased; } /** * @dev Add a new payee to the contract. * @param account The address of the payee to add. * @param shares_ The number of shares owned by the payee. */ function _addPayee(address account, uint256 shares_) internal { require(account != address(0), "PaymentSplitter: account is the zero address"); require(shares_ > 0, "PaymentSplitter: shares are 0"); require(_shares[account] == 0, "PaymentSplitter: account already has shares"); _payees.push(account); _shares[account] = shares_; _totalShares = _totalShares + shares_; emit PayeeAdded(account, shares_); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC20/utils/SafeERC20.sol) pragma solidity ^0.8.0; import "../IERC20.sol"; import "../../../utils/Address.sol"; /** * @title SafeERC20 * @dev Wrappers around ERC20 operations that throw on failure (when the token * contract returns false). Tokens that return no value (and instead revert or * throw on failure) are also supported, non-reverting calls are assumed to be * successful. * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract, * which allows you to call the safe operations as `token.safeTransfer(...)`, etc. */ library SafeERC20 { using Address for address; function safeTransfer( IERC20 token, address to, uint256 value ) internal { _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value)); } function safeTransferFrom( IERC20 token, address from, address to, uint256 value ) internal { _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value)); } /** * @dev Deprecated. This function has issues similar to the ones found in * {IERC20-approve}, and its usage is discouraged. * * Whenever possible, use {safeIncreaseAllowance} and * {safeDecreaseAllowance} instead. */ function safeApprove( IERC20 token, address spender, uint256 value ) internal { // safeApprove should only be called when setting an initial allowance, // or when resetting it to zero. To increase and decrease it, use // 'safeIncreaseAllowance' and 'safeDecreaseAllowance' require( (value == 0) || (token.allowance(address(this), spender) == 0), "SafeERC20: approve from non-zero to non-zero allowance" ); _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value)); } function safeIncreaseAllowance( IERC20 token, address spender, uint256 value ) internal { uint256 newAllowance = token.allowance(address(this), spender) + value; _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance)); } function safeDecreaseAllowance( IERC20 token, address spender, uint256 value ) internal { unchecked { uint256 oldAllowance = token.allowance(address(this), spender); require(oldAllowance >= value, "SafeERC20: decreased allowance below zero"); uint256 newAllowance = oldAllowance - value; _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance)); } } /** * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement * on the return value: the return value is optional (but if data is returned, it must not be false). * @param token The token targeted by the call. * @param data The call data (encoded using abi.encode or one of its variants). */ function _callOptionalReturn(IERC20 token, bytes memory data) private { // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that // the target address contains contract code and also asserts for success in the low-level call. bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed"); if (returndata.length > 0) { // Return data is optional require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed"); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (interfaces/IERC165.sol) pragma solidity ^0.8.0; import "../utils/introspection/IERC165.sol";
{ "metadata": { "bytecodeHash": "none" }, "optimizer": { "enabled": true, "runs": 800 }, "outputSelection": { "*": { "*": [ "evm.bytecode", "evm.deployedBytecode", "devdoc", "userdoc", "metadata", "abi" ] } }, "libraries": {} }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[{"internalType":"string","name":"_contractURI","type":"string"},{"internalType":"address payable","name":"_controlCenter","type":"address"},{"internalType":"address","name":"_trustedForwarder","type":"address"},{"internalType":"address","name":"_nativeTokenWrapper","type":"address"},{"internalType":"address","name":"_saleRecipient","type":"address"},{"internalType":"uint128","name":"_royaltyBps","type":"uint128"},{"internalType":"uint128","name":"_feeBps","type":"uint128"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","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":"uint256","name":"claimConditionIndex","type":"uint256"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"claimer","type":"address"},{"indexed":false,"internalType":"uint256","name":"quantityClaimed","type":"uint256"}],"name":"ClaimedTokens","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"startTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"endTokenId","type":"uint256"},{"indexed":false,"internalType":"string","name":"baseURI","type":"string"}],"name":"LazyMintedTokens","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"},{"components":[{"internalType":"uint256","name":"startTimestamp","type":"uint256"},{"internalType":"uint256","name":"maxClaimableSupply","type":"uint256"},{"internalType":"uint256","name":"supplyClaimed","type":"uint256"},{"internalType":"uint256","name":"quantityLimitPerTransaction","type":"uint256"},{"internalType":"uint256","name":"waitTimeInSecondsBetweenClaims","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"},{"internalType":"uint256","name":"pricePerToken","type":"uint256"},{"internalType":"address","name":"currency","type":"address"}],"indexed":false,"internalType":"struct ILazyMintERC1155.ClaimCondition[]","name":"claimConditions","type":"tuple[]"}],"name":"NewClaimConditions","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"prevOwner","type":"address"},{"indexed":false,"internalType":"address","name":"newOwner","type":"address"}],"name":"NewOwner","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"recipient","type":"address"},{"indexed":true,"internalType":"uint256","name":"_tokenId","type":"uint256"},{"indexed":false,"internalType":"bool","name":"isDefaultRecipient","type":"bool"}],"name":"NewSaleRecipient","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"newFeeBps","type":"uint256"}],"name":"PrimarySalesFeeUpdates","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"newRoyaltyBps","type":"uint256"}],"name":"RoyaltyUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"values","type":"uint256[]"}],"name":"TransferBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"TransferSingle","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"restricted","type":"bool"}],"name":"TransfersRestricted","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"value","type":"string"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"}],"name":"URI","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MINTER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"NATIVE_TOKEN","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"TRANSFER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"}],"name":"balanceOfBatch","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"values","type":"uint256[]"}],"name":"burnBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint256","name":"_quantity","type":"uint256"},{"internalType":"bytes32[]","name":"_proofs","type":"bytes32[]"}],"name":"claim","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"claimConditions","outputs":[{"internalType":"uint256","name":"totalConditionCount","type":"uint256"},{"internalType":"uint256","name":"timstampLimitIndex","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"contractURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"defaultSaleRecipient","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"feeBps","outputs":[{"internalType":"uint120","name":"","type":"uint120"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint256","name":"_index","type":"uint256"}],"name":"getClaimConditionAtIndex","outputs":[{"components":[{"internalType":"uint256","name":"startTimestamp","type":"uint256"},{"internalType":"uint256","name":"maxClaimableSupply","type":"uint256"},{"internalType":"uint256","name":"supplyClaimed","type":"uint256"},{"internalType":"uint256","name":"quantityLimitPerTransaction","type":"uint256"},{"internalType":"uint256","name":"waitTimeInSecondsBetweenClaims","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"},{"internalType":"uint256","name":"pricePerToken","type":"uint256"},{"internalType":"address","name":"currency","type":"address"}],"internalType":"struct ILazyMintERC1155.ClaimCondition","name":"mintCondition","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"getIndexOfActiveCondition","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getRoleMember","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleMemberCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint256","name":"_index","type":"uint256"},{"internalType":"address","name":"_claimer","type":"address"}],"name":"getTimestampForNextValidClaim","outputs":[{"internalType":"uint256","name":"nextValidTimestampForClaim","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"forwarder","type":"address"}],"name":"isTrustedForwarder","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"string","name":"_baseURIForTokens","type":"string"}],"name":"lazyMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes[]","name":"data","type":"bytes[]"}],"name":"multicall","outputs":[{"internalType":"bytes[]","name":"results","type":"bytes[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"nativeTokenWrapper","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nextTokenIdToMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"royaltyBps","outputs":[{"internalType":"uint64","name":"","type":"uint64"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"royaltyAmount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeBatchTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"saleRecipient","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"components":[{"internalType":"uint256","name":"startTimestamp","type":"uint256"},{"internalType":"uint256","name":"maxClaimableSupply","type":"uint256"},{"internalType":"uint256","name":"supplyClaimed","type":"uint256"},{"internalType":"uint256","name":"quantityLimitPerTransaction","type":"uint256"},{"internalType":"uint256","name":"waitTimeInSecondsBetweenClaims","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"},{"internalType":"uint256","name":"pricePerToken","type":"uint256"},{"internalType":"address","name":"currency","type":"address"}],"internalType":"struct ILazyMintERC1155.ClaimCondition[]","name":"_conditions","type":"tuple[]"}],"name":"setClaimConditions","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"_uri","type":"string"}],"name":"setContractURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_saleRecipient","type":"address"}],"name":"setDefaultSaleRecipient","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_feeBps","type":"uint256"}],"name":"setFeeBps","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_newOwner","type":"address"}],"name":"setOwner","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"_restrictedTransfer","type":"bool"}],"name":"setRestrictedTransfer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_royaltyBps","type":"uint256"}],"name":"setRoyaltyBps","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"address","name":"_saleRecipient","type":"address"}],"name":"setSaleRecipient","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":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"_tokenURI","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"transfersRestricted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"components":[{"internalType":"uint256","name":"startTimestamp","type":"uint256"},{"internalType":"uint256","name":"maxClaimableSupply","type":"uint256"},{"internalType":"uint256","name":"supplyClaimed","type":"uint256"},{"internalType":"uint256","name":"quantityLimitPerTransaction","type":"uint256"},{"internalType":"uint256","name":"waitTimeInSecondsBetweenClaims","type":"uint256"},{"internalType":"bytes32","name":"merkleRoot","type":"bytes32"},{"internalType":"uint256","name":"pricePerToken","type":"uint256"},{"internalType":"address","name":"currency","type":"address"}],"internalType":"struct ILazyMintERC1155.ClaimCondition[]","name":"_conditions","type":"tuple[]"}],"name":"updateClaimConditions","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"uri","outputs":[{"internalType":"string","name":"_tokenURI","type":"string"}],"stateMutability":"view","type":"function"}]
Contract Creation Code
60a06040523480156200001157600080fd5b5060405162005daa38038062005daa833981016040819052620000349162000446565b604080516020810190915260008152859062000050816200017c565b50600380546001600160a01b03199081166001600160a01b03938416179091556001600655600c80548216898416179055858216608052600880549091169185169190911790558651620000ac90600b9060208a019062000355565b50600a80546001600160781b03831668010000000000000000026001600160b81b03199091166001600160401b038516171790556000620000ec62000195565b600780546001600160a01b0319166001600160a01b038316179055905062000116600082620001b1565b620001427f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a682620001b1565b6200016e7f8502233096d909befbda0999bb8ea2f3a6be3c138b9fbf003752a4c8bce86f6c82620001b1565b5050505050505050620005d1565b80516200019190600290602084019062000355565b5050565b6000620001ac620001bd60201b620020651760201c565b905090565b620001918282620001f6565b6003546000906001600160a01b0316331415620001e1575060131936013560601c90565b620001ac6200023960201b620020901760201c565b6200020d82826200023d60201b620020941760201c565b60008281526005602090815260409091206200023491839062002137620002e3821b17901c565b505050565b3390565b60008281526004602090815260408083206001600160a01b038516845290915290205460ff16620001915760008281526004602090815260408083206001600160a01b03851684529091529020805460ff191660011790556200029f62000195565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000620002fa836001600160a01b03841662000303565b90505b92915050565b60008181526001830160205260408120546200034c57508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155620002fd565b506000620002fd565b828054620003639062000594565b90600052602060002090601f016020900481019282620003875760008555620003d2565b82601f10620003a257805160ff1916838001178555620003d2565b82800160010185558215620003d2579182015b82811115620003d2578251825591602001919060010190620003b5565b50620003e0929150620003e4565b5090565b5b80821115620003e05760008155600101620003e5565b634e487b7160e01b600052604160045260246000fd5b80516001600160a01b03811681146200042957600080fd5b919050565b80516001600160801b03811681146200042957600080fd5b600080600080600080600060e0888a0312156200046257600080fd5b87516001600160401b03808211156200047a57600080fd5b818a0191508a601f8301126200048f57600080fd5b815181811115620004a457620004a4620003fb565b604051601f8201601f19908116603f01168101908382118183101715620004cf57620004cf620003fb565b81604052828152602093508d84848701011115620004ec57600080fd5b600091505b82821015620005105784820184015181830185015290830190620004f1565b82821115620005225760008484830101525b9a50620005349150508a820162000411565b97505050620005466040890162000411565b9450620005566060890162000411565b9350620005666080890162000411565b92506200057660a089016200042e565b91506200058660c089016200042e565b905092959891949750929550565b600181811c90821680620005a957607f821691505b60208210811415620005cb57634e487b7160e01b600052602260045260246000fd5b50919050565b6080516157a16200060960003960008181610b4d01528181613f16015281816140110152818161452d01526145a401526157a16000f3fe6080604052600436106103285760003560e01c80638ba448c2116101a5578063c63adb2b116100ec578063d547741f11610095578063eb56a8e51161006f578063eb56a8e514610adb578063f242432a14610afb578063f5298aca14610b1b578063f9ea29cb14610b3b57600080fd5b8063d547741f14610a5d578063e8a3d48514610a7d578063e985e9c514610a9257600080fd5b8063ca15c873116100c6578063ca15c8731461097f578063cc9599141461099f578063d539139314610a2957600080fd5b8063c63adb2b146108ef578063c7337d6b14610929578063c87b56dd1461095f57600080fd5b80639e45e4661161014e578063ac9650d811610128578063ac9650d814610882578063ae0b51df146108af578063bd85b039146108c257600080fd5b80639e45e4661461082d578063a217fddf1461084d578063a22cb4651461086257600080fd5b80639010d07c1161017f5780639010d07c146107a757806391d14854146107c7578063938e3d7b1461080d57600080fd5b80638ba448c2146107525780638d8b4f38146107725780638da5cb5b1461079257600080fd5b80632f2ff15d116102745780634e1273f41161021d57806372c27b62116101f757806372c27b62146106a857806372cc0198146106c85780638423df79146106e8578063860ec5d11461070957600080fd5b80634e1273f41461062c578063572b6c05146106595780636b20c4541461068857600080fd5b80633b1475a71161024e5780633b1475a7146105d657806347158264146105ec5780634d4529a01461060c57600080fd5b80632f2ff15d1461056e57806331f7d9641461058e57806336568abe146105b657600080fd5b8063206b60f9116102d657806324a9d853116102b057806324a9d853146104bb5780632a55205a1461050f5780632eb2c2d61461054e57600080fd5b8063206b60f91461041f578063246b436b14610453578063248a9ca31461048b57600080fd5b806313af40351161030757806313af4035146103bd5780631490ee76146103df5780631f72d831146103ff57600080fd5b8062fdd58e1461032d57806301ffc9a7146103605780630e89341c14610390575b600080fd5b34801561033957600080fd5b5061034d61034836600461491b565b610b6f565b6040519081526020015b60405180910390f35b34801561036c57600080fd5b5061038061037b36600461495d565b610c1b565b6040519015158152602001610357565b34801561039c57600080fd5b506103b06103ab36600461497a565b610c51565b60405161035791906149eb565b3480156103c957600080fd5b506103dd6103d83660046149fe565b610d0e565b005b3480156103eb57600080fd5b506103dd6103fa3660046149fe565b610e43565b34801561040b57600080fd5b506103dd61041a36600461497a565b610eea565b34801561042b57600080fd5b5061034d7f8502233096d909befbda0999bb8ea2f3a6be3c138b9fbf003752a4c8bce86f6c81565b34801561045f57600080fd5b50600854610473906001600160a01b031681565b6040516001600160a01b039091168152602001610357565b34801561049757600080fd5b5061034d6104a636600461497a565b60009081526004602052604090206001015490565b3480156104c757600080fd5b50600a546104ef906801000000000000000090046effffffffffffffffffffffffffffff1681565b6040516effffffffffffffffffffffffffffff9091168152602001610357565b34801561051b57600080fd5b5061052f61052a366004614a1b565b610fcd565b604080516001600160a01b039093168352602083019190915201610357565b34801561055a57600080fd5b506103dd610569366004614b89565b61107e565b34801561057a57600080fd5b506103dd610589366004614c37565b611132565b34801561059a57600080fd5b5061047373eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee81565b3480156105c257600080fd5b506103dd6105d1366004614c37565b611164565b3480156105e257600080fd5b5061034d60095481565b3480156105f857600080fd5b506103dd610607366004614cb0565b611200565b34801561061857600080fd5b506103dd610627366004614c37565b611338565b34801561063857600080fd5b5061064c610647366004614cfc565b6113ea565b6040516103579190614e04565b34801561066557600080fd5b506103806106743660046149fe565b6003546001600160a01b0391821691161490565b34801561069457600080fd5b506103dd6106a3366004614e17565b611528565b3480156106b457600080fd5b506103dd6106c336600461497a565b6115c0565b3480156106d457600080fd5b5061034d6106e336600461497a565b6116c5565b3480156106f457600080fd5b50600a5461038090600160b81b900460ff1681565b34801561071557600080fd5b5061073d61072436600461497a565b6010602052600090815260409020805460019091015482565b60408051928352602083019190915201610357565b34801561075e57600080fd5b506103dd61076d366004614e9b565b6117cc565b34801561077e57600080fd5b506103dd61078d366004614eb8565b611881565b34801561079e57600080fd5b50610473611927565b3480156107b357600080fd5b506104736107c2366004614a1b565b611980565b3480156107d357600080fd5b506103806107e2366004614c37565b60009182526004602090815260408084206001600160a01b0393909316845291905290205460ff1690565b34801561081957600080fd5b506103dd610828366004614f37565b61199f565b34801561083957600080fd5b506103dd610848366004614eb8565b6119f8565b34801561085957600080fd5b5061034d600081565b34801561086e57600080fd5b506103dd61087d366004614f79565b611a90565b34801561088e57600080fd5b506108a261089d366004614fec565b611aa2565b6040516103579190615022565b6103dd6108bd366004615084565b611b97565b3480156108ce57600080fd5b5061034d6108dd36600461497a565b600f6020526000908152604090205481565b3480156108fb57600080fd5b50600a546109109067ffffffffffffffff1681565b60405167ffffffffffffffff9091168152602001610357565b34801561093557600080fd5b5061047361094436600461497a565b6011602052600090815260409020546001600160a01b031681565b34801561096b57600080fd5b506103b061097a36600461497a565b611cf6565b34801561098b57600080fd5b5061034d61099a36600461497a565b611d01565b3480156109ab57600080fd5b506109bf6109ba366004614a1b565b611d18565b6040516103579190600061010082019050825182526020830151602083015260408301516040830152606083015160608301526080830151608083015260a083015160a083015260c083015160c08301526001600160a01b0360e08401511660e083015292915050565b348015610a3557600080fd5b5061034d7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a681565b348015610a6957600080fd5b506103dd610a78366004614c37565b611ded565b348015610a8957600080fd5b506103b0611e15565b348015610a9e57600080fd5b50610380610aad3660046150d7565b6001600160a01b03918216600090815260016020908152604080832093909416825291909152205460ff1690565b348015610ae757600080fd5b5061034d610af6366004615105565b611ea3565b348015610b0757600080fd5b506103dd610b1636600461513e565b611f20565b348015610b2757600080fd5b506103dd610b363660046151a7565b611fcd565b348015610b4757600080fd5b506104737f000000000000000000000000000000000000000000000000000000000000000081565b60006001600160a01b038316610bf25760405162461bcd60e51b815260206004820152602b60248201527f455243313135353a2062616c616e636520717565727920666f7220746865207a60448201527f65726f206164647265737300000000000000000000000000000000000000000060648201526084015b60405180910390fd5b506000818152602081815260408083206001600160a01b03861684529091529020545b92915050565b60006001600160e01b03198216636cdb3d1360e11b1480610c1557506001600160e01b0319821663152a902d60e11b1492915050565b606060005b600d54811015610cf857600d8181548110610c7357610c736151dc565b9060005260206000200154831015610ce657600e6000600d8381548110610c9c57610c9c6151dc565b90600052602060002001548152602001908152602001600020610cbe8461214c565b604051602001610ccf929190615249565b604051602081830303815290604052915050919050565b610cf1600182615306565b9050610c56565b5050604080516020810190915260008152919050565b610d1b60006107e261224a565b610d5b5760405162461bcd60e51b81526020600482015260116024820152703737ba1036b7b23ab6329030b236b4b71760791b6044820152606401610be9565b6001600160a01b03811660009081527f17ef568e3e12ab5b9c7254a8d58478811de00f9e6eb34345acd53bf8fd09d3ec602052604090205460ff16610de25760405162461bcd60e51b815260206004820152601b60248201527f6e6577206f776e6572206e6f74206d6f64756c652061646d696e2e00000000006044820152606401610be9565b600780546001600160a01b038381166001600160a01b031983168117909355604080519190921680825260208201939093527f70aea8d848e8a90fb7661b227dc522eb6395c3dac71b63cb59edd5c9899b2364910160405180910390a15050565b610e5060006107e261224a565b610e905760405162461bcd60e51b81526020600482015260116024820152703737ba1036b7b23ab6329030b236b4b71760791b6044820152606401610be9565b600880546001600160a01b0319166001600160a01b0383169081179091556040516001815260001991907fdfa24b2c84f4b56930965774ade10cc0167141522e42b2863e191e8426fdc7d39060200160405180910390a350565b610ef760006107e261224a565b610f375760405162461bcd60e51b81526020600482015260116024820152703737ba1036b7b23ab6329030b236b4b71760791b6044820152606401610be9565b612710811115610f795760405162461bcd60e51b815260206004820152600d60248201526c313839901e1e9018981818181760991b6044820152606401610be9565b600a805467ffffffffffffffff191667ffffffffffffffff83161790556040518181527f244ea8d7627f5a08f4299862bd5a45752842c183aee5b0fb0d1e4887bfa605b3906020015b60405180910390a150565b600c5460405163f2aab4b360e01b815230600482015260009182916001600160a01b039091169063f2aab4b39060240160206040518083038186803b15801561101557600080fd5b505afa158015611029573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061104d919061531e565b600a549092506127109061106b9067ffffffffffffffff168561533b565b6110759190615370565b90509250929050565b61108661224a565b6001600160a01b0316856001600160a01b031614806110ac57506110ac85610aad61224a565b61111e5760405162461bcd60e51b815260206004820152603260248201527f455243313135353a207472616e736665722063616c6c6572206973206e6f742060448201527f6f776e6572206e6f7220617070726f76656400000000000000000000000000006064820152608401610be9565b61112b8585858585612254565b5050505050565b6000828152600460205260409020600101546111558161115061224a565b6124cb565b61115f838361254b565b505050565b61116c61224a565b6001600160a01b0316816001600160a01b0316146111f25760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201527f20726f6c657320666f722073656c6600000000000000000000000000000000006064820152608401610be9565b6111fc828261256d565b5050565b61122c7f9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a66107e261224a565b6112785760405162461bcd60e51b815260206004820152600b60248201527f6e6f74206d696e7465722e0000000000000000000000000000000000000000006044820152606401610be9565b60095460006112878583615306565b60098190556000818152600e602052604090209091506112a890858561486a565b50600d8054600181810183556000929092527fd7b6990105719101dabeb77144f2a3385c8033acd3af97e9423a695e81ad1eb5018290557f8d92b22f5855b4d8db025239efe923788e125b3fae327dbebdba3eb9dc42094790839061130d8883615306565b6113179190615384565b8686604051611329949392919061539b565b60405180910390a15050505050565b61134560006107e261224a565b6113855760405162461bcd60e51b81526020600482015260116024820152703737ba1036b7b23ab6329030b236b4b71760791b6044820152606401610be9565b600082815260116020908152604080832080546001600160a01b0319166001600160a01b0386169081179091559051928352849290917fdfa24b2c84f4b56930965774ade10cc0167141522e42b2863e191e8426fdc7d3910160405180910390a35050565b606081518351146114635760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e67746860448201527f206d69736d6174636800000000000000000000000000000000000000000000006064820152608401610be9565b6000835167ffffffffffffffff81111561147f5761147f614a3d565b6040519080825280602002602001820160405280156114a8578160200160208202803683370190505b50905060005b8451811015611520576114f38582815181106114cc576114cc6151dc565b60200260200101518583815181106114e6576114e66151dc565b6020026020010151610b6f565b828281518110611505576115056151dc565b6020908102919091010152611519816153d8565b90506114ae565b509392505050565b61153061224a565b6001600160a01b0316836001600160a01b03161480611556575061155683610aad61224a565b6115b55760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2063616c6c6572206973206e6f74206f776e6572206e6f726044820152691030b8383937bb32b21760b11b6064820152608401610be9565b61115f83838361258f565b6115cd60006107e261224a565b61160d5760405162461bcd60e51b81526020600482015260116024820152703737ba1036b7b23ab6329030b236b4b71760791b6044820152606401610be9565b61271081111561164f5760405162461bcd60e51b815260206004820152600d60248201526c313839901e1e9018981818181760991b6044820152606401610be9565b600a80547fffffffffffffffffff000000000000000000000000000000ffffffffffffffff16680100000000000000006effffffffffffffffffffffffffffff8416021790556040518181527f2440645f96173394eb0d508ef9d0c95e3ddc41c6a10ef86e547fc738df9ecce290602001610fc2565b600081815260106020526040812054806117215760405162461bcd60e51b815260206004820152601960248201527f6e6f207075626c6963206d696e7420636f6e646974696f6e2e000000000000006044820152606401610be9565b805b801561178357600084815260106020526040812060020190611746600184615384565b815260200190815260200160002060000154421061177157611769600182615384565b949350505050565b61177c600182615384565b9050611723565b5060405162461bcd60e51b815260206004820152601960248201527f6e6f20616374697665206d696e7420636f6e646974696f6e2e000000000000006044820152606401610be9565b6117d960006107e261224a565b6118195760405162461bcd60e51b81526020600482015260116024820152703737ba1036b7b23ab6329030b236b4b71760791b6044820152606401610be9565b600a8054821515600160b81b027fffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffff9091161790556040517f2ebd4f59eaa9d49c5dcd06a0afa8b39bf09928fbd60111acee2f986fa485d09890610fc290831515815260200190565b61188e60006107e261224a565b6118ce5760405162461bcd60e51b81526020600482015260116024820152703737ba1036b7b23ab6329030b236b4b71760791b6044820152606401610be9565b60006118db8484846127dd565b90506118e78482612be6565b837f956477c5e2c5cb1058056ffe701dad74855fe3cc445bbfc11a42e384f0f5099484846040516119199291906153f3565b60405180910390a250505050565b6007546001600160a01b031660009081527f17ef568e3e12ab5b9c7254a8d58478811de00f9e6eb34345acd53bf8fd09d3ec602052604081205460ff1661196e5750600090565b6007546001600160a01b03165b905090565b60008281526005602052604081206119989083612c10565b9392505050565b6119ac60006107e261224a565b6119ec5760405162461bcd60e51b81526020600482015260116024820152703737ba1036b7b23ab6329030b236b4b71760791b6044820152606401610be9565b61115f600b838361486a565b611a0560006107e261224a565b611a455760405162461bcd60e51b81526020600482015260116024820152703737ba1036b7b23ab6329030b236b4b71760791b6044820152606401610be9565b611a508383836127dd565b50827f956477c5e2c5cb1058056ffe701dad74855fe3cc445bbfc11a42e384f0f509948383604051611a839291906153f3565b60405180910390a2505050565b6111fc611a9b61224a565b8383612c1c565b60608167ffffffffffffffff811115611abd57611abd614a3d565b604051908082528060200260200182016040528015611af057816020015b6060815260200190600190039081611adb5790505b50905060005b82811015611b9057611b6030858584818110611b1457611b146151dc565b9050602002810190611b26919061548a565b8080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250612d1192505050565b828281518110611b7257611b726151dc565b60200260200101819052508080611b88906153d8565b915050611af6565b5092915050565b60026006541415611bea5760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606401610be9565b60026006556000611bfa856116c5565b600086815260106020908152604080832084845260029081018352928190208151610100810183528154815260018201549381019390935292830154908201526003820154606082015260048201546080820152600582015460a0820152600682015460c08201526007909101546001600160a01b031660e0820152909150611c87868686868686612d36565b611c92818688612fb2565b611c9d828787613197565b611ca561224a565b6001600160a01b031686837f1ab884c1a00435d9835b58198932b6c056fdc9942defb8f1e67762a8c9b2779088604051611ce191815260200190565b60405180910390a45050600160065550505050565b6060610c1582610c51565b6000818152600560205260408120610c1590613255565b611d6c6040518061010001604052806000815260200160008152602001600081526020016000815260200160008152602001600080191681526020016000815260200160006001600160a01b031681525090565b50600091825260106020908152604080842092845260029283018252928390208351610100810185528154815260018201549281019290925291820154928101929092526003810154606083015260048101546080830152600581015460a0830152600681015460c0830152600701546001600160a01b031660e082015290565b600082815260046020526040902060010154611e0b8161115061224a565b61115f838361256d565b600b8054611e22906151f2565b80601f0160208091040260200160405190810160405280929190818152602001828054611e4e906151f2565b8015611e9b5780601f10611e7057610100808354040283529160200191611e9b565b820191906000526020600020905b815481529060010190602001808311611e7e57829003601f168201915b505050505081565b6000838152601060205260408120600101548190611ec19085615306565b60008681526010602090815260408083206001600160a01b03881684526003810183528184208585528352818420548985526002909101909252909120600401548101935090915080831015611f175760001992505b50509392505050565b611f2861224a565b6001600160a01b0316856001600160a01b03161480611f4e5750611f4e85610aad61224a565b611fc05760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2063616c6c6572206973206e6f74206f776e6572206e6f7260448201527f20617070726f76656400000000000000000000000000000000000000000000006064820152608401610be9565b61112b858585858561325f565b611fd561224a565b6001600160a01b0316836001600160a01b03161480611ffb5750611ffb83610aad61224a565b61205a5760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2063616c6c6572206973206e6f74206f776e6572206e6f726044820152691030b8383937bb32b21760b11b6064820152608401610be9565b61115f838383613417565b6003546000906001600160a01b0316331415612088575060131936013560601c90565b503390565b90565b3390565b60008281526004602090815260408083206001600160a01b038516845290915290205460ff166111fc5760008281526004602090815260408083206001600160a01b03851684529091529020805460ff191660011790556120f361224a565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000611998836001600160a01b03841661359b565b6060816121705750506040805180820190915260018152600360fc1b602082015290565b8160005b811561219a5780612184816153d8565b91506121939050600a83615370565b9150612174565b60008167ffffffffffffffff8111156121b5576121b5614a3d565b6040519080825280601f01601f1916602001820160405280156121df576020820181803683370190505b5090505b8415611769576121f4600183615384565b9150612201600a866154d1565b61220c906030615306565b60f81b818381518110612221576122216151dc565b60200101906001600160f81b031916908160001a905350612243600a86615370565b94506121e3565b600061197b612065565b81518351146122b65760405162461bcd60e51b815260206004820152602860248201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206044820152670dad2e6dac2e8c6d60c31b6064820152608401610be9565b6001600160a01b03841661231a5760405162461bcd60e51b815260206004820152602560248201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604482015264647265737360d81b6064820152608401610be9565b600061232461224a565b90506123348187878787876135ea565b60005b845181101561245d576000858281518110612354576123546151dc565b602002602001015190506000858381518110612372576123726151dc565b602090810291909101810151600084815280835260408082206001600160a01b038e1683529093529190912054909150818110156124055760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60448201526939103a3930b739b332b960b11b6064820152608401610be9565b6000838152602081815260408083206001600160a01b038e8116855292528083208585039055908b16825281208054849290612442908490615306565b9250508190555050505080612456906153d8565b9050612337565b50846001600160a01b0316866001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb87876040516124ad9291906154e5565b60405180910390a46124c3818787878787613805565b505050505050565b60008281526004602090815260408083206001600160a01b038516845290915290205460ff166111fc57612509816001600160a01b031660146139ba565b6125148360206139ba565b60405160200161252592919061550a565b60408051601f198184030181529082905262461bcd60e51b8252610be9916004016149eb565b6125558282612094565b600082815260056020526040902061115f9082612137565b6125778282613b63565b600082815260056020526040902061115f9082613c04565b6001600160a01b0383166125f15760405162461bcd60e51b815260206004820152602360248201527f455243313135353a206275726e2066726f6d20746865207a65726f206164647260448201526265737360e81b6064820152608401610be9565b80518251146126535760405162461bcd60e51b815260206004820152602860248201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206044820152670dad2e6dac2e8c6d60c31b6064820152608401610be9565b600061265d61224a565b905061267d818560008686604051806020016040528060008152506135ea565b60005b835181101561277e57600084828151811061269d5761269d6151dc565b6020026020010151905060008483815181106126bb576126bb6151dc565b602090810291909101810151600084815280835260408082206001600160a01b038c1683529093529190912054909150818110156127475760405162461bcd60e51b8152602060048201526024808201527f455243313135353a206275726e20616d6f756e7420657863656564732062616c604482015263616e636560e01b6064820152608401610be9565b6000928352602083815260408085206001600160a01b038b1686529091529092209103905580612776816153d8565b915050612680565b5060006001600160a01b0316846001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb86866040516127cf9291906154e5565b60405180910390a450505050565b60008060005b83811015612b37578115806128135750848482818110612805576128056151dc565b905061010002016000013582105b6128855760405162461bcd60e51b815260206004820152602a60248201527f737461727454696d657374616d70206d75737420626520696e20617363656e6460448201527f696e67206f726465722e000000000000000000000000000000000000000000006064820152608401610be9565b6000858583818110612899576128996151dc565b9050610100020160200135116128f15760405162461bcd60e51b815260206004820152601c60248201527f6d6178206d696e7420737570706c792063616e6e6f7420626520302e000000006044820152606401610be9565b6000858583818110612905576129056151dc565b90506101000201606001351161295d5760405162461bcd60e51b815260206004820152601b60248201527f7175616e74697479206c696d69742063616e6e6f7420626520302e00000000006044820152606401610be9565b60405180610100016040528086868481811061297b5761297b6151dc565b9050610100020160000135815260200186868481811061299d5761299d6151dc565b90506101000201602001358152602001600081526020018686848181106129c6576129c66151dc565b905061010002016060013581526020018686848181106129e8576129e86151dc565b90506101000201608001358152602001868684818110612a0a57612a0a6151dc565b9050610100020160a001358152602001868684818110612a2c57612a2c6151dc565b9050610100020160c001358152602001868684818110612a4e57612a4e6151dc565b9050610100020160e0016020810190612a6791906149fe565b6001600160a01b039081169091526000888152601060209081526040808320888452600290810183529281902085518155918501516001808401919091559085015192820192909255606084015160038201556080840151600482015560a0840151600582015560c0840151600682015560e090930151600790930180546001600160a01b03191693909216929092179055612b039084615306565b9250848482818110612b1757612b176151dc565b905061010002016000013591508080612b2f906153d8565b9150506127e3565b5060008581526010602052604090205480831015612bcb57825b81811015612bc95760008781526010602090815260408083208484526002908101909252822082815560018082018490559181018390556003810183905560048101839055600581018390556006810192909255600790910180546001600160a01b0319169055612bc29082615306565b9050612b51565b505b50506000938452601060205260409093208390555090919050565b60008281526010602052604081206001018054839290612c07908490615306565b90915550505050565b60006119988383613c19565b816001600160a01b0316836001600160a01b03161415612ca45760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c2073746174757360448201527f20666f722073656c6600000000000000000000000000000000000000000000006064820152608401610be9565b6001600160a01b03838116600081815260016020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6060611998838360405180606001604052806027815260200161576e60279139613c43565b600085118015612d4a575080606001518511155b612d965760405162461bcd60e51b815260206004820152601960248201527f696e76616c6964207175616e7469747920636c61696d65642e000000000000006044820152606401610be9565b8060200151858260400151612dab9190615306565b1115612df95760405162461bcd60e51b815260206004820152601760248201527f657863656564206d6178206d696e7420737570706c792e0000000000000000006044820152606401610be9565b600086815260106020526040812060010154612e159084615306565b60008881526010602052604081209192509060030181612e3361224a565b6001600160a01b03168152602080820192909252604090810160009081208582529092528120549150612e698986610af661224a565b9050811580612e785750804210155b612ec45760405162461bcd60e51b815260206004820152601160248201527f63616e6e6f7420636c61696d207965742e0000000000000000000000000000006044820152606401610be9565b60a084015115612fa7576000612ed861224a565b604051602001612f00919060609190911b6bffffffffffffffffffffffff1916815260140190565b604051602081830303815290604052805190602001209050612f5988888080602002602001604051908101604052809392919081815260200183836020028082843760009201919091525050505060a087015183613d2e565b612fa55760405162461bcd60e51b815260206004820152601160248201527f6e6f7420696e2077686974656c6973742e0000000000000000000000000000006044820152606401610be9565b505b505050505050505050565b60008360c0015111612fc357505050565b60008360c0015183612fd5919061533b565b600a5490915060009061271090613009906801000000000000000090046effffffffffffffffffffffffffffff168461533b565b6130139190615370565b60e08601519091506001600160a01b031673eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee14156130935781341461308e5760405162461bcd60e51b815260206004820152601660248201527f6d7573742073656e6420746f74616c2070726963652e000000000000000000006044820152606401610be9565b6130a9565b6130a961309e61224a565b8660e0015184613d44565b61313a8560e001516130b961224a565b600c5460405163f2aab4b360e01b81523060048201526001600160a01b039091169063f2aab4b39060240160206040518083038186803b1580156130fc57600080fd5b505afa158015613110573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613134919061531e565b84613ec0565b60008381526011602052604090205460e08601516001600160a01b03909116906124c39061316661224a565b6001600160a01b0384161561317b5783613188565b6008546001600160a01b03165b6131928688615384565b613ec0565b6000828152601060209081526040808320868452600290810190925282200180548392906131c6908490615306565b90915550506000828152601060205260408120600101546131e79085615306565b600084815260106020526040812091925042916003019061320661224a565b6001600160a01b031681526020808201929092526040908101600090812085825290925290205561324f61323861224a565b84846040518060200160405280600081525061409e565b50505050565b6000610c15825490565b6001600160a01b0384166132c35760405162461bcd60e51b815260206004820152602560248201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604482015264647265737360d81b6064820152608401610be9565b60006132cd61224a565b90506132ed8187876132de886141aa565b6132e7886141aa565b876135ea565b6000848152602081815260408083206001600160a01b038a168452909152902054838110156133715760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60448201526939103a3930b739b332b960b11b6064820152608401610be9565b6000858152602081815260408083206001600160a01b038b81168552925280832087850390559088168252812080548692906133ae908490615306565b909155505060408051868152602081018690526001600160a01b03808916928a821692918616917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a461340e8288888888886141f5565b50505050505050565b6001600160a01b0383166134795760405162461bcd60e51b815260206004820152602360248201527f455243313135353a206275726e2066726f6d20746865207a65726f206164647260448201526265737360e81b6064820152608401610be9565b600061348361224a565b90506134b381856000613495876141aa565b61349e876141aa565b604051806020016040528060008152506135ea565b6000838152602081815260408083206001600160a01b0388168452909152902054828110156135305760405162461bcd60e51b8152602060048201526024808201527f455243313135353a206275726e20616d6f756e7420657863656564732062616c604482015263616e636560e01b6064820152608401610be9565b6000848152602081815260408083206001600160a01b03898116808652918452828520888703905582518981529384018890529092908616917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a45050505050565b60008181526001830160205260408120546135e257508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610c15565b506000610c15565b600a54600160b81b900460ff16801561360b57506001600160a01b03851615155b801561361f57506001600160a01b03841615155b156136f9576001600160a01b03851660009081527f1c88b5fd2b55b5abb48725d2d1819fee67dc026403dc9aa4432aac630558b5e8602052604090205460ff16806136a157506001600160a01b03841660009081527f1c88b5fd2b55b5abb48725d2d1819fee67dc026403dc9aa4432aac630558b5e8602052604090205460ff165b6136f95760405162461bcd60e51b8152602060048201526024808201527f7265737472696374656420746f205452414e534645525f524f4c4520686f6c6460448201526332b9399760e11b6064820152608401610be9565b6001600160a01b0385166137805760005b835181101561377e57828181518110613725576137256151dc565b6020026020010151600f6000868481518110613743576137436151dc565b6020026020010151815260200190815260200160002060008282546137689190615306565b909155506137779050816153d8565b905061370a565b505b6001600160a01b0384166124c35760005b835181101561340e578281815181106137ac576137ac6151dc565b6020026020010151600f60008684815181106137ca576137ca6151dc565b6020026020010151815260200190815260200160002060008282546137ef9190615384565b909155506137fe9050816153d8565b9050613791565b6001600160a01b0384163b156124c35760405163bc197c8160e01b81526001600160a01b0385169063bc197c8190613849908990899088908890889060040161558b565b602060405180830381600087803b15801561386357600080fd5b505af1925050508015613893575060408051601f3d908101601f19168201909252613890918101906155e9565b60015b6139495761389f615606565b806308c379a014156138d957506138b4615621565b806138bf57506138db565b8060405162461bcd60e51b8152600401610be991906149eb565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e204552433131353560448201527f526563656976657220696d706c656d656e7465720000000000000000000000006064820152608401610be9565b6001600160e01b0319811663bc197c8160e01b1461340e5760405162461bcd60e51b815260206004820152602860248201527f455243313135353a204552433131353552656365697665722072656a656374656044820152676420746f6b656e7360c01b6064820152608401610be9565b606060006139c983600261533b565b6139d4906002615306565b67ffffffffffffffff8111156139ec576139ec614a3d565b6040519080825280601f01601f191660200182016040528015613a16576020820181803683370190505b509050600360fc1b81600081518110613a3157613a316151dc565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110613a6057613a606151dc565b60200101906001600160f81b031916908160001a9053506000613a8484600261533b565b613a8f906001615306565b90505b6001811115613b14577f303132333435363738396162636465660000000000000000000000000000000085600f1660108110613ad057613ad06151dc565b1a60f81b828281518110613ae657613ae66151dc565b60200101906001600160f81b031916908160001a90535060049490941c93613b0d816156ab565b9050613a92565b5083156119985760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610be9565b60008281526004602090815260408083206001600160a01b038516845290915290205460ff16156111fc5760008281526004602090815260408083206001600160a01b03851684529091529020805460ff19169055613bc061224a565b6001600160a01b0316816001600160a01b0316837ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b60405160405180910390a45050565b6000611998836001600160a01b038416614300565b6000826000018281548110613c3057613c306151dc565b9060005260206000200154905092915050565b6060833b613cb95760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f60448201527f6e747261637400000000000000000000000000000000000000000000000000006064820152608401610be9565b600080856001600160a01b031685604051613cd491906156c2565b600060405180830381855af49150503d8060008114613d0f576040519150601f19603f3d011682016040523d82523d6000602084013e613d14565b606091505b5091509150613d248282866143f3565b9695505050505050565b600082613d3b858461442c565b14949350505050565b6040516370a0823160e01b81526001600160a01b0384811660048301528291908416906370a082319060240160206040518083038186803b158015613d8857600080fd5b505afa158015613d9c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613dc091906156de565b10158015613e4e5750604051636eb1769f60e11b81526001600160a01b03848116600483015230602483015282919084169063dd62ed3e9060440160206040518083038186803b158015613e1357600080fd5b505afa158015613e27573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613e4b91906156de565b10155b61115f5760405162461bcd60e51b815260206004820152602b60248201527f696e73756666696369656e742063757272656e63792062616c616e6365206f7260448201527f20616c6c6f77616e63652e0000000000000000000000000000000000000000006064820152608401610be9565b80613eca5761324f565b6001600160a01b03841673eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee1415614092576001600160a01b038316301415613f8957604051632e1a7d4d60e01b8152600481018290527f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031690632e1a7d4d90602401600060405180830381600087803b158015613f6257600080fd5b505af1158015613f76573d6000803e3d6000fd5b50505050613f8482826144d0565b61324f565b6001600160a01b0382163014156140885734811461400f5760405162461bcd60e51b815260206004820152602d60248201527f6e617469766520746f6b656e2076616c756520646f6573206e6f74206d61746360448201527f682062696420616d6f756e742e000000000000000000000000000000000000006064820152608401610be9565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0826040518263ffffffff1660e01b81526004016000604051808303818588803b15801561406a57600080fd5b505af115801561407e573d6000803e3d6000fd5b505050505061324f565b613f8482826144d0565b61324f848484846145c7565b6001600160a01b0384166140fe5760405162461bcd60e51b815260206004820152602160248201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736044820152607360f81b6064820152608401610be9565b600061410861224a565b905061411a816000876132de886141aa565b6000848152602081815260408083206001600160a01b03891684529091528120805485929061414a908490615306565b909155505060408051858152602081018590526001600160a01b0380881692600092918516917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a461112b816000878787876141f5565b604080516001808252818301909252606091600091906020808301908036833701905050905082816000815181106141e4576141e46151dc565b602090810291909101015292915050565b6001600160a01b0384163b156124c35760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e619061423990899089908890889088906004016156f7565b602060405180830381600087803b15801561425357600080fd5b505af1925050508015614283575060408051601f3d908101601f19168201909252614280918101906155e9565b60015b61428f5761389f615606565b6001600160e01b0319811663f23a6e6160e01b1461340e5760405162461bcd60e51b815260206004820152602860248201527f455243313135353a204552433131353552656365697665722072656a656374656044820152676420746f6b656e7360c01b6064820152608401610be9565b600081815260018301602052604081205480156143e9576000614324600183615384565b855490915060009061433890600190615384565b905081811461439d576000866000018281548110614358576143586151dc565b906000526020600020015490508087600001848154811061437b5761437b6151dc565b6000918252602080832090910192909255918252600188019052604090208390555b85548690806143ae576143ae61573a565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610c15565b6000915050610c15565b60608315614402575081611998565b8251156144125782518084602001fd5b8160405162461bcd60e51b8152600401610be991906149eb565b600081815b845181101561152057600085828151811061444e5761444e6151dc565b602002602001015190508083116144905760408051602081018590529081018290526060016040516020818303038152906040528051906020012092506144bd565b60408051602081018390529081018490526060016040516020818303038152906040528051906020012092505b50806144c8816153d8565b915050614431565b6000826001600160a01b03168260405160006040518083038185875af1925050503d806000811461451d576040519150601f19603f3d011682016040523d82523d6000602084013e614522565b606091505b505090508061115f577f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663d0e30db0836040518263ffffffff1660e01b81526004016000604051808303818588803b15801561458657600080fd5b505af115801561459a573d6000803e3d6000fd5b505050505061115f7f00000000000000000000000000000000000000000000000000000000000000003085855b816001600160a01b0316836001600160a01b031614156145e65761324f565b6040516370a0823160e01b81526001600160a01b038381166004830152600091908616906370a082319060240160206040518083038186803b15801561462b57600080fd5b505afa15801561463f573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061466391906156de565b905060006001600160a01b0385163014614706576040516323b872dd60e01b81526001600160a01b0386811660048301528581166024830152604482018590528716906323b872dd90606401602060405180830381600087803b1580156146c957600080fd5b505af11580156146dd573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906147019190615750565b614788565b60405163a9059cbb60e01b81526001600160a01b0385811660048301526024820185905287169063a9059cbb90604401602060405180830381600087803b15801561475057600080fd5b505af1158015614764573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906147889190615750565b6040516370a0823160e01b81526001600160a01b0386811660048301529192506000918816906370a082319060240160206040518083038186803b1580156147cf57600080fd5b505afa1580156147e3573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061480791906156de565b905081801561481e575061481b8484615306565b81145b61340e5760405162461bcd60e51b815260206004820152601c60248201527f6661696c656420746f207472616e736665722063757272656e63792e000000006044820152606401610be9565b828054614876906151f2565b90600052602060002090601f01602090048101928261489857600085556148de565b82601f106148b15782800160ff198235161785556148de565b828001600101855582156148de579182015b828111156148de5782358255916020019190600101906148c3565b506148ea9291506148ee565b5090565b5b808211156148ea57600081556001016148ef565b6001600160a01b038116811461491857600080fd5b50565b6000806040838503121561492e57600080fd5b823561493981614903565b946020939093013593505050565b6001600160e01b03198116811461491857600080fd5b60006020828403121561496f57600080fd5b813561199881614947565b60006020828403121561498c57600080fd5b5035919050565b60005b838110156149ae578181015183820152602001614996565b8381111561324f5750506000910152565b600081518084526149d7816020860160208601614993565b601f01601f19169290920160200192915050565b60208152600061199860208301846149bf565b600060208284031215614a1057600080fd5b813561199881614903565b60008060408385031215614a2e57600080fd5b50508035926020909101359150565b634e487b7160e01b600052604160045260246000fd5b601f8201601f1916810167ffffffffffffffff81118282101715614a7957614a79614a3d565b6040525050565b600067ffffffffffffffff821115614a9a57614a9a614a3d565b5060051b60200190565b600082601f830112614ab557600080fd5b81356020614ac282614a80565b604051614acf8282614a53565b83815260059390931b8501820192828101915086841115614aef57600080fd5b8286015b84811015614b0a5780358352918301918301614af3565b509695505050505050565b600082601f830112614b2657600080fd5b813567ffffffffffffffff811115614b4057614b40614a3d565b604051614b57601f8301601f191660200182614a53565b818152846020838601011115614b6c57600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a08688031215614ba157600080fd5b8535614bac81614903565b94506020860135614bbc81614903565b9350604086013567ffffffffffffffff80821115614bd957600080fd5b614be589838a01614aa4565b94506060880135915080821115614bfb57600080fd5b614c0789838a01614aa4565b93506080880135915080821115614c1d57600080fd5b50614c2a88828901614b15565b9150509295509295909350565b60008060408385031215614c4a57600080fd5b823591506020830135614c5c81614903565b809150509250929050565b60008083601f840112614c7957600080fd5b50813567ffffffffffffffff811115614c9157600080fd5b602083019150836020828501011115614ca957600080fd5b9250929050565b600080600060408486031215614cc557600080fd5b83359250602084013567ffffffffffffffff811115614ce357600080fd5b614cef86828701614c67565b9497909650939450505050565b60008060408385031215614d0f57600080fd5b823567ffffffffffffffff80821115614d2757600080fd5b818501915085601f830112614d3b57600080fd5b81356020614d4882614a80565b604051614d558282614a53565b83815260059390931b8501820192828101915089841115614d7557600080fd5b948201945b83861015614d9c578535614d8d81614903565b82529482019490820190614d7a565b96505086013592505080821115614db257600080fd5b50614dbf85828601614aa4565b9150509250929050565b600081518084526020808501945080840160005b83811015614df957815187529582019590820190600101614ddd565b509495945050505050565b6020815260006119986020830184614dc9565b600080600060608486031215614e2c57600080fd5b8335614e3781614903565b9250602084013567ffffffffffffffff80821115614e5457600080fd5b614e6087838801614aa4565b93506040860135915080821115614e7657600080fd5b50614e8386828701614aa4565b9150509250925092565b801515811461491857600080fd5b600060208284031215614ead57600080fd5b813561199881614e8d565b600080600060408486031215614ecd57600080fd5b83359250602084013567ffffffffffffffff80821115614eec57600080fd5b818601915086601f830112614f0057600080fd5b813581811115614f0f57600080fd5b8760208260081b8501011115614f2457600080fd5b6020830194508093505050509250925092565b60008060208385031215614f4a57600080fd5b823567ffffffffffffffff811115614f6157600080fd5b614f6d85828601614c67565b90969095509350505050565b60008060408385031215614f8c57600080fd5b8235614f9781614903565b91506020830135614c5c81614e8d565b60008083601f840112614fb957600080fd5b50813567ffffffffffffffff811115614fd157600080fd5b6020830191508360208260051b8501011115614ca957600080fd5b60008060208385031215614fff57600080fd5b823567ffffffffffffffff81111561501657600080fd5b614f6d85828601614fa7565b6000602080830181845280855180835260408601915060408160051b870101925083870160005b8281101561507757603f198886030184526150658583516149bf565b94509285019290850190600101615049565b5092979650505050505050565b6000806000806060858703121561509a57600080fd5b8435935060208501359250604085013567ffffffffffffffff8111156150bf57600080fd5b6150cb87828801614fa7565b95989497509550505050565b600080604083850312156150ea57600080fd5b82356150f581614903565b91506020830135614c5c81614903565b60008060006060848603121561511a57600080fd5b8335925060208401359150604084013561513381614903565b809150509250925092565b600080600080600060a0868803121561515657600080fd5b853561516181614903565b9450602086013561517181614903565b93506040860135925060608601359150608086013567ffffffffffffffff81111561519b57600080fd5b614c2a88828901614b15565b6000806000606084860312156151bc57600080fd5b83356151c781614903565b95602085013595506040909401359392505050565b634e487b7160e01b600052603260045260246000fd5b600181811c9082168061520657607f821691505b6020821081141561522757634e487b7160e01b600052602260045260246000fd5b50919050565b6000815161523f818560208601614993565b9290920192915050565b600080845481600182811c91508083168061526557607f831692505b602080841082141561528557634e487b7160e01b86526022600452602486fd5b81801561529957600181146152aa576152d7565b60ff198616895284890196506152d7565b60008b81526020902060005b868110156152cf5781548b8201529085019083016152b6565b505084890196505b5050505050506152e7818561522d565b95945050505050565b634e487b7160e01b600052601160045260246000fd5b60008219821115615319576153196152f0565b500190565b60006020828403121561533057600080fd5b815161199881614903565b6000816000190483118215151615615355576153556152f0565b500290565b634e487b7160e01b600052601260045260246000fd5b60008261537f5761537f61535a565b500490565b600082821015615396576153966152f0565b500390565b84815283602082015260606040820152816060820152818360808301376000818301608090810191909152601f909201601f191601019392505050565b60006000198214156153ec576153ec6152f0565b5060010190565b6020808252818101839052600090604080840186845b8781101561547d578135835284820135858401528382013584840152606080830135908401526080808301359084015260a0808301359084015260c0808301359084015260e08083013561545c81614903565b6001600160a01b031690840152610100928301929190910190600101615409565b5090979650505050505050565b6000808335601e198436030181126154a157600080fd5b83018035915067ffffffffffffffff8211156154bc57600080fd5b602001915036819003821315614ca957600080fd5b6000826154e0576154e061535a565b500690565b6040815260006154f86040830185614dc9565b82810360208401526152e78185614dc9565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351615542816017850160208801614993565b7f206973206d697373696e6720726f6c6520000000000000000000000000000000601791840191820152835161557f816028840160208801614993565b01602801949350505050565b60006001600160a01b03808816835280871660208401525060a060408301526155b760a0830186614dc9565b82810360608401526155c98186614dc9565b905082810360808401526155dd81856149bf565b98975050505050505050565b6000602082840312156155fb57600080fd5b815161199881614947565b600060033d111561208d5760046000803e5060005160e01c90565b600060443d101561562f5790565b6040516003193d81016004833e81513d67ffffffffffffffff816024840111818411171561565f57505050505090565b82850191508151818111156156775750505050505090565b843d87010160208285010111156156915750505050505090565b6156a060208286010187614a53565b509095945050505050565b6000816156ba576156ba6152f0565b506000190190565b600082516156d4818460208701614993565b9190910192915050565b6000602082840312156156f057600080fd5b5051919050565b60006001600160a01b03808816835280871660208401525084604083015283606083015260a0608083015261572f60a08301846149bf565b979650505050505050565b634e487b7160e01b600052603160045260246000fd5b60006020828403121561576257600080fd5b815161199881614e8d56fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a164736f6c6343000809000a00000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000d2e8bb33ac5b192c9a46df0144d67e26af350c50000000000000000000000000c82bbe41f2cf04e3a8efa18f7032bdd7f6d98a810000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf1270000000000000000000000000eaa5a7d7fa42cbaff443fe1bdb764e608e039f97000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000042697066733a2f2f6261666b7265696477683375783478346e707971706e67786c646579786f35736c35706b753373746c356e666b78776d716e617671787462366f65000000000000000000000000000000000000000000000000000000000000