Overview
ETH Balance
0 ETH
ETH Value
$0.00More Info
Private Name Tags
Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
---|---|---|---|---|---|---|---|---|---|
Latest 1 internal transaction
Parent Transaction Hash | Block | From | To | |||
---|---|---|---|---|---|---|
4122568 | 26 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:
WrappedLiquidStakedToken
Compiler Version
v0.8.25+commit.b61c2a91
ZkSolc Version
v1.5.11
Optimization Enabled:
Yes with Mode 3
Other Settings:
paris EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT pragma solidity 0.8.25; import {ILiquidStakingToken} from "./interfaces/ILiquidStakingToken.sol"; import {ERC20PermitUpgradeable, Initializable} from "@openzeppelin/contracts-upgradeable/token/ERC20/extensions/ERC20PermitUpgradeable.sol"; import {Errors} from "./libraries/Errors.sol"; /** * @title WrappedLiquidStakedToken * @notice Wraps the LiquidStakingToken contract. * @author redactedcartel.finance */ contract WrappedLiquidStakedToken is Initializable, ERC20PermitUpgradeable { /*////////////////////////////////////////////////////////////// WLST STORAGE //////////////////////////////////////////////////////////////*/ /// @custom:storage-location erc7201:redacted.storage.WrappedLiquidStakedToken struct WLSTStorage { /** * @notice The LiquidStakingToken contract. * @dev This is the LiquidStakingToken contract that the WrappedLiquidStakedToken wraps. */ ILiquidStakingToken lst; } // keccak256(abi.encode(uint256(keccak256(redacted.storage.WrappedLiquidStakedToken)) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant WLSTStorageLocation = 0xddf967707f52bbdea6c202114c491d81e6de0cb9ded430e88a276a6f8d3e3800; function _getWrappedLiquidStakedTokenStorage() private pure returns (WLSTStorage storage $) { assembly { $.slot := WLSTStorageLocation } } /// @custom:oz-upgrades-unsafe-allow constructor constructor() { _disableInitializers(); } /*////////////////////////////////////////////////////////////// INITIALIZER //////////////////////////////////////////////////////////////*/ function initialize( address lst_, string memory name_, string memory symbol_ ) external initializer { __WrappedLiquidStakedToken_init(lst_, name_, symbol_); } function __WrappedLiquidStakedToken_init( address lst_, string memory name_, string memory symbol_ ) internal onlyInitializing { WLSTStorage storage wlst = _getWrappedLiquidStakedTokenStorage(); wlst.lst = ILiquidStakingToken(lst_); // Set decoded values for name and symbol. __ERC20_init_unchained(name_, symbol_); // Set the name for EIP-712 signature. __ERC20Permit_init(name_); } /*////////////////////////////////////////////////////////////// WRAPPER FUNCTIONS //////////////////////////////////////////////////////////////*/ /** * @notice Wraps the LiquidStakingToken into WrappedLiquidStakedToken. * @param _amount The amount of LiquidStakingToken to wrap. * @return shares The amount of WrappedLiquidStakedToken shares minted. */ function wrap(uint256 _amount) external returns (uint256) { if (_amount == 0) { revert Errors.ZeroAmount(); } WLSTStorage storage $ = _getWrappedLiquidStakedTokenStorage(); ILiquidStakingToken lst = $.lst; uint256 shares = lst.convertToShares(_amount); _mint(msg.sender, shares); lst.transferFrom(msg.sender, address(this), _amount); return shares; } /** * @notice Unwraps the WrappedLiquidStakedToken into LiquidStakingToken. * @param _amount The amount of WrappedLiquidStakedToken shares to unwrap. * @return assets The amount of LiquidStakingToken assets received. */ function unwrap(uint256 _amount) external returns (uint256) { if (_amount == 0) { revert Errors.ZeroAmount(); } WLSTStorage storage $ = _getWrappedLiquidStakedTokenStorage(); ILiquidStakingToken lst = $.lst; uint256 assets = lst.convertToAssets(_amount, true); _burn(msg.sender, _amount); lst.transfer(msg.sender, assets); return assets; } /*////////////////////////////////////////////////////////////// VIEW FUNCTIONS //////////////////////////////////////////////////////////////*/ /** * @notice Returns the amount of WrappedLiquidStakedToken shares that corresponds to `_lstAmount` LiquidStakingToken. * @param _lstAmount The amount of LiquidStakingToken. * @return shares The amount of WrappedLiquidStakedToken shares. */ function getWrappedLSTAmount( uint256 _lstAmount ) external view returns (uint256) { return _getWrappedLiquidStakedTokenStorage().lst.convertToShares( _lstAmount ); } /** * @notice Returns the amount of LiquidStakingToken assets that corresponds to `_wlstAmount` WrappedLiquidStakedToken shares. * @param _wlstAmount The amount of WrappedLiquidStakedToken shares. * @return assets The amount of LiquidStakingToken assets. */ function getLSTAmount(uint256 _wlstAmount) external view returns (uint256) { return _getWrappedLiquidStakedTokenStorage().lst.convertToAssets( _wlstAmount, true ); } /** * @notice Returns the amount of LiquidStakingToken assets that corresponds to 1 WrappedLiquidStakedToken share. * @return assets The amount of LiquidStakingToken assets. */ function LSTPerToken() external view returns (uint256) { return _getWrappedLiquidStakedTokenStorage().lst.convertToAssets( 1 ether, true ); } /** * @notice Returns the amount of WrappedLiquidStakedToken shares that corresponds to 1 LiquidStakingToken asset. * @return shares The amount of WrappedLiquidStakedToken shares. */ function tokensPerLST() external view returns (uint256) { return _getWrappedLiquidStakedTokenStorage().lst.convertToShares(1 ether); } /** * @notice Returns the LiquidStakingToken contract address. * @return lst The LiquidStakingToken contract address. */ function getLSTAddress() external view returns (address) { return address(_getWrappedLiquidStakedTokenStorage().lst); } }
// SPDX-License-Identifier: MIT pragma solidity 0.8.25; library Errors { /** * @dev Zero address specified */ error ZeroAddress(); /** * @dev Zero amount specified */ error ZeroAmount(); /** * @dev Invalid fee specified */ error InvalidFee(); /** * @dev not same as deposit size */ error InvalidAmount(); /** * @dev Invalid nonce */ error InvalidNonce(); /** * @dev not allowed */ error NotAllowed(); /** * @dev Only ETH allowed */ error OnlyETH(); /** * @dev Invalid rate */ error InvalidRate(); /** * @dev Withdraw limit exceeded */ error WithdrawLimitExceeded(); /** * @dev Unauthorized caller on SyncPool */ error UnauthorizedCaller(); /** * @dev Native transfer failed on SyncPool */ error NativeTransferFailed(); /** * @dev Insufficient amount out */ error InsufficientAmountOut(); /** * @dev Insufficient amount to sync */ error InsufficientAmountToSync(); /** * @dev Unauthorized token */ error UnauthorizedToken(); /** * @dev Invalid amount in */ error InvalidAmountIn(); /** * @dev Max sync amount exceeded, to prevent going over the bridge limit */ error MaxSyncAmountExceeded(); /** * @dev Unsupported destination chain */ error UnsupportedEid(); /** * @dev Multichain eposits can't be wrapped */ error MultichainDepositsCannotBeWrapped(); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.20; import {MessagingReceipt} from "contracts/vendor/layerzero/protocol/interfaces/ILayerZeroEndpointV2.sol"; /** * @title ILiquidStakingToken. * @notice Interface for the LiquidStakingToken contract. * @author redactedcartel.finance */ interface ILiquidStakingToken { /** * @return the amount of shares that corresponds to `_assets` (pxEth). */ function convertToShares(uint256 assets) external view returns (uint256); /** * @return the amount of assets that corresponds to `_shares` token shares. * @param floor if true, the result is rounded down, otherwise it's rounded up. */ function convertToAssets(uint256 shares, bool floor) external view returns (uint256); /** * @notice Mint LiquidStakingToken tokens to the recipient. * @param _amount uint256 The amount of LiquidStakingToken to mint. * @param _assetsPerShare uint256 The assets per share value. * @param _receiver address The recipient of the minted LiquidStakingToken. */ function mint( address _receiver, uint256 _amount, uint256 _assetsPerShare ) external; /** * @notice transfer `_amount` LiquidStakingToken tokens from the sender to the recipient. * @param sender address The sender of the LiquidStakingToken tokens. * @param recipient address The recipient of the LiquidStakingToken tokens. * @param amount uint256 The amount of LiquidStakingToken tokens to transfer. */ function transferFrom( address sender, address recipient, uint256 amount ) external returns (bool); /** * @notice transfer `_amount` LiquidStakingToken tokens from the sender to the recipient. * @param recipient address The recipient of the LiquidStakingToken tokens. * @param amount uint256 The amount of LiquidStakingToken tokens to transfer. */ function transfer( address recipient, uint256 amount ) external returns (bool); /** * @notice Sync the unsynchronized pending deposit. * @dev Only the Sync Pool contract can sync to signal a sync message sent to L1. * @param token address token address on Layer 1 * @param amountIn uint256 Amount of tokens deposited on Layer 2 * @param amountOut uint256 Amount of tokens minted on Layer 2 * @param refundAddress address The address to receive any excess fee values sent to the endpoint. * @param options bytes Extra options for the messaging protocol * @return receipt Messaging receipt */ function sync( address token, uint256 amountIn, uint256 amountOut, address refundAddress, bytes calldata options ) external payable returns (MessagingReceipt memory); /** * @dev Deposit tokens on Layer 2 * This will mint tokenOut on Layer 2 using the exchange rate for tokenIn to tokenOut. * The amount deposited and minted will be stored in the token data which can be synced to Layer 1. * Will revert if: * - The amountIn is zero * - The token is unauthorized (that is, the l1Address is address(0)) * - The amountOut is less than the minAmountOut * @param tokenIn Address of the token * @param amountIn Amount of tokens to deposit * @param minAmountOut Minimum amount of tokens to mint on Layer 2 * @return amountOut Amount of tokens minted on Layer 2 */ function deposit( address tokenIn, uint256 amountIn, uint256 minAmountOut ) external payable returns (uint256 amountOut); /** * @dev Deposit tokens on Layer 2 * This will mint tokenOut on Layer 2 using the exchange rate for tokenIn to tokenOut. * The amount deposited and minted will be stored in the token data which can be synced to Layer 1. * Will revert if: * - The amountIn is zero * - The token is unauthorized (that is, the l1Address is address(0)) * - The amountOut is less than the minAmountOut * @param tokenIn Address of the token * @param amountIn Amount of tokens to deposit * @param minAmountOut Minimum amount of tokens to mint on Layer 2 * @param shouldWrap If true, the minted tokens will be wrapped and sent to the sender * @return amountOut Amount of tokens minted on Layer 2 */ function deposit( address tokenIn, uint256 amountIn, uint256 minAmountOut, bool shouldWrap ) external payable returns (uint256 amountOut); /** * @notice Deposit tokens on Layer 2 and wrap them * This will mint tokenOut on Layer 2 using the exchange rate for tokenIn to tokenOut. * The amount deposited and minted will be stored in the token data which can be synced to Layer 1. * The minted tokens will be wrapped and sent to the sender. * @param tokenIn Address of the token * @param amountIn Amount of tokens to deposit * @param minAmountOut Minimum amount of tokens to mint on Layer 2 * @return amountOut Amount of tokens minted on Layer 2 */ function depositAndWrap( address tokenIn, uint256 amountIn, uint256 minAmountOut ) external payable returns (uint256 amountOut); }
// SPDX-License-Identifier: MIT pragma solidity >=0.8.0; import { IMessageLibManager } from "./IMessageLibManager.sol"; import { IMessagingComposer } from "./IMessagingComposer.sol"; import { IMessagingChannel } from "./IMessagingChannel.sol"; import { IMessagingContext } from "./IMessagingContext.sol"; struct MessagingParams { uint32 dstEid; bytes32 receiver; bytes message; bytes options; bool payInLzToken; } struct MessagingReceipt { bytes32 guid; uint64 nonce; MessagingFee fee; } struct MessagingFee { uint256 nativeFee; uint256 lzTokenFee; } struct Origin { uint32 srcEid; bytes32 sender; uint64 nonce; } interface ILayerZeroEndpointV2 is IMessageLibManager, IMessagingComposer, IMessagingChannel, IMessagingContext { event PacketSent(bytes encodedPayload, bytes options, address sendLibrary); event PacketVerified(Origin origin, address receiver, bytes32 payloadHash); event PacketDelivered(Origin origin, address receiver); event LzReceiveAlert( address indexed receiver, address indexed executor, Origin origin, bytes32 guid, uint256 gas, uint256 value, bytes message, bytes extraData, bytes reason ); event LzTokenSet(address token); event DelegateSet(address sender, address delegate); function quote(MessagingParams calldata _params, address _sender) external view returns (MessagingFee memory); function send( MessagingParams calldata _params, address _refundAddress ) external payable returns (MessagingReceipt memory); function verify(Origin calldata _origin, address _receiver, bytes32 _payloadHash) external; function verifiable(Origin calldata _origin, address _receiver) external view returns (bool); function initializable(Origin calldata _origin, address _receiver) external view returns (bool); function lzReceive( Origin calldata _origin, address _receiver, bytes32 _guid, bytes calldata _message, bytes calldata _extraData ) external payable; // oapp can burn messages partially by calling this function with its own business logic if messages are verified in order function clear(address _oapp, Origin calldata _origin, bytes32 _guid, bytes calldata _message) external; function setLzToken(address _lzToken) external; function lzToken() external view returns (address); function nativeToken() external view returns (address); function setDelegate(address _delegate) external; }
// SPDX-License-Identifier: MIT pragma solidity >=0.8.0; struct SetConfigParam { uint32 eid; uint32 configType; bytes config; } interface IMessageLibManager { struct Timeout { address lib; uint256 expiry; } event LibraryRegistered(address newLib); event DefaultSendLibrarySet(uint32 eid, address newLib); event DefaultReceiveLibrarySet(uint32 eid, address newLib); event DefaultReceiveLibraryTimeoutSet(uint32 eid, address oldLib, uint256 expiry); event SendLibrarySet(address sender, uint32 eid, address newLib); event ReceiveLibrarySet(address receiver, uint32 eid, address newLib); event ReceiveLibraryTimeoutSet(address receiver, uint32 eid, address oldLib, uint256 timeout); function registerLibrary(address _lib) external; function isRegisteredLibrary(address _lib) external view returns (bool); function getRegisteredLibraries() external view returns (address[] memory); function setDefaultSendLibrary(uint32 _eid, address _newLib) external; function defaultSendLibrary(uint32 _eid) external view returns (address); function setDefaultReceiveLibrary(uint32 _eid, address _newLib, uint256 _timeout) external; function defaultReceiveLibrary(uint32 _eid) external view returns (address); function setDefaultReceiveLibraryTimeout(uint32 _eid, address _lib, uint256 _expiry) external; function defaultReceiveLibraryTimeout(uint32 _eid) external view returns (address lib, uint256 expiry); function isSupportedEid(uint32 _eid) external view returns (bool); function isValidReceiveLibrary(address _receiver, uint32 _eid, address _lib) external view returns (bool); /// ------------------- OApp interfaces ------------------- function setSendLibrary(address _oapp, uint32 _eid, address _newLib) external; function getSendLibrary(address _sender, uint32 _eid) external view returns (address lib); function isDefaultSendLibrary(address _sender, uint32 _eid) external view returns (bool); function setReceiveLibrary(address _oapp, uint32 _eid, address _newLib, uint256 _gracePeriod) external; function getReceiveLibrary(address _receiver, uint32 _eid) external view returns (address lib, bool isDefault); function setReceiveLibraryTimeout(address _oapp, uint32 _eid, address _lib, uint256 _gracePeriod) external; function receiveLibraryTimeout(address _receiver, uint32 _eid) external view returns (address lib, uint256 expiry); function setConfig(address _oapp, address _lib, SetConfigParam[] calldata _params) external; function getConfig( address _oapp, address _lib, uint32 _eid, uint32 _configType ) external view returns (bytes memory config); }
// SPDX-License-Identifier: MIT pragma solidity >=0.8.0; interface IMessagingComposer { event ComposeSent(address from, address to, bytes32 guid, uint16 index, bytes message); event ComposeDelivered(address from, address to, bytes32 guid, uint16 index); event LzComposeAlert( address indexed from, address indexed to, address indexed executor, bytes32 guid, uint16 index, uint256 gas, uint256 value, bytes message, bytes extraData, bytes reason ); function composeQueue( address _from, address _to, bytes32 _guid, uint16 _index ) external view returns (bytes32 messageHash); function sendCompose(address _to, bytes32 _guid, uint16 _index, bytes calldata _message) external; function lzCompose( address _from, address _to, bytes32 _guid, uint16 _index, bytes calldata _message, bytes calldata _extraData ) external payable; }
// SPDX-License-Identifier: MIT pragma solidity >=0.8.0; interface IMessagingChannel { event InboundNonceSkipped(uint32 srcEid, bytes32 sender, address receiver, uint64 nonce); event PacketNilified(uint32 srcEid, bytes32 sender, address receiver, uint64 nonce, bytes32 payloadHash); event PacketBurnt(uint32 srcEid, bytes32 sender, address receiver, uint64 nonce, bytes32 payloadHash); function eid() external view returns (uint32); // this is an emergency function if a message cannot be verified for some reasons // required to provide _nextNonce to avoid race condition function skip(address _oapp, uint32 _srcEid, bytes32 _sender, uint64 _nonce) external; function nilify(address _oapp, uint32 _srcEid, bytes32 _sender, uint64 _nonce, bytes32 _payloadHash) external; function burn(address _oapp, uint32 _srcEid, bytes32 _sender, uint64 _nonce, bytes32 _payloadHash) external; function nextGuid(address _sender, uint32 _dstEid, bytes32 _receiver) external view returns (bytes32); function inboundNonce(address _receiver, uint32 _srcEid, bytes32 _sender) external view returns (uint64); function outboundNonce(address _sender, uint32 _dstEid, bytes32 _receiver) external view returns (uint64); function inboundPayloadHash( address _receiver, uint32 _srcEid, bytes32 _sender, uint64 _nonce ) external view returns (bytes32); function lazyInboundNonce(address _receiver, uint32 _srcEid, bytes32 _sender) external view returns (uint64); }
// SPDX-License-Identifier: MIT pragma solidity >=0.8.0; interface IMessagingContext { function isSendingMessage() external view returns (bool); function getSendContext() external view returns (uint32 dstEid, address sender); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/extensions/ERC20Permit.sol) pragma solidity ^0.8.20; import {IERC20Permit} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Permit.sol"; import {ERC20Upgradeable} from "../ERC20Upgradeable.sol"; import {ECDSA} from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol"; import {EIP712Upgradeable} from "../../../utils/cryptography/EIP712Upgradeable.sol"; import {NoncesUpgradeable} from "../../../utils/NoncesUpgradeable.sol"; import {Initializable} from "../../../proxy/utils/Initializable.sol"; /** * @dev Implementation of the ERC-20 Permit extension allowing approvals to be made via signatures, as defined in * https://eips.ethereum.org/EIPS/eip-2612[ERC-2612]. * * Adds the {permit} method, which can be used to change an account's ERC-20 allowance (see {IERC20-allowance}) by * presenting a message signed by the account. By not relying on `{IERC20-approve}`, the token holder account doesn't * need to send a transaction, and thus is not required to hold Ether at all. */ abstract contract ERC20PermitUpgradeable is Initializable, ERC20Upgradeable, IERC20Permit, EIP712Upgradeable, NoncesUpgradeable { bytes32 private constant PERMIT_TYPEHASH = keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)"); /** * @dev Permit deadline has expired. */ error ERC2612ExpiredSignature(uint256 deadline); /** * @dev Mismatched signature. */ error ERC2612InvalidSigner(address signer, address owner); /** * @dev Initializes the {EIP712} domain separator using the `name` parameter, and setting `version` to `"1"`. * * It's a good idea to use the same `name` that is defined as the ERC-20 token name. */ function __ERC20Permit_init(string memory name) internal onlyInitializing { __EIP712_init_unchained(name, "1"); } function __ERC20Permit_init_unchained(string memory) internal onlyInitializing {} /** * @inheritdoc IERC20Permit */ function permit( address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) public virtual { if (block.timestamp > deadline) { revert ERC2612ExpiredSignature(deadline); } bytes32 structHash = keccak256(abi.encode(PERMIT_TYPEHASH, owner, spender, value, _useNonce(owner), deadline)); bytes32 hash = _hashTypedDataV4(structHash); address signer = ECDSA.recover(hash, v, r, s); if (signer != owner) { revert ERC2612InvalidSigner(signer, owner); } _approve(owner, spender, value); } /** * @inheritdoc IERC20Permit */ function nonces(address owner) public view virtual override(IERC20Permit, NoncesUpgradeable) returns (uint256) { return super.nonces(owner); } /** * @inheritdoc IERC20Permit */ // solhint-disable-next-line func-name-mixedcase function DOMAIN_SEPARATOR() external view virtual returns (bytes32) { return _domainSeparatorV4(); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/Initializable.sol) pragma solidity ^0.8.20; /** * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect. * * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in * case an upgrade adds a module that needs to be initialized. * * For example: * * [.hljs-theme-light.nopadding] * ```solidity * contract MyToken is ERC20Upgradeable { * function initialize() initializer public { * __ERC20_init("MyToken", "MTK"); * } * } * * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable { * function initializeV2() reinitializer(2) public { * __ERC20Permit_init("MyToken"); * } * } * ``` * * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}. * * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity. * * [CAUTION] * ==== * Avoid leaving a contract uninitialized. * * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed: * * [.hljs-theme-light.nopadding] * ``` * /// @custom:oz-upgrades-unsafe-allow constructor * constructor() { * _disableInitializers(); * } * ``` * ==== */ abstract contract Initializable { /** * @dev Storage of the initializable contract. * * It's implemented on a custom ERC-7201 namespace to reduce the risk of storage collisions * when using with upgradeable contracts. * * @custom:storage-location erc7201:openzeppelin.storage.Initializable */ struct InitializableStorage { /** * @dev Indicates that the contract has been initialized. */ uint64 _initialized; /** * @dev Indicates that the contract is in the process of being initialized. */ bool _initializing; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Initializable")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant INITIALIZABLE_STORAGE = 0xf0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00; /** * @dev The contract is already initialized. */ error InvalidInitialization(); /** * @dev The contract is not initializing. */ error NotInitializing(); /** * @dev Triggered when the contract has been initialized or reinitialized. */ event Initialized(uint64 version); /** * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope, * `onlyInitializing` functions can be used to initialize parent contracts. * * Similar to `reinitializer(1)`, except that in the context of a constructor an `initializer` may be invoked any * number of times. This behavior in the constructor can be useful during testing and is not expected to be used in * production. * * Emits an {Initialized} event. */ modifier initializer() { // solhint-disable-next-line var-name-mixedcase InitializableStorage storage $ = _getInitializableStorage(); // Cache values to avoid duplicated sloads bool isTopLevelCall = !$._initializing; uint64 initialized = $._initialized; // Allowed calls: // - initialSetup: the contract is not in the initializing state and no previous version was // initialized // - construction: the contract is initialized at version 1 (no reininitialization) and the // current contract is just being deployed bool initialSetup = initialized == 0 && isTopLevelCall; bool construction = initialized == 1 && address(this).code.length == 0; if (!initialSetup && !construction) { revert InvalidInitialization(); } $._initialized = 1; if (isTopLevelCall) { $._initializing = true; } _; if (isTopLevelCall) { $._initializing = false; emit Initialized(1); } } /** * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be * used to initialize parent contracts. * * A reinitializer may be used after the original initialization step. This is essential to configure modules that * are added through upgrades and that require initialization. * * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer` * cannot be nested. If one is invoked in the context of another, execution will revert. * * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in * a contract, executing them in the right order is up to the developer or operator. * * WARNING: Setting the version to 2**64 - 1 will prevent any future reinitialization. * * Emits an {Initialized} event. */ modifier reinitializer(uint64 version) { // solhint-disable-next-line var-name-mixedcase InitializableStorage storage $ = _getInitializableStorage(); if ($._initializing || $._initialized >= version) { revert InvalidInitialization(); } $._initialized = version; $._initializing = true; _; $._initializing = false; emit Initialized(version); } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} and {reinitializer} modifiers, directly or indirectly. */ modifier onlyInitializing() { _checkInitializing(); _; } /** * @dev Reverts if the contract is not in an initializing state. See {onlyInitializing}. */ function _checkInitializing() internal view virtual { if (!_isInitializing()) { revert NotInitializing(); } } /** * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call. * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized * to any version. It is recommended to use this to lock implementation contracts that are designed to be called * through proxies. * * Emits an {Initialized} event the first time it is successfully executed. */ function _disableInitializers() internal virtual { // solhint-disable-next-line var-name-mixedcase InitializableStorage storage $ = _getInitializableStorage(); if ($._initializing) { revert InvalidInitialization(); } if ($._initialized != type(uint64).max) { $._initialized = type(uint64).max; emit Initialized(type(uint64).max); } } /** * @dev Returns the highest version that has been initialized. See {reinitializer}. */ function _getInitializedVersion() internal view returns (uint64) { return _getInitializableStorage()._initialized; } /** * @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}. */ function _isInitializing() internal view returns (bool) { return _getInitializableStorage()._initializing; } /** * @dev Returns a pointer to the storage namespace. */ // solhint-disable-next-line var-name-mixedcase function _getInitializableStorage() private pure returns (InitializableStorage storage $) { assembly { $.slot := INITIALIZABLE_STORAGE } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Nonces.sol) pragma solidity ^0.8.20; import {Initializable} from "../proxy/utils/Initializable.sol"; /** * @dev Provides tracking nonces for addresses. Nonces will only increment. */ abstract contract NoncesUpgradeable is Initializable { /** * @dev The nonce used for an `account` is not the expected current nonce. */ error InvalidAccountNonce(address account, uint256 currentNonce); /// @custom:storage-location erc7201:openzeppelin.storage.Nonces struct NoncesStorage { mapping(address account => uint256) _nonces; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.Nonces")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant NoncesStorageLocation = 0x5ab42ced628888259c08ac98db1eb0cf702fc1501344311d8b100cd1bfe4bb00; function _getNoncesStorage() private pure returns (NoncesStorage storage $) { assembly { $.slot := NoncesStorageLocation } } function __Nonces_init() internal onlyInitializing { } function __Nonces_init_unchained() internal onlyInitializing { } /** * @dev Returns the next unused nonce for an address. */ function nonces(address owner) public view virtual returns (uint256) { NoncesStorage storage $ = _getNoncesStorage(); return $._nonces[owner]; } /** * @dev Consumes a nonce. * * Returns the current value and increments nonce. */ function _useNonce(address owner) internal virtual returns (uint256) { NoncesStorage storage $ = _getNoncesStorage(); // For each account, the nonce has an initial value of 0, can only be incremented by one, and cannot be // decremented or reset. This guarantees that the nonce never overflows. unchecked { // It is important to do x++ and not ++x here. return $._nonces[owner]++; } } /** * @dev Same as {_useNonce} but checking that `nonce` is the next valid for `owner`. */ function _useCheckedNonce(address owner, uint256 nonce) internal virtual { uint256 current = _useNonce(owner); if (nonce != current) { revert InvalidAccountNonce(owner, current); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/ERC20.sol) pragma solidity ^0.8.20; import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol"; import {IERC20Metadata} from "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol"; import {ContextUpgradeable} from "../../utils/ContextUpgradeable.sol"; import {IERC20Errors} from "@openzeppelin/contracts/interfaces/draft-IERC6093.sol"; import {Initializable} from "../../proxy/utils/Initializable.sol"; /** * @dev Implementation of the {IERC20} interface. * * This implementation is agnostic to the way tokens are created. This means * that a supply mechanism has to be added in a derived contract using {_mint}. * * TIP: For a detailed writeup see our guide * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How * to implement supply mechanisms]. * * The default value of {decimals} is 18. To change this, you should override * this function so it returns a different value. * * We have followed general OpenZeppelin Contracts guidelines: functions revert * instead returning `false` on failure. This behavior is nonetheless * conventional and does not conflict with the expectations of ERC-20 * applications. */ abstract contract ERC20Upgradeable is Initializable, ContextUpgradeable, IERC20, IERC20Metadata, IERC20Errors { /// @custom:storage-location erc7201:openzeppelin.storage.ERC20 struct ERC20Storage { mapping(address account => uint256) _balances; mapping(address account => mapping(address spender => uint256)) _allowances; uint256 _totalSupply; string _name; string _symbol; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.ERC20")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant ERC20StorageLocation = 0x52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace00; function _getERC20Storage() private pure returns (ERC20Storage storage $) { assembly { $.slot := ERC20StorageLocation } } /** * @dev Sets the values for {name} and {symbol}. * * All two of these values are immutable: they can only be set once during * construction. */ function __ERC20_init(string memory name_, string memory symbol_) internal onlyInitializing { __ERC20_init_unchained(name_, symbol_); } function __ERC20_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing { ERC20Storage storage $ = _getERC20Storage(); $._name = name_; $._symbol = symbol_; } /** * @dev Returns the name of the token. */ function name() public view virtual returns (string memory) { ERC20Storage storage $ = _getERC20Storage(); return $._name; } /** * @dev Returns the symbol of the token, usually a shorter version of the * name. */ function symbol() public view virtual returns (string memory) { ERC20Storage storage $ = _getERC20Storage(); return $._symbol; } /** * @dev Returns the number of decimals used to get its user representation. * For example, if `decimals` equals `2`, a balance of `505` tokens should * be displayed to a user as `5.05` (`505 / 10 ** 2`). * * Tokens usually opt for a value of 18, imitating the relationship between * Ether and Wei. This is the default value returned by this function, unless * it's overridden. * * NOTE: This information is only used for _display_ purposes: it in * no way affects any of the arithmetic of the contract, including * {IERC20-balanceOf} and {IERC20-transfer}. */ function decimals() public view virtual returns (uint8) { return 18; } /** * @dev See {IERC20-totalSupply}. */ function totalSupply() public view virtual returns (uint256) { ERC20Storage storage $ = _getERC20Storage(); return $._totalSupply; } /** * @dev See {IERC20-balanceOf}. */ function balanceOf(address account) public view virtual returns (uint256) { ERC20Storage storage $ = _getERC20Storage(); return $._balances[account]; } /** * @dev See {IERC20-transfer}. * * Requirements: * * - `to` cannot be the zero address. * - the caller must have a balance of at least `value`. */ function transfer(address to, uint256 value) public virtual returns (bool) { address owner = _msgSender(); _transfer(owner, to, value); return true; } /** * @dev See {IERC20-allowance}. */ function allowance(address owner, address spender) public view virtual returns (uint256) { ERC20Storage storage $ = _getERC20Storage(); return $._allowances[owner][spender]; } /** * @dev See {IERC20-approve}. * * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on * `transferFrom`. This is semantically equivalent to an infinite approval. * * Requirements: * * - `spender` cannot be the zero address. */ function approve(address spender, uint256 value) public virtual returns (bool) { address owner = _msgSender(); _approve(owner, spender, value); return true; } /** * @dev See {IERC20-transferFrom}. * * Skips emitting an {Approval} event indicating an allowance update. This is not * required by the ERC. See {xref-ERC20-_approve-address-address-uint256-bool-}[_approve]. * * NOTE: Does not update the allowance if the current allowance * is the maximum `uint256`. * * Requirements: * * - `from` and `to` cannot be the zero address. * - `from` must have a balance of at least `value`. * - the caller must have allowance for ``from``'s tokens of at least * `value`. */ function transferFrom(address from, address to, uint256 value) public virtual returns (bool) { address spender = _msgSender(); _spendAllowance(from, spender, value); _transfer(from, to, value); return true; } /** * @dev Moves a `value` amount of tokens from `from` to `to`. * * This internal function is equivalent to {transfer}, and can be used to * e.g. implement automatic token fees, slashing mechanisms, etc. * * Emits a {Transfer} event. * * NOTE: This function is not virtual, {_update} should be overridden instead. */ function _transfer(address from, address to, uint256 value) internal { if (from == address(0)) { revert ERC20InvalidSender(address(0)); } if (to == address(0)) { revert ERC20InvalidReceiver(address(0)); } _update(from, to, value); } /** * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from` * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding * this function. * * Emits a {Transfer} event. */ function _update(address from, address to, uint256 value) internal virtual { ERC20Storage storage $ = _getERC20Storage(); if (from == address(0)) { // Overflow check required: The rest of the code assumes that totalSupply never overflows $._totalSupply += value; } else { uint256 fromBalance = $._balances[from]; if (fromBalance < value) { revert ERC20InsufficientBalance(from, fromBalance, value); } unchecked { // Overflow not possible: value <= fromBalance <= totalSupply. $._balances[from] = fromBalance - value; } } if (to == address(0)) { unchecked { // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply. $._totalSupply -= value; } } else { unchecked { // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256. $._balances[to] += value; } } emit Transfer(from, to, value); } /** * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0). * Relies on the `_update` mechanism * * Emits a {Transfer} event with `from` set to the zero address. * * NOTE: This function is not virtual, {_update} should be overridden instead. */ function _mint(address account, uint256 value) internal { if (account == address(0)) { revert ERC20InvalidReceiver(address(0)); } _update(address(0), account, value); } /** * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply. * Relies on the `_update` mechanism. * * Emits a {Transfer} event with `to` set to the zero address. * * NOTE: This function is not virtual, {_update} should be overridden instead */ function _burn(address account, uint256 value) internal { if (account == address(0)) { revert ERC20InvalidSender(address(0)); } _update(account, address(0), value); } /** * @dev Sets `value` as the allowance of `spender` over the `owner` s tokens. * * This internal function is equivalent to `approve`, and can be used to * e.g. set automatic allowances for certain subsystems, etc. * * Emits an {Approval} event. * * Requirements: * * - `owner` cannot be the zero address. * - `spender` cannot be the zero address. * * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument. */ function _approve(address owner, address spender, uint256 value) internal { _approve(owner, spender, value, true); } /** * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event. * * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any * `Approval` event during `transferFrom` operations. * * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to * true using the following override: * * ```solidity * function _approve(address owner, address spender, uint256 value, bool) internal virtual override { * super._approve(owner, spender, value, true); * } * ``` * * Requirements are the same as {_approve}. */ function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual { ERC20Storage storage $ = _getERC20Storage(); if (owner == address(0)) { revert ERC20InvalidApprover(address(0)); } if (spender == address(0)) { revert ERC20InvalidSpender(address(0)); } $._allowances[owner][spender] = value; if (emitEvent) { emit Approval(owner, spender, value); } } /** * @dev Updates `owner` s allowance for `spender` based on spent `value`. * * Does not update the allowance value in case of infinite allowance. * Revert if not enough allowance is available. * * Does not emit an {Approval} event. */ function _spendAllowance(address owner, address spender, uint256 value) internal virtual { uint256 currentAllowance = allowance(owner, spender); if (currentAllowance != type(uint256).max) { if (currentAllowance < value) { revert ERC20InsufficientAllowance(spender, currentAllowance, value); } unchecked { _approve(owner, spender, currentAllowance - value, false); } } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/cryptography/EIP712.sol) pragma solidity ^0.8.20; import {MessageHashUtils} from "@openzeppelin/contracts/utils/cryptography/MessageHashUtils.sol"; import {IERC5267} from "@openzeppelin/contracts/interfaces/IERC5267.sol"; import {Initializable} from "../../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 scheme specified in the EIP requires a domain separator and a hash of the typed structured data, whose * encoding is very generic and therefore its 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 order to * produce the hash of their typed data 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]. * * NOTE: In the upgradeable version of this contract, the cached values will correspond to the address, and the domain * separator of the implementation contract. This will cause the {_domainSeparatorV4} function to always rebuild the * separator from the immutable values, which is cheaper than accessing a cached version in cold storage. */ abstract contract EIP712Upgradeable is Initializable, IERC5267 { bytes32 private constant TYPE_HASH = keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)"); /// @custom:storage-location erc7201:openzeppelin.storage.EIP712 struct EIP712Storage { /// @custom:oz-renamed-from _HASHED_NAME bytes32 _hashedName; /// @custom:oz-renamed-from _HASHED_VERSION bytes32 _hashedVersion; string _name; string _version; } // keccak256(abi.encode(uint256(keccak256("openzeppelin.storage.EIP712")) - 1)) & ~bytes32(uint256(0xff)) bytes32 private constant EIP712StorageLocation = 0xa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d100; function _getEIP712Storage() private pure returns (EIP712Storage storage $) { assembly { $.slot := EIP712StorageLocation } } /** * @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 { EIP712Storage storage $ = _getEIP712Storage(); $._name = name; $._version = version; // Reset prior values in storage if upgrading $._hashedName = 0; $._hashedVersion = 0; } /** * @dev Returns the domain separator for the current chain. */ function _domainSeparatorV4() internal view returns (bytes32) { return _buildDomainSeparator(); } function _buildDomainSeparator() private view returns (bytes32) { return keccak256(abi.encode(TYPE_HASH, _EIP712NameHash(), _EIP712VersionHash(), 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 MessageHashUtils.toTypedDataHash(_domainSeparatorV4(), structHash); } /** * @dev See {IERC-5267}. */ function eip712Domain() public view virtual returns ( bytes1 fields, string memory name, string memory version, uint256 chainId, address verifyingContract, bytes32 salt, uint256[] memory extensions ) { EIP712Storage storage $ = _getEIP712Storage(); // If the hashed name and version in storage are non-zero, the contract hasn't been properly initialized // and the EIP712 domain is not reliable, as it will be missing name and version. require($._hashedName == 0 && $._hashedVersion == 0, "EIP712: Uninitialized"); return ( hex"0f", // 01111 _EIP712Name(), _EIP712Version(), block.chainid, address(this), bytes32(0), new uint256[](0) ); } /** * @dev 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 _EIP712Name() internal view virtual returns (string memory) { EIP712Storage storage $ = _getEIP712Storage(); return $._name; } /** * @dev 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 _EIP712Version() internal view virtual returns (string memory) { EIP712Storage storage $ = _getEIP712Storage(); return $._version; } /** * @dev The hash of the name parameter for the EIP712 domain. * * NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Name` instead. */ function _EIP712NameHash() internal view returns (bytes32) { EIP712Storage storage $ = _getEIP712Storage(); string memory name = _EIP712Name(); if (bytes(name).length > 0) { return keccak256(bytes(name)); } else { // If the name is empty, the contract may have been upgraded without initializing the new storage. // We return the name hash in storage if non-zero, otherwise we assume the name is empty by design. bytes32 hashedName = $._hashedName; if (hashedName != 0) { return hashedName; } else { return keccak256(""); } } } /** * @dev The hash of the version parameter for the EIP712 domain. * * NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Version` instead. */ function _EIP712VersionHash() internal view returns (bytes32) { EIP712Storage storage $ = _getEIP712Storage(); string memory version = _EIP712Version(); if (bytes(version).length > 0) { return keccak256(bytes(version)); } else { // If the version is empty, the contract may have been upgraded without initializing the new storage. // We return the version hash in storage if non-zero, otherwise we assume the version is empty by design. bytes32 hashedVersion = $._hashedVersion; if (hashedVersion != 0) { return hashedVersion; } else { return keccak256(""); } } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/cryptography/ECDSA.sol) pragma solidity ^0.8.20; /** * @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 } /** * @dev The signature derives the `address(0)`. */ error ECDSAInvalidSignature(); /** * @dev The signature has an invalid length. */ error ECDSAInvalidSignatureLength(uint256 length); /** * @dev The signature has an S value that is in the upper half order. */ error ECDSAInvalidSignatureS(bytes32 s); /** * @dev Returns the address that signed a hashed message (`hash`) with `signature` or an error. This will not * return address(0) without also returning an error description. Errors are documented using an enum (error type) * and a bytes32 providing additional information about the error. * * If no error is returned, then the address can be used for verification purposes. * * The `ecrecover` EVM precompile 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 {MessageHashUtils-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] */ function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError, bytes32) { 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. /// @solidity memory-safe-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 { return (address(0), RecoverError.InvalidSignatureLength, bytes32(signature.length)); } } /** * @dev Returns the address that signed a hashed message (`hash`) with * `signature`. This address can then be used for verification purposes. * * The `ecrecover` EVM precompile 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 {MessageHashUtils-toEthSignedMessageHash} on it. */ function recover(bytes32 hash, bytes memory signature) internal pure returns (address) { (address recovered, RecoverError error, bytes32 errorArg) = tryRecover(hash, signature); _throwError(error, errorArg); 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] */ function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError, bytes32) { unchecked { bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff); // We do not check for an overflow here since the shift operation results in 0 or 1. 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. */ function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) { (address recovered, RecoverError error, bytes32 errorArg) = tryRecover(hash, r, vs); _throwError(error, errorArg); return recovered; } /** * @dev Overload of {ECDSA-tryRecover} that receives the `v`, * `r` and `s` signature fields separately. */ function tryRecover( bytes32 hash, uint8 v, bytes32 r, bytes32 s ) internal pure returns (address, RecoverError, bytes32) { // 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, s); } // 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, bytes32(0)); } return (signer, RecoverError.NoError, bytes32(0)); } /** * @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, bytes32 errorArg) = tryRecover(hash, v, r, s); _throwError(error, errorArg); return recovered; } /** * @dev Optionally reverts with the corresponding custom error according to the `error` argument provided. */ function _throwError(RecoverError error, bytes32 errorArg) private pure { if (error == RecoverError.NoError) { return; // no error: do nothing } else if (error == RecoverError.InvalidSignature) { revert ECDSAInvalidSignature(); } else if (error == RecoverError.InvalidSignatureLength) { revert ECDSAInvalidSignatureLength(uint256(errorArg)); } else if (error == RecoverError.InvalidSignatureS) { revert ECDSAInvalidSignatureS(errorArg); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Permit.sol) pragma solidity ^0.8.20; /** * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612]. * * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't * need to send a transaction, and thus is not required to hold Ether at all. * * ==== Security Considerations * * There are two important considerations concerning the use of `permit`. The first is that a valid permit signature * expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be * considered as an intention to spend the allowance in any specific way. The second is that because permits have * built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should * take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be * generally recommended is: * * ```solidity * function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public { * try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {} * doThing(..., value); * } * * function doThing(..., uint256 value) public { * token.safeTransferFrom(msg.sender, address(this), value); * ... * } * ``` * * Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of * `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also * {SafeERC20-safeTransferFrom}). * * Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so * contracts should have entry points that don't rely on permit. */ interface IERC20Permit { /** * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens, * given ``owner``'s signed approval. * * IMPORTANT: The same issues {IERC20-approve} has related to transaction * ordering also apply here. * * Emits an {Approval} event. * * Requirements: * * - `spender` cannot be the zero address. * - `deadline` must be a timestamp in the future. * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner` * over the EIP712-formatted function arguments. * - the signature must use ``owner``'s current nonce (see {nonces}). * * For more information on the signature format, see the * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP * section]. * * CAUTION: See Security Considerations above. */ function permit( address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) external; /** * @dev Returns the current nonce for `owner`. This value must be * included whenever a signature is generated for {permit}. * * Every successful call to {permit} increases ``owner``'s nonce by one. This * prevents a signature from being used multiple times. */ function nonces(address owner) external view returns (uint256); /** * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}. */ // solhint-disable-next-line func-name-mixedcase function DOMAIN_SEPARATOR() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol) pragma solidity ^0.8.20; import {Initializable} from "../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; } function _contextSuffixLength() internal view virtual returns (uint256) { return 0; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Metadata.sol) pragma solidity ^0.8.20; import {IERC20} from "../IERC20.sol"; /** * @dev Interface for the optional metadata functions from the ERC20 standard. */ interface IERC20Metadata is IERC20 { /** * @dev Returns the name of the token. */ function name() external view returns (string memory); /** * @dev Returns the symbol of the token. */ function symbol() external view returns (string memory); /** * @dev Returns the decimals places of the token. */ function decimals() external view returns (uint8); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/cryptography/MessageHashUtils.sol) pragma solidity ^0.8.20; import {Strings} from "../Strings.sol"; /** * @dev Signature message hash utilities for producing digests to be consumed by {ECDSA} recovery or signing. * * The library provides methods for generating a hash of a message that conforms to the * https://eips.ethereum.org/EIPS/eip-191[EIP 191] and https://eips.ethereum.org/EIPS/eip-712[EIP 712] * specifications. */ library MessageHashUtils { /** * @dev Returns the keccak256 digest of an EIP-191 signed data with version * `0x45` (`personal_sign` messages). * * The digest is calculated by prefixing a bytes32 `messageHash` with * `"\x19Ethereum Signed Message:\n32"` and hashing the result. It corresponds with the * hash signed when using the https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] JSON-RPC method. * * NOTE: The `messageHash` parameter is intended to be the result of hashing a raw message with * keccak256, although any bytes32 value can be safely used because the final digest will * be re-hashed. * * See {ECDSA-recover}. */ function toEthSignedMessageHash(bytes32 messageHash) internal pure returns (bytes32 digest) { /// @solidity memory-safe-assembly assembly { mstore(0x00, "\x19Ethereum Signed Message:\n32") // 32 is the bytes-length of messageHash mstore(0x1c, messageHash) // 0x1c (28) is the length of the prefix digest := keccak256(0x00, 0x3c) // 0x3c is the length of the prefix (0x1c) + messageHash (0x20) } } /** * @dev Returns the keccak256 digest of an EIP-191 signed data with version * `0x45` (`personal_sign` messages). * * The digest is calculated by prefixing an arbitrary `message` with * `"\x19Ethereum Signed Message:\n" + len(message)` and hashing the result. It corresponds with the * hash signed when using the https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`] JSON-RPC method. * * See {ECDSA-recover}. */ function toEthSignedMessageHash(bytes memory message) internal pure returns (bytes32) { return keccak256(bytes.concat("\x19Ethereum Signed Message:\n", bytes(Strings.toString(message.length)), message)); } /** * @dev Returns the keccak256 digest of an EIP-191 signed data with version * `0x00` (data with intended validator). * * The digest is calculated by prefixing an arbitrary `data` with `"\x19\x00"` and the intended * `validator` address. Then hashing the result. * * See {ECDSA-recover}. */ function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) { return keccak256(abi.encodePacked(hex"19_00", validator, data)); } /** * @dev Returns the keccak256 digest of an EIP-712 typed data (EIP-191 version `0x01`). * * The digest is calculated from a `domainSeparator` and a `structHash`, by prefixing them with * `\x19\x01` and hashing the result. It corresponds to the hash signed by the * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`] JSON-RPC method as part of EIP-712. * * See {ECDSA-recover}. */ function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 digest) { /// @solidity memory-safe-assembly assembly { let ptr := mload(0x40) mstore(ptr, hex"19_01") mstore(add(ptr, 0x02), domainSeparator) mstore(add(ptr, 0x22), structHash) digest := keccak256(ptr, 0x42) } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/IERC20.sol) pragma solidity ^0.8.20; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20 { /** * @dev Emitted when `value` tokens are moved from one account (`from`) to * another (`to`). * * Note that `value` may be zero. */ event Transfer(address indexed from, address indexed to, uint256 value); /** * @dev Emitted when the allowance of a `spender` for an `owner` is set by * a call to {approve}. `value` is the new allowance. */ event Approval(address indexed owner, address indexed spender, uint256 value); /** * @dev Returns the value of tokens in existence. */ function totalSupply() external view returns (uint256); /** * @dev Returns the value of tokens owned by `account`. */ function balanceOf(address account) external view returns (uint256); /** * @dev Moves a `value` amount of tokens from the caller's account to `to`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address to, uint256 value) external returns (bool); /** * @dev Returns the remaining number of tokens that `spender` will be * allowed to spend on behalf of `owner` through {transferFrom}. This is * zero by default. * * This value changes when {approve} or {transferFrom} are called. */ function allowance(address owner, address spender) external view returns (uint256); /** * @dev Sets a `value` amount of tokens as the allowance of `spender` over the * caller's tokens. * * Returns a boolean value indicating whether the operation succeeded. * * IMPORTANT: Beware that changing an allowance with this method brings the risk * that someone may use both the old and the new allowance by unfortunate * transaction ordering. One possible solution to mitigate this race * condition is to first reduce the spender's allowance to 0 and set the * desired value afterwards: * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 * * Emits an {Approval} event. */ function approve(address spender, uint256 value) external returns (bool); /** * @dev Moves a `value` amount of tokens from `from` to `to` using the * allowance mechanism. `value` is then deducted from the caller's * allowance. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transferFrom(address from, address to, uint256 value) external returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/IERC5267.sol) pragma solidity ^0.8.20; interface IERC5267 { /** * @dev MAY be emitted to signal that the domain could have changed. */ event EIP712DomainChanged(); /** * @dev returns the fields and values that describe the domain separator used by this contract for EIP-712 * signature. */ function eip712Domain() external view returns ( bytes1 fields, string memory name, string memory version, uint256 chainId, address verifyingContract, bytes32 salt, uint256[] memory extensions ); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol) pragma solidity ^0.8.20; /** * @dev Standard ERC20 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens. */ interface IERC20Errors { /** * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. * @param balance Current balance for the interacting account. * @param needed Minimum amount required to perform a transfer. */ error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC20InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC20InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers. * @param spender Address that may be allowed to operate on tokens without being their owner. * @param allowance Amount of tokens a `spender` is allowed to operate with. * @param needed Minimum amount required to perform a transfer. */ error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC20InvalidApprover(address approver); /** * @dev Indicates a failure with the `spender` to be approved. Used in approvals. * @param spender Address that may be allowed to operate on tokens without being their owner. */ error ERC20InvalidSpender(address spender); } /** * @dev Standard ERC721 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens. */ interface IERC721Errors { /** * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20. * Used in balance queries. * @param owner Address of the current owner of a token. */ error ERC721InvalidOwner(address owner); /** * @dev Indicates a `tokenId` whose `owner` is the zero address. * @param tokenId Identifier number of a token. */ error ERC721NonexistentToken(uint256 tokenId); /** * @dev Indicates an error related to the ownership over a particular token. Used in transfers. * @param sender Address whose tokens are being transferred. * @param tokenId Identifier number of a token. * @param owner Address of the current owner of a token. */ error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC721InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC721InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `operator`’s approval. Used in transfers. * @param operator Address that may be allowed to operate on tokens without being their owner. * @param tokenId Identifier number of a token. */ error ERC721InsufficientApproval(address operator, uint256 tokenId); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC721InvalidApprover(address approver); /** * @dev Indicates a failure with the `operator` to be approved. Used in approvals. * @param operator Address that may be allowed to operate on tokens without being their owner. */ error ERC721InvalidOperator(address operator); } /** * @dev Standard ERC1155 Errors * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens. */ interface IERC1155Errors { /** * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. * @param balance Current balance for the interacting account. * @param needed Minimum amount required to perform a transfer. * @param tokenId Identifier number of a token. */ error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId); /** * @dev Indicates a failure with the token `sender`. Used in transfers. * @param sender Address whose tokens are being transferred. */ error ERC1155InvalidSender(address sender); /** * @dev Indicates a failure with the token `receiver`. Used in transfers. * @param receiver Address to which tokens are being transferred. */ error ERC1155InvalidReceiver(address receiver); /** * @dev Indicates a failure with the `operator`’s approval. Used in transfers. * @param operator Address that may be allowed to operate on tokens without being their owner. * @param owner Address of the current owner of a token. */ error ERC1155MissingApprovalForAll(address operator, address owner); /** * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals. * @param approver Address initiating an approval operation. */ error ERC1155InvalidApprover(address approver); /** * @dev Indicates a failure with the `operator` to be approved. Used in approvals. * @param operator Address that may be allowed to operate on tokens without being their owner. */ error ERC1155InvalidOperator(address operator); /** * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation. * Used in batch transfers. * @param idsLength Length of the array of token identifiers * @param valuesLength Length of the array of token amounts */ error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/Strings.sol) pragma solidity ^0.8.20; import {Math} from "./math/Math.sol"; import {SignedMath} from "./math/SignedMath.sol"; /** * @dev String operations. */ library Strings { bytes16 private constant HEX_DIGITS = "0123456789abcdef"; uint8 private constant ADDRESS_LENGTH = 20; /** * @dev The `value` string doesn't fit in the specified `length`. */ error StringsInsufficientHexLength(uint256 value, uint256 length); /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { unchecked { uint256 length = Math.log10(value) + 1; string memory buffer = new string(length); uint256 ptr; /// @solidity memory-safe-assembly assembly { ptr := add(buffer, add(32, length)) } while (true) { ptr--; /// @solidity memory-safe-assembly assembly { mstore8(ptr, byte(mod(value, 10), HEX_DIGITS)) } value /= 10; if (value == 0) break; } return buffer; } } /** * @dev Converts a `int256` to its ASCII `string` decimal representation. */ function toStringSigned(int256 value) internal pure returns (string memory) { return string.concat(value < 0 ? "-" : "", toString(SignedMath.abs(value))); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { unchecked { return toHexString(value, Math.log256(value) + 1); } } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString(uint256 value, uint256 length) internal pure returns (string memory) { uint256 localValue = value; bytes memory buffer = new bytes(2 * length + 2); buffer[0] = "0"; buffer[1] = "x"; for (uint256 i = 2 * length + 1; i > 1; --i) { buffer[i] = HEX_DIGITS[localValue & 0xf]; localValue >>= 4; } if (localValue != 0) { revert StringsInsufficientHexLength(value, length); } return string(buffer); } /** * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal * representation. */ function toHexString(address addr) internal pure returns (string memory) { return toHexString(uint256(uint160(addr)), ADDRESS_LENGTH); } /** * @dev Returns true if the two strings are equal. */ function equal(string memory a, string memory b) internal pure returns (bool) { return bytes(a).length == bytes(b).length && keccak256(bytes(a)) == keccak256(bytes(b)); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/math/SignedMath.sol) pragma solidity ^0.8.20; /** * @dev Standard signed math utilities missing in the Solidity language. */ library SignedMath { /** * @dev Returns the largest of two signed numbers. */ function max(int256 a, int256 b) internal pure returns (int256) { return a > b ? a : b; } /** * @dev Returns the smallest of two signed numbers. */ function min(int256 a, int256 b) internal pure returns (int256) { return a < b ? a : b; } /** * @dev Returns the average of two signed numbers without overflow. * The result is rounded towards zero. */ function average(int256 a, int256 b) internal pure returns (int256) { // Formula from the book "Hacker's Delight" int256 x = (a & b) + ((a ^ b) >> 1); return x + (int256(uint256(x) >> 255) & (a ^ b)); } /** * @dev Returns the absolute unsigned value of a signed value. */ function abs(int256 n) internal pure returns (uint256) { unchecked { // must be unchecked in order to support `n = type(int256).min` return uint256(n >= 0 ? n : -n); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (utils/math/Math.sol) pragma solidity ^0.8.20; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { /** * @dev Muldiv operation overflow. */ error MathOverflowedMulDiv(); enum Rounding { Floor, // Toward negative infinity Ceil, // Toward positive infinity Trunc, // Toward zero Expand // Away from zero } /** * @dev Returns the addition of two unsigned integers, with an overflow flag. */ function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { uint256 c = a + b; if (c < a) return (false, 0); return (true, c); } } /** * @dev Returns the subtraction of two unsigned integers, with an overflow flag. */ function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b > a) return (false, 0); return (true, a - b); } } /** * @dev Returns the multiplication of two unsigned integers, with an overflow flag. */ function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { // Gas optimization: this is cheaper than requiring 'a' not being zero, but the // benefit is lost if 'b' is also tested. // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522 if (a == 0) return (true, 0); uint256 c = a * b; if (c / a != b) return (false, 0); return (true, c); } } /** * @dev Returns the division of two unsigned integers, with a division by zero flag. */ function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b == 0) return (false, 0); return (true, a / b); } } /** * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag. */ function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) { unchecked { if (b == 0) return (false, 0); return (true, a % b); } } /** * @dev Returns the largest of two numbers. */ function max(uint256 a, uint256 b) internal pure returns (uint256) { return a > b ? a : b; } /** * @dev Returns the smallest of two numbers. */ function min(uint256 a, uint256 b) internal pure returns (uint256) { return a < b ? a : b; } /** * @dev Returns the average of two numbers. The result is rounded towards * zero. */ function average(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b) / 2 can overflow. return (a & b) + (a ^ b) / 2; } /** * @dev Returns the ceiling of the division of two numbers. * * This differs from standard division with `/` in that it rounds towards infinity instead * of rounding towards zero. */ function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) { if (b == 0) { // Guarantee the same behavior as in a regular Solidity division. return a / b; } // (a + b - 1) / b can overflow on addition, so we distribute. return a == 0 ? 0 : (a - 1) / b + 1; } /** * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or * denominator == 0. * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by * Uniswap Labs also under MIT license. */ function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) { unchecked { // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256 // variables such that product = prod1 * 2^256 + prod0. uint256 prod0 = x * y; // Least significant 256 bits of the product uint256 prod1; // Most significant 256 bits of the product assembly { let mm := mulmod(x, y, not(0)) prod1 := sub(sub(mm, prod0), lt(mm, prod0)) } // Handle non-overflow cases, 256 by 256 division. if (prod1 == 0) { // Solidity will revert if denominator == 0, unlike the div opcode on its own. // The surrounding unchecked block does not change this fact. // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic. return prod0 / denominator; } // Make sure the result is less than 2^256. Also prevents denominator == 0. if (denominator <= prod1) { revert MathOverflowedMulDiv(); } /////////////////////////////////////////////// // 512 by 256 division. /////////////////////////////////////////////// // Make division exact by subtracting the remainder from [prod1 prod0]. uint256 remainder; assembly { // Compute remainder using mulmod. remainder := mulmod(x, y, denominator) // Subtract 256 bit number from 512 bit number. prod1 := sub(prod1, gt(remainder, prod0)) prod0 := sub(prod0, remainder) } // Factor powers of two out of denominator and compute largest power of two divisor of denominator. // Always >= 1. See https://cs.stackexchange.com/q/138556/92363. uint256 twos = denominator & (0 - denominator); assembly { // Divide denominator by twos. denominator := div(denominator, twos) // Divide [prod1 prod0] by twos. prod0 := div(prod0, twos) // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one. twos := add(div(sub(0, twos), twos), 1) } // Shift in bits from prod1 into prod0. prod0 |= prod1 * twos; // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for // four bits. That is, denominator * inv = 1 mod 2^4. uint256 inverse = (3 * denominator) ^ 2; // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also // works in modular arithmetic, doubling the correct bits in each step. inverse *= 2 - denominator * inverse; // inverse mod 2^8 inverse *= 2 - denominator * inverse; // inverse mod 2^16 inverse *= 2 - denominator * inverse; // inverse mod 2^32 inverse *= 2 - denominator * inverse; // inverse mod 2^64 inverse *= 2 - denominator * inverse; // inverse mod 2^128 inverse *= 2 - denominator * inverse; // inverse mod 2^256 // Because the division is now exact we can divide by multiplying with the modular inverse of denominator. // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1 // is no longer required. result = prod0 * inverse; return result; } } /** * @notice Calculates x * y / denominator with full precision, following the selected rounding direction. */ function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) { uint256 result = mulDiv(x, y, denominator); if (unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0) { result += 1; } return result; } /** * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded * towards zero. * * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11). */ function sqrt(uint256 a) internal pure returns (uint256) { if (a == 0) { return 0; } // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target. // // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`. // // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)` // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))` // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)` // // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit. uint256 result = 1 << (log2(a) >> 1); // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128, // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision // into the expected uint128 result. unchecked { result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; return min(result, a / result); } } /** * @notice Calculates sqrt(a), following the selected rounding direction. */ function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = sqrt(a); return result + (unsignedRoundsUp(rounding) && result * result < a ? 1 : 0); } } /** * @dev Return the log in base 2 of a positive value rounded towards zero. * Returns 0 if given 0. */ function log2(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 128; } if (value >> 64 > 0) { value >>= 64; result += 64; } if (value >> 32 > 0) { value >>= 32; result += 32; } if (value >> 16 > 0) { value >>= 16; result += 16; } if (value >> 8 > 0) { value >>= 8; result += 8; } if (value >> 4 > 0) { value >>= 4; result += 4; } if (value >> 2 > 0) { value >>= 2; result += 2; } if (value >> 1 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 2, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log2(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log2(value); return result + (unsignedRoundsUp(rounding) && 1 << result < value ? 1 : 0); } } /** * @dev Return the log in base 10 of a positive value rounded towards zero. * Returns 0 if given 0. */ function log10(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >= 10 ** 64) { value /= 10 ** 64; result += 64; } if (value >= 10 ** 32) { value /= 10 ** 32; result += 32; } if (value >= 10 ** 16) { value /= 10 ** 16; result += 16; } if (value >= 10 ** 8) { value /= 10 ** 8; result += 8; } if (value >= 10 ** 4) { value /= 10 ** 4; result += 4; } if (value >= 10 ** 2) { value /= 10 ** 2; result += 2; } if (value >= 10 ** 1) { result += 1; } } return result; } /** * @dev Return the log in base 10, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log10(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log10(value); return result + (unsignedRoundsUp(rounding) && 10 ** result < value ? 1 : 0); } } /** * @dev Return the log in base 256 of a positive value rounded towards zero. * Returns 0 if given 0. * * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string. */ function log256(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 16; } if (value >> 64 > 0) { value >>= 64; result += 8; } if (value >> 32 > 0) { value >>= 32; result += 4; } if (value >> 16 > 0) { value >>= 16; result += 2; } if (value >> 8 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 256, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log256(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log256(value); return result + (unsignedRoundsUp(rounding) && 1 << (result << 3) < value ? 1 : 0); } } /** * @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers. */ function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) { return uint8(rounding) % 2 == 1; } }
{ "evmVersion": "paris", "optimizer": { "enabled": true, "mode": "3" }, "outputSelection": { "*": { "*": [ "abi" ] } }, "detectMissingLibraries": false, "forceEVMLA": false, "enableEraVMExtensions": true, "libraries": {} }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ECDSAInvalidSignature","type":"error"},{"inputs":[{"internalType":"uint256","name":"length","type":"uint256"}],"name":"ECDSAInvalidSignatureLength","type":"error"},{"inputs":[{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"ECDSAInvalidSignatureS","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"allowance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientAllowance","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"balance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientBalance","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC20InvalidApprover","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC20InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC20InvalidSender","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"}],"name":"ERC20InvalidSpender","type":"error"},{"inputs":[{"internalType":"uint256","name":"deadline","type":"uint256"}],"name":"ERC2612ExpiredSignature","type":"error"},{"inputs":[{"internalType":"address","name":"signer","type":"address"},{"internalType":"address","name":"owner","type":"address"}],"name":"ERC2612InvalidSigner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"currentNonce","type":"uint256"}],"name":"InvalidAccountNonce","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[],"name":"NotInitializing","type":"error"},{"inputs":[],"name":"ZeroAmount","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[],"name":"EIP712DomainChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[],"name":"DOMAIN_SEPARATOR","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"LSTPerToken","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"eip712Domain","outputs":[{"internalType":"bytes1","name":"fields","type":"bytes1"},{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"version","type":"string"},{"internalType":"uint256","name":"chainId","type":"uint256"},{"internalType":"address","name":"verifyingContract","type":"address"},{"internalType":"bytes32","name":"salt","type":"bytes32"},{"internalType":"uint256[]","name":"extensions","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getLSTAddress","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_wlstAmount","type":"uint256"}],"name":"getLSTAmount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_lstAmount","type":"uint256"}],"name":"getWrappedLSTAmount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"lst_","type":"address"},{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"nonces","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"deadline","type":"uint256"},{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"permit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tokensPerLST","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"unwrap","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_amount","type":"uint256"}],"name":"wrap","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"}]
Contract Creation Code
9c4d535b00000000000000000000000000000000000000000000000000000000000000000100031581b14b3331c7c3674b2823e18bbb08903e4915ee8d440087ba21b77100000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x0001000000000002000600000000000200000000000103550000008003000039000000400030043f0000000100200190000000310000c13d00000060021002700000029602200197000000040020008c000003af0000413d000000000301043b000000e0033002700000029f0030009c000000540000a13d000002a00030009c000000650000a13d000002a10030009c0000008f0000213d000002a50030009c0000023f0000613d000002a60030009c0000030d0000613d000002a70030009c000003af0000c13d000000440020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d0000000402100370000000000202043b000002bd0020009c000003af0000213d0000002401100370000000000101043b000600000001001d000002bd0010009c000003af0000213d00000000010200190a52087c0000040f0000000602000029000000000020043f000000200010043f000000400200003900000000010000190a520a330000040f000000000101041a000003600000013d0000000001000416000000000001004b000003af0000c13d0000029701000041000000000101041a0000029800100198000000500000c13d0000029b021001970000029b0020009c0000004b0000613d0000029b011001c70000029702000041000000000012041b0000029b01000041000000800010043f0000000001000414000002960010009c0000029601008041000000c0011002100000029c011001c70000800d0200003900000001030000390000029d040000410a520a480000040f0000000100200190000003af0000613d0000002001000039000001000010044300000120000004430000029e0100004100000a530001042e0000029901000041000000800010043f0000029a0100004100000a5400010430000002ae0030009c0000007b0000213d000002b50030009c000000f80000a13d000002b60030009c000002000000613d000002b70030009c000002d00000613d000002b80030009c000003af0000c13d0000000001000416000000000001004b000003af0000c13d0000001201000039000000800010043f000003050100004100000a530001042e000002a80030009c000000d40000a13d000002a90030009c0000014b0000613d000002aa0030009c000001e00000613d000002ab0030009c000003af0000c13d000000440020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d0000000402100370000000000202043b000002bd0020009c000003af0000213d0000002401100370000000000301043b00000000010004110a5208a30000040f000001090000013d000002af0030009c0000010b0000a13d000002b00030009c000002050000613d000002b10030009c000003040000613d000002b20030009c000003af0000c13d000000240020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d0000000401100370000000000101043b000002bd0010009c000003af0000213d000000000010043f000002c401000041000002c80000013d000002a20030009c0000027b0000613d000002a30030009c0000033c0000613d000002a40030009c000003af0000c13d000000240020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d000002bb02000041000000000202041a000002bc03000041000000800030043f0000000401100370000000000101043b000000840010043f0000000101000039000000a40010043f0000000001000414000002bd02200197000002960010009c0000029601008041000000c001100210000002be011001c70a520a4d0000040f000000800a00003900000060031002700000029603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000080057001bf000000b90000613d000000000801034f000000008908043c000000000a9a043600000000005a004b000000b50000c13d000000000006004b000000c60000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000002700000c13d0000001f0530018f000002bf06300198000000400200043d0000000004620019000003d70000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000000cf0000c13d000003d70000013d000002ac0030009c000002bd0000613d000002ad0030009c000003af0000c13d0000000001000416000000000001004b000003af0000c13d000002fa01000041000000000101041a000000000001004b000003670000c13d000002fb01000041000000000101041a000000000001004b000003670000c13d000002f201000041000000000201041a000000010320019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000442013f0000000100400190000003560000c13d000000800010043f000000000003004b000004120000613d000002f202000041000000000020043f000000000001004b000004a00000c13d0000002001000039000000a002000039000004b40000013d000002b90030009c000003490000613d000002ba0030009c000003af0000c13d000000440020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d0000000402100370000000000202043b000002bd0020009c000003af0000213d0000002401100370000000000301043b00000000010004110a5209100000040f0000000101000039000003600000013d000002b30030009c0000035c0000613d000002b40030009c000003af0000c13d0000000001000416000000000001004b000003af0000c13d000002bb01000041000000000101041a000002bc02000041000000800020043f0000030602000041000000840020043f0000000102000039000000a40020043f0000000003000414000002bd02100197000002960030009c0000029603008041000000c001300210000002be011001c70a520a4d0000040f00000060031002700000029603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000080057001bf000001300000613d0000008008000039000000000901034f000000009a09043c0000000008a80436000000000058004b0000012c0000c13d000000000006004b0000013d0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000002700000c13d0000001f0530018f000002bf06300198000000400200043d0000000004620019000003d70000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000001460000c13d000003d70000013d000000640020008c000003af0000413d0000000003000416000000000003004b000003af0000c13d0000000403100370000000000303043b000600000003001d000002bd0030009c000003af0000213d0000002403100370000000000403043b0000029b0040009c000003af0000213d0000002303400039000000000023004b000003af0000813d0000000405400039000000000351034f000000000303043b0000029b0030009c000004ad0000213d0000001f063000390000030b066001970000003f066000390000030b06600197000002e30060009c000004ad0000213d0000008006600039000000400060043f000000800030043f00000000043400190000002404400039000000000024004b000003af0000213d0000002004500039000000000541034f0000030b063001980000001f0730018f000000a0046000390000017a0000613d000000a008000039000000000905034f000000009a09043c0000000008a80436000000000048004b000001760000c13d000000000007004b000001870000613d000000000565034f0000000306700210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f0000000000540435000000a00330003900000000000304350000004403100370000000000403043b0000029b0040009c000003af0000213d0000002303400039000000000023004b000003af0000813d0000000405400039000000000351034f000000000303043b0000029b0030009c000004ad0000213d0000001f063000390000030b066001970000003f066000390000030b06600197000000400700043d0000000006670019000500000007001d000000000076004b000000000700003900000001070040390000029b0060009c000004ad0000213d0000000100700190000004ad0000c13d000000400060043f00000005060000290000000006360436000400000006001d00000000043400190000002404400039000000000024004b000003af0000213d0000002002500039000000000221034f0000030b043001980000001f0530018f0000000401400029000001b70000613d000000000602034f0000000407000029000000006806043c0000000007870436000000000017004b000001b30000c13d000000000005004b000001c40000613d000000000242034f0000000304500210000000000501043300000000054501cf000000000545022f000000000202043b0000010004400089000000000242022f00000000024201cf000000000252019f0000000000210435000000040130002900000000000104350000029701000041000000000101041a000300000001001d0000029b01100198000006af0000613d000000010010008c000006c10000c13d000002e4010000410000000000100443000000000100041000000004001004430000000001000414000002960010009c0000029601008041000000c001100210000002e5011001c700008002020000390a520a4d0000040f0000000100200190000005bd0000613d000000000101043b000000000001004b000006c10000c13d00000003010000290000029801100197000006b30000013d0000000001000416000000000001004b000003af0000c13d000002e101000041000000000201041a000000010320019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000442013f0000000100400190000003560000c13d000000800010043f000000000003004b000003ba0000613d000002e102000041000000000020043f000000000001004b000003b80000613d000002e20200004100000000040000190000000003040019000000000402041a000000a005300039000000000045043500000001022000390000002004300039000000000014004b000001f70000413d000003fe0000013d0000000001000416000000000001004b000003af0000c13d000002c301000041000002cc0000013d0000000001000416000000000001004b000003af0000c13d000002bb01000041000000000101041a000002c102000041000000800020043f0000030602000041000000840020043f0000000003000414000002bd02100197000002960030009c0000029603008041000000c001300210000002c2011001c70a520a4d0000040f00000060031002700000029603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000080057001bf000002240000613d0000008008000039000000000901034f000000009a09043c0000000008a80436000000000058004b000002200000c13d000000000006004b000002310000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000002700000c13d0000001f0530018f000002bf06300198000000400200043d0000000004620019000003d70000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000023a0000c13d000003d70000013d000000240020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d000002bb02000041000000000202041a000002c103000041000000800030043f0000000401100370000000000101043b000000840010043f0000000001000414000002bd02200197000002960010009c0000029601008041000000c001100210000002c2011001c70a520a4d0000040f00000060031002700000029603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000080057001bf000002610000613d0000008008000039000000000901034f000000009a09043c0000000008a80436000000000058004b0000025d0000c13d000000000006004b0000026e0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000003710000613d0000001f01400039000000600110018f00000080011001bf000000400010043f000000200030008c000003af0000413d000000800200043d00000000002104350000004001100210000002c0011001c700000a530001042e000000240020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d0000000401100370000000000301043b000000000003004b000003450000613d000002bb01000041000000000101041a000002bc02000041000000800020043f000600000003001d000000840030043f0000000102000039000000a40020043f0000000003000414000002bd02100197000002960030009c0000029603008041000000c001300210000002be011001c7000500000002001d0a520a4d0000040f00000060031002700000029603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000080057001bf000002a30000613d0000008008000039000000000901034f000000009a09043c0000000008a80436000000000058004b0000029f0000c13d000000000006004b000002b00000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000003c00000613d0000001f01400039000000600210018f00000080012001bf000000400010043f000000200030008c000003af0000413d0000000003000411000000000003004b000004180000c13d000002d003000041000003ee0000013d000000240020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d0000000401100370000000000101043b000002bd0010009c000003af0000213d000000000010043f000002d401000041000000200010043f000000400200003900000000010000190a520a330000040f000000000101041a000000800010043f000003050100004100000a530001042e000000640020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d0000000402100370000000000202043b000600000002001d000002bd0020009c000003af0000213d0000002402100370000000000202043b000500000002001d000002bd0020009c000003af0000213d0000004401100370000000000101043b000400000001001d0000000601000029000000000010043f0000030701000041000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000003af0000613d000000000101043b0000000002000411000000000020043f000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000003af0000613d000000000101043b000000000301041a0000030c0030009c000004d30000c13d000000060100002900000005020000290000000403000029000000790000013d0000000001000416000000000001004b000003af0000c13d000002bb01000041000000000101041a000002bd01100197000000800010043f000003050100004100000a530001042e000000e40020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d0000000402100370000000000202043b000600000002001d000002bd0020009c000003af0000213d0000002402100370000000000202043b000500000002001d000002bd0020009c000003af0000213d0000006402100370000000000202043b000400000002001d0000004402100370000000000202043b000300000002001d0000008401100370000000000101043b000200000001001d000000ff0010008c000003af0000213d000002d20100004100000000001004430000000001000414000002960010009c0000029601008041000000c001100210000002d3011001c70000800b020000390a520a4d0000040f0000000100200190000005bd0000613d000000000101043b0000000403000029000000000031004b000004e70000a13d000000400100043d000002e0020000410000000000210435000000040210003900000000003204350000063a0000013d000000240020008c000003af0000413d0000000002000416000000000002004b000003af0000c13d0000000401100370000000000301043b000000000003004b0000037d0000c13d000002d101000041000000800010043f0000029a0100004100000a54000104300000000001000416000000000001004b000003af0000c13d000002ea01000041000000000201041a000000010320019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000043004b000003b10000613d000002ca01000041000000000010043f0000002201000039000000040010043f000002cb0100004100000a54000104300000000001000416000000000001004b000003af0000c13d0a5209560000040f000000400200043d0000000000120435000002960020009c00000296020080410000004001200210000002c0011001c700000a530001042e000002fe01000041000000800010043f0000002001000039000000840010043f0000001501000039000000a40010043f000002ff01000041000000c40010043f000003000100004100000a54000104300000001f0530018f000002bf06300198000000400200043d0000000004620019000003d70000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000003780000c13d000003d70000013d000002bb01000041000000000101041a000002c102000041000000800020043f000500000003001d000000840030043f0000000003000414000002bd02100197000002960030009c0000029603008041000000c001300210000002c2011001c7000600000002001d0a520a4d0000040f00000060031002700000029603300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000080057001bf0000039a0000613d0000008008000039000000000901034f000000009a09043c0000000008a80436000000000058004b000003960000c13d000000000006004b000003a70000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f00000000006504350000000100200190000003cc0000613d0000001f01400039000000600210018f00000080012001bf000000400010043f000000200030008c000003ea0000813d000000000100001900000a5400010430000000800010043f000000000003004b000003ba0000613d000002ea02000041000000000020043f000000000001004b000003f40000c13d000000a001000039000003ff0000013d0000030d02200197000000a00020043f000000000001004b000000c001000039000000a001006039000003ff0000013d0000001f0530018f000002bf06300198000000400200043d0000000004620019000003d70000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000003c70000c13d000003d70000013d0000001f0530018f000002bf06300198000000400200043d0000000004620019000003d70000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000003d30000c13d000000000005004b000003e40000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000002960020009c00000296020080410000004002200210000000000112019f00000a54000104300000000004000411000000000004004b000004340000c13d000002cc03000041000000000031043500000084022001bf00000000000204350000004001100210000002cb011001c700000a5400010430000002ec0200004100000000040000190000000003040019000000000402041a000000a005300039000000000045043500000001022000390000002004300039000000000014004b000003f60000413d000000c001300039000000800210008a00000080010000390a52086a0000040f0000002001000039000000400200043d000600000002001d000000000212043600000080010000390a5208580000040f00000006020000290000000001210049000002960010009c00000296010080410000006001100210000002960020009c00000296020080410000004002200210000000000121019f00000a530001042e0000030d02200197000000a00020043f000000000001004b00000020020000390000000002006039000004a90000013d000000800100043d000400000001001d000000000030043f000002c401000041000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000003af0000613d000000000101043b000000000301041a00000006040000290003000000430053000005be0000813d000000400200043d000500000002001d000002cf010000410000000000120435000000040120003900000000020004110a52089b0000040f0000000502000029000004de0000013d000000800300043d000002c301000041000000000201041a000000000032001a000008520000413d000400000003001d0000000002320019000000000021041b000000000040043f000002c401000041000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000003af0000613d000000000101043b000000000201041a00000004030000290000000002320019000000000021041b000000400100043d0000000000310435000002960010009c000002960100804100000040011002100000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002c6011001c70000800d020000390000000303000039000002c704000041000000000500001900000000060004110a520a480000040f0000000100200190000003af0000613d000000400300043d000300000003001d000000440130003900000005020000290000000000210435000000240130003900000000020004100000000000210435000002c8010000410000000000130435000000040130003900000000020004110000000000210435000002960030009c0000029601000041000000000103401900000040011002100000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002c9011001c700000006020000290a520a480000040f00000060031002700000029603300197000000200030008c000000200400003900000000040340190000001f0540018f000000000b0400190000002006400190000000030a00002900000003046000290000048a0000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000048004b000004860000c13d000000000005004b000004970000613d000000000661034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f000000000054043500000001002001900000063f0000613d00000000010a001900000000020b001900060000000b001d0a52086a0000040f00000003010000290000000602000029000006220000013d000002f4030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000004a20000413d0000003f012000390000030b01100197000003010010009c000004b30000413d000002ca01000041000000000010043f0000004101000039000000040010043f000002cb0100004100000a54000104300000008002100039000000400020043f000002f603000041000000000403041a000000010540019000000001034002700000007f0330618f0000001f0030008c00000000060000390000000106002039000000000664013f0000000100600190000003560000c13d0000000000320435000000000005004b0000054e0000613d000002f604000041000000000040043f000000000003004b0000000004000019000005540000613d000002f805000041000000a00610003900000000040000190000000007460019000000000805041a000000000087043500000001055000390000002004400039000000000034004b000004cb0000413d000005540000013d000000040130006c0000062c0000813d000000400200043d000600000002001d0000030a0100004100000000001204350000000401200039000000000200041100000004040000290a52089b0000040f00000006020000290000000001210049000002960010009c00000296010080410000006001100210000002960020009c00000296020080410000004002200210000000000121019f00000a54000104300000000601000029000000000010043f000002d401000041000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000003af0000613d000000000101043b000000000201041a0000000103200039000000000031041b000000400100043d000000c00310003900000004040000290000000000430435000000a0031000390000000000230435000000800210003900000003030000290000000000320435000000600210003900000005030000290000000000320435000000400210003900000006030000290000000000320435000000c0020000390000000002210436000002d5030000410000000000320435000002d60010009c000004ad0000213d000000e003100039000000400030043f000002960020009c000002960200804100000040022002100000000001010433000002960010009c00000296010080410000006001100210000000000121019f0000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002d7011001c700008010020000390a520a4d0000040f0000000100200190000003af0000613d000000000101043b000400000001001d0a5209560000040f000002d802000041000000400300043d0000000000230435000000020230003900000000001204350000002201300039000000040200002900000000002104350000000001000367000000c402100370000000000202043b000400000002001d000000a401100370000000000101043b000100000001001d000002960030009c000002960300804100000040013002100000000002000414000002960020009c0000029602008041000000c002200210000000000121019f000002d9011001c700008010020000390a520a4d0000040f0000000100200190000003af0000613d000000400200043d0000000403000029000002da0030009c000006750000a13d000002df010000410000000000120435000000040120003900000004030000290000000000310435000002960020009c00000296020080410000004001200210000002cb011001c700000a54000104300000030d04400197000000a0051000390000000000450435000000000003004b000000200400003900000000040060390000003f034000390000030b033001970000000004230019000000000034004b000000000300003900000001030040390000029b0040009c000004ad0000213d0000000100300190000004ad0000c13d000000400040043f000003020040009c000004ad0000213d0000002003400039000200000003001d000000400030043f000500000004001d0000000000040435000000400500043d0000002003500039000000e004000039000000000043043500000303030000410000000000350435000000e004500039000000800300043d0000000000340435000600000005001d0000010004500039000000000003004b0000057b0000613d00000000050000190000000006450019000000a007500039000000000707043300000000007604350000002005500039000000000035004b000005740000413d000000000543001900000000000504350000001f033000390000030b033001970000000003430019000000060500002900000000045300490000004005500039000000000045043500000000060204330000000005630436000000000006004b000005910000613d000000a001100039000000000200001900000000035200190000000004210019000000000404043300000000004304350000002002200039000000000062004b0000058a0000413d000400000005001d000300000006001d00000000016500190000000000010435000003040100004100000000001004430000000001000414000002960010009c0000029601008041000000c001100210000002d3011001c70000800b020000390a520a4d0000040f0000000100200190000005bd0000613d000000000101043b00000006040000290000008002400039000000000300041000000000003204350000006002400039000000000012043500000003010000290000001f011000390000030b0110019700000004011000290000000002410049000000c0034000390000000000230435000000a0024000390000000000020435000000050200002900000000020204330000000001210436000000000002004b000004080000613d00000000030000190000000205000029000000005405043400000000014104360000000103300039000000000023004b000005b70000413d000004080000013d000000000001042f0000000001000411000000000010043f000002c401000041000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000003af0000613d000000000101043b0000000302000029000000000021041b000002c301000041000000000201041a00000006030000290000000002320049000000000021041b000000400100043d0000000000310435000002960010009c000002960100804100000040011002100000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002c6011001c70000800d020000390000000303000039000002c704000041000000000500041100000000060000190a520a480000040f0000000100200190000003af0000613d000000400300043d000600000003001d000000240130003900000004020000290000000000210435000002cd010000410000000000130435000000040130003900000000020004110000000000210435000002960030009c0000029601000041000000000103401900000040011002100000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002ce011001c700000005020000290a520a480000040f00000060031002700000029603300197000000200030008c000000200400003900000000040340190000001f0540018f000000000b0400190000002006400190000000060a00002900000006046000290000060d0000613d000000000701034f00000000080a0019000000007907043c0000000008980436000000000048004b000006090000c13d000000000005004b0000061a0000613d000000000661034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f00000000005404350000000100200190000006690000613d00000000010a001900000000020b001900050000000b001d0a52086a0000040f0000000601000029000000050200002900000000021200190a52088d0000040f000000400100043d00000004020000290000000000210435000002960010009c00000296010080410000004001100210000002c0011001c700000a530001042e000300000001001d000000060000006b000006320000c13d000000400100043d0000030902000041000006370000013d0000000001000411000000000001004b0000064b0000c13d000000400100043d0000030802000041000000000021043500000004021000390000000000020435000002960010009c00000296010080410000004001100210000002cb011001c700000a54000104300000001f0530018f000002bf06300198000000400200043d0000000004620019000003d70000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000006460000c13d000003d70000013d0000000601000029000000000010043f0000030701000041000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000003af0000613d000000000101043b0000000002000411000000000020043f000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000003af0000613d000000000101043b0000000302000029000000000021041b000003000000013d0000001f0530018f000002bf06300198000000400200043d0000000004620019000003d70000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000006700000c13d000003d70000013d000000000101043b0000006003200039000000040400002900000000004304350000004003200039000000010400002900000000004304350000002003200039000000020400002900000000004304350000000000120435000000000000043f000002960020009c000002960200804100000040012002100000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002db011001c700000001020000390a520a4d0000040f00000060031002700000029603300197000000200030008c000000200400003900000000040340190000001f0540018f00000020044001900000069a0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000006960000c13d000000000005004b000006a70000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f00000000005404350000000100200190000006c90000613d000000000100043d000002bd01100198000006d50000c13d000000400100043d000002dd02000041000006c30000013d000000030100002900000298001001980000000001000019000006c10000c13d0000000303000029000002e60230019700000001022001bf000002e703300197000002e8033001c7000000000001004b000000000302c0190000029702000041000000000032041b0000029800300198000006dd0000c13d000000400100043d000002fd02000041000006c30000013d000000400100043d00000299020000410000000000210435000002960010009c00000296010080410000004001100210000002de011001c700000a54000104300000001f0530018f000002bf06300198000000400200043d0000000004620019000003d70000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000006d00000c13d000003d70000013d000000060010006c0000070c0000c13d0000000601000029000000050200002900000003030000290a5209100000040f000000000100001900000a530001042e000002bb02000041000000000302041a000002e90330019700000006033001af000000000032041b000000800200043d0000029b0020009c000004ad0000213d000002ea03000041000000000403041a000000010040019000000001034002700000007f0330618f0000001f0030008c00000000050000390000000105002039000000000454013f0000000100400190000003560000c13d000000200030008c000007020000413d000002ea04000041000000000040043f0000001f042000390000000504400270000002eb0440009a000000200020008c000002ec040040410000001f033000390000000503300270000002eb0330009a000000000034004b000007020000813d000000000004041b0000000104400039000000000034004b000006fe0000413d0000001f0020008c0000000103200210000007190000a13d000002ea04000041000000000040043f0000030b06200198000007230000c13d0000002005000039000002ec040000410000072f0000013d000000400200043d000000240320003900000006040000290000000000430435000002dc03000041000000000032043500000004032000390000000000130435000002960020009c00000296020080410000004001200210000002ce011001c700000a5400010430000000000002004b00000000040000190000071d0000613d000000a00400043d00000003022002100000030c0220027f0000030c02200167000000000224016f000000000232019f0000073a0000013d000002ec040000410000002005000039000000010760008a0000000507700270000002ed0770009a00000080085000390000000008080433000000000084041b00000020055000390000000104400039000000000074004b000007280000c13d000000000026004b000007390000813d0000000302200210000000f80220018f0000030c0220027f0000030c0220016700000080055000390000000005050433000000000225016f000000000024041b00000001023001bf000002ea03000041000000000023041b000000050200002900000000020204330000029b0020009c000004ad0000213d000002e103000041000000000403041a000000010040019000000001034002700000007f0330618f0000001f0030008c00000000050000390000000105002039000000000454013f0000000100400190000003560000c13d000000200030008c0000075d0000413d000002e104000041000000000040043f0000001f042000390000000504400270000002ee0440009a000000200020008c000002e2040040410000001f033000390000000503300270000002ee0330009a000000000034004b0000075d0000813d000000000004041b0000000104400039000000000034004b000007590000413d0000001f0020008c0000000103200210000007670000a13d000002e104000041000000000040043f0000030b06200198000007720000c13d0000002005000039000002e2040000410000077f0000013d000000000002004b00000000040000190000076c0000613d0000000404000029000000000404043300000003022002100000030c0220027f0000030c02200167000000000224016f000000000232019f0000078a0000013d000002e2040000410000002005000039000000010760008a0000000507700270000002ef0770009a000000050900002900000000089500190000000008080433000000000084041b00000020055000390000000104400039000000000074004b000007780000c13d000000000026004b000007890000813d0000000302200210000000f80220018f0000030c0220027f0000030c0220016700000005055000290000000005050433000000000225016f000000000024041b00000001023001bf000002e103000041000000000023041b0000029702000041000000000202041a0000029800200198000006be0000613d000000400200043d000002f00020009c000004ad0000213d0000004003200039000000400030043f00000001030000390000000004320436000002f1050000410000000000540435000000800500043d0000029b0050009c000004ad0000213d000002f206000041000000000706041a000000010070019000000001067002700000007f0660618f0000001f0060008c00000000080000390000000108002039000000000787013f0000000100700190000003560000c13d000000200060008c000007b90000413d000002f207000041000000000070043f0000001f075000390000000507700270000002f30770009a000000200050008c000002f4070040410000001f066000390000000506600270000002f30660009a000000000067004b000007b90000813d000000000007041b0000000107700039000000000067004b000007b50000413d0000001f0050008c000007c20000a13d000002f206000041000000000060043f0000030b07500198000007cd0000c13d000000a008000039000002f406000041000007db0000013d000000000005004b0000000006000019000007c60000613d000000a00600043d00000003075002100000030c0770027f0000030c07700167000000000676016f0000000105500210000000000556019f000007e60000013d000002f4060000410000002009000039000000010870008a0000000508800270000002f50880009a000000000a09001900000080099000390000000009090433000000000096041b0000002009a000390000000106600039000000000086004b000007d20000c13d000000a008a00039000000000057004b000007e40000813d0000000307500210000000f80770018f0000030c0770027f0000030c077001670000000008080433000000000778016f000000000076041b000000010550021000000001055001bf000002f206000041000000000056041b00000000050204330000029b0050009c000004ad0000213d000002f606000041000000000706041a000000010070019000000001067002700000007f0660618f0000001f0060008c00000000080000390000000108002039000000000787013f0000000100700190000003560000c13d000000200060008c000008080000413d000002f607000041000000000070043f0000001f075000390000000507700270000002f70770009a000000200050008c000002f8070040410000001f066000390000000506600270000002f70660009a000000000067004b000008080000813d000000000007041b0000000107700039000000000067004b000008040000413d0000001f0050008c000008110000a13d000002f604000041000000000040043f0000030b075001980000081c0000c13d0000002006000039000002f804000041000008280000013d000000000005004b0000000002000019000008150000613d000000000204043300000003045002100000030c0440027f0000030c04400167000000000242016f0000000104500210000000000242019f000008340000013d000002f8040000410000002006000039000000010870008a0000000508800270000002f90880009a00000000092600190000000009090433000000000094041b00000020066000390000000104400039000000000084004b000008210000c13d000000000057004b000008320000813d0000000307500210000000f80770018f0000030c0770027f0000030c0770016700000000022600190000000002020433000000000272016f000000000024041b000000010250021000000001022001bf000002f604000041000000000024041b000002fa02000041000000000002041b000002fb02000041000000000002041b000000000001004b000008500000c13d0000029701000041000000000201041a000002fc02200197000000000021041b000000400100043d0000000000310435000002960010009c000002960100804100000040011002100000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002c6011001c70000800d020000390000029d040000410a520a480000040f0000000100200190000003af0000613d000000000100001900000a530001042e000002ca01000041000000000010043f0000001101000039000000040010043f000002cb0100004100000a540001043000000000430104340000000001320436000000000003004b000008640000613d000000000200001900000000052100190000000006240019000000000606043300000000006504350000002002200039000000000032004b0000085d0000413d000000000231001900000000000204350000001f023000390000030b022001970000000001210019000000000001042d0000001f022000390000030b022001970000000001120019000000000021004b000000000200003900000001020040390000029b0010009c000008760000213d0000000100200190000008760000c13d000000400010043f000000000001042d000002ca01000041000000000010043f0000004101000039000000040010043f000002cb0100004100000a5400010430000002bd01100197000000000010043f0000030701000041000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f00000001002001900000088b0000613d000000000101043b000000000001042d000000000100001900000a540001043000000000021200490000030e0020009c000008990000213d0000001f0020008c000008990000a13d0000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000008990000c13d000000000001042d000000000100001900000a54000104300000004005100039000000000045043500000020041000390000000000340435000002bd0220019700000000002104350000006001100039000000000001042d0005000000000002000500000003001d000002bd03100198000008f10000613d000100000001001d000302bd0020019c000008f40000613d000400000003001d000000000030043f000002c401000041000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000008ef0000613d000000000101043b000000000301041a0002000500300074000008fe0000413d0000000401000029000000000010043f000002c401000041000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000008ef0000613d000000000101043b0000000202000029000000000021041b0000000301000029000000000010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f0000000100200190000008ef0000613d000000000101043b000000000201041a00000005030000290000000002320019000000000021041b000000400100043d0000000000310435000002960010009c000002960100804100000040011002100000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002c6011001c70000800d020000390000000303000039000002c704000041000000040500002900000003060000290a520a480000040f0000000100200190000008ef0000613d000000000001042d000000000100001900000a5400010430000000400100043d000002d002000041000008f60000013d000000400100043d000002cc02000041000000000021043500000004021000390000000000020435000002960010009c00000296010080410000004001100210000002cb011001c700000a5400010430000000400200043d000400000002001d000002cf0100004100000000001204350000000401200039000000010200002900000005040000290a52089b0000040f00000004020000290000000001210049000002960010009c00000296010080410000006001100210000002960020009c00000296020080410000004002200210000000000121019f00000a54000104300003000000000002000002bd01100198000009490000613d000200000003001d000302bd0020019c0000094c0000613d000100000001001d000000000010043f0000030701000041000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f00000001002001900000000303000029000009470000613d000000000101043b000000000030043f000000200010043f0000000001000414000002960010009c0000029601008041000000c001100210000002c5011001c700008010020000390a520a4d0000040f00000003060000290000000100200190000009470000613d000000000101043b0000000202000029000000000021041b000000400100043d0000000000210435000002960010009c000002960100804100000040011002100000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002c6011001c70000800d0200003900000003030000390000030f0400004100000001050000290a520a480000040f0000000100200190000009470000613d000000000001042d000000000100001900000a5400010430000000400100043d00000309020000410000094e0000013d000000400100043d0000030802000041000000000021043500000004021000390000000000020435000002960010009c00000296010080410000004001100210000002cb011001c700000a54000104300002000000000002000002f201000041000000000401041a000000010540019000000001024002700000007f0220618f0000001f0020008c00000000010000390000000101002039000000000015004b00000a2b0000c13d000000400300043d0000000001230436000000000005004b000009730000613d000002f204000041000000000040043f000000000002004b000009790000613d000002f40500004100000000040000190000000006410019000000000705041a000000000076043500000001055000390000002004400039000000000024004b0000096b0000413d0000097a0000013d0000030d044001970000000000410435000000000002004b000000200400003900000000040060390000097a0000013d00000000040000190000003f02400039000000200900008a000000000492016f0000000002340019000000000042004b000000000400003900000001040040390000029b0020009c00000a230000213d000000010040019000000a230000c13d000000400020043f0000000003030433000000000003004b0000099e0000613d000002960030009c00000296030080410000006002300210000002960010009c00000296010080410000004001100210000000000112019f0000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002d7011001c700008010020000390a520a4d0000040f000000010020019000000a290000613d000000400200043d000000000801043b000000200900008a000009a20000013d000002fa01000041000000000801041a000000000008004b0000031008006041000002f601000041000000000401041a000000010540019000000001034002700000007f0330618f0000001f0030008c00000000010000390000000101002039000000000114013f000000010010019000000a2b0000c13d0000000001320436000000000005004b000009be0000613d000002f604000041000000000040043f000000000003004b000009c40000613d000002f80500004100000000040000190000000006410019000000000705041a000000000076043500000001055000390000002004400039000000000034004b000009b60000413d000009c50000013d0000030d044001970000000000410435000000000003004b00000020040000390000000004006039000009c50000013d00000000040000190000003f03400039000000000393016f0000000004230019000000000034004b000000000300003900000001030040390000029b0040009c00000a230000213d000000010030019000000a230000c13d000000400040043f0000000002020433000000000002004b000009e90000613d000200000008001d000002960020009c00000296020080410000006002200210000002960010009c00000296010080410000004001100210000000000112019f0000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002d7011001c700008010020000390a520a4d0000040f000000010020019000000a290000613d000000400400043d000000000101043b0000000208000029000009ed0000013d000002fb01000041000000000101041a000000000001004b0000031001006041000200000004001d000000600240003900000000001204350000004001400039000000000081043500000020024000390000031101000041000100000002001d0000000000120435000003040100004100000000001004430000000001000414000002960010009c0000029601008041000000c001100210000002d3011001c70000800b020000390a520a4d0000040f000000010020019000000a310000613d000000000101043b0000000204000029000000a0024000390000000003000410000000000032043500000080024000390000000000120435000000a0010000390000000000140435000003120040009c00000a230000213d000000c001400039000000400010043f0000000101000029000002960010009c000002960100804100000040011002100000000002040433000002960020009c00000296020080410000006002200210000000000112019f0000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002d7011001c700008010020000390a520a4d0000040f000000010020019000000a290000613d000000000101043b000000000001042d000002ca01000041000000000010043f0000004101000039000000040010043f000002cb0100004100000a5400010430000000000100001900000a5400010430000002ca01000041000000000010043f0000002201000039000000040010043f000002cb0100004100000a5400010430000000000001042f000000000001042f000002960010009c00000296010080410000004001100210000002960020009c00000296020080410000006002200210000000000112019f0000000002000414000002960020009c0000029602008041000000c002200210000000000112019f000002d7011001c700008010020000390a520a4d0000040f000000010020019000000a460000613d000000000101043b000000000001042d000000000100001900000a540001043000000a4b002104210000000102000039000000000001042d0000000002000019000000000001042d00000a50002104230000000102000039000000000001042d0000000002000019000000000001042d00000a520000043200000a530001042e00000a540001043000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000fffffffff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a000000000000000000000000000000000000000000000000ff0000000000000000f92ee8a9000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000800000000000000000000000000000000000000000000000000000000000000000ffffffffffffffff0200000000000000000000000000000000000020000000800000000000000000c7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d20000000200000000000000000000000000000040000001000000000000000000000000000000000000000000000000000000000000000000000000007ecebdff00000000000000000000000000000000000000000000000000000000aa24698500000000000000000000000000000000000000000000000000000000de0e9a3d00000000000000000000000000000000000000000000000000000000de0e9a3e00000000000000000000000000000000000000000000000000000000ea598cb000000000000000000000000000000000000000000000000000000000f3f2b63e00000000000000000000000000000000000000000000000000000000aa24698600000000000000000000000000000000000000000000000000000000d505accf00000000000000000000000000000000000000000000000000000000dd62ed3e000000000000000000000000000000000000000000000000000000009065714600000000000000000000000000000000000000000000000000000000906571470000000000000000000000000000000000000000000000000000000095d89b4100000000000000000000000000000000000000000000000000000000a9059cbb000000000000000000000000000000000000000000000000000000007ecebe000000000000000000000000000000000000000000000000000000000084b0196e000000000000000000000000000000000000000000000000000000003644e514000000000000000000000000000000000000000000000000000000003e969f9b000000000000000000000000000000000000000000000000000000003e969f9c00000000000000000000000000000000000000000000000000000000597da51d0000000000000000000000000000000000000000000000000000000070a08231000000000000000000000000000000000000000000000000000000003644e5150000000000000000000000000000000000000000000000000000000039648e000000000000000000000000000000000000000000000000000000000018160ddc0000000000000000000000000000000000000000000000000000000018160ddd0000000000000000000000000000000000000000000000000000000023b872dd00000000000000000000000000000000000000000000000000000000313ce5670000000000000000000000000000000000000000000000000000000006fdde0300000000000000000000000000000000000000000000000000000000095ea7b3ddf967707f52bbdea6c202114c491d81e6de0cb9ded430e88a276a6f8d3e3800cae791ed00000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000004400000080000000000000000000000000000000000000000000000000000000000000000000000000ffffffe00000000000000000000000000000000000000020000000000000000000000000c6e6f59200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002400000080000000000000000052c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0252c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0002000000000000000000000000000000000000400000000000000000000000000200000000000000000000000000000000000020000000000000000000000000ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef23b872dd0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000640000000000000000000000004e487b71000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000024000000000000000000000000ec442f0500000000000000000000000000000000000000000000000000000000a9059cbb000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044000000000000000000000000e450d38c0000000000000000000000000000000000000000000000000000000096c6fd1e000000000000000000000000000000000000000000000000000000001f2a200500000000000000000000000000000000000000000000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d9553913202000002000000000000000000000000000000040000000000000000000000005ab42ced628888259c08ac98db1eb0cf702fc1501344311d8b100cd1bfe4bb006e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9000000000000000000000000000000000000000000000000ffffffffffffff1f0200000000000000000000000000000000000000000000000000000000000000190100000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000420000000000000000000000007fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a000000000000000000000000000000000000000800000000000000000000000004b800e4600000000000000000000000000000000000000000000000000000000f645eedf000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000d78bce0c00000000000000000000000000000000000000000000000000000000627913020000000000000000000000000000000000000000000000000000000052c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0446a2803e59a4de4e7a4c574b1243f25977ac4c77d5a1a4a609b5394cebb4a2aa000000000000000000000000000000000000000000000000ffffffffffffff7f1806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000000000000010000000000000001ffffffffffffffffffffffff000000000000000000000000000000000000000052c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace03d51f7571d6dac09653a26865efe6a95470726282129c05857c4e903b89b715502ae08a8e29253f69ac5d979a101956ab8f8d9d7ded63fa7a83b16fc47648eab0d51f7571d6dac09653a26865efe6a95470726282129c05857c4e903b89b7154fb95d7fc1a65b21b185b3a8b4edbc0da68853b3882a5e5b59f64ac6b3144b5d56b95d7fc1a65b21b185b3a8b4edbc0da68853b3882a5e5b59f64ac6b3144b5d55000000000000000000000000000000000000000000000000ffffffffffffffbf3100000000000000000000000000000000000000000000000000000000000000a16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d102bd52a2c1e0d1918f12309266e475cfdc2c0357fb85ecea6d0612460264762a8342ad5d3e1f2e6e70edcf6d991b8a3023d3fca8047a131592f9edb9fd9b89d57dbd52a2c1e0d1918f12309266e475cfdc2c0357fb85ecea6d0612460264762a82a16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d103a0631cb7ea071eebce38448a571977956eb8708003e244f56723dbf02228948b5f9ce34815f8e11431c7bb75a8e6886a91478f7ffc1dbb0a98dc240fddd76b75a0631cb7ea071eebce38448a571977956eb8708003e244f56723dbf02228948aa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d100a16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d101ffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffd7e6bcf80000000000000000000000000000000000000000000000000000000008c379a0000000000000000000000000000000000000000000000000000000004549503731323a20556e696e697469616c697a656400000000000000000000000000000000000000000000000000000000000064000000800000000000000000000000000000000000000000000000000000000000000000ffffffffffffff80000000000000000000000000000000000000000000000000ffffffffffffffdf0f000000000000000000000000000000000000000000000000000000000000009a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b00000000000000000000000000000000000000200000008000000000000000000000000000000000000000000000000000000000000000000de0b6b3a764000052c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0194280d6200000000000000000000000000000000000000000000000000000000e602df0500000000000000000000000000000000000000000000000000000000fb8f41b200000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4708b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f000000000000000000000000000000000000000000000000ffffffffffffff3f000000000000000000000000000000000000000000000000000000000000000006aa79e0511784dd38a0e0727e55bb103b9c09296fb350a5bc3e360f00329fba
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 34 Chains
Chain | Token | Portfolio % | Price | Amount | Value |
---|
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.