Source Code
Overview
ETH Balance
0 ETH
More Info
ContractCreator
Multichain Info
N/A
Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
---|---|---|---|---|---|---|---|---|---|
Loading...
Loading
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.
Contract Name:
MCV2_Bond
Compiler Version
v0.8.20+commit.a1b79de6
ZkSolc Version
v1.5.11
Optimization Enabled:
Yes with Mode 3
Other Settings:
paris EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: BUSL-1.1 pragma solidity =0.8.20; import {Clones} from "@openzeppelin/contracts/proxy/Clones.sol"; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol"; import {MCV2_Royalty} from "./MCV2_Royalty.sol"; import {MCV2_Token} from "./MCV2_Token.sol"; import {MCV2_MultiToken} from "./MCV2_MultiToken.sol"; import {MCV2_ICommonToken} from "./interfaces/MCV2_ICommonToken.sol"; import {Math} from "@openzeppelin/contracts/utils/math/Math.sol"; import {SafeCast} from "@openzeppelin/contracts/utils/math/SafeCast.sol"; /** * @title MintClub Bond V2 * @dev Providing liquidity for MintClubV2 tokens with a bonding curve. */ contract MCV2_Bond is MCV2_Royalty { using SafeERC20 for IERC20; using SafeCast for uint256; // Error messages error MCV2_Bond__InvalidConstructorParams(string reason); error MCV2_Bond__InvalidTokenCreationParams(string reason); error MCV2_Bond__InvalidReserveToken(string reason); error MCV2_Bond__InvalidStepParams(string reason); error MCV2_Bond__TokenSymbolAlreadyExists(); error MCV2_Bond__TokenNotFound(); error MCV2_Bond__ExceedMaxSupply(); error MCV2_Bond__SlippageLimitExceeded(); error MCV2_Bond__InvalidTokenAmount(); error MCV2_Bond__ExceedTotalSupply(); error MCV2_Bond__InvalidCurrentSupply(); error MCV2_Bond__PermissionDenied(); error MCV2_Bond__InvalidCreatorAddress(); error MCV2_BOND__InvalidPaginationParameters(); error MCV2_Bond__InvalidReceiver(); error MCV2_Bond__InvalidCreationFee(); error MCV2_Bond__CreationFeeTransactionFailed(); uint256 private constant MIN_UINT8_LENGTH = 31; // uint8 = 32 bits uint256 private constant MIN_STRING_LENGTH = 95; // empty string = 64 bits, 1 character = 96 bits uint256 private immutable MAX_STEPS; /** * @dev ERC20 Token implementation contract * We use "EIP-1167: Minimal Proxy Contract" in order to save gas cost for each token deployment * REF: https://github.com/optionality/clone-factory */ address private immutable TOKEN_IMPLEMENTATION; address private immutable MULTI_TOKEN_IMPLEMENTATION; struct Bond { address creator; uint16 mintRoyalty; // immutable uint16 burnRoyalty; // immutable uint40 createdAt; // immutable address reserveToken; // immutable uint256 reserveBalance; BondStep[] steps; // immutable } // Use uint128 to save storage cost & prevent integer overflow when calculating range * price struct BondStep { uint128 rangeTo; uint128 price; // multiplied by 10**18 for decimals } mapping (address => Bond) public tokenBond; address[] public tokens; // Array of all created tokens event TokenCreated(address indexed token, string name, string symbol, address indexed reserveToken); event MultiTokenCreated(address indexed token, string name, string symbol, string uri, address indexed reserveToken); event Mint(address indexed token, address indexed user, address receiver, uint256 amountMinted, address indexed reserveToken, uint256 reserveAmount); event Burn(address indexed token, address indexed user, address receiver, uint256 amountBurned, address indexed reserveToken, uint256 refundAmount); event BondCreatorUpdated(address indexed token, address indexed creator); // MARK: - Constructor /** * @dev Initializes the MCV2_Bond contract. * @param tokenImplementation The address of the token implementation contract. * @param multiTokenImplementation The address of the multi-token implementation contract. * @param protocolBeneficiary_ The address of the protocol beneficiary. * @param maxSteps The maximum number of steps allowed in a bond. */ constructor( address tokenImplementation, address multiTokenImplementation, address protocolBeneficiary_, uint256 creationFee_, uint256 maxSteps ) MCV2_Royalty(protocolBeneficiary_, creationFee_, msg.sender) { if (tokenImplementation == address(0)) revert MCV2_Bond__InvalidConstructorParams('tokenImplementation'); if (multiTokenImplementation == address(0)) revert MCV2_Bond__InvalidConstructorParams('multiTokenImplementation'); if (protocolBeneficiary_ == address(0)) revert MCV2_Bond__InvalidConstructorParams('protocolBeneficiary'); if (maxSteps == 0) revert MCV2_Bond__InvalidConstructorParams('maxSteps'); TOKEN_IMPLEMENTATION = tokenImplementation; MULTI_TOKEN_IMPLEMENTATION = multiTokenImplementation; MAX_STEPS = maxSteps; } modifier _checkBondExists(address token) { if(tokenBond[token].reserveToken == address(0)) revert MCV2_Bond__TokenNotFound(); _; } // MARK: - Factory // Use structs to avoid stack too deep error struct TokenParams { string name; string symbol; } struct MultiTokenParams { string name; string symbol; string uri; } struct BondParams { uint16 mintRoyalty; uint16 burnRoyalty; address reserveToken; uint128 maxSupply; uint128[] stepRanges; uint128[] stepPrices; } /** * @dev Validates the token creation parameters. * @param tp The token parameters. */ function _validateTokenParams(TokenParams calldata tp) pure private { if (bytes(tp.name).length == 0) revert MCV2_Bond__InvalidTokenCreationParams('name'); if (bytes(tp.symbol).length == 0) revert MCV2_Bond__InvalidTokenCreationParams('symbol'); } /** * @dev Validates the multi-token creation parameters. * @param tp The multi-token parameters. */ function _validateMultiTokenParams(MultiTokenParams calldata tp) pure private { if (bytes(tp.name).length == 0) revert MCV2_Bond__InvalidTokenCreationParams('name'); if (bytes(tp.symbol).length == 0) revert MCV2_Bond__InvalidTokenCreationParams('symbol'); if (bytes(tp.uri).length == 0) revert MCV2_Bond__InvalidTokenCreationParams('uri'); } /** * @dev Checks if the contract has the method with the minimum length of the return data. * @param implementation The address of the contract implementation. * @param method The name of the method to check. * @param minLength The minimum length of the return data. * @return A boolean indicating whether the method exists. */ function _checkMethodExists(address implementation, string memory method, uint256 minLength) private view returns (bool) { (bool success, bytes memory data) = implementation.staticcall(abi.encodeWithSignature(method)); return success && data.length > minLength; } /** * @dev Validates the bond parameters. * @param bp The bond parameters. */ function _validateBondParams(BondParams calldata bp) view private { if (bp.mintRoyalty > maxRoyaltyRange) revert MCV2_Bond__InvalidTokenCreationParams('mintRoyalty'); if (bp.burnRoyalty > maxRoyaltyRange) revert MCV2_Bond__InvalidTokenCreationParams('burnRoyalty'); // Check if the reserveToken is compatible with IERC20Metadata address r = bp.reserveToken; if (r == address(0)) revert MCV2_Bond__InvalidTokenCreationParams('reserveToken'); if(!_checkMethodExists(r, "decimals()", MIN_UINT8_LENGTH)) revert MCV2_Bond__InvalidReserveToken('decimals'); if(!_checkMethodExists(r, "name()", MIN_STRING_LENGTH)) revert MCV2_Bond__InvalidReserveToken('name'); if(!_checkMethodExists(r, "symbol()", MIN_STRING_LENGTH)) revert MCV2_Bond__InvalidReserveToken('symbol'); if (bp.maxSupply == 0) revert MCV2_Bond__InvalidTokenCreationParams('maxSupply'); if (bp.stepRanges.length == 0 || bp.stepRanges.length > MAX_STEPS) revert MCV2_Bond__InvalidStepParams('INVALID_STEP_LENGTH'); if (bp.stepRanges.length != bp.stepPrices.length) revert MCV2_Bond__InvalidStepParams('STEP_LENGTH_DO_NOT_MATCH'); // Last value or the rangeTo must be the same as the maxSupply if (bp.stepRanges[bp.stepRanges.length - 1] != bp.maxSupply) revert MCV2_Bond__InvalidStepParams('MAX_SUPPLY_MISMATCH'); } /** * @dev Sets the bond parameters for a token. * @param token The address of the token. * @param bp The bond parameters. */ function _setBond(address token, BondParams calldata bp) private { // Set token bond data Bond storage bond = tokenBond[token]; bond.creator = _msgSender(); bond.mintRoyalty = bp.mintRoyalty; bond.burnRoyalty = bp.burnRoyalty; bond.createdAt = uint40(block.timestamp); bond.reserveToken = bp.reserveToken; uint256 multiFactor = 10**IERC20Metadata(token).decimals(); for (uint256 i = 0; i < bp.stepRanges.length; ++i) { uint256 stepRange = bp.stepRanges[i]; uint256 stepPrice = bp.stepPrices[i]; if (stepRange == 0) { revert MCV2_Bond__InvalidStepParams('STEP_CANNOT_BE_ZERO'); } else if (stepPrice > 0 && stepRange * stepPrice < multiFactor) { // To minimize rounding errors, the product of the range and price must be at least multiFactor (1e18 for ERC20, 1 for ERC1155). revert MCV2_Bond__InvalidStepParams('STEP_RANG_OR_PRICE_TOO_SMALL'); } // Ranges and prices must be strictly increasing if (i > 0) { if (stepRange <= bp.stepRanges[i - 1]) revert MCV2_Bond__InvalidStepParams('DECREASING_RANGE'); if (stepPrice <= bp.stepPrices[i - 1]) revert MCV2_Bond__InvalidStepParams('DECREASING_PRICE'); } bond.steps.push(BondStep({ rangeTo: uint128(stepRange), price: uint128(stepPrice) })); } } /** * @dev Clones the implementation contract with a unique symbol. * @param implementation The address of the implementation contract. * @param symbol The symbol of the token. * @return The address of the cloned token contract. */ function _clone(address implementation, string calldata symbol) private returns (address) { // Uniqueness of symbols on this network is guaranteed by the deterministic contract address bytes32 salt = keccak256(abi.encodePacked(address(this), symbol)); // NOTE: This check might not be necessary as the clone would fail with an 'ERC1167: create2 failed' // error anyway, and the collision is nearly impossible (one in 2^160). // However, we retain this check to provide a clearer error message, albeit at the expense of an additional gas cost. address predicted = Clones.predictDeterministicAddress(implementation, salt); if (exists(predicted)) revert MCV2_Bond__TokenSymbolAlreadyExists(); return Clones.cloneDeterministic(implementation, salt); } /** * @dev Creates a new token with the given parameters. * @param tp The token parameters. * @param bp The bond parameters. * @return The address of the newly created token. */ function createToken(TokenParams calldata tp, BondParams calldata bp) external payable returns (address) { if (msg.value != creationFee) revert MCV2_Bond__InvalidCreationFee(); _validateTokenParams(tp); _validateBondParams(bp); address token = _clone(TOKEN_IMPLEMENTATION, tp.symbol); MCV2_Token newToken = MCV2_Token(token); newToken.init(tp.name, tp.symbol); tokens.push(token); _setBond(token, bp); emit TokenCreated(token, tp.name, tp.symbol, bp.reserveToken); // Send free tokens to the creator if a free minting range exists if (bp.stepPrices[0] == 0) { newToken.mintByBond(_msgSender(), bp.stepRanges[0]); } // Collect creation fee if exists if (creationFee > 0) { (bool success, ) = payable(protocolBeneficiary).call{value: creationFee}(""); if (!success) revert MCV2_Bond__CreationFeeTransactionFailed(); } return token; } /** * @dev Creates a new multi-token with the given parameters. * @param tp The multi-token parameters. * @param bp The bond parameters. * @return The address of the newly created multi-token. */ function createMultiToken(MultiTokenParams calldata tp, BondParams calldata bp) external payable returns (address) { if (msg.value != creationFee) revert MCV2_Bond__InvalidCreationFee(); _validateMultiTokenParams(tp); _validateBondParams(bp); address token = _clone(MULTI_TOKEN_IMPLEMENTATION, tp.symbol); MCV2_MultiToken newToken = MCV2_MultiToken(token); newToken.init(tp.name, tp.symbol, tp.uri); tokens.push(token); _setBond(token, bp); emit MultiTokenCreated(token, tp.name, tp.symbol, tp.uri, bp.reserveToken); // Send free tokens to the creator if a free minting range exists if (bp.stepPrices[0] == 0) { newToken.mintByBond(_msgSender(), bp.stepRanges[0]); } // Collect creation fee if exists if (creationFee > 0) { (bool success, ) = payable(protocolBeneficiary).call{value: creationFee}(""); if (!success) revert MCV2_Bond__CreationFeeTransactionFailed(); } return token; } // MARK: - Creator only functions /** * @dev Updates the bond creator address for a token. * @param token The address of the token. * @param creator The new creator address. */ function updateBondCreator(address token, address creator) external { Bond storage bond = tokenBond[token]; if (bond.creator != _msgSender()) revert MCV2_Bond__PermissionDenied(); // This will also check the existence of the bond // null address is not allowed, use dEaD address instead if (creator == address(0)) revert MCV2_Bond__InvalidCreatorAddress(); bond.creator = creator; emit BondCreatorUpdated(token, creator); } // MARK: - Mint /** * @dev Retrieves the current step for a given token and current supply. * @param token The address of the token. * @param currentSupply The current supply of the token. * @return The index of the current step. */ function getCurrentStep(address token, uint256 currentSupply) internal view returns (uint256) { Bond storage bond = tokenBond[token]; for(uint256 i = 0; i < bond.steps.length; ++i) { if (currentSupply <= bond.steps[i].rangeTo) { return i; } } revert MCV2_Bond__InvalidCurrentSupply(); // can never happen } /** * @dev Retrieves the reserve amount and royalty for a given token and the number of tokens to mint. * @param token The address of the token. * @param tokensToMint The number of tokens to mint. * @return reserveAmount The reserve amount required to mint the specified number of tokens. * @return royalty The royalty amount to be added to the reserve amount. */ function getReserveForToken(address token, uint256 tokensToMint) public view _checkBondExists(token) returns (uint256 reserveAmount, uint256 royalty) { if (tokensToMint == 0) revert MCV2_Bond__InvalidTokenAmount(); Bond memory bond = tokenBond[token]; // Create an array and variable to mention that this can be modified. BondStep[] memory steps = bond.steps; MCV2_ICommonToken t = MCV2_ICommonToken(token); uint256 currentSupply = t.totalSupply(); uint256 newSupply = currentSupply + tokensToMint; if (newSupply > maxSupply(token)) revert MCV2_Bond__ExceedMaxSupply(); uint256 multiFactor = 10**t.decimals(); // 1 or 18 uint256 tokensLeft = tokensToMint; uint256 reserveToBond = 0; uint256 supplyLeft; for (uint256 i = getCurrentStep(token, currentSupply); i < steps.length; ++i) { BondStep memory step = steps[i]; supplyLeft = step.rangeTo - currentSupply; if (supplyLeft < tokensLeft) { if(supplyLeft == 0) continue; // ensure reserve is calculated with ceiling reserveToBond += Math.ceilDiv(supplyLeft * step.price, multiFactor); currentSupply += supplyLeft; tokensLeft -= supplyLeft; } else { // ensure reserve is calculated with ceiling reserveToBond += Math.ceilDiv(tokensLeft * step.price, multiFactor); tokensLeft = 0; break; } } // tokensLeft > 0 -> can never happen // reserveToBond == 0 -> can happen if a user tries to mint within the free minting range, which is prohibited by design. if (reserveToBond == 0 || tokensLeft > 0) revert MCV2_Bond__InvalidTokenAmount(); royalty = _getRoyalty(reserveToBond, bond.mintRoyalty); reserveAmount = reserveToBond + royalty; } /** * @dev Mint new tokens by depositing reserve tokens. * @param token The address of the token to mint. * @param tokensToMint The amount of tokens to mint. * @param maxReserveAmount The maximum reserve amount allowed for the minting operation. * @param receiver The address to receive the minted tokens. */ function mint(address token, uint256 tokensToMint, uint256 maxReserveAmount, address receiver) external returns (uint256) { if (receiver == address(0)) revert MCV2_Bond__InvalidReceiver(); (uint256 reserveAmount, uint256 royalty) = getReserveForToken(token, tokensToMint); if (reserveAmount > maxReserveAmount) revert MCV2_Bond__SlippageLimitExceeded(); Bond storage bond = tokenBond[token]; address user = _msgSender(); IERC20 reserveToken = IERC20(bond.reserveToken); // Update reserve & fee balances bond.reserveBalance += reserveAmount - royalty; _addRoyalty(bond.creator, bond.reserveToken, royalty); // Mint reward tokens to the receiver MCV2_ICommonToken(token).mintByBond(receiver, tokensToMint); // Transfer reserve tokens from the user reserveToken.safeTransferFrom(user, address(this), reserveAmount); emit Mint(token, user, receiver, tokensToMint, bond.reserveToken, reserveAmount); return reserveAmount; } // MARK: - Burn /** * @dev Calculates the refund amount and royalty for a given amount of tokens to burn. * @param token The address of the token. * @param tokensToBurn The amount of tokens to burn. * @return refundAmount The amount to be refunded. * @return royalty The royalty amount. */ function getRefundForTokens(address token, uint256 tokensToBurn) public view _checkBondExists(token) returns (uint256 refundAmount, uint256 royalty) { if (tokensToBurn == 0) revert MCV2_Bond__InvalidTokenAmount(); Bond memory bond = tokenBond[token]; // Store bond.steps in memory to minimize sloads BondStep[] memory steps = bond.steps; MCV2_ICommonToken t = MCV2_ICommonToken(token); uint256 currentSupply = t.totalSupply(); if (tokensToBurn > currentSupply) revert MCV2_Bond__ExceedTotalSupply(); uint256 multiFactor = 10**t.decimals(); uint256 reserveFromBond; uint256 tokensLeft = tokensToBurn; uint256 i = getCurrentStep(token, currentSupply); while (tokensLeft > 0) { uint256 supplyLeft = i == 0 ? currentSupply : currentSupply - steps[i - 1].rangeTo; uint256 tokensToProcess = tokensLeft < supplyLeft ? tokensLeft : supplyLeft; reserveFromBond += ((tokensToProcess * steps[i].price) / multiFactor); tokensLeft -= tokensToProcess; currentSupply -= tokensToProcess; if (i > 0) --i; } // tokensLeft > 0 -> can never happen // reserveToBond == 0 -> can happen if a user tries to burn within the free minting range, which is prohibited by design. if (tokensLeft > 0) revert MCV2_Bond__InvalidTokenAmount(); royalty = _getRoyalty(reserveFromBond, bond.burnRoyalty); refundAmount = reserveFromBond - royalty; } /** * @dev Burns a specified amount of tokens and refunds the user with reserve tokens. * @param token The address of the token to burn. * @param tokensToBurn The amount of tokens to burn. * @param minRefund The minimum refund amount required. * @param receiver The address to receive the refund. */ function burn(address token, uint256 tokensToBurn, uint256 minRefund, address receiver) external returns (uint256) { if (receiver == address(0)) revert MCV2_Bond__InvalidReceiver(); (uint256 refundAmount, uint256 royalty) = getRefundForTokens(token, tokensToBurn); if (refundAmount < minRefund) revert MCV2_Bond__SlippageLimitExceeded(); Bond storage bond = tokenBond[token]; address user = _msgSender(); // Burn tokens from the user MCV2_ICommonToken(token).burnByBond(user, tokensToBurn); // Update reserve & fee balances bond.reserveBalance -= (refundAmount + royalty); _addRoyalty(bond.creator, bond.reserveToken, royalty); // Transfer reserve tokens to the receiver IERC20 reserveToken = IERC20(bond.reserveToken); reserveToken.safeTransfer(receiver, refundAmount); emit Burn(token, user, receiver, tokensToBurn, bond.reserveToken, refundAmount); return refundAmount; } // MARK: - Utility functions /** * @dev Returns the number of tokens in the bond. * @return The number of tokens in the bond. */ function tokenCount() external view returns (uint256) { return tokens.length; } /** * @dev Checks if a token exists in the bond. * @param token The address of the token to check. * @return True if the token exists in the bond, false otherwise. */ function exists(address token) public view returns (bool) { return tokenBond[token].reserveToken != address(0); } /** * @dev Returns the steps of a token in the bond. * @param token The address of the token. * @return The steps of the token in the bond. */ function getSteps(address token) external view returns (BondStep[] memory) { return tokenBond[token].steps; } /** * @dev Returns the price for the next mint of a token * @param token The address of the token. * @return The price at the next step of the bonding curve */ function priceForNextMint(address token) public view returns (uint128) { uint256 currentSupply = MCV2_ICommonToken(token).totalSupply(); if (currentSupply < maxSupply(token)) { ++currentSupply; // Ensure currentSupply is in the next range } uint256 i = getCurrentStep(token, currentSupply); return tokenBond[token].steps[i].price; } /** * @dev Returns the maximum supply of a token in the bond. * @param token The address of the token. * @return The maximum supply of the token in the bond. */ function maxSupply(address token) public view returns (uint128) { return tokenBond[token].steps[tokenBond[token].steps.length - 1].rangeTo; } struct BondInfo { address creator; address token; uint8 decimals; string symbol; string name; uint40 createdAt; uint128 currentSupply; uint128 maxSupply; uint128 priceForNextMint; address reserveToken; uint8 reserveDecimals; string reserveSymbol; string reserveName; uint256 reserveBalance; } function _getBondInfo(address token) private view returns(BondInfo memory info) { MCV2_ICommonToken t = MCV2_ICommonToken(token); Bond memory bond = tokenBond[token]; IERC20Metadata r = IERC20Metadata(bond.reserveToken); info = BondInfo({ creator: bond.creator, token: token, decimals: t.decimals(), symbol: t.symbol(), name: t.name(), createdAt: bond.createdAt, currentSupply: t.totalSupply().toUint128(), maxSupply: maxSupply(token), priceForNextMint: priceForNextMint(token), reserveToken: bond.reserveToken, reserveDecimals: r.decimals(), reserveSymbol: r.symbol(), reserveName: r.name(), reserveBalance: bond.reserveBalance }); } /** * @dev Get all tokens and their bond parameters in the range where start <= id < stop. * @param start The starting index of the range. * @param stop The ending index of the range. * @return info An array of BondInfo structs containing the bond parameters for each token in the range. */ function getList(uint256 start, uint256 stop) external view returns(BondInfo[] memory info) { if (start >= stop || stop - start > 1000) revert MCV2_BOND__InvalidPaginationParameters(); unchecked { uint256 tokensLength = tokens.length; if (stop > tokensLength) { stop = tokensLength; } uint256 arrayLength = stop - start; info = new BondInfo[](arrayLength); uint256 j; for (uint256 i = start; i < stop; ++i) { info[j++] = _getBondInfo(tokens[i]); } } } struct BondDetail { uint16 mintRoyalty; uint16 burnRoyalty; BondInfo info; BondStep[] steps; } /** * @dev Retrieves the details of a bond token. * @param token The address of the bond token. * @return detail The BondDetail struct containing the royalty, bond info, and steps of the bond token. */ function getDetail(address token) external view returns(BondDetail memory detail) { Bond memory bond = tokenBond[token]; detail = BondDetail({ mintRoyalty: bond.mintRoyalty, burnRoyalty: bond.burnRoyalty, info: _getBondInfo(token), steps: bond.steps }); } /** * @dev Get tokens filtered by reserve token in the range where start <= id < stop * @param reserveToken The address of the reserve token * @param start The starting index of the range * @param stop The ending index of the range * @return addresses An array of addresses representing the filtered tokens */ function getTokensByReserveToken(address reserveToken, uint256 start, uint256 stop) external view returns (address[] memory addresses) { if (start >= stop || stop - start > 10000) revert MCV2_BOND__InvalidPaginationParameters(); unchecked { uint256 tokensLength = tokens.length; if (stop > tokensLength) { stop = tokensLength; } uint256 count; for (uint256 i = start; i < stop; ++i) { if (tokenBond[tokens[i]].reserveToken == reserveToken) ++count; } addresses = new address[](count); uint256 j = 0; for (uint256 i = start; i < stop; ++i) { if (tokenBond[tokens[i]].reserveToken == reserveToken){ addresses[j++] = tokens[i]; if (j == count) break; } } } } /** * @dev Get tokens filtered by creator address in the range where start <= id < stop * @param creator The address of the token creator * @param start The starting index of the range * @param stop The ending index of the range (exclusive) * @return addresses An array of token addresses filtered by creator address */ function getTokensByCreator(address creator, uint256 start, uint256 stop) external view returns (address[] memory addresses) { if (start >= stop || stop - start > 10000) revert MCV2_BOND__InvalidPaginationParameters(); unchecked { uint256 tokensLength = tokens.length; if (stop > tokensLength) { stop = tokensLength; } uint256 count; for (uint256 i = start; i < stop; ++i) { if (tokenBond[tokens[i]].creator == creator) ++count; } addresses = new address[](count); uint256 j = 0; for (uint256 i = start; i < stop; ++i) { if (tokenBond[tokens[i]].creator == creator) { addresses[j++] = tokens[i]; if (j == count) break; } } } } function version() external pure returns (string memory) { return "0.1.120"; } }
// SPDX-License-Identifier: BUSL-1.1 pragma solidity =0.8.20; import {ERC20Initializable} from "./lib/ERC20Initializable.sol"; /** * @title MCV2_Token * @dev A token contract that implements a bonding curve and allows minting and burning of tokens. */ contract MCV2_Token is ERC20Initializable { error MCV2_Token__AlreadyInitialized(); error MCV2_Token__PermissionDenied(); bool private _initialized; // false by default address public bond; // Bonding curve contract should have its minting permission /** * @dev Initializes the token contract with the provided name and symbol. * @param name_ The name of the token. * @param symbol_ The symbol of the token. */ function init(string calldata name_, string calldata symbol_) external { if(_initialized) revert MCV2_Token__AlreadyInitialized(); _initialized = true; _name = name_; _symbol = symbol_; bond = _msgSender(); } modifier onlyBond() { if (bond != _msgSender()) revert MCV2_Token__PermissionDenied(); _; } /** * @dev Mint tokens by the bonding curve contract. * Minting should also provide liquidity to the bonding curve contract. * @param to The address to which the minted tokens will be transferred. * @param amount The amount of tokens to mint. */ function mintByBond(address to, uint256 amount) external onlyBond { _mint(to, amount); } /** * @dev Burns tokens by the bonding curve contract. * Burning tokens affects the bonding curve. * Users can simply send tokens to the token contract address for the same burning effect without changing the totalSupply. * @param account The address from which the tokens will be burned. * @param amount The amount of tokens to burn. */ function burnByBond(address account, uint256 amount) external onlyBond { _spendAllowance(account, bond, amount); // `msg.sender` is always `bond` _burn(account, amount); } }
// SPDX-License-Identifier: BUSL-1.1 pragma solidity =0.8.20; import {ERC1155Initializable} from "./lib/ERC1155Initializable.sol"; import {Strings} from "@openzeppelin/contracts/utils/Strings.sol"; /** * @title MCV2_MultiToken * @dev A multi-token contract that implements the ERC1155 standard. */ contract MCV2_MultiToken is ERC1155Initializable { error MCV2_MultiToken__AlreadyInitialized(); error MCV2_MultiToken__PermissionDenied(); error MCV2_MultiToken__BurnAmountExceedsTotalSupply(); error MCV2_MultiToken__NotApproved(); // ERC1155 spec does not include a name and symbol by default, but we have added them here for consistency. string public name; string public symbol; // Implement custom totalSupply tracking, since we only need to track the supply for tokenId = 0 uint256 public totalSupply; bool private _initialized; // false by default address public bond; // Bonding curve contract should have its minting permission /** * @dev Initializes the contract with the provided name, symbol, and URI. * @param name_ The name of the multi-token contract. * @param symbol_ The symbol of the multi-token contract. * @param uri_ The base URI for token metadata. */ function init(string calldata name_, string calldata symbol_, string calldata uri_) external { if(_initialized) revert MCV2_MultiToken__AlreadyInitialized(); _initialized = true; name = name_; symbol = symbol_; _setURI(uri_); bond = _msgSender(); } modifier onlyBond() { if (bond != _msgSender()) revert MCV2_MultiToken__PermissionDenied(); _; } /** * @dev Mints tokens by the bonding curve contract. * Minting should also provide liquidity to the bonding curve contract. * @param to The address to which the tokens will be minted. * @param amount The amount of tokens to mint. */ function mintByBond(address to, uint256 amount) external onlyBond { totalSupply += amount; _mint(to, 0, amount, ""); } /** * @dev Burns tokens by the bonding curve contract. * Users can simply send tokens to the token contract address for the same burning effect without changing the totalSupply. * @param account The address from which the tokens will be burned. * @param amount The amount of tokens to burn. */ function burnByBond(address account, uint256 amount) external onlyBond { if (amount > totalSupply) revert MCV2_MultiToken__BurnAmountExceedsTotalSupply(); if(!isApprovedForAll(account, bond)) revert MCV2_MultiToken__NotApproved(); // `msg.sender` is always be `_bond` unchecked { totalSupply -= amount; } _burn(account, 0, amount); } /** * @dev Added to support a common interface with ERC20 */ function decimals() public pure returns (uint8) { return 0; } /** * @dev Returns the contract URI for OpenSea compatibility. * @return The contract URI. */ function contractURI() external view returns (string memory) { return string(abi.encodePacked("https://mint.club/metadata/", Strings.toString(block.chainid), "/", symbol, ".json")); } }
// SPDX-License-Identifier: BUSL-1.1 pragma solidity =0.8.20; import {SafeERC20} from "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol"; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import {Ownable} from "@openzeppelin/contracts/access/Ownable.sol"; // include Context /** * @title MCV2_Royalty * @dev This contract implements royalty functionality for the Mint Club V2 protocol. */ abstract contract MCV2_Royalty is Ownable { using SafeERC20 for IERC20; error MCV2_Royalty__NothingToClaim(); error MCV2_Royalty__InvalidParams(); uint256 private constant RATIO_BASE = 10000; // 100.00% uint256 private constant PROTOCOL_CUT = 2000; address public constant BURN_ADDRESS = address(0x000000000000000000000000000000000000dEaD); address public protocolBeneficiary; uint256 public creationFee; uint256 public maxRoyaltyRange = 5000; // User => ReserveToken => Royalty Balance mapping(address => mapping(address => uint256)) public userTokenRoyaltyBalance; mapping(address => mapping(address => uint256)) public userTokenRoyaltyClaimed; // INFO event ProtocolBeneficiaryUpdated(address protocolBeneficiary); event CreationFeeUpdated(uint256 amount); event RoyaltyRangeUpdated(uint256 ratio); event RoyaltyClaimed( address indexed user, address reserveToken, uint256 amount ); /** * @dev Initializes the MCV2_Royalty contract. * @param protocolBeneficiary_ The address of the protocol beneficiary. * @param msgSender The address of the contract deployer. */ constructor( address protocolBeneficiary_, uint256 creationFee_, address msgSender ) Ownable(msgSender) { protocolBeneficiary = protocolBeneficiary_; creationFee = creationFee_; } // MARK: - Admin functions /** * @dev Updates the protocol beneficiary address. * @param protocolBeneficiary_ The new address of the protocol beneficiary. */ function updateProtocolBeneficiary( address protocolBeneficiary_ ) public onlyOwner { if (protocolBeneficiary_ == address(0)) revert MCV2_Royalty__InvalidParams(); protocolBeneficiary = protocolBeneficiary_; emit ProtocolBeneficiaryUpdated(protocolBeneficiary_); } function updateCreationFee(uint256 amount) external onlyOwner { creationFee = amount; emit CreationFeeUpdated(amount); } function updateMaxRoyaltyRange(uint256 ratio) external onlyOwner { if (ratio > RATIO_BASE) revert MCV2_Royalty__InvalidParams(); maxRoyaltyRange = ratio; emit RoyaltyRangeUpdated(ratio); } // MARK: - Internal utility functions /** * @dev Calculates the royalty amount based on the reserve amount and royalty ratio. * @param reserveAmount The amount of the reserve token. * @param royaltyRatio The royalty ratio. * @return The calculated royalty amount. */ function _getRoyalty( uint256 reserveAmount, uint16 royaltyRatio ) internal pure returns (uint256) { return (reserveAmount * royaltyRatio) / RATIO_BASE; } /** * @dev Adds royalty to the beneficiary and the protocol. * @param beneficiary The address of the royalty beneficiary. * @param reserveToken The address of the reserve token. * @param royaltyAmount The royalty amount to be added. */ function _addRoyalty( address beneficiary, address reserveToken, uint256 royaltyAmount ) internal { uint256 protocolCut = (royaltyAmount * PROTOCOL_CUT) / RATIO_BASE; userTokenRoyaltyBalance[beneficiary][reserveToken] += royaltyAmount - protocolCut; userTokenRoyaltyBalance[protocolBeneficiary][ reserveToken ] += protocolCut; } // MARK: - External functions /** * @dev Claims the accumulated royalties for a specific reserve token. * @param reserveToken The address of the reserve token. */ function claimRoyalties(address reserveToken) external { address msgSender = _msgSender(); uint256 amount = userTokenRoyaltyBalance[msgSender][reserveToken]; if (amount == 0) revert MCV2_Royalty__NothingToClaim(); userTokenRoyaltyBalance[msgSender][reserveToken] = 0; userTokenRoyaltyClaimed[msgSender][reserveToken] += amount; // INFO IERC20(reserveToken).safeTransfer(msgSender, amount); emit RoyaltyClaimed(msgSender, reserveToken, amount); } /** * @dev Burns the accumulated royalties for a specific reserve token and sends them to the BURN_ADDRESS. * @dev Anyone can call this function to burn the accumulated royalties for a specific reserve token. * @dev This function serves to clear the burned reserve balance from the bond contract. * @param reserveToken The address of the reserve token. */ function burnRoyalties(address reserveToken) external { uint256 amount = userTokenRoyaltyBalance[BURN_ADDRESS][reserveToken]; if (amount == 0) revert MCV2_Royalty__NothingToClaim(); userTokenRoyaltyBalance[BURN_ADDRESS][reserveToken] = 0; userTokenRoyaltyClaimed[BURN_ADDRESS][reserveToken] += amount; // INFO IERC20(reserveToken).safeTransfer(BURN_ADDRESS, amount); emit RoyaltyClaimed(BURN_ADDRESS, reserveToken, amount); } // MARK: - Utility view functions /** * @dev Retrieves the royalty information for a specific wallet and reserve token. * @param wallet The address of the wallet. * @param reserveToken The address of the reserve token. * @return The royalty balance and claimed amount for the wallet and reserve token. */ function getRoyaltyInfo( address wallet, address reserveToken ) external view returns (uint256, uint256) { return ( userTokenRoyaltyBalance[wallet][reserveToken], userTokenRoyaltyClaimed[wallet][reserveToken] ); } }
// SPDX-License-Identifier: BUSL-1.1 pragma solidity =0.8.20; interface MCV2_ICommonToken { function totalSupply() external view returns (uint256); function mintByBond(address to, uint256 amount) external; function burnByBond(address account, uint256 amount) external; function decimals() external pure returns (uint8); function name() external view returns (string memory); function symbol() external view returns (string memory); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (proxy/Clones.sol) pragma solidity ^0.8.20; /** * @dev https://eips.ethereum.org/EIPS/eip-1167[EIP 1167] is a standard for * deploying minimal proxy contracts, also known as "clones". * * > To simply and cheaply clone contract functionality in an immutable way, this standard specifies * > a minimal bytecode implementation that delegates all calls to a known, fixed address. * * The library includes functions to deploy a proxy using either `create` (traditional deployment) or `create2` * (salted deterministic deployment). It also includes functions to predict the addresses of clones deployed using the * deterministic method. */ library Clones { /** * @dev A clone instance deployment failed. */ error ERC1167FailedCreateClone(); /** * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`. * * This function uses the create opcode, which should never revert. */ function clone(address implementation) internal returns (address instance) { /// @solidity memory-safe-assembly assembly { // Cleans the upper 96 bits of the `implementation` word, then packs the first 3 bytes // of the `implementation` address with the bytecode before the address. mstore(0x00, or(shr(0xe8, shl(0x60, implementation)), 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000)) // Packs the remaining 17 bytes of `implementation` with the bytecode after the address. mstore(0x20, or(shl(0x78, implementation), 0x5af43d82803e903d91602b57fd5bf3)) instance := create(0, 0x09, 0x37) } if (instance == address(0)) { revert ERC1167FailedCreateClone(); } } /** * @dev Deploys and returns the address of a clone that mimics the behaviour of `implementation`. * * This function uses the create2 opcode and a `salt` to deterministically deploy * the clone. Using the same `implementation` and `salt` multiple time will revert, since * the clones cannot be deployed twice at the same address. */ function cloneDeterministic(address implementation, bytes32 salt) internal returns (address instance) { /// @solidity memory-safe-assembly assembly { // Cleans the upper 96 bits of the `implementation` word, then packs the first 3 bytes // of the `implementation` address with the bytecode before the address. mstore(0x00, or(shr(0xe8, shl(0x60, implementation)), 0x3d602d80600a3d3981f3363d3d373d3d3d363d73000000)) // Packs the remaining 17 bytes of `implementation` with the bytecode after the address. mstore(0x20, or(shl(0x78, implementation), 0x5af43d82803e903d91602b57fd5bf3)) instance := create2(0, 0x09, 0x37, salt) } if (instance == address(0)) { revert ERC1167FailedCreateClone(); } } /** * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}. */ function predictDeterministicAddress( address implementation, bytes32 salt, address deployer ) internal pure returns (address predicted) { /// @solidity memory-safe-assembly assembly { let ptr := mload(0x40) mstore(add(ptr, 0x38), deployer) mstore(add(ptr, 0x24), 0x5af43d82803e903d91602b57fd5bf3ff) mstore(add(ptr, 0x14), implementation) mstore(ptr, 0x3d602d80600a3d3981f3363d3d373d3d3d363d73) mstore(add(ptr, 0x58), salt) mstore(add(ptr, 0x78), keccak256(add(ptr, 0x0c), 0x37)) predicted := keccak256(add(ptr, 0x43), 0x55) } } /** * @dev Computes the address of a clone deployed using {Clones-cloneDeterministic}. */ function predictDeterministicAddress( address implementation, bytes32 salt ) internal view returns (address predicted) { return predictDeterministicAddress(implementation, salt, address(this)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Metadata.sol) pragma solidity ^0.8.20; import {IERC20} from "../IERC20.sol"; /** * @dev Interface for the optional metadata functions from the ERC20 standard. */ interface IERC20Metadata is IERC20 { /** * @dev Returns the name of the token. */ function name() external view returns (string memory); /** * @dev Returns the symbol of the token. */ function symbol() external view returns (string memory); /** * @dev Returns the decimals places of the token. */ function decimals() external view returns (uint8); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/utils/SafeERC20.sol) pragma solidity ^0.8.20; import {IERC20} from "../IERC20.sol"; import {IERC20Permit} from "../extensions/IERC20Permit.sol"; import {Address} from "../../../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; /** * @dev An operation with an ERC20 token failed. */ error SafeERC20FailedOperation(address token); /** * @dev Indicates a failed `decreaseAllowance` request. */ error SafeERC20FailedDecreaseAllowance(address spender, uint256 currentAllowance, uint256 requestedDecrease); /** * @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value, * non-reverting calls are assumed to be successful. */ function safeTransfer(IERC20 token, address to, uint256 value) internal { _callOptionalReturn(token, abi.encodeCall(token.transfer, (to, value))); } /** * @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the * calling contract. If `token` returns no value, non-reverting calls are assumed to be successful. */ function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal { _callOptionalReturn(token, abi.encodeCall(token.transferFrom, (from, to, value))); } /** * @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value, * non-reverting calls are assumed to be successful. */ function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal { uint256 oldAllowance = token.allowance(address(this), spender); forceApprove(token, spender, oldAllowance + value); } /** * @dev Decrease the calling contract's allowance toward `spender` by `requestedDecrease`. If `token` returns no * value, non-reverting calls are assumed to be successful. */ function safeDecreaseAllowance(IERC20 token, address spender, uint256 requestedDecrease) internal { unchecked { uint256 currentAllowance = token.allowance(address(this), spender); if (currentAllowance < requestedDecrease) { revert SafeERC20FailedDecreaseAllowance(spender, currentAllowance, requestedDecrease); } forceApprove(token, spender, currentAllowance - requestedDecrease); } } /** * @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value, * non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval * to be set to zero before setting it to a non-zero value, such as USDT. */ function forceApprove(IERC20 token, address spender, uint256 value) internal { bytes memory approvalCall = abi.encodeCall(token.approve, (spender, value)); if (!_callOptionalReturnBool(token, approvalCall)) { _callOptionalReturn(token, abi.encodeCall(token.approve, (spender, 0))); _callOptionalReturn(token, approvalCall); } } /** * @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); if (returndata.length != 0 && !abi.decode(returndata, (bool))) { revert SafeERC20FailedOperation(address(token)); } } /** * @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). * * This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead. */ function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) { // 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 cannot use {Address-functionCall} here since this should return false // and not revert is the subcall reverts. (bool success, bytes memory returndata) = address(token).call(data); return success && (returndata.length == 0 || abi.decode(returndata, (bool))) && address(token).code.length > 0; } }
// SPDX-License-Identifier: MIT pragma solidity =0.8.20; import {IERC1155} from "@openzeppelin/contracts/token/ERC1155/IERC1155.sol"; import {IERC1155Receiver} from "@openzeppelin/contracts/token/ERC1155/IERC1155Receiver.sol"; import {IERC1155MetadataURI} from "@openzeppelin/contracts/token/ERC1155/extensions/IERC1155MetadataURI.sol"; import {Context} from "@openzeppelin/contracts/utils/Context.sol"; import {IERC165, ERC165} from "@openzeppelin/contracts/utils/introspection/ERC165.sol"; import {Arrays} from "@openzeppelin/contracts/utils/Arrays.sol"; import {IERC1155Errors} from "@openzeppelin/contracts/interfaces/draft-IERC6093.sol"; /** * @notice A slightly modified version of ERC1155 (from OpenZeppelin 5.0.0) for initialization pattern. * Modifications are marekd with the MODIFIED tag. */ abstract contract ERC1155Initializable is Context, ERC165, IERC1155, IERC1155MetadataURI, IERC1155Errors { using Arrays for uint256[]; using Arrays for address[]; mapping(uint256 id => mapping(address account => uint256)) private _balances; mapping(address account => mapping(address operator => 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 internal _uri; // MODIFIED // MODIFIED: Removed for initialization pattern // 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 /* id */) public view virtual returns (string memory) { return _uri; } /** * @dev See {IERC1155-balanceOf}. */ function balanceOf(address account, uint256 id) public view virtual returns (uint256) { 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 returns (uint256[] memory) { if (accounts.length != ids.length) { revert ERC1155InvalidArrayLength(ids.length, accounts.length); } uint256[] memory batchBalances = new uint256[](accounts.length); for (uint256 i = 0; i < accounts.length; ++i) { batchBalances[i] = balanceOf(accounts.unsafeMemoryAccess(i), ids.unsafeMemoryAccess(i)); } return batchBalances; } /** * @dev See {IERC1155-setApprovalForAll}. */ function setApprovalForAll(address operator, bool approved) public virtual { _setApprovalForAll(_msgSender(), operator, approved); } /** * @dev See {IERC1155-isApprovedForAll}. */ function isApprovedForAll(address account, address operator) public view virtual returns (bool) { return _operatorApprovals[account][operator]; } /** * @dev See {IERC1155-safeTransferFrom}. */ function safeTransferFrom(address from, address to, uint256 id, uint256 value, bytes memory data) public virtual { address sender = _msgSender(); if (from != sender && !isApprovedForAll(from, sender)) { revert ERC1155MissingApprovalForAll(sender, from); } _safeTransferFrom(from, to, id, value, data); } /** * @dev See {IERC1155-safeBatchTransferFrom}. */ function safeBatchTransferFrom( address from, address to, uint256[] memory ids, uint256[] memory values, bytes memory data ) public virtual { address sender = _msgSender(); if (from != sender && !isApprovedForAll(from, sender)) { revert ERC1155MissingApprovalForAll(sender, from); } _safeBatchTransferFrom(from, to, ids, values, data); } /** * @dev Transfers a `value` amount of tokens of type `id` from `from` to `to`. Will mint (or burn) if `from` * (or `to`) is the zero address. * * Emits a {TransferSingle} event if the arrays contain one element, and {TransferBatch} otherwise. * * Requirements: * * - If `to` refers to a smart contract, it must implement either {IERC1155Receiver-onERC1155Received} * or {IERC1155Receiver-onERC1155BatchReceived} and return the acceptance magic value. * - `ids` and `values` must have the same length. * * NOTE: The ERC-1155 acceptance check is not performed in this function. See {_updateWithAcceptanceCheck} instead. */ function _update(address from, address to, uint256[] memory ids, uint256[] memory values) internal virtual { if (ids.length != values.length) { revert ERC1155InvalidArrayLength(ids.length, values.length); } address operator = _msgSender(); for (uint256 i = 0; i < ids.length; ++i) { uint256 id = ids.unsafeMemoryAccess(i); uint256 value = values.unsafeMemoryAccess(i); if (from != address(0)) { uint256 fromBalance = _balances[id][from]; if (fromBalance < value) { revert ERC1155InsufficientBalance(from, fromBalance, value, id); } unchecked { // Overflow not possible: value <= fromBalance _balances[id][from] = fromBalance - value; } } if (to != address(0)) { _balances[id][to] += value; } } if (ids.length == 1) { uint256 id = ids.unsafeMemoryAccess(0); uint256 value = values.unsafeMemoryAccess(0); emit TransferSingle(operator, from, to, id, value); } else { emit TransferBatch(operator, from, to, ids, values); } } /** * @dev Version of {_update} that performs the token acceptance check by calling * {IERC1155Receiver-onERC1155Received} or {IERC1155Receiver-onERC1155BatchReceived} on the receiver address if it * contains code (eg. is a smart contract at the moment of execution). * * IMPORTANT: Overriding this function is discouraged because it poses a reentrancy risk from the receiver. So any * update to the contract state after this function would break the check-effect-interaction pattern. Consider * overriding {_update} instead. */ function _updateWithAcceptanceCheck( address from, address to, uint256[] memory ids, uint256[] memory values, bytes memory data ) internal virtual { _update(from, to, ids, values); if (to != address(0)) { address operator = _msgSender(); if (ids.length == 1) { uint256 id = ids.unsafeMemoryAccess(0); uint256 value = values.unsafeMemoryAccess(0); _doSafeTransferAcceptanceCheck(operator, from, to, id, value, data); } else { _doSafeBatchTransferAcceptanceCheck(operator, from, to, ids, values, data); } } } /** * @dev Transfers a `value` 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 `value` 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 value, bytes memory data) internal { if (to == address(0)) { revert ERC1155InvalidReceiver(address(0)); } if (from == address(0)) { revert ERC1155InvalidSender(address(0)); } (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value); _updateWithAcceptanceCheck(from, to, ids, values, 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. * - `ids` and `values` must have the same length. */ function _safeBatchTransferFrom( address from, address to, uint256[] memory ids, uint256[] memory values, bytes memory data ) internal { if (to == address(0)) { revert ERC1155InvalidReceiver(address(0)); } if (from == address(0)) { revert ERC1155InvalidSender(address(0)); } _updateWithAcceptanceCheck(from, to, ids, values, 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 values 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 a `value` amount of tokens of 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 value, bytes memory data) internal { if (to == address(0)) { revert ERC1155InvalidReceiver(address(0)); } (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value); _updateWithAcceptanceCheck(address(0), to, ids, values, data); } /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_mint}. * * Emits a {TransferBatch} event. * * Requirements: * * - `ids` and `values` must have the same length. * - `to` cannot be the zero address. * - 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 values, bytes memory data) internal { if (to == address(0)) { revert ERC1155InvalidReceiver(address(0)); } _updateWithAcceptanceCheck(address(0), to, ids, values, data); } /** * @dev Destroys a `value` amount of tokens of type `id` from `from` * * Emits a {TransferSingle} event. * * Requirements: * * - `from` cannot be the zero address. * - `from` must have at least `value` amount of tokens of type `id`. */ function _burn(address from, uint256 id, uint256 value) internal { if (from == address(0)) { revert ERC1155InvalidSender(address(0)); } (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value); _updateWithAcceptanceCheck(from, address(0), ids, values, ""); } /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_burn}. * * Emits a {TransferBatch} event. * * Requirements: * * - `from` cannot be the zero address. * - `from` must have at least `value` amount of tokens of type `id`. * - `ids` and `values` must have the same length. */ function _burnBatch(address from, uint256[] memory ids, uint256[] memory values) internal { if (from == address(0)) { revert ERC1155InvalidSender(address(0)); } _updateWithAcceptanceCheck(from, address(0), ids, values, ""); } /** * @dev Approve `operator` to operate on all of `owner` tokens * * Emits an {ApprovalForAll} event. * * Requirements: * * - `operator` cannot be the zero address. */ function _setApprovalForAll(address owner, address operator, bool approved) internal virtual { if (operator == address(0)) { revert ERC1155InvalidOperator(address(0)); } _operatorApprovals[owner][operator] = approved; emit ApprovalForAll(owner, operator, approved); } /** * @dev Performs an acceptance check by calling {IERC1155-onERC1155Received} on the `to` address * if it contains code at the moment of execution. */ function _doSafeTransferAcceptanceCheck( address operator, address from, address to, uint256 id, uint256 value, bytes memory data ) private { if (to.code.length > 0) { try IERC1155Receiver(to).onERC1155Received(operator, from, id, value, data) returns (bytes4 response) { if (response != IERC1155Receiver.onERC1155Received.selector) { // Tokens rejected revert ERC1155InvalidReceiver(to); } } catch (bytes memory reason) { if (reason.length == 0) { // non-ERC1155Receiver implementer revert ERC1155InvalidReceiver(to); } else { /// @solidity memory-safe-assembly assembly { revert(add(32, reason), mload(reason)) } } } } } /** * @dev Performs a batch acceptance check by calling {IERC1155-onERC1155BatchReceived} on the `to` address * if it contains code at the moment of execution. */ function _doSafeBatchTransferAcceptanceCheck( address operator, address from, address to, uint256[] memory ids, uint256[] memory values, bytes memory data ) private { if (to.code.length > 0) { try IERC1155Receiver(to).onERC1155BatchReceived(operator, from, ids, values, data) returns ( bytes4 response ) { if (response != IERC1155Receiver.onERC1155BatchReceived.selector) { // Tokens rejected revert ERC1155InvalidReceiver(to); } } catch (bytes memory reason) { if (reason.length == 0) { // non-ERC1155Receiver implementer revert ERC1155InvalidReceiver(to); } else { /// @solidity memory-safe-assembly assembly { revert(add(32, reason), mload(reason)) } } } } } /** * @dev Creates an array in memory with only one value for each of the elements provided. */ function _asSingletonArrays( uint256 element1, uint256 element2 ) private pure returns (uint256[] memory array1, uint256[] memory array2) { /// @solidity memory-safe-assembly assembly { // Load the free memory pointer array1 := mload(0x40) // Set array length to 1 mstore(array1, 1) // Store the single element at the next word after the length (where content starts) mstore(add(array1, 0x20), element1) // Repeat for next array locating it right after the first array array2 := add(array1, 0x40) mstore(array2, 1) mstore(add(array2, 0x20), element2) // Update the free memory pointer by pointing after the second array mstore(0x40, add(array2, 0x40)) } } }
// SPDX-License-Identifier: MIT pragma solidity =0.8.20; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import {Context} from "@openzeppelin/contracts/utils/Context.sol"; import {IERC20Errors} from "@openzeppelin/contracts/interfaces/draft-IERC6093.sol"; /** * @notice A slightly modified version of ERC20 (from OpenZeppelin 5.0.0) for initialization pattern. * Modifications are marekd with the MODIFIED tag. */ abstract contract ERC20Initializable is Context, IERC20, IERC20Metadata, IERC20Errors { mapping(address account => uint256) private _balances; mapping(address account => mapping(address spender => uint256)) private _allowances; uint256 private _totalSupply; string internal _name; // MODIFIED string internal _symbol; // MODIFIED // MODIFIED: Removed for initialization pattern // constructor(string memory name_, string memory symbol_) { // _name = name_; // _symbol = symbol_; // } /** * @dev Returns the name of the token. */ function name() public view virtual returns (string memory) { return _name; } /** * @dev Returns the symbol of the token, usually a shorter version of the * name. */ function symbol() public view virtual returns (string memory) { return _symbol; } /** * @dev Returns the number of decimals used to get its user representation. * For example, if `decimals` equals `2`, a balance of `505` tokens should * be displayed to a user as `5.05` (`505 / 10 ** 2`). * * Tokens usually opt for a value of 18, imitating the relationship between * Ether and Wei. This is the default value returned by this function, unless * it's overridden. * * NOTE: This information is only used for _display_ purposes: it in * no way affects any of the arithmetic of the contract, including * {IERC20-balanceOf} and {IERC20-transfer}. */ function decimals() public view virtual returns (uint8) { return 18; } /** * @dev See {IERC20-totalSupply}. */ function totalSupply() public view virtual returns (uint256) { return _totalSupply; } /** * @dev See {IERC20-balanceOf}. */ function balanceOf(address account) public view virtual returns (uint256) { return _balances[account]; } /** * @dev See {IERC20-transfer}. * * Requirements: * * - `to` cannot be the zero address. * - the caller must have a balance of at least `value`. */ function transfer(address to, uint256 value) public virtual returns (bool) { address owner = _msgSender(); _transfer(owner, to, value); return true; } /** * @dev See {IERC20-allowance}. */ function allowance(address owner, address spender) public view virtual returns (uint256) { return _allowances[owner][spender]; } /** * @dev See {IERC20-approve}. * * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on * `transferFrom`. This is semantically equivalent to an infinite approval. * * Requirements: * * - `spender` cannot be the zero address. */ function approve(address spender, uint256 value) public virtual returns (bool) { address owner = _msgSender(); _approve(owner, spender, value); return true; } /** * @dev See {IERC20-transferFrom}. * * Emits an {Approval} event indicating the updated allowance. This is not * required by the EIP. See the note at the beginning of {ERC20}. * * NOTE: Does not update the allowance if the current allowance * is the maximum `uint256`. * * Requirements: * * - `from` and `to` cannot be the zero address. * - `from` must have a balance of at least `value`. * - the caller must have allowance for ``from``'s tokens of at least * `value`. */ function transferFrom(address from, address to, uint256 value) public virtual returns (bool) { address spender = _msgSender(); _spendAllowance(from, spender, value); _transfer(from, to, value); return true; } /** * @dev Moves a `value` amount of tokens from `from` to `to`. * * This internal function is equivalent to {transfer}, and can be used to * e.g. implement automatic token fees, slashing mechanisms, etc. * * Emits a {Transfer} event. * * NOTE: This function is not virtual, {_update} should be overridden instead. */ function _transfer(address from, address to, uint256 value) internal { if (from == address(0)) { revert ERC20InvalidSender(address(0)); } if (to == address(0)) { revert ERC20InvalidReceiver(address(0)); } _update(from, to, value); } /** * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from` * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding * this function. * * Emits a {Transfer} event. */ function _update(address from, address to, uint256 value) internal virtual { if (from == address(0)) { // Overflow check required: The rest of the code assumes that totalSupply never overflows _totalSupply += value; } else { uint256 fromBalance = _balances[from]; if (fromBalance < value) { revert ERC20InsufficientBalance(from, fromBalance, value); } unchecked { // Overflow not possible: value <= fromBalance <= totalSupply. _balances[from] = fromBalance - value; } } if (to == address(0)) { unchecked { // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply. _totalSupply -= value; } } else { unchecked { // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256. _balances[to] += value; } } emit Transfer(from, to, value); } /** * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0). * Relies on the `_update` mechanism * * Emits a {Transfer} event with `from` set to the zero address. * * NOTE: This function is not virtual, {_update} should be overridden instead. */ function _mint(address account, uint256 value) internal { if (account == address(0)) { revert ERC20InvalidReceiver(address(0)); } _update(address(0), account, value); } /** * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply. * Relies on the `_update` mechanism. * * Emits a {Transfer} event with `to` set to the zero address. * * NOTE: This function is not virtual, {_update} should be overridden instead */ function _burn(address account, uint256 value) internal { if (account == address(0)) { revert ERC20InvalidSender(address(0)); } _update(account, address(0), value); } /** * @dev Sets `value` as the allowance of `spender` over the `owner` s tokens. * * This internal function is equivalent to `approve`, and can be used to * e.g. set automatic allowances for certain subsystems, etc. * * Emits an {Approval} event. * * Requirements: * * - `owner` cannot be the zero address. * - `spender` cannot be the zero address. * * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument. */ function _approve(address owner, address spender, uint256 value) internal { _approve(owner, spender, value, true); } /** * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event. * * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any * `Approval` event during `transferFrom` operations. * * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to * true using the following override: * ``` * function _approve(address owner, address spender, uint256 value, bool) internal virtual override { * super._approve(owner, spender, value, true); * } * ``` * * Requirements are the same as {_approve}. */ function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual { if (owner == address(0)) { revert ERC20InvalidApprover(address(0)); } if (spender == address(0)) { revert ERC20InvalidSpender(address(0)); } _allowances[owner][spender] = value; if (emitEvent) { emit Approval(owner, spender, value); } } /** * @dev Updates `owner` s allowance for `spender` based on spent `value`. * * Does not update the allowance value in case of infinite allowance. * Revert if not enough allowance is available. * * Does not emit an {Approval} event. */ function _spendAllowance(address owner, address spender, uint256 value) internal virtual { uint256 currentAllowance = allowance(owner, spender); if (currentAllowance != type(uint256).max) { if (currentAllowance < value) { revert ERC20InsufficientAllowance(spender, currentAllowance, value); } unchecked { _approve(owner, spender, currentAllowance - value, false); } } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/math/SafeCast.sol) // This file was procedurally generated from scripts/generate/templates/SafeCast.js. pragma solidity ^0.8.20; /** * @dev Wrappers over Solidity's uintXX/intXX casting operators with added overflow * checks. * * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can * easily result in undesired exploitation or bugs, since developers usually * assume that overflows raise errors. `SafeCast` restores this intuition by * reverting the transaction when such an operation overflows. * * Using this library instead of the unchecked operations eliminates an entire * class of bugs, so it's recommended to use it always. */ library SafeCast { /** * @dev Value doesn't fit in an uint of `bits` size. */ error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value); /** * @dev An int value doesn't fit in an uint of `bits` size. */ error SafeCastOverflowedIntToUint(int256 value); /** * @dev Value doesn't fit in an int of `bits` size. */ error SafeCastOverflowedIntDowncast(uint8 bits, int256 value); /** * @dev An uint value doesn't fit in an int of `bits` size. */ error SafeCastOverflowedUintToInt(uint256 value); /** * @dev Returns the downcasted uint248 from uint256, reverting on * overflow (when the input is greater than largest uint248). * * Counterpart to Solidity's `uint248` operator. * * Requirements: * * - input must fit into 248 bits */ function toUint248(uint256 value) internal pure returns (uint248) { if (value > type(uint248).max) { revert SafeCastOverflowedUintDowncast(248, value); } return uint248(value); } /** * @dev Returns the downcasted uint240 from uint256, reverting on * overflow (when the input is greater than largest uint240). * * Counterpart to Solidity's `uint240` operator. * * Requirements: * * - input must fit into 240 bits */ function toUint240(uint256 value) internal pure returns (uint240) { if (value > type(uint240).max) { revert SafeCastOverflowedUintDowncast(240, value); } return uint240(value); } /** * @dev Returns the downcasted uint232 from uint256, reverting on * overflow (when the input is greater than largest uint232). * * Counterpart to Solidity's `uint232` operator. * * Requirements: * * - input must fit into 232 bits */ function toUint232(uint256 value) internal pure returns (uint232) { if (value > type(uint232).max) { revert SafeCastOverflowedUintDowncast(232, value); } return uint232(value); } /** * @dev Returns the downcasted uint224 from uint256, reverting on * overflow (when the input is greater than largest uint224). * * Counterpart to Solidity's `uint224` operator. * * Requirements: * * - input must fit into 224 bits */ function toUint224(uint256 value) internal pure returns (uint224) { if (value > type(uint224).max) { revert SafeCastOverflowedUintDowncast(224, value); } return uint224(value); } /** * @dev Returns the downcasted uint216 from uint256, reverting on * overflow (when the input is greater than largest uint216). * * Counterpart to Solidity's `uint216` operator. * * Requirements: * * - input must fit into 216 bits */ function toUint216(uint256 value) internal pure returns (uint216) { if (value > type(uint216).max) { revert SafeCastOverflowedUintDowncast(216, value); } return uint216(value); } /** * @dev Returns the downcasted uint208 from uint256, reverting on * overflow (when the input is greater than largest uint208). * * Counterpart to Solidity's `uint208` operator. * * Requirements: * * - input must fit into 208 bits */ function toUint208(uint256 value) internal pure returns (uint208) { if (value > type(uint208).max) { revert SafeCastOverflowedUintDowncast(208, value); } return uint208(value); } /** * @dev Returns the downcasted uint200 from uint256, reverting on * overflow (when the input is greater than largest uint200). * * Counterpart to Solidity's `uint200` operator. * * Requirements: * * - input must fit into 200 bits */ function toUint200(uint256 value) internal pure returns (uint200) { if (value > type(uint200).max) { revert SafeCastOverflowedUintDowncast(200, value); } return uint200(value); } /** * @dev Returns the downcasted uint192 from uint256, reverting on * overflow (when the input is greater than largest uint192). * * Counterpart to Solidity's `uint192` operator. * * Requirements: * * - input must fit into 192 bits */ function toUint192(uint256 value) internal pure returns (uint192) { if (value > type(uint192).max) { revert SafeCastOverflowedUintDowncast(192, value); } return uint192(value); } /** * @dev Returns the downcasted uint184 from uint256, reverting on * overflow (when the input is greater than largest uint184). * * Counterpart to Solidity's `uint184` operator. * * Requirements: * * - input must fit into 184 bits */ function toUint184(uint256 value) internal pure returns (uint184) { if (value > type(uint184).max) { revert SafeCastOverflowedUintDowncast(184, value); } return uint184(value); } /** * @dev Returns the downcasted uint176 from uint256, reverting on * overflow (when the input is greater than largest uint176). * * Counterpart to Solidity's `uint176` operator. * * Requirements: * * - input must fit into 176 bits */ function toUint176(uint256 value) internal pure returns (uint176) { if (value > type(uint176).max) { revert SafeCastOverflowedUintDowncast(176, value); } return uint176(value); } /** * @dev Returns the downcasted uint168 from uint256, reverting on * overflow (when the input is greater than largest uint168). * * Counterpart to Solidity's `uint168` operator. * * Requirements: * * - input must fit into 168 bits */ function toUint168(uint256 value) internal pure returns (uint168) { if (value > type(uint168).max) { revert SafeCastOverflowedUintDowncast(168, value); } return uint168(value); } /** * @dev Returns the downcasted uint160 from uint256, reverting on * overflow (when the input is greater than largest uint160). * * Counterpart to Solidity's `uint160` operator. * * Requirements: * * - input must fit into 160 bits */ function toUint160(uint256 value) internal pure returns (uint160) { if (value > type(uint160).max) { revert SafeCastOverflowedUintDowncast(160, value); } return uint160(value); } /** * @dev Returns the downcasted uint152 from uint256, reverting on * overflow (when the input is greater than largest uint152). * * Counterpart to Solidity's `uint152` operator. * * Requirements: * * - input must fit into 152 bits */ function toUint152(uint256 value) internal pure returns (uint152) { if (value > type(uint152).max) { revert SafeCastOverflowedUintDowncast(152, value); } return uint152(value); } /** * @dev Returns the downcasted uint144 from uint256, reverting on * overflow (when the input is greater than largest uint144). * * Counterpart to Solidity's `uint144` operator. * * Requirements: * * - input must fit into 144 bits */ function toUint144(uint256 value) internal pure returns (uint144) { if (value > type(uint144).max) { revert SafeCastOverflowedUintDowncast(144, value); } return uint144(value); } /** * @dev Returns the downcasted uint136 from uint256, reverting on * overflow (when the input is greater than largest uint136). * * Counterpart to Solidity's `uint136` operator. * * Requirements: * * - input must fit into 136 bits */ function toUint136(uint256 value) internal pure returns (uint136) { if (value > type(uint136).max) { revert SafeCastOverflowedUintDowncast(136, value); } return uint136(value); } /** * @dev Returns the downcasted uint128 from uint256, reverting on * overflow (when the input is greater than largest uint128). * * Counterpart to Solidity's `uint128` operator. * * Requirements: * * - input must fit into 128 bits */ function toUint128(uint256 value) internal pure returns (uint128) { if (value > type(uint128).max) { revert SafeCastOverflowedUintDowncast(128, value); } return uint128(value); } /** * @dev Returns the downcasted uint120 from uint256, reverting on * overflow (when the input is greater than largest uint120). * * Counterpart to Solidity's `uint120` operator. * * Requirements: * * - input must fit into 120 bits */ function toUint120(uint256 value) internal pure returns (uint120) { if (value > type(uint120).max) { revert SafeCastOverflowedUintDowncast(120, value); } return uint120(value); } /** * @dev Returns the downcasted uint112 from uint256, reverting on * overflow (when the input is greater than largest uint112). * * Counterpart to Solidity's `uint112` operator. * * Requirements: * * - input must fit into 112 bits */ function toUint112(uint256 value) internal pure returns (uint112) { if (value > type(uint112).max) { revert SafeCastOverflowedUintDowncast(112, value); } return uint112(value); } /** * @dev Returns the downcasted uint104 from uint256, reverting on * overflow (when the input is greater than largest uint104). * * Counterpart to Solidity's `uint104` operator. * * Requirements: * * - input must fit into 104 bits */ function toUint104(uint256 value) internal pure returns (uint104) { if (value > type(uint104).max) { revert SafeCastOverflowedUintDowncast(104, value); } return uint104(value); } /** * @dev Returns the downcasted uint96 from uint256, reverting on * overflow (when the input is greater than largest uint96). * * Counterpart to Solidity's `uint96` operator. * * Requirements: * * - input must fit into 96 bits */ function toUint96(uint256 value) internal pure returns (uint96) { if (value > type(uint96).max) { revert SafeCastOverflowedUintDowncast(96, value); } return uint96(value); } /** * @dev Returns the downcasted uint88 from uint256, reverting on * overflow (when the input is greater than largest uint88). * * Counterpart to Solidity's `uint88` operator. * * Requirements: * * - input must fit into 88 bits */ function toUint88(uint256 value) internal pure returns (uint88) { if (value > type(uint88).max) { revert SafeCastOverflowedUintDowncast(88, value); } return uint88(value); } /** * @dev Returns the downcasted uint80 from uint256, reverting on * overflow (when the input is greater than largest uint80). * * Counterpart to Solidity's `uint80` operator. * * Requirements: * * - input must fit into 80 bits */ function toUint80(uint256 value) internal pure returns (uint80) { if (value > type(uint80).max) { revert SafeCastOverflowedUintDowncast(80, value); } return uint80(value); } /** * @dev Returns the downcasted uint72 from uint256, reverting on * overflow (when the input is greater than largest uint72). * * Counterpart to Solidity's `uint72` operator. * * Requirements: * * - input must fit into 72 bits */ function toUint72(uint256 value) internal pure returns (uint72) { if (value > type(uint72).max) { revert SafeCastOverflowedUintDowncast(72, value); } return uint72(value); } /** * @dev Returns the downcasted uint64 from uint256, reverting on * overflow (when the input is greater than largest uint64). * * Counterpart to Solidity's `uint64` operator. * * Requirements: * * - input must fit into 64 bits */ function toUint64(uint256 value) internal pure returns (uint64) { if (value > type(uint64).max) { revert SafeCastOverflowedUintDowncast(64, value); } return uint64(value); } /** * @dev Returns the downcasted uint56 from uint256, reverting on * overflow (when the input is greater than largest uint56). * * Counterpart to Solidity's `uint56` operator. * * Requirements: * * - input must fit into 56 bits */ function toUint56(uint256 value) internal pure returns (uint56) { if (value > type(uint56).max) { revert SafeCastOverflowedUintDowncast(56, value); } return uint56(value); } /** * @dev Returns the downcasted uint48 from uint256, reverting on * overflow (when the input is greater than largest uint48). * * Counterpart to Solidity's `uint48` operator. * * Requirements: * * - input must fit into 48 bits */ function toUint48(uint256 value) internal pure returns (uint48) { if (value > type(uint48).max) { revert SafeCastOverflowedUintDowncast(48, value); } return uint48(value); } /** * @dev Returns the downcasted uint40 from uint256, reverting on * overflow (when the input is greater than largest uint40). * * Counterpart to Solidity's `uint40` operator. * * Requirements: * * - input must fit into 40 bits */ function toUint40(uint256 value) internal pure returns (uint40) { if (value > type(uint40).max) { revert SafeCastOverflowedUintDowncast(40, value); } return uint40(value); } /** * @dev Returns the downcasted uint32 from uint256, reverting on * overflow (when the input is greater than largest uint32). * * Counterpart to Solidity's `uint32` operator. * * Requirements: * * - input must fit into 32 bits */ function toUint32(uint256 value) internal pure returns (uint32) { if (value > type(uint32).max) { revert SafeCastOverflowedUintDowncast(32, value); } return uint32(value); } /** * @dev Returns the downcasted uint24 from uint256, reverting on * overflow (when the input is greater than largest uint24). * * Counterpart to Solidity's `uint24` operator. * * Requirements: * * - input must fit into 24 bits */ function toUint24(uint256 value) internal pure returns (uint24) { if (value > type(uint24).max) { revert SafeCastOverflowedUintDowncast(24, value); } return uint24(value); } /** * @dev Returns the downcasted uint16 from uint256, reverting on * overflow (when the input is greater than largest uint16). * * Counterpart to Solidity's `uint16` operator. * * Requirements: * * - input must fit into 16 bits */ function toUint16(uint256 value) internal pure returns (uint16) { if (value > type(uint16).max) { revert SafeCastOverflowedUintDowncast(16, value); } return uint16(value); } /** * @dev Returns the downcasted uint8 from uint256, reverting on * overflow (when the input is greater than largest uint8). * * Counterpart to Solidity's `uint8` operator. * * Requirements: * * - input must fit into 8 bits */ function toUint8(uint256 value) internal pure returns (uint8) { if (value > type(uint8).max) { revert SafeCastOverflowedUintDowncast(8, value); } return uint8(value); } /** * @dev Converts a signed int256 into an unsigned uint256. * * Requirements: * * - input must be greater than or equal to 0. */ function toUint256(int256 value) internal pure returns (uint256) { if (value < 0) { revert SafeCastOverflowedIntToUint(value); } return uint256(value); } /** * @dev Returns the downcasted int248 from int256, reverting on * overflow (when the input is less than smallest int248 or * greater than largest int248). * * Counterpart to Solidity's `int248` operator. * * Requirements: * * - input must fit into 248 bits */ function toInt248(int256 value) internal pure returns (int248 downcasted) { downcasted = int248(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(248, value); } } /** * @dev Returns the downcasted int240 from int256, reverting on * overflow (when the input is less than smallest int240 or * greater than largest int240). * * Counterpart to Solidity's `int240` operator. * * Requirements: * * - input must fit into 240 bits */ function toInt240(int256 value) internal pure returns (int240 downcasted) { downcasted = int240(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(240, value); } } /** * @dev Returns the downcasted int232 from int256, reverting on * overflow (when the input is less than smallest int232 or * greater than largest int232). * * Counterpart to Solidity's `int232` operator. * * Requirements: * * - input must fit into 232 bits */ function toInt232(int256 value) internal pure returns (int232 downcasted) { downcasted = int232(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(232, value); } } /** * @dev Returns the downcasted int224 from int256, reverting on * overflow (when the input is less than smallest int224 or * greater than largest int224). * * Counterpart to Solidity's `int224` operator. * * Requirements: * * - input must fit into 224 bits */ function toInt224(int256 value) internal pure returns (int224 downcasted) { downcasted = int224(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(224, value); } } /** * @dev Returns the downcasted int216 from int256, reverting on * overflow (when the input is less than smallest int216 or * greater than largest int216). * * Counterpart to Solidity's `int216` operator. * * Requirements: * * - input must fit into 216 bits */ function toInt216(int256 value) internal pure returns (int216 downcasted) { downcasted = int216(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(216, value); } } /** * @dev Returns the downcasted int208 from int256, reverting on * overflow (when the input is less than smallest int208 or * greater than largest int208). * * Counterpart to Solidity's `int208` operator. * * Requirements: * * - input must fit into 208 bits */ function toInt208(int256 value) internal pure returns (int208 downcasted) { downcasted = int208(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(208, value); } } /** * @dev Returns the downcasted int200 from int256, reverting on * overflow (when the input is less than smallest int200 or * greater than largest int200). * * Counterpart to Solidity's `int200` operator. * * Requirements: * * - input must fit into 200 bits */ function toInt200(int256 value) internal pure returns (int200 downcasted) { downcasted = int200(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(200, value); } } /** * @dev Returns the downcasted int192 from int256, reverting on * overflow (when the input is less than smallest int192 or * greater than largest int192). * * Counterpart to Solidity's `int192` operator. * * Requirements: * * - input must fit into 192 bits */ function toInt192(int256 value) internal pure returns (int192 downcasted) { downcasted = int192(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(192, value); } } /** * @dev Returns the downcasted int184 from int256, reverting on * overflow (when the input is less than smallest int184 or * greater than largest int184). * * Counterpart to Solidity's `int184` operator. * * Requirements: * * - input must fit into 184 bits */ function toInt184(int256 value) internal pure returns (int184 downcasted) { downcasted = int184(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(184, value); } } /** * @dev Returns the downcasted int176 from int256, reverting on * overflow (when the input is less than smallest int176 or * greater than largest int176). * * Counterpart to Solidity's `int176` operator. * * Requirements: * * - input must fit into 176 bits */ function toInt176(int256 value) internal pure returns (int176 downcasted) { downcasted = int176(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(176, value); } } /** * @dev Returns the downcasted int168 from int256, reverting on * overflow (when the input is less than smallest int168 or * greater than largest int168). * * Counterpart to Solidity's `int168` operator. * * Requirements: * * - input must fit into 168 bits */ function toInt168(int256 value) internal pure returns (int168 downcasted) { downcasted = int168(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(168, value); } } /** * @dev Returns the downcasted int160 from int256, reverting on * overflow (when the input is less than smallest int160 or * greater than largest int160). * * Counterpart to Solidity's `int160` operator. * * Requirements: * * - input must fit into 160 bits */ function toInt160(int256 value) internal pure returns (int160 downcasted) { downcasted = int160(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(160, value); } } /** * @dev Returns the downcasted int152 from int256, reverting on * overflow (when the input is less than smallest int152 or * greater than largest int152). * * Counterpart to Solidity's `int152` operator. * * Requirements: * * - input must fit into 152 bits */ function toInt152(int256 value) internal pure returns (int152 downcasted) { downcasted = int152(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(152, value); } } /** * @dev Returns the downcasted int144 from int256, reverting on * overflow (when the input is less than smallest int144 or * greater than largest int144). * * Counterpart to Solidity's `int144` operator. * * Requirements: * * - input must fit into 144 bits */ function toInt144(int256 value) internal pure returns (int144 downcasted) { downcasted = int144(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(144, value); } } /** * @dev Returns the downcasted int136 from int256, reverting on * overflow (when the input is less than smallest int136 or * greater than largest int136). * * Counterpart to Solidity's `int136` operator. * * Requirements: * * - input must fit into 136 bits */ function toInt136(int256 value) internal pure returns (int136 downcasted) { downcasted = int136(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(136, value); } } /** * @dev Returns the downcasted int128 from int256, reverting on * overflow (when the input is less than smallest int128 or * greater than largest int128). * * Counterpart to Solidity's `int128` operator. * * Requirements: * * - input must fit into 128 bits */ function toInt128(int256 value) internal pure returns (int128 downcasted) { downcasted = int128(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(128, value); } } /** * @dev Returns the downcasted int120 from int256, reverting on * overflow (when the input is less than smallest int120 or * greater than largest int120). * * Counterpart to Solidity's `int120` operator. * * Requirements: * * - input must fit into 120 bits */ function toInt120(int256 value) internal pure returns (int120 downcasted) { downcasted = int120(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(120, value); } } /** * @dev Returns the downcasted int112 from int256, reverting on * overflow (when the input is less than smallest int112 or * greater than largest int112). * * Counterpart to Solidity's `int112` operator. * * Requirements: * * - input must fit into 112 bits */ function toInt112(int256 value) internal pure returns (int112 downcasted) { downcasted = int112(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(112, value); } } /** * @dev Returns the downcasted int104 from int256, reverting on * overflow (when the input is less than smallest int104 or * greater than largest int104). * * Counterpart to Solidity's `int104` operator. * * Requirements: * * - input must fit into 104 bits */ function toInt104(int256 value) internal pure returns (int104 downcasted) { downcasted = int104(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(104, value); } } /** * @dev Returns the downcasted int96 from int256, reverting on * overflow (when the input is less than smallest int96 or * greater than largest int96). * * Counterpart to Solidity's `int96` operator. * * Requirements: * * - input must fit into 96 bits */ function toInt96(int256 value) internal pure returns (int96 downcasted) { downcasted = int96(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(96, value); } } /** * @dev Returns the downcasted int88 from int256, reverting on * overflow (when the input is less than smallest int88 or * greater than largest int88). * * Counterpart to Solidity's `int88` operator. * * Requirements: * * - input must fit into 88 bits */ function toInt88(int256 value) internal pure returns (int88 downcasted) { downcasted = int88(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(88, value); } } /** * @dev Returns the downcasted int80 from int256, reverting on * overflow (when the input is less than smallest int80 or * greater than largest int80). * * Counterpart to Solidity's `int80` operator. * * Requirements: * * - input must fit into 80 bits */ function toInt80(int256 value) internal pure returns (int80 downcasted) { downcasted = int80(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(80, value); } } /** * @dev Returns the downcasted int72 from int256, reverting on * overflow (when the input is less than smallest int72 or * greater than largest int72). * * Counterpart to Solidity's `int72` operator. * * Requirements: * * - input must fit into 72 bits */ function toInt72(int256 value) internal pure returns (int72 downcasted) { downcasted = int72(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(72, value); } } /** * @dev Returns the downcasted int64 from int256, reverting on * overflow (when the input is less than smallest int64 or * greater than largest int64). * * Counterpart to Solidity's `int64` operator. * * Requirements: * * - input must fit into 64 bits */ function toInt64(int256 value) internal pure returns (int64 downcasted) { downcasted = int64(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(64, value); } } /** * @dev Returns the downcasted int56 from int256, reverting on * overflow (when the input is less than smallest int56 or * greater than largest int56). * * Counterpart to Solidity's `int56` operator. * * Requirements: * * - input must fit into 56 bits */ function toInt56(int256 value) internal pure returns (int56 downcasted) { downcasted = int56(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(56, value); } } /** * @dev Returns the downcasted int48 from int256, reverting on * overflow (when the input is less than smallest int48 or * greater than largest int48). * * Counterpart to Solidity's `int48` operator. * * Requirements: * * - input must fit into 48 bits */ function toInt48(int256 value) internal pure returns (int48 downcasted) { downcasted = int48(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(48, value); } } /** * @dev Returns the downcasted int40 from int256, reverting on * overflow (when the input is less than smallest int40 or * greater than largest int40). * * Counterpart to Solidity's `int40` operator. * * Requirements: * * - input must fit into 40 bits */ function toInt40(int256 value) internal pure returns (int40 downcasted) { downcasted = int40(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(40, value); } } /** * @dev Returns the downcasted int32 from int256, reverting on * overflow (when the input is less than smallest int32 or * greater than largest int32). * * Counterpart to Solidity's `int32` operator. * * Requirements: * * - input must fit into 32 bits */ function toInt32(int256 value) internal pure returns (int32 downcasted) { downcasted = int32(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(32, value); } } /** * @dev Returns the downcasted int24 from int256, reverting on * overflow (when the input is less than smallest int24 or * greater than largest int24). * * Counterpart to Solidity's `int24` operator. * * Requirements: * * - input must fit into 24 bits */ function toInt24(int256 value) internal pure returns (int24 downcasted) { downcasted = int24(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(24, value); } } /** * @dev Returns the downcasted int16 from int256, reverting on * overflow (when the input is less than smallest int16 or * greater than largest int16). * * Counterpart to Solidity's `int16` operator. * * Requirements: * * - input must fit into 16 bits */ function toInt16(int256 value) internal pure returns (int16 downcasted) { downcasted = int16(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(16, value); } } /** * @dev Returns the downcasted int8 from int256, reverting on * overflow (when the input is less than smallest int8 or * greater than largest int8). * * Counterpart to Solidity's `int8` operator. * * Requirements: * * - input must fit into 8 bits */ function toInt8(int256 value) internal pure returns (int8 downcasted) { downcasted = int8(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(8, value); } } /** * @dev Converts an unsigned uint256 into a signed int256. * * Requirements: * * - input must be less than or equal to maxInt256. */ function toInt256(uint256 value) internal pure returns (int256) { // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive if (value > uint256(type(int256).max)) { revert SafeCastOverflowedUintToInt(value); } return int256(value); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/IERC20.sol) pragma solidity ^0.8.20; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20 { /** * @dev Emitted when `value` tokens are moved from one account (`from`) to * another (`to`). * * Note that `value` may be zero. */ event Transfer(address indexed from, address indexed to, uint256 value); /** * @dev Emitted when the allowance of a `spender` for an `owner` is set by * a call to {approve}. `value` is the new allowance. */ event Approval(address indexed owner, address indexed spender, uint256 value); /** * @dev Returns the value of tokens in existence. */ function totalSupply() external view returns (uint256); /** * @dev Returns the value of tokens owned by `account`. */ function balanceOf(address account) external view returns (uint256); /** * @dev Moves a `value` amount of tokens from the caller's account to `to`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address to, uint256 value) 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 a `value` amount of tokens 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 value) external returns (bool); /** * @dev Moves a `value` amount of tokens from `from` to `to` using the * allowance mechanism. `value` is then deducted from the caller's * allowance. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transferFrom(address from, address to, uint256 value) external returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/math/Math.sol) pragma solidity ^0.8.20; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { /** * @dev Muldiv operation overflow. */ error MathOverflowedMulDiv(); enum Rounding { Floor, // Toward negative infinity Ceil, // Toward positive infinity Trunc, // Toward zero Expand // Away from zero } /** * @dev Returns the addition of two unsigned integers, with an overflow flag. */ function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { uint256 c = a + b; if (c < a) return (false, 0); return (true, c); } } /** * @dev Returns the subtraction of two unsigned integers, with an overflow flag. */ function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b > a) return (false, 0); return (true, a - b); } } /** * @dev Returns the multiplication of two unsigned integers, with an overflow flag. */ function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { // Gas optimization: this is cheaper than requiring 'a' not being zero, but the // benefit is lost if 'b' is also tested. // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522 if (a == 0) return (true, 0); uint256 c = a * b; if (c / a != b) return (false, 0); return (true, c); } } /** * @dev Returns the division of two unsigned integers, with a division by zero flag. */ function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b == 0) return (false, 0); return (true, a / b); } } /** * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag. */ function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b == 0) return (false, 0); return (true, a % b); } } /** * @dev Returns the largest of two numbers. */ function max(uint256 a, uint256 b) internal pure returns (uint256) { return a > b ? a : b; } /** * @dev Returns the smallest of two numbers. */ function min(uint256 a, uint256 b) internal pure returns (uint256) { return a < b ? a : b; } /** * @dev Returns the average of two numbers. The result is rounded towards * zero. */ function average(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b) / 2 can overflow. return (a & b) + (a ^ b) / 2; } /** * @dev Returns the ceiling of the division of two numbers. * * This differs from standard division with `/` in that it rounds towards infinity instead * of rounding towards zero. */ function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) { if (b == 0) { // Guarantee the same behavior as in a regular Solidity division. return a / b; } // (a + b - 1) / b can overflow on addition, so we distribute. return a == 0 ? 0 : (a - 1) / b + 1; } /** * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or * denominator == 0. * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by * Uniswap Labs also under MIT license. */ function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) { unchecked { // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256 // variables such that product = prod1 * 2^256 + prod0. uint256 prod0 = x * y; // Least significant 256 bits of the product uint256 prod1; // Most significant 256 bits of the product assembly { let mm := mulmod(x, y, not(0)) prod1 := sub(sub(mm, prod0), lt(mm, prod0)) } // Handle non-overflow cases, 256 by 256 division. if (prod1 == 0) { // Solidity will revert if denominator == 0, unlike the div opcode on its own. // The surrounding unchecked block does not change this fact. // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic. return prod0 / denominator; } // Make sure the result is less than 2^256. Also prevents denominator == 0. if (denominator <= prod1) { revert MathOverflowedMulDiv(); } /////////////////////////////////////////////// // 512 by 256 division. /////////////////////////////////////////////// // Make division exact by subtracting the remainder from [prod1 prod0]. uint256 remainder; assembly { // Compute remainder using mulmod. remainder := mulmod(x, y, denominator) // Subtract 256 bit number from 512 bit number. prod1 := sub(prod1, gt(remainder, prod0)) prod0 := sub(prod0, remainder) } // Factor powers of two out of denominator and compute largest power of two divisor of denominator. // Always >= 1. See https://cs.stackexchange.com/q/138556/92363. uint256 twos = denominator & (0 - denominator); assembly { // Divide denominator by twos. denominator := div(denominator, twos) // Divide [prod1 prod0] by twos. prod0 := div(prod0, twos) // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one. twos := add(div(sub(0, twos), twos), 1) } // Shift in bits from prod1 into prod0. prod0 |= prod1 * twos; // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for // four bits. That is, denominator * inv = 1 mod 2^4. uint256 inverse = (3 * denominator) ^ 2; // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also // works in modular arithmetic, doubling the correct bits in each step. inverse *= 2 - denominator * inverse; // inverse mod 2^8 inverse *= 2 - denominator * inverse; // inverse mod 2^16 inverse *= 2 - denominator * inverse; // inverse mod 2^32 inverse *= 2 - denominator * inverse; // inverse mod 2^64 inverse *= 2 - denominator * inverse; // inverse mod 2^128 inverse *= 2 - denominator * inverse; // inverse mod 2^256 // Because the division is now exact we can divide by multiplying with the modular inverse of denominator. // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1 // is no longer required. result = prod0 * inverse; return result; } } /** * @notice Calculates x * y / denominator with full precision, following the selected rounding direction. */ function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) { uint256 result = mulDiv(x, y, denominator); if (unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0) { result += 1; } return result; } /** * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded * towards zero. * * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11). */ function sqrt(uint256 a) internal pure returns (uint256) { if (a == 0) { return 0; } // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target. // // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`. // // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)` // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))` // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)` // // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit. uint256 result = 1 << (log2(a) >> 1); // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128, // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision // into the expected uint128 result. unchecked { result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; return min(result, a / result); } } /** * @notice Calculates sqrt(a), following the selected rounding direction. */ function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = sqrt(a); return result + (unsignedRoundsUp(rounding) && result * result < a ? 1 : 0); } } /** * @dev Return the log in base 2 of a positive value rounded towards zero. * Returns 0 if given 0. */ function log2(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 128; } if (value >> 64 > 0) { value >>= 64; result += 64; } if (value >> 32 > 0) { value >>= 32; result += 32; } if (value >> 16 > 0) { value >>= 16; result += 16; } if (value >> 8 > 0) { value >>= 8; result += 8; } if (value >> 4 > 0) { value >>= 4; result += 4; } if (value >> 2 > 0) { value >>= 2; result += 2; } if (value >> 1 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 2, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log2(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log2(value); return result + (unsignedRoundsUp(rounding) && 1 << result < value ? 1 : 0); } } /** * @dev Return the log in base 10 of a positive value rounded towards zero. * Returns 0 if given 0. */ function log10(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >= 10 ** 64) { value /= 10 ** 64; result += 64; } if (value >= 10 ** 32) { value /= 10 ** 32; result += 32; } if (value >= 10 ** 16) { value /= 10 ** 16; result += 16; } if (value >= 10 ** 8) { value /= 10 ** 8; result += 8; } if (value >= 10 ** 4) { value /= 10 ** 4; result += 4; } if (value >= 10 ** 2) { value /= 10 ** 2; result += 2; } if (value >= 10 ** 1) { result += 1; } } return result; } /** * @dev Return the log in base 10, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log10(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log10(value); return result + (unsignedRoundsUp(rounding) && 10 ** result < value ? 1 : 0); } } /** * @dev Return the log in base 256 of a positive value rounded towards zero. * Returns 0 if given 0. * * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string. */ function log256(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 16; } if (value >> 64 > 0) { value >>= 64; result += 8; } if (value >> 32 > 0) { value >>= 32; result += 4; } if (value >> 16 > 0) { value >>= 16; result += 2; } if (value >> 8 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 256, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log256(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log256(value); return result + (unsignedRoundsUp(rounding) && 1 << (result << 3) < value ? 1 : 0); } } /** * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers. */ function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) { return uint8(rounding) % 2 == 1; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Strings.sol) pragma solidity ^0.8.20; import {Math} from "./math/Math.sol"; import {SignedMath} from "./math/SignedMath.sol"; /** * @dev String operations. */ library Strings { bytes16 private constant HEX_DIGITS = "0123456789abcdef"; uint8 private constant ADDRESS_LENGTH = 20; /** * @dev The `value` string doesn't fit in the specified `length`. */ error StringsInsufficientHexLength(uint256 value, uint256 length); /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { unchecked { uint256 length = Math.log10(value) + 1; string memory buffer = new string(length); uint256 ptr; /// @solidity memory-safe-assembly assembly { ptr := add(buffer, add(32, length)) } while (true) { ptr--; /// @solidity memory-safe-assembly assembly { mstore8(ptr, byte(mod(value, 10), HEX_DIGITS)) } value /= 10; if (value == 0) break; } return buffer; } } /** * @dev Converts a `int256` to its ASCII `string` decimal representation. */ function toStringSigned(int256 value) internal pure returns (string memory) { return string.concat(value < 0 ? "-" : "", toString(SignedMath.abs(value))); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { unchecked { return toHexString(value, Math.log256(value) + 1); } } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString(uint256 value, uint256 length) internal pure returns (string memory) { uint256 localValue = value; 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_DIGITS[localValue & 0xf]; localValue >>= 4; } if (localValue != 0) { revert StringsInsufficientHexLength(value, length); } return string(buffer); } /** * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal * representation. */ function toHexString(address addr) internal pure returns (string memory) { return toHexString(uint256(uint160(addr)), ADDRESS_LENGTH); } /** * @dev Returns true if the two strings are equal. */ function equal(string memory a, string memory b) internal pure returns (bool) { return bytes(a).length == bytes(b).length && keccak256(bytes(a)) == keccak256(bytes(b)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol) pragma solidity ^0.8.20; import {Context} from "../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. * * The initial owner is set to the address provided by the deployer. 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; /** * @dev The caller account is not authorized to perform an operation. */ error OwnableUnauthorizedAccount(address account); /** * @dev The owner is not a valid owner account. (eg. `address(0)`) */ error OwnableInvalidOwner(address owner); event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the address provided by the deployer as the initial owner. */ constructor(address initialOwner) { if (initialOwner == address(0)) { revert OwnableInvalidOwner(address(0)); } _transferOwnership(initialOwner); } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { _checkOwner(); _; } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if the sender is not the owner. */ function _checkOwner() internal view virtual { if (owner() != _msgSender()) { revert OwnableUnauthorizedAccount(_msgSender()); } } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby disabling 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 { if (newOwner == address(0)) { revert OwnableInvalidOwner(address(0)); } _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: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol) pragma solidity ^0.8.20; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev The ETH balance of the account is not enough to perform the operation. */ error AddressInsufficientBalance(address account); /** * @dev There's no code at `target` (it is not a contract). */ error AddressEmptyCode(address target); /** * @dev A call to an address target failed. The target may have reverted. */ error FailedInnerCall(); /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.8.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { if (address(this).balance < amount) { revert AddressInsufficientBalance(address(this)); } (bool success, ) = recipient.call{value: amount}(""); if (!success) { revert FailedInnerCall(); } } /** * @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 or custom error, it is bubbled * up by this function (like regular Solidity function calls). However, if * the call reverted with no returned reason, this function reverts with a * {FailedInnerCall} error. * * 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. */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0); } /** * @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`. */ function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) { if (address(this).balance < value) { revert AddressInsufficientBalance(address(this)); } (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a delegate call. */ function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) { (bool success, bytes memory returndata) = target.delegatecall(data); return verifyCallResultFromTarget(target, success, returndata); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target * was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an * unsuccessful call. */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata ) internal view returns (bytes memory) { if (!success) { _revert(returndata); } else { // only check if target is a contract if the call was successful and the return data is empty // otherwise we already know that it was a contract if (returndata.length == 0 && target.code.length == 0) { revert AddressEmptyCode(target); } return returndata; } } /** * @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the * revert reason or with a default {FailedInnerCall} error. */ function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) { if (!success) { _revert(returndata); } else { return returndata; } } /** * @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}. */ function _revert(bytes memory returndata) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert FailedInnerCall(); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Permit.sol) pragma solidity ^0.8.20; /** * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612]. * * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't * need to send a transaction, and thus is not required to hold Ether at all. * * ==== Security Considerations * * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be * considered as an intention to spend the allowance in any specific way. The second is that because permits have * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be * generally recommended is: * * ```solidity * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public { * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {} * doThing(..., value); * } * * function doThing(..., uint256 value) public { * token.safeTransferFrom(msg.sender, address(this), value); * ... * } * ``` * * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also * {SafeERC20-safeTransferFrom}). * * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so * contracts should have entry points that don't rely on permit. */ interface IERC20Permit { /** * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens, * given ``owner``'s signed approval. * * IMPORTANT: The same issues {IERC20-approve} has related to transaction * ordering also apply here. * * Emits an {Approval} event. * * Requirements: * * - `spender` cannot be the zero address. * - `deadline` must be a timestamp in the future. * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner` * over the EIP712-formatted function arguments. * - the signature must use ``owner``'s current nonce (see {nonces}). * * For more information on the signature format, see the * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP * section]. * * CAUTION: See Security Considerations above. */ function permit( address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) external; /** * @dev Returns the current nonce for `owner`. This value must be * included whenever a signature is generated for {permit}. * * Every successful call to {permit} increases ``owner``'s nonce by one. This * prevents a signature from being used multiple times. */ function nonces(address owner) external view returns (uint256); /** * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}. */ // solhint-disable-next-line func-name-mixedcase function DOMAIN_SEPARATOR() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol) pragma solidity ^0.8.20; /** * @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; } function _contextSuffixLength() internal view virtual returns (uint256) { return 0; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Arrays.sol) pragma solidity ^0.8.20; import {StorageSlot} from "./StorageSlot.sol"; import {Math} from "./math/Math.sol"; /** * @dev Collection of functions related to array types. */ library Arrays { using StorageSlot for bytes32; /** * @dev Searches a sorted `array` and returns the first index that contains * a value greater or equal to `element`. If no such index exists (i.e. all * values in the array are strictly less than `element`), the array length is * returned. Time complexity O(log n). * * `array` is expected to be sorted in ascending order, and to contain no * repeated elements. */ function findUpperBound(uint256[] storage array, uint256 element) internal view returns (uint256) { uint256 low = 0; uint256 high = array.length; if (high == 0) { return 0; } while (low < high) { uint256 mid = Math.average(low, high); // Note that mid will always be strictly less than high (i.e. it will be a valid array index) // because Math.average rounds towards zero (it does integer division with truncation). if (unsafeAccess(array, mid).value > element) { high = mid; } else { low = mid + 1; } } // At this point `low` is the exclusive upper bound. We will return the inclusive upper bound. if (low > 0 && unsafeAccess(array, low - 1).value == element) { return low - 1; } else { return low; } } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeAccess(address[] storage arr, uint256 pos) internal pure returns (StorageSlot.AddressSlot storage) { bytes32 slot; // We use assembly to calculate the storage slot of the element at index `pos` of the dynamic array `arr` // following https://docs.soliditylang.org/en/v0.8.20/internals/layout_in_storage.html#mappings-and-dynamic-arrays. /// @solidity memory-safe-assembly assembly { mstore(0, arr.slot) slot := add(keccak256(0, 0x20), pos) } return slot.getAddressSlot(); } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeAccess(bytes32[] storage arr, uint256 pos) internal pure returns (StorageSlot.Bytes32Slot storage) { bytes32 slot; // We use assembly to calculate the storage slot of the element at index `pos` of the dynamic array `arr` // following https://docs.soliditylang.org/en/v0.8.20/internals/layout_in_storage.html#mappings-and-dynamic-arrays. /// @solidity memory-safe-assembly assembly { mstore(0, arr.slot) slot := add(keccak256(0, 0x20), pos) } return slot.getBytes32Slot(); } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeAccess(uint256[] storage arr, uint256 pos) internal pure returns (StorageSlot.Uint256Slot storage) { bytes32 slot; // We use assembly to calculate the storage slot of the element at index `pos` of the dynamic array `arr` // following https://docs.soliditylang.org/en/v0.8.20/internals/layout_in_storage.html#mappings-and-dynamic-arrays. /// @solidity memory-safe-assembly assembly { mstore(0, arr.slot) slot := add(keccak256(0, 0x20), pos) } return slot.getUint256Slot(); } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeMemoryAccess(uint256[] memory arr, uint256 pos) internal pure returns (uint256 res) { assembly { res := mload(add(add(arr, 0x20), mul(pos, 0x20))) } } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeMemoryAccess(address[] memory arr, uint256 pos) internal pure returns (address res) { assembly { res := mload(add(add(arr, 0x20), mul(pos, 0x20))) } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/IERC1155Receiver.sol) pragma solidity ^0.8.20; import {IERC165} from "../../utils/introspection/IERC165.sol"; /** * @dev Interface that must be implemented by smart contracts in order to receive * ERC-1155 token transfers. */ 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. * * NOTE: 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. * * NOTE: 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 (last updated v5.0.1) (token/ERC1155/IERC1155.sol) pragma solidity ^0.8.20; import {IERC165} from "../../utils/introspection/IERC165.sol"; /** * @dev Required interface of an ERC1155 compliant contract, as defined in the * https://eips.ethereum.org/EIPS/eip-1155[EIP]. */ interface IERC1155 is IERC165 { /** * @dev Emitted when `value` amount of tokens of 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 value 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 a `value` amount of tokens of type `id` from `from` to `to`. * * WARNING: This function can potentially allow a reentrancy attack when transferring tokens * to an untrusted contract, when invoking {onERC1155Received} on the receiver. * Ensure to follow the checks-effects-interactions pattern and consider employing * reentrancy guards when interacting with untrusted contracts. * * Emits a {TransferSingle} event. * * Requirements: * * - `to` cannot be the zero address. * - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}. * - `from` must have a balance of tokens of type `id` of at least `value` 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 value, bytes calldata data) external; /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}. * * WARNING: This function can potentially allow a reentrancy attack when transferring tokens * to an untrusted contract, when invoking {onERC1155BatchReceived} on the receiver. * Ensure to follow the checks-effects-interactions pattern and consider employing * reentrancy guards when interacting with untrusted contracts. * * Emits either a {TransferSingle} or a {TransferBatch} event, depending on the length of the array arguments. * * Requirements: * * - `ids` and `values` 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 values, bytes calldata data ) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/ERC165.sol) pragma solidity ^0.8.20; import {IERC165} from "./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); * } * ``` */ abstract contract ERC165 is IERC165 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) { return interfaceId == type(IERC165).interfaceId; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol) pragma solidity ^0.8.20; /** * @dev Standard ERC20 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens. */ interface IERC20Errors { /** * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. * @param balance Current balance for the interacting account. * @param needed Minimum amount required to perform a transfer. */ error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC20InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC20InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers. * @param spender Address that may be allowed to operate on tokens without being their owner. * @param allowance Amount of tokens a `spender` is allowed to operate with. * @param needed Minimum amount required to perform a transfer. */ error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC20InvalidApprover(address approver); /** * @dev Indicates a failure with the `spender` to be approved. Used in approvals. * @param spender Address that may be allowed to operate on tokens without being their owner. */ error ERC20InvalidSpender(address spender); } /** * @dev Standard ERC721 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens. */ interface IERC721Errors { /** * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20. * Used in balance queries. * @param owner Address of the current owner of a token. */ error ERC721InvalidOwner(address owner); /** * @dev Indicates a `tokenId` whose `owner` is the zero address. * @param tokenId Identifier number of a token. */ error ERC721NonexistentToken(uint256 tokenId); /** * @dev Indicates an error related to the ownership over a particular token. Used in transfers. * @param sender Address whose tokens are being transferred. * @param tokenId Identifier number of a token. * @param owner Address of the current owner of a token. */ error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC721InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC721InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `operator`’s approval. Used in transfers. * @param operator Address that may be allowed to operate on tokens without being their owner. * @param tokenId Identifier number of a token. */ error ERC721InsufficientApproval(address operator, uint256 tokenId); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC721InvalidApprover(address approver); /** * @dev Indicates a failure with the `operator` to be approved. Used in approvals. * @param operator Address that may be allowed to operate on tokens without being their owner. */ error ERC721InvalidOperator(address operator); } /** * @dev Standard ERC1155 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens. */ interface IERC1155Errors { /** * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. * @param balance Current balance for the interacting account. * @param needed Minimum amount required to perform a transfer. * @param tokenId Identifier number of a token. */ error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC1155InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC1155InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `operator`’s approval. Used in transfers. * @param operator Address that may be allowed to operate on tokens without being their owner. * @param owner Address of the current owner of a token. */ error ERC1155MissingApprovalForAll(address operator, address owner); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC1155InvalidApprover(address approver); /** * @dev Indicates a failure with the `operator` to be approved. Used in approvals. * @param operator Address that may be allowed to operate on tokens without being their owner. */ error ERC1155InvalidOperator(address operator); /** * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation. * Used in batch transfers. * @param idsLength Length of the array of token identifiers * @param valuesLength Length of the array of token amounts */ error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC1155/extensions/IERC1155MetadataURI.sol) pragma solidity ^0.8.20; import {IERC1155} from "../IERC1155.sol"; /** * @dev Interface of the optional ERC1155MetadataExtension interface, as defined * in the https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[EIP]. */ 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 (last updated v5.0.0) (utils/math/SignedMath.sol) pragma solidity ^0.8.20; /** * @dev Standard signed math utilities missing in the Solidity language. */ library SignedMath { /** * @dev Returns the largest of two signed numbers. */ function max(int256 a, int256 b) internal pure returns (int256) { return a > b ? a : b; } /** * @dev Returns the smallest of two signed numbers. */ function min(int256 a, int256 b) internal pure returns (int256) { return a < b ? a : b; } /** * @dev Returns the average of two signed numbers without overflow. * The result is rounded towards zero. */ function average(int256 a, int256 b) internal pure returns (int256) { // Formula from the book "Hacker's Delight" int256 x = (a & b) + ((a ^ b) >> 1); return x + (int256(uint256(x) >> 255) & (a ^ b)); } /** * @dev Returns the absolute unsigned value of a signed value. */ function abs(int256 n) internal pure returns (uint256) { unchecked { // must be unchecked in order to support `n = type(int256).min` return uint256(n >= 0 ? n : -n); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/introspection/IERC165.sol) pragma solidity ^0.8.20; /** * @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 (last updated v5.0.0) (utils/StorageSlot.sol) // This file was procedurally generated from scripts/generate/templates/StorageSlot.js. pragma solidity ^0.8.20; /** * @dev Library for reading and writing primitive types to specific storage slots. * * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts. * This library helps with reading and writing to such slots without the need for inline assembly. * * The functions in this library return Slot structs that contain a `value` member that can be used to read or write. * * Example usage to set ERC1967 implementation slot: * ```solidity * contract ERC1967 { * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc; * * function _getImplementation() internal view returns (address) { * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value; * } * * function _setImplementation(address newImplementation) internal { * require(newImplementation.code.length > 0); * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; * } * } * ``` */ library StorageSlot { struct AddressSlot { address value; } struct BooleanSlot { bool value; } struct Bytes32Slot { bytes32 value; } struct Uint256Slot { uint256 value; } struct StringSlot { string value; } struct BytesSlot { bytes value; } /** * @dev Returns an `AddressSlot` with member `value` located at `slot`. */ function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `BooleanSlot` with member `value` located at `slot`. */ function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `Bytes32Slot` with member `value` located at `slot`. */ function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `Uint256Slot` with member `value` located at `slot`. */ function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `StringSlot` with member `value` located at `slot`. */ function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `StringSlot` representation of the string storage pointer `store`. */ function getStringSlot(string storage store) internal pure returns (StringSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := store.slot } } /** * @dev Returns an `BytesSlot` with member `value` located at `slot`. */ function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`. */ function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := store.slot } } }
{ "evmVersion": "paris", "optimizer": { "enabled": true, "mode": "3" }, "outputSelection": { "*": { "*": [ "abi" ] } }, "detectMissingLibraries": false, "forceEVMLA": false, "enableEraVMExtensions": false, "libraries": {} }
Contract ABI
API[{"inputs":[{"internalType":"address","name":"tokenImplementation","type":"address"},{"internalType":"address","name":"multiTokenImplementation","type":"address"},{"internalType":"address","name":"protocolBeneficiary_","type":"address"},{"internalType":"uint256","name":"creationFee_","type":"uint256"},{"internalType":"uint256","name":"maxSteps","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"target","type":"address"}],"name":"AddressEmptyCode","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"AddressInsufficientBalance","type":"error"},{"inputs":[],"name":"ERC1167FailedCreateClone","type":"error"},{"inputs":[],"name":"FailedInnerCall","type":"error"},{"inputs":[],"name":"MCV2_BOND__InvalidPaginationParameters","type":"error"},{"inputs":[],"name":"MCV2_Bond__CreationFeeTransactionFailed","type":"error"},{"inputs":[],"name":"MCV2_Bond__ExceedMaxSupply","type":"error"},{"inputs":[],"name":"MCV2_Bond__ExceedTotalSupply","type":"error"},{"inputs":[{"internalType":"string","name":"reason","type":"string"}],"name":"MCV2_Bond__InvalidConstructorParams","type":"error"},{"inputs":[],"name":"MCV2_Bond__InvalidCreationFee","type":"error"},{"inputs":[],"name":"MCV2_Bond__InvalidCreatorAddress","type":"error"},{"inputs":[],"name":"MCV2_Bond__InvalidCurrentSupply","type":"error"},{"inputs":[],"name":"MCV2_Bond__InvalidReceiver","type":"error"},{"inputs":[{"internalType":"string","name":"reason","type":"string"}],"name":"MCV2_Bond__InvalidReserveToken","type":"error"},{"inputs":[{"internalType":"string","name":"reason","type":"string"}],"name":"MCV2_Bond__InvalidStepParams","type":"error"},{"inputs":[],"name":"MCV2_Bond__InvalidTokenAmount","type":"error"},{"inputs":[{"internalType":"string","name":"reason","type":"string"}],"name":"MCV2_Bond__InvalidTokenCreationParams","type":"error"},{"inputs":[],"name":"MCV2_Bond__PermissionDenied","type":"error"},{"inputs":[],"name":"MCV2_Bond__SlippageLimitExceeded","type":"error"},{"inputs":[],"name":"MCV2_Bond__TokenNotFound","type":"error"},{"inputs":[],"name":"MCV2_Bond__TokenSymbolAlreadyExists","type":"error"},{"inputs":[],"name":"MCV2_Royalty__InvalidParams","type":"error"},{"inputs":[],"name":"MCV2_Royalty__NothingToClaim","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"inputs":[{"internalType":"uint8","name":"bits","type":"uint8"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"SafeCastOverflowedUintDowncast","type":"error"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"SafeERC20FailedOperation","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"token","type":"address"},{"indexed":true,"internalType":"address","name":"creator","type":"address"}],"name":"BondCreatorUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"token","type":"address"},{"indexed":true,"internalType":"address","name":"user","type":"address"},{"indexed":false,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amountBurned","type":"uint256"},{"indexed":true,"internalType":"address","name":"reserveToken","type":"address"},{"indexed":false,"internalType":"uint256","name":"refundAmount","type":"uint256"}],"name":"Burn","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"CreationFeeUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"token","type":"address"},{"indexed":true,"internalType":"address","name":"user","type":"address"},{"indexed":false,"internalType":"address","name":"receiver","type":"address"},{"indexed":false,"internalType":"uint256","name":"amountMinted","type":"uint256"},{"indexed":true,"internalType":"address","name":"reserveToken","type":"address"},{"indexed":false,"internalType":"uint256","name":"reserveAmount","type":"uint256"}],"name":"Mint","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"token","type":"address"},{"indexed":false,"internalType":"string","name":"name","type":"string"},{"indexed":false,"internalType":"string","name":"symbol","type":"string"},{"indexed":false,"internalType":"string","name":"uri","type":"string"},{"indexed":true,"internalType":"address","name":"reserveToken","type":"address"}],"name":"MultiTokenCreated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"protocolBeneficiary","type":"address"}],"name":"ProtocolBeneficiaryUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"user","type":"address"},{"indexed":false,"internalType":"address","name":"reserveToken","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"RoyaltyClaimed","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"ratio","type":"uint256"}],"name":"RoyaltyRangeUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"token","type":"address"},{"indexed":false,"internalType":"string","name":"name","type":"string"},{"indexed":false,"internalType":"string","name":"symbol","type":"string"},{"indexed":true,"internalType":"address","name":"reserveToken","type":"address"}],"name":"TokenCreated","type":"event"},{"inputs":[],"name":"BURN_ADDRESS","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"tokensToBurn","type":"uint256"},{"internalType":"uint256","name":"minRefund","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"burn","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"reserveToken","type":"address"}],"name":"burnRoyalties","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"reserveToken","type":"address"}],"name":"claimRoyalties","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"string","name":"uri","type":"string"}],"internalType":"struct MCV2_Bond.MultiTokenParams","name":"tp","type":"tuple"},{"components":[{"internalType":"uint16","name":"mintRoyalty","type":"uint16"},{"internalType":"uint16","name":"burnRoyalty","type":"uint16"},{"internalType":"address","name":"reserveToken","type":"address"},{"internalType":"uint128","name":"maxSupply","type":"uint128"},{"internalType":"uint128[]","name":"stepRanges","type":"uint128[]"},{"internalType":"uint128[]","name":"stepPrices","type":"uint128[]"}],"internalType":"struct MCV2_Bond.BondParams","name":"bp","type":"tuple"}],"name":"createMultiToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"payable","type":"function"},{"inputs":[{"components":[{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"symbol","type":"string"}],"internalType":"struct MCV2_Bond.TokenParams","name":"tp","type":"tuple"},{"components":[{"internalType":"uint16","name":"mintRoyalty","type":"uint16"},{"internalType":"uint16","name":"burnRoyalty","type":"uint16"},{"internalType":"address","name":"reserveToken","type":"address"},{"internalType":"uint128","name":"maxSupply","type":"uint128"},{"internalType":"uint128[]","name":"stepRanges","type":"uint128[]"},{"internalType":"uint128[]","name":"stepPrices","type":"uint128[]"}],"internalType":"struct MCV2_Bond.BondParams","name":"bp","type":"tuple"}],"name":"createToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"creationFee","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"exists","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"getDetail","outputs":[{"components":[{"internalType":"uint16","name":"mintRoyalty","type":"uint16"},{"internalType":"uint16","name":"burnRoyalty","type":"uint16"},{"components":[{"internalType":"address","name":"creator","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint8","name":"decimals","type":"uint8"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"string","name":"name","type":"string"},{"internalType":"uint40","name":"createdAt","type":"uint40"},{"internalType":"uint128","name":"currentSupply","type":"uint128"},{"internalType":"uint128","name":"maxSupply","type":"uint128"},{"internalType":"uint128","name":"priceForNextMint","type":"uint128"},{"internalType":"address","name":"reserveToken","type":"address"},{"internalType":"uint8","name":"reserveDecimals","type":"uint8"},{"internalType":"string","name":"reserveSymbol","type":"string"},{"internalType":"string","name":"reserveName","type":"string"},{"internalType":"uint256","name":"reserveBalance","type":"uint256"}],"internalType":"struct MCV2_Bond.BondInfo","name":"info","type":"tuple"},{"components":[{"internalType":"uint128","name":"rangeTo","type":"uint128"},{"internalType":"uint128","name":"price","type":"uint128"}],"internalType":"struct MCV2_Bond.BondStep[]","name":"steps","type":"tuple[]"}],"internalType":"struct MCV2_Bond.BondDetail","name":"detail","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"start","type":"uint256"},{"internalType":"uint256","name":"stop","type":"uint256"}],"name":"getList","outputs":[{"components":[{"internalType":"address","name":"creator","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint8","name":"decimals","type":"uint8"},{"internalType":"string","name":"symbol","type":"string"},{"internalType":"string","name":"name","type":"string"},{"internalType":"uint40","name":"createdAt","type":"uint40"},{"internalType":"uint128","name":"currentSupply","type":"uint128"},{"internalType":"uint128","name":"maxSupply","type":"uint128"},{"internalType":"uint128","name":"priceForNextMint","type":"uint128"},{"internalType":"address","name":"reserveToken","type":"address"},{"internalType":"uint8","name":"reserveDecimals","type":"uint8"},{"internalType":"string","name":"reserveSymbol","type":"string"},{"internalType":"string","name":"reserveName","type":"string"},{"internalType":"uint256","name":"reserveBalance","type":"uint256"}],"internalType":"struct MCV2_Bond.BondInfo[]","name":"info","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"tokensToBurn","type":"uint256"}],"name":"getRefundForTokens","outputs":[{"internalType":"uint256","name":"refundAmount","type":"uint256"},{"internalType":"uint256","name":"royalty","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"tokensToMint","type":"uint256"}],"name":"getReserveForToken","outputs":[{"internalType":"uint256","name":"reserveAmount","type":"uint256"},{"internalType":"uint256","name":"royalty","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"wallet","type":"address"},{"internalType":"address","name":"reserveToken","type":"address"}],"name":"getRoyaltyInfo","outputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"getSteps","outputs":[{"components":[{"internalType":"uint128","name":"rangeTo","type":"uint128"},{"internalType":"uint128","name":"price","type":"uint128"}],"internalType":"struct MCV2_Bond.BondStep[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"creator","type":"address"},{"internalType":"uint256","name":"start","type":"uint256"},{"internalType":"uint256","name":"stop","type":"uint256"}],"name":"getTokensByCreator","outputs":[{"internalType":"address[]","name":"addresses","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"reserveToken","type":"address"},{"internalType":"uint256","name":"start","type":"uint256"},{"internalType":"uint256","name":"stop","type":"uint256"}],"name":"getTokensByReserveToken","outputs":[{"internalType":"address[]","name":"addresses","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxRoyaltyRange","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"maxSupply","outputs":[{"internalType":"uint128","name":"","type":"uint128"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"tokensToMint","type":"uint256"},{"internalType":"uint256","name":"maxReserveAmount","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"mint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"priceForNextMint","outputs":[{"internalType":"uint128","name":"","type":"uint128"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"protocolBeneficiary","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"tokenBond","outputs":[{"internalType":"address","name":"creator","type":"address"},{"internalType":"uint16","name":"mintRoyalty","type":"uint16"},{"internalType":"uint16","name":"burnRoyalty","type":"uint16"},{"internalType":"uint40","name":"createdAt","type":"uint40"},{"internalType":"address","name":"reserveToken","type":"address"},{"internalType":"uint256","name":"reserveBalance","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tokenCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"tokens","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"address","name":"creator","type":"address"}],"name":"updateBondCreator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"updateCreationFee","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"ratio","type":"uint256"}],"name":"updateMaxRoyaltyRange","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"protocolBeneficiary_","type":"address"}],"name":"updateProtocolBeneficiary","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"}],"name":"userTokenRoyaltyBalance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"},{"internalType":"address","name":"","type":"address"}],"name":"userTokenRoyaltyClaimed","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"version","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"}]
Contract Creation Code
9c4d535b000000000000000000000000000000000000000000000000000000000000000001000aa79704b24945449f296398b8aeefb16e8cc6e11e8865dfbb87efc438db000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000023cb54484b807b286e3a9bb52c416b0cfeb2d224000000000000000000000000e1c1c27589bef64ff80165ad02de7ebf8aef966f00000000000000000000000082ca6d313bffe56e9096b16633dfd414148d66b1000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003e8
Deployed Bytecode
0x0002000000000002001200000000000200010000000103550000006003100270000009e90030019d000009e9033001970000000100200190000000230000c13d0000008002000039000c00000002001d000000400020043f000000040030008c0000004e0000413d000000000201043b000000e002200270000009f90020009c000000500000213d00000a120020009c000000630000a13d00000a130020009c000000a20000a13d00000a140020009c000006ab0000a13d00000a150020009c00000d820000613d00000a160020009c0000080a0000613d00000a170020009c0000004e0000c13d0000000001000416000000000001004b0000004e0000c13d0000000101000039000000000101041a0000080e0000013d0000000002000416000000000002004b0000004e0000c13d0000001f02300039000009ea02200197000000e002200039000000400020043f0000001f0430018f000009eb05300198000000e002500039000000340000613d000000e006000039000000000701034f000000007807043c0000000006860436000000000026004b000000300000c13d000000000004004b000000410000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000120435000000a00030008c0000004e0000413d000000e00400043d000009ec0040009c0000004e0000213d000001000100043d001200000001001d000009ec0010009c0000004e0000213d000001200100043d001100000001001d000009ec0010009c0000059f0000a13d0000000001000019000027a000010430000009fa0020009c000000890000a13d000009fb0020009c000000ba0000a13d000009fc0020009c000006bb0000a13d000009fd0020009c00000dcf0000613d000009fe0020009c000008120000613d000009ff0020009c0000004e0000c13d0000000001000416000000000001004b0000004e0000c13d0000dead01000039000000800010043f00000a2a010000410000279f0001042e00000a1f0020009c0000014b0000213d00000a250020009c000006cd0000213d00000a280020009c000008b00000613d00000a290020009c0000004e0000c13d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000101043b000009ec0010009c0000004e0000213d000000000200041a000009ec032001970000000002000411000000000023004b00000de80000c13d000000000001004b000000b60000613d0000000103000039000000000203041a000009ed02200197000000000212019f000000000023041b000000800010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a60011001c70000800d0200003900000a730400004100000e140000013d00000a070020009c000001650000213d00000a0d0020009c000006e40000213d00000a100020009c000008f30000613d00000a110020009c0000004e0000c13d000000440030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000202043b000009ec0020009c0000004e0000213d0000002401100370000000000101043b001200000001001d000009ec0010009c0000004e0000213d000000000020043f0000000401000039000009230000013d00000a1a0020009c000005ac0000213d00000a1d0020009c0000076e0000613d00000a1e0020009c0000004e0000c13d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000101043b000000000200041a000009ec032001970000000002000411000000000023004b00000de80000c13d000027100010008c00000e090000a13d00000a7401000041000000800010043f00000a6b01000041000027a00001043000000a020020009c000006a20000213d00000a050020009c000007820000613d00000a060020009c0000004e0000c13d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000101043b001200000001001d000009ec0010009c0000004e0000213d0000dead01000039000000000010043f0000000401000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000001202000029000000000020043f000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b000000000101041a000000000001004b000007350000613d001100000001001d0000dead01000039000000000010043f0000000401000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000001202000029000000000020043f000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b000000000001041b0000dead01000039000000000010043f0000000501000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000001202000029000000000020043f000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b000000000201041a000000110020002a00000f740000413d00000011040000290000000002420019000000000021041b000000400200043d000000200120003900000a440300004100000000003104350000004401200039000000000041043500000024012000390000dead0300003900000000003104350000004401000039000000000012043500000a450020009c000010d10000213d0000008001200039000000400010043f0000001201000029279e209e0000040f000000400100043d00000020021000390000001103000029000000000032043500000012020000290000000000210435000009e90010009c000009e90100804100000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a2c011001c70000800d0200003900000002030000390000dead0500003900000a460400004100000e140000013d00000a200020009c000006ed0000213d00000a230020009c000009130000613d00000a240020009c0000004e0000c13d0000000001000416000000000001004b0000004e0000c13d000000c001000039000000400010043f0000000701000039000000800010043f00000a6c01000041000000a00010043f0000002001000039000000c00010043f0000008001000039000000e002000039279e1ad90000040f000000c00110008a000009e90010009c000009e901008041000000600110021000000a6d011001c70000279f0001042e00000a080020009c000007090000213d00000a0b0020009c000009310000613d00000a0c0020009c0000004e0000c13d000000440030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000202043b0000002401100370000000000101043b0000000003010019000000000121004b00000ded0000a13d000003e80010008c00000ded0000213d0000000701000039000000000101041a000000000013004b0000000003018019000100000003001d000000000323004900000a2d0030009c000010d10000213d000000000602001900000005013002100000003f0210003900000a310420019700000a450040009c000010d10000213d0000008002400039000000400020043f000000800030043f000000010060006b000010a80000c13d000000010060006b0000058c0000a13d000b00000000001d0000000701000039000000000101041a000900000006001d000000000061004b0000156d0000a13d000000400100043d00000a4c0010009c000010d10000213d000000090200002900000a2b0220009a000000000202041a000009ec04200197000001c002100039000000400020043f000001800210003900000060030000390000000000320435000001600210003900000000003204350000008002100039000000000032043500000060021000390000000000320435000001a0021000390000000000020435000001400210003900000000000204350000012002100039000000000002043500000100021000390000000000020435000000e0021000390000000000020435000000c0021000390000000000020435000000a002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000e00000004001d000000000040043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000400500043d00000a2f0050009c000010d10000213d000000000101043b000000e002500039000000400020043f000000000201041a000000b0032002700000ffff0330018f00000040045000390000000000340435000000a0032002700000ffff0330018f00000020045000390000000000340435000009ec032001970000000000350435000000c00220027000000a30022001970000006003500039000f00000003001d00000000002304350000000102100039000000000202041a000009ec022001970000008003500039000800000003001d0000000000230435000000a0035000390000000202100039000000000202041a000700000003001d00000000002304350000000301100039000000000401041a00000a2d0040009c000010d10000213d00000005024002100000003f0220003900000a3102200197000000400600043d0000000002260019000000000062004b0000000003000039000000010300403900000a2d0020009c000010d10000213d0000000100300190000010d10000c13d001200000005001d000000400020043f001100000006001d0000000000460435000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039001000000004001d279e27990000040f00000001002001900000004e0000613d0000001009000029000000000009004b0000001208000029000000110a0000290000021f0000613d000000000101043b000000000200001900000000030a0019000000400400043d00000a330040009c000010d10000213d0000004005400039000000400050043f0000002005400039000000000601041a0000008007600270000000000075043500000a340560019700000000005404350000002003300039000000000043043500000001011000390000000102200039000000000092004b0000020e0000413d000000c0018000390000000000a104350000000001080433000600000001001d00000008010000290000000001010433001100000001001d000000400200043d001200000002001d00000a37010000410000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000e02000029279e27990000040f000000120a0000290000006003100270000009e903300197000000200030008c00000020040000390000000004034019000000200640019000000000056a0019000002450000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b000002410000c13d0000001f07400190000002520000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000011ee0000613d0000001f01400039000000600110018f0000000004a10019000000000014004b0000000001000039000000010100403900000a2d0040009c000010d10000213d0000000100100190000010d10000c13d000000400040043f000000200030008c0000004e0000413d00000000010a0433000500000001001d000000ff0010008c0000004e0000213d00000a4d010000410000000000140435000009e90040009c000009e901000041000000000104401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000e02000029001200000004001d279e27990000040f00000060031002700000001f0430018f000009eb05300197000009e9033001970000000100200190000011fa0000613d00000012090000290000000002590019000000000005004b000002840000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000027004b000002800000c13d000000000004004b000002910000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000009ea011001970000000001910019000d00000001001d00000a2d0010009c000010d10000213d0000000d01000029000000400010043f000000200030008c0000004e0000413d000000000109043300000a2d0010009c0000004e0000213d000000000393001900000000019100190000001f02100039000000000032004b0000004e0000813d000000002101043400000a2d0010009c000010d10000213d0000001f0410003900000a76044001970000003f0440003900000a76044001970000000d0440002900000a2d0040009c000010d10000213d000000400040043f0000000d0400002900000000041404360000000005210019000000000035004b0000004e0000213d000000000001004b000002bd0000613d000000000300001900000000054300190000000006230019000000000606043300000000006504350000002003300039000000000013004b000002b60000413d00000000014100190000000000010435000000400200043d00000a4e010000410000000000120435000009e90020009c001200000002001d000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000e02000029279e27990000040f00000060031002700000001f0430018f000009eb05300197000009e9033001970000000100200190000012050000613d00000012090000290000000002590019000000000005004b000002df0000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000027004b000002db0000c13d000000000004004b000002ec0000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000009ea011001970000000002910019000000000012004b00000000010000390000000101004039000c00000002001d00000a2d0020009c000010d10000213d0000000100100190000010d10000c13d0000000c01000029000000400010043f000000200030008c0000004e0000413d000000000109043300000a2d0010009c0000004e0000213d000000000393001900000000019100190000001f02100039000000000032004b000000000400001900000a4f0400804100000a4f0220019700000a4f05300197000000000652013f000000000052004b000000000200001900000a4f0200404100000a4f0060009c000000000204c019000000000002004b0000004e0000c13d000000002101043400000a2d0010009c000010d10000213d0000001f0410003900000a76044001970000003f0440003900000a76044001970000000c0440002900000a2d0040009c000010d10000213d000000400040043f0000000c0400002900000000041404360000000005210019000000000035004b0000004e0000213d000000000001004b000003280000613d000000000300001900000000054300190000000006230019000000000606043300000000006504350000002003300039000000000013004b000003210000413d000000000141001900000000000104350000000f010000290000000001010433000400000001001d000000400200043d001200000002001d00000a35010000410000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000e02000029279e27990000040f000000120a0000290000006003100270000009e903300197000000200030008c00000020040000390000000004034019000000200640019000000000056a00190000034c0000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b000003480000c13d0000001f07400190000003590000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000012100000613d0000001f01400039000000600210018f0000000001a20019000000000021004b0000000002000039000000010200403900000a2d0010009c000010d10000213d0000000100200190000010d10000c13d000000400010043f000000200030008c0000004e0000413d00000000020a0433000300000002001d00000a500020009c0000121c0000813d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000301100039000000000201041a001200000002001d000000000002004b00000f740000613d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000001201100029000000010110008a000000000101041a000200000001001d000000400200043d001200000002001d00000a35010000410000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000e02000029279e27990000040f000000120a0000290000006003100270000009e903300197000000200030008c00000020040000390000000004034019000000200640019000000000056a0019000003ad0000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b000003a90000c13d0000001f07400190000003ba0000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000012290000613d0000001f01400039000000600210018f0000000001a20019000000000021004b0000000002000039000000010200403900000a2d0010009c000010d10000213d0000000100200190000010d10000c13d000000400010043f000000200030008c0000004e0000413d00000000010a0433001200000001001d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000301100039000000000201041a001000000002001d000000000002004b00000f740000613d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000001001100029000000010110008a000000000101041a001000000001001d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f000000100300002900000a3403300197000000120030006b0000000003000039000000010300403900000001002001900000004e0000613d000000000101043b0000000304100039000000000104041a001000000001001d000000000001004b000016960000613d0000001101000029000a09ec0010019b001100120030002d0000000002000019000f00000004001d000000000104041a001200000002001d000000000021004b0000156d0000a13d000000000040043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b00000012020000290000000001210019000000000101041a00000a3401100197000000110010006c000004240000813d0000000102200039000000100020006c0000000f040000290000040a0000413d000016960000013d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000301100039000000000201041a000000120020006c0000156d0000a13d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000001201100029000000000101041a001100000001001d00000008010000290000000001010433001000000001001d000000400200043d001200000002001d00000a37010000410000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000a02000029279e27990000040f000000120a0000290000006003100270000009e903300197000000200030008c00000020040000390000000004034019000000200640019000000000056a0019000004660000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000058004b000004620000c13d0000001f07400190000004730000613d000000000661034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f00000000006504350000000100200190000012350000613d0000001f01400039000000600110018f0000000004a10019000000000014004b0000000001000039000000010100403900000a2d0040009c000010d10000213d0000000100100190000010d10000c13d000000400040043f000000200030008c0000004e0000413d00000000010a0433000f00000001001d000000ff0010008c0000004e0000213d00000a4d010000410000000000140435000009e90040009c000009e901000041000000000104401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000a02000029001200000004001d279e27990000040f00000060031002700000001f0430018f000009eb05300197000009e9033001970000000100200190000012410000613d00000012090000290000000002590019000000000005004b000004a50000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000027004b000004a10000c13d000000000004004b000004b20000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000009ea01100197000000000691001900000a2d0060009c000010d10000213d000000400060043f000000200030008c0000004e0000413d000000000109043300000a2d0010009c0000004e0000213d000000000393001900000000019100190000001f02100039000000000032004b0000004e0000813d000000002101043400000a2d0010009c000010d10000213d0000001f0410003900000a76044001970000003f0440003900000a7604400197000000000464001900000a2d0040009c000010d10000213d000000400040043f00000000041604360000000005210019000000000035004b0000004e0000213d001200000006001d000000000001004b000004dc0000613d000000000300001900000000054300190000000006230019000000000606043300000000006504350000002003300039000000000013004b000004d50000413d00000000014100190000000000010435000000400200043d00000a4e010000410000000000120435000009e90020009c000800000002001d000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000a02000029279e27990000040f00000060031002700000001f0430018f000009eb05300197000009e90330019700000001002001900000124c0000613d00000008090000290000000002590019000000000005004b000004fe0000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000027004b000004fa0000c13d000000000004004b0000050b0000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000009ea021001970000000001920019000000000021004b0000000002000039000000010200403900000a2d0010009c0000001208000029000010d10000213d0000000100200190000010d10000c13d000000400010043f000000200030008c0000004e0000413d000000000209043300000a2d0020009c0000004e0000213d000000000493001900000000029200190000001f03200039000000000043004b000000000500001900000a4f0500804100000a4f0330019700000a4f06400197000000000763013f000000000063004b000000000300001900000a4f0300404100000a4f0070009c000000000305c019000000000003004b0000004e0000c13d000000003202043400000a2d0020009c000010d10000213d0000001f0520003900000a76055001970000003f0550003900000a7605500197000000000515001900000a2d0050009c000010d10000213d000000400050043f00000000052104360000000006320019000000000046004b0000004e0000213d000000000002004b000005450000613d000000000400001900000000065400190000000007340019000000000707043300000000007604350000002004400039000000000024004b0000053e0000413d00000000025200190000000000020435000000400200043d00000a4c0020009c000010d10000213d00000007030000290000000003030433000001c004200039000000400040043f000001a004200039000000000034043500000180032000390000000000130435000001600120003900000000008104350000000f01000029000000ff0110018f000001400320003900000000001304350000001001000029000009ec01100197000001200320003900000000001304350000001101000029000000800110027000000100032000390000000000130435000000020100002900000a3401100197000000e0032000390000000000130435000000030100002900000a3401100197000000c0032000390000000000130435000000040100002900000a3001100197000000a003200039000000000013043500000080012000390000000c03000029000000000031043500000060012000390000000d0300002900000000003104350000000501000029000000ff0110018f0000004003200039000000000013043500000020012000390000000e0300002900000000003104350000000601000029000009ec011001970000000000120435000000800100043d0000000b0010006c0000156d0000a13d0000000b030000290000000501300210000000a0011000390000000000210435000000800100043d000000000031004b0000156d0000a13d0000000b01000029000b00010010003d00000009060000290000000106600039000000010060006c0000018f0000413d000000400100043d00000020020000390000000003210436000000800200043d0000000000230435000000400310003900000005042002100000000004340019000000000002004b000010e40000c13d0000000002140049000009e90020009c000009e9020080410000006002200210000009e90010009c000009e9010080410000004001100210000000000112019f0000279f0001042e000000400200043d0000000006000411000000000006004b000007380000c13d000009f701000041000000000012043500000004012000390000000000010435000009e90020009c000009e9020080410000004001200210000009f8011001c7000027a00001043000000a1b0020009c000007a40000613d00000a1c0020009c0000004e0000c13d000000440030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000202043b001200000002001d000009ec0020009c0000004e0000213d0000002401100370000000000101043b001100000001001d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000101100039000000000101041a000009ec00100198000007a10000613d000000110000006b00000e330000613d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000400200043d001000000002001d00000a2f0020009c000010d10000213d000000000101043b0000001005000029000000e002500039000000400020043f000000000201041a000000c00320027000000a300330019700000060045000390000000000340435000000b0032002700000ffff0330018f00000040045000390000000000340435000009ec032001970000000003350436000000a0022002700000ffff0220018f000d00000003001d00000000002304350000000102100039000000000202041a000009ec0220019700000080035000390000000000230435000000a0025000390000000203100039000000000303041a00000000003204350000000301100039000000000401041a00000a2d0040009c000010d10000213d00000005024002100000003f0220003900000a3102200197000000400300043d0000000002230019000c00000003001d000000000032004b0000000003000039000000010300403900000a2d0020009c000010d10000213d0000000100300190000010d10000c13d000000400020043f0000000c02000029000f00000004001d0000000002420436000b00000002001d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d0000000f08000029000000000008004b000006350000613d000000000101043b00000000020000190000000c03000029000000400400043d00000a330040009c000010d10000213d0000004005400039000000400050043f0000002005400039000000000601041a0000008007600270000000000075043500000a340560019700000000005404350000002003300039000000000043043500000001011000390000000102200039000000000082004b000006240000413d0000001001000029000000c0011000390000000c02000029000000000021043500000a3501000041000000400200043d001000000002001d0000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000001202000029279e27990000040f0000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000100b0000290000001005700029000006590000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000006550000c13d000000000006004b000006660000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000011a60000613d0000001f01400039000000600210018f0000000001b20019000000000021004b0000000002000039000000010200403900000a2d0010009c000010d10000213d0000000100200190000010d10000c13d000000400010043f000000200030008c0000004e0000413d00000000020b0433001000000002001d000000110020002a00000f740000413d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000301100039000000000201041a000f00000002001d000000000002004b00000f740000613d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d00000010030000290000001102300029000000000101043b0000000f01100029000000010110008a000000000101041a00000a3401100197000000000012004b000015b20000a13d000000400100043d00000a5c0200004100000f8b0000013d00000a030020009c000007cc0000613d00000a040020009c0000004e0000c13d0000000001000416000000000001004b0000004e0000c13d00000002010000390000092d0000013d00000a180020009c000007f00000613d00000a190020009c0000004e0000c13d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000101043b000009ec0010009c0000004e0000213d279e214e0000040f00000a340110019700000c720000013d00000a000020009c000007f50000613d00000a010020009c0000004e0000c13d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000101043b000009ec0010009c0000004e0000213d279e21380000040f000000000001004b0000000001000039000000010100c03900000c720000013d00000a260020009c000009b10000613d00000a270020009c0000004e0000c13d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000101043b0000000702000039000000000202041a000000000021004b0000004e0000813d279e1acb0000040f0000000302200210000000000101041a000000000121022f000009ec01100197000000ff0020008c000000000100201900000c720000013d00000a0e0020009c00000c680000613d00000a0f0020009c0000004e0000c13d0000000001000416000000000001004b0000004e0000c13d00000007010000390000092d0000013d00000a210020009c00000c790000613d00000a220020009c0000004e0000c13d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d000000000200041a000009ec032001970000000002000411000000000023004b00000de80000c13d0000000401100370000000000101043b0000000202000039000000000012041b000000800010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a60011001c70000800d02000039000000010300003900000a620400004100000e140000013d00000a090020009c00000d520000613d00000a0a0020009c0000004e0000c13d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000101043b001200000001001d000009ec0010009c0000004e0000213d0000000001000411000000000010043f0000000401000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000001202000029000000000020043f000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b000000000101041a000000000001004b000010440000c13d000000400100043d00000a490200004100000f8b0000013d000e00000002001d000001600100043d000d00000001001d000001400100043d000f00000001001d000000000100041a000009ed02100197000000000262019f000000000020041b0000000002000414000009ec05100197000009e90020009c000009e902008041000000c001200210000009ee011001c70000800d020000390000000303000039001000000004001d000009ef04000041279e27940000040f000000100300002900000001002001900000004e0000613d00001388010000390000000306000039000000000016041b0000000101000039000000000201041a000009ed022001970000001105000029000000000252019f000000000021041b00000002010000390000000f02000029000000000021041b000000000003004b00000df60000c13d0000000e030000290000004401300039000009f6020000410000000000210435000000240130003900000013020000390000000000210435000009f2010000410000000000130435000000040130003900000020020000390000000000210435000009e90030009c000009e9030080410000004001300210000009f3011001c7000027a0000104300000000001000416000000000001004b0000004e0000c13d000000000100041a000009ec021001970000000005000411000000000052004b00000df10000c13d000009ed01100197000000000010041b0000000001000414000009e90010009c000009e901008041000000c001100210000009ee011001c70000800d020000390000000303000039000009ef04000041000000000600001900000e140000013d000000440030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000202043b001200000002001d000009ec0020009c0000004e0000213d0000002401100370000000000101043b001100000001001d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000101100039000000000101041a000009ec0010019800000e310000c13d000000400100043d00000a690200004100000f8b0000013d000000440030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000202043b001200000002001d000009ec0020009c0000004e0000213d0000002401100370000000000101043b001100000001001d000009ec0010009c0000004e0000213d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b000000000201041a000009ec032001970000000004000411000000000043004b00000f890000c13d0000001106000029000000000006004b000010d70000c13d000000400100043d00000a5f0200004100000f8b0000013d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000101043b000009ec0010009c0000004e0000213d000000000010043f0000000601000039000000200010043f00000040020000390000000001000019279e277f0000040f0000000202100039000000000202041a0000000103100039000000000303041a000000000101041a000009ec04100197000000800040043f000000a0041002700000ffff0440018f000000a00040043f000000b0041002700000ffff0440018f000000c00040043f000000c00110027000000a3001100197000000e00010043f000009ec01300197000001000010043f000001200020043f00000a43010000410000279f0001042e0000000001000416000000000001004b0000004e0000c13d00000003010000390000092d0000013d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000601043b000009ec0060009c0000004e0000213d000000000100041a000009ec021001970000000005000411000000000052004b00000df10000c13d000000000006004b00000e360000c13d000009f701000041000000800010043f000000840000043f00000a4201000041000027a0000104300000000001000416000000000001004b0000004e0000c13d000000000100041a000009ec01100197000000800010043f00000a2a010000410000279f0001042e000000640030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000202043b001000000002001d000009ec0020009c0000004e0000213d0000002402100370000000000202043b0000004401100370000000000101043b000e00000002001d0000000003010019000000000121004b00000ded0000a13d000027100010008c00000ded0000213d0000000701000039000000000101041a000000000013004b00000000030180190000000e01000029000f00000003001d000000000031004b0000000003000019000008550000813d00000000030100190000000002000019001200000002001d0000000701000039000000000101041a000000000031004b0000156d0000a13d001100000003001d00000a2b0130009a000000000101041a000009ec01100197000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b000000000101041a000000100110014f000009ec0010019800000012020000290000000102206039000000110300002900000001033000390000000f0030006c000008310000413d00000a2d0020009c000010d10000213d0000000003020019000000400100043d000c00000001001d001200000003001d00000005023002100000003f0120003900000a2e031001970000000c01300029000000000031004b0000000003000039000000010300403900000a2d0010009c000010d10000213d0000000100300190000010d10000c13d000000400010043f0000000c0100002900000012030000290000000001310436000b00000001001d0000001f0120018f000000000002004b000008710000613d0000000b04000029000000000224001900000000030000310000000103300367000000003503043c0000000004540436000000000024004b0000086d0000c13d000000000001004b0000000e010000290000000f0010006c000008ac0000813d000d00000000001d0000087b0000013d0000000e0100002900000001011000390000000f0010006c000008ac0000813d000e00000001001d0000000701000039000000000101041a0000000e0010006c0000156d0000a13d0000000e0100002900000a2b0110009a001100000001001d000000000101041a000009ec01100197000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b000000000101041a000000100110014f000009ec00100198000008770000c13d0000000701000039000000000101041a0000000e0010006c0000156d0000a13d0000000701000039000000000010043f0000000c0100002900000000010104330000000d0010006c0000156d0000a13d0000000d0300002900000005013002100000000b011000290000001102000029000000000202041a000009ec0220019700000000002104350000000103300039000d00000003001d000000120030006c0000000e01000029000008780000c13d000000400100043d001200000001001d0000000c0200002900000ea10000013d000000640030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000202043b001000000002001d000009ec0020009c0000004e0000213d0000002402100370000000000202043b0000004401100370000000000101043b000e00000002001d0000000003010019000000000121004b00000ded0000a13d000027110010008c00000ded0000813d0000000701000039000000000101041a000000000013004b00000000030180190000000e01000029000f00000003001d000000000031004b00000e420000813d00000000030100190000000002000019001200000002001d0000000701000039000000000101041a000000000031004b0000156d0000a13d001100000003001d00000a2b0130009a000000000101041a000009ec01100197000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000101100039000000000101041a000000100110014f000009ec0010019800000012020000290000000102206039000000110300002900000001033000390000000f0030006c000008ce0000413d00000a2d0020009c000010d10000213d0000000001020019000000400400043d00000e440000013d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000101043b000009ec0010009c0000004e0000213d000000000010043f0000000601000039000000200010043f00000040020000390000000001000019279e277f0000040f0000000301100039279e205e0000040f0000002002000039000000400300043d001200000003001d0000000002230436279e1aeb0000040f00000012020000290000000001210049000009e90010009c000009e9010080410000006001100210000009e90020009c000009e9020080410000004002200210000000000121019f0000279f0001042e000000440030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000202043b000009ec0020009c0000004e0000213d0000002401100370000000000101043b001200000001001d000009ec0010009c0000004e0000213d000000000020043f0000000501000039000000200010043f00000040020000390000000001000019279e277f0000040f0000001202000029000000000020043f000000200010043f00000000010000190000004002000039279e277f0000040f000000000101041a000000800010043f00000a2a010000410000279f0001042e0000000002000416000000000002004b0000004e0000c13d000000240030008c0000004e0000413d0000000401100370000000000101043b001200000001001d000009ec0010009c0000004e0000213d0000010001000039000000400010043f000000800000043f000000a00000043f279e226c0000040f000000c00010043f0000006001000039000000e00010043f0000001201000029000000000010043f0000000601000039000000200010043f00000040020000390000000001000019279e277f0000040f000e00000001001d000000400100043d001100000001001d279e1b860000040f0000000e06000029000000000106041a000000c00210027000000a3002200197000000110400002900000060034000390000000000230435000009ec021001970000000003240436000f00000003001d000000b0021002700000ffff0220018f0000004005400039001000000005001d0000000000250435000000a0011002700000ffff0110018f00000000001304350000000101600039000000000101041a000009ec01100197000000800240003900000000001204350000000201600039000000000101041a000000a00240003900000000001204350000000301600039279e205e0000040f0000001102000029000000c002200039001100000002001d00000000001204350000000f010000290000000001010433000f00000001001d00000010010000290000000001010433001000000001001d0000001201000029279e22940000040f00000011020000290000000002020433000e00000002001d001200000001001d000000400100043d000d00000001001d279e1b910000040f0000000d040000290000006001400039001100000001001d0000000e02000029000000000021043500000040014000390000001202000029000000000021043500000010020000290000ffff0220018f000000200340003900000000002304350000000f020000290000ffff0220018f00000000002404350000002002000039000000400500043d001200000005001d000000000225043600000000040404330000ffff0440018f000000000042043500000000020304330000ffff0220018f000000400350003900000000002304350000000001010433000000800200003900000060035000390000000000230435000000a002500039279e1afe0000040f000000000201001900000012040000290000000001410049000000200310008a0000001101000029000000000101043300000080044000390000000000340435279e1aeb0000040f00000012020000290000000001210049000009e90020009c000009e9020080410000004002200210000009e90010009c000009e9010080410000006001100210000000000121019f0000279f0001042e000000440030008c0000004e0000413d0000000402100370000000000202043b001200000002001d00000a2d0020009c0000004e0000213d000000120230006a00000a520020009c0000004e0000213d000000440020008c0000004e0000413d0000002402100370000000000202043b001100000002001d00000a2d0020009c0000004e0000213d000000110230006a00000a520020009c0000004e0000213d000000c40020008c0000004e0000413d0000000202000039000000000202041a0000000004000416000000000024004b00000e190000c13d0000001202000029001000040020003d000000100230006a0000001004100360000000000504043b0000001f0220008a00000a4f0420019700000a4f06500197000000000746013f000000000046004b000000000600001900000a4f06004041000000000025004b000000000800001900000a4f0800804100000a4f0070009c000000000608c019000000000006004b0000004e0000c13d0000001006500029000000000561034f000000000505043b00000a2d0050009c0000004e0000213d00000000075300490000002006600039000000000076004b000000000800001900000a4f0800204100000a4f0770019700000a4f06600197000000000976013f000000000076004b000000000600001900000a4f0600404100000a4f0090009c000000000608c019000000000006004b0000004e0000c13d000000000005004b00000dc50000613d0000001005000029000f00200050003d0000000f05100360000000000505043b00000a4f06500197000000000746013f000000000046004b000000000400001900000a4f04004041000000000025004b000000000200001900000a4f0200804100000a4f0070009c000000000402c019000000000004004b0000004e0000c13d0000001002500029000000000121034f000000000101043b00000a2d0010009c0000004e0000213d00000000031300490000002002200039000000000032004b000000000400001900000a4f0400204100000a4f0330019700000a4f02200197000000000532013f000000000032004b000000000200001900000a4f0200404100000a4f0050009c000000000204c019000000000002004b0000004e0000c13d000000000001004b0000119c0000613d00000011010000290000000401100039000e00000001001d279e1bb00000040f00000001020003670000000f01200360000000000301043b0000000001000031000000120410006a000000230440008a00000a4f0540019700000a4f06300197000000000756013f000000000056004b000000000500001900000a4f05004041000000000043004b000000000400001900000a4f0400804100000a4f0070009c000000000504c019000000000005004b0000004e0000c13d0000001003300029000000000232034f000000000202043b001200000002001d00000a2d0020009c0000004e0000213d000000120110006a000000200530003900000a4f0210019700000a4f03500197000000000423013f000000000023004b000000000200001900000a4f02004041000d00000005001d000000000015004b000000000100001900000a4f0100204100000a4f0040009c000000000201c019000000000002004b0000004e0000c13d00000a5301000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000009e90010009c000009e901008041000000c00110021000000a54011001c70000800502000039279e27990000040f000000010020019000001a610000613d000000000101043b0000000d020000290000001203000029279e1fa90000040f00000001030003670000001002300360000000000602043b0000000002000031000000100420006a0000001f0440008a00000a4f0540019700000a4f07600197000000000857013f000000000057004b000000000700001900000a4f07004041000000000046004b000000000900001900000a4f0900804100000a4f0080009c000000000709c019001200000001001d000000000007004b0000004e0000c13d0000001001600029000000000613034f000000000606043b000d00000006001d00000a2d0060009c0000004e0000213d0000000d0620006a000000200910003900000a4f0160019700000a4f07900197000000000817013f000000000017004b000000000100001900000a4f01004041000c00000009001d000000000069004b000000000600001900000a4f0600204100000a4f0080009c000000000106c019000000000001004b0000004e0000c13d0000000f01300360000000000101043b00000a4f06100197000000000756013f000000000056004b000000000500001900000a4f05004041000000000041004b000000000400001900000a4f0400804100000a4f0070009c000000000504c019000000000005004b0000004e0000c13d0000001001100029000000000313034f000000000303043b000b00000003001d00000a2d0030009c0000004e0000213d0000000b0220006a000000200510003900000a4f0120019700000a4f03500197000000000413013f000000000013004b000000000100001900000a4f01004041000a00000005001d000000000025004b000000000200001900000a4f0200204100000a4f0040009c000000000102c019000000000001004b0000004e0000c13d0000001201000029000009ec0210019700000a38010000410000000000100443000900000002001d00000004002004430000000001000414000009e90010009c000009e901008041000000c00110021000000a39011001c70000800202000039279e27990000040f000000010020019000001a610000613d000000000101043b000000000001004b0000004e0000613d000000400400043d00000a6f01000041000000000014043500000044014000390000000d03000029000000000031043500000004014000390000004002000039000000000021043500000a76053001980000001f0630018f000800000004001d0000006403400039000000000453001900000001020003670000000c0720036000000ad20000613d000000000807034f0000000009030019000000008a08043c0000000009a90436000000000049004b00000ace0000c13d000000000006004b00000adf0000613d000000000557034f0000000306600210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f00000000005404350000000d05000029000000000453001900000000000404350000001f0450003900000a7604400197000000000443001900000000011400490000000803000029000000240330003900000000001304350000000a032003600000000b02000029000000000124043600000a76042001980000001f0520018f000000000241001900000af60000613d000000000603034f0000000007010019000000006806043c0000000007870436000000000027004b00000af20000c13d000000000005004b00000b030000613d000000000343034f0000000304500210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f00000000003204350000000b040000290000001f0240003900000a760220019700000000034100190000000000030435000000080300002900000000023200490000000001120019000009e90010009c000009e9010080410000006001100210000009e90030009c000009e90200004100000000020340190000004002200210000000000121019f0000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f0000000902000029279e27940000040f00000001002001900000181f0000613d000000080100002900000a2d0010009c000010d10000213d0000000801000029000000400010043f0000000702000039000000000102041a00000a2d0010009c000010d10000213d0000000103100039000000000032041b000000000020043f00000a2b0110009a000000000201041a000009ed0220019700000009022001af000000000021041b00000012010000290000000e02000029279e1dee0000040f00000001010003670000001002100360000000000302043b0000000004000031000000100240006a0000001f0220008a00000a4f0520019700000a4f06300197000000000756013f000000000056004b000000000600001900000a4f06004041000000000023004b000000000800001900000a4f0800804100000a4f0070009c000000000608c019000000000006004b0000004e0000c13d0000001006300029000000000361034f000000000303043b00000a2d0030009c0000004e0000213d0000000008340049000000200760003900000a4f0680019700000a4f09700197000000000a69013f000000000069004b000000000600001900000a4f06004041000000000087004b000000000800001900000a4f0800204100000a4f00a0009c000000000608c019000000000006004b0000004e0000c13d0000000f06100360000000000606043b00000a4f08600197000000000958013f000000000058004b000000000500001900000a4f05004041000000000026004b000000000200001900000a4f0200804100000a4f0090009c000000000502c019000000000005004b0000004e0000c13d0000001005600029000000000251034f000000000202043b00000a2d0020009c0000004e0000213d0000000004240049000000200550003900000a4f0640019700000a4f08500197000000000968013f000000000068004b000000000600001900000a4f06004041000000000045004b000000000400001900000a4f0400204100000a4f0090009c000000000604c019000000000006004b0000004e0000c13d0000001104000029001200440040003d0000001204100360000000000604043b000009ec0060009c0000004e0000213d000000000a71034f000000400400043d000000400700003900000000077404360000004008400039000000000038043500000a760b3001980000001f0c30018f00000060084000390000000009b8001900000b900000613d000000000d0a034f000000000e08001900000000df0d043c000000000efe043600000000009e004b00000b8c0000c13d00000000000c004b00000b9d0000613d000000000aba034f000000030bc00210000000000c090433000000000cbc01cf000000000cbc022f000000000a0a043b000001000bb00089000000000aba022f000000000aba01cf000000000aca019f0000000000a90435000000000938001900000000000904350000001f0330003900000a7603300197000000000338001900000000084300490000000000870435000000000551034f000000000123043600000a76072001980000001f0820018f000000000371001900000bb00000613d000000000905034f000000000a010019000000009b09043c000000000aba043600000000003a004b00000bac0000c13d000000000008004b00000bbd0000613d000000000575034f0000000307800210000000000803043300000000087801cf000000000878022f000000000505043b0000010007700089000000000575022f00000000057501cf000000000585019f00000000005304350000001f0320003900000a76033001970000000002210019000000000002043500000000024300490000000001120019000009e90010009c000009e9010080410000006001100210000009e90040009c000009e9040080410000004002400210000000000121019f0000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f000009ee011001c70000800d02000039000000030300003900000a70040000410000000905000029279e27940000040f00000001002001900000004e0000613d000000120100002900000060041000390000000101000367000000000241034f000000000602043b00000000020000310000000e0320006a0000001f0330008a00000a4f0530019700000a4f07600197000000000857013f000000000057004b000000000700001900000a4f07004041000000000036004b000000000900001900000a4f0900804100000a4f0080009c000000000709c019000000000007004b0000004e0000c13d0000000e07600029000000000671034f000000000606043b00000a2d0060009c0000004e0000213d00000005086002100000000008820049000000200770003900000a4f0980019700000a4f0a700197000000000b9a013f00000000009a004b000000000900001900000a4f09004041000000000087004b000000000800001900000a4f0800204100000a4f00b0009c000000000908c019000000000009004b0000004e0000c13d000000000006004b0000156d0000613d000000000671034f000000000606043b00000a340060009c0000004e0000213d000000000006004b00000c620000c13d000000200440008a000000000441034f000000000404043b00000a4f06400197000000000756013f000000000056004b000000000500001900000a4f05004041000000000034004b000000000300001900000a4f0300804100000a4f0070009c000000000503c019000000000005004b0000004e0000c13d0000000e04400029000000000341034f000000000303043b00000a2d0030009c0000004e0000213d00000005053002100000000005520049000000200240003900000a4f0450019700000a4f06200197000000000746013f000000000046004b000000000400001900000a4f04004041000000000052004b000000000500001900000a4f0500204100000a4f0070009c000000000405c019000000000004004b0000004e0000c13d000000000003004b0000156d0000613d000000000121034f000000000101043b001200000001001d00000a340010009c0000004e0000213d00000a38010000410000000000100443000000090100002900000004001004430000000001000414000009e90010009c000009e901008041000000c00110021000000a39011001c70000800202000039279e27990000040f000000010020019000001a610000613d000000000101043b000000000001004b0000004e0000613d000000400300043d00000024013000390000001202000029000000000021043500000a3a0100004100000000001304350000000001000411000009ec0110019700000004023000390000000000120435000009e90030009c001200000003001d000009e901000041000000000103401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a3b011001c70000000902000029279e27940000040f0000000100200190000019e30000613d000000120100002900000a2d0010009c000010d10000213d0000001201000029000000400010043f0000000201000039000000000301041a000000000003004b000019f00000c13d000000400100043d00001a260000013d000000240030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000401100370000000000101043b000009ec0010009c0000004e0000213d279e22400000040f000000400200043d0000000000120435000009e90020009c000009e902008041000000400120021000000a40011001c70000279f0001042e000000840030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000202043b001200000002001d000009ec0020009c0000004e0000213d0000006402100370000000000202043b001100000002001d000009ec0020009c0000004e0000213d0000002402100370000000000202043b0000004401100370000000000301043b000000110000006b00000de40000613d000e00000003001d001000000002001d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000101100039000000000101041a000009ec00100198000007a10000613d000000100000006b00000e330000613d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000400200043d000f00000002001d00000a2f0020009c000010d10000213d000000000101043b0000000f05000029000000e002500039000000400020043f000000000201041a000000c00320027000000a300330019700000060045000390000000000340435000000a0032002700000ffff0330018f00000020045000390000000000340435000009ec032001970000000000350435000000b0022002700000ffff0220018f0000004003500039000800000003001d00000000002304350000000102100039000000000202041a000009ec0220019700000080035000390000000000230435000000a0025000390000000203100039000000000303041a00000000003204350000000301100039000000000401041a00000a2d0040009c000010d10000213d00000005024002100000003f0220003900000a3102200197000000400300043d0000000002230019000700000003001d000000000032004b0000000003000039000000010300403900000a2d0020009c000010d10000213d0000000100300190000010d10000c13d000000400020043f0000000702000029000d00000004001d0000000002420436000900000002001d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d0000000d08000029000000000008004b00000d090000613d000000000101043b00000000020000190000000703000029000000400400043d00000a330040009c000010d10000213d0000004005400039000000400050043f0000002005400039000000000601041a0000008007600270000000000075043500000a340560019700000000005404350000002003300039000000000043043500000001011000390000000102200039000000000082004b00000cf80000413d0000000f01000029000000c0011000390000000702000029000000000021043500000a3501000041000000400200043d000f00000002001d0000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000001202000029279e27990000040f0000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000f0b0000290000000f0570002900000d2d0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00000d290000c13d000000000006004b00000d3a0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000012640000613d0000001f01400039000000600110018f0000000002b10019000000000012004b00000000010000390000000101004039000c00000002001d00000a2d0020009c000010d10000213d0000000100100190000010d10000c13d0000000c01000029000000400010043f000000200030008c0000004e0000413d00000000020b0433000d00000002001d000000100020006b000015730000a13d00000a48010000410000000c020000290000103e0000013d000000440030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000302043b000009ec0030009c0000004e0000213d0000002401100370000000000101043b001200000001001d000009ec0010009c0000004e0000213d001000000003001d000000000030043f0000000401000039000000200010043f00000040020000390000000001000019279e277f0000040f0000001202000029000000000020043f000000200010043f00000000010000190000004002000039279e277f0000040f000000000101041a001100000001001d0000001001000029000000000010043f0000000501000039000000200010043f00000000010000190000004002000039279e277f0000040f0000001202000029000000000020043f000000200010043f00000000010000190000004002000039279e277f0000040f000000000101041a0000001102000029000000800020043f000000a00010043f00000a4a010000410000279f0001042e000000440030008c0000004e0000413d0000000402100370000000000202043b001200000002001d00000a2d0020009c0000004e0000213d000000120230006a00000a520020009c0000004e0000213d000000640020008c0000004e0000413d0000002402100370000000000202043b00000a2d0020009c0000004e0000213d000000000423004900000a520040009c0000004e0000213d000000c40040008c0000004e0000413d0000000204000039000000000404041a0000000005000416000000000045004b00000e190000c13d0000001204000029001100040040003d0000001104100360000000000604043b000000110430006a0000001f0440008a00000a4f0540019700000a4f07600197000000000857013f000000000057004b000000000700001900000a4f07004041000000000046004b000000000900001900000a4f0900804100000a4f0080009c000000000709c019000000000007004b0000004e0000c13d0000001107600029000000000671034f000000000606043b00000a2d0060009c0000004e0000213d00000000086300490000002007700039000000000087004b000000000900001900000a4f0900204100000a4f0880019700000a4f07700197000000000a87013f000000000087004b000000000700001900000a4f0700404100000a4f00a0009c000000000709c019000000000007004b0000004e0000c13d000000000006004b000011760000c13d00000a5901000041000000800010043f0000002001000039000000840010043f0000000401000039000000a40010043f00000a7201000041000000c40010043f00000a5b01000041000027a000010430000000840030008c0000004e0000413d0000000002000416000000000002004b0000004e0000c13d0000000402100370000000000202043b001200000002001d000009ec0020009c0000004e0000213d0000006402100370000000000202043b001100000002001d000009ec0020009c0000004e0000213d0000002402100370000000000202043b0000004401100370000000000301043b000000110000006b00000ea30000c13d00000a6a01000041000000800010043f00000a6b01000041000027a00001043000000a4101000041000000800010043f000000840020043f00000a4201000041000027a00001043000000a7501000041000000800010043f00000a6b01000041000027a00001043000000a4101000041000000800010043f000000840050043f00000a4201000041000027a0000104300000001204000029000000000004004b00000e000000c13d000000400100043d0000004402100039000009f50300004100000000003204350000002402100039000000180300003900000e260000013d000000000005004b00000e1d0000c13d000000400100043d0000004402100039000009f40300004100000000003204350000002402100039000000130300003900000e260000013d0000000302000039000000000012041b000000800010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a60011001c70000800d02000039000000010300003900000a6104000041279e27940000040f00000001002001900000004e0000613d00000000010000190000279f0001042e00000a6e01000041000000800010043f00000a6b01000041000027a0000104300000000d01000029000000000001004b00000f7a0000c13d000000400100043d0000004402100039000009f1030000410000000000320435000000240210003900000008030000390000000000320435000009f2020000410000000000210435000000040210003900000020030000390000000000320435000009e90010009c000009e9010080410000004001100210000009f3011001c7000027a000010430000000110000006b00000f910000c13d000000400100043d00000a680200004100000f8b0000013d000009ed01100197000000000161019f000000000010041b0000000001000414000009e90010009c000009e901008041000000c001100210000009ee011001c70000800d020000390000000303000039000009ef0400004100000e140000013d00000080040000390000000001000019001200000001001d00000005021002100000003f0120003900000a2e03100197000c00000004001d0000000001430019000000000031004b0000000003000039000000010300403900000a2d0010009c000010d10000213d0000000100300190000010d10000c13d000000400010043f00000012010000290000000c060000290000000001160436000b00000001001d0000001f0120018f000000000002004b00000e610000613d0000000b04000029000000000224001900000000030000310000000103300367000000003503043c0000000004540436000000000024004b00000e5d0000c13d000000000001004b0000000e010000290000000f0010006c00000e9e0000813d000d00000000001d00000e6c0000013d0000000e010000290000000c0600002900000001011000390000000f0010006c00000e9e0000813d000e00000001001d0000000701000039000000000101041a0000000e0010006c0000156d0000a13d0000000e0100002900000a2b0110009a001100000001001d000000000101041a000009ec01100197000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000101100039000000000101041a000000100110014f000009ec0010019800000e670000c13d0000000701000039000000000101041a0000000e0010006c0000000c060000290000156d0000a13d0000000701000039000000000010043f00000000010604330000000d0010006c0000156d0000a13d0000000d0300002900000005013002100000000b011000290000001102000029000000000202041a000009ec0220019700000000002104350000000103300039000d00000003001d000000120030006c0000000e0100002900000e690000c13d000000400100043d001200000001001d0000000002060019279e1abb0000040f000009090000013d000f00000003001d001000000002001d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000101100039000000000101041a000009ec00100198000007a10000613d000000100000006b00000e330000613d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000400200043d000e00000002001d00000a2f0020009c000010d10000213d000000000101043b0000000e05000029000000e002500039000000400020043f000000000201041a000000c00320027000000a300330019700000060045000390000000000340435000000b0032002700000ffff0330018f00000040045000390000000000340435000009ec032001970000000003350436000000a0022002700000ffff0220018f000a00000003001d00000000002304350000000102100039000000000202041a000009ec0220019700000080035000390000000000230435000000a0025000390000000203100039000000000303041a00000000003204350000000301100039000000000401041a00000a2d0040009c000010d10000213d00000005024002100000003f0220003900000a3102200197000000400300043d0000000002230019000900000003001d000000000032004b0000000003000039000000010300403900000a2d0020009c000010d10000213d0000000100300190000010d10000c13d000000400020043f0000000902000029000d00000004001d0000000002420436000800000002001d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d0000000d08000029000000000008004b00000f1d0000613d000000000101043b00000000020000190000000903000029000000400400043d00000a330040009c000010d10000213d0000004005400039000000400050043f0000002005400039000000000601041a0000008007600270000000000075043500000a340560019700000000005404350000002003300039000000000043043500000001011000390000000102200039000000000082004b00000f0c0000413d0000000e01000029000000c0011000390000000902000029000000000021043500000a3501000041000000400200043d000e00000002001d0000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000001202000029279e27990000040f0000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000e0b0000290000000e0570002900000f410000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00000f3d0000c13d000000000006004b00000f4e0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000012700000613d0000001f01400039000000600210018f0000000001b20019000000000021004b0000000002000039000000010200403900000a2d0010009c000010d10000213d0000000100200190000010d10000c13d000000400010043f000000200030008c0000004e0000413d00000000020b0433000c00000002001d000000100020002a00000f740000413d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000301100039000000000201041a000e00000002001d000000000002004b000015f70000c13d00000a6601000041000000000010043f0000001101000039000000040010043f000009f801000041000027a000010430000000a00030043f000000c00040043f000000800010043f0000014000000443000001600010044300000020010000390000018000100443000001a0003004430000004002000039000001c000200443000001e00040044300000100001004430000012000600443000009f0010000410000279f0001042e000000400100043d00000a5d020000410000000000210435000009e90010009c000009e901008041000000400110021000000a36011001c7000027a0000104300000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000400200043d001000000002001d00000a2f0020009c000010d10000213d000000000101043b0000001005000029000000e002500039000000400020043f000000000201041a000000c00320027000000a300330019700000060045000390000000000340435000000a0032002700000ffff0330018f00000020045000390000000000340435000009ec032001970000000000350435000000b0022002700000ffff0220018f0000004003500039000b00000003001d00000000002304350000000102100039000000000202041a000009ec0220019700000080035000390000000000230435000000a0025000390000000203100039000000000303041a00000000003204350000000301100039000000000401041a00000a2d0040009c000010d10000213d00000005024002100000003f0220003900000a3102200197000000400300043d0000000002230019000a00000003001d000000000032004b0000000003000039000000010300403900000a2d0020009c000010d10000213d0000000100300190000010d10000c13d000000400020043f0000000a02000029000f00000004001d0000000002420436000d00000002001d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d0000000f08000029000000000008004b00000ff60000613d000000000101043b00000000020000190000000a03000029000000400400043d00000a330040009c000010d10000213d0000004005400039000000400050043f0000002005400039000000000601041a0000008007600270000000000075043500000a340560019700000000005404350000002003300039000000000043043500000001011000390000000102200039000000000082004b00000fe50000413d0000001001000029000000c0011000390000000a02000029000000000021043500000a3501000041000000400200043d001000000002001d0000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000001202000029279e27990000040f0000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000100b00002900000010057000290000101a0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000010160000c13d000000000006004b000010270000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000011b20000613d0000001f01400039000000600110018f0000000002b10019000000000012004b00000000010000390000000101004039000f00000002001d00000a2d0020009c000010d10000213d0000000100100190000010d10000c13d0000000f01000029000000400010043f000000200030008c0000004e0000413d00000000020b0433001000000002001d000000110020006b0000127c0000a13d00000a48010000410000000f020000290000000000120435000009e90020009c000009e902008041000000400120021000000a36011001c7000027a000010430001100000001001d0000000001000411000000000010043f0000000401000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000001202000029000000000020043f000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b000000000001041b0000000001000411000000000010043f0000000501000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000001202000029000000000020043f000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b000000000201041a000000110020002a00000f740000413d00000011040000290000000002420019000000000021041b000000400200043d000000200120003900000a44030000410000000000310435000000440120003900000000004104350000000001000411000009ec01100197000000240320003900000000001304350000004401000039000000000012043500000a450020009c000010d10000213d0000008001200039000000400010043f0000001201000029279e209e0000040f000000400100043d00000020021000390000001103000029000000000032043500000012020000290000000000210435000009e90010009c000009e90100804100000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a2c011001c70000800d02000039000000020300003900000a4604000041000000000500041100000e140000013d00000a4b0040009c000010d10000213d00000060030000390000000004000019000001c005200039000000400050043f00000180052000390000000000350435000001600520003900000000003504350000008005200039000000000035043500000060052000390000000000350435000001a0052000390000000000050435000001400520003900000000000504350000012005200039000000000005043500000100052000390000000000050435000000e0052000390000000000050435000000c0052000390000000000050435000000a005200039000000000005043500000040052000390000000000050435000000200520003900000000000504350000000000020435000000a00540003900000000002504350000002004400039000000000014004b0000018c0000813d000000400200043d00000a4c0020009c000010ac0000a13d00000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a000010430000009ed02200197000000000262019f000000000021041b0000000001000414000009e90010009c000009e901008041000000c001100210000009ee011001c70000800d02000039000000030300003900000a5e04000041000000120500002900000e140000013d000000a005000039000001c0060000390000000008000019000010f40000013d000000000cab001900000000000c0435000001a004400039000001a009900039000000000909043300000000009404350000001f04b0003900000a76044001970000000004a400190000000108800039000000000028004b000005960000813d0000000009140049000000400990008a0000000003930436000000005905043400000000ba090434000009ec0aa00197000000000aa40436000000000b0b0433000009ec0bb001970000000000ba0435000000400a900039000000000a0a0433000000ff0aa0018f000000400b4000390000000000ab0435000000600a900039000000000a0a0433000000600b40003900000000006b0435000001c00b40003900000000ca0a04340000000000ab0435000001e00b40003900000000000a004b000011150000613d000000000d000019000000000ebd0019000000000fdc0019000000000f0f04330000000000fe0435000000200dd000390000000000ad004b0000110e0000413d000000000cba001900000000000c04350000001f0aa0003900000a760aa00197000000000aba0019000000800b900039000000000b0b0433000000000c4a0049000000800d4000390000000000cd043500000000cb0b0434000000000aba043600000000000b004b0000112b0000613d000000000d000019000000000ead0019000000000fdc0019000000000f0f04330000000000fe0435000000200dd000390000000000bd004b000011240000413d000000000cab001900000000000c0435000000a00c900039000000000c0c043300000a300cc00197000000a00d4000390000000000cd0435000000c00c900039000000000c0c043300000a340cc00197000000c00d4000390000000000cd0435000000e00c900039000000000c0c043300000a340cc00197000000e00d4000390000000000cd0435000001000c900039000000000c0c043300000a340cc00197000001000d4000390000000000cd0435000001200c900039000000000c0c0433000009ec0cc00197000001200d4000390000000000cd0435000001400c900039000000000c0c0433000000ff0cc0018f000001400d4000390000000000cd04350000001f0bb0003900000a760bb00197000000000aab0019000000000b4a0049000001600c400039000001600d900039000000000d0d04330000000000bc043500000000cb0d0434000000000aba043600000000000b004b0000115f0000613d000000000d000019000000000ead0019000000000fdc0019000000000f0f04330000000000fe0435000000200dd000390000000000bd004b000011580000413d000000000cab001900000000000c04350000001f0bb0003900000a760bb00197000000000aab0019000001800b900039000000000b0b0433000000000c4a0049000001800d4000390000000000cd043500000000cb0b0434000000000aba043600000000000b004b000010e80000613d000000000d000019000000000ead0019000000000fdc0019000000000f0f04330000000000fe0435000000200dd000390000000000bd004b0000116e0000413d000010e80000013d0000001106000029001000200060003d0000001006100360000000000606043b00000a4f07600197000000000857013f000000000057004b000000000700001900000a4f07004041000000000046004b000000000900001900000a4f0900804100000a4f0080009c000000000709c019000000000007004b0000004e0000c13d0000001107600029000000000671034f000000000606043b00000a2d0060009c0000004e0000213d00000000086300490000002007700039000000000087004b000000000900001900000a4f0900204100000a4f0880019700000a4f07700197000000000a87013f000000000087004b000000000700001900000a4f0700404100000a4f00a0009c000000000709c019000000000007004b0000004e0000c13d000000000006004b000011be0000c13d00000a5901000041000000800010043f0000002001000039000000840010043f0000000601000039000000a40010043f00000a7101000041000000c40010043f00000a5b01000041000027a0000104300000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000011ad0000c13d000016660000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000011b90000c13d000016660000013d0000001006000029000f00200060003d0000000f06100360000000000606043b00000a4f07600197000000000857013f000000000057004b000000000500001900000a4f05004041000000000046004b000000000400001900000a4f0400804100000a4f0080009c000000000504c019000000000005004b0000004e0000c13d0000001104600029000000000141034f000000000101043b00000a2d0010009c0000004e0000213d00000000031300490000002004400039000000000034004b000000000500001900000a4f0500204100000a4f0330019700000a4f04400197000000000634013f000000000034004b000000000300001900000a4f0300404100000a4f0060009c000000000305c019000000000003004b0000004e0000c13d000000000001004b000012c70000c13d00000a5901000041000000800010043f0000002001000039000000840010043f0000000301000039000000a40010043f00000a5a01000041000000c40010043f00000a5b01000041000027a0000104300000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000011f50000c13d000016660000013d000000400200043d0000000006520019000000000005004b000012560000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b000012000000c13d000012560000013d000000400200043d0000000006520019000000000005004b000012560000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b0000120b0000c13d000012560000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000012170000c13d000016660000013d00000024021000390000000303000029000000000032043500000a51020000410000000000210435000000040210003900000080030000390000000000320435000009e90010009c000009e901008041000000400110021000000a3b011001c7000027a0000104300000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000012300000c13d000016660000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000123c0000c13d000016660000013d000000400200043d0000000006520019000000000005004b000012560000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b000012470000c13d000012560000013d000000400200043d0000000006520019000000000005004b000012560000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b000012520000c13d000000000004004b000016730000613d000000000151034f0000000304400210000000000506043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000160435000016730000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000126b0000c13d000016660000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000012770000c13d000016660000013d00000a37010000410000000f020000290000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000001202000029279e27990000040f0000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000f057000290000129a0000613d000000000801034f0000000f09000029000000008a08043c0000000009a90436000000000059004b000012960000c13d000000000006004b000012a70000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000012bb0000613d0000001f01400039000000600110018f0000000f0110002900000a2d0010009c000010d10000213d000000400010043f000000200030008c0000004e0000413d0000000f010000290000000001010433000000ff0010008c0000004e0000213d0000004d0010008c00000f740000213d000000000001004b000016790000c13d0000000104000039000016820000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000012c20000c13d000016660000013d0000000401200039279e1bb00000040f00000001020003670000001001200360000000000301043b0000000001000031000000120410006a000000230440008a00000a4f0540019700000a4f06300197000000000756013f000000000056004b000000000500001900000a4f05004041000000000043004b000000000400001900000a4f0400804100000a4f0070009c000000000504c019000000000005004b0000004e0000c13d0000001103300029000000000232034f000000000202043b000e00000002001d00000a2d0020009c0000004e0000213d0000000e0110006a000000200530003900000a4f0210019700000a4f03500197000000000423013f000000000023004b000000000200001900000a4f02004041000d00000005001d000000000015004b000000000100001900000a4f0100204100000a4f0040009c000000000201c019000000000002004b0000004e0000c13d00000a5301000041000000000010044300000000010004120000000400100443000000400100003900000024001004430000000001000414000009e90010009c000009e901008041000000c00110021000000a54011001c70000800502000039279e27990000040f000000010020019000001a610000613d000000000101043b0000000d020000290000000e03000029279e1fa90000040f00000001030003670000001102300360000000000602043b0000000002000031000000110420006a0000001f0440008a00000a4f0540019700000a4f07600197000000000857013f000000000057004b000000000700001900000a4f07004041000000000046004b000000000900001900000a4f0900804100000a4f0080009c000000000709c019000e00000001001d000000000007004b0000004e0000c13d0000001101600029000000000613034f000000000606043b000d00000006001d00000a2d0060009c0000004e0000213d0000000d0620006a000000200910003900000a4f0160019700000a4f07900197000000000817013f000000000017004b000000000100001900000a4f01004041000c00000009001d000000000069004b000000000600001900000a4f0600204100000a4f0080009c000000000106c019000000000001004b0000004e0000c13d0000001001300360000000000101043b00000a4f06100197000000000756013f000000000056004b000000000600001900000a4f06004041000000000041004b000000000800001900000a4f0800804100000a4f0070009c000000000608c019000000000006004b0000004e0000c13d0000001101100029000000000613034f000000000606043b000b00000006001d00000a2d0060009c0000004e0000213d0000000b0620006a000000200910003900000a4f0160019700000a4f07900197000000000817013f000000000017004b000000000100001900000a4f01004041000a00000009001d000000000069004b000000000600001900000a4f0600204100000a4f0080009c000000000106c019000000000001004b0000004e0000c13d0000000f01300360000000000101043b00000a4f06100197000000000756013f000000000056004b000000000500001900000a4f05004041000000000041004b000000000400001900000a4f0400804100000a4f0070009c000000000504c019000000000005004b0000004e0000c13d0000001101100029000000000313034f000000000303043b000900000003001d00000a2d0030009c0000004e0000213d000000090220006a000000200510003900000a4f0120019700000a4f03500197000000000413013f000000000013004b000000000100001900000a4f01004041000800000005001d000000000025004b000000000200001900000a4f0200204100000a4f0040009c000000000102c019000000000001004b0000004e0000c13d00000a380100004100000000001004430000000e01000029000009ec01100197000700000001001d00000004001004430000000001000414000009e90010009c000009e901008041000000c00110021000000a39011001c70000800202000039279e27990000040f000000010020019000001a610000613d000000000101043b000000000001004b0000004e0000613d000000400400043d00000a5501000041000000000014043500000064014000390000000d03000029000000000031043500000004014000390000006002000039000000000021043500000a76053001980000001f0630018f000600000004001d0000008403400039000000000453001900000001020003670000000c07200360000013a00000613d000000000807034f0000000009030019000000008a08043c0000000009a90436000000000049004b0000139c0000c13d000000000006004b000013ad0000613d000000000557034f0000000306600210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f00000000005404350000000d05000029000000000453001900000000000404350000001f0450003900000a7604400197000000000343001900000000041300490000000605000029000000240550003900000000004504350000000a052003600000000b04000029000000000343043600000a76064001980000001f0740018f0000000004630019000013c40000613d000000000805034f0000000009030019000000008a08043c0000000009a90436000000000049004b000013c00000c13d000000000007004b000013d10000613d000000000565034f0000000306700210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f00000000005404350000000b05000029000000000453001900000000000404350000001f0450003900000a76044001970000000004430019000000000114004900000006030000290000004403300039000000000013043500000008032003600000000902000029000000000124043600000a76042001980000001f0520018f0000000002410019000013e80000613d000000000603034f0000000007010019000000006806043c0000000007870436000000000027004b000013e40000c13d000000000005004b000013f50000613d000000000343034f0000000304500210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f000000000032043500000009040000290000001f0240003900000a760220019700000000034100190000000000030435000000060300002900000000023200490000000001120019000009e90010009c000009e9010080410000006001100210000009e90030009c000009e90200004100000000020340190000004002200210000000000121019f0000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f0000000702000029279e27940000040f0000000100200190000019b40000613d000000060100002900000a2d0010009c000010d10000213d0000000601000029000000400010043f0000000702000039000000000102041a00000a2d0010009c000010d10000213d0000000103100039000000000032041b000000000020043f00000a2b0110009a000000000201041a000009ed0220019700000007022001af000000000021041b00000024010000390000000101100367000000000101043b00000004021000390000000e01000029279e1dee0000040f00000001010003670000001102100360000000000302043b0000000005000031000000120250006a000000230220008a00000a4f0620019700000a4f04300197000000000764013f000000000064004b000000000400001900000a4f04004041000000000023004b000000000800001900000a4f0800804100000a4f0070009c000000000408c019000000000004004b0000004e0000c13d0000001103300029000000000431034f000000000404043b00000a2d0040009c0000004e0000213d0000000007450049000000200930003900000a4f0370019700000a4f08900197000000000a38013f000000000038004b000000000300001900000a4f03004041000000000079004b000000000700001900000a4f0700204100000a4f00a0009c000000000307c019000000000003004b0000004e0000c13d0000001003100360000000000303043b00000a4f07300197000000000867013f000000000067004b000000000700001900000a4f07004041000000000023004b000000000a00001900000a4f0a00804100000a4f0080009c00000000070ac019000000000007004b0000004e0000c13d0000001107300029000000000371034f000000000303043b00000a2d0030009c0000004e0000213d000000000a350049000000200870003900000a4f07a0019700000a4f0b800197000000000c7b013f00000000007b004b000000000700001900000a4f070040410000000000a8004b000000000a00001900000a4f0a00204100000a4f00c0009c00000000070ac019000000000007004b0000004e0000c13d0000000f07100360000000000707043b00000a4f0a700197000000000b6a013f00000000006a004b000000000600001900000a4f06004041000000000027004b000000000200001900000a4f0200804100000a4f00b0009c000000000602c019000000000006004b0000004e0000c13d0000001106700029000000000261034f000000000202043b00000a2d0020009c0000004e0000213d0000000005250049000000200660003900000a4f0750019700000a4f0a600197000000000b7a013f00000000007a004b000000000700001900000a4f07004041001100000006001d000000000056004b000000000500001900000a4f0500204100000a4f00b0009c000000000705c019000000000007004b0000004e0000c13d0000002405100370000000000505043b0000004405500039000000000551034f000000000505043b001200000005001d000009ec0050009c0000004e0000213d000000000c91034f000000400500043d000000600600003900000000096504360000006007500039000000000047043500000a760d4001980000001f0e40018f0000008007500039000000000bd70019000014aa0000613d000000000f0c034f000000000a07001900000000f60f043c000000000a6a04360000000000ba004b000014a60000c13d00000000000e004b000014b70000613d0000000006dc034f000000030ae00210000000000c0b0433000000000cac01cf000000000cac022f000000000606043b000001000aa000890000000006a6022f0000000006a601cf0000000006c6019f00000000006b0435000000000647001900000000000604350000001f0440003900000a7604400197000000000447001900000000065400490000000000690435000000000981034f000000000434043600000a760a3001980000001f0b30018f0000000008a40019000014ca0000613d000000000c09034f000000000704001900000000c60c043c0000000007670436000000000087004b000014c60000c13d00000000000b004b000014d70000613d0000000006a9034f0000000307b00210000000000908043300000000097901cf000000000979022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000696019f0000000000680435000000000634001900000000000604350000001f0330003900000a760330019700000000033400190000000004530049000000400650003900000000004604350000001104100360000000000123043600000a76072001980000001f0820018f0000000003710019000014eb0000613d000000000904034f0000000006010019000000009a09043c0000000006a60436000000000036004b000014e70000c13d000000000008004b000014f80000613d000000000474034f0000000306800210000000000703043300000000076701cf000000000767022f000000000404043b0000010006600089000000000464022f00000000046401cf000000000474019f00000000004304350000001f0320003900000a76033001970000000002210019000000000002043500000000025300490000000001120019000009e90010009c000009e9010080410000006001100210000009e90050009c000009e9050080410000004002500210000000000121019f0000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f000009ee011001c70000800d02000039000000030300003900000a560400004100000007050000290000001206000029279e27940000040f00000001002001900000004e0000613d00000001010003670000002402100370000000000602043b000000a404600039000000000241034f000000000702043b00000000020000310000000003620049000000230330008a00000a4f0530019700000a4f08700197000000000958013f000000000058004b000000000800001900000a4f08004041000000000037004b000000000a00001900000a4f0a00804100000a4f0090009c00000000080ac019000000000008004b0000004e0000c13d00000004066000390000000008670019000000000781034f000000000707043b00000a2d0070009c0000004e0000213d00000005097002100000000009920049000000200880003900000a4f0a90019700000a4f0b800197000000000cab013f0000000000ab004b000000000a00001900000a4f0a004041000000000098004b000000000900001900000a4f0900204100000a4f00c0009c000000000a09c01900000000000a004b0000004e0000c13d000000000007004b0000156d0000613d000000000781034f000000000707043b00000a340070009c0000004e0000213d000000000007004b00001a5b0000c13d000000200440008a000000000441034f000000000404043b00000a4f07400197000000000857013f000000000057004b000000000500001900000a4f05004041000000000034004b000000000300001900000a4f0300804100000a4f0080009c000000000503c019000000000005004b0000004e0000c13d0000000004640019000000000341034f000000000303043b00000a2d0030009c0000004e0000213d00000005053002100000000005520049000000200240003900000a4f0450019700000a4f06200197000000000746013f000000000046004b000000000400001900000a4f04004041000000000052004b000000000500001900000a4f0500204100000a4f0070009c000000000405c019000000000004004b0000004e0000c13d000000000003004b00001a280000c13d00000a6601000041000000000010043f0000003201000039000000040010043f000009f801000041000027a00001043000000a37010000410000000c020000290000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000001202000029279e27990000040f0000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000c05700029000015910000613d000000000801034f0000000c09000029000000008a08043c0000000009a90436000000000059004b0000158d0000c13d000000000006004b0000159e0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000164f0000613d0000001f01400039000000600110018f0000000c0110002900000a2d0010009c000010d10000213d000000400010043f000000200030008c0000004e0000413d0000000c010000290000000001010433000000ff0010008c0000004e0000213d0000004e0010008c00000f740000813d000000000001004b000016c10000c13d0000000104000039000016ca0000013d000000400200043d000f00000002001d00000a37010000410000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000001202000029279e27990000040f0000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000f0b0000290000000f05700029000015d20000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000015ce0000c13d000000000006004b000015df0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000165b0000613d0000001f01400039000000600210018f0000000001b20019000000000021004b0000000002000039000000010200403900000a2d0010009c000010d10000213d0000000100200190000010d10000c13d000000400010043f000000200030008c0000004e0000413d00000000010b0433000000ff0010008c0000004e0000213d0000004d0010008c00000f740000213d000000000001004b000016fa0000c13d0000000104000039000017030000013d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d0000000c030000290000001002300029000000000101043b0000000e01100029000000010110008a000000000101041a00000a3401100197000000000012004b0000069f0000213d000000400200043d000e00000002001d00000a37010000410000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000001202000029279e27990000040f0000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000e0b0000290000000e057000290000162a0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000016260000c13d000000000006004b000016370000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000016990000613d0000001f01400039000000600210018f0000000001b20019000000000021004b0000000002000039000000010200403900000a2d0010009c000010d10000213d0000000100200190000010d10000c13d000000400010043f000000200030008c0000004e0000413d00000000010b0433000000ff0010008c0000004e0000213d0000004d0010008c00000f740000213d000000000001004b000017760000c13d00000001040000390000177f0000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000016560000c13d000016660000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000016620000c13d000000000005004b000016730000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000009e90020009c000009e9020080410000004002200210000000000112019f000027a0000104300000000a020000390000000104000039000000010010019000000000032200a9000000010200603900000000044200a9000000010110027200000000020300190000167b0000c13d000c00000004001d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000302100039000000000102041a000f00000001001d000000000001004b000016a50000c13d000000400100043d00000a670200004100000f8b0000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000016660000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000016a00000c13d000016660000013d0000000007000019000e00000002001d000000000102041a000000000071004b0000156d0000a13d001200000007001d000000000020043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b00000012070000290000000001710019000000000101041a00000a3401100197000000100010006c000017340000813d00000001077000390000000f0070006c0000000e02000029000016a70000413d000016960000013d0000000a020000390000000104000039000000010010019000000000032200a9000000010200603900000000044200a900000001011002720000000002030019000016c30000c13d000a00000004001d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000302100039000000000102041a000c00000001001d000000000001004b000016960000613d0000000003000019000b00000002001d000000000102041a000f00000003001d000000000031004b0000156d0000a13d000000000020043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000f030000290000000001310019000000000101041a00000a34011001970000000d0010006c000017b00000813d00000001033000390000000c0030006c0000000b02000029000016e00000413d000016960000013d0000000a020000390000000104000039000000010010019000000000032200a9000000010200603900000000044200a900000001011002720000000002030019000016fc0000c13d000a00000004001d0000001201000029000009ec01100197000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000301100039000f00000001001d000000000101041a000e00000001001d000000000001004b000016960000613d00000000030000190000000f02000029000000000102041a001200000003001d000000000031004b0000156d0000a13d000000000020043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b00000012030000290000000001310019000000000101041a00000a3401100197000000100010006c000017f40000813d00000001033000390000000e0030006c0000171a0000413d000016960000013d0000000a0100002900000000020104330000000001000019000000000007004b0000001003000029000017440000613d000000010370008a000000000032004b0000156d0000a13d00000005033002100000000d033000290000000003030433000000000303043300000a3403300197000000100330006b00000f740000413d000000110030006b0000001103004029000000000072004b0000156d0000a13d00000005047002100000000d0440002900000000040404330000002004400039000000000404043300000a340540019700000000043500a9000000000003004b000017540000613d00000000063400d9000000000056004b00000f740000c13d0000000c05000029000000000005004b000019c90000613d00000000045400d9000000000014001a00000f740000413d001000100030007300000f740000413d0000000001140019000000000007004b000000010770c08a0011001100300073000017370000c13d0000000b0200002900000000020204330000ffff0320018f00000000021300a9000000000001004b0000176a0000613d00000000041200d9000000000034004b00000f740000c13d000027100220011a000000000121004b00000f740000413d000000400300043d000000200430003900000000002404350000000000130435000009e90030009c000009e903008041000000400130021000000a47011001c70000279f0001042e0000000a020000390000000104000039000000010010019000000000032200a9000000010200603900000000044200a900000001011002720000000002030019000017780000c13d000700000004001d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000301100039000d00000001001d000000000101041a000b00000001001d000000000001004b000016960000613d000e00000000001d0000000d01000029000000000101041a0000000e0010006c0000156d0000a13d0000000d01000029000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000e01100029000000000101041a00000a34011001970000000c0010006c0000183b0000813d0000000e010000290000000101100039000e00000001001d0000000b0010006c000017950000413d000016960000013d000000070100002900000000010104330000001002000029000c00000000001d0000000f0000006b0000000d03000029000017c20000613d0000000f03000029000000010330008a000000000031004b0000156d0000a13d000000050330021000000009033000290000000003030433000000000303043300000a34033001970000000d0330006b00000f740000413d000000000032004b00000000030240190000000f0010006c0000156d0000a13d0000000f040000290000000504400210000000090440002900000000040404330000002004400039000000000404043300000a340540019700000000043500a9000000000003004b000017d30000613d00000000063400d9000000000056004b00000f740000c13d0000000a0000006b000019c90000613d0000000a044000fa0000000c0040002a00000f740000413d000d000d0030007300000f740000413d000c000c0040002d0000000f04000029000000010440008c0000000004004019000f00000004001d000000000232004b000017b40000c13d000000080100002900000000010104330000ffff0210018f0000000c012000b90000000c0000006b000017ea0000613d0000000c031000fa000000000023004b00000f740000c13d000027100210011a000d00000002001d000f000c0020007300000f740000413d0000000f020000290000000e0020006c000018800000813d000000400100043d00000a650200004100000f8b0000013d0000000c010000290000000002010433000000000023004b00000e330000813d0000000001000019000017fe0000013d0000001203000029001200010030003d000000120020006b000018700000813d000000120300002900000005033002100000000b033000290000000003030433000000005303043400000a3403300197000000100630006c00000f740000413d000000110460006b000018670000a13d000000100030006c000017fa0000613d000000000505043300000a340750019700000000056700a900000000066500d9000000000076004b00000f740000c13d0000000a0000006b000019c90000613d000000000005004b000018180000613d000000010550008a0000000a055000fa0000000105500039000018190000013d0000000005000019000000000015001a00000f740000413d0000000001150019001100000004001d001000000003001d000017fa0000013d00000060061002700000001f0460018f000009eb05600198000000400200043d00000000035200190000182b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000018270000c13d000009e906600197000000000004004b000018390000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000006001600210000016740000013d000000090100002900000000010104330000000e0010006b00000e330000813d0000001002000029000d00000000001d000018460000013d0000000e03000029000e00010030003d0000000e0010006b0000191c0000813d0000000e03000029000000050330021000000008033000290000000003030433000000005303043400000a34033001970000000c0630006c00000f740000413d000000000462004b000019130000a13d0000000c0030006c000018420000613d000000000205043300000a340520019700000000026500a900000000066200d9000000000056004b00000f740000c13d000000070000006b000019c90000613d000000000002004b000018600000613d000000010220008a00000007022000fa0000000102200039000018610000013d00000000020000190000000d0020002a00000f740000413d000d000d0020002d0000000002040019000c00000003001d000018420000013d000000110000006b000019040000c13d0000000a0000006b0000000003000019000019c90000613d000000000013001a00000f740000413d0000000001130019001100000000001d000000000001004b00000e330000613d000000110000006b00000e330000c13d0000000d0200002900000000020204330000ffff0320018f00000000021300a900000000041200d9000000000034004b00000f740000c13d000027100220011a000000000012001a00000f740000413d00000000011200190000176d0000013d0000001201000029000009ec01100197001200000001001d000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b000e00000001001d00000a38010000410000000000100443000000120100002900000004001004430000000001000414000009e90010009c000009e901008041000000c00110021000000a39011001c70000800202000039279e27990000040f000000010020019000001a610000613d000000000101043b000000000001004b0000004e0000613d000000400300043d00000024013000390000001002000029000000000021043500000a630100004100000000001304350000000001000411000009ec0110019700000004023000390000000000120435000009e90030009c000b00000003001d000009e901000041000000000103401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a3b011001c70000001202000029279e27940000040f0000000100200190000019cf0000613d0000000b0100002900000a2d0010009c000010d10000213d0000000b01000029000000400010043f0000000e010000290000000201100039000000000201041a0000000c0220006c00000f740000413d000000000021041b0000000e02000029000000000102041a0000000102200039000e00000002001d000000000202041a000009ec01100197000009ec022001970000000d03000029279e27220000040f0000000e01000029000000000101041a00000a4403000041000000400200043d0000002004200039000000000034043500000044032000390000000f040000290000000000430435000000440300003900000000003204350000001103000029000009ec043001970000002403200039001100000004001d000000000043043500000a450020009c000010d10000213d0000008003200039000000400030043f000009ec01100197279e209e0000040f0000000e01000029000000000201041a000000400100043d00000040031000390000000f04000029000000000043043500000020031000390000001004000029000000000043043500000011030000290000000000310435000009e90010009c000009e90100804100000040011002100000000003000414000009e90030009c000009e903008041000000c003300210000000000113019f00000a3e011001c7000009ec072001970000800d02000039000000040300003900000a640400004100000012050000290000000006000411279e27940000040f00000001002001900000004e0000613d000000400100043d0000000f0200002900001ab30000013d000000000205043300000a340320019700000011023000b900000011042000fa000000000034004b00000f740000c13d0000000a0000006b000019c90000613d000000000002004b00000000030000190000186c0000613d000000010220008a0000000a022000fa00000001032000390000186c0000013d000000000002004b000019c10000c13d000000070000006b0000000002000019000019c90000613d0000000d0020002a00000f740000413d000d000d0020002d00000000020000190000000d0000006b00000e330000613d000000000002004b00000e330000c13d0000000a0100002900000000010104330000ffff0210018f0000000d012000b90000000d031000fa000000000023004b00000f740000c13d000027100210011a000e00000002001d0000000d0020002a00000f740000413d0000000e020000290000000d02200029000c00000002001d0000000f0020006c000017f10000213d0000001201000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000004e0000613d000000000101043b0000000e030000290000000c0030006c00000f740000213d0000000205100039000000000305041a0000000d0030002a00000f740000413d0000000104100039000f00000004001d000000000404041a000009ec024001970000000d03300029000000000035041b000000000101041a000009ec01100197000d00000002001d0000000e03000029279e27220000040f00000a38010000410000000000100443000000120100002900000004001004430000000001000414000009e90010009c000009e901008041000000c00110021000000a39011001c70000800202000039279e27990000040f000000010020019000001a610000613d000000000101043b000000000001004b0000004e0000613d000000400300043d00000a3a010000410000000001130436000b00000001001d00000004013000390000001102000029000000000021043500000024023000390000001001000029000a00000002001d0000000000120435000009e90030009c000e00000003001d000009e901000041000000000103401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a3b011001c70000001202000029279e27940000040f000000010020019000001a620000613d0000000e0100002900000a2d0010009c000010d10000213d0000000e03000029000000400030043f00000a3c010000410000000b02000029000000000012043500000000010004110000000a02000029000000000012043500000064013000390000000c0200002900000000002104350000004401300039000000000200041000000000002104350000006401000039000000000013043500000a3d0030009c000010d10000213d0000000e02000029000000a001200039000000400010043f0000000d01000029279e209e0000040f0000000f01000029000000000201041a000000400100043d00000040031000390000000c04000029000000000043043500000020031000390000001004000029000000000043043500000011030000290000000000310435000009e90010009c000009e90100804100000040011002100000000003000414000009e90030009c000009e903008041000000c003300210000000000113019f00000a3e011001c7000009ec072001970000800d02000039000000040300003900000a3f0400004100000012050000290000000006000411279e27940000040f00000001002001900000004e0000613d000000400100043d0000000c0200002900001ab30000013d00000060061002700000001f0460018f000009eb05600198000000400200043d00000000035200190000182b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000019bc0000c13d0000182b0000013d000000000105043300000a340310019700000000012300a900000000022100d9000000000032004b00000f740000c13d000000070000006b000019dc0000c13d00000a6601000041000000000010043f0000001201000039000000040010043f000009f801000041000027a00001043000000060061002700000001f0460018f000009eb05600198000000400200043d00000000035200190000182b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000019d70000c13d0000182b0000013d000000000001004b0000000002000019000019180000613d000000010110008a00000007011000fa0000000102100039000019180000013d00000060061002700000001f0460018f000009eb05600198000000400200043d00000000035200190000182b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b000019eb0000c13d0000182b0000013d0000000101000039000000000101041a0000000002000414000009ec04100197000009e90020009c000009e902008041000000c001200210000009ee011001c700008009020000390000000005000019279e27940000040f0000006003100270000009e90330019800001a230000613d0000001f04300039000009ea044001970000003f0440003900000a5704400197000000400500043d0000000004450019000000000054004b0000000006000039000000010600403900000a2d0040009c000010d10000213d0000000100600190000010d10000c13d000000400040043f0000001f0430018f0000000006350436000009eb05300198000000000356001900001a160000613d000000000701034f000000007807043c0000000006860436000000000036004b00001a120000c13d000000000004004b00001a230000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000000400100043d000000010020019000001ab90000613d000000090200002900001ab30000013d000000000121034f000000000101043b001200000001001d00000a340010009c0000004e0000213d00000a38010000410000000000100443000000070100002900000004001004430000000001000414000009e90010009c000009e901008041000000c00110021000000a39011001c70000800202000039279e27990000040f000000010020019000001a610000613d000000000101043b000000000001004b0000004e0000613d000000400300043d00000024013000390000001202000029000000000021043500000a3a0100004100000000001304350000000001000411000009ec0110019700000004023000390000000000120435000009e90030009c001200000003001d000009e901000041000000000103401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a3b011001c70000000702000029279e27940000040f000000010020019000001a6f0000613d000000120100002900000a2d0010009c000010d10000213d0000001201000029000000400010043f0000000201000039000000000301041a000000000003004b00001a7c0000c13d000000400100043d00001ab20000013d000000000001042f00000060061002700000001f0460018f000009eb05600198000000400200043d00000000035200190000182b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b00001a6a0000c13d0000182b0000013d00000060061002700000001f0460018f000009eb05600198000000400200043d00000000035200190000182b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000038004b00001a770000c13d0000182b0000013d0000000101000039000000000101041a0000000002000414000009ec04100197000009e90020009c000009e902008041000000c001200210000009ee011001c700008009020000390000000005000019279e27940000040f0000006003100270000009e90330019800001aaf0000613d0000001f04300039000009ea044001970000003f0440003900000a5704400197000000400500043d0000000004450019000000000054004b0000000006000039000000010600403900000a2d0040009c000010d10000213d0000000100600190000010d10000c13d000000400040043f0000001f0430018f0000000006350436000009eb05300198000000000356001900001aa20000613d000000000701034f000000007807043c0000000006860436000000000036004b00001a9e0000c13d000000000004004b00001aaf0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000000400100043d000000010020019000001ab90000613d00000007020000290000000000210435000009e90010009c000009e901008041000000400110021000000a40011001c70000279f0001042e00000a580200004100000f8b0000013d00000020030000390000000004310436000000000302043300000000003404350000004001100039000000000003004b00001aca0000613d000000000400001900000020022000390000000005020433000009ec0550019700000000015104360000000104400039000000000034004b00001ac30000413d000000000001042d0000000702000039000000000302041a000000000013004b00001ad30000a13d000000000020043f00000a2b0110009a0000000002000019000000000001042d00000a6601000041000000000010043f0000003201000039000000040010043f000009f801000041000027a00001043000000000430104340000000001320436000000000003004b00001ae50000613d000000000200001900000000051200190000000006240019000000000606043300000000006504350000002002200039000000000032004b00001ade0000413d000000000213001900000000000204350000001f0230003900000a76022001970000000001210019000000000001042d000000000301001900000000040104330000000001420436000000000004004b00001afd0000613d000000000200001900000020033000390000000005030433000000006505043400000a34055001970000000005510436000000000606043300000a3406600197000000000065043500000040011000390000000102200039000000000042004b00001af10000413d000000000001042d0000000043010434000009ec0330019700000000033204360000000004040433000009ec04400197000000000043043500000040031000390000000003030433000000ff0330018f00000040042000390000000000340435000000600310003900000000030304330000006004200039000001c0050000390000000000540435000001c00420003900000000530304340000000000340435000001e004200039000000000003004b00001b1c0000613d000000000600001900000000074600190000000008650019000000000808043300000000008704350000002006600039000000000036004b00001b150000413d000000000543001900000000000504350000001f0530003900000a760550019700000000044500190000008005100039000000000505043300000000062400490000008007200039000000000067043500000000650504340000000004540436000000000005004b00001b320000613d000000000700001900000000084700190000000009760019000000000909043300000000009804350000002007700039000000000057004b00001b2b0000413d00000000064500190000000000060435000000a006100039000000000606043300000a3006600197000000a0072000390000000000670435000000c006100039000000000606043300000a3406600197000000c0072000390000000000670435000000e006100039000000000606043300000a3406600197000000e00720003900000000006704350000010006100039000000000606043300000a34066001970000010007200039000000000067043500000120061000390000000006060433000009ec066001970000012007200039000000000067043500000140061000390000000006060433000000ff0660018f000001400720003900000000006704350000001f0550003900000a760550019700000000044500190000000005240049000001600620003900000160071000390000000007070433000000000056043500000000650704340000000004540436000000000005004b00001b660000613d000000000700001900000000084700190000000009760019000000000909043300000000009804350000002007700039000000000057004b00001b5f0000413d000000000645001900000000000604350000001f0550003900000a760550019700000000044500190000018005100039000000000505043300000000062400490000018007200039000000000067043500000000650504340000000004540436000000000005004b00001b7c0000613d000000000700001900000000084700190000000009760019000000000909043300000000009804350000002007700039000000000057004b00001b750000413d00000000064500190000000000060435000001a002200039000001a001100039000000000101043300000000001204350000001f0150003900000a76011001970000000001410019000000000001042d00000a770010009c00001b8b0000813d000000e001100039000000400010043f000000000001042d00000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a00001043000000a780010009c00001b960000813d0000008001100039000000400010043f000000000001042d00000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a000010430000000400210003900000a72030000410000000000320435000000200210003900000004030000390000000000320435000000200200003900000000002104350000006001100039000000000001042d000000400210003900000a71030000410000000000320435000000200210003900000006030000390000000000320435000000200200003900000000002104350000006001100039000000000001042d00040000000000020000000105000367000400000001001d000000000215034f000000000302043b00000a790030009c00001d890000813d0000000302000039000000000202041a000000000023004b00001db50000213d00000004010000290000002003100039000000000435034f000000000404043b0000ffff0040008c00001d890000213d000000000024004b00001db90000213d000100200030003d0000000101500360000000000101043b000300000001001d000009ec0010009c00001d890000213d000000400100043d000000030000006b00001dc00000613d00000a7a0010009c00001d8b0000813d0000004002100039000000400020043f000000200210003900000a7b0300004100000000003204350000000a020000390000000000210435000000400100043d00000a2d0010009c00001d8b0000213d0000000402000039000000000221043600000a3703000041000000000032043500000a330010009c00001d8b0000213d0000004003100039000000400030043f000009e90020009c000009e90200804100000040022002100000000001010433000009e90010009c000009e9010080410000006001100210000000000121019f0000000002000414000009e90020009c000009e902008041000000c002200210000000000121019f0000000302000029279e27990000040f0000006003100270000009e90430019800001c180000613d0000001f03400039000009ea033001970000003f0330003900000a5705300197000000400300043d0000000005530019000000000035004b0000000006000039000000010600403900000a2d0050009c00001d8b0000213d000000010060019000001d8b0000c13d000000400050043f0000001f0540018f0000000007430436000009eb06400198000000000467001900001c0a0000613d000000000801034f000000008908043c0000000007970436000000000047004b00001c060000c13d000000000005004b00001c190000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f000000000014043500001c190000013d0000006003000039000000010020019000001d910000613d00000000010304330000001f0010008c00001d910000a13d000000400100043d00000a330010009c00001d8b0000213d0000004002100039000000400020043f0000000602000039000000000121043600000a7c020000410000000000210435000009e90010009c000009e9010080410000004001100210000000400200043d000200000002001d0000000002000414000009e90020009c000009e902008041000000c002200210000000000121019f00000a7d011001c70000801002000039279e27990000040f000000010020019000001d890000613d000000020300002900000a2d0030009c00001d8b0000213d000000000201043b000000400030043f0000000401000039000000000113043600000a7e02200197000000000021043500000a330030009c00001d8b0000213d0000004002300039000000400020043f000009e90010009c000009e90100804100000040011002100000000002030433000009e90020009c000009e9020080410000006002200210000000000112019f0000000002000414000009e90020009c000009e902008041000000c002200210000000000121019f0000000302000029279e27990000040f0000006003100270000009e90430019800001c7b0000613d0000001f03400039000009ea033001970000003f0330003900000a5705300197000000400300043d0000000005530019000000000035004b0000000006000039000000010600403900000a2d0050009c00001d8b0000213d000000010060019000001d8b0000c13d000000400050043f0000001f0540018f0000000007430436000009eb06400198000000000467001900001c6d0000613d000000000801034f000000008908043c0000000007970436000000000047004b00001c690000c13d000000000005004b00001c7c0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f000000000014043500001c7c0000013d0000006003000039000000010020019000001d9a0000613d00000000010304330000005f0010008c00001d9a0000a13d000000400100043d00000a330010009c00001d8b0000213d0000004002100039000000400020043f0000000802000039000000000121043600000a7f020000410000000000210435000009e90010009c000009e9010080410000004001100210000000400200043d000200000002001d0000000002000414000009e90020009c000009e902008041000000c002200210000000000121019f00000a80011001c70000801002000039279e27990000040f000000010020019000001d890000613d000000020300002900000a2d0030009c00001d8b0000213d000000000201043b000000400030043f0000000401000039000000000113043600000a7e02200197000000000021043500000a330030009c00001d8b0000213d0000004002300039000000400020043f000009e90010009c000009e90100804100000040011002100000000002030433000009e90020009c000009e9020080410000006002200210000000000112019f0000000002000414000009e90020009c000009e902008041000000c002200210000000000121019f0000000302000029279e27990000040f0000006003100270000009e90430019800001cde0000613d0000001f03400039000009ea033001970000003f0330003900000a5705300197000000400300043d0000000005530019000000000035004b0000000006000039000000010600403900000a2d0050009c00001d8b0000213d000000010060019000001d8b0000c13d000000400050043f0000001f0540018f0000000007430436000009eb06400198000000000467001900001cd00000613d000000000801034f000000008908043c0000000007970436000000000047004b00001ccc0000c13d000000000005004b00001cdf0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f000000000014043500001cdf0000013d0000006003000039000000010020019000001da10000613d00000000010304330000005f0010008c00001da10000a13d000000010100002900000020081000390000000101000367000000000281034f000000000202043b00000a340020009c00001d890000213d000000000002004b00001dc60000613d0000002009800039000000000291034f000000000302043b0000000002000031000000040420006a0000001f0440008a00000a4f0540019700000a4f06300197000000000756013f000000000056004b000000000500001900000a4f05004041000000000043004b000000000400001900000a4f0400804100000a4f0070009c000000000504c019000000000005004b00001d890000c13d0000000403300029000000000131034f000000000501043b00000a2d0050009c00001d890000213d000000050150021000000000011200490000002002300039000000000012004b000000000300001900000a4f0300204100000a4f0110019700000a4f02200197000000000412013f000000000012004b000000000100001900000a4f0100404100000a4f0040009c000000000103c019000000000001004b00001d890000c13d000300000005001d000000000005004b00001db10000613d000100000009001d000200000008001d00000a530100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000009e90010009c000009e901008041000000c00110021000000a54011001c70000800502000039279e27990000040f000000010020019000001dcf0000613d000000000101043b000000030010006b000000020c000029000000010d00002900001db10000213d00000001010003670000000002d1034f000000000202043b0000000004000031000000040340006a0000001f0630008a00000a4f0760019700000a4f03200197000000000573013f000000000073004b000000000300001900000a4f03004041000000000062004b000000000800001900000a4f0800804100000a4f0050009c000000000308c019000000000003004b00001d890000c13d0000000402200029000000000321034f000000000303043b00000a2d0030009c00001d890000213d000000050530021000000000085400490000002009200039000000000089004b000000000a00001900000a4f0a00204100000a4f0880019700000a4f09900197000000000b89013f000000000089004b000000000800001900000a4f0800404100000a4f00b0009c00000000080ac019000000000008004b00001d890000c13d0000002008d00039000000000881034f000000000808043b00000a4f09800197000000000a79013f000000000079004b000000000700001900000a4f07004041000000000068004b000000000600001900000a4f0600804100000a4f00a0009c000000000706c019000000000007004b00001d890000c13d0000000407800029000000000671034f000000000606043b00000a2d0060009c00001d890000213d000000050860021000000000048400490000002007700039000000000047004b000000000800001900000a4f0800204100000a4f0440019700000a4f07700197000000000947013f000000000047004b000000000400001900000a4f0400404100000a4f0090009c000000000408c019000000000004004b00001d890000c13d000000000063004b00001dd00000c13d000000000003004b00001dd70000613d0000000002250019000000000221034f000000000202043b00000a340020009c00001d890000213d0000000001c1034f000000000101043b00000a340010009c00001d890000213d000000000012004b00001ddd0000c13d000000000001042d0000000001000019000027a00001043000000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a000010430000000400100043d000000440210003900000a8703000041000000000032043500000024021000390000000803000039000000000032043500000a860200004100001de50000013d000000400200043d000400000002001d00000a860100004100000000001204350000000401200039279e1b9c0000040f00001da70000013d000000400200043d000400000002001d00000a860100004100000000001204350000000401200039279e1ba60000040f00000004020000290000000001210049000009e90010009c000009e9010080410000006001100210000009e90020009c000009e9020080410000004002200210000000000121019f000027a000010430000000400100043d000000440210003900000a840300004100001de00000013d000000400100043d000000440210003900000a8a0300004100001dbc0000013d000000400100043d000000440210003900000a8903000041000000000032043500000024021000390000000b0300003900001dcc0000013d000000440210003900000a8803000041000000000032043500000024021000390000000c0300003900001dcc0000013d000000400100043d000000440210003900000a8503000041000000000032043500000024021000390000000903000039000000000032043500000a590200004100001de50000013d000000000001042f000000400100043d000000440210003900000a810300004100000000003204350000002402100039000000180300003900001de30000013d00000a6601000041000000000010043f0000001101000039000000040010043f000009f801000041000027a000010430000000400100043d000000440210003900000a8303000041000000000032043500000024021000390000001303000039000000000032043500000a82020000410000000000210435000000040210003900000020030000390000000000320435000009e90010009c000009e9010080410000004001100210000009f3011001c7000027a0000104300009000000000002000500000002001d000009ec01100197000800000001001d000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000504000029000000010020019000001f460000613d0000000102000367000000000342034f000000000101043b000900000001001d000000000101041a000700000001001d000000000103043b000600000001001d0000ffff0010008c00001f460000213d000400200040003d0000000401200360000000000101043b000300000001001d0000ffff0010008c00001f460000213d00000a8b0100004100000000001004430000000001000414000009e90010009c000009e901008041000000c00110021000000a8c011001c70000800b02000039279e27990000040f000000010020019000001f840000613d000000070200002900000a8d022001970000000603000029000000a00330021000000a8e03300197000000000223019f0000000303000029000000b00330021000000a8f03300197000000000232019f000000000300041100000a9003300197000000000232019f000000000101043b000000c00110021000000a9101100197000000000112019f0000000902000029000000000012041b00000004010000290000002001100039000600000001001d0000000101100367000000000101043b000009ec0010009c00001f460000213d00000009020000290000000102200039000000000302041a000009ed03300197000000000113019f000000000012041b00000a3701000041000000400200043d000700000002001d0000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000802000029279e27990000040f000000070b0000290000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900001e5a0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00001e560000c13d000000000006004b00001e670000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000000050c00002900001f850000613d0000001f01400039000000600210018f0000000001b20019000000000021004b0000000002000039000000010200403900000a2d0010009c00001f4f0000213d000000010020019000001f4f0000c13d000000400010043f000000200030008c00001f460000413d00000000010b0433000000ff0010008c00001f460000213d0000004e0010008c00001fa30000813d000000000001004b00001e880000613d0000000a020000390000000104000039000000010010019000000000032200a9000000010200603900000000044200a90000000101100272000000000203001900001e800000c13d00001e890000013d0000000104000039000100000004001d0000000601000029000400400010003d00000001010003670000000402100360000000000202043b00000000030000310000000004c300490000001f0640008a00000a4f0460019700000a4f05200197000000000745013f000000000045004b000000000400001900000a4f04004041000000000062004b000000000500001900000a4f0500804100000a4f0070009c000000000405c019000000000004004b00001f460000c13d0000000904000029000200030040003d0000000404000029000300200040003d000000000d0000190000000002c20019000000000421034f000000000404043b00000a2d0040009c00001f460000213d00000005054002100000000007530049000000200520003900000a4f0270019700000a4f08500197000000000928013f000000000028004b000000000200001900000a4f02004041000000000075004b000000000700001900000a4f0700204100000a4f0090009c000000000207c019000000000002004b00001f460000c13d00000000004d004b00001f480000813d0000000508d002100000000002580019000000000221034f000000000202043b00000a340020009c00001f460000213d0000000307100360000000000707043b00000a4f0970019700000a4f0a600197000000000ba9013f0000000000a9004b000000000900001900000a4f09004041000000000067004b000000000600001900000a4f0600804100000a4f00b0009c000000000906c019000000000009004b00001f460000c13d0000000007c70019000000000671034f000000000606043b00000a2d0060009c00001f460000213d00000005096002100000000003930049000000200770003900000a4f0930019700000a4f0a700197000000000b9a013f00000000009a004b000000000900001900000a4f09004041000000000037004b000000000300001900000a4f0300204100000a4f00b0009c000000000903c019000000000009004b00001f460000c13d00000000006d004b00001f490000813d0000000003870019000000000331034f000000000303043b00000a340030009c00001f460000213d000000000002004b00001f550000613d000000000003004b00001ef30000613d00000000082300a9000000010080006c00001f5c0000413d00000000000d004b00001f0b0000613d0000000108d0008a000000000048004b00001f490000813d00000005048002100000000005540019000000000551034f000000000505043b00000a340050009c00001f460000213d000000000052004b00001f630000a13d000000000068004b00001f490000813d0000000004470019000000000141034f000000000101043b00000a340010009c00001f460000213d000000400500043d000000000013004b00001f0c0000213d00001f740000013d000000400500043d000000020400002900090000000d001d00000a330050009c00001f4f0000213d0000004001500039000000400010043f0000000001250436000800000001001d0000000000310435000000000104041a00000a2d0010009c00001f4f0000213d000700000005001d000600000001001d0000000101100039000000000014041b000000000040043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f000000050c0000290000000100200190000000090d00002900001f460000613d000000000101043b00000006011000290000000702000029000000000202043300000a3402200197000000080300002900000000030304330000008003300210000000000223019f000000000021041b00000001010003670000000402100360000000000202043b00000000030000310000000004c300490000001f0640008a00000a4f0460019700000a4f05200197000000000745013f000000000045004b000000000400001900000a4f04002041000000000062004b000000000500001900000a4f0500404100000a4f0070009c000000000405c019000000010dd00039000000000004004b00001ea40000c13d0000000001000019000027a000010430000000000001042d00000a6601000041000000000010043f0000003201000039000000040010043f000009f801000041000027a00001043000000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a000010430000000400100043d000000440210003900000a950300004100000000003204350000002402100039000000130300003900001f690000013d000000400100043d000000440210003900000a9403000041000000000032043500000024021000390000001c0300003900001f690000013d000000400100043d000000440210003900000a9203000041000000000032043500000024021000390000001003000039000000000032043500000a82020000410000000000210435000000040210003900000020030000390000000000320435000009e90010009c000009e9010080410000004001100210000009f3011001c7000027a000010430000000440150003900000a9302000041000000000021043500000024015000390000001002000039000000000021043500000a82010000410000000000150435000000040150003900000020020000390000000000210435000009e90050009c000009e9050080410000004001500210000009f3011001c7000027a000010430000000000001042f0000001f0530018f000009eb06300198000000400200043d000000000462001900001f900000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00001f8c0000c13d000000000005004b00001f9d0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000009e90020009c000009e9020080410000004002200210000000000112019f000027a00001043000000a6601000041000000000010043f0000001101000039000000040010043f000009f801000041000027a0000104300003000000000002000300000001001d00000000010004100000006005100210000000400100043d0000002004100039000000000054043500000a76083001980000001f0930018f00000034061000390000000007860019000000010220036700001fbc0000613d000000000a02034f000000000b06001900000000ac0a043c000000000bcb043600000000007b004b00001fb80000c13d000000000009004b00001fc90000613d000000000282034f0000000308900210000000000907043300000000098901cf000000000989022f000000000202043b0000010008800089000000000282022f00000000028201cf000000000292019f00000000002704350000000002360019000000000002043500000014023000390000000000210435000000530230003900000a76022001970000000002210019000000000012004b0000000003000039000000010300403900000a2d0020009c000020500000213d0000000100300190000020500000c13d000000400020043f000009e90040009c000009e90400804100000040024002100000000001010433000009e90010009c000009e9010080410000006001100210000000000121019f0000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f000009ee011001c70000801002000039279e27990000040f00000001002001900000204b0000613d000000000301043b000000400400043d000000380140003900000000020004100000000000210435000000240140003900000a960200004100000000002104350000001401400039000000030200002900000000002104350000005801400039000100000003001d000000000031043500000a97010000410000000000140435000200000004001d0000000c01400039000009e90010009c000009e90100804100000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000121019f00000a98011001c70000801002000039279e27990000040f00000001002001900000204b0000613d000000000101043b0000000203000029000000780230003900000000001204350000004301300039000009e90010009c000009e90100804100000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000121019f00000a99011001c70000801002000039279e27990000040f00000001002001900000204b0000613d000000000101043b000009ec01100197000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000204b0000613d000000000101043b0000000101100039000000000101041a000009ec00100198000020560000c13d0000000302000029000000880120027000000a9b0110019700000a9c011001c7000000000010043f000000780120021000000a9d011001c7000000200010043f000000000100041400000a9e02000041000000090020043f00000001020000290000000d0020043f00000060020000390000004d0020043f0000004d0200008a0000006d0020043f000009e90010009c000009e901008041000000c00110021000000a9f011001c70000800602000039279e27940000040f00000001002001900000204d0000613d000000000101043b000009ec001001980000204d0000613d000000000001042d0000000001000019000027a000010430000000400100043d00000aa002000041000020580000013d00000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a000010430000000400100043d00000a9a020000410000000000210435000009e90010009c000009e901008041000000400110021000000a36011001c7000027a0000104300002000000000002000000000401041a00000aa10040009c000020960000813d00000005024002100000003f0220003900000a3102200197000000400500043d0000000002250019000000000052004b0000000003000039000000010300403900000a2d0020009c000020960000213d0000000100300190000020960000c13d000000400020043f000200000005001d0000000000450435000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039000100000004001d279e27990000040f00000001002001900000209c0000613d0000000108000029000000000008004b0000000209000029000020940000613d000000000101043b00000000020000190000000003090019000000400400043d00000a330040009c000020960000213d0000004005400039000000400050043f0000002005400039000000000601041a0000008007600270000000000075043500000a340560019700000000005404350000002003300039000000000043043500000001011000390000000102200039000000000082004b000020830000413d0000000001090019000000000001042d00000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a0000104300000000001000019000027a00001043000050000000000020000002003200039000009e90030009c000009e90300804100000040033002100000000002020433000009e90020009c000009e9020080410000006002200210000000000232019f0000000003000414000009e90030009c000009e903008041000000c003300210000000000332019f000009ec021001970000000001030019000300000002001d279e27940000040f0000006003100270000009e903300198000020db0000613d0000001f04300039000009ea044001970000003f0440003900000a5704400197000000400a00043d00000000044a00190000000000a4004b0000000005000039000000010500403900000a2d0040009c0000211e0000213d00000001005001900000211e0000c13d000000400040043f0000001f0430018f00000000093a0436000009eb053001980000000003590019000020cd0000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000037004b000020c90000c13d000000000004004b000020dd0000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000130435000020dd0000013d000000600a000039000000800900003900000000010a04330000000100200190000021110000613d0000000002000415000000050220008a0000000502200210000000000001004b000020ff0000c13d00020000000a001d000100000009001d00000a38010000410000000000100443000000030100002900000004001004430000000001000414000009e90010009c000009e901008041000000c00110021000000a39011001c70000800202000039279e27990000040f00000001002001900000212c0000613d000000000101043b000000000001004b00000002010000290000212d0000613d0000000002000415000000040220008a00000005022002100000000001010433000000000001004b00000001090000290000210e0000613d00000a520010009c0000210f0000213d000000200010008c0000210f0000413d0000000001090433000000000001004b0000000003000039000000010300c039000000000031004b0000210f0000c13d000000000001004b0000000501200270000000000100003f000000010100603f0000211b0000613d000000000001042d0000000001000019000027a000010430000000000001004b000021240000c13d000000400100043d00000aa2020000410000000000210435000009e90010009c000009e901008041000000400110021000000a36011001c7000027a000010430000000400100043d00000aa3020000410000212f0000013d00000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a000010430000009e90090009c000009e9090080410000004002900210000009e90010009c000009e9010080410000006001100210000000000121019f000027a000010430000000000001042f000000400100043d00000aa4020000410000000000210435000000040210003900000003030000290000000000320435000009e90010009c000009e9010080410000004001100210000009f8011001c7000027a000010430000009ec01100197000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000214c0000613d000000000101043b0000000101100039000000000101041a000009ec001001980000000001000039000000010100c039000000000001042d0000000001000019000027a0000104300005000000000002000000400300043d000500000003001d00000a35020000410000000000230435000009e90030009c000009e902000041000000000203401900000040022002100000000003000414000009e90030009c000009e903008041000000c003300210000000000223019f00000a36032001c7000009ec021001970000000001030019000100000002001d279e27990000040f000000050b0000290000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b0019000021710000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b0000216d0000c13d000000000006004b0000217e0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000022160000613d0000001f01400039000000600210018f0000000001b20019000000000021004b0000000002000039000000010200403900000a2d0010009c000022340000213d0000000100200190000022340000c13d000000400010043f0000001f0030008c0000220e0000a13d00000000010b0433000500000001001d0000000101000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000220e0000613d000000000101043b0000000301100039000000000201041a000400000002001d000000000002004b0000223a0000613d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000220e0000613d000000000101043b0000000401100029000000010110008a000000000101041a000400000001001d0000000101000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f000000040300002900000a3403300197000000050030006b0000000003000039000000010300403900000001002001900000220e0000613d000000000101043b0000000304100039000000000104041a000200000001001d000000000001004b000021e50000613d000400050030002d0000000002000019000300000004001d000000000104041a000500000002001d000000000021004b000022100000a13d000000000040043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000220e0000613d000000000101043b00000005020000290000000001210019000000000101041a00000a3401100197000000040010006c000021ed0000813d0000000102200039000000020020006c0000000304000029000021cc0000413d000000400100043d00000a67020000410000000000210435000009e90010009c000009e901008041000000400110021000000a36011001c7000027a0000104300000000101000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f00000001002001900000220e0000613d000000000101043b0000000301100039000000000201041a000000050020006c000022100000a13d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f00000001002001900000220e0000613d000000000101043b0000000501100029000000000101041a0000008001100270000000000001042d0000000001000019000027a00001043000000a6601000041000000000010043f0000003201000039000000040010043f000009f801000041000027a0000104300000001f0530018f000009eb06300198000000400200043d0000000004620019000022210000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000221d0000c13d000000000005004b0000222e0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000009e90020009c000009e9020080410000004002200210000000000112019f000027a00001043000000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a00001043000000a6601000041000000000010043f0000001101000039000000040010043f000009f801000041000027a0000104300001000000000002000009ec01100197000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000100200190000022640000613d000000000101043b0000000301100039000000000201041a000100000002001d000000000002004b000022660000613d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f0000000100200190000022640000613d000000000101043b0000000101100029000000010110008a000000000101041a00000a3401100197000000000001042d0000000001000019000027a00001043000000a6601000041000000000010043f0000001101000039000000040010043f000009f801000041000027a000010430000000400100043d00000aa50010009c0000228e0000813d000001c002100039000000400020043f000001800210003900000060030000390000000000320435000001600210003900000000003204350000008002100039000000000032043500000060021000390000000000320435000001a0021000390000000000020435000001400210003900000000000204350000012002100039000000000002043500000100021000390000000000020435000000e0021000390000000000020435000000c0021000390000000000020435000000a002100039000000000002043500000040021000390000000000020435000000200210003900000000000204350000000000010435000000000001042d00000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a000010430000f000000000002000000400200043d00000aa50020009c000026880000813d000001c003200039000000400030043f000001800320003900000060040000390000000000430435000001600320003900000000004304350000008003200039000000000043043500000060032000390000000000430435000001a0032000390000000000030435000001400320003900000000000304350000012003200039000000000003043500000100032000390000000000030435000000e0032000390000000000030435000000c0032000390000000000030435000000a003200039000000000003043500000040032000390000000000030435000000200320003900000000000304350000000000020435000009ec01100197000b00000001001d000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000100200190000026860000613d000000400500043d00000a2f0050009c000026880000213d000000000101043b000000e002500039000000400020043f000000000201041a000000b0032002700000ffff0330018f00000040045000390000000000340435000000a0032002700000ffff0330018f00000020045000390000000000340435000009ec032001970000000000350435000000c00220027000000a30022001970000006003500039000c00000003001d00000000002304350000000102100039000000000202041a000009ec022001970000008003500039000700000003001d0000000000230435000000a0035000390000000202100039000000000202041a000600000003001d00000000002304350000000301100039000000000401041a00000a2d0040009c000026880000213d00000005024002100000003f0220003900000a3102200197000000400600043d0000000002260019000000000062004b0000000003000039000000010300403900000a2d0020009c000026880000213d0000000100300190000026880000c13d000f00000005001d000000400020043f000e00000006001d0000000000460435000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039000d00000004001d279e27990000040f0000000100200190000026860000613d0000000d09000029000000000009004b0000000f080000290000000e0a0000290000231d0000613d000000000101043b000000000200001900000000030a0019000000400400043d00000a330040009c000026880000213d0000004005400039000000400050043f0000002005400039000000000601041a0000008007600270000000000075043500000a340560019700000000005404350000002003300039000000000043043500000001011000390000000102200039000000000092004b0000230c0000413d000000c0018000390000000000a104350000000001080433000500000001001d00000007010000290000000001010433000e00000001001d000000400200043d000f00000002001d00000a37010000410000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000b02000029279e27990000040f0000000f0b0000290000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b0019000023440000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000023400000c13d000000000006004b000023510000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f000000000065043500000001002001900000269a0000613d0000001f01400039000000600110018f0000000004b10019000000000014004b0000000001000039000000010100403900000a2d0040009c000026880000213d0000000100100190000026880000c13d000000400040043f000000200030008c000026860000413d00000000010b0433000400000001001d000000ff0010008c000026860000213d00000a4d010000410000000000140435000009e90040009c000009e901000041000000000104401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000b02000029000f00000004001d279e27990000040f00000060031002700000001f0430018f000009eb05300197000009e9033001970000000100200190000026a60000613d0000000f090000290000000002590019000000000005004b000023830000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000027004b0000237f0000c13d000000000004004b000023900000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000009ea011001970000000001910019000a00000001001d00000a2d0010009c000026880000213d0000000a01000029000000400010043f000000200030008c000026860000413d000000000109043300000a2d0010009c000026860000213d000000000393001900000000019100190000001f02100039000000000032004b000026860000813d000000002101043400000a2d0010009c000026880000213d0000001f0410003900000a76044001970000003f0440003900000a76044001970000000a0440002900000a2d0040009c000026880000213d000000400040043f0000000a0400002900000000041404360000000005210019000000000035004b000026860000213d000000000001004b000023bc0000613d000000000300001900000000054300190000000006230019000000000606043300000000006504350000002003300039000000000013004b000023b50000413d0000000001410019000000000001043500000a4e01000041000000400200043d0000000000120435000009e90020009c000f00000002001d000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000b02000029279e27990000040f00000060031002700000001f0430018f000009eb05300197000009e9033001970000000100200190000026b10000613d0000000f090000290000000002590019000000000005004b000023de0000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000027004b000023da0000c13d000000000004004b000023eb0000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000009ea011001970000000002910019000000000012004b00000000010000390000000101004039000900000002001d00000a2d0020009c000026880000213d0000000100100190000026880000c13d0000000901000029000000400010043f000000200030008c000026860000413d000000000109043300000a2d0010009c000026860000213d000000000393001900000000019100190000001f02100039000000000032004b000000000400001900000a4f0400804100000a4f0220019700000a4f05300197000000000652013f000000000052004b000000000200001900000a4f0200404100000a4f0060009c000000000204c019000000000002004b000026860000c13d000000002101043400000a2d0010009c000026880000213d0000001f0410003900000a76044001970000003f0440003900000a7604400197000000090440002900000a2d0040009c000026880000213d000000400040043f000000090400002900000000041404360000000005210019000000000035004b000026860000213d000000000001004b000024270000613d000000000300001900000000054300190000000006230019000000000606043300000000006504350000002003300039000000000013004b000024200000413d000000000141001900000000000104350000000c010000290000000001010433000300000001001d000000400200043d000f00000002001d00000a35010000410000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000b02000029279e27990000040f0000000f0b0000290000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b00190000244c0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000024480000c13d000000000006004b000024590000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000026bc0000613d0000001f01400039000000600210018f0000000001b20019000000000021004b0000000002000039000000010200403900000a2d0010009c000026880000213d0000000100200190000026880000c13d000000400010043f000000200030008c000026860000413d00000000020b0433000200000002001d00000a500020009c000026c80000813d0000000b01000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000100200190000026860000613d000000000101043b0000000301100039000000000201041a000f00000002001d000000000002004b000026940000613d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f0000000100200190000026860000613d000000000101043b0000000f01100029000000010110008a000000000101041a000100000001001d000000400200043d000f00000002001d00000a35010000410000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000b02000029279e27990000040f0000000f0b0000290000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b0019000024ae0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000024aa0000c13d000000000006004b000024bb0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000026d50000613d0000001f01400039000000600210018f0000000001b20019000000000021004b0000000002000039000000010200403900000a2d0010009c000026880000213d0000000100200190000026880000c13d000000400010043f000000200030008c000026860000413d00000000010b0433000f00000001001d0000000b01000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000100200190000026860000613d000000000101043b0000000301100039000000000201041a000d00000002001d000000000002004b000026940000613d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f0000000100200190000026860000613d000000000101043b0000000d01100029000000010110008a000000000101041a000d00000001001d0000000b01000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000d0300002900000a34033001970000000f0030006b000000000300003900000001030040390000000100200190000026860000613d000000000101043b0000000304100039000000000104041a000d00000001001d000000000001004b000025240000613d0000000e01000029000809ec0010019b000e000f0030002d0000000002000019000c00000004001d000000000104041a000f00000002001d000000000021004b0000268e0000a13d000000000040043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f0000000100200190000026860000613d000000000101043b0000000f020000290000000001210019000000000101041a00000a34011001970000000e0010006c0000252c0000813d00000001022000390000000d0020006c0000000c040000290000250b0000413d000000400100043d00000a67020000410000000000210435000009e90010009c000009e901008041000000400110021000000a36011001c7000027a0000104300000000b01000029000000000010043f0000000601000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000100200190000026860000613d000000000101043b0000000301100039000000000201041a0000000f0020006c0000268e0000a13d000000000010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a32011001c70000801002000039279e27990000040f0000000100200190000026860000613d000000000101043b0000000f01100029000000000101041a000e00000001001d00000007010000290000000001010433000d00000001001d000000400200043d000f00000002001d00000a37010000410000000000120435000009e90020009c000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000802000029279e27990000040f0000000f0b0000290000006003100270000009e903300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b00190000256f0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b0000256b0000c13d000000000006004b0000257c0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000026e10000613d0000001f01400039000000600110018f0000000004b10019000000000014004b0000000001000039000000010100403900000a2d0040009c000026880000213d0000000100100190000026880000c13d000000400040043f000000200030008c000026860000413d00000000010b0433000c00000001001d000000ff0010008c000026860000213d00000a4d010000410000000000140435000009e90040009c000009e901000041000000000104401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000802000029000f00000004001d279e27990000040f00000060031002700000001f0430018f000009eb05300197000009e9033001970000000100200190000026fa0000613d0000000f090000290000000002590019000000000005004b000025ae0000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000027004b000025aa0000c13d000000000004004b000025bb0000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000009ea01100197000000000691001900000a2d0060009c000026880000213d000000400060043f000000200030008c000026860000413d000000000109043300000a2d0010009c000026860000213d000000000393001900000000019100190000001f02100039000000000032004b000026860000813d000000002101043400000a2d0010009c000026880000213d0000001f0410003900000a76044001970000003f0440003900000a7604400197000000000464001900000a2d0040009c000026880000213d000000400040043f00000000041604360000000005210019000000000035004b000026860000213d000f00000006001d000000000001004b000025e50000613d000000000300001900000000054300190000000006230019000000000606043300000000006504350000002003300039000000000013004b000025de0000413d0000000001410019000000000001043500000a4e01000041000000400200043d0000000000120435000009e90020009c000700000002001d000009e901000041000000000102401900000040011002100000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f00000a36011001c70000000802000029279e27990000040f00000060031002700000001f0430018f000009eb05300197000009e9033001970000000100200190000027050000613d00000007090000290000000002590019000000000005004b000026070000613d000000000601034f0000000007090019000000006806043c0000000007870436000000000027004b000026030000c13d000000000004004b000026140000613d000000000151034f0000000304400210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001204350000001f01300039000009ea011001970000000002910019000000000012004b0000000001000039000000010100403900000a2d0020009c0000000f08000029000026880000213d0000000100100190000026880000c13d000000400020043f000000200030008c000026860000413d000000000109043300000a2d0010009c000026860000213d000000000493001900000000019100190000001f03100039000000000043004b000000000500001900000a4f0500804100000a4f0330019700000a4f06400197000000000763013f000000000063004b000000000300001900000a4f0300404100000a4f0070009c000000000305c019000000000003004b000026860000c13d000000003101043400000a2d0010009c000026880000213d0000001f0510003900000a76055001970000003f0550003900000a7605500197000000000525001900000a2d0050009c000026880000213d000000400050043f00000000051204360000000006310019000000000046004b000026860000213d000000000001004b0000264e0000613d000000000400001900000000065400190000000007340019000000000707043300000000007604350000002004400039000000000014004b000026470000413d00000000015100190000000000010435000000400100043d00000a4c0010009c000026880000213d00000006030000290000000003030433000001c004100039000000400040043f000001a004100039000000000034043500000180031000390000000000230435000001600210003900000000008204350000000c02000029000000ff0220018f000001400310003900000000002304350000000d02000029000009ec02200197000001200310003900000000002304350000000e02000029000000800220027000000100031000390000000000230435000000010200002900000a3402200197000000e0031000390000000000230435000000020200002900000a3402200197000000c0031000390000000000230435000000030200002900000a3002200197000000a003100039000000000023043500000080021000390000000903000029000000000032043500000060021000390000000a0300002900000000003204350000000402000029000000ff0220018f0000004003100039000000000023043500000020021000390000000b0300002900000000003204350000000502000029000009ec022001970000000000210435000000000001042d0000000001000019000027a00001043000000a6601000041000000000010043f0000004101000039000000040010043f000009f801000041000027a00001043000000a6601000041000000000010043f0000003201000039000000040010043f000009f801000041000027a00001043000000a6601000041000000000010043f0000001101000039000000040010043f000009f801000041000027a0000104300000001f0530018f000009eb06300198000000400200043d0000000004620019000026ec0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000026a10000c13d000026ec0000013d000000400200043d0000000006520019000000000005004b0000270f0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b000026ac0000c13d0000270f0000013d000000400200043d0000000006520019000000000005004b0000270f0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b000026b70000c13d0000270f0000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000026ec0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000026c30000c13d000026ec0000013d00000024021000390000000203000029000000000032043500000a51020000410000000000210435000000040210003900000080030000390000000000320435000009e90010009c000009e901008041000000400110021000000a3b011001c7000027a0000104300000001f0530018f000009eb06300198000000400200043d0000000004620019000026ec0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000026dc0000c13d000026ec0000013d0000001f0530018f000009eb06300198000000400200043d0000000004620019000026ec0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000026e80000c13d000000000005004b0000271c0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000271c0000013d000000400200043d0000000006520019000000000005004b0000270f0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b000027000000c13d0000270f0000013d000000400200043d0000000006520019000000000005004b0000270f0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000068004b0000270b0000c13d000000000004004b0000271c0000613d000000000151034f0000000304400210000000000506043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001604350000006001300210000009e90020009c000009e9020080410000004002200210000000000112019f000027a0000104300003000000000002000300000002001d000007d0043000c9000000000003004b0000272a0000613d00000000023400d9000007d00020008c000027780000c13d000100000004001d000200000003001d000009ec01100197000000000010043f0000000401000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000100200190000027760000613d000000000101043b0000000302000029000009ec02200197000300000002001d000000000020043f000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000100200190000027760000613d0000000102000029000027100420011a0000000202400069000000000101043b000000000301041a000000000023001a000027780000413d000200000004001d0000000002230019000000000021041b0000000101000039000000000101041a000009ec01100197000000000010043f0000000401000039000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000100200190000027760000613d000000000101043b0000000302000029000000000020043f000000200010043f0000000001000414000009e90010009c000009e901008041000000c00110021000000a2c011001c70000801002000039279e27990000040f0000000100200190000027760000613d000000000101043b000000000201041a0000000203000029000000000032001a000027780000413d0000000002320019000000000021041b000000000001042d0000000001000019000027a00001043000000a6601000041000000000010043f0000001101000039000000040010043f000009f801000041000027a000010430000000000001042f000009e90010009c000009e9010080410000004001100210000009e90020009c000009e9020080410000006002200210000000000112019f0000000002000414000009e90020009c000009e902008041000000c002200210000000000112019f000009ee011001c70000801002000039279e27990000040f0000000100200190000027920000613d000000000101043b000000000001042d0000000001000019000027a00001043000002797002104210000000102000039000000000001042d0000000002000019000000000001042d0000279c002104230000000102000039000000000001042d0000000002000019000000000001042d0000279e000004320000279f0001042e000027a00001043000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000000ffffffe0000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e000000002000000000000000000000000000001000000010000000000000000006d61785374657073000000000000000000000000000000000000000000000000643b81d700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006400000000000000000000000070726f746f636f6c42656e6566696369617279000000000000000000000000006d756c7469546f6b656e496d706c656d656e746174696f6e0000000000000000746f6b656e496d706c656d656e746174696f6e000000000000000000000000001e4fbdf700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002400000000000000000000000000000000000000000000000000000000000000000000000000000000995e5f9100000000000000000000000000000000000000000000000000000000c9cb204a00000000000000000000000000000000000000000000000000000000f2fde38a00000000000000000000000000000000000000000000000000000000f74bfe8d00000000000000000000000000000000000000000000000000000000f74bfe8e00000000000000000000000000000000000000000000000000000000fb8c13c800000000000000000000000000000000000000000000000000000000fccc281300000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000f6a3d24e00000000000000000000000000000000000000000000000000000000d9fe0ead00000000000000000000000000000000000000000000000000000000d9fe0eae00000000000000000000000000000000000000000000000000000000dce0b4e400000000000000000000000000000000000000000000000000000000c9cb204b00000000000000000000000000000000000000000000000000000000cfc5562200000000000000000000000000000000000000000000000000000000a746ee2d00000000000000000000000000000000000000000000000000000000ac4e967400000000000000000000000000000000000000000000000000000000ac4e967500000000000000000000000000000000000000000000000000000000c162c91600000000000000000000000000000000000000000000000000000000a746ee2e00000000000000000000000000000000000000000000000000000000a9816b08000000000000000000000000000000000000000000000000000000009cc7bece000000000000000000000000000000000000000000000000000000009cc7becf000000000000000000000000000000000000000000000000000000009f181b5e00000000000000000000000000000000000000000000000000000000995e5f92000000000000000000000000000000000000000000000000000000009c65003d00000000000000000000000000000000000000000000000000000000715018a50000000000000000000000000000000000000000000000000000000077e456ca0000000000000000000000000000000000000000000000000000000085396d2a0000000000000000000000000000000000000000000000000000000085396d2b000000000000000000000000000000000000000000000000000000008da5cb5b00000000000000000000000000000000000000000000000000000000990e60050000000000000000000000000000000000000000000000000000000077e456cb00000000000000000000000000000000000000000000000000000000840d885d00000000000000000000000000000000000000000000000000000000763e7da500000000000000000000000000000000000000000000000000000000763e7da60000000000000000000000000000000000000000000000000000000076a9864b00000000000000000000000000000000000000000000000000000000715018a6000000000000000000000000000000000000000000000000000000007348ed2f0000000000000000000000000000000000000000000000000000000050801fb0000000000000000000000000000000000000000000000000000000005a4d5310000000000000000000000000000000000000000000000000000000005a4d5311000000000000000000000000000000000000000000000000000000006fa237950000000000000000000000000000000000000000000000000000000050801fb10000000000000000000000000000000000000000000000000000000054fd4d500000000000000000000000000000000000000000000000000000000030be69540000000000000000000000000000000000000000000000000000000030be6955000000000000000000000000000000000000000000000000000000004f64b2be0000000000000000000000000000000000000000000000000000000007e329460000000000000000000000000000000000000000000000000000000027e381a90000000000000000000000000000000000000020000000800000000000000000599336d74a1247d50642b66dd6abeaa5484f6bd96b415b31bb99e26578c939780200000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffff00000000000000000000000000000000000000000000003fffffffffffffffe0000000000000000000000000000000000000000000000000ffffffffffffff1f000000000000000000000000000000000000000000000000000000ffffffffff7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe00200000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffbf00000000000000000000000000000000ffffffffffffffffffffffffffffffff18160ddd000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000313ce567000000000000000000000000000000000000000000000000000000001806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b8302000002000000000000000000000000000000240000000000000000000000001b5ad8b500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004400000000000000000000000023b872dd00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff5f020000000000000000000000000000000000006000000000000000000000000002ed9b10d8b33a6a9fda664247bfd8f6248f74cff85cc84e56b7530c2fce560a0000000000000000000000000000000000000020000000000000000000000000118cdaa700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002400000080000000000000000000000000000000000000000000000000000000c0000000800000000000000000a9059cbb00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff7fd1b893da855ca6a7c9cfbaff142da78c734a39d4811ad711fe7acfd6e5e433a400000000000000000000000000000000000000400000000000000000000000004fffb8fa00000000000000000000000000000000000000000000000000000000bfa4e446000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000800000000000000000000000000000000000000000000000000000000000000000fffffffffffffdbf000000000000000000000000000000000000000000000000fffffffffffffe3f95d89b410000000000000000000000000000000000000000000000000000000006fdde0300000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000006dfcc650000000000000000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff310ab089e4439a4c15d089f94afb7896ff553aecb10793d0ab882de59d99a32e020000020000000000000000000000000000004400000000000000000000000041e461a00000000000000000000000000000000000000000000000000000000042d30c09380d6b8dbb77d95cae534a5c8fbf778789d87f58030bd7428043707100000000000000000000000000000000000000000000000000000003ffffffe00d4d59b30000000000000000000000000000000000000000000000000000000049d3358800000000000000000000000000000000000000000000000000000000757269000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000640000008000000000000000006b5b0f7c0000000000000000000000000000000000000000000000000000000036a02038000000000000000000000000000000000000000000000000000000009dcef3aa57f22970dfc6ff519e5421e041cc4153300a7dabe19bffe85e25568867f61c8200000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000002000000080000000000000000021085b3501e0e4fa8e0c825e7ed36b44420471b9f3c5aef447cebe50b2db133d88a973fd5506071e0cf878b30898776c47d5250a7ee1e6ee0b36df3b03c7c16af4efe8f20000000000000000000000000000000000000000000000000000000080a56de61873550ae491e454783a8dfc9d08a6f8bdace0887eabd4315c4b9da807728bb0000000000000000000000000000000000000000000000000000000004e487b7100000000000000000000000000000000000000000000000000000000d1ce01ea00000000000000000000000000000000000000000000000000000000c01ae105000000000000000000000000000000000000000000000000000000002d350e9f00000000000000000000000000000000000000000000000000000000d9b08f76000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000800000000000000000302e312e313230000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c000000000000000003403ce37000000000000000000000000000000000000000000000000000000007029144c000000000000000000000000000000000000000000000000000000006596c1670eb3390048d23721809c3da5d3f531375ac0e2cab0f77a808ed6433173796d626f6c00000000000000000000000000000000000000000000000000006e616d6500000000000000000000000000000000000000000000000000000000cf7686c0c53a1ab216c4cd81c1bc037136c791a61f30af4a78827c39157660445059b85f00000000000000000000000000000000000000000000000000000000891724d600000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0000000000000000000000000000000000000000000000000ffffffffffffff20000000000000000000000000000000000000000000000000ffffffffffffff800000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000ffffffffffffffc0646563696d616c732829000000000000000000000000000000000000000000006e616d65282900000000000000000000000000000000000000000000000000000200000000000000000000000000000000000006000000000000000000000000ffffffff0000000000000000000000000000000000000000000000000000000073796d626f6c28290000000000000000000000000000000000000000000000000200000000000000000000000000000000000008000000000000000000000000535445505f4c454e4754485f444f5f4e4f545f4d4154434800000000000000001afd40d6000000000000000000000000000000000000000000000000000000004d41585f535550504c595f4d49534d4154434800000000000000000000000000494e56414c49445f535445505f4c454e475448000000000000000000000000006d6178537570706c79000000000000000000000000000000000000000000000059f5822400000000000000000000000000000000000000000000000000000000646563696d616c7300000000000000000000000000000000000000000000000072657365727665546f6b656e00000000000000000000000000000000000000006275726e526f79616c74790000000000000000000000000000000000000000006d696e74526f79616c7479000000000000000000000000000000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d955391320200000200000000000000000000000000000004000000000000000000000000ffffff000000000000000000000000000000000000000000000000000000000000000000000000000000ffff00000000000000000000000000000000000000000000000000000000ffff00000000000000000000000000000000000000000000ffffff000000000000000000ffffffffffffffffffffffffffffffffffffffff000000ffffffffff00000000000000000000000000000000000000000000000044454352454153494e475f52414e47450000000000000000000000000000000044454352454153494e475f505249434500000000000000000000000000000000535445505f52414e475f4f525f50524943455f544f4f5f534d414c4c00000000535445505f43414e4e4f545f42455f5a45524f00000000000000000000000000000000000000000000000000000000005af43d82803e903d91602b57fd5bf3ff0000000000000000000000003d602d80600a3d3981f3363d3d373d3d3d363d7302000000000000000000000000000000000000370000000000000000000000000200000000000000000000000000000000000055000000000000000000000000358b6638000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffff0000000000000000003d602d80600a3d3981f3363d3d373d3d3d363d7300000000000000000000000000000000000000005af43d82803e903d91602b57fd5bf33cda33511d41a8a5431b1770c5bc0ddd62e1cd30555d16659b89c0d60f4f9f570200000000000000000000000000000000000037000000090000000000000000c2f868f40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000001425ea42000000000000000000000000000000000000000000000000000000005274afe7000000000000000000000000000000000000000000000000000000009996b31500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000fffffffffffffe40e4cb9c3c7c638b2bad305ec11e34ff3723bbfc4e01e3230e5f47c09e5b34e120
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
00000000000000000000000023cb54484b807b286e3a9bb52c416b0cfeb2d224000000000000000000000000e1c1c27589bef64ff80165ad02de7ebf8aef966f00000000000000000000000082ca6d313bffe56e9096b16633dfd414148d66b1000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003e8
-----Decoded View---------------
Arg [0] : tokenImplementation (address): 0x23cb54484b807b286e3A9bb52C416B0CFeb2d224
Arg [1] : multiTokenImplementation (address): 0xe1c1c27589bef64fF80165AD02De7eBf8AeF966F
Arg [2] : protocolBeneficiary_ (address): 0x82CA6d313BffE56E9096b16633dfD414148D66b1
Arg [3] : creationFee_ (uint256): 0
Arg [4] : maxSteps (uint256): 1000
-----Encoded View---------------
5 Constructor Arguments found :
Arg [0] : 00000000000000000000000023cb54484b807b286e3a9bb52c416b0cfeb2d224
Arg [1] : 000000000000000000000000e1c1c27589bef64ff80165ad02de7ebf8aef966f
Arg [2] : 00000000000000000000000082ca6d313bffe56e9096b16633dfd414148d66b1
Arg [3] : 0000000000000000000000000000000000000000000000000000000000000000
Arg [4] : 00000000000000000000000000000000000000000000000000000000000003e8
Loading...
Loading
Loading...
Loading
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.