Overview
ETH Balance
0 ETH
ETH Value
$0.00More Info
Private Name Tags
ContractCreator
Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
---|---|---|---|---|---|---|---|---|---|
Latest 1 internal transaction
Parent Transaction Hash | Block | From | To | |||
---|---|---|---|---|---|---|
250241 | 27 days ago | Contract Creation | 0 ETH |
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 Source Code Verified (Exact Match)
Contract Name:
PepenadeCrush
Compiler Version
v0.8.28+commit.7893614a
ZkSolc Version
v1.5.7
Optimization Enabled:
Yes with Mode 3
Other Settings:
paris EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: UNLICENSED pragma solidity 0.8.28; import {UUPSUpgradeable} from "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol"; import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol"; import {EIP712Upgradeable} from "@openzeppelin/contracts-upgradeable/utils/cryptography/draft-EIP712Upgradeable.sol"; import {OwnableUpgradeable} from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol"; import {ECDSA} from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol"; /// @title Fear & Greed: Pepenade Crush /// @notice A contract to manage the scores of the players in the Pepenade Crush minigame contract PepenadeCrush is Initializable, UUPSUpgradeable, EIP712Upgradeable, OwnableUpgradeable { /// @notice The message struct containing the player address, scores and nonce struct ScoreMessage { address player; uint256 totalScore; uint256 highScore; uint256 crewScore; string nonce; } /// @notice Event emitted when player's total score is updated event NewTotalScore( address indexed player, uint256 previousScore, uint256 newScore ); /// @notice Event emitted when player reaches new high score event NewHighScore( address indexed player, uint256 previousHighScore, uint256 newHighScore ); /// @notice Event emitted when player's crew reaches new total score event NewCrewScore( address indexed player, uint256 previousScore, uint256 newScore ); /// @notice Event emitted when the backend wallet address is set event BackendSignerSet(address backendSigner); /// @dev Custom errors error NonceAlreadyUsed(string nonce); error InvalidSigner(); /// @notice The address of the backend wallet that will sign the messages address public backendSigner; /// @notice Mapping of player address to their total score mapping(address => uint256) public totalScore; /// @notice Mapping of player address to their high score mapping(address => uint256) public highScore; /// @notice Mapping of crew address to their high score mapping(address => uint256) public crewScore; /// @notice Mapping of nonce to a boolean indicating if it was already used mapping(string => bool) public nonces; /// @notice Initializes the contract with the backend wallet address and the deployer as the owner /// @param _backendSigner The address of the backend wallet function initialize(address _backendSigner) external initializer { __Ownable_init(); __EIP712_init("PepenadeCrush", "1"); _setBackendSigner(_backendSigner); } /// @notice Adds a score to a player's current score /// @param message The message containing the player address, score and nonce /// @param signature The signature of the message signed by the backend wallet function updateScore( ScoreMessage memory message, bytes memory signature ) external { _verifySignature(message, signature); _consumeNonce(message.nonce); _updateScore( message.player, message.totalScore, message.highScore, message.crewScore ); } /// @dev Updates all scores for a player /// @dev Has no signature verification, nonce consumption or authorization checks /// @param player The address of the player /// @param _totalScore The new total score /// @param _highScore The new high score /// @param _crewScore The new crew score function _updateScore( address player, uint256 _totalScore, uint256 _highScore, uint256 _crewScore ) private { _updateTotalScore(player, _totalScore); _updateHighScore(player, _highScore); _updateCrewScore(player, _crewScore); } /// @dev Updates the total score of a player /// @param player The address of the player /// @param score The new total score function _updateTotalScore(address player, uint256 score) private { uint256 previousScore = totalScore[player]; if (score <= previousScore) { return; } totalScore[player] = score; emit NewTotalScore(player, previousScore, score); } /// @dev Updates the high score of a player /// @param player The address of the player /// @param score The new high score function _updateHighScore(address player, uint256 score) private { uint256 previousScore = highScore[player]; if (score <= previousScore) { return; } highScore[player] = score; emit NewHighScore(player, previousScore, score); } /// @dev Updates the crew score of a player /// @param player The address of the player /// @param score The new crew score function _updateCrewScore(address player, uint256 score) private { uint256 previousScore = crewScore[player]; if (score <= previousScore) { return; } crewScore[player] = score; emit NewCrewScore(player, previousScore, score); } /// @notice Utility function to check if the message encoding is valid /// @param message The message containing the player address, score and nonce /// @param encodedMessage Hashed, ABI encoded message function isMessageEncodingValid( ScoreMessage memory message, bytes32 encodedMessage ) public view returns (bool) { return _verifyMessage(message, encodedMessage); } /// @notice Utility function to get the signer of a message /// @param message The message containing the player address, score and nonce /// @param signature The signature of the message function getSigner( ScoreMessage memory message, bytes memory signature ) public view returns (address) { return ECDSA.recover(_hashTypedDataV4(_hashMessage(message)), signature); } /// @notice Sets the backend wallet address. Can only be called by the owner /// @param _backendSigner The address of the backend wallet function setBackendSigner(address _backendSigner) external onlyOwner { _setBackendSigner(_backendSigner); } /// @dev Verifies if the message was constructed correctly /// @param message The message containing the player address, score, nonce /// @param rawMessage The raw message /// @return bool function _verifyMessage( ScoreMessage memory message, bytes32 rawMessage ) private view returns (bool) { bytes32 expectedDigest = _hashTypedDataV4(_hashMessage(message)); bytes32 digest = _hashTypedDataV4(rawMessage); return expectedDigest == digest; } /// @dev Verifies if the message was signed by the backend wallet. Reverts with InvalidSigner if not /// @param message The message containing the player address, score, nonce /// @param signature The signature of the message function _verifySignature( ScoreMessage memory message, bytes memory signature ) private view { bytes32 digest = _hashTypedDataV4(_hashMessage(message)); address signer = ECDSA.recover(digest, signature); if (signer != backendSigner) { revert InvalidSigner(); } } /// @notice Sets the backend wallet address /// @param _backendSigner The address of the backend wallet /// @dev Emits a BackendSignerSet event /// @dev Does not check for authorization function _setBackendSigner(address _backendSigner) private { backendSigner = _backendSigner; emit BackendSignerSet(_backendSigner); } /// @notice Validates whether a nonce was already used and marks it as used /// @param nonce The nonce to validate /// @dev Reverts with NonceAlreadyUsed if the nonce was already used function _consumeNonce(string memory nonce) private { if (nonces[nonce]) { revert NonceAlreadyUsed(nonce); } nonces[nonce] = true; } /// @dev ABI encodes the message and hashes it using keccak256 /// @param message The message containing the player address, score, nonce /// @return bytes32 function _hashMessage( ScoreMessage memory message ) private pure returns (bytes32) { return keccak256( abi.encode( keccak256( "ScoreMessage(address player,uint256 totalScore,uint256 highScore,uint256 crewScore,string nonce)" ), message.player, message.totalScore, message.highScore, message.crewScore, keccak256(bytes(message.nonce)) ) ); } /// @dev Upgrades the contract to a new implementation /// @param newImplementation The address of the new implementation function _authorizeUpgrade( address newImplementation ) internal override onlyOwner {} }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (proxy/utils/Initializable.sol) pragma solidity ^0.8.2; import "../../utils/AddressUpgradeable.sol"; /** * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect. * * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in * case an upgrade adds a module that needs to be initialized. * * For example: * * [.hljs-theme-light.nopadding] * ``` * contract MyToken is ERC20Upgradeable { * function initialize() initializer public { * __ERC20_init("MyToken", "MTK"); * } * } * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable { * function initializeV2() reinitializer(2) public { * __ERC20Permit_init("MyToken"); * } * } * ``` * * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}. * * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity. * * [CAUTION] * ==== * Avoid leaving a contract uninitialized. * * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed: * * [.hljs-theme-light.nopadding] * ``` * /// @custom:oz-upgrades-unsafe-allow constructor * constructor() { * _disableInitializers(); * } * ``` * ==== */ abstract contract Initializable { /** * @dev Indicates that the contract has been initialized. * @custom:oz-retyped-from bool */ uint8 private _initialized; /** * @dev Indicates that the contract is in the process of being initialized. */ bool private _initializing; /** * @dev Triggered when the contract has been initialized or reinitialized. */ event Initialized(uint8 version); /** * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope, * `onlyInitializing` functions can be used to initialize parent contracts. Equivalent to `reinitializer(1)`. */ modifier initializer() { bool isTopLevelCall = _setInitializedVersion(1); if (isTopLevelCall) { _initializing = true; } _; if (isTopLevelCall) { _initializing = false; emit Initialized(1); } } /** * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be * used to initialize parent contracts. * * `initializer` is equivalent to `reinitializer(1)`, so a reinitializer may be used after the original * initialization step. This is essential to configure modules that are added through upgrades and that require * initialization. * * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in * a contract, executing them in the right order is up to the developer or operator. */ modifier reinitializer(uint8 version) { bool isTopLevelCall = _setInitializedVersion(version); if (isTopLevelCall) { _initializing = true; } _; if (isTopLevelCall) { _initializing = false; emit Initialized(version); } } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} and {reinitializer} modifiers, directly or indirectly. */ modifier onlyInitializing() { require(_initializing, "Initializable: contract is not initializing"); _; } /** * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call. * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized * to any version. It is recommended to use this to lock implementation contracts that are designed to be called * through proxies. */ function _disableInitializers() internal virtual { _setInitializedVersion(type(uint8).max); } function _setInitializedVersion(uint8 version) private returns (bool) { // If the contract is initializing we ignore whether _initialized is set in order to support multiple // inheritance patterns, but we only do this in the context of a constructor, and for the lowest level // of initializers, because in other contexts the contract may have been reentered. if (_initializing) { require( version == 1 && !AddressUpgradeable.isContract(address(this)), "Initializable: contract is already initialized" ); return false; } else { require(_initialized < version, "Initializable: contract is already initialized"); _initialized = version; return true; } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/cryptography/draft-EIP712.sol) pragma solidity ^0.8.0; import "./ECDSAUpgradeable.sol"; import "../../proxy/utils/Initializable.sol"; /** * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data. * * The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible, * thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding * they need in their contracts using a combination of `abi.encode` and `keccak256`. * * This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding * scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA * ({_hashTypedDataV4}). * * The implementation of the domain separator was designed to be as efficient as possible while still properly updating * the chain id to protect against replay attacks on an eventual fork of the chain. * * NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method * https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask]. * * _Available since v3.4._ * * @custom:storage-size 52 */ abstract contract EIP712Upgradeable is Initializable { /* solhint-disable var-name-mixedcase */ bytes32 private _HASHED_NAME; bytes32 private _HASHED_VERSION; bytes32 private constant _TYPE_HASH = keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)"); /* solhint-enable var-name-mixedcase */ /** * @dev Initializes the domain separator and parameter caches. * * The meaning of `name` and `version` is specified in * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]: * * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol. * - `version`: the current major version of the signing domain. * * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart * contract upgrade]. */ function __EIP712_init(string memory name, string memory version) internal onlyInitializing { __EIP712_init_unchained(name, version); } function __EIP712_init_unchained(string memory name, string memory version) internal onlyInitializing { bytes32 hashedName = keccak256(bytes(name)); bytes32 hashedVersion = keccak256(bytes(version)); _HASHED_NAME = hashedName; _HASHED_VERSION = hashedVersion; } /** * @dev Returns the domain separator for the current chain. */ function _domainSeparatorV4() internal view returns (bytes32) { return _buildDomainSeparator(_TYPE_HASH, _EIP712NameHash(), _EIP712VersionHash()); } function _buildDomainSeparator( bytes32 typeHash, bytes32 nameHash, bytes32 versionHash ) private view returns (bytes32) { return keccak256(abi.encode(typeHash, nameHash, versionHash, block.chainid, address(this))); } /** * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this * function returns the hash of the fully encoded EIP712 message for this domain. * * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example: * * ```solidity * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode( * keccak256("Mail(address to,string contents)"), * mailTo, * keccak256(bytes(mailContents)) * ))); * address signer = ECDSA.recover(digest, signature); * ``` */ function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) { return ECDSAUpgradeable.toTypedDataHash(_domainSeparatorV4(), structHash); } /** * @dev The hash of the name parameter for the EIP712 domain. * * NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs * are a concern. */ function _EIP712NameHash() internal virtual view returns (bytes32) { return _HASHED_NAME; } /** * @dev The hash of the version parameter for the EIP712 domain. * * NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs * are a concern. */ function _EIP712VersionHash() internal virtual view returns (bytes32) { return _HASHED_VERSION; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (proxy/utils/UUPSUpgradeable.sol) pragma solidity ^0.8.0; import "../../interfaces/draft-IERC1822Upgradeable.sol"; import "../ERC1967/ERC1967UpgradeUpgradeable.sol"; import "./Initializable.sol"; /** * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy. * * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing * `UUPSUpgradeable` with a custom implementation of upgrades. * * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism. * * _Available since v4.1._ */ abstract contract UUPSUpgradeable is Initializable, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable { function __UUPSUpgradeable_init() internal onlyInitializing { } function __UUPSUpgradeable_init_unchained() internal onlyInitializing { } /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment address private immutable __self = address(this); /** * @dev Check that the execution is being performed through a delegatecall call and that the execution context is * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to * fail. */ modifier onlyProxy() { require(address(this) != __self, "Function must be called through delegatecall"); require(_getImplementation() == __self, "Function must be called through active proxy"); _; } /** * @dev Check that the execution is not being performed through a delegate call. This allows a function to be * callable on the implementing contract but not through proxies. */ modifier notDelegated() { require(address(this) == __self, "UUPSUpgradeable: must not be called through delegatecall"); _; } /** * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the * implementation. It is used to validate that the this implementation remains valid after an upgrade. * * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier. */ function proxiableUUID() external view virtual override notDelegated returns (bytes32) { return _IMPLEMENTATION_SLOT; } /** * @dev Upgrade the implementation of the proxy to `newImplementation`. * * Calls {_authorizeUpgrade}. * * Emits an {Upgraded} event. */ function upgradeTo(address newImplementation) external virtual onlyProxy { _authorizeUpgrade(newImplementation); _upgradeToAndCallUUPS(newImplementation, new bytes(0), false); } /** * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call * encoded in `data`. * * Calls {_authorizeUpgrade}. * * Emits an {Upgraded} event. */ function upgradeToAndCall(address newImplementation, bytes memory data) external payable virtual onlyProxy { _authorizeUpgrade(newImplementation); _upgradeToAndCallUUPS(newImplementation, data, true); } /** * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by * {upgradeTo} and {upgradeToAndCall}. * * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}. * * ```solidity * function _authorizeUpgrade(address) internal override onlyOwner {} * ``` */ function _authorizeUpgrade(address newImplementation) internal virtual; /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/Ownable.sol) pragma solidity ^0.8.0; import "../utils/ContextUpgradeable.sol"; import "../proxy/utils/Initializable.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * By default, the owner account will be the one that deploys the contract. This * can later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable { address private _owner; event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the deployer as the initial owner. */ function __Ownable_init() internal onlyInitializing { __Ownable_init_unchained(); } function __Ownable_init_unchained() internal onlyInitializing { _transferOwnership(_msgSender()); } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { require(owner() == _msgSender(), "Ownable: caller is not the owner"); _; } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions anymore. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby removing any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { require(newOwner != address(0), "Ownable: new owner is the zero address"); _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (utils/cryptography/ECDSA.sol) pragma solidity ^0.8.0; import "../Strings.sol"; /** * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations. * * These functions can be used to verify that a message was signed by the holder * of the private keys of a given address. */ library ECDSA { enum RecoverError { NoError, InvalidSignature, InvalidSignatureLength, InvalidSignatureS, InvalidSignatureV } function _throwError(RecoverError error) private pure { if (error == RecoverError.NoError) { return; // no error: do nothing } else if (error == RecoverError.InvalidSignature) { revert("ECDSA: invalid signature"); } else if (error == RecoverError.InvalidSignatureLength) { revert("ECDSA: invalid signature length"); } else if (error == RecoverError.InvalidSignatureS) { revert("ECDSA: invalid signature 's' value"); } else if (error == RecoverError.InvalidSignatureV) { revert("ECDSA: invalid signature 'v' value"); } } /** * @dev Returns the address that signed a hashed message (`hash`) with * `signature` or error string. This address can then be used for verification purposes. * * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures: * this function rejects them by requiring the `s` value to be in the lower * half order, and the `v` value to be either 27 or 28. * * IMPORTANT: `hash` _must_ be the result of a hash operation for the * verification to be secure: it is possible to craft signatures that * recover to arbitrary addresses for non-hashed data. A safe way to ensure * this is by receiving a hash of the original message (which may otherwise * be too long), and then calling {toEthSignedMessageHash} on it. * * Documentation for signature generation: * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js] * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers] * * _Available since v4.3._ */ function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) { // Check the signature length // - case 65: r,s,v signature (standard) // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._ if (signature.length == 65) { bytes32 r; bytes32 s; uint8 v; // ecrecover takes the signature parameters, and the only way to get them // currently is to use assembly. assembly { r := mload(add(signature, 0x20)) s := mload(add(signature, 0x40)) v := byte(0, mload(add(signature, 0x60))) } return tryRecover(hash, v, r, s); } else if (signature.length == 64) { bytes32 r; bytes32 vs; // ecrecover takes the signature parameters, and the only way to get them // currently is to use assembly. assembly { r := mload(add(signature, 0x20)) vs := mload(add(signature, 0x40)) } return tryRecover(hash, r, vs); } else { return (address(0), RecoverError.InvalidSignatureLength); } } /** * @dev Returns the address that signed a hashed message (`hash`) with * `signature`. This address can then be used for verification purposes. * * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures: * this function rejects them by requiring the `s` value to be in the lower * half order, and the `v` value to be either 27 or 28. * * IMPORTANT: `hash` _must_ be the result of a hash operation for the * verification to be secure: it is possible to craft signatures that * recover to arbitrary addresses for non-hashed data. A safe way to ensure * this is by receiving a hash of the original message (which may otherwise * be too long), and then calling {toEthSignedMessageHash} on it. */ function recover(bytes32 hash, bytes memory signature) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, signature); _throwError(error); return recovered; } /** * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately. * * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures] * * _Available since v4.3._ */ function tryRecover( bytes32 hash, bytes32 r, bytes32 vs ) internal pure returns (address, RecoverError) { bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff); uint8 v = uint8((uint256(vs) >> 255) + 27); return tryRecover(hash, v, r, s); } /** * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately. * * _Available since v4.2._ */ function recover( bytes32 hash, bytes32 r, bytes32 vs ) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, r, vs); _throwError(error); return recovered; } /** * @dev Overload of {ECDSA-tryRecover} that receives the `v`, * `r` and `s` signature fields separately. * * _Available since v4.3._ */ function tryRecover( bytes32 hash, uint8 v, bytes32 r, bytes32 s ) internal pure returns (address, RecoverError) { // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most // signatures from current libraries generate a unique signature with an s-value in the lower half order. // // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept // these malleable signatures as well. if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) { return (address(0), RecoverError.InvalidSignatureS); } if (v != 27 && v != 28) { return (address(0), RecoverError.InvalidSignatureV); } // If the signature is valid (and not malleable), return the signer address address signer = ecrecover(hash, v, r, s); if (signer == address(0)) { return (address(0), RecoverError.InvalidSignature); } return (signer, RecoverError.NoError); } /** * @dev Overload of {ECDSA-recover} that receives the `v`, * `r` and `s` signature fields separately. */ function recover( bytes32 hash, uint8 v, bytes32 r, bytes32 s ) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, v, r, s); _throwError(error); return recovered; } /** * @dev Returns an Ethereum Signed Message, created from a `hash`. This * produces hash corresponding to the one signed with the * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] * JSON-RPC method as part of EIP-191. * * See {recover}. */ function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) { // 32 is the length in bytes of hash, // enforced by the type signature above return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash)); } /** * @dev Returns an Ethereum Signed Message, created from `s`. This * produces hash corresponding to the one signed with the * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] * JSON-RPC method as part of EIP-191. * * See {recover}. */ function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) { return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", Strings.toString(s.length), s)); } /** * @dev Returns an Ethereum Signed Typed Data, created from a * `domainSeparator` and a `structHash`. This produces hash corresponding * to the one signed with the * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`] * JSON-RPC method as part of EIP-712. * * See {recover}. */ function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) { return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library AddressUpgradeable { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCall(target, data, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value ) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); require(isContract(target), "Address: call to non-contract"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { require(isContract(target), "Address: static call to non-contract"); (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResult(success, returndata, errorMessage); } /** * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol) pragma solidity ^0.8.0; /** * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified * proxy whose upgrades are fully controlled by the current implementation. */ interface IERC1822ProxiableUpgradeable { /** * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation * address. * * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this * function revert if invoked through a proxy. */ function proxiableUUID() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (proxy/ERC1967/ERC1967Upgrade.sol) pragma solidity ^0.8.2; import "../beacon/IBeaconUpgradeable.sol"; import "../../interfaces/draft-IERC1822Upgradeable.sol"; import "../../utils/AddressUpgradeable.sol"; import "../../utils/StorageSlotUpgradeable.sol"; import "../utils/Initializable.sol"; /** * @dev This abstract contract provides getters and event emitting update functions for * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots. * * _Available since v4.1._ * * @custom:oz-upgrades-unsafe-allow delegatecall */ abstract contract ERC1967UpgradeUpgradeable is Initializable { function __ERC1967Upgrade_init() internal onlyInitializing { } function __ERC1967Upgrade_init_unchained() internal onlyInitializing { } // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1 bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143; /** * @dev Storage slot with the address of the current implementation. * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is * validated in the constructor. */ bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc; /** * @dev Emitted when the implementation is upgraded. */ event Upgraded(address indexed implementation); /** * @dev Returns the current implementation address. */ function _getImplementation() internal view returns (address) { return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value; } /** * @dev Stores a new address in the EIP1967 implementation slot. */ function _setImplementation(address newImplementation) private { require(AddressUpgradeable.isContract(newImplementation), "ERC1967: new implementation is not a contract"); StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; } /** * @dev Perform implementation upgrade * * Emits an {Upgraded} event. */ function _upgradeTo(address newImplementation) internal { _setImplementation(newImplementation); emit Upgraded(newImplementation); } /** * @dev Perform implementation upgrade with additional setup call. * * Emits an {Upgraded} event. */ function _upgradeToAndCall( address newImplementation, bytes memory data, bool forceCall ) internal { _upgradeTo(newImplementation); if (data.length > 0 || forceCall) { _functionDelegateCall(newImplementation, data); } } /** * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call. * * Emits an {Upgraded} event. */ function _upgradeToAndCallUUPS( address newImplementation, bytes memory data, bool forceCall ) internal { // Upgrades from old implementations will perform a rollback test. This test requires the new // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing // this special case will break upgrade paths from old UUPS implementation to new ones. if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) { _setImplementation(newImplementation); } else { try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) { require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID"); } catch { revert("ERC1967Upgrade: new implementation is not UUPS"); } _upgradeToAndCall(newImplementation, data, forceCall); } } /** * @dev Storage slot with the admin of the contract. * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is * validated in the constructor. */ bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103; /** * @dev Emitted when the admin account has changed. */ event AdminChanged(address previousAdmin, address newAdmin); /** * @dev Returns the current admin. */ function _getAdmin() internal view returns (address) { return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value; } /** * @dev Stores a new address in the EIP1967 admin slot. */ function _setAdmin(address newAdmin) private { require(newAdmin != address(0), "ERC1967: new admin is the zero address"); StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin; } /** * @dev Changes the admin of the proxy. * * Emits an {AdminChanged} event. */ function _changeAdmin(address newAdmin) internal { emit AdminChanged(_getAdmin(), newAdmin); _setAdmin(newAdmin); } /** * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy. * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor. */ bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50; /** * @dev Emitted when the beacon is upgraded. */ event BeaconUpgraded(address indexed beacon); /** * @dev Returns the current beacon. */ function _getBeacon() internal view returns (address) { return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value; } /** * @dev Stores a new beacon in the EIP1967 beacon slot. */ function _setBeacon(address newBeacon) private { require(AddressUpgradeable.isContract(newBeacon), "ERC1967: new beacon is not a contract"); require( AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()), "ERC1967: beacon implementation is not a contract" ); StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon; } /** * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that). * * Emits a {BeaconUpgraded} event. */ function _upgradeBeaconToAndCall( address newBeacon, bytes memory data, bool forceCall ) internal { _setBeacon(newBeacon); emit BeaconUpgraded(newBeacon); if (data.length > 0 || forceCall) { _functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data); } } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function _functionDelegateCall(address target, bytes memory data) private returns (bytes memory) { require(AddressUpgradeable.isContract(target), "Address: delegate call to non-contract"); // solhint-disable-next-line avoid-low-level-calls (bool success, bytes memory returndata) = target.delegatecall(data); return AddressUpgradeable.verifyCallResult(success, returndata, "Address: low-level delegate call failed"); } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Context.sol) pragma solidity ^0.8.0; import "../proxy/utils/Initializable.sol"; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract ContextUpgradeable is Initializable { function __Context_init() internal onlyInitializing { } function __Context_init_unchained() internal onlyInitializing { } function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Strings.sol) pragma solidity ^0.8.0; /** * @dev String operations. */ library Strings { bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef"; /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { // Inspired by OraclizeAPI's implementation - MIT licence // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol if (value == 0) { return "0"; } uint256 temp = value; uint256 digits; while (temp != 0) { digits++; temp /= 10; } bytes memory buffer = new bytes(digits); while (value != 0) { digits -= 1; buffer[digits] = bytes1(uint8(48 + uint256(value % 10))); value /= 10; } return string(buffer); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { if (value == 0) { return "0x00"; } uint256 temp = value; uint256 length = 0; while (temp != 0) { length++; temp >>= 8; } return toHexString(value, length); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString(uint256 value, uint256 length) internal pure returns (string memory) { bytes memory buffer = new bytes(2 * length + 2); buffer[0] = "0"; buffer[1] = "x"; for (uint256 i = 2 * length + 1; i > 1; --i) { buffer[i] = _HEX_SYMBOLS[value & 0xf]; value >>= 4; } require(value == 0, "Strings: hex length insufficient"); return string(buffer); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (utils/cryptography/ECDSA.sol) pragma solidity ^0.8.0; import "../StringsUpgradeable.sol"; /** * @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations. * * These functions can be used to verify that a message was signed by the holder * of the private keys of a given address. */ library ECDSAUpgradeable { enum RecoverError { NoError, InvalidSignature, InvalidSignatureLength, InvalidSignatureS, InvalidSignatureV } function _throwError(RecoverError error) private pure { if (error == RecoverError.NoError) { return; // no error: do nothing } else if (error == RecoverError.InvalidSignature) { revert("ECDSA: invalid signature"); } else if (error == RecoverError.InvalidSignatureLength) { revert("ECDSA: invalid signature length"); } else if (error == RecoverError.InvalidSignatureS) { revert("ECDSA: invalid signature 's' value"); } else if (error == RecoverError.InvalidSignatureV) { revert("ECDSA: invalid signature 'v' value"); } } /** * @dev Returns the address that signed a hashed message (`hash`) with * `signature` or error string. This address can then be used for verification purposes. * * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures: * this function rejects them by requiring the `s` value to be in the lower * half order, and the `v` value to be either 27 or 28. * * IMPORTANT: `hash` _must_ be the result of a hash operation for the * verification to be secure: it is possible to craft signatures that * recover to arbitrary addresses for non-hashed data. A safe way to ensure * this is by receiving a hash of the original message (which may otherwise * be too long), and then calling {toEthSignedMessageHash} on it. * * Documentation for signature generation: * - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js] * - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers] * * _Available since v4.3._ */ function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) { // Check the signature length // - case 65: r,s,v signature (standard) // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._ if (signature.length == 65) { bytes32 r; bytes32 s; uint8 v; // ecrecover takes the signature parameters, and the only way to get them // currently is to use assembly. assembly { r := mload(add(signature, 0x20)) s := mload(add(signature, 0x40)) v := byte(0, mload(add(signature, 0x60))) } return tryRecover(hash, v, r, s); } else if (signature.length == 64) { bytes32 r; bytes32 vs; // ecrecover takes the signature parameters, and the only way to get them // currently is to use assembly. assembly { r := mload(add(signature, 0x20)) vs := mload(add(signature, 0x40)) } return tryRecover(hash, r, vs); } else { return (address(0), RecoverError.InvalidSignatureLength); } } /** * @dev Returns the address that signed a hashed message (`hash`) with * `signature`. This address can then be used for verification purposes. * * The `ecrecover` EVM opcode allows for malleable (non-unique) signatures: * this function rejects them by requiring the `s` value to be in the lower * half order, and the `v` value to be either 27 or 28. * * IMPORTANT: `hash` _must_ be the result of a hash operation for the * verification to be secure: it is possible to craft signatures that * recover to arbitrary addresses for non-hashed data. A safe way to ensure * this is by receiving a hash of the original message (which may otherwise * be too long), and then calling {toEthSignedMessageHash} on it. */ function recover(bytes32 hash, bytes memory signature) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, signature); _throwError(error); return recovered; } /** * @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately. * * See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures] * * _Available since v4.3._ */ function tryRecover( bytes32 hash, bytes32 r, bytes32 vs ) internal pure returns (address, RecoverError) { bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff); uint8 v = uint8((uint256(vs) >> 255) + 27); return tryRecover(hash, v, r, s); } /** * @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately. * * _Available since v4.2._ */ function recover( bytes32 hash, bytes32 r, bytes32 vs ) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, r, vs); _throwError(error); return recovered; } /** * @dev Overload of {ECDSA-tryRecover} that receives the `v`, * `r` and `s` signature fields separately. * * _Available since v4.3._ */ function tryRecover( bytes32 hash, uint8 v, bytes32 r, bytes32 s ) internal pure returns (address, RecoverError) { // EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature // unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines // the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most // signatures from current libraries generate a unique signature with an s-value in the lower half order. // // If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value // with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or // vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept // these malleable signatures as well. if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) { return (address(0), RecoverError.InvalidSignatureS); } if (v != 27 && v != 28) { return (address(0), RecoverError.InvalidSignatureV); } // If the signature is valid (and not malleable), return the signer address address signer = ecrecover(hash, v, r, s); if (signer == address(0)) { return (address(0), RecoverError.InvalidSignature); } return (signer, RecoverError.NoError); } /** * @dev Overload of {ECDSA-recover} that receives the `v`, * `r` and `s` signature fields separately. */ function recover( bytes32 hash, uint8 v, bytes32 r, bytes32 s ) internal pure returns (address) { (address recovered, RecoverError error) = tryRecover(hash, v, r, s); _throwError(error); return recovered; } /** * @dev Returns an Ethereum Signed Message, created from a `hash`. This * produces hash corresponding to the one signed with the * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] * JSON-RPC method as part of EIP-191. * * See {recover}. */ function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) { // 32 is the length in bytes of hash, // enforced by the type signature above return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash)); } /** * @dev Returns an Ethereum Signed Message, created from `s`. This * produces hash corresponding to the one signed with the * https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] * JSON-RPC method as part of EIP-191. * * See {recover}. */ function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) { return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", StringsUpgradeable.toString(s.length), s)); } /** * @dev Returns an Ethereum Signed Typed Data, created from a * `domainSeparator` and a `structHash`. This produces hash corresponding * to the one signed with the * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`] * JSON-RPC method as part of EIP-712. * * See {recover}. */ function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) { return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol) pragma solidity ^0.8.0; /** * @dev This is the interface that {BeaconProxy} expects of its beacon. */ interface IBeaconUpgradeable { /** * @dev Must return an address that can be used as a delegate call target. * * {BeaconProxy} will check that this address is a contract. */ function implementation() external view returns (address); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/StorageSlot.sol) pragma solidity ^0.8.0; /** * @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: * ``` * 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(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract"); * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; * } * } * ``` * * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._ */ library StorageSlotUpgradeable { struct AddressSlot { address value; } struct BooleanSlot { bool value; } struct Bytes32Slot { bytes32 value; } struct Uint256Slot { uint256 value; } /** * @dev Returns an `AddressSlot` with member `value` located at `slot`. */ function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) { assembly { r.slot := slot } } /** * @dev Returns an `BooleanSlot` with member `value` located at `slot`. */ function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) { assembly { r.slot := slot } } /** * @dev Returns an `Bytes32Slot` with member `value` located at `slot`. */ function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) { assembly { r.slot := slot } } /** * @dev Returns an `Uint256Slot` with member `value` located at `slot`. */ function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) { assembly { r.slot := slot } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Strings.sol) pragma solidity ^0.8.0; /** * @dev String operations. */ library StringsUpgradeable { bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef"; /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { // Inspired by OraclizeAPI's implementation - MIT licence // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol if (value == 0) { return "0"; } uint256 temp = value; uint256 digits; while (temp != 0) { digits++; temp /= 10; } bytes memory buffer = new bytes(digits); while (value != 0) { digits -= 1; buffer[digits] = bytes1(uint8(48 + uint256(value % 10))); value /= 10; } return string(buffer); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { if (value == 0) { return "0x00"; } uint256 temp = value; uint256 length = 0; while (temp != 0) { length++; temp >>= 8; } return toHexString(value, length); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString(uint256 value, uint256 length) internal pure returns (string memory) { bytes memory buffer = new bytes(2 * length + 2); buffer[0] = "0"; buffer[1] = "x"; for (uint256 i = 2 * length + 1; i > 1; --i) { buffer[i] = _HEX_SYMBOLS[value & 0xf]; value >>= 4; } require(value == 0, "Strings: hex length insufficient"); return string(buffer); } }
{ "evmVersion": "paris", "optimizer": { "enabled": true, "mode": "3" }, "outputSelection": { "*": { "*": [ "abi", "metadata" ], "": [ "ast" ] } }, "detectMissingLibraries": false, "forceEVMLA": false, "enableEraVMExtensions": true, "libraries": {} }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[],"name":"InvalidSigner","type":"error"},{"inputs":[{"internalType":"string","name":"nonce","type":"string"}],"name":"NonceAlreadyUsed","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"previousAdmin","type":"address"},{"indexed":false,"internalType":"address","name":"newAdmin","type":"address"}],"name":"AdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"backendSigner","type":"address"}],"name":"BackendSignerSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"beacon","type":"address"}],"name":"BeaconUpgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"player","type":"address"},{"indexed":false,"internalType":"uint256","name":"previousScore","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"newScore","type":"uint256"}],"name":"NewCrewScore","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"player","type":"address"},{"indexed":false,"internalType":"uint256","name":"previousHighScore","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"newHighScore","type":"uint256"}],"name":"NewHighScore","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"player","type":"address"},{"indexed":false,"internalType":"uint256","name":"previousScore","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"newScore","type":"uint256"}],"name":"NewTotalScore","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"inputs":[],"name":"backendSigner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"crewScore","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"address","name":"player","type":"address"},{"internalType":"uint256","name":"totalScore","type":"uint256"},{"internalType":"uint256","name":"highScore","type":"uint256"},{"internalType":"uint256","name":"crewScore","type":"uint256"},{"internalType":"string","name":"nonce","type":"string"}],"internalType":"struct PepenadeCrush.ScoreMessage","name":"message","type":"tuple"},{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"getSigner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"highScore","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_backendSigner","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"address","name":"player","type":"address"},{"internalType":"uint256","name":"totalScore","type":"uint256"},{"internalType":"uint256","name":"highScore","type":"uint256"},{"internalType":"uint256","name":"crewScore","type":"uint256"},{"internalType":"string","name":"nonce","type":"string"}],"internalType":"struct PepenadeCrush.ScoreMessage","name":"message","type":"tuple"},{"internalType":"bytes32","name":"encodedMessage","type":"bytes32"}],"name":"isMessageEncodingValid","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"","type":"string"}],"name":"nonces","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"proxiableUUID","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_backendSigner","type":"address"}],"name":"setBackendSigner","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"totalScore","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"address","name":"player","type":"address"},{"internalType":"uint256","name":"totalScore","type":"uint256"},{"internalType":"uint256","name":"highScore","type":"uint256"},{"internalType":"uint256","name":"crewScore","type":"uint256"},{"internalType":"string","name":"nonce","type":"string"}],"internalType":"struct PepenadeCrush.ScoreMessage","name":"message","type":"tuple"},{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"updateScore","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"}],"name":"upgradeTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"upgradeToAndCall","outputs":[],"stateMutability":"payable","type":"function"}]
Contract Creation Code
9c4d535b00000000000000000000000000000000000000000000000000000000000000000100036b75d9d0d57734a896920f0586b121e13f294bda207de59eca67d2cf1500000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x0003000000000002000a0000000000020000006003100270000002f9033001970002000000310355000100000001035500000001002001900000002e0000c13d0000008002000039000000400020043f000000040030008c000003830000413d000000000401043b000000e004400270000002fb0040009c0000003d0000213d000003070040009c000000570000213d0000030d0040009c000000990000213d000003100040009c000002ed0000613d000003110040009c000003830000c13d000000240030008c000003830000413d0000000002000416000000000002004b000003830000c13d0000000401100370000000000101043b000600000001001d000003140010009c000003830000213d000000cb01000039000000000101041a00000314011001970000000002000411000000000021004b000000000100003900000001010060390bde09950000040f00000006010000290bde09b50000040f000000000100001900000bdf0001042e000000a001000039000000400010043f0000000001000416000000000001004b000003830000c13d0000000001000410000000800010043f000001400000044300000160001004430000002001000039000001000010044300000001010000390000012000100443000002fa0100004100000bdf0001042e000002fc0040009c000000760000213d000003020040009c000000bc0000213d000003050040009c0000030e0000613d000003060040009c000003830000c13d000000240030008c000003830000413d0000000002000416000000000002004b000003830000c13d0000000401100370000000000101043b000003120010009c000003830000213d000000040110003900000000020300190bde08100000040f0bde09700000040f000000000101041a000000ff001001900000000001000039000000010100c039000003200000013d000003080040009c000001560000213d0000030b0040009c000003270000613d0000030c0040009c000003830000c13d0000000001000416000000000001004b000003830000c13d000000cb01000039000000000201041a00000314052001970000000003000411000000000035004b000003990000c13d0000033b02200197000000000021041b0000000001000414000002f90010009c000002f901008041000000c00110021000000316011001c70000800d0200003900000003030000390000033c0400004100000000060000190bde0bcf0000040f0000000100200190000003830000613d000000000100001900000bdf0001042e000002fd0040009c0000015f0000213d000003000040009c000003300000613d000003010040009c000003830000c13d000000440030008c000003830000413d0000000002000416000000000002004b000003830000c13d0000000401100370000000000101043b000003120010009c000003830000213d000000040110003900000000020300190bde085a0000040f0bde09e40000040f000600000001001d0bde0a4f0000040f00000006020000290bde0a940000040f00000024020000390000000102200367000000000202043b000500000002001d000600000001001d0bde0a4f0000040f00000005020000290bde0a940000040f000000060010006b00000000010000390000000101006039000003200000013d0000030e0040009c0000033c0000613d0000030f0040009c000003830000c13d0000000001000416000000000001004b000003830000c13d000003470100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000002f90010009c000002f901008041000000c00110021000000348011001c700008005020000390bde0bd40000040f0000000100200190000005da0000613d000000400300043d000002f90030009c000002f90200004100000000020340190000004002200210000000000101043b00000314011001970000000004000410000000000014004b000003a20000c13d0000034b01000041000000000013043500000334012001c700000bdf0001042e000003030040009c0000035b0000613d000003040040009c000003830000c13d000000240030008c000003830000413d0000000003000416000000000003004b000003830000c13d0000000401100370000000000101043b000600000001001d000003140010009c000003830000213d000000000100041a0000ff0003100190000003b20000c13d000000ff00100190000003fd0000c13d000500000003001d0000033a0110019700000101011001bf000000000010041b00000000010004110000031406100197000000cb01000039000000000201041a0000033b03200197000000000363019f000000000031041b00000000010004140000031405200197000002f90010009c000002f901008041000000c00110021000000316011001c70000800d0200003900000003030000390000033c040000410bde0bcf0000040f0000000100200190000003830000613d000000400100043d0000033d0010009c000003550000213d0000004002100039000000400020043f0000000d0200003900000000022104360000033e030000410000000000320435000000400400043d0000033d0040009c000003550000213d0000004003400039000000400030043f0000000103000039000400000004001d00000000043404360000033f03000041000300000004001d0000000000340435000000000300041a0000ff0000300190000003c60000613d000002f90020009c000002f90200804100000040022002100000000001010433000002f90010009c000002f9010080410000006001100210000000000121019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d0000000302000029000002f90020009c000002f902008041000000400220021000000004030000290000000003030433000002f90030009c000002f9030080410000006003300210000000000223019f000000000101043b000400000001001d0000000001000414000002f90010009c000002f901008041000000c001100210000000000121019f00000316011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d000000000101043b00000065020000390000000403000029000000000032041b0000006602000039000000000012041b000000fd01000039000000000201041a0000033b022001970000000603000029000000000232019f000000000021041b000000400100043d0000000000310435000002f90010009c000002f90100804100000040011002100000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000340011001c70000800d02000039000000010300003900000341040000410bde0bcf0000040f0000000100200190000003830000613d000000050000006b000000740000c13d000000000200041a0000035f01200197000000000010041b000000400100043d00000001030000390000000000310435000002f90010009c000002f90100804100000040011002100000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000340011001c70000800d020000390000034204000041000000710000013d000003090040009c000003670000613d0000030a0040009c000003830000c13d0000000001000416000000000001004b000003830000c13d000000cb010000390000032b0000013d000002fe0040009c0000037a0000613d000002ff0040009c000003830000c13d000000440030008c000003830000413d0000000002000416000000000002004b000003830000c13d0000000402100370000000000202043b000003120020009c000003830000213d00000004022000390000000004230049000003130040009c000003830000213d000000a00040008c000003830000413d0000012004000039000000400040043f000000000521034f000000000505043b000003140050009c000003830000213d000000800050043f0000002005200039000000000551034f000000000505043b000000a00050043f0000004005200039000000000551034f000000000505043b000000c00050043f0000006005200039000000000551034f000000000505043b000000e00050043f0000008005200039000000000551034f000000000505043b000003120050009c000003830000213d00000000062500190000001f02600039000000000032004b000003830000813d000000000261034f000000000502043b000003120050009c000003550000213d0000001f0750003900000360077001970000003f077000390000036007700197000003150070009c000003550000213d00000020066000390000012007700039000000400070043f000001200050043f0000000007650019000000000037004b000003830000213d000000000761034f00000360085001980000001f0950018f0000014006800039000001aa0000613d000001400a000039000000000b07034f00000000bc0b043c000000000aca043600000000006a004b000001a60000c13d000000000009004b000001b70000613d000000000787034f0000000308900210000000000906043300000000098901cf000000000989022f000000000707043b0000010008800089000000000787022f00000000078701cf000000000797019f000000000076043500000140055000390000000000050435000001000040043f0000002404100370000000000504043b000003120050009c000003830000213d0000002304500039000000000034004b000003830000813d0000000406500039000000000461034f000000000404043b000003120040009c000003550000213d0000001f0740003900000360077001970000003f077000390000036007700197000000400800043d0000000007780019000600000008001d000000000087004b00000000080000390000000108004039000003120070009c000003550000213d0000000100800190000003550000c13d0000002405500039000000400070043f00000006070000290000000007470436000500000007001d0000000005540019000000000035004b000003830000213d0000002003600039000000000331034f00000360024001980000001f0540018f0000000501200029000001e80000613d000000000603034f0000000507000029000000006806043c0000000007870436000000000017004b000001e40000c13d000000000005004b000001f50000613d000000000223034f0000000303500210000000000501043300000000053501cf000000000535022f000000000202043b0000010003300089000000000232022f00000000023201cf000000000252019f000000000021043500000005014000290000000000010435000001000100043d0000002002100039000002f90020009c000002f90200804100000040022002100000000001010433000002f90010009c000002f9010080410000006001100210000000000121019f000000e00200043d000100000002001d000000c00200043d000200000002001d000000a00200043d000300000002001d000000800200043d000400000002001d0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d000000000201043b000000400100043d000000c0031000390000000000230435000000a002100039000000010300002900000000003204350000008002100039000000020300002900000000003204350000006002100039000000030300002900000000003204350000000402000029000003140220019700000040031000390000000000230435000000200210003900000317030000410000000000320435000000c0030000390000000000310435000003180010009c000003550000213d000000e003100039000000400030043f000002f90020009c000002f90200804100000040022002100000000001010433000002f90010009c000002f9010080410000006001100210000000000121019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d000000000101043b000200000001001d0000006501000039000000000101041a0000006602000039000000000202041a000000400400043d0000006003400039000000000023043500000040024000390000000000120435000400000004001d00000020024000390000031901000041000300000002001d00000000001204350000031a0100004100000000001004430000000001000414000002f90010009c000002f901008041000000c0011002100000031b011001c70000800b020000390bde0bd40000040f0000000100200190000005da0000613d000000000101043b0000000404000029000000a0024000390000000003000410000000000032043500000080024000390000000000120435000000a00100003900000000001404350000031c0040009c000003550000213d0000000402000029000000c001200039000000400010043f0000000301000029000002f90010009c000002f90100804100000040011002100000000002020433000002f90020009c000002f9020080410000006002200210000000000112019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d000000000301043b000000400100043d00000042021000390000000204000029000000000042043500000020021000390000031d04000041000000000042043500000022041000390000000000340435000000420300003900000000003104350000031e0010009c000003550000213d0000008003100039000000400030043f000002f90020009c000002f90200804100000040022002100000000001010433000002f90010009c000002f9010080410000006001100210000000000121019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d000000000101043b00000006020000290000000002020433000000410020008c000006ac0000613d000000400020008c000006bb0000c13d00000006020000290000004002200039000000000202043300000313032001970000031f0030009c000006b10000213d00000005040000290000000004040433000000400500043d0000006006500039000000000036043500000040035000390000000000430435000000ff022002700000001b02200039000000200350003900000000002304350000000000150435000000000000043f000002f90050009c000002f90500804100000040015002100000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000320011001c700000001020000390bde0bd40000040f0000006003100270000002f903300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000002d00000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000002cc0000c13d000000000005004b000002dd0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000000000003001f00020000000103550000000100200190000007030000c13d0000001f0530018f0000032106300198000000400200043d0000000004620019000007f10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000002e80000c13d000007f10000013d000000240030008c000003830000413d0000000002000416000000000002004b000003830000c13d0000000401100370000000000101043b000600000001001d000003140010009c000003830000213d000003470100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000002f90010009c000002f901008041000000c00110021000000348011001c700008005020000390bde0bd40000040f0000000100200190000005da0000613d000000000101043b00000314011001970000000002000410000000000012004b000003d00000c13d000000400100043d00000064021000390000035e03000041000004670000013d0000000001000416000000000001004b000003830000c13d00000000010300190bde08c90000040f000600000002001d0bde09e40000040f000500000001001d0bde0a4f0000040f00000005020000290bde0a940000040f00000006020000290bde0abe0000040f000600000001001d00000000010200190bde0b750000040f00000006010000290000031401100197000000400200043d0000000000120435000002f90020009c000002f902008041000000400120021000000334011001c700000bdf0001042e0000000001000416000000000001004b000003830000c13d000000fd01000039000000000101041a0000031401100197000000800010043f000003350100004100000bdf0001042e000000240030008c000003830000413d0000000002000416000000000002004b000003830000c13d0000000401100370000000000101043b000003140010009c000003830000213d000000000010043f0000010001000039000003720000013d000000440030008c000003830000413d0000000402100370000000000202043b000600000002001d000003140020009c000003830000213d0000002402100370000000000402043b000003120040009c000003830000213d0000002302400039000000000032004b000003830000813d0000000405400039000000000251034f000000000202043b000003120020009c000003550000213d0000001f0620003900000360066001970000003f0660003900000360066001970000031e0060009c000004100000a13d0000035c01000041000000000010043f0000004101000039000000040010043f0000035d0100004100000be000010430000000240030008c000003830000413d0000000002000416000000000002004b000003830000c13d0000000401100370000000000101043b000003140010009c000003830000213d000000000010043f000000ff01000039000003720000013d000000240030008c000003830000413d0000000002000416000000000002004b000003830000c13d0000000401100370000000000101043b000003140010009c000003830000213d000000000010043f000000fe01000039000000200010043f000000400200003900000000010000190bde0bba0000040f000000000101041a000000800010043f000003350100004100000bdf0001042e000000240030008c000003830000413d0000000002000416000000000002004b000003830000c13d0000000401100370000000000101043b000003140010009c000003850000a13d000000000100001900000be000010430000000cb02000039000000000202041a00000314022001970000000003000411000000000032004b000003990000c13d000000000001004b000003f90000c13d0000032401000041000000800010043f0000002001000039000000840010043f0000002601000039000000a40010043f0000033101000041000000c40010043f0000033201000041000000e40010043f000003330100004100000be0000104300000032401000041000000800010043f0000002001000039000000840010043f000000a40010043f0000034501000041000000c40010043f000003460100004100000be00001043000000064013000390000034904000041000000000041043500000044013000390000034a0400004100000000004104350000002401300039000000380400003900000000004104350000032401000041000000000013043500000004013000390000002003000039000000000031043500000325012001c700000be000010430000500000003001d00000336010000410000000000100443000000000100041000000004001004430000000001000414000002f90010009c000002f901008041000000c00110021000000337011001c700008002020000390bde0bd40000040f0000000100200190000005da0000613d000000000101043b000000000001004b000003fc0000c13d000000000100041a0000ff0000100190000000d30000c13d000000400100043d00000064021000390000034303000041000000000032043500000044021000390000034403000041000000000032043500000024021000390000002b030000390000046d0000013d0000034b02000041000000000202041a0000031402200197000000000012004b000004640000c13d000000400300043d000000cb01000039000000000101041a00000314011001970000000002000411000000000021004b000004780000c13d000003590030009c000003550000813d0000002001300039000200000001001d000000400010043f000300000003001d00000000000304350000000001000415000400000001001d0000034c01000041000000000101041a000000ff00100190000004870000c13d000000400200043d0000034d01000041000500000002001d000000000012043500000000010004140000000602000029000000040020008c000004a10000c13d00000000050004150000000a0550008a00000005055002100000000003000031000000200030008c00000020040000390000000004034019000004cf0000013d0bde09cf0000040f000000000100001900000bdf0001042e000000400200043d00000064012000390000033803000041000000000031043500000044012000390000033903000041000000000031043500000024012000390000002e03000039000000000031043500000324010000410000000000120435000000040120003900000020030000390000000000310435000002f90020009c000002f902008041000000400120021000000325011001c700000be00001043000000024044000390000008006600039000000400060043f000000800020043f0000000004420019000000000034004b000003830000213d0000002003500039000000000331034f00000360042001980000001f0520018f000000a001400039000004230000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b0000041f0000c13d000000000005004b000004300000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a0012000390000000000010435000003470100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000002f90010009c000002f901008041000000c00110021000000348011001c700008005020000390bde0bd40000040f0000000100200190000005da0000613d000000000101043b00000314011001970000000002000410000000000012004b0000030a0000613d0000034b02000041000000000202041a0000031402200197000000000012004b000004640000c13d000000cb01000039000000000101041a00000314011001970000000002000411000000000021004b0000052d0000c13d0000034c01000041000000000101041a000000ff00100190000005470000c13d000000400200043d0000034d01000041000500000002001d000000000012043500000000010004140000000602000029000000040020008c0000055e0000c13d0000000005000415000000080550008a00000005055002100000000003000031000000200030008c000000200400003900000000040340190000058c0000013d000000400100043d00000064021000390000035703000041000000000032043500000044021000390000035803000041000000000032043500000024021000390000002c03000039000000000032043500000324020000410000000000210435000000040210003900000020030000390000000000320435000002f90010009c000002f901008041000000400110021000000325011001c700000be0000104300000004401300039000003450200004100000000002104350000032401000041000000000013043500000024013000390000002002000039000000000021043500000004013000390000000000210435000002f90030009c000002f90300804100000040013002100000032e011001c700000be00001043000000336010000410000000000100443000000060100002900000004001004430000000001000414000002f90010009c000002f901008041000000c00110021000000337011001c700008002020000390bde0bd40000040f0000000100200190000005da0000613d000000000101043b000000000001004b0000053d0000c13d000000400100043d00000064021000390000035a03000041000000000032043500000044021000390000035b03000041000000000032043500000024021000390000002d030000390000046d0000013d0000000502000029000002f90020009c000002f9020080410000004002200210000002f90010009c000002f901008041000000c001100210000000000121019f00000327011001c700000006020000290bde0bd40000040f0000006003100270000002f903300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000505700029000004bb0000613d000000000801034f0000000509000029000000008a08043c0000000009a90436000000000059004b000004b70000c13d000000000006004b000004c80000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000000003001f00020000000103550000000005000415000000090550008a00000005055002100000000100200190000005db0000613d0000001f01400039000000600210018f0000000501200029000000000021004b00000000020000390000000102004039000003120010009c000003550000213d0000000100200190000003550000c13d000000400010043f000000200030008c000003830000413d000000050200002900000000020204330000000503500270000000000302001f0000034b0020009c000005eb0000c13d00000336010000410000000000100443000000060100002900000004001004430000000001000414000002f90010009c000002f901008041000000c00110021000000337011001c700008002020000390bde0bd40000040f0000000100200190000005da0000613d000000000101043b000000000001004b000004970000613d0000034b01000041000000000201041a0000033b022001970000000605000029000000000252019f000000000021041b000000400100043d000500000001001d0000000001000414000002f90010009c000002f901008041000000c00110021000000316011001c70000800d02000039000000020300003900000350040000410bde0bcf0000040f0000000100200190000003830000613d00000003010000290000000001010433000000000001004b000005420000613d00000336010000410000000000100443000000060100002900000004001004430000000001000414000002f90010009c000002f901008041000000c00110021000000337011001c700008002020000390bde0bd40000040f0000000100200190000005da0000613d000000000101043b000000000001004b000005f40000c13d000000050300002900000064013000390000035502000041000000000021043500000044013000390000035602000041000000000021043500000024013000390000002602000039000000000021043500000324010000410000000000130435000000040130003900000020020000390000000000210435000002f90030009c000002f903008041000000400130021000000325011001c700000be000010430000000400100043d0000004402100039000003450300004100000000003204350000032402000041000000000021043500000024021000390000002003000039000000000032043500000004021000390000000000320435000002f90010009c000002f90100804100000040011002100000032e011001c700000be0000104300000034b01000041000000000201041a0000033b0220019700000006022001af000000000021041b000000000100041500000004011000690000000001000002000000000100001900000bdf0001042e00000336010000410000000000100443000000060100002900000004001004430000000001000414000002f90010009c000002f901008041000000c00110021000000337011001c700008002020000390bde0bd40000040f0000000100200190000005da0000613d000000000101043b000000000001004b000004970000613d0000034b01000041000000000201041a0000033b0220019700000006022001af000000000021041b000000000100001900000bdf0001042e0000000502000029000002f90020009c000002f9020080410000004002200210000002f90010009c000002f901008041000000c001100210000000000121019f00000327011001c700000006020000290bde0bd40000040f0000006003100270000002f903300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000505700029000005780000613d000000000801034f0000000509000029000000008a08043c0000000009a90436000000000059004b000005740000c13d000000000006004b000005850000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000000003001f00020000000103550000000005000415000000070550008a00000005055002100000000100200190000005db0000613d0000001f01400039000000600210018f0000000501200029000000000021004b00000000020000390000000102004039000003120010009c000003550000213d0000000100200190000003550000c13d000000400010043f000000200030008c000003830000413d000000050200002900000000020204330000000503500270000000000302001f0000034b0020009c000005eb0000c13d00000336010000410000000000100443000000060100002900000004001004430000000001000414000002f90010009c000002f901008041000000c00110021000000337011001c700008002020000390bde0bd40000040f0000000100200190000005da0000613d000000000101043b000000000001004b000004970000613d0000034b01000041000000000201041a0000033b022001970000000605000029000000000252019f000000000021041b000000400100043d000500000001001d0000000001000414000002f90010009c000002f901008041000000c00110021000000316011001c70000800d02000039000000020300003900000350040000410bde0bcf0000040f0000000100200190000003830000613d00000336010000410000000000100443000000060100002900000004001004430000000001000414000002f90010009c000002f901008041000000c00110021000000337011001c700008002020000390bde0bd40000040f0000000100200190000005da0000613d000000000101043b000000000001004b000005190000613d000000800200043d00000000010004140000000603000029000000040030008c000006570000c13d00000001030000390000000002000031000006660000013d000000000001042f000000400200043d000600000002001d0000032401000041000000000012043500000004012000390bde09a80000040f00000006020000290000000001210049000002f90010009c000002f9010080410000006001100210000002f90020009c000002f9020080410000004002200210000000000121019f00000be00001043000000064021000390000034e03000041000000000032043500000044021000390000034f030000410000000000320435000000240210003900000029030000390000046d0000013d0000000301000029000000000201043300000000010004140000000603000029000000040030008c000005fd0000c13d00000001030000390000000002000031000006100000013d0000000203000029000002f90030009c000002f9030080410000004003300210000002f90020009c000002f9020080410000006002200210000000000232019f000002f90010009c000002f901008041000000c001100210000000000112019f00000006020000290bde0bd90000040f000000010320018f00020000000103550000006001100270000002f90010019d000002f902100197000000000002004b0000062d0000c13d00000060010000390000008004000039000000400200043d000003520020009c000003550000213d0000006005200039000000400050043f00000040052000390000035306000041000000000065043500000020052000390000035406000041000000000065043500000027050000390000000000520435000000000003004b000005420000c13d0000000001010433000000000001004b000006a40000c13d000000400300043d000600000003001d0000032401000041000000000013043500000004013000390bde0a3a0000040f000005e10000013d000003120020009c000003550000213d0000001f0120003900000360011001970000003f011000390000036004100197000000400100043d0000000004410019000000000014004b00000000060000390000000106004039000003120040009c000003550000213d0000000100600190000003550000c13d000000400040043f000000000421043600000360052001980000001f0620018f00000000025400190000000207000367000006490000613d000000000807034f0000000009040019000000008a08043c0000000009a90436000000000029004b000006450000c13d000000000006004b000006140000613d000000000557034f0000000306600210000000000702043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f0000000000520435000006140000013d000002f90020009c000002f9020080410000006002200210000002f90010009c000002f901008041000000c001100210000000000121019f00000351011001c700000006020000290bde0bd90000040f000000010320018f00020000000103550000006001100270000002f90010019d000002f902100197000000000002004b0000067a0000c13d00000060010000390000008004000039000000400200043d000003520020009c000003550000213d0000006005200039000000400050043f00000040052000390000035306000041000000000065043500000020052000390000035406000041000000000065043500000027050000390000000000520435000000000003004b000000740000c13d000006230000013d000003120020009c000003550000213d0000001f0120003900000360011001970000003f011000390000036004100197000000400100043d0000000004410019000000000014004b00000000050000390000000105004039000003120040009c000003550000213d0000000100500190000003550000c13d000000400040043f000000000421043600000360052001980000001f0620018f00000000025400190000000207000367000006960000613d000000000807034f0000000009040019000000008a08043c0000000009a90436000000000029004b000006920000c13d000000000006004b0000066a0000613d000000000557034f0000000306600210000000000702043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f00000000005204350000066a0000013d000002f90040009c000002f9040080410000004002400210000002f90010009c000002f9010080410000006001100210000000000121019f00000be0000104300000000602000029000000400220003900000000030204330000031f0030009c000006c70000a13d000000400100043d00000064021000390000032203000041000000000032043500000044021000390000032f030000410000000000320435000000240210003900000022030000390000046d0000013d000000400100043d00000044021000390000033003000041000000000032043500000024021000390000001f0300003900000000003204350000032402000041000000000021043500000004021000390000002003000039000005370000013d000000060200002900000060022000390000000002020433000000f804200270000000400200043d0000001b0540008a000000010050008c0000070d0000213d000000050500002900000000050504330000006006200039000000000036043500000040032000390000000000530435000000200320003900000000004304350000000000120435000000000000043f000002f90020009c000002f90200804100000040012002100000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000320011001c700000001020000390bde0bd40000040f0000006003100270000002f903300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000006f20000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000006ee0000c13d000000000005004b000006ff0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000000000003001f00020000000103550000000100200190000007e60000613d000000000100043d0000031400100198000007160000c13d000000400100043d00000044021000390000032d03000041000000000032043500000024021000390000001803000039000006c10000013d00000064012000390000032203000041000000000031043500000044012000390000032303000041000000000031043500000024012000390000002203000039000004050000013d000000fd02000039000000000202041a000000000112013f0000031400100198000008040000c13d000000400100043d000001000200043d0000002006200039000500000002001d0000000002020433000000000002004b0000072a0000613d000000000300001900000000041300190000000005630019000000000505043300000000005404350000002003300039000000000023004b000007230000413d000600000006001d000000000312001900000101040000390000000000430435000002f90010009c000002f90100804100000040011002100000002002200039000002f90020009c000002f9020080410000006002200210000000000112019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d000000400500043d000000000101043b000000000101041a000000ff00100190000008080000c13d00000005010000290000000001010433000000000001004b000007510000613d000000000200001900000000035200190000000604200029000000000404043300000000004304350000002002200039000000000012004b0000074a0000413d000000000251001900000101030000390000000000320435000002f90050009c000002f90500804100000040025002100000002001100039000002f90010009c000002f9010080410000006001100210000000000121019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d000000000101043b000000000201041a000003610220019700000001022001bf000000000021041b000000800100043d0000031401100197000000e00200043d000300000002001d000000c00200043d000400000002001d000000a00200043d000500000002001d000600000001001d000000000010043f000000fe01000039000000200010043f0000000001000414000002f90010009c000002f901008041000000c00110021000000329011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d000000000201043b000000000102041a000000050010006c0000079a0000813d0000000504000029000000000042041b000000400200043d000000200320003900000000004304350000000000120435000002f90020009c000002f90200804100000040012002100000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000329011001c70000800d0200003900000002030000390000032a0400004100000006050000290bde0bcf0000040f0000000100200190000003830000613d0000000601000029000000000010043f000000ff01000039000000200010043f0000000001000414000002f90010009c000002f901008041000000c00110021000000329011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d000000000201043b000000000102041a000000040010006c000007c10000813d0000000404000029000000000042041b000000400200043d000000200320003900000000004304350000000000120435000002f90020009c000002f90200804100000040012002100000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000329011001c70000800d0200003900000002030000390000032b0400004100000006050000290bde0bcf0000040f0000000100200190000003830000613d0000000601000029000000000010043f0000010001000039000000200010043f0000000001000414000002f90010009c000002f901008041000000c00110021000000329011001c700008010020000390bde0bd40000040f0000000100200190000003830000613d000000000201043b000000000102041a000000030010006c000000740000813d0000000304000029000000000042041b000000400200043d000000200320003900000000004304350000000000120435000002f90020009c000002f90200804100000040012002100000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000329011001c70000800d0200003900000002030000390000032c040000410000000605000029000000710000013d0000001f0530018f0000032106300198000000400200043d0000000004620019000007f10000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000007ed0000c13d000000000005004b000007fe0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000002f90020009c000002f9020080410000004002200210000000000112019f00000be0000104300000032601000041000000000010043f000003270100004100000be0000104300000032801000041000400000005001d0000000000150435000000040150003900000005020000290bde0a3a0000040f0000000402000029000005e20000013d00000000030100190000001f01100039000000000021004b0000000004000019000003620400404100000362052001970000036201100197000000000651013f000000000051004b00000000010000190000036201002041000003620060009c000000000104c019000000000001004b000008580000613d0000000105000367000000000135034f000000000401043b000003630040009c000008520000813d0000001f0140003900000360011001970000003f011000390000036007100197000000400100043d0000000007710019000000000017004b00000000080000390000000108004039000003120070009c000008520000213d0000000100800190000008520000c13d0000002008300039000000400070043f00000000034104360000000007840019000000000027004b000008580000213d000000000585034f00000360064001980000001f0740018f0000000002630019000008420000613d000000000805034f0000000009030019000000008a08043c0000000009a90436000000000029004b0000083e0000c13d000000000007004b0000084f0000613d000000000565034f0000000306700210000000000702043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f000000000052043500000000024300190000000000020435000000000001042d0000035c01000041000000000010043f0000004101000039000000040010043f0000035d0100004100000be000010430000000000100001900000be00001043000000000030100190000000001120049000003130010009c000008c10000213d0000009f0010008c000008c10000a13d000000400100043d000003640010009c000008c30000813d000000a004100039000000400040043f0000000104000367000000000534034f000000000505043b000003140050009c000008c10000213d00000000055104360000002006300039000000000664034f000000000606043b00000000006504350000004005300039000000000554034f000000000505043b000000400610003900000000005604350000006005300039000000000554034f000000000505043b000000600610003900000000005604350000008005300039000000000554034f000000000505043b000003120050009c000008c10000213d00000000063500190000001f03600039000000000023004b0000000005000019000003620500804100000362033001970000036207200197000000000873013f000000000073004b00000000030000190000036203004041000003620080009c000000000305c019000000000003004b000008c10000c13d000000000364034f000000000303043b000003120030009c000008c30000213d0000001f0530003900000360055001970000003f055000390000036008500197000000400500043d0000000008850019000000000058004b00000000090000390000000109004039000003120080009c000008c30000213d0000000100900190000008c30000c13d0000002009600039000000400080043f00000000063504360000000008930019000000000028004b000008c10000213d000000000494034f00000360073001980000001f0830018f0000000002760019000008af0000613d000000000904034f000000000a060019000000009b09043c000000000aba043600000000002a004b000008ab0000c13d000000000008004b000008bc0000613d000000000474034f0000000307800210000000000802043300000000087801cf000000000878022f000000000404043b0000010007700089000000000474022f00000000047401cf000000000484019f00000000004204350000000002360019000000000002043500000080021000390000000000520435000000000001042d000000000100001900000be0000104300000035c01000041000000000010043f0000004101000039000000040010043f0000035d0100004100000be000010430000003130010009c000009680000213d0000000003010019000000430010008c000009680000a13d00000001040003670000000401400370000000000101043b000003120010009c000009680000213d00000004021000390000000001230049000003130010009c000009680000213d000000a00010008c000009680000413d000000400100043d000003640010009c0000096a0000813d000000a005100039000000400050043f000000000524034f000000000505043b000003140050009c000009680000213d00000000055104360000002006200039000000000664034f000000000606043b00000000006504350000004005200039000000000554034f000000000505043b000000400610003900000000005604350000006005200039000000000554034f000000000505043b000000600610003900000000005604350000008005200039000000000554034f000000000505043b000003120050009c000009680000213d00000000072500190000001f02700039000000000032004b000009680000813d000000000274034f000000000202043b000003120020009c0000096a0000213d0000001f0620003900000360066001970000003f066000390000036008600197000000400600043d0000000008860019000000000068004b00000000090000390000000109004039000003120080009c0000096a0000213d00000001009001900000096a0000c13d0000002009700039000000400080043f00000000072604360000000008920019000000000038004b000009680000213d000000000994034f000003600a2001980000001f0b20018f0000000008a700190000091c0000613d000000000c09034f000000000d07001900000000ce0c043c000000000ded043600000000008d004b000009180000c13d00000000000b004b000009290000613d0000000009a9034f000000030ab00210000000000b080433000000000bab01cf000000000bab022f000000000909043b000001000aa000890000000009a9022f0000000009a901cf0000000009b9019f000000000098043500000000022700190000000000020435000000800210003900000000006204350000002402400370000000000702043b000003120070009c000009680000213d0000002302700039000000000032004b000009680000813d0000000408700039000000000284034f000000000602043b000003120060009c0000096a0000213d0000001f0260003900000360022001970000003f022000390000036009200197000000400200043d0000000009920019000000000029004b000000000a000039000000010a004039000003120090009c0000096a0000213d0000000100a001900000096a0000c13d000000240a700039000000400090043f00000000076204360000000009a60019000000000039004b000009680000213d0000002003800039000000000434034f00000360056001980000001f0860018f0000000003570019000009580000613d000000000904034f000000000a070019000000009b09043c000000000aba043600000000003a004b000009540000c13d000000000008004b000009650000613d000000000454034f0000000305800210000000000803043300000000085801cf000000000858022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000484019f000000000043043500000000036700190000000000030435000000000001042d000000000100001900000be0000104300000035c01000041000000000010043f0000004101000039000000040010043f0000035d0100004100000be000010430000000400200043d0000000031010434000000000001004b0000097c0000613d000000000400001900000000052400190000000006430019000000000606043300000000006504350000002004400039000000000014004b000009750000413d000000000321001900000101040000390000000000430435000002f90020009c000002f90200804100000040022002100000002001100039000002f90010009c000002f9010080410000006001100210000000000121019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f0000000100200190000009930000613d000000000101043b000000000001042d000000000100001900000be000010430000000000001004b000009980000613d000000000001042d000000400100043d0000004402100039000003450300004100000000003204350000032402000041000000000021043500000024021000390000002003000039000000000032043500000004021000390000000000320435000002f90010009c000002f90100804100000040011002100000032e011001c700000be00001043000000060021000390000036503000041000000000032043500000040021000390000036603000041000000000032043500000020021000390000002e030000390000000000320435000000200200003900000000002104350000008001100039000000000001042d0000031401100197000000fd02000039000000000302041a0000033b03300197000000000313019f000000000032041b000000400200043d0000000000120435000002f90020009c000002f90200804100000040012002100000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000340011001c70000800d02000039000000010300003900000341040000410bde0bcf0000040f0000000100200190000009cd0000613d000000000001042d000000000100001900000be0000104300000031406100197000000cb01000039000000000201041a0000033b03200197000000000363019f000000000031041b00000000010004140000031405200197000002f90010009c000002f901008041000000c00110021000000316011001c70000800d0200003900000003030000390000033c040000410bde0bcf0000040f0000000100200190000009e20000613d000000000001042d000000000100001900000be0000104300004000000000002000000800210003900000000020204330000002003200039000002f90030009c000002f90300804100000040033002100000000002020433000002f90020009c000002f9020080410000006002200210000000000232019f00000060031000390000000003030433000100000003001d00000040031000390000000003030433000200000003001d0000000013010434000400000003001d0000000001010433000300000001001d0000000001000414000002f90010009c000002f901008041000000c001100210000000000121019f00000316011001c700008010020000390bde0bd40000040f000000010020019000000a320000613d000000000201043b000000400100043d000000c0031000390000000000230435000000a002100039000000010300002900000000003204350000008002100039000000020300002900000000003204350000006002100039000000030300002900000000003204350000000402000029000003140220019700000040031000390000000000230435000000200210003900000317030000410000000000320435000000c0030000390000000000310435000003670010009c00000a340000813d000000e003100039000000400030043f000002f90020009c000002f90200804100000040022002100000000001010433000002f90010009c000002f9010080410000006001100210000000000121019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f000000010020019000000a320000613d000000000101043b000000000001042d000000000100001900000be0000104300000035c01000041000000000010043f0000004101000039000000040010043f0000035d0100004100000be00001043000000020030000390000000004310436000000003202043400000000002404350000004001100039000000000002004b00000a490000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b00000a420000413d000000000312001900000000000304350000001f0220003900000360022001970000000001210019000000000001042d00020000000000020000006501000039000000000101041a0000006602000039000000000202041a000000400400043d0000006003400039000000000023043500000040024000390000000000120435000200000004001d00000020024000390000031901000041000100000002001d00000000001204350000031a0100004100000000001004430000000001000414000002f90010009c000002f901008041000000c0011002100000031b011001c70000800b020000390bde0bd40000040f000000010020019000000a8b0000613d000000000101043b0000000204000029000000a0024000390000000003000410000000000032043500000080024000390000000000120435000000a0010000390000000000140435000003680040009c00000a8c0000813d000000c001400039000000400010043f0000000101000029000002f90010009c000002f90100804100000040011002100000000002040433000002f90020009c000002f9020080410000006002200210000000000112019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f000000010020019000000a920000613d000000000101043b000000000001042d000000000001042f0000035c01000041000000000010043f0000004101000039000000040010043f0000035d0100004100000be000010430000000000100001900000be000010430000000400300043d0000004204300039000000000024043500000020023000390000031d0400004100000000004204350000002204300039000000000014043500000042010000390000000000130435000003690030009c00000ab60000813d0000008001300039000000400010043f000002f90020009c000002f90200804100000040012002100000000002030433000002f90020009c000002f9020080410000006002200210000000000112019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f000000010020019000000abc0000613d000000000101043b000000000001042d0000035c01000041000000000010043f0000004101000039000000040010043f0000035d0100004100000be000010430000000000100001900000be0000104300000000034020434000000400040008c00000b0d0000613d000000410040008c00000b150000c13d000000400420003900000000040404330000031f0040009c00000b120000213d00000060022000390000000002020433000000f8022002700000001b0520008a000000010050008c00000b540000213d0000000003030433000000400500043d0000006006500039000000000046043500000040045000390000000000340435000000200350003900000000002304350000000000150435000000000000043f000002f90050009c000002f90500804100000040015002100000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000320011001c700000001020000390bde0bd40000040f0000006003100270000002f903300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000000af00000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00000aec0000c13d000000000005004b00000afd0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000000000003001f0002000000010355000000010020019000000b4e0000c13d0000001f0530018f0000032106300198000000400200043d000000000462001900000b620000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00000b080000c13d00000b620000013d0000004002200039000000000202043300000313042001970000031f0040009c00000b180000a13d00000003020000390000000001000019000000000001042d00000002020000390000000001000019000000000001042d0000000003030433000000400500043d0000006006500039000000000046043500000040045000390000000000340435000000ff022002700000001b02200039000000200350003900000000002304350000000000150435000000000000043f000002f90050009c000002f90500804100000040015002100000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000320011001c700000001020000390bde0bd40000040f0000006003100270000002f903300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000000b3d0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00000b390000c13d000000000005004b00000b4a0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000000000003001f0002000000010355000000010020019000000b570000613d000000000100043d0000031400100198000000000100601900000000020000390000000102006039000000000001042d00000004020000390000000001000019000000000001042d0000001f0530018f0000032106300198000000400200043d000000000462001900000b620000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00000b5e0000c13d000000000005004b00000b6f0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000002f90020009c000002f9020080410000004002200210000000000112019f00000be000010430000000050010008c00000b870000813d000000000001004b00000b7a0000c13d000000000001042d000000010010008c00000b8d0000613d000000020010008c00000b940000613d000000030010008c00000ba50000c13d000000400100043d00000064021000390000032203000041000000000032043500000044021000390000032f0300004100000bab0000013d0000035c01000041000000000010043f0000002101000039000000040010043f0000035d0100004100000be000010430000000400100043d00000044021000390000032d0300004100000000003204350000002402100039000000180300003900000b9a0000013d000000400100043d00000044021000390000033003000041000000000032043500000024021000390000001f03000039000000000032043500000324020000410000000000210435000000040210003900000020030000390000000000320435000002f90010009c000002f90100804100000040011002100000032e011001c700000be000010430000000400100043d00000064021000390000032203000041000000000032043500000044021000390000032303000041000000000032043500000024021000390000002203000039000000000032043500000324020000410000000000210435000000040210003900000020030000390000000000320435000002f90010009c000002f901008041000000400110021000000325011001c700000be000010430000000000001042f000002f90010009c000002f9010080410000004001100210000002f90020009c000002f9020080410000006002200210000000000112019f0000000002000414000002f90020009c000002f902008041000000c002200210000000000112019f00000316011001c700008010020000390bde0bd40000040f000000010020019000000bcd0000613d000000000101043b000000000001042d000000000100001900000be00001043000000bd2002104210000000102000039000000000001042d0000000002000019000000000001042d00000bd7002104230000000102000039000000000001042d0000000002000019000000000001042d00000bdc002104250000000102000039000000000001042d0000000002000019000000000001042d00000bde0000043200000bdf0001042e00000be00001043000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffff000000020000000000000000000000000000008000000100000000000000000000000000000000000000000000000000000000000000000000000000a56740f700000000000000000000000000000000000000000000000000000000c69ad66100000000000000000000000000000000000000000000000000000000f2fde38a00000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000f4bd65bf00000000000000000000000000000000000000000000000000000000c69ad66200000000000000000000000000000000000000000000000000000000f191577c00000000000000000000000000000000000000000000000000000000ba5bf0e600000000000000000000000000000000000000000000000000000000ba5bf0e700000000000000000000000000000000000000000000000000000000c4d66de800000000000000000000000000000000000000000000000000000000a56740f800000000000000000000000000000000000000000000000000000000b24fce880000000000000000000000000000000000000000000000000000000065d65e850000000000000000000000000000000000000000000000000000000084eda6610000000000000000000000000000000000000000000000000000000084eda662000000000000000000000000000000000000000000000000000000008da5cb5b0000000000000000000000000000000000000000000000000000000065d65e8600000000000000000000000000000000000000000000000000000000715018a6000000000000000000000000000000000000000000000000000000004f1ef285000000000000000000000000000000000000000000000000000000004f1ef2860000000000000000000000000000000000000000000000000000000052d1902d000000000000000000000000000000000000000000000000000000003659cfe60000000000000000000000000000000000000000000000000000000036f95670000000000000000000000000000000000000000000000000ffffffffffffffff7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000ffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000fffffffffffffedf02000000000000000000000000000000000000000000000000000000000000005ab4e29c833efafc9412957c7f112699ee4db87ca2de826200080b4773dc19de000000000000000000000000000000000000000000000000ffffffffffffff1f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f9a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b0200000200000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff3f1901000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff7f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffe0756500000000000000000000000000000000000000000000000000000000000045434453413a20696e76616c6964207369676e6174757265202776272076616c08c379a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084000000000000000000000000815e1d64000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000a1f398330000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000400000000000000000000000004941f73fe371eb950eee6a9ad91de5c92be17ab72677bec7e30f06b202451a96ec51f1f19b3cb8ab4176d8a463cb3b7a4bb866380c5ee1c51da9577ad94db00ab248037c79ce93cf8b9329c2435a047d3cb407b3d9729452e8453f1b00e7fb1545434453413a20696e76616c6964207369676e61747572650000000000000000000000000000000000000000000000000000006400000000000000000000000045434453413a20696e76616c6964207369676e6174757265202773272076616c45434453413a20696e76616c6964207369676e6174757265206c656e677468004f776e61626c653a206e6577206f776e657220697320746865207a65726f206164647265737300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084000000800000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000200000008000000000000000001806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000647920696e697469616c697a6564000000000000000000000000000000000000496e697469616c697a61626c653a20636f6e747261637420697320616c726561ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000ffffffffffffffffffffffff00000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0000000000000000000000000000000000000000000000000ffffffffffffffbf506570656e61646543727573680000000000000000000000000000000000000031000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000020000000000000000000000000d1e88985151fc6b7a0cf6b9d009f9878a420330db3463adc53971c69fbd86ed97f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024986e697469616c697a696e67000000000000000000000000000000000000000000496e697469616c697a61626c653a20636f6e7472616374206973206e6f7420694f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65720000000000000000000000000000000000000064000000800000000000000000310ab089e4439a4c15d089f94afb7896ff553aecb10793d0ab882de59d99a32e02000002000000000000000000000000000000440000000000000000000000006c6564207468726f7567682064656c656761746563616c6c0000000000000000555550535570677261646561626c653a206d757374206e6f742062652063616c360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd914352d1902d000000000000000000000000000000000000000000000000000000006961626c6555554944000000000000000000000000000000000000000000000045524331393637557067726164653a20756e737570706f727465642070726f78bc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b0000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000ffffffffffffff9f206661696c656400000000000000000000000000000000000000000000000000416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c6e74726163740000000000000000000000000000000000000000000000000000416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6163746976652070726f7879000000000000000000000000000000000000000046756e6374696f6e206d7573742062652063616c6c6564207468726f75676820000000000000000000000000000000000000000000000000ffffffffffffffe06f74206120636f6e747261637400000000000000000000000000000000000000455243313936373a206e657720696d706c656d656e746174696f6e206973206e4e487b7100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002400000000000000000000000064656c656761746563616c6c0000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000ffffffffffffff606f6e206973206e6f74205555505300000000000000000000000000000000000045524331393637557067726164653a206e657720696d706c656d656e74617469000000000000000000000000000000000000000000000000ffffffffffffff20000000000000000000000000000000000000000000000000ffffffffffffff40000000000000000000000000000000000000000000000000ffffffffffffff80f0953dbc1acb1bb82f3f9528a7d9ca9f6019f89f780d3a4a373854d09af31387
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.