Overview
ETH Balance
0 ETH
ETH Value
$0.00More Info
Private Name Tags
ContractCreator
| Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
|---|---|---|---|---|---|---|---|---|---|
Latest 1 internal transaction
| Parent Transaction Hash | Block | From | To | |||
|---|---|---|---|---|---|---|
| 861921 | 21 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:
Adventurer
Compiler Version
v0.8.27-1.0.1
ZkSolc Version
v1.5.7
Contract Source Code (Solidity)
/**
*Submitted for verification at abscan.org on 2025-02-03
*/
// SPDX-License-Identifier: MIT
pragma solidity =0.8.27 ^0.8.0 ^0.8.20 ^0.8.4;
// lib/ERC721A-Upgradeable/contracts/ERC721AStorage.sol
library ERC721AStorage {
// Bypass for a `--via-ir` bug (https://github.com/chiru-labs/ERC721A/pull/364).
struct TokenApprovalRef {
address value;
}
struct Layout {
// =============================================================
// STORAGE
// =============================================================
// The next token ID to be minted.
uint256 _currentIndex;
// The number of tokens burned.
uint256 _burnCounter;
// Token name
string _name;
// Token symbol
string _symbol;
// Mapping from token ID to ownership details
// An empty struct value does not necessarily mean the token is unowned.
// See {_packedOwnershipOf} implementation for details.
//
// Bits Layout:
// - [0..159] `addr`
// - [160..223] `startTimestamp`
// - [224] `burned`
// - [225] `nextInitialized`
// - [232..255] `extraData`
mapping(uint256 => uint256) _packedOwnerships;
// Mapping owner address to address data.
//
// Bits Layout:
// - [0..63] `balance`
// - [64..127] `numberMinted`
// - [128..191] `numberBurned`
// - [192..255] `aux`
mapping(address => uint256) _packedAddressData;
// Mapping from token ID to approved address.
mapping(uint256 => ERC721AStorage.TokenApprovalRef) _tokenApprovals;
// Mapping from owner to operator approvals
mapping(address => mapping(address => bool)) _operatorApprovals;
}
bytes32 internal constant STORAGE_SLOT = keccak256('ERC721A.contracts.storage.ERC721A');
function layout() internal pure returns (Layout storage l) {
bytes32 slot = STORAGE_SLOT;
assembly {
l.slot := slot
}
}
}
// lib/ERC721A-Upgradeable/contracts/ERC721A__InitializableStorage.sol
/**
* @dev This is a base storage for the initialization function for upgradeable diamond facet contracts
**/
library ERC721A__InitializableStorage {
struct Layout {
/*
* Indicates that the contract has been initialized.
*/
bool _initialized;
/*
* Indicates that the contract is in the process of being initialized.
*/
bool _initializing;
}
bytes32 internal constant STORAGE_SLOT = keccak256('ERC721A.contracts.storage.initializable.facet');
function layout() internal pure returns (Layout storage l) {
bytes32 slot = STORAGE_SLOT;
assembly {
l.slot := slot
}
}
}
// lib/ERC721A-Upgradeable/contracts/IERC721AUpgradeable.sol
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
/**
* @dev Interface of ERC721A.
*/
interface IERC721AUpgradeable {
/**
* The caller must own the token or be an approved operator.
*/
error ApprovalCallerNotOwnerNorApproved();
/**
* The token does not exist.
*/
error ApprovalQueryForNonexistentToken();
/**
* Cannot query the balance for the zero address.
*/
error BalanceQueryForZeroAddress();
/**
* Cannot mint to the zero address.
*/
error MintToZeroAddress();
/**
* The quantity of tokens minted must be more than zero.
*/
error MintZeroQuantity();
/**
* The token does not exist.
*/
error OwnerQueryForNonexistentToken();
/**
* The caller must own the token or be an approved operator.
*/
error TransferCallerNotOwnerNorApproved();
/**
* The token must be owned by `from`.
*/
error TransferFromIncorrectOwner();
/**
* Cannot safely transfer to a contract that does not implement the
* ERC721Receiver interface.
*/
error TransferToNonERC721ReceiverImplementer();
/**
* Cannot transfer to the zero address.
*/
error TransferToZeroAddress();
/**
* The token does not exist.
*/
error URIQueryForNonexistentToken();
/**
* The `quantity` minted with ERC2309 exceeds the safety limit.
*/
error MintERC2309QuantityExceedsLimit();
/**
* The `extraData` cannot be set on an unintialized ownership slot.
*/
error OwnershipNotInitializedForExtraData();
// =============================================================
// STRUCTS
// =============================================================
struct TokenOwnership {
// The address of the owner.
address addr;
// Stores the start time of ownership with minimal overhead for tokenomics.
uint64 startTimestamp;
// Whether the token has been burned.
bool burned;
// Arbitrary data similar to `startTimestamp` that can be set via {_extraData}.
uint24 extraData;
}
// =============================================================
// TOKEN COUNTERS
// =============================================================
/**
* @dev Returns the total number of tokens in existence.
* Burned tokens will reduce the count.
* To get the total number of tokens minted, please see {_totalMinted}.
*/
function totalSupply() external view returns (uint256);
// =============================================================
// IERC165
// =============================================================
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
* to learn more about how these ids are created.
*
* This function call must use less than 30000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
// =============================================================
// IERC721
// =============================================================
/**
* @dev Emitted when `tokenId` token is transferred from `from` to `to`.
*/
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
*/
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables or disables
* (`approved`) `operator` to manage all of its assets.
*/
event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
/**
* @dev Returns the number of tokens in `owner`'s account.
*/
function balanceOf(address owner) external view returns (uint256 balance);
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) external view returns (address owner);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`,
* checking first that contract recipients are aware of the ERC721 protocol
* to prevent tokens from being forever locked.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be have been allowed to move
* this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement
* {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes calldata data
) external payable;
/**
* @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) external payable;
/**
* @dev Transfers `tokenId` from `from` to `to`.
*
* WARNING: Usage of this method is discouraged, use {safeTransferFrom}
* whenever possible.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) external payable;
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the
* zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) external payable;
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom}
* for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool _approved) external;
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) external view returns (address operator);
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address owner, address operator) external view returns (bool);
// =============================================================
// IERC721Metadata
// =============================================================
/**
* @dev Returns the token collection name.
*/
function name() external view returns (string memory);
/**
* @dev Returns the token collection symbol.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) external view returns (string memory);
// =============================================================
// IERC2309
// =============================================================
/**
* @dev Emitted when tokens in `fromTokenId` to `toTokenId`
* (inclusive) is transferred from `from` to `to`, as defined in the
* [ERC2309](https://eips.ethereum.org/EIPS/eip-2309) standard.
*
* See {_mintERC2309} for more details.
*/
event ConsecutiveTransfer(uint256 indexed fromTokenId, uint256 toTokenId, address indexed from, address indexed to);
}
// lib/openzeppelin-contracts-upgradeable/contracts/proxy/utils/Initializable.sol
// OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/Initializable.sol)
/**
* @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
* behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
* external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
* function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
*
* The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
* reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
* case an upgrade adds a module that needs to be initialized.
*
* For example:
*
* [.hljs-theme-light.nopadding]
* ```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
}
}
}
// lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/interfaces/draft-IERC1822.sol
// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC1822.sol)
/**
* @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
* proxy whose upgrades are fully controlled by the current implementation.
*/
interface IERC1822Proxiable {
/**
* @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
* address.
*
* IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
* bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
* function revert if invoked through a proxy.
*/
function proxiableUUID() external view returns (bytes32);
}
// lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/proxy/beacon/IBeacon.sol
// OpenZeppelin Contracts (last updated v5.0.0) (proxy/beacon/IBeacon.sol)
/**
* @dev This is the interface that {BeaconProxy} expects of its beacon.
*/
interface IBeacon {
/**
* @dev Must return an address that can be used as a delegate call target.
*
* {UpgradeableBeacon} will check that this address is a contract.
*/
function implementation() external view returns (address);
}
// lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/utils/Address.sol
// OpenZeppelin Contracts (last updated v5.0.0) (utils/Address.sol)
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev The ETH balance of the account is not enough to perform the operation.
*/
error AddressInsufficientBalance(address account);
/**
* @dev There's no code at `target` (it is not a contract).
*/
error AddressEmptyCode(address target);
/**
* @dev A call to an address target failed. The target may have reverted.
*/
error FailedInnerCall();
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.8.20/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
if (address(this).balance < amount) {
revert AddressInsufficientBalance(address(this));
}
(bool success, ) = recipient.call{value: amount}("");
if (!success) {
revert FailedInnerCall();
}
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason or custom error, it is bubbled
* up by this function (like regular Solidity function calls). However, if
* the call reverted with no returned reason, this function reverts with a
* {FailedInnerCall} error.
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*/
function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
if (address(this).balance < value) {
revert AddressInsufficientBalance(address(this));
}
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and reverts if the target
* was not a contract or bubbling up the revert reason (falling back to {FailedInnerCall}) in case of an
* unsuccessful call.
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata
) internal view returns (bytes memory) {
if (!success) {
_revert(returndata);
} else {
// only check if target is a contract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
if (returndata.length == 0 && target.code.length == 0) {
revert AddressEmptyCode(target);
}
return returndata;
}
}
/**
* @dev Tool to verify that a low level call was successful, and reverts if it wasn't, either by bubbling the
* revert reason or with a default {FailedInnerCall} error.
*/
function verifyCallResult(bool success, bytes memory returndata) internal pure returns (bytes memory) {
if (!success) {
_revert(returndata);
} else {
return returndata;
}
}
/**
* @dev Reverts with returndata if present. Otherwise reverts with {FailedInnerCall}.
*/
function _revert(bytes memory returndata) private pure {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert FailedInnerCall();
}
}
}
// lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/utils/StorageSlot.sol
// OpenZeppelin Contracts (last updated v5.0.0) (utils/StorageSlot.sol)
// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
/**
* @dev Library for reading and writing primitive types to specific storage slots.
*
* Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
* This library helps with reading and writing to such slots without the need for inline assembly.
*
* The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
*
* Example usage to set ERC1967 implementation slot:
* ```solidity
* contract ERC1967 {
* bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
*
* function _getImplementation() internal view returns (address) {
* return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
* }
*
* function _setImplementation(address newImplementation) internal {
* require(newImplementation.code.length > 0);
* StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
* }
* }
* ```
*/
library StorageSlot {
struct AddressSlot {
address value;
}
struct BooleanSlot {
bool value;
}
struct Bytes32Slot {
bytes32 value;
}
struct Uint256Slot {
uint256 value;
}
struct StringSlot {
string value;
}
struct BytesSlot {
bytes value;
}
/**
* @dev Returns an `AddressSlot` with member `value` located at `slot`.
*/
function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `BooleanSlot` with member `value` located at `slot`.
*/
function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
*/
function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `Uint256Slot` with member `value` located at `slot`.
*/
function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `StringSlot` with member `value` located at `slot`.
*/
function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `StringSlot` representation of the string storage pointer `store`.
*/
function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := store.slot
}
}
/**
* @dev Returns an `BytesSlot` with member `value` located at `slot`.
*/
function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
*/
function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := store.slot
}
}
}
// lib/solady/src/auth/Ownable.sol
/// @notice Simple single owner authorization mixin.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/auth/Ownable.sol)
///
/// @dev Note:
/// This implementation does NOT auto-initialize the owner to `msg.sender`.
/// You MUST call the `_initializeOwner` in the constructor / initializer.
///
/// While the ownable portion follows
/// [EIP-173](https://eips.ethereum.org/EIPS/eip-173) for compatibility,
/// the nomenclature for the 2-step ownership handover may be unique to this codebase.
abstract contract Ownable {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The caller is not authorized to call the function.
error Unauthorized();
/// @dev The `newOwner` cannot be the zero address.
error NewOwnerIsZeroAddress();
/// @dev The `pendingOwner` does not have a valid handover request.
error NoHandoverRequest();
/// @dev Cannot double-initialize.
error AlreadyInitialized();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* EVENTS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The ownership is transferred from `oldOwner` to `newOwner`.
/// This event is intentionally kept the same as OpenZeppelin's Ownable to be
/// compatible with indexers and [EIP-173](https://eips.ethereum.org/EIPS/eip-173),
/// despite it not being as lightweight as a single argument event.
event OwnershipTransferred(address indexed oldOwner, address indexed newOwner);
/// @dev An ownership handover to `pendingOwner` has been requested.
event OwnershipHandoverRequested(address indexed pendingOwner);
/// @dev The ownership handover to `pendingOwner` has been canceled.
event OwnershipHandoverCanceled(address indexed pendingOwner);
/// @dev `keccak256(bytes("OwnershipTransferred(address,address)"))`.
uint256 private constant _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE =
0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0;
/// @dev `keccak256(bytes("OwnershipHandoverRequested(address)"))`.
uint256 private constant _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE =
0xdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d;
/// @dev `keccak256(bytes("OwnershipHandoverCanceled(address)"))`.
uint256 private constant _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE =
0xfa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c92;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* STORAGE */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The owner slot is given by:
/// `bytes32(~uint256(uint32(bytes4(keccak256("_OWNER_SLOT_NOT")))))`.
/// It is intentionally chosen to be a high value
/// to avoid collision with lower slots.
/// The choice of manual storage layout is to enable compatibility
/// with both regular and upgradeable contracts.
bytes32 internal constant _OWNER_SLOT =
0xffffffffffffffffffffffffffffffffffffffffffffffffffffffff74873927;
/// The ownership handover slot of `newOwner` is given by:
/// ```
/// mstore(0x00, or(shl(96, user), _HANDOVER_SLOT_SEED))
/// let handoverSlot := keccak256(0x00, 0x20)
/// ```
/// It stores the expiry timestamp of the two-step ownership handover.
uint256 private constant _HANDOVER_SLOT_SEED = 0x389a75e1;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* INTERNAL FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Override to return true to make `_initializeOwner` prevent double-initialization.
function _guardInitializeOwner() internal pure virtual returns (bool guard) {}
/// @dev Initializes the owner directly without authorization guard.
/// This function must be called upon initialization,
/// regardless of whether the contract is upgradeable or not.
/// This is to enable generalization to both regular and upgradeable contracts,
/// and to save gas in case the initial owner is not the caller.
/// For performance reasons, this function will not check if there
/// is an existing owner.
function _initializeOwner(address newOwner) internal virtual {
if (_guardInitializeOwner()) {
/// @solidity memory-safe-assembly
assembly {
let ownerSlot := _OWNER_SLOT
if sload(ownerSlot) {
mstore(0x00, 0x0dc149f0) // `AlreadyInitialized()`.
revert(0x1c, 0x04)
}
// Clean the upper 96 bits.
newOwner := shr(96, shl(96, newOwner))
// Store the new value.
sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner))))
// Emit the {OwnershipTransferred} event.
log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner)
}
} else {
/// @solidity memory-safe-assembly
assembly {
// Clean the upper 96 bits.
newOwner := shr(96, shl(96, newOwner))
// Store the new value.
sstore(_OWNER_SLOT, newOwner)
// Emit the {OwnershipTransferred} event.
log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner)
}
}
}
/// @dev Sets the owner directly without authorization guard.
function _setOwner(address newOwner) internal virtual {
if (_guardInitializeOwner()) {
/// @solidity memory-safe-assembly
assembly {
let ownerSlot := _OWNER_SLOT
// Clean the upper 96 bits.
newOwner := shr(96, shl(96, newOwner))
// Emit the {OwnershipTransferred} event.
log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner)
// Store the new value.
sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner))))
}
} else {
/// @solidity memory-safe-assembly
assembly {
let ownerSlot := _OWNER_SLOT
// Clean the upper 96 bits.
newOwner := shr(96, shl(96, newOwner))
// Emit the {OwnershipTransferred} event.
log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner)
// Store the new value.
sstore(ownerSlot, newOwner)
}
}
}
/// @dev Throws if the sender is not the owner.
function _checkOwner() internal view virtual {
/// @solidity memory-safe-assembly
assembly {
// If the caller is not the stored owner, revert.
if iszero(eq(caller(), sload(_OWNER_SLOT))) {
mstore(0x00, 0x82b42900) // `Unauthorized()`.
revert(0x1c, 0x04)
}
}
}
/// @dev Returns how long a two-step ownership handover is valid for in seconds.
/// Override to return a different value if needed.
/// Made internal to conserve bytecode. Wrap it in a public function if needed.
function _ownershipHandoverValidFor() internal view virtual returns (uint64) {
return 48 * 3600;
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* PUBLIC UPDATE FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Allows the owner to transfer the ownership to `newOwner`.
function transferOwnership(address newOwner) public payable virtual onlyOwner {
/// @solidity memory-safe-assembly
assembly {
if iszero(shl(96, newOwner)) {
mstore(0x00, 0x7448fbae) // `NewOwnerIsZeroAddress()`.
revert(0x1c, 0x04)
}
}
_setOwner(newOwner);
}
/// @dev Allows the owner to renounce their ownership.
function renounceOwnership() public payable virtual onlyOwner {
_setOwner(address(0));
}
/// @dev Request a two-step ownership handover to the caller.
/// The request will automatically expire in 48 hours (172800 seconds) by default.
function requestOwnershipHandover() public payable virtual {
unchecked {
uint256 expires = block.timestamp + _ownershipHandoverValidFor();
/// @solidity memory-safe-assembly
assembly {
// Compute and set the handover slot to `expires`.
mstore(0x0c, _HANDOVER_SLOT_SEED)
mstore(0x00, caller())
sstore(keccak256(0x0c, 0x20), expires)
// Emit the {OwnershipHandoverRequested} event.
log2(0, 0, _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE, caller())
}
}
}
/// @dev Cancels the two-step ownership handover to the caller, if any.
function cancelOwnershipHandover() public payable virtual {
/// @solidity memory-safe-assembly
assembly {
// Compute and set the handover slot to 0.
mstore(0x0c, _HANDOVER_SLOT_SEED)
mstore(0x00, caller())
sstore(keccak256(0x0c, 0x20), 0)
// Emit the {OwnershipHandoverCanceled} event.
log2(0, 0, _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE, caller())
}
}
/// @dev Allows the owner to complete the two-step ownership handover to `pendingOwner`.
/// Reverts if there is no existing ownership handover requested by `pendingOwner`.
function completeOwnershipHandover(address pendingOwner) public payable virtual onlyOwner {
/// @solidity memory-safe-assembly
assembly {
// Compute and set the handover slot to 0.
mstore(0x0c, _HANDOVER_SLOT_SEED)
mstore(0x00, pendingOwner)
let handoverSlot := keccak256(0x0c, 0x20)
// If the handover does not exist, or has expired.
if gt(timestamp(), sload(handoverSlot)) {
mstore(0x00, 0x6f5e8818) // `NoHandoverRequest()`.
revert(0x1c, 0x04)
}
// Set the handover slot to 0.
sstore(handoverSlot, 0)
}
_setOwner(pendingOwner);
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* PUBLIC READ FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Returns the owner of the contract.
function owner() public view virtual returns (address result) {
/// @solidity memory-safe-assembly
assembly {
result := sload(_OWNER_SLOT)
}
}
/// @dev Returns the expiry timestamp for the two-step ownership handover to `pendingOwner`.
function ownershipHandoverExpiresAt(address pendingOwner)
public
view
virtual
returns (uint256 result)
{
/// @solidity memory-safe-assembly
assembly {
// Compute the handover slot.
mstore(0x0c, _HANDOVER_SLOT_SEED)
mstore(0x00, pendingOwner)
// Load the handover slot.
result := sload(keccak256(0x0c, 0x20))
}
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* MODIFIERS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Marks a function as only callable by the owner.
modifier onlyOwner() virtual {
_checkOwner();
_;
}
}
// lib/solady/src/tokens/ERC2981.sol
/// @notice Simple ERC2981 NFT Royalty Standard implementation.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/tokens/ERC2981.sol)
/// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/token/common/ERC2981.sol)
abstract contract ERC2981 {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The royalty fee numerator exceeds the fee denominator.
error RoyaltyOverflow();
/// @dev The royalty receiver cannot be the zero address.
error RoyaltyReceiverIsZeroAddress();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* STORAGE */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The default royalty info is given by:
/// ```
/// let packed := sload(_ERC2981_MASTER_SLOT_SEED)
/// let receiver := shr(96, packed)
/// let royaltyFraction := xor(packed, shl(96, receiver))
/// ```
///
/// The per token royalty info is given by.
/// ```
/// mstore(0x00, tokenId)
/// mstore(0x20, _ERC2981_MASTER_SLOT_SEED)
/// let packed := sload(keccak256(0x00, 0x40))
/// let receiver := shr(96, packed)
/// let royaltyFraction := xor(packed, shl(96, receiver))
/// ```
uint256 private constant _ERC2981_MASTER_SLOT_SEED = 0xaa4ec00224afccfdb7;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* ERC2981 */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Checks that `_feeDenominator` is non-zero.
constructor() {
require(_feeDenominator() != 0, "Fee denominator cannot be zero.");
}
/// @dev Returns the denominator for the royalty amount.
/// Defaults to 10000, which represents fees in basis points.
/// Override this function to return a custom amount if needed.
function _feeDenominator() internal pure virtual returns (uint96) {
return 10000;
}
/// @dev Returns true if this contract implements the interface defined by `interfaceId`.
/// See: https://eips.ethereum.org/EIPS/eip-165
/// This function call must use less than 30000 gas.
function supportsInterface(bytes4 interfaceId) public view virtual returns (bool result) {
/// @solidity memory-safe-assembly
assembly {
let s := shr(224, interfaceId)
// ERC165: 0x01ffc9a7, ERC2981: 0x2a55205a.
result := or(eq(s, 0x01ffc9a7), eq(s, 0x2a55205a))
}
}
/// @dev Returns the `receiver` and `royaltyAmount` for `tokenId` sold at `salePrice`.
function royaltyInfo(uint256 tokenId, uint256 salePrice)
public
view
virtual
returns (address receiver, uint256 royaltyAmount)
{
uint256 feeDenominator = _feeDenominator();
/// @solidity memory-safe-assembly
assembly {
mstore(0x00, tokenId)
mstore(0x20, _ERC2981_MASTER_SLOT_SEED)
let packed := sload(keccak256(0x00, 0x40))
receiver := shr(96, packed)
if iszero(receiver) {
packed := sload(mload(0x20))
receiver := shr(96, packed)
}
let x := salePrice
let y := xor(packed, shl(96, receiver)) // `feeNumerator`.
// Overflow check, equivalent to `require(y == 0 || x <= type(uint256).max / y)`.
// Out-of-gas revert. Should not be triggered in practice, but included for safety.
returndatacopy(returndatasize(), returndatasize(), mul(y, gt(x, div(not(0), y))))
royaltyAmount := div(mul(x, y), feeDenominator)
}
}
/// @dev Sets the default royalty `receiver` and `feeNumerator`.
///
/// Requirements:
/// - `receiver` must not be the zero address.
/// - `feeNumerator` must not be greater than the fee denominator.
function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
uint256 feeDenominator = _feeDenominator();
/// @solidity memory-safe-assembly
assembly {
feeNumerator := shr(160, shl(160, feeNumerator))
if gt(feeNumerator, feeDenominator) {
mstore(0x00, 0x350a88b3) // `RoyaltyOverflow()`.
revert(0x1c, 0x04)
}
let packed := shl(96, receiver)
if iszero(packed) {
mstore(0x00, 0xb4457eaa) // `RoyaltyReceiverIsZeroAddress()`.
revert(0x1c, 0x04)
}
sstore(_ERC2981_MASTER_SLOT_SEED, or(packed, feeNumerator))
}
}
/// @dev Sets the default royalty `receiver` and `feeNumerator` to zero.
function _deleteDefaultRoyalty() internal virtual {
/// @solidity memory-safe-assembly
assembly {
sstore(_ERC2981_MASTER_SLOT_SEED, 0)
}
}
/// @dev Sets the royalty `receiver` and `feeNumerator` for `tokenId`.
///
/// Requirements:
/// - `receiver` must not be the zero address.
/// - `feeNumerator` must not be greater than the fee denominator.
function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator)
internal
virtual
{
uint256 feeDenominator = _feeDenominator();
/// @solidity memory-safe-assembly
assembly {
feeNumerator := shr(160, shl(160, feeNumerator))
if gt(feeNumerator, feeDenominator) {
mstore(0x00, 0x350a88b3) // `RoyaltyOverflow()`.
revert(0x1c, 0x04)
}
let packed := shl(96, receiver)
if iszero(packed) {
mstore(0x00, 0xb4457eaa) // `RoyaltyReceiverIsZeroAddress()`.
revert(0x1c, 0x04)
}
mstore(0x00, tokenId)
mstore(0x20, _ERC2981_MASTER_SLOT_SEED)
sstore(keccak256(0x00, 0x40), or(packed, feeNumerator))
}
}
/// @dev Sets the royalty `receiver` and `feeNumerator` for `tokenId` to zero.
function _resetTokenRoyalty(uint256 tokenId) internal virtual {
/// @solidity memory-safe-assembly
assembly {
mstore(0x00, tokenId)
mstore(0x20, _ERC2981_MASTER_SLOT_SEED)
sstore(keccak256(0x00, 0x40), 0)
}
}
}
// lib/solady/src/utils/ECDSA.sol
/// @notice Gas optimized ECDSA wrapper.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/ECDSA.sol)
/// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/ECDSA.sol)
/// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/cryptography/ECDSA.sol)
///
/// @dev Note:
/// - The recovery functions use the ecrecover precompile (0x1).
/// - As of Solady version 0.0.68, the `recover` variants will revert upon recovery failure.
/// This is for more safety by default.
/// Use the `tryRecover` variants if you need to get the zero address back
/// upon recovery failure instead.
/// - As of Solady version 0.0.134, all `bytes signature` variants accept both
/// regular 65-byte `(r, s, v)` and EIP-2098 `(r, vs)` short form signatures.
/// See: https://eips.ethereum.org/EIPS/eip-2098
/// This is for calldata efficiency on smart accounts prevalent on L2s.
///
/// WARNING! Do NOT use signatures as unique identifiers:
/// - Use a nonce in the digest to prevent replay attacks on the same contract.
/// - Use EIP-712 for the digest to prevent replay attacks across different chains and contracts.
/// EIP-712 also enables readable signing of typed data for better user safety.
/// This implementation does NOT check if a signature is non-malleable.
library ECDSA {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* CUSTOM ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The signature is invalid.
error InvalidSignature();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* RECOVERY OPERATIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Recovers the signer's address from a message digest `hash`, and the `signature`.
function recover(bytes32 hash, bytes memory signature) internal view returns (address result) {
/// @solidity memory-safe-assembly
assembly {
result := 1
let m := mload(0x40) // Cache the free memory pointer.
for {} 1 {} {
mstore(0x00, hash)
mstore(0x40, mload(add(signature, 0x20))) // `r`.
if eq(mload(signature), 64) {
let vs := mload(add(signature, 0x40))
mstore(0x20, add(shr(255, vs), 27)) // `v`.
mstore(0x60, shr(1, shl(1, vs))) // `s`.
break
}
if eq(mload(signature), 65) {
mstore(0x20, byte(0, mload(add(signature, 0x60)))) // `v`.
mstore(0x60, mload(add(signature, 0x40))) // `s`.
break
}
result := 0
break
}
result :=
mload(
staticcall(
gas(), // Amount of gas left for the transaction.
result, // Address of `ecrecover`.
0x00, // Start of input.
0x80, // Size of input.
0x01, // Start of output.
0x20 // Size of output.
)
)
// `returndatasize()` will be `0x20` upon success, and `0x00` otherwise.
if iszero(returndatasize()) {
mstore(0x00, 0x8baa579f) // `InvalidSignature()`.
revert(0x1c, 0x04)
}
mstore(0x60, 0) // Restore the zero slot.
mstore(0x40, m) // Restore the free memory pointer.
}
}
/// @dev Recovers the signer's address from a message digest `hash`, and the `signature`.
function recoverCalldata(bytes32 hash, bytes calldata signature)
internal
view
returns (address result)
{
/// @solidity memory-safe-assembly
assembly {
result := 1
let m := mload(0x40) // Cache the free memory pointer.
mstore(0x00, hash)
for {} 1 {} {
if eq(signature.length, 64) {
let vs := calldataload(add(signature.offset, 0x20))
mstore(0x20, add(shr(255, vs), 27)) // `v`.
mstore(0x40, calldataload(signature.offset)) // `r`.
mstore(0x60, shr(1, shl(1, vs))) // `s`.
break
}
if eq(signature.length, 65) {
mstore(0x20, byte(0, calldataload(add(signature.offset, 0x40)))) // `v`.
calldatacopy(0x40, signature.offset, 0x40) // Copy `r` and `s`.
break
}
result := 0
break
}
result :=
mload(
staticcall(
gas(), // Amount of gas left for the transaction.
result, // Address of `ecrecover`.
0x00, // Start of input.
0x80, // Size of input.
0x01, // Start of output.
0x20 // Size of output.
)
)
// `returndatasize()` will be `0x20` upon success, and `0x00` otherwise.
if iszero(returndatasize()) {
mstore(0x00, 0x8baa579f) // `InvalidSignature()`.
revert(0x1c, 0x04)
}
mstore(0x60, 0) // Restore the zero slot.
mstore(0x40, m) // Restore the free memory pointer.
}
}
/// @dev Recovers the signer's address from a message digest `hash`,
/// and the EIP-2098 short form signature defined by `r` and `vs`.
function recover(bytes32 hash, bytes32 r, bytes32 vs) internal view returns (address result) {
/// @solidity memory-safe-assembly
assembly {
let m := mload(0x40) // Cache the free memory pointer.
mstore(0x00, hash)
mstore(0x20, add(shr(255, vs), 27)) // `v`.
mstore(0x40, r)
mstore(0x60, shr(1, shl(1, vs))) // `s`.
result :=
mload(
staticcall(
gas(), // Amount of gas left for the transaction.
1, // Address of `ecrecover`.
0x00, // Start of input.
0x80, // Size of input.
0x01, // Start of output.
0x20 // Size of output.
)
)
// `returndatasize()` will be `0x20` upon success, and `0x00` otherwise.
if iszero(returndatasize()) {
mstore(0x00, 0x8baa579f) // `InvalidSignature()`.
revert(0x1c, 0x04)
}
mstore(0x60, 0) // Restore the zero slot.
mstore(0x40, m) // Restore the free memory pointer.
}
}
/// @dev Recovers the signer's address from a message digest `hash`,
/// and the signature defined by `v`, `r`, `s`.
function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s)
internal
view
returns (address result)
{
/// @solidity memory-safe-assembly
assembly {
let m := mload(0x40) // Cache the free memory pointer.
mstore(0x00, hash)
mstore(0x20, and(v, 0xff))
mstore(0x40, r)
mstore(0x60, s)
result :=
mload(
staticcall(
gas(), // Amount of gas left for the transaction.
1, // Address of `ecrecover`.
0x00, // Start of input.
0x80, // Size of input.
0x01, // Start of output.
0x20 // Size of output.
)
)
// `returndatasize()` will be `0x20` upon success, and `0x00` otherwise.
if iszero(returndatasize()) {
mstore(0x00, 0x8baa579f) // `InvalidSignature()`.
revert(0x1c, 0x04)
}
mstore(0x60, 0) // Restore the zero slot.
mstore(0x40, m) // Restore the free memory pointer.
}
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* TRY-RECOVER OPERATIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
// WARNING!
// These functions will NOT revert upon recovery failure.
// Instead, they will return the zero address upon recovery failure.
// It is critical that the returned address is NEVER compared against
// a zero address (e.g. an uninitialized address variable).
/// @dev Recovers the signer's address from a message digest `hash`, and the `signature`.
function tryRecover(bytes32 hash, bytes memory signature)
internal
view
returns (address result)
{
/// @solidity memory-safe-assembly
assembly {
result := 1
let m := mload(0x40) // Cache the free memory pointer.
for {} 1 {} {
mstore(0x00, hash)
mstore(0x40, mload(add(signature, 0x20))) // `r`.
if eq(mload(signature), 64) {
let vs := mload(add(signature, 0x40))
mstore(0x20, add(shr(255, vs), 27)) // `v`.
mstore(0x60, shr(1, shl(1, vs))) // `s`.
break
}
if eq(mload(signature), 65) {
mstore(0x20, byte(0, mload(add(signature, 0x60)))) // `v`.
mstore(0x60, mload(add(signature, 0x40))) // `s`.
break
}
result := 0
break
}
pop(
staticcall(
gas(), // Amount of gas left for the transaction.
result, // Address of `ecrecover`.
0x00, // Start of input.
0x80, // Size of input.
0x40, // Start of output.
0x20 // Size of output.
)
)
mstore(0x60, 0) // Restore the zero slot.
// `returndatasize()` will be `0x20` upon success, and `0x00` otherwise.
result := mload(xor(0x60, returndatasize()))
mstore(0x40, m) // Restore the free memory pointer.
}
}
/// @dev Recovers the signer's address from a message digest `hash`, and the `signature`.
function tryRecoverCalldata(bytes32 hash, bytes calldata signature)
internal
view
returns (address result)
{
/// @solidity memory-safe-assembly
assembly {
result := 1
let m := mload(0x40) // Cache the free memory pointer.
mstore(0x00, hash)
for {} 1 {} {
if eq(signature.length, 64) {
let vs := calldataload(add(signature.offset, 0x20))
mstore(0x20, add(shr(255, vs), 27)) // `v`.
mstore(0x40, calldataload(signature.offset)) // `r`.
mstore(0x60, shr(1, shl(1, vs))) // `s`.
break
}
if eq(signature.length, 65) {
mstore(0x20, byte(0, calldataload(add(signature.offset, 0x40)))) // `v`.
calldatacopy(0x40, signature.offset, 0x40) // Copy `r` and `s`.
break
}
result := 0
break
}
pop(
staticcall(
gas(), // Amount of gas left for the transaction.
result, // Address of `ecrecover`.
0x00, // Start of input.
0x80, // Size of input.
0x40, // Start of output.
0x20 // Size of output.
)
)
mstore(0x60, 0) // Restore the zero slot.
// `returndatasize()` will be `0x20` upon success, and `0x00` otherwise.
result := mload(xor(0x60, returndatasize()))
mstore(0x40, m) // Restore the free memory pointer.
}
}
/// @dev Recovers the signer's address from a message digest `hash`,
/// and the EIP-2098 short form signature defined by `r` and `vs`.
function tryRecover(bytes32 hash, bytes32 r, bytes32 vs)
internal
view
returns (address result)
{
/// @solidity memory-safe-assembly
assembly {
let m := mload(0x40) // Cache the free memory pointer.
mstore(0x00, hash)
mstore(0x20, add(shr(255, vs), 27)) // `v`.
mstore(0x40, r)
mstore(0x60, shr(1, shl(1, vs))) // `s`.
pop(
staticcall(
gas(), // Amount of gas left for the transaction.
1, // Address of `ecrecover`.
0x00, // Start of input.
0x80, // Size of input.
0x40, // Start of output.
0x20 // Size of output.
)
)
mstore(0x60, 0) // Restore the zero slot.
// `returndatasize()` will be `0x20` upon success, and `0x00` otherwise.
result := mload(xor(0x60, returndatasize()))
mstore(0x40, m) // Restore the free memory pointer.
}
}
/// @dev Recovers the signer's address from a message digest `hash`,
/// and the signature defined by `v`, `r`, `s`.
function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s)
internal
view
returns (address result)
{
/// @solidity memory-safe-assembly
assembly {
let m := mload(0x40) // Cache the free memory pointer.
mstore(0x00, hash)
mstore(0x20, and(v, 0xff))
mstore(0x40, r)
mstore(0x60, s)
pop(
staticcall(
gas(), // Amount of gas left for the transaction.
1, // Address of `ecrecover`.
0x00, // Start of input.
0x80, // Size of input.
0x40, // Start of output.
0x20 // Size of output.
)
)
mstore(0x60, 0) // Restore the zero slot.
// `returndatasize()` will be `0x20` upon success, and `0x00` otherwise.
result := mload(xor(0x60, returndatasize()))
mstore(0x40, m) // Restore the free memory pointer.
}
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* HASHING OPERATIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Returns an Ethereum Signed Message, created from a `hash`.
/// This produces a hash corresponding to the one signed with the
/// [`eth_sign`](https://eth.wiki/json-rpc/API#eth_sign)
/// JSON-RPC method as part of EIP-191.
function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 result) {
/// @solidity memory-safe-assembly
assembly {
mstore(0x20, hash) // Store into scratch space for keccak256.
mstore(0x00, "\x00\x00\x00\x00\x19Ethereum Signed Message:\n32") // 28 bytes.
result := keccak256(0x04, 0x3c) // `32 * 2 - (32 - 28) = 60 = 0x3c`.
}
}
/// @dev Returns an Ethereum Signed Message, created from `s`.
/// This produces a hash corresponding to the one signed with the
/// [`eth_sign`](https://eth.wiki/json-rpc/API#eth_sign)
/// JSON-RPC method as part of EIP-191.
/// Note: Supports lengths of `s` up to 999999 bytes.
function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32 result) {
/// @solidity memory-safe-assembly
assembly {
let sLength := mload(s)
let o := 0x20
mstore(o, "\x19Ethereum Signed Message:\n") // 26 bytes, zero-right-padded.
mstore(0x00, 0x00)
// Convert the `s.length` to ASCII decimal representation: `base10(s.length)`.
for { let temp := sLength } 1 {} {
o := sub(o, 1)
mstore8(o, add(48, mod(temp, 10)))
temp := div(temp, 10)
if iszero(temp) { break }
}
let n := sub(0x3a, o) // Header length: `26 + 32 - o`.
// Throw an out-of-offset error (consumes all gas) if the header exceeds 32 bytes.
returndatacopy(returndatasize(), returndatasize(), gt(n, 0x20))
mstore(s, or(mload(0x00), mload(n))) // Temporarily store the header.
result := keccak256(add(s, sub(0x20, n)), add(n, sLength))
mstore(s, sLength) // Restore the length.
}
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* EMPTY CALLDATA HELPERS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Returns an empty calldata bytes.
function emptySignature() internal pure returns (bytes calldata signature) {
/// @solidity memory-safe-assembly
assembly {
signature.length := 0
}
}
}
// src/access/AccessRoles.sol
/**
* @title AccessRoles
* @notice This library contains all the valid roles within the protocol. Roles have been defined to mimic
* {Solady.OwnableRoles} roles.
*/
library AccessRoles {
uint256 public constant ADMIN_ROLE = 1 << 0;
}
// src/interfaces/IAdventurer.sol
/**
* @title IAdventurer
* @notice Interface for Adventurer.
*/
interface IAdventurer {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* ERRORS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/**
* Thrown when the zero address is provided as input.
*/
error ZeroAddress();
/**
* Thrown when the recovered signer doesn't match the set signer.
*/
error SignerMismatch();
/**
* Thrown when an address has already claimed an adventurer.
*/
error AccountHasClaimed();
/**
* Thrown when an input array has zero length.
*/
error ZeroLengthArray();
/**
* Thrown when the amount of tokens to airdrop does not match the allocation amount.
*/
error InvalidAirdropAmount();
/**
* Thrown when the airdrop is already complete.
*/
error AirdropComplete();
/**
* Thrown when the mint is not active.
*/
error MintInactive();
/**
* Thrown when the mint exceeds the total supply.
*/
error MintExceedsTotalSupply();
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* EVENTS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/**
* Emitted when the signer address is updated.
* @param oldSigner Old signer address.
* @param newSigner New signer address.
*/
event SignerUpdated(address indexed oldSigner, address indexed newSigner);
/**
* Emitted when the base token URI is updated.
* @param oldBaseTokenURI Old base token URI value.
* @param newBaseTokenURI New base token URI value.
*/
event BaseTokenURIUpdated(string oldBaseTokenURI, string newBaseTokenURI);
/**
* Emitted when the mint state is updated.
* @param oldMintState Old mint state value.
* @param newMintState New mint state value.
*/
event MintStateUpdated(bool oldMintState, bool newMintState);
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/**
* Function used to initialize storage of the proxy contract.
* @param _owner Owner address.
* @param _admin Admin address.
* @param _signer Signer address.
* @param _treasury Treasury address.
* @param _baseTokenURI Starting base token URI.
*/
function initialize(
address _owner,
address _admin,
address _signer,
address _treasury,
string calldata _baseTokenURI
)
external;
/**
* Function used to mint during the mint phase.
* @param signature Signed message digest.
*/
function mint(bytes calldata signature) external;
/**
* Function used to airdrop adventurers to a list of accounts, this function is only callable once
* and will be called after deployment prior to the mint phase.
* @param accounts List of accounts to airdrop to.
*/
function airdrop(address[] calldata accounts) external;
/**
* Function used to mint the remainder of the supply to the treasury.
* @param receiver Address to mint to.
* @param quantity Quantity of tokens to mint.
*/
function adminMint(address receiver, uint256 quantity) external;
/**
* Function used to emit an ERC4906 event to update the metadata for all existing tokens.
*/
function updateMetadata() external;
/**
* Function used to update the signer address.
* @param newSigner New signer address.
*/
function setSigner(address newSigner) external;
/**
* Function used to set a new base token URI.
* @param newBaseTokenURI New base token URI value.
*/
function setBaseTokenURI(string calldata newBaseTokenURI) external;
/**
* Function used to toggle the mint state.
*/
function toggleMint() external;
/**
* Function used to view if an account has claimed an adventurer.
* @param account Account to check.
*/
function hasClaimed(address account) external view returns (bool);
}
// src/interfaces/IERC4906.sol
/**
* @title IERC4906
*/
interface IERC4906 {
/**
* @dev This event emits when the metadata of a token is changed.
* So that the third-party platforms such as NFT market could
* timely update the images and related attributes of the NFT.
*/
event MetadataUpdate(uint256 _tokenId);
/**
* @dev This event emits when the metadata of a range of tokens is changed.
* So that the third-party platforms such as NFT market could
* timely update the images and related attributes of the NFTs.
*/
event BatchMetadataUpdate(uint256 _fromTokenId, uint256 _toTokenId);
}
// lib/ERC721A-Upgradeable/contracts/ERC721A__Initializable.sol
/**
* @dev This is a base contract to aid in writing upgradeable diamond facet 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.
*
* 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.
*/
abstract contract ERC721A__Initializable {
using ERC721A__InitializableStorage for ERC721A__InitializableStorage.Layout;
/**
* @dev Modifier to protect an initializer function from being invoked twice.
*/
modifier initializerERC721A() {
// If the contract is initializing we ignore whether _initialized is set in order to support multiple
// inheritance patterns, but we only do this in the context of a constructor, because in other contexts the
// contract may have been reentered.
require(
ERC721A__InitializableStorage.layout()._initializing
? _isConstructor()
: !ERC721A__InitializableStorage.layout()._initialized,
'ERC721A__Initializable: contract is already initialized'
);
bool isTopLevelCall = !ERC721A__InitializableStorage.layout()._initializing;
if (isTopLevelCall) {
ERC721A__InitializableStorage.layout()._initializing = true;
ERC721A__InitializableStorage.layout()._initialized = true;
}
_;
if (isTopLevelCall) {
ERC721A__InitializableStorage.layout()._initializing = false;
}
}
/**
* @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
* {initializer} modifier, directly or indirectly.
*/
modifier onlyInitializingERC721A() {
require(
ERC721A__InitializableStorage.layout()._initializing,
'ERC721A__Initializable: contract is not initializing'
);
_;
}
/// @dev Returns true if and only if the function is running in the constructor
function _isConstructor() private view returns (bool) {
// extcodesize checks the size of the code stored in an address, and
// address returns the current address. Since the code is still not
// deployed when running a constructor, any checks on its code size will
// yield zero, making it an effective way to detect if a contract is
// under construction or not.
address self = address(this);
uint256 cs;
assembly {
cs := extcodesize(self)
}
return cs == 0;
}
}
// lib/ERC721A-Upgradeable/contracts/extensions/IERC721ABurnableUpgradeable.sol
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
/**
* @dev Interface of ERC721ABurnable.
*/
interface IERC721ABurnableUpgradeable is IERC721AUpgradeable {
/**
* @dev Burns `tokenId`. See {ERC721A-_burn}.
*
* Requirements:
*
* - The caller must own `tokenId` or be an approved operator.
*/
function burn(uint256 tokenId) external;
}
// lib/ERC721A-Upgradeable/contracts/interfaces/IERC721AUpgradeable.sol
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
// lib/solady/src/auth/OwnableRoles.sol
/// @notice Simple single owner and multiroles authorization mixin.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/auth/Ownable.sol)
/// @dev While the ownable portion follows [EIP-173](https://eips.ethereum.org/EIPS/eip-173)
/// for compatibility, the nomenclature for the 2-step ownership handover and roles
/// may be unique to this codebase.
abstract contract OwnableRoles is Ownable {
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* EVENTS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The `user`'s roles is updated to `roles`.
/// Each bit of `roles` represents whether the role is set.
event RolesUpdated(address indexed user, uint256 indexed roles);
/// @dev `keccak256(bytes("RolesUpdated(address,uint256)"))`.
uint256 private constant _ROLES_UPDATED_EVENT_SIGNATURE =
0x715ad5ce61fc9595c7b415289d59cf203f23a94fa06f04af7e489a0a76e1fe26;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* STORAGE */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev The role slot of `user` is given by:
/// ```
/// mstore(0x00, or(shl(96, user), _ROLE_SLOT_SEED))
/// let roleSlot := keccak256(0x00, 0x20)
/// ```
/// This automatically ignores the upper bits of the `user` in case
/// they are not clean, as well as keep the `keccak256` under 32-bytes.
///
/// Note: This is equivalent to `uint32(bytes4(keccak256("_OWNER_SLOT_NOT")))`.
uint256 private constant _ROLE_SLOT_SEED = 0x8b78c6d8;
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* INTERNAL FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Overwrite the roles directly without authorization guard.
function _setRoles(address user, uint256 roles) internal virtual {
/// @solidity memory-safe-assembly
assembly {
mstore(0x0c, _ROLE_SLOT_SEED)
mstore(0x00, user)
// Store the new value.
sstore(keccak256(0x0c, 0x20), roles)
// Emit the {RolesUpdated} event.
log3(0, 0, _ROLES_UPDATED_EVENT_SIGNATURE, shr(96, mload(0x0c)), roles)
}
}
/// @dev Updates the roles directly without authorization guard.
/// If `on` is true, each set bit of `roles` will be turned on,
/// otherwise, each set bit of `roles` will be turned off.
function _updateRoles(address user, uint256 roles, bool on) internal virtual {
/// @solidity memory-safe-assembly
assembly {
mstore(0x0c, _ROLE_SLOT_SEED)
mstore(0x00, user)
let roleSlot := keccak256(0x0c, 0x20)
// Load the current value.
let current := sload(roleSlot)
// Compute the updated roles if `on` is true.
let updated := or(current, roles)
// Compute the updated roles if `on` is false.
// Use `and` to compute the intersection of `current` and `roles`,
// `xor` it with `current` to flip the bits in the intersection.
if iszero(on) { updated := xor(current, and(current, roles)) }
// Then, store the new value.
sstore(roleSlot, updated)
// Emit the {RolesUpdated} event.
log3(0, 0, _ROLES_UPDATED_EVENT_SIGNATURE, shr(96, mload(0x0c)), updated)
}
}
/// @dev Grants the roles directly without authorization guard.
/// Each bit of `roles` represents the role to turn on.
function _grantRoles(address user, uint256 roles) internal virtual {
_updateRoles(user, roles, true);
}
/// @dev Removes the roles directly without authorization guard.
/// Each bit of `roles` represents the role to turn off.
function _removeRoles(address user, uint256 roles) internal virtual {
_updateRoles(user, roles, false);
}
/// @dev Throws if the sender does not have any of the `roles`.
function _checkRoles(uint256 roles) internal view virtual {
/// @solidity memory-safe-assembly
assembly {
// Compute the role slot.
mstore(0x0c, _ROLE_SLOT_SEED)
mstore(0x00, caller())
// Load the stored value, and if the `and` intersection
// of the value and `roles` is zero, revert.
if iszero(and(sload(keccak256(0x0c, 0x20)), roles)) {
mstore(0x00, 0x82b42900) // `Unauthorized()`.
revert(0x1c, 0x04)
}
}
}
/// @dev Throws if the sender is not the owner,
/// and does not have any of the `roles`.
/// Checks for ownership first, then lazily checks for roles.
function _checkOwnerOrRoles(uint256 roles) internal view virtual {
/// @solidity memory-safe-assembly
assembly {
// If the caller is not the stored owner.
// Note: `_ROLE_SLOT_SEED` is equal to `_OWNER_SLOT_NOT`.
if iszero(eq(caller(), sload(not(_ROLE_SLOT_SEED)))) {
// Compute the role slot.
mstore(0x0c, _ROLE_SLOT_SEED)
mstore(0x00, caller())
// Load the stored value, and if the `and` intersection
// of the value and `roles` is zero, revert.
if iszero(and(sload(keccak256(0x0c, 0x20)), roles)) {
mstore(0x00, 0x82b42900) // `Unauthorized()`.
revert(0x1c, 0x04)
}
}
}
}
/// @dev Throws if the sender does not have any of the `roles`,
/// and is not the owner.
/// Checks for roles first, then lazily checks for ownership.
function _checkRolesOrOwner(uint256 roles) internal view virtual {
/// @solidity memory-safe-assembly
assembly {
// Compute the role slot.
mstore(0x0c, _ROLE_SLOT_SEED)
mstore(0x00, caller())
// Load the stored value, and if the `and` intersection
// of the value and `roles` is zero, revert.
if iszero(and(sload(keccak256(0x0c, 0x20)), roles)) {
// If the caller is not the stored owner.
// Note: `_ROLE_SLOT_SEED` is equal to `_OWNER_SLOT_NOT`.
if iszero(eq(caller(), sload(not(_ROLE_SLOT_SEED)))) {
mstore(0x00, 0x82b42900) // `Unauthorized()`.
revert(0x1c, 0x04)
}
}
}
}
/// @dev Convenience function to return a `roles` bitmap from an array of `ordinals`.
/// This is meant for frontends like Etherscan, and is therefore not fully optimized.
/// Not recommended to be called on-chain.
/// Made internal to conserve bytecode. Wrap it in a public function if needed.
function _rolesFromOrdinals(uint8[] memory ordinals) internal pure returns (uint256 roles) {
/// @solidity memory-safe-assembly
assembly {
for { let i := shl(5, mload(ordinals)) } i { i := sub(i, 0x20) } {
// We don't need to mask the values of `ordinals`, as Solidity
// cleans dirty upper bits when storing variables into memory.
roles := or(shl(mload(add(ordinals, i)), 1), roles)
}
}
}
/// @dev Convenience function to return an array of `ordinals` from the `roles` bitmap.
/// This is meant for frontends like Etherscan, and is therefore not fully optimized.
/// Not recommended to be called on-chain.
/// Made internal to conserve bytecode. Wrap it in a public function if needed.
function _ordinalsFromRoles(uint256 roles) internal pure returns (uint8[] memory ordinals) {
/// @solidity memory-safe-assembly
assembly {
// Grab the pointer to the free memory.
ordinals := mload(0x40)
let ptr := add(ordinals, 0x20)
let o := 0
// The absence of lookup tables, De Bruijn, etc., here is intentional for
// smaller bytecode, as this function is not meant to be called on-chain.
for { let t := roles } 1 {} {
mstore(ptr, o)
// `shr` 5 is equivalent to multiplying by 0x20.
// Push back into the ordinals array if the bit is set.
ptr := add(ptr, shl(5, and(t, 1)))
o := add(o, 1)
t := shr(o, roles)
if iszero(t) { break }
}
// Store the length of `ordinals`.
mstore(ordinals, shr(5, sub(ptr, add(ordinals, 0x20))))
// Allocate the memory.
mstore(0x40, ptr)
}
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* PUBLIC UPDATE FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Allows the owner to grant `user` `roles`.
/// If the `user` already has a role, then it will be an no-op for the role.
function grantRoles(address user, uint256 roles) public payable virtual onlyOwner {
_grantRoles(user, roles);
}
/// @dev Allows the owner to remove `user` `roles`.
/// If the `user` does not have a role, then it will be an no-op for the role.
function revokeRoles(address user, uint256 roles) public payable virtual onlyOwner {
_removeRoles(user, roles);
}
/// @dev Allow the caller to remove their own roles.
/// If the caller does not have a role, then it will be an no-op for the role.
function renounceRoles(uint256 roles) public payable virtual {
_removeRoles(msg.sender, roles);
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* PUBLIC READ FUNCTIONS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Returns the roles of `user`.
function rolesOf(address user) public view virtual returns (uint256 roles) {
/// @solidity memory-safe-assembly
assembly {
// Compute the role slot.
mstore(0x0c, _ROLE_SLOT_SEED)
mstore(0x00, user)
// Load the stored value.
roles := sload(keccak256(0x0c, 0x20))
}
}
/// @dev Returns whether `user` has any of `roles`.
function hasAnyRole(address user, uint256 roles) public view virtual returns (bool) {
return rolesOf(user) & roles != 0;
}
/// @dev Returns whether `user` has all of `roles`.
function hasAllRoles(address user, uint256 roles) public view virtual returns (bool) {
return rolesOf(user) & roles == roles;
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* MODIFIERS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/// @dev Marks a function as only callable by an account with `roles`.
modifier onlyRoles(uint256 roles) virtual {
_checkRoles(roles);
_;
}
/// @dev Marks a function as only callable by the owner or by an account
/// with `roles`. Checks for ownership first, then lazily checks for roles.
modifier onlyOwnerOrRoles(uint256 roles) virtual {
_checkOwnerOrRoles(roles);
_;
}
/// @dev Marks a function as only callable by an account with `roles`
/// or the owner. Checks for roles first, then lazily checks for ownership.
modifier onlyRolesOrOwner(uint256 roles) virtual {
_checkRolesOrOwner(roles);
_;
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* ROLE CONSTANTS */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
// IYKYK
uint256 internal constant _ROLE_0 = 1 << 0;
uint256 internal constant _ROLE_1 = 1 << 1;
uint256 internal constant _ROLE_2 = 1 << 2;
uint256 internal constant _ROLE_3 = 1 << 3;
uint256 internal constant _ROLE_4 = 1 << 4;
uint256 internal constant _ROLE_5 = 1 << 5;
uint256 internal constant _ROLE_6 = 1 << 6;
uint256 internal constant _ROLE_7 = 1 << 7;
uint256 internal constant _ROLE_8 = 1 << 8;
uint256 internal constant _ROLE_9 = 1 << 9;
uint256 internal constant _ROLE_10 = 1 << 10;
uint256 internal constant _ROLE_11 = 1 << 11;
uint256 internal constant _ROLE_12 = 1 << 12;
uint256 internal constant _ROLE_13 = 1 << 13;
uint256 internal constant _ROLE_14 = 1 << 14;
uint256 internal constant _ROLE_15 = 1 << 15;
uint256 internal constant _ROLE_16 = 1 << 16;
uint256 internal constant _ROLE_17 = 1 << 17;
uint256 internal constant _ROLE_18 = 1 << 18;
uint256 internal constant _ROLE_19 = 1 << 19;
uint256 internal constant _ROLE_20 = 1 << 20;
uint256 internal constant _ROLE_21 = 1 << 21;
uint256 internal constant _ROLE_22 = 1 << 22;
uint256 internal constant _ROLE_23 = 1 << 23;
uint256 internal constant _ROLE_24 = 1 << 24;
uint256 internal constant _ROLE_25 = 1 << 25;
uint256 internal constant _ROLE_26 = 1 << 26;
uint256 internal constant _ROLE_27 = 1 << 27;
uint256 internal constant _ROLE_28 = 1 << 28;
uint256 internal constant _ROLE_29 = 1 << 29;
uint256 internal constant _ROLE_30 = 1 << 30;
uint256 internal constant _ROLE_31 = 1 << 31;
uint256 internal constant _ROLE_32 = 1 << 32;
uint256 internal constant _ROLE_33 = 1 << 33;
uint256 internal constant _ROLE_34 = 1 << 34;
uint256 internal constant _ROLE_35 = 1 << 35;
uint256 internal constant _ROLE_36 = 1 << 36;
uint256 internal constant _ROLE_37 = 1 << 37;
uint256 internal constant _ROLE_38 = 1 << 38;
uint256 internal constant _ROLE_39 = 1 << 39;
uint256 internal constant _ROLE_40 = 1 << 40;
uint256 internal constant _ROLE_41 = 1 << 41;
uint256 internal constant _ROLE_42 = 1 << 42;
uint256 internal constant _ROLE_43 = 1 << 43;
uint256 internal constant _ROLE_44 = 1 << 44;
uint256 internal constant _ROLE_45 = 1 << 45;
uint256 internal constant _ROLE_46 = 1 << 46;
uint256 internal constant _ROLE_47 = 1 << 47;
uint256 internal constant _ROLE_48 = 1 << 48;
uint256 internal constant _ROLE_49 = 1 << 49;
uint256 internal constant _ROLE_50 = 1 << 50;
uint256 internal constant _ROLE_51 = 1 << 51;
uint256 internal constant _ROLE_52 = 1 << 52;
uint256 internal constant _ROLE_53 = 1 << 53;
uint256 internal constant _ROLE_54 = 1 << 54;
uint256 internal constant _ROLE_55 = 1 << 55;
uint256 internal constant _ROLE_56 = 1 << 56;
uint256 internal constant _ROLE_57 = 1 << 57;
uint256 internal constant _ROLE_58 = 1 << 58;
uint256 internal constant _ROLE_59 = 1 << 59;
uint256 internal constant _ROLE_60 = 1 << 60;
uint256 internal constant _ROLE_61 = 1 << 61;
uint256 internal constant _ROLE_62 = 1 << 62;
uint256 internal constant _ROLE_63 = 1 << 63;
uint256 internal constant _ROLE_64 = 1 << 64;
uint256 internal constant _ROLE_65 = 1 << 65;
uint256 internal constant _ROLE_66 = 1 << 66;
uint256 internal constant _ROLE_67 = 1 << 67;
uint256 internal constant _ROLE_68 = 1 << 68;
uint256 internal constant _ROLE_69 = 1 << 69;
uint256 internal constant _ROLE_70 = 1 << 70;
uint256 internal constant _ROLE_71 = 1 << 71;
uint256 internal constant _ROLE_72 = 1 << 72;
uint256 internal constant _ROLE_73 = 1 << 73;
uint256 internal constant _ROLE_74 = 1 << 74;
uint256 internal constant _ROLE_75 = 1 << 75;
uint256 internal constant _ROLE_76 = 1 << 76;
uint256 internal constant _ROLE_77 = 1 << 77;
uint256 internal constant _ROLE_78 = 1 << 78;
uint256 internal constant _ROLE_79 = 1 << 79;
uint256 internal constant _ROLE_80 = 1 << 80;
uint256 internal constant _ROLE_81 = 1 << 81;
uint256 internal constant _ROLE_82 = 1 << 82;
uint256 internal constant _ROLE_83 = 1 << 83;
uint256 internal constant _ROLE_84 = 1 << 84;
uint256 internal constant _ROLE_85 = 1 << 85;
uint256 internal constant _ROLE_86 = 1 << 86;
uint256 internal constant _ROLE_87 = 1 << 87;
uint256 internal constant _ROLE_88 = 1 << 88;
uint256 internal constant _ROLE_89 = 1 << 89;
uint256 internal constant _ROLE_90 = 1 << 90;
uint256 internal constant _ROLE_91 = 1 << 91;
uint256 internal constant _ROLE_92 = 1 << 92;
uint256 internal constant _ROLE_93 = 1 << 93;
uint256 internal constant _ROLE_94 = 1 << 94;
uint256 internal constant _ROLE_95 = 1 << 95;
uint256 internal constant _ROLE_96 = 1 << 96;
uint256 internal constant _ROLE_97 = 1 << 97;
uint256 internal constant _ROLE_98 = 1 << 98;
uint256 internal constant _ROLE_99 = 1 << 99;
uint256 internal constant _ROLE_100 = 1 << 100;
uint256 internal constant _ROLE_101 = 1 << 101;
uint256 internal constant _ROLE_102 = 1 << 102;
uint256 internal constant _ROLE_103 = 1 << 103;
uint256 internal constant _ROLE_104 = 1 << 104;
uint256 internal constant _ROLE_105 = 1 << 105;
uint256 internal constant _ROLE_106 = 1 << 106;
uint256 internal constant _ROLE_107 = 1 << 107;
uint256 internal constant _ROLE_108 = 1 << 108;
uint256 internal constant _ROLE_109 = 1 << 109;
uint256 internal constant _ROLE_110 = 1 << 110;
uint256 internal constant _ROLE_111 = 1 << 111;
uint256 internal constant _ROLE_112 = 1 << 112;
uint256 internal constant _ROLE_113 = 1 << 113;
uint256 internal constant _ROLE_114 = 1 << 114;
uint256 internal constant _ROLE_115 = 1 << 115;
uint256 internal constant _ROLE_116 = 1 << 116;
uint256 internal constant _ROLE_117 = 1 << 117;
uint256 internal constant _ROLE_118 = 1 << 118;
uint256 internal constant _ROLE_119 = 1 << 119;
uint256 internal constant _ROLE_120 = 1 << 120;
uint256 internal constant _ROLE_121 = 1 << 121;
uint256 internal constant _ROLE_122 = 1 << 122;
uint256 internal constant _ROLE_123 = 1 << 123;
uint256 internal constant _ROLE_124 = 1 << 124;
uint256 internal constant _ROLE_125 = 1 << 125;
uint256 internal constant _ROLE_126 = 1 << 126;
uint256 internal constant _ROLE_127 = 1 << 127;
uint256 internal constant _ROLE_128 = 1 << 128;
uint256 internal constant _ROLE_129 = 1 << 129;
uint256 internal constant _ROLE_130 = 1 << 130;
uint256 internal constant _ROLE_131 = 1 << 131;
uint256 internal constant _ROLE_132 = 1 << 132;
uint256 internal constant _ROLE_133 = 1 << 133;
uint256 internal constant _ROLE_134 = 1 << 134;
uint256 internal constant _ROLE_135 = 1 << 135;
uint256 internal constant _ROLE_136 = 1 << 136;
uint256 internal constant _ROLE_137 = 1 << 137;
uint256 internal constant _ROLE_138 = 1 << 138;
uint256 internal constant _ROLE_139 = 1 << 139;
uint256 internal constant _ROLE_140 = 1 << 140;
uint256 internal constant _ROLE_141 = 1 << 141;
uint256 internal constant _ROLE_142 = 1 << 142;
uint256 internal constant _ROLE_143 = 1 << 143;
uint256 internal constant _ROLE_144 = 1 << 144;
uint256 internal constant _ROLE_145 = 1 << 145;
uint256 internal constant _ROLE_146 = 1 << 146;
uint256 internal constant _ROLE_147 = 1 << 147;
uint256 internal constant _ROLE_148 = 1 << 148;
uint256 internal constant _ROLE_149 = 1 << 149;
uint256 internal constant _ROLE_150 = 1 << 150;
uint256 internal constant _ROLE_151 = 1 << 151;
uint256 internal constant _ROLE_152 = 1 << 152;
uint256 internal constant _ROLE_153 = 1 << 153;
uint256 internal constant _ROLE_154 = 1 << 154;
uint256 internal constant _ROLE_155 = 1 << 155;
uint256 internal constant _ROLE_156 = 1 << 156;
uint256 internal constant _ROLE_157 = 1 << 157;
uint256 internal constant _ROLE_158 = 1 << 158;
uint256 internal constant _ROLE_159 = 1 << 159;
uint256 internal constant _ROLE_160 = 1 << 160;
uint256 internal constant _ROLE_161 = 1 << 161;
uint256 internal constant _ROLE_162 = 1 << 162;
uint256 internal constant _ROLE_163 = 1 << 163;
uint256 internal constant _ROLE_164 = 1 << 164;
uint256 internal constant _ROLE_165 = 1 << 165;
uint256 internal constant _ROLE_166 = 1 << 166;
uint256 internal constant _ROLE_167 = 1 << 167;
uint256 internal constant _ROLE_168 = 1 << 168;
uint256 internal constant _ROLE_169 = 1 << 169;
uint256 internal constant _ROLE_170 = 1 << 170;
uint256 internal constant _ROLE_171 = 1 << 171;
uint256 internal constant _ROLE_172 = 1 << 172;
uint256 internal constant _ROLE_173 = 1 << 173;
uint256 internal constant _ROLE_174 = 1 << 174;
uint256 internal constant _ROLE_175 = 1 << 175;
uint256 internal constant _ROLE_176 = 1 << 176;
uint256 internal constant _ROLE_177 = 1 << 177;
uint256 internal constant _ROLE_178 = 1 << 178;
uint256 internal constant _ROLE_179 = 1 << 179;
uint256 internal constant _ROLE_180 = 1 << 180;
uint256 internal constant _ROLE_181 = 1 << 181;
uint256 internal constant _ROLE_182 = 1 << 182;
uint256 internal constant _ROLE_183 = 1 << 183;
uint256 internal constant _ROLE_184 = 1 << 184;
uint256 internal constant _ROLE_185 = 1 << 185;
uint256 internal constant _ROLE_186 = 1 << 186;
uint256 internal constant _ROLE_187 = 1 << 187;
uint256 internal constant _ROLE_188 = 1 << 188;
uint256 internal constant _ROLE_189 = 1 << 189;
uint256 internal constant _ROLE_190 = 1 << 190;
uint256 internal constant _ROLE_191 = 1 << 191;
uint256 internal constant _ROLE_192 = 1 << 192;
uint256 internal constant _ROLE_193 = 1 << 193;
uint256 internal constant _ROLE_194 = 1 << 194;
uint256 internal constant _ROLE_195 = 1 << 195;
uint256 internal constant _ROLE_196 = 1 << 196;
uint256 internal constant _ROLE_197 = 1 << 197;
uint256 internal constant _ROLE_198 = 1 << 198;
uint256 internal constant _ROLE_199 = 1 << 199;
uint256 internal constant _ROLE_200 = 1 << 200;
uint256 internal constant _ROLE_201 = 1 << 201;
uint256 internal constant _ROLE_202 = 1 << 202;
uint256 internal constant _ROLE_203 = 1 << 203;
uint256 internal constant _ROLE_204 = 1 << 204;
uint256 internal constant _ROLE_205 = 1 << 205;
uint256 internal constant _ROLE_206 = 1 << 206;
uint256 internal constant _ROLE_207 = 1 << 207;
uint256 internal constant _ROLE_208 = 1 << 208;
uint256 internal constant _ROLE_209 = 1 << 209;
uint256 internal constant _ROLE_210 = 1 << 210;
uint256 internal constant _ROLE_211 = 1 << 211;
uint256 internal constant _ROLE_212 = 1 << 212;
uint256 internal constant _ROLE_213 = 1 << 213;
uint256 internal constant _ROLE_214 = 1 << 214;
uint256 internal constant _ROLE_215 = 1 << 215;
uint256 internal constant _ROLE_216 = 1 << 216;
uint256 internal constant _ROLE_217 = 1 << 217;
uint256 internal constant _ROLE_218 = 1 << 218;
uint256 internal constant _ROLE_219 = 1 << 219;
uint256 internal constant _ROLE_220 = 1 << 220;
uint256 internal constant _ROLE_221 = 1 << 221;
uint256 internal constant _ROLE_222 = 1 << 222;
uint256 internal constant _ROLE_223 = 1 << 223;
uint256 internal constant _ROLE_224 = 1 << 224;
uint256 internal constant _ROLE_225 = 1 << 225;
uint256 internal constant _ROLE_226 = 1 << 226;
uint256 internal constant _ROLE_227 = 1 << 227;
uint256 internal constant _ROLE_228 = 1 << 228;
uint256 internal constant _ROLE_229 = 1 << 229;
uint256 internal constant _ROLE_230 = 1 << 230;
uint256 internal constant _ROLE_231 = 1 << 231;
uint256 internal constant _ROLE_232 = 1 << 232;
uint256 internal constant _ROLE_233 = 1 << 233;
uint256 internal constant _ROLE_234 = 1 << 234;
uint256 internal constant _ROLE_235 = 1 << 235;
uint256 internal constant _ROLE_236 = 1 << 236;
uint256 internal constant _ROLE_237 = 1 << 237;
uint256 internal constant _ROLE_238 = 1 << 238;
uint256 internal constant _ROLE_239 = 1 << 239;
uint256 internal constant _ROLE_240 = 1 << 240;
uint256 internal constant _ROLE_241 = 1 << 241;
uint256 internal constant _ROLE_242 = 1 << 242;
uint256 internal constant _ROLE_243 = 1 << 243;
uint256 internal constant _ROLE_244 = 1 << 244;
uint256 internal constant _ROLE_245 = 1 << 245;
uint256 internal constant _ROLE_246 = 1 << 246;
uint256 internal constant _ROLE_247 = 1 << 247;
uint256 internal constant _ROLE_248 = 1 << 248;
uint256 internal constant _ROLE_249 = 1 << 249;
uint256 internal constant _ROLE_250 = 1 << 250;
uint256 internal constant _ROLE_251 = 1 << 251;
uint256 internal constant _ROLE_252 = 1 << 252;
uint256 internal constant _ROLE_253 = 1 << 253;
uint256 internal constant _ROLE_254 = 1 << 254;
uint256 internal constant _ROLE_255 = 1 << 255;
}
// lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/proxy/ERC1967/ERC1967Utils.sol
// OpenZeppelin Contracts (last updated v5.0.0) (proxy/ERC1967/ERC1967Utils.sol)
/**
* @dev This abstract contract provides getters and event emitting update functions for
* https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
*/
library ERC1967Utils {
// We re-declare ERC-1967 events here because they can't be used directly from IERC1967.
// This will be fixed in Solidity 0.8.21. At that point we should remove these events.
/**
* @dev Emitted when the implementation is upgraded.
*/
event Upgraded(address indexed implementation);
/**
* @dev Emitted when the admin account has changed.
*/
event AdminChanged(address previousAdmin, address newAdmin);
/**
* @dev Emitted when the beacon is changed.
*/
event BeaconUpgraded(address indexed beacon);
/**
* @dev Storage slot with the address of the current implementation.
* This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1.
*/
// solhint-disable-next-line private-vars-leading-underscore
bytes32 internal constant IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
/**
* @dev The `implementation` of the proxy is invalid.
*/
error ERC1967InvalidImplementation(address implementation);
/**
* @dev The `admin` of the proxy is invalid.
*/
error ERC1967InvalidAdmin(address admin);
/**
* @dev The `beacon` of the proxy is invalid.
*/
error ERC1967InvalidBeacon(address beacon);
/**
* @dev An upgrade function sees `msg.value > 0` that may be lost.
*/
error ERC1967NonPayable();
/**
* @dev Returns the current implementation address.
*/
function getImplementation() internal view returns (address) {
return StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value;
}
/**
* @dev Stores a new address in the EIP1967 implementation slot.
*/
function _setImplementation(address newImplementation) private {
if (newImplementation.code.length == 0) {
revert ERC1967InvalidImplementation(newImplementation);
}
StorageSlot.getAddressSlot(IMPLEMENTATION_SLOT).value = newImplementation;
}
/**
* @dev Performs implementation upgrade with additional setup call if data is nonempty.
* This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
* to avoid stuck value in the contract.
*
* Emits an {IERC1967-Upgraded} event.
*/
function upgradeToAndCall(address newImplementation, bytes memory data) internal {
_setImplementation(newImplementation);
emit Upgraded(newImplementation);
if (data.length > 0) {
Address.functionDelegateCall(newImplementation, data);
} else {
_checkNonPayable();
}
}
/**
* @dev Storage slot with the admin of the contract.
* This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1.
*/
// solhint-disable-next-line private-vars-leading-underscore
bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
/**
* @dev Returns the current admin.
*
* TIP: To get this value clients can read directly from the storage slot shown below (specified by EIP1967) using
* the https://eth.wiki/json-rpc/API#eth_getstorageat[`eth_getStorageAt`] RPC call.
* `0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103`
*/
function getAdmin() internal view returns (address) {
return StorageSlot.getAddressSlot(ADMIN_SLOT).value;
}
/**
* @dev Stores a new address in the EIP1967 admin slot.
*/
function _setAdmin(address newAdmin) private {
if (newAdmin == address(0)) {
revert ERC1967InvalidAdmin(address(0));
}
StorageSlot.getAddressSlot(ADMIN_SLOT).value = newAdmin;
}
/**
* @dev Changes the admin of the proxy.
*
* Emits an {IERC1967-AdminChanged} event.
*/
function changeAdmin(address newAdmin) internal {
emit AdminChanged(getAdmin(), newAdmin);
_setAdmin(newAdmin);
}
/**
* @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
* This is the keccak-256 hash of "eip1967.proxy.beacon" subtracted by 1.
*/
// solhint-disable-next-line private-vars-leading-underscore
bytes32 internal constant BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
/**
* @dev Returns the current beacon.
*/
function getBeacon() internal view returns (address) {
return StorageSlot.getAddressSlot(BEACON_SLOT).value;
}
/**
* @dev Stores a new beacon in the EIP1967 beacon slot.
*/
function _setBeacon(address newBeacon) private {
if (newBeacon.code.length == 0) {
revert ERC1967InvalidBeacon(newBeacon);
}
StorageSlot.getAddressSlot(BEACON_SLOT).value = newBeacon;
address beaconImplementation = IBeacon(newBeacon).implementation();
if (beaconImplementation.code.length == 0) {
revert ERC1967InvalidImplementation(beaconImplementation);
}
}
/**
* @dev Change the beacon and trigger a setup call if data is nonempty.
* This function is payable only if the setup call is performed, otherwise `msg.value` is rejected
* to avoid stuck value in the contract.
*
* Emits an {IERC1967-BeaconUpgraded} event.
*
* CAUTION: Invoking this function has no effect on an instance of {BeaconProxy} since v5, since
* it uses an immutable beacon without looking at the value of the ERC-1967 beacon slot for
* efficiency.
*/
function upgradeBeaconToAndCall(address newBeacon, bytes memory data) internal {
_setBeacon(newBeacon);
emit BeaconUpgraded(newBeacon);
if (data.length > 0) {
Address.functionDelegateCall(IBeacon(newBeacon).implementation(), data);
} else {
_checkNonPayable();
}
}
/**
* @dev Reverts if `msg.value` is not zero. It can be used to avoid `msg.value` stuck in the contract
* if an upgrade doesn't perform an initialization call.
*/
function _checkNonPayable() private {
if (msg.value > 0) {
revert ERC1967NonPayable();
}
}
}
// lib/ERC721A-Upgradeable/contracts/ERC721AUpgradeable.sol
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
/**
* @dev Interface of ERC721 token receiver.
*/
interface ERC721A__IERC721ReceiverUpgradeable {
function onERC721Received(
address operator,
address from,
uint256 tokenId,
bytes calldata data
) external returns (bytes4);
}
/**
* @title ERC721A
*
* @dev Implementation of the [ERC721](https://eips.ethereum.org/EIPS/eip-721)
* Non-Fungible Token Standard, including the Metadata extension.
* Optimized for lower gas during batch mints.
*
* Token IDs are minted in sequential order (e.g. 0, 1, 2, 3, ...)
* starting from `_startTokenId()`.
*
* Assumptions:
*
* - An owner cannot have more than 2**64 - 1 (max value of uint64) of supply.
* - The maximum token ID cannot exceed 2**256 - 1 (max value of uint256).
*/
contract ERC721AUpgradeable is ERC721A__Initializable, IERC721AUpgradeable {
using ERC721AStorage for ERC721AStorage.Layout;
// =============================================================
// CONSTANTS
// =============================================================
// Mask of an entry in packed address data.
uint256 private constant _BITMASK_ADDRESS_DATA_ENTRY = (1 << 64) - 1;
// The bit position of `numberMinted` in packed address data.
uint256 private constant _BITPOS_NUMBER_MINTED = 64;
// The bit position of `numberBurned` in packed address data.
uint256 private constant _BITPOS_NUMBER_BURNED = 128;
// The bit position of `aux` in packed address data.
uint256 private constant _BITPOS_AUX = 192;
// Mask of all 256 bits in packed address data except the 64 bits for `aux`.
uint256 private constant _BITMASK_AUX_COMPLEMENT = (1 << 192) - 1;
// The bit position of `startTimestamp` in packed ownership.
uint256 private constant _BITPOS_START_TIMESTAMP = 160;
// The bit mask of the `burned` bit in packed ownership.
uint256 private constant _BITMASK_BURNED = 1 << 224;
// The bit position of the `nextInitialized` bit in packed ownership.
uint256 private constant _BITPOS_NEXT_INITIALIZED = 225;
// The bit mask of the `nextInitialized` bit in packed ownership.
uint256 private constant _BITMASK_NEXT_INITIALIZED = 1 << 225;
// The bit position of `extraData` in packed ownership.
uint256 private constant _BITPOS_EXTRA_DATA = 232;
// Mask of all 256 bits in a packed ownership except the 24 bits for `extraData`.
uint256 private constant _BITMASK_EXTRA_DATA_COMPLEMENT = (1 << 232) - 1;
// The mask of the lower 160 bits for addresses.
uint256 private constant _BITMASK_ADDRESS = (1 << 160) - 1;
// The maximum `quantity` that can be minted with {_mintERC2309}.
// This limit is to prevent overflows on the address data entries.
// For a limit of 5000, a total of 3.689e15 calls to {_mintERC2309}
// is required to cause an overflow, which is unrealistic.
uint256 private constant _MAX_MINT_ERC2309_QUANTITY_LIMIT = 5000;
// The `Transfer` event signature is given by:
// `keccak256(bytes("Transfer(address,address,uint256)"))`.
bytes32 private constant _TRANSFER_EVENT_SIGNATURE =
0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef;
// =============================================================
// CONSTRUCTOR
// =============================================================
function __ERC721A_init(string memory name_, string memory symbol_) internal onlyInitializingERC721A {
__ERC721A_init_unchained(name_, symbol_);
}
function __ERC721A_init_unchained(string memory name_, string memory symbol_) internal onlyInitializingERC721A {
ERC721AStorage.layout()._name = name_;
ERC721AStorage.layout()._symbol = symbol_;
ERC721AStorage.layout()._currentIndex = _startTokenId();
}
// =============================================================
// TOKEN COUNTING OPERATIONS
// =============================================================
/**
* @dev Returns the starting token ID.
* To change the starting token ID, please override this function.
*/
function _startTokenId() internal view virtual returns (uint256) {
return 0;
}
/**
* @dev Returns the next token ID to be minted.
*/
function _nextTokenId() internal view virtual returns (uint256) {
return ERC721AStorage.layout()._currentIndex;
}
/**
* @dev Returns the total number of tokens in existence.
* Burned tokens will reduce the count.
* To get the total number of tokens minted, please see {_totalMinted}.
*/
function totalSupply() public view virtual override returns (uint256) {
// Counter underflow is impossible as _burnCounter cannot be incremented
// more than `_currentIndex - _startTokenId()` times.
unchecked {
return ERC721AStorage.layout()._currentIndex - ERC721AStorage.layout()._burnCounter - _startTokenId();
}
}
/**
* @dev Returns the total amount of tokens minted in the contract.
*/
function _totalMinted() internal view virtual returns (uint256) {
// Counter underflow is impossible as `_currentIndex` does not decrement,
// and it is initialized to `_startTokenId()`.
unchecked {
return ERC721AStorage.layout()._currentIndex - _startTokenId();
}
}
/**
* @dev Returns the total number of tokens burned.
*/
function _totalBurned() internal view virtual returns (uint256) {
return ERC721AStorage.layout()._burnCounter;
}
// =============================================================
// ADDRESS DATA OPERATIONS
// =============================================================
/**
* @dev Returns the number of tokens in `owner`'s account.
*/
function balanceOf(address owner) public view virtual override returns (uint256) {
if (owner == address(0)) revert BalanceQueryForZeroAddress();
return ERC721AStorage.layout()._packedAddressData[owner] & _BITMASK_ADDRESS_DATA_ENTRY;
}
/**
* Returns the number of tokens minted by `owner`.
*/
function _numberMinted(address owner) internal view returns (uint256) {
return
(ERC721AStorage.layout()._packedAddressData[owner] >> _BITPOS_NUMBER_MINTED) & _BITMASK_ADDRESS_DATA_ENTRY;
}
/**
* Returns the number of tokens burned by or on behalf of `owner`.
*/
function _numberBurned(address owner) internal view returns (uint256) {
return
(ERC721AStorage.layout()._packedAddressData[owner] >> _BITPOS_NUMBER_BURNED) & _BITMASK_ADDRESS_DATA_ENTRY;
}
/**
* Returns the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
*/
function _getAux(address owner) internal view returns (uint64) {
return uint64(ERC721AStorage.layout()._packedAddressData[owner] >> _BITPOS_AUX);
}
/**
* Sets the auxiliary data for `owner`. (e.g. number of whitelist mint slots used).
* If there are multiple variables, please pack them into a uint64.
*/
function _setAux(address owner, uint64 aux) internal virtual {
uint256 packed = ERC721AStorage.layout()._packedAddressData[owner];
uint256 auxCasted;
// Cast `aux` with assembly to avoid redundant masking.
assembly {
auxCasted := aux
}
packed = (packed & _BITMASK_AUX_COMPLEMENT) | (auxCasted << _BITPOS_AUX);
ERC721AStorage.layout()._packedAddressData[owner] = packed;
}
// =============================================================
// IERC165
// =============================================================
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* [EIP section](https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified)
* to learn more about how these ids are created.
*
* This function call must use less than 30000 gas.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
// The interface IDs are constants representing the first 4 bytes
// of the XOR of all function selectors in the interface.
// See: [ERC165](https://eips.ethereum.org/EIPS/eip-165)
// (e.g. `bytes4(i.functionA.selector ^ i.functionB.selector ^ ...)`)
return
interfaceId == 0x01ffc9a7 || // ERC165 interface ID for ERC165.
interfaceId == 0x80ac58cd || // ERC165 interface ID for ERC721.
interfaceId == 0x5b5e139f; // ERC165 interface ID for ERC721Metadata.
}
// =============================================================
// IERC721Metadata
// =============================================================
/**
* @dev Returns the token collection name.
*/
function name() public view virtual override returns (string memory) {
return ERC721AStorage.layout()._name;
}
/**
* @dev Returns the token collection symbol.
*/
function symbol() public view virtual override returns (string memory) {
return ERC721AStorage.layout()._symbol;
}
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
if (!_exists(tokenId)) revert URIQueryForNonexistentToken();
string memory baseURI = _baseURI();
return bytes(baseURI).length != 0 ? string(abi.encodePacked(baseURI, _toString(tokenId))) : '';
}
/**
* @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
* token will be the concatenation of the `baseURI` and the `tokenId`. Empty
* by default, it can be overridden in child contracts.
*/
function _baseURI() internal view virtual returns (string memory) {
return '';
}
// =============================================================
// OWNERSHIPS OPERATIONS
// =============================================================
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) public view virtual override returns (address) {
return address(uint160(_packedOwnershipOf(tokenId)));
}
/**
* @dev Gas spent here starts off proportional to the maximum mint batch size.
* It gradually moves to O(1) as tokens get transferred around over time.
*/
function _ownershipOf(uint256 tokenId) internal view virtual returns (TokenOwnership memory) {
return _unpackedOwnership(_packedOwnershipOf(tokenId));
}
/**
* @dev Returns the unpacked `TokenOwnership` struct at `index`.
*/
function _ownershipAt(uint256 index) internal view virtual returns (TokenOwnership memory) {
return _unpackedOwnership(ERC721AStorage.layout()._packedOwnerships[index]);
}
/**
* @dev Initializes the ownership slot minted at `index` for efficiency purposes.
*/
function _initializeOwnershipAt(uint256 index) internal virtual {
if (ERC721AStorage.layout()._packedOwnerships[index] == 0) {
ERC721AStorage.layout()._packedOwnerships[index] = _packedOwnershipOf(index);
}
}
/**
* Returns the packed ownership data of `tokenId`.
*/
function _packedOwnershipOf(uint256 tokenId) private view returns (uint256 packed) {
if (_startTokenId() <= tokenId) {
packed = ERC721AStorage.layout()._packedOwnerships[tokenId];
// If not burned.
if (packed & _BITMASK_BURNED == 0) {
// If the data at the starting slot does not exist, start the scan.
if (packed == 0) {
if (tokenId >= ERC721AStorage.layout()._currentIndex) revert OwnerQueryForNonexistentToken();
// Invariant:
// There will always be an initialized ownership slot
// (i.e. `ownership.addr != address(0) && ownership.burned == false`)
// before an unintialized ownership slot
// (i.e. `ownership.addr == address(0) && ownership.burned == false`)
// Hence, `tokenId` will not underflow.
//
// We can directly compare the packed value.
// If the address is zero, packed will be zero.
for (;;) {
unchecked {
packed = ERC721AStorage.layout()._packedOwnerships[--tokenId];
}
if (packed == 0) continue;
return packed;
}
}
// Otherwise, the data exists and is not burned. We can skip the scan.
// This is possible because we have already achieved the target condition.
// This saves 2143 gas on transfers of initialized tokens.
return packed;
}
}
revert OwnerQueryForNonexistentToken();
}
/**
* @dev Returns the unpacked `TokenOwnership` struct from `packed`.
*/
function _unpackedOwnership(uint256 packed) private pure returns (TokenOwnership memory ownership) {
ownership.addr = address(uint160(packed));
ownership.startTimestamp = uint64(packed >> _BITPOS_START_TIMESTAMP);
ownership.burned = packed & _BITMASK_BURNED != 0;
ownership.extraData = uint24(packed >> _BITPOS_EXTRA_DATA);
}
/**
* @dev Packs ownership data into a single uint256.
*/
function _packOwnershipData(address owner, uint256 flags) private view returns (uint256 result) {
assembly {
// Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
owner := and(owner, _BITMASK_ADDRESS)
// `owner | (block.timestamp << _BITPOS_START_TIMESTAMP) | flags`.
result := or(owner, or(shl(_BITPOS_START_TIMESTAMP, timestamp()), flags))
}
}
/**
* @dev Returns the `nextInitialized` flag set if `quantity` equals 1.
*/
function _nextInitializedFlag(uint256 quantity) private pure returns (uint256 result) {
// For branchless setting of the `nextInitialized` flag.
assembly {
// `(quantity == 1) << _BITPOS_NEXT_INITIALIZED`.
result := shl(_BITPOS_NEXT_INITIALIZED, eq(quantity, 1))
}
}
// =============================================================
// APPROVAL OPERATIONS
// =============================================================
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account. See {ERC721A-_approve}.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
*/
function approve(address to, uint256 tokenId) public payable virtual override {
_approve(to, tokenId, true);
}
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) public view virtual override returns (address) {
if (!_exists(tokenId)) revert ApprovalQueryForNonexistentToken();
return ERC721AStorage.layout()._tokenApprovals[tokenId].value;
}
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom}
* for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
ERC721AStorage.layout()._operatorApprovals[_msgSenderERC721A()][operator] = approved;
emit ApprovalForAll(_msgSenderERC721A(), operator, approved);
}
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
return ERC721AStorage.layout()._operatorApprovals[owner][operator];
}
/**
* @dev Returns whether `tokenId` exists.
*
* Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
*
* Tokens start existing when they are minted. See {_mint}.
*/
function _exists(uint256 tokenId) internal view virtual returns (bool) {
return
_startTokenId() <= tokenId &&
tokenId < ERC721AStorage.layout()._currentIndex && // If within bounds,
ERC721AStorage.layout()._packedOwnerships[tokenId] & _BITMASK_BURNED == 0; // and not burned.
}
/**
* @dev Returns whether `msgSender` is equal to `approvedAddress` or `owner`.
*/
function _isSenderApprovedOrOwner(
address approvedAddress,
address owner,
address msgSender
) private pure returns (bool result) {
assembly {
// Mask `owner` to the lower 160 bits, in case the upper bits somehow aren't clean.
owner := and(owner, _BITMASK_ADDRESS)
// Mask `msgSender` to the lower 160 bits, in case the upper bits somehow aren't clean.
msgSender := and(msgSender, _BITMASK_ADDRESS)
// `msgSender == owner || msgSender == approvedAddress`.
result := or(eq(msgSender, owner), eq(msgSender, approvedAddress))
}
}
/**
* @dev Returns the storage slot and value for the approved address of `tokenId`.
*/
function _getApprovedSlotAndAddress(uint256 tokenId)
private
view
returns (uint256 approvedAddressSlot, address approvedAddress)
{
ERC721AStorage.TokenApprovalRef storage tokenApproval = ERC721AStorage.layout()._tokenApprovals[tokenId];
// The following is equivalent to `approvedAddress = _tokenApprovals[tokenId].value`.
assembly {
approvedAddressSlot := tokenApproval.slot
approvedAddress := sload(approvedAddressSlot)
}
}
// =============================================================
// TRANSFER OPERATIONS
// =============================================================
/**
* @dev Transfers `tokenId` from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) public payable virtual override {
uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);
if (address(uint160(prevOwnershipPacked)) != from) revert TransferFromIncorrectOwner();
(uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);
// The nested ifs save around 20+ gas over a compound boolean condition.
if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();
if (to == address(0)) revert TransferToZeroAddress();
_beforeTokenTransfers(from, to, tokenId, 1);
// Clear approvals from the previous owner.
assembly {
if approvedAddress {
// This is equivalent to `delete _tokenApprovals[tokenId]`.
sstore(approvedAddressSlot, 0)
}
}
// Underflow of the sender's balance is impossible because we check for
// ownership above and the recipient's balance can't realistically overflow.
// Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
unchecked {
// We can directly increment and decrement the balances.
--ERC721AStorage.layout()._packedAddressData[from]; // Updates: `balance -= 1`.
++ERC721AStorage.layout()._packedAddressData[to]; // Updates: `balance += 1`.
// Updates:
// - `address` to the next owner.
// - `startTimestamp` to the timestamp of transfering.
// - `burned` to `false`.
// - `nextInitialized` to `true`.
ERC721AStorage.layout()._packedOwnerships[tokenId] = _packOwnershipData(
to,
_BITMASK_NEXT_INITIALIZED | _nextExtraData(from, to, prevOwnershipPacked)
);
// If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
uint256 nextTokenId = tokenId + 1;
// If the next slot's address is zero and not burned (i.e. packed value is zero).
if (ERC721AStorage.layout()._packedOwnerships[nextTokenId] == 0) {
// If the next slot is within bounds.
if (nextTokenId != ERC721AStorage.layout()._currentIndex) {
// Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
ERC721AStorage.layout()._packedOwnerships[nextTokenId] = prevOwnershipPacked;
}
}
}
}
emit Transfer(from, to, tokenId);
_afterTokenTransfers(from, to, tokenId, 1);
}
/**
* @dev Equivalent to `safeTransferFrom(from, to, tokenId, '')`.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) public payable virtual override {
safeTransferFrom(from, to, tokenId, '');
}
/**
* @dev Safely transfers `tokenId` token from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token
* by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement
* {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes memory _data
) public payable virtual override {
transferFrom(from, to, tokenId);
if (to.code.length != 0)
if (!_checkContractOnERC721Received(from, to, tokenId, _data)) {
revert TransferToNonERC721ReceiverImplementer();
}
}
/**
* @dev Hook that is called before a set of serially-ordered token IDs
* are about to be transferred. This includes minting.
* And also called before burning one token.
*
* `startTokenId` - the first token ID to be transferred.
* `quantity` - the amount to be transferred.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
* transferred to `to`.
* - When `from` is zero, `tokenId` will be minted for `to`.
* - When `to` is zero, `tokenId` will be burned by `from`.
* - `from` and `to` are never both zero.
*/
function _beforeTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal virtual {}
/**
* @dev Hook that is called after a set of serially-ordered token IDs
* have been transferred. This includes minting.
* And also called after one token has been burned.
*
* `startTokenId` - the first token ID to be transferred.
* `quantity` - the amount to be transferred.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` has been
* transferred to `to`.
* - When `from` is zero, `tokenId` has been minted for `to`.
* - When `to` is zero, `tokenId` has been burned by `from`.
* - `from` and `to` are never both zero.
*/
function _afterTokenTransfers(
address from,
address to,
uint256 startTokenId,
uint256 quantity
) internal virtual {}
/**
* @dev Private function to invoke {IERC721Receiver-onERC721Received} on a target contract.
*
* `from` - Previous owner of the given token ID.
* `to` - Target address that will receive the token.
* `tokenId` - Token ID to be transferred.
* `_data` - Optional data to send along with the call.
*
* Returns whether the call correctly returned the expected magic value.
*/
function _checkContractOnERC721Received(
address from,
address to,
uint256 tokenId,
bytes memory _data
) private returns (bool) {
try
ERC721A__IERC721ReceiverUpgradeable(to).onERC721Received(_msgSenderERC721A(), from, tokenId, _data)
returns (bytes4 retval) {
return retval == ERC721A__IERC721ReceiverUpgradeable(to).onERC721Received.selector;
} catch (bytes memory reason) {
if (reason.length == 0) {
revert TransferToNonERC721ReceiverImplementer();
} else {
assembly {
revert(add(32, reason), mload(reason))
}
}
}
}
// =============================================================
// MINT OPERATIONS
// =============================================================
/**
* @dev Mints `quantity` tokens and transfers them to `to`.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `quantity` must be greater than 0.
*
* Emits a {Transfer} event for each mint.
*/
function _mint(address to, uint256 quantity) internal virtual {
uint256 startTokenId = ERC721AStorage.layout()._currentIndex;
if (quantity == 0) revert MintZeroQuantity();
_beforeTokenTransfers(address(0), to, startTokenId, quantity);
// Overflows are incredibly unrealistic.
// `balance` and `numberMinted` have a maximum limit of 2**64.
// `tokenId` has a maximum limit of 2**256.
unchecked {
// Updates:
// - `balance += quantity`.
// - `numberMinted += quantity`.
//
// We can directly add to the `balance` and `numberMinted`.
ERC721AStorage.layout()._packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);
// Updates:
// - `address` to the owner.
// - `startTimestamp` to the timestamp of minting.
// - `burned` to `false`.
// - `nextInitialized` to `quantity == 1`.
ERC721AStorage.layout()._packedOwnerships[startTokenId] = _packOwnershipData(
to,
_nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
);
uint256 toMasked;
uint256 end = startTokenId + quantity;
// Use assembly to loop and emit the `Transfer` event for gas savings.
// The duplicated `log4` removes an extra check and reduces stack juggling.
// The assembly, together with the surrounding Solidity code, have been
// delicately arranged to nudge the compiler into producing optimized opcodes.
assembly {
// Mask `to` to the lower 160 bits, in case the upper bits somehow aren't clean.
toMasked := and(to, _BITMASK_ADDRESS)
// Emit the `Transfer` event.
log4(
0, // Start of data (0, since no data).
0, // End of data (0, since no data).
_TRANSFER_EVENT_SIGNATURE, // Signature.
0, // `address(0)`.
toMasked, // `to`.
startTokenId // `tokenId`.
)
// The `iszero(eq(,))` check ensures that large values of `quantity`
// that overflows uint256 will make the loop run out of gas.
// The compiler will optimize the `iszero` away for performance.
for {
let tokenId := add(startTokenId, 1)
} iszero(eq(tokenId, end)) {
tokenId := add(tokenId, 1)
} {
// Emit the `Transfer` event. Similar to above.
log4(0, 0, _TRANSFER_EVENT_SIGNATURE, 0, toMasked, tokenId)
}
}
if (toMasked == 0) revert MintToZeroAddress();
ERC721AStorage.layout()._currentIndex = end;
}
_afterTokenTransfers(address(0), to, startTokenId, quantity);
}
/**
* @dev Mints `quantity` tokens and transfers them to `to`.
*
* This function is intended for efficient minting only during contract creation.
*
* It emits only one {ConsecutiveTransfer} as defined in
* [ERC2309](https://eips.ethereum.org/EIPS/eip-2309),
* instead of a sequence of {Transfer} event(s).
*
* Calling this function outside of contract creation WILL make your contract
* non-compliant with the ERC721 standard.
* For full ERC721 compliance, substituting ERC721 {Transfer} event(s) with the ERC2309
* {ConsecutiveTransfer} event is only permissible during contract creation.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `quantity` must be greater than 0.
*
* Emits a {ConsecutiveTransfer} event.
*/
function _mintERC2309(address to, uint256 quantity) internal virtual {
uint256 startTokenId = ERC721AStorage.layout()._currentIndex;
if (to == address(0)) revert MintToZeroAddress();
if (quantity == 0) revert MintZeroQuantity();
if (quantity > _MAX_MINT_ERC2309_QUANTITY_LIMIT) revert MintERC2309QuantityExceedsLimit();
_beforeTokenTransfers(address(0), to, startTokenId, quantity);
// Overflows are unrealistic due to the above check for `quantity` to be below the limit.
unchecked {
// Updates:
// - `balance += quantity`.
// - `numberMinted += quantity`.
//
// We can directly add to the `balance` and `numberMinted`.
ERC721AStorage.layout()._packedAddressData[to] += quantity * ((1 << _BITPOS_NUMBER_MINTED) | 1);
// Updates:
// - `address` to the owner.
// - `startTimestamp` to the timestamp of minting.
// - `burned` to `false`.
// - `nextInitialized` to `quantity == 1`.
ERC721AStorage.layout()._packedOwnerships[startTokenId] = _packOwnershipData(
to,
_nextInitializedFlag(quantity) | _nextExtraData(address(0), to, 0)
);
emit ConsecutiveTransfer(startTokenId, startTokenId + quantity - 1, address(0), to);
ERC721AStorage.layout()._currentIndex = startTokenId + quantity;
}
_afterTokenTransfers(address(0), to, startTokenId, quantity);
}
/**
* @dev Safely mints `quantity` tokens and transfers them to `to`.
*
* Requirements:
*
* - If `to` refers to a smart contract, it must implement
* {IERC721Receiver-onERC721Received}, which is called for each safe transfer.
* - `quantity` must be greater than 0.
*
* See {_mint}.
*
* Emits a {Transfer} event for each mint.
*/
function _safeMint(
address to,
uint256 quantity,
bytes memory _data
) internal virtual {
_mint(to, quantity);
unchecked {
if (to.code.length != 0) {
uint256 end = ERC721AStorage.layout()._currentIndex;
uint256 index = end - quantity;
do {
if (!_checkContractOnERC721Received(address(0), to, index++, _data)) {
revert TransferToNonERC721ReceiverImplementer();
}
} while (index < end);
// Reentrancy protection.
if (ERC721AStorage.layout()._currentIndex != end) revert();
}
}
}
/**
* @dev Equivalent to `_safeMint(to, quantity, '')`.
*/
function _safeMint(address to, uint256 quantity) internal virtual {
_safeMint(to, quantity, '');
}
// =============================================================
// APPROVAL OPERATIONS
// =============================================================
/**
* @dev Equivalent to `_approve(to, tokenId, false)`.
*/
function _approve(address to, uint256 tokenId) internal virtual {
_approve(to, tokenId, false);
}
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the
* zero address clears previous approvals.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function _approve(
address to,
uint256 tokenId,
bool approvalCheck
) internal virtual {
address owner = ownerOf(tokenId);
if (approvalCheck)
if (_msgSenderERC721A() != owner)
if (!isApprovedForAll(owner, _msgSenderERC721A())) {
revert ApprovalCallerNotOwnerNorApproved();
}
ERC721AStorage.layout()._tokenApprovals[tokenId].value = to;
emit Approval(owner, to, tokenId);
}
// =============================================================
// BURN OPERATIONS
// =============================================================
/**
* @dev Equivalent to `_burn(tokenId, false)`.
*/
function _burn(uint256 tokenId) internal virtual {
_burn(tokenId, false);
}
/**
* @dev Destroys `tokenId`.
* The approval is cleared when the token is burned.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits a {Transfer} event.
*/
function _burn(uint256 tokenId, bool approvalCheck) internal virtual {
uint256 prevOwnershipPacked = _packedOwnershipOf(tokenId);
address from = address(uint160(prevOwnershipPacked));
(uint256 approvedAddressSlot, address approvedAddress) = _getApprovedSlotAndAddress(tokenId);
if (approvalCheck) {
// The nested ifs save around 20+ gas over a compound boolean condition.
if (!_isSenderApprovedOrOwner(approvedAddress, from, _msgSenderERC721A()))
if (!isApprovedForAll(from, _msgSenderERC721A())) revert TransferCallerNotOwnerNorApproved();
}
_beforeTokenTransfers(from, address(0), tokenId, 1);
// Clear approvals from the previous owner.
assembly {
if approvedAddress {
// This is equivalent to `delete _tokenApprovals[tokenId]`.
sstore(approvedAddressSlot, 0)
}
}
// Underflow of the sender's balance is impossible because we check for
// ownership above and the recipient's balance can't realistically overflow.
// Counter overflow is incredibly unrealistic as `tokenId` would have to be 2**256.
unchecked {
// Updates:
// - `balance -= 1`.
// - `numberBurned += 1`.
//
// We can directly decrement the balance, and increment the number burned.
// This is equivalent to `packed -= 1; packed += 1 << _BITPOS_NUMBER_BURNED;`.
ERC721AStorage.layout()._packedAddressData[from] += (1 << _BITPOS_NUMBER_BURNED) - 1;
// Updates:
// - `address` to the last owner.
// - `startTimestamp` to the timestamp of burning.
// - `burned` to `true`.
// - `nextInitialized` to `true`.
ERC721AStorage.layout()._packedOwnerships[tokenId] = _packOwnershipData(
from,
(_BITMASK_BURNED | _BITMASK_NEXT_INITIALIZED) | _nextExtraData(from, address(0), prevOwnershipPacked)
);
// If the next slot may not have been initialized (i.e. `nextInitialized == false`) .
if (prevOwnershipPacked & _BITMASK_NEXT_INITIALIZED == 0) {
uint256 nextTokenId = tokenId + 1;
// If the next slot's address is zero and not burned (i.e. packed value is zero).
if (ERC721AStorage.layout()._packedOwnerships[nextTokenId] == 0) {
// If the next slot is within bounds.
if (nextTokenId != ERC721AStorage.layout()._currentIndex) {
// Initialize the next slot to maintain correctness for `ownerOf(tokenId + 1)`.
ERC721AStorage.layout()._packedOwnerships[nextTokenId] = prevOwnershipPacked;
}
}
}
}
emit Transfer(from, address(0), tokenId);
_afterTokenTransfers(from, address(0), tokenId, 1);
// Overflow not possible, as _burnCounter cannot be exceed _currentIndex times.
unchecked {
ERC721AStorage.layout()._burnCounter++;
}
}
// =============================================================
// EXTRA DATA OPERATIONS
// =============================================================
/**
* @dev Directly sets the extra data for the ownership data `index`.
*/
function _setExtraDataAt(uint256 index, uint24 extraData) internal virtual {
uint256 packed = ERC721AStorage.layout()._packedOwnerships[index];
if (packed == 0) revert OwnershipNotInitializedForExtraData();
uint256 extraDataCasted;
// Cast `extraData` with assembly to avoid redundant masking.
assembly {
extraDataCasted := extraData
}
packed = (packed & _BITMASK_EXTRA_DATA_COMPLEMENT) | (extraDataCasted << _BITPOS_EXTRA_DATA);
ERC721AStorage.layout()._packedOwnerships[index] = packed;
}
/**
* @dev Called during each token transfer to set the 24bit `extraData` field.
* Intended to be overridden by the cosumer contract.
*
* `previousExtraData` - the value of `extraData` before transfer.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, `from`'s `tokenId` will be
* transferred to `to`.
* - When `from` is zero, `tokenId` will be minted for `to`.
* - When `to` is zero, `tokenId` will be burned by `from`.
* - `from` and `to` are never both zero.
*/
function _extraData(
address from,
address to,
uint24 previousExtraData
) internal view virtual returns (uint24) {}
/**
* @dev Returns the next extra data for the packed ownership data.
* The returned result is shifted into position.
*/
function _nextExtraData(
address from,
address to,
uint256 prevOwnershipPacked
) private view returns (uint256) {
uint24 extraData = uint24(prevOwnershipPacked >> _BITPOS_EXTRA_DATA);
return uint256(_extraData(from, to, extraData)) << _BITPOS_EXTRA_DATA;
}
// =============================================================
// OTHER OPERATIONS
// =============================================================
/**
* @dev Returns the message sender (defaults to `msg.sender`).
*
* If you are writing GSN compatible contracts, you need to override this function.
*/
function _msgSenderERC721A() internal view virtual returns (address) {
return msg.sender;
}
/**
* @dev Converts a uint256 to its ASCII string decimal representation.
*/
function _toString(uint256 value) internal pure virtual returns (string memory str) {
assembly {
// The maximum value of a uint256 contains 78 digits (1 byte per digit), but
// we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned.
// We will need 1 word for the trailing zeros padding, 1 word for the length,
// and 3 words for a maximum of 78 digits. Total: 5 * 0x20 = 0xa0.
let m := add(mload(0x40), 0xa0)
// Update the free memory pointer to allocate.
mstore(0x40, m)
// Assign the `str` to the end.
str := sub(m, 0x20)
// Zeroize the slot after the string.
mstore(str, 0)
// Cache the end of the memory to calculate the length later.
let end := str
// We write the string from rightmost digit to leftmost digit.
// The following is essentially a do-while loop that also handles the zero case.
// prettier-ignore
for { let temp := value } 1 {} {
str := sub(str, 1)
// Write the character to the pointer.
// The ASCII index of the '0' character is 48.
mstore8(str, add(48, mod(temp, 10)))
// Keep dividing `temp` until zero.
temp := div(temp, 10)
// prettier-ignore
if iszero(temp) { break }
}
let length := sub(end, str)
// Move the pointer 32 bytes leftwards to make room for the length.
str := sub(str, 0x20)
// Store the length.
mstore(str, length)
}
}
}
// lib/ERC721A-Upgradeable/contracts/extensions/ERC721ABurnableUpgradeable.sol
// ERC721A Contracts v4.2.3
// Creator: Chiru Labs
/**
* @title ERC721ABurnable.
*
* @dev ERC721A token that can be irreversibly burned (destroyed).
*/
abstract contract ERC721ABurnableUpgradeable is
ERC721A__Initializable,
ERC721AUpgradeable,
IERC721ABurnableUpgradeable
{
function __ERC721ABurnable_init() internal onlyInitializingERC721A {
__ERC721ABurnable_init_unchained();
}
function __ERC721ABurnable_init_unchained() internal onlyInitializingERC721A {}
/**
* @dev Burns `tokenId`. See {ERC721A-_burn}.
*
* Requirements:
*
* - The caller must own `tokenId` or be an approved operator.
*/
function burn(uint256 tokenId) public virtual override {
_burn(tokenId, true);
}
}
// lib/openzeppelin-contracts-upgradeable/contracts/proxy/utils/UUPSUpgradeable.sol
// OpenZeppelin Contracts (last updated v5.0.0) (proxy/utils/UUPSUpgradeable.sol)
/**
* @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an
* {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.
*
* A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is
* reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing
* `UUPSUpgradeable` with a custom implementation of upgrades.
*
* The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.
*/
abstract contract UUPSUpgradeable is Initializable, IERC1822Proxiable {
/// @custom:oz-upgrades-unsafe-allow state-variable-immutable
address private immutable __self = address(this);
/**
* @dev The version of the upgrade interface of the contract. If this getter is missing, both `upgradeTo(address)`
* and `upgradeToAndCall(address,bytes)` are present, and `upgradeTo` must be used if no function should be called,
* while `upgradeToAndCall` will invoke the `receive` function if the second argument is the empty byte string.
* If the getter returns `"5.0.0"`, only `upgradeToAndCall(address,bytes)` is present, and the second argument must
* be the empty byte string if no function should be called, making it impossible to invoke the `receive` function
* during an upgrade.
*/
string public constant UPGRADE_INTERFACE_VERSION = "5.0.0";
/**
* @dev The call is from an unauthorized context.
*/
error UUPSUnauthorizedCallContext();
/**
* @dev The storage `slot` is unsupported as a UUID.
*/
error UUPSUnsupportedProxiableUUID(bytes32 slot);
/**
* @dev Check that the execution is being performed through a delegatecall call and that the execution context is
* a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case
* for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a
* function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to
* fail.
*/
modifier onlyProxy() {
_checkProxy();
_;
}
/**
* @dev Check that the execution is not being performed through a delegate call. This allows a function to be
* callable on the implementing contract but not through proxies.
*/
modifier notDelegated() {
_checkNotDelegated();
_;
}
function __UUPSUpgradeable_init() internal onlyInitializing {
}
function __UUPSUpgradeable_init_unchained() internal onlyInitializing {
}
/**
* @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the
* implementation. It is used to validate the implementation's compatibility when performing an upgrade.
*
* IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
* bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
* function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.
*/
function proxiableUUID() external view virtual notDelegated returns (bytes32) {
return ERC1967Utils.IMPLEMENTATION_SLOT;
}
/**
* @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call
* encoded in `data`.
*
* Calls {_authorizeUpgrade}.
*
* Emits an {Upgraded} event.
*
* @custom:oz-upgrades-unsafe-allow-reachable delegatecall
*/
function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {
_authorizeUpgrade(newImplementation);
_upgradeToAndCallUUPS(newImplementation, data);
}
/**
* @dev Reverts if the execution is not performed via delegatecall or the execution
* context is not of a proxy with an ERC1967-compliant implementation pointing to self.
* See {_onlyProxy}.
*/
function _checkProxy() internal view virtual {
if (
address(this) == __self || // Must be called through delegatecall
ERC1967Utils.getImplementation() != __self // Must be called through an active proxy
) {
revert UUPSUnauthorizedCallContext();
}
}
/**
* @dev Reverts if the execution is performed via delegatecall.
* See {notDelegated}.
*/
function _checkNotDelegated() internal view virtual {
if (address(this) != __self) {
// Must not be called through delegatecall
revert UUPSUnauthorizedCallContext();
}
}
/**
* @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
* {upgradeToAndCall}.
*
* Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.
*
* ```solidity
* function _authorizeUpgrade(address) internal onlyOwner {}
* ```
*/
function _authorizeUpgrade(address newImplementation) internal virtual;
/**
* @dev Performs an implementation upgrade with a security check for UUPS proxies, and additional setup call.
*
* As a security check, {proxiableUUID} is invoked in the new implementation, and the return value
* is expected to be the implementation slot in ERC1967.
*
* Emits an {IERC1967-Upgraded} event.
*/
function _upgradeToAndCallUUPS(address newImplementation, bytes memory data) private {
try IERC1822Proxiable(newImplementation).proxiableUUID() returns (bytes32 slot) {
if (slot != ERC1967Utils.IMPLEMENTATION_SLOT) {
revert UUPSUnsupportedProxiableUUID(slot);
}
ERC1967Utils.upgradeToAndCall(newImplementation, data);
} catch {
// The implementation is not UUPS
revert ERC1967Utils.ERC1967InvalidImplementation(newImplementation);
}
}
}
// src/Adventurer.sol
/**
* @title Adventurer
*/
contract Adventurer is
IAdventurer,
IERC4906,
ERC2981,
OwnableRoles,
ERC721ABurnableUpgradeable,
Initializable,
UUPSUpgradeable
{
using ECDSA for bytes32;
uint256 public constant MAX_TOKENS = 7000;
uint256 public constant TREASURY_ALLOCATION = 550;
/// @dev Base token URI for the collection.
string public baseTokenURI;
/// @dev Address of the signer used to verify mint signatures.
address public signer;
/// @dev Flag indicating if the mint is active.
bool public mintable;
/**
* Disable initializers so that storage of the implementation contract cannot be modified.
*/
constructor() {
_disableInitializers();
}
/**
* @inheritdoc IAdventurer
*/
function initialize(
address _owner,
address _admin,
address _signer,
address _treasury,
string calldata _baseTokenURI
)
external
initializerERC721A
initializer
{
/// @dev No zero check for `_treasury` as `_mint` will revert if the `to` address is zero.
if (_owner == address(0) || _admin == address(0) || _signer == address(0)) revert ZeroAddress();
__ERC721A_init({ name_: "Abstract Adventurers", symbol_: "ADVNT" });
_initializeOwner({ newOwner: _owner });
_grantRoles({ user: _admin, roles: AccessRoles.ADMIN_ROLE });
signer = _signer;
baseTokenURI = _baseTokenURI;
uint256 batchSize = 50;
uint256 batchCount = TREASURY_ALLOCATION / batchSize;
/// Mint treasury allocation in batches of 50 tokens to prevent potential gas issues on later transfers.
for (uint256 i = 0; i < batchCount; i++) {
_mint({ to: _treasury, quantity: batchSize });
}
}
/**
* @inheritdoc IAdventurer
*/
function mint(bytes calldata signature) external {
if (!mintable) revert MintInactive();
if (_totalMinted() + 1 > MAX_TOKENS) revert MintExceedsTotalSupply();
if (_getAux({ owner: msg.sender }) == 1) revert AccountHasClaimed();
_setAux({ owner: msg.sender, aux: 1 });
bytes32 digest = keccak256(abi.encodePacked(msg.sender)).toEthSignedMessageHash();
if (signer != digest.recoverCalldata(signature)) revert SignerMismatch();
_mint({ to: msg.sender, quantity: 1 });
}
/**
* @inheritdoc IAdventurer
*/
function airdrop(address[] calldata accounts) external onlyRoles(AccessRoles.ADMIN_ROLE) {
if (accounts.length == 0) revert ZeroLengthArray();
if (_totalMinted() + accounts.length > MAX_TOKENS) revert MintExceedsTotalSupply();
for (uint256 i = 0; i < accounts.length; i++) {
address account = accounts[i];
/// @dev Set auxiliary value to `1` so that airdropped accounts cannot participate in the mint.
if (_getAux({ owner: account }) == 1) revert AccountHasClaimed();
_setAux({ owner: account, aux: 1 });
_mint({ to: account, quantity: 1 });
}
}
/**
* @inheritdoc IAdventurer
*/
function adminMint(address receiver, uint256 quantity) external onlyRoles(AccessRoles.ADMIN_ROLE) {
if (_totalMinted() + quantity > MAX_TOKENS) revert MintExceedsTotalSupply();
_mint({ to: receiver, quantity: quantity });
}
/**
* @inheritdoc IAdventurer
*/
function setSigner(address newSigner) external onlyRoles(AccessRoles.ADMIN_ROLE) {
if (newSigner == address(0)) revert ZeroAddress();
address oldSigner = signer;
signer = newSigner;
emit SignerUpdated(oldSigner, newSigner);
}
/**
* @inheritdoc IAdventurer
*/
function setBaseTokenURI(string calldata newBaseTokenURI) external onlyRoles(AccessRoles.ADMIN_ROLE) {
string memory oldBaseTokenURI = baseTokenURI;
baseTokenURI = newBaseTokenURI;
emit BaseTokenURIUpdated(oldBaseTokenURI, newBaseTokenURI);
}
/**
* @inheritdoc IAdventurer
*/
function toggleMint() external onlyRoles(AccessRoles.ADMIN_ROLE) {
bool oldFlag = mintable;
mintable = !oldFlag;
emit MintStateUpdated({ oldMintState: oldFlag, newMintState: !oldFlag });
}
/**
* @inheritdoc IAdventurer
*/
function updateMetadata() external {
emit BatchMetadataUpdate({ _fromTokenId: _startTokenId(), _toTokenId: _totalMinted() });
}
/**
* @inheritdoc IAdventurer
*/
function hasClaimed(address account) external view returns (bool) {
return _getAux({ owner: account }) == 1;
}
/**
* Overriden to acknowledge support for IERC4906 and IERC2981.
*/
function supportsInterface(bytes4 interfaceId)
public
view
override(ERC721AUpgradeable, IERC721AUpgradeable, ERC2981)
returns (bool)
{
/// forgefmt: disable-next-item
return interfaceId == 0x49064906
|| ERC2981.supportsInterface(interfaceId)
|| super.supportsInterface(interfaceId);
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* ERC2981 */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
/**
* Function used to set the default royalty information.
* @param receiver Address to receive royalties.
* @param feeNumerator Fee numerator out of 10,000.
*/
function setDefaultRoyalty(address receiver, uint96 feeNumerator) external onlyRoles(AccessRoles.ADMIN_ROLE) {
_setDefaultRoyalty(receiver, feeNumerator);
}
/**
* Function used to delete the default royalty information.
*/
function deleteDefaultRoyalty() external onlyRoles(AccessRoles.ADMIN_ROLE) {
_deleteDefaultRoyalty();
}
/**
* Function used to set token specific royalty information.
* @param tokenId Token ID to set royalty for.
* @param receiver Address to receive royalties.
* @param feeNumerator Fee numerator out of 10,000.
*/
function setTokenRoyalty(
uint256 tokenId,
address receiver,
uint96 feeNumerator
)
external
onlyRoles(AccessRoles.ADMIN_ROLE)
{
_setTokenRoyalty(tokenId, receiver, feeNumerator);
}
/**
* Function used to reset token specific royalty information.
* @param tokenId Token ID to reset royalty for.
*/
function resetTokenRoyalty(uint256 tokenId) external onlyRoles(AccessRoles.ADMIN_ROLE) {
_resetTokenRoyalty(tokenId);
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* ERC721A OVERRIDES */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
function _startTokenId() internal pure override returns (uint256) {
return 1;
}
function _baseURI() internal view override returns (string memory) {
return baseTokenURI;
}
/*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
/* UUPSUPGRADEABLE */
/*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/
function _authorizeUpgrade(address) internal override onlyRoles(AccessRoles.ADMIN_ROLE) { }
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AccountHasClaimed","type":"error"},{"inputs":[{"internalType":"address","name":"target","type":"address"}],"name":"AddressEmptyCode","type":"error"},{"inputs":[],"name":"AirdropComplete","type":"error"},{"inputs":[],"name":"AlreadyInitialized","type":"error"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"ApprovalQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"BalanceQueryForZeroAddress","type":"error"},{"inputs":[{"internalType":"address","name":"implementation","type":"address"}],"name":"ERC1967InvalidImplementation","type":"error"},{"inputs":[],"name":"ERC1967NonPayable","type":"error"},{"inputs":[],"name":"FailedInnerCall","type":"error"},{"inputs":[],"name":"InvalidAirdropAmount","type":"error"},{"inputs":[],"name":"InvalidInitialization","type":"error"},{"inputs":[],"name":"MintERC2309QuantityExceedsLimit","type":"error"},{"inputs":[],"name":"MintExceedsTotalSupply","type":"error"},{"inputs":[],"name":"MintInactive","type":"error"},{"inputs":[],"name":"MintToZeroAddress","type":"error"},{"inputs":[],"name":"MintZeroQuantity","type":"error"},{"inputs":[],"name":"NewOwnerIsZeroAddress","type":"error"},{"inputs":[],"name":"NoHandoverRequest","type":"error"},{"inputs":[],"name":"NotInitializing","type":"error"},{"inputs":[],"name":"OwnerQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"OwnershipNotInitializedForExtraData","type":"error"},{"inputs":[],"name":"RoyaltyOverflow","type":"error"},{"inputs":[],"name":"RoyaltyReceiverIsZeroAddress","type":"error"},{"inputs":[],"name":"SignerMismatch","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToNonERC721ReceiverImplementer","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"URIQueryForNonexistentToken","type":"error"},{"inputs":[],"name":"UUPSUnauthorizedCallContext","type":"error"},{"inputs":[{"internalType":"bytes32","name":"slot","type":"bytes32"}],"name":"UUPSUnsupportedProxiableUUID","type":"error"},{"inputs":[],"name":"Unauthorized","type":"error"},{"inputs":[],"name":"ZeroAddress","type":"error"},{"inputs":[],"name":"ZeroLengthArray","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"oldBaseTokenURI","type":"string"},{"indexed":false,"internalType":"string","name":"newBaseTokenURI","type":"string"}],"name":"BaseTokenURIUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_toTokenId","type":"uint256"}],"name":"BatchMetadataUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"toTokenId","type":"uint256"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"}],"name":"ConsecutiveTransfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint64","name":"version","type":"uint64"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"MetadataUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bool","name":"oldMintState","type":"bool"},{"indexed":false,"internalType":"bool","name":"newMintState","type":"bool"}],"name":"MintStateUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverCanceled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverRequested","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"user","type":"address"},{"indexed":true,"internalType":"uint256","name":"roles","type":"uint256"}],"name":"RolesUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldSigner","type":"address"},{"indexed":true,"internalType":"address","name":"newSigner","type":"address"}],"name":"SignerUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"inputs":[],"name":"MAX_TOKENS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"TREASURY_ALLOCATION","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"UPGRADE_INTERFACE_VERSION","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"adminMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"}],"name":"airdrop","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseTokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"cancelOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"completeOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"deleteDefaultRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"grantRoles","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"hasAllRoles","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"hasAnyRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"hasClaimed","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_owner","type":"address"},{"internalType":"address","name":"_admin","type":"address"},{"internalType":"address","name":"_signer","type":"address"},{"internalType":"address","name":"_treasury","type":"address"},{"internalType":"string","name":"_baseTokenURI","type":"string"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes","name":"signature","type":"bytes"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"mintable","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"result","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"ownershipHandoverExpiresAt","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"proxiableUUID","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"renounceRoles","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"requestOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"resetTokenRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"revokeRoles","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"rolesOf","outputs":[{"internalType":"uint256","name":"roles","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"royaltyAmount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"newBaseTokenURI","type":"string"}],"name":"setBaseTokenURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setDefaultRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newSigner","type":"address"}],"name":"setSigner","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setTokenRoyalty","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"signer","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"toggleMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"updateMetadata","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"upgradeToAndCall","outputs":[],"stateMutability":"payable","type":"function"}]Contract Creation Code
9c4d535b00000000000000000000000000000000000000000000000000000000000000000100065159d507cd1330c111f7fffc9945c071a90720c296bef90007b28577d600000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x0003000000000002000d00000000000200000060031002700000057b033001970002000000310355000100000001035500000001002001900000003a0000c13d0000008007000039000000400070043f000000040030008c00000bdd0000413d000000000201043b000000e002200270000005820020009c000000610000213d000005a40020009c0000007e0000a13d000005a50020009c000000c00000a13d000005a60020009c000001460000a13d000005a70020009c000002a20000213d000005aa0020009c000003950000613d000005ab0020009c00000bdd0000c13d0000000001000416000000000001004b00000bdd0000c13d0000060601000041000000000010044300000000010004120000000400100443000000240000044300000000010004140000057b0010009c0000057b01008041000000c00110021000000607011001c7000080050200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000005c5011001970000000002000410000000000012004b0000072c0000c13d000000400100043d000006080200004100000000002104350000057b0010009c0000057b010080410000004001100210000005cf011001c7000015e70001042e000000a001000039000000400010043f0000000001000416000000000001004b00000bdd0000c13d0000000001000410000000800010043f0000057c02000041000000000202041a0000057d002001980000099d0000c13d0000057e032001970000057e0030009c000000590000613d0000057e012001c70000057c02000041000000000012041b0000057e01000041000000a00010043f00000000010004140000057b0010009c0000057b01008041000000c0011002100000057f011001c70000800d020000390000000103000039000005800400004115e615d70000040f000000010020019000000bdd0000613d000000800100043d0000000102000039000001400000044300000160001004430000002001000039000001000010044300000120002004430000058101000041000015e70001042e000005830020009c000000a70000a13d000005840020009c000000fe0000a13d000005850020009c0000016b0000a13d000005860020009c000002db0000213d000005890020009c000003a70000613d0000058a0020009c00000bdd0000c13d000000240030008c00000bdd0000413d0000000401100370000000000101043b000005c50010009c00000bdd0000213d000005c802000041000000000202041a0000000003000411000000000023004b000007280000c13d000000000001004b000007a60000c13d000005c901000041000000000010043f000005ca01000041000015e800010430000005b60020009c0000011e0000213d000005be0020009c000002360000213d000005c20020009c000005f20000613d000005c30020009c000004b10000613d000005c40020009c00000bdd0000c13d0000000001000416000000000001004b00000bdd0000c13d0000062901000041000000000201041a000000010320019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000043004b000006890000c13d000000800010043f000000000003004b000006ad0000613d0000062902000041000000000020043f000000000001004b0000000002000019000006b20000613d0000062b030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b0000009f0000413d000006b20000013d000005950020009c000001390000213d0000059d0020009c000002480000213d000005a10020009c000006000000613d000005a20020009c000004d80000613d000005a30020009c00000bdd0000c13d000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000101043b000005c50010009c00000bdd0000213d000000000001004b000006c30000c13d0000060101000041000000000010043f000005da01000041000015e800010430000005af0020009c000001860000213d000005b30020009c000004140000613d000005b40020009c0000032b0000613d000005b50020009c00000bdd0000c13d000000a40030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b000b00000002001d000005c50020009c00000bdd0000213d0000002402100370000000000202043b000a00000002001d000005c50020009c00000bdd0000213d0000004402100370000000000202043b000900000002001d000005c50020009c00000bdd0000213d0000006402100370000000000202043b000800000002001d000005c50020009c00000bdd0000213d0000008402100370000000000202043b0000057e0020009c00000bdd0000213d0000002304200039000000000034004b00000bdd0000813d0000000404200039000000000141034f000000000101043b000700000001001d0000057e0010009c00000bdd0000213d0000002402200039000600000002001d0000000701200029000000000031004b00000bdd0000213d0000061f01000041000000000101041a0005ff0000100194000009700000c13d000000ff0010019000000a6d0000c13d000006240110019700000101011001bf0000061f02000041000000000012041b000009800000013d0000058e0020009c000002000000213d000005920020009c0000045e0000613d000005930020009c000003360000613d000005940020009c00000bdd0000c13d000000840030008c00000bdd0000413d0000000402100370000000000202043b000b00000002001d000005c50020009c00000bdd0000213d0000002402100370000000000202043b000a00000002001d000005c50020009c00000bdd0000213d0000006402100370000000000202043b0000057e0020009c00000bdd0000213d0000004401100370000000000101043b000900000001001d0000000401200039000000000203001915e610fb0000040f0000000004010019000003550000013d000005b70020009c0000025e0000213d000005bb0020009c000006100000613d000005bc0020009c000004fa0000613d000005bd0020009c00000bdd0000c13d000000440030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b000005c50020009c00000bdd0000213d0000002401100370000000000101043b000b00000001001d000000000102001915e612b40000040f0000000b0110017f0000000b0010006c00000000010000390000000101006039000006090000013d000005960020009c0000028b0000213d0000059a0020009c000006180000613d0000059b0020009c0000050a0000613d0000059c0020009c00000bdd0000c13d0000000001000416000000000001004b00000bdd0000c13d000005c801000041000006760000013d000005ac0020009c000003fa0000613d000005ad0020009c000002f20000613d000005ae0020009c00000bdd0000c13d000000440030008c00000bdd0000413d0000000402100370000000000202043b000b00000002001d000005c50020009c00000bdd0000213d0000002402100370000000000402043b0000057e0040009c00000bdd0000213d0000002302400039000000000032004b00000bdd0000813d0000000405400039000000000251034f000000000202043b0000057e0020009c000001650000213d0000001f0620003900000647066001970000003f066000390000064706600197000006090060009c000006dc0000a13d000005fd01000041000000000010043f0000004101000039000000040010043f000005fe01000041000015e8000104300000058b0020009c0000040a0000613d0000058c0020009c000002fd0000613d0000058d0020009c00000bdd0000c13d000000440030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b000005c50020009c00000bdd0000213d0000002401100370000000000101043b000b00000001001d000005c50010009c00000bdd0000213d000000000102001915e6118f0000040f0000000b0200002915e611a00000040f000000000101041a000000ff00100190000003a40000013d000005b00020009c000004660000613d000005b10020009c0000034a0000613d000005b20020009c00000bdd0000c13d000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000101043b000000000001004b0000068f0000613d000a00000001001d000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000005df001001980000068f0000c13d000000000001004b000001c10000c13d000005d101000041000000000101041a0000000a02000029000000000021004b0000068f0000a13d000b00000002001d0000000b01000029000000010110008a000b00000001001d000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000000000001004b000001ae0000613d000b00000001001d0000000a01000029000000000010043f0000061801000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d0000000b02000029000005c502200197000000000101043b000800000001001d000000000301041a0000000001000411000005c501100197000900000002001d000000000021004b000007c90000613d000000000031004b000007c90000613d000700000001001d000600000003001d0000000901000029000000000010043f000005ea01000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b0000000702000029000000000020043f000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000000ff001001900000000603000029000007c90000c13d0000061901000041000000000010043f000005da01000041000015e8000104300000058f0020009c000004aa0000613d000005900020009c0000035b0000613d000005910020009c00000bdd0000c13d0000000001000416000000000001004b00000bdd0000c13d000005d0010000410000000c0010043f0000000001000411000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a0000000100100190000007280000613d0000000103000039000000000103041a000005db02100197000005dc001001980000000001000019000005dd01006041000000000121019f000000000013041b00000000010000390000000101006039000000400200043d000000200420003900000000001404350000000001000039000000010100c03900000000001204350000057b0020009c0000057b02008041000000400120021000000000020004140000057b0020009c0000057b02008041000000c002200210000000000112019f000005d3011001c70000800d02000039000005de04000041000002a10000013d000005bf0020009c000006360000613d000005c00020009c0000051d0000613d000005c10020009c00000bdd0000c13d0000000001000416000000000001004b00000bdd0000c13d0000061c01000041000000000101041a0000064801100167000005d102000041000000000202041a0000000001120019000000800010043f000005c701000041000015e70001042e0000059e0020009c0000065d0000613d0000059f0020009c0000057a0000613d000005a00020009c00000bdd0000c13d000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000101043b000005c50010009c00000bdd0000213d15e6117e0000040f000000000101041a000005ef01100197000005f00010009c00000000010000390000000101006039000006090000013d000005b80020009c000006720000613d000005b90020009c000005a90000613d000005ba0020009c00000bdd0000c13d000005c6010000410000000c0010043f0000000001000411000000000010043f000005cc01000041000000000010044300000000010004140000057b0010009c0000057b01008041000000c001100210000005cd011001c70000800b0200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000b00000001001d00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b0000000b02000029000006380220009a000000000021041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d0200003900000002030000390000063904000041000003ed0000013d000005970020009c0000067b0000613d000005980020009c000005ae0000613d000005990020009c00000bdd0000c13d0000000001000416000000000001004b00000bdd0000c13d000005d101000041000000000101041a0000000103000039000000800030043f000000010110008a000000a00010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005e8011001c70000800d02000039000005e904000041000003ee0000013d000005a80020009c000003d60000613d000005a90020009c00000bdd0000c13d000000640030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b000a00000002001d0000002402100370000000000202043b000b00000002001d000005c50020009c00000bdd0000213d0000004401100370000000000101043b000900000001001d000006040010009c00000bdd0000213d000005d0010000410000000c0010043f0000000001000411000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a0000000100100190000007280000613d0000000901000029000027100010008c000004d40000213d0000000b0000006b000007ab0000613d0000000a01000029000000000010043f000005e701000041000000200010043f0000004002000039000000000100001915e615c20000040f0000000b02000029000000600220021000000009022001af000000000021041b0000000001000019000015e70001042e000005870020009c000003f30000613d000005880020009c00000bdd0000c13d000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000101043b000005c50010009c00000bdd0000213d000005c6020000410000000c0020043f000000000010043f0000000c01000039000000200200003915e615c20000040f000000000101041a000000800010043f000005c701000041000015e70001042e0000000001000416000000000001004b00000bdd0000c13d0000000101000039000000000101041a000005dc001001980000000001000039000000010100c039000000800010043f000005c701000041000015e70001042e000000440030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b000a00000002001d000005c50020009c00000bdd0000213d0000002401100370000000000101043b000900000001001d000005d0010000410000000c0010043f0000000001000411000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a0000000100100190000007280000613d000005d101000041000000000201041a000000010120008a0000000903000029000000000031001a000007430000413d000000000131001900001b580010008c000008810000213d000b00000002001d000000000003004b000007490000c13d000005d901000041000000000010043f000005da01000041000015e800010430000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000101043b000005c50010009c00000bdd0000213d15e612b40000040f000006090000013d0000000001000416000000000001004b00000bdd0000c13d000000c001000039000000400010043f0000000501000039000000800010043f000005e501000041000000a00010043f0000002001000039000000c00010043f0000008001000039000000e00200003915e610700000040f000000c00110008a0000057b0010009c0000057b010080410000006001100210000005e6011001c7000015e70001042e000000000103001915e610d70000040f000b00000001001d000a00000002001d000900000003001d000000400100043d000800000001001d000000200200003915e610e90000040f000000080400002900000000000404350000000b010000290000000a02000029000000090300002915e612c50000040f0000000001000019000015e70001042e000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000201043b000000000002004b000006930000613d000005d101000041000000000101041a000000000021004b000006930000a13d000b00000002001d000000000020043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000005df00100198000006930000c13d000000000200041a000000010320019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000442013f0000000100400190000006890000c13d000000400500043d0000000004150436000000000003004b0000085f0000613d000000000000043f000000000001004b0000000002000019000008640000613d000005e00300004100000000020000190000000006240019000000000703041a000000000076043500000001033000390000002002200039000000000012004b0000038d0000413d000008640000013d000000440030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b000005c50020009c00000bdd0000213d0000002401100370000000000101043b000b00000001001d000000000102001915e612b40000040f0000000b001001800000000001000039000000010100c039000006090000013d000000240030008c00000bdd0000413d0000000401100370000000000101043b000b00000001001d000005c50010009c00000bdd0000213d000005c801000041000000000101041a0000000002000411000000000012004b000007280000c13d000005c6010000410000000c0010043f0000000b01000029000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000900000001001d000000000101041a000a00000001001d000005cc01000041000000000010044300000000010004140000057b0010009c0000057b01008041000000c001100210000005cd011001c70000800b0200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b0000000a0010006c000007a30000a13d000005ce01000041000000000010043f000005ca01000041000015e800010430000005c6010000410000000c0010043f0000000001000411000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000001041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d0200003900000002030000390000060504000041000000000500041115e615d70000040f000000010020019000000bdd0000613d0000000001000019000015e70001042e0000000001000416000000000001004b00000bdd0000c13d00001b5801000039000000800010043f000005c701000041000015e70001042e000000440030008c00000bdd0000413d0000000402100370000000000202043b000b00000002001d000005c50020009c00000bdd0000213d0000002401100370000000000101043b000a00000001001d15e614d40000040f0000000b010000290000000a0200002915e6157b0000040f0000000001000019000015e70001042e0000000001000416000000000001004b00000bdd0000c13d15e611450000040f0000002002000039000000400300043d000b00000003001d000000000223043615e610700000040f000006b90000013d000000440030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000002402100370000000000202043b000b00000002001d0000000401100370000000000101043b000000000010043f000005e701000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000201041a000006040020009c000004300000213d000005e701000041000000000201041a00000604012001980000000003000019000000010300c08a000000000313c0d90000000b0030006b0000000003000019000000000301201900000000040000310000000005430019000000000045004b00000bdd0000213d00000647053001980000001f0630018f00000002074003670000000003540019000004450000613d000000000807034f000000008908043c0000000004940436000000000034004b000004410000c13d0000006002200270000000000006004b000004530000613d000000000457034f0000000305600210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000b011000b9000027100110011a000000400300043d0000002004300039000000000014043500000000002304350000057b0030009c0000057b03008041000000400130021000000637011001c7000015e70001042e0000000001000416000000000001004b00000bdd0000c13d15e614bc0000040f000005e701000041000000000001041b0000000001000019000015e70001042e000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b0000057e0020009c00000bdd0000213d0000002304200039000000000034004b00000bdd0000813d0000000404200039000000000141034f000000000101043b000b00000001001d0000057e0010009c00000bdd0000213d0000002402200039000a00000002001d0000000b01200029000000000031004b00000bdd0000213d000005d0010000410000000c0010043f0000000001000411000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a0000000100100190000007280000613d000000000100041a000000010210019000000001061002700000007f0660618f0000001f0060008c00000000030000390000000103002039000000000331013f0000000100300190000006890000c13d000000400500043d0000000003650436000000000002004b0000088c0000613d000000000000043f000000000006004b0000000001000019000008910000613d000005e00200004100000000010000190000000004130019000000000702041a000000000074043500000001022000390000002001100039000000000061004b000004a20000413d000008910000013d0000000001000416000000000001004b00000bdd0000c13d0000022601000039000000800010043f000005c701000041000015e70001042e000000440030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b000b00000002001d000005c50020009c00000bdd0000213d0000002401100370000000000101043b000a00000001001d000006040010009c00000bdd0000213d000005d0010000410000000c0010043f0000000001000411000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a0000000100100190000007280000613d0000000a01000029000027110010008c000007a90000413d0000063f01000041000000000010043f000005ca01000041000015e800010430000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000101043b000b00000001001d000005c50010009c00000bdd0000213d000005d0010000410000000c0010043f0000000001000411000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a0000000100100190000007280000613d0000000b06000029000000000006004b000007300000c13d0000063101000041000000000010043f000005da01000041000015e800010430000000440030008c00000bdd0000413d0000000402100370000000000202043b000b00000002001d000005c50020009c00000bdd0000213d0000002401100370000000000101043b000a00000001001d15e614d40000040f0000000b010000290000000a0200002915e6159f0000040f0000000001000019000015e70001042e000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000101043b000b00000001001d15e614bc0000040f0000000b01000029000000000010043f000005e701000041000000200010043f0000004002000039000000000100001915e615c20000040f000000000001041b0000000001000019000015e70001042e000000440030008c00000bdd0000413d0000000402100370000000000202043b000a00000002001d000005c50020009c00000bdd0000213d0000002401100370000000000101043b000000000001004b0000068f0000613d000900000001001d000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000005df001001980000068f0000c13d000000000001004b000005540000c13d000005d101000041000000000101041a0000000902000029000000000021004b0000068f0000a13d000b00000002001d0000000b01000029000000010110008a000b00000001001d000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000000000001004b000005410000613d000b05c50010019b00000000020004110000000b0020006c0000083c0000c13d0000000901000029000000000010043f0000061801000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d0000000a02000029000005c506200197000000000101043b000000000201041a0000060202200197000000000262019f000000000021041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d0200003900000004030000390000063b040000410000000b05000029000000090700002915e615d70000040f000000010020019000000bdd0000613d000003f10000013d000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b0000057e0020009c00000bdd0000213d0000002304200039000000000034004b00000bdd0000813d0000000404200039000000000141034f000000000101043b000700000001001d0000057e0010009c00000bdd0000213d000600240020003d000000070100002900000005011002100000000601100029000000000031004b00000bdd0000213d000005d0010000410000000c0010043f0000000001000411000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a0000000100100190000007280000613d000000070000006b000008790000c13d000005ff01000041000000000010043f000005da01000041000015e800010430000000000103001915e610d70000040f15e611b00000040f0000000001000019000015e70001042e000000440030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b000b00000002001d000005c50020009c00000bdd0000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039000a00000002001d000000000012004b00000bdd0000c13d0000000001000411000005c501100197000000000010043f000005ea01000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b0000000b02000029000000000020043f000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000201041a00000649022001970000000a03000029000000000232019f000000000021041b000000400100043d00000000003104350000057b0010009c0000057b01008041000000400110021000000000020004140000057b0020009c0000057b02008041000000c002200210000000000112019f000005eb011001c70000800d020000390000000303000039000005ec0400004100000000050004110000000b06000029000003ee0000013d000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000201043b000006410020019800000bdd0000c13d0000064203200197000006430030009c000006c70000c13d0000000102000039000006d80000013d000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000101043b15e614de0000040f000005c501100197000000400200043d00000000001204350000057b0020009c0000057b020080410000004001200210000005cf011001c7000015e70001042e000000240030008c00000bdd0000413d0000000401100370000000000201043b000000000100041115e6157b0000040f0000000001000019000015e70001042e000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000402100370000000000202043b0000057e0020009c00000bdd0000213d0000002304200039000000000034004b00000bdd0000813d000a00040020003d0000000a01100360000000000101043b000b00000001001d0000057e0010009c00000bdd0000213d0000000b012000290000002401100039000000000031004b00000bdd0000213d0000000101000039000000000101041a000005dc001001980000073f0000c13d000005f901000041000000000010043f000005da01000041000015e800010430000000240030008c00000bdd0000413d0000000002000416000000000002004b00000bdd0000c13d0000000401100370000000000201043b000000000002004b000006970000613d000005d101000041000000000101041a000000000021004b000006970000a13d000b00000002001d000000000020043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000005df001001980000000b01000029000006970000c13d000000000010043f0000061801000041000000200010043f0000004002000039000000000100001915e615c20000040f000000000101041a000006080000013d000005c801000041000000000501041a0000000001000411000000000051004b000007280000c13d00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d0200003900000003030000390000060004000041000000000600001915e615d70000040f000000010020019000000bdd0000613d000005c801000041000000000001041b0000000001000019000015e70001042e0000000001000416000000000001004b00000bdd0000c13d0000000101000039000000000101041a000005c501100197000000800010043f000005c701000041000015e70001042e0000000001000416000000000001004b00000bdd0000c13d000005ed01000041000000000201041a000000010320019000000001012002700000007f0110618f0000001f0010008c00000000040000390000000104002039000000000442013f00000001004001900000069b0000613d000005fd01000041000000000010043f0000002201000039000000040010043f000005fe01000041000015e8000104300000063c01000041000000000010043f000005da01000041000015e800010430000005e401000041000000000010043f000005da01000041000015e8000104300000063d01000041000000000010043f000005da01000041000015e800010430000000800010043f000000000003004b000006ad0000613d000005ed02000041000000000020043f000000000001004b0000000002000019000006b20000613d000005ee030000410000000002000019000000000403041a000000a005200039000000000045043500000001033000390000002002200039000000000012004b000006a50000413d000006b20000013d0000064902200197000000a00020043f000000000001004b000000200200003900000000020060390000002002200039000000800100003915e610e90000040f000000400100043d000b00000001001d000000800200003915e610a20000040f0000000b0200002900000000012100490000057b0010009c0000057b0100804100000060011002100000057b0020009c0000057b020080410000004002200210000000000121019f000015e70001042e15e6117e0000040f000000000101041a0000057e01100197000006090000013d000000e004200270000005b30040009c00000000020000390000000102006039000005c20040009c00000001022061bf000006d80000613d000005b30040009c000006d80000613d000006440030009c000005fe0000613d000006450030009c000005fe0000613d000006460030009c0000000102000039000006d80000613d0000000002000019000000010120018f000000800010043f000005c701000041000015e70001042e0000008006600039000000400060043f000000800020043f00000000042400190000002404400039000000000034004b00000bdd0000213d000a00000007001d0000002003500039000000000331034f00000647042001980000001f0520018f000000a001400039000006f00000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b000006ec0000c13d000000000005004b000006fd0000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a00120003900000000000104350000060601000041000000000010044300000000010004120000000400100443000000240000044300000000010004140000057b0010009c0000057b01008041000000c00110021000000607011001c7000080050200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000005c5011001970000000002000410000000000012004b0000072c0000613d0000060802000041000000000202041a000005c502200197000000000012004b0000072c0000c13d000005d0010000410000000c0010043f0000000001000411000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000000010010019000000b540000c13d0000064001000041000000000010043f000005ca01000041000015e8000104300000061701000041000000000010043f000005da01000041000015e8000104300000000101000039000000000201041a0000060203200197000000000363019f000000000031041b0000000001000414000005c5052001970000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d0200003900000003030000390000060304000041000003ee0000013d000005d101000041000000000101041a000000000001004b000007af0000c13d000005fd01000041000000000010043f0000001101000039000000040010043f000005fe01000041000015e8000104300000000a01000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d0000000902000029000005d4022000d1000000000101043b000000000301041a0000000002230019000000000021041b000005cc01000041000000000010044300000000010004140000057b0010009c0000057b01008041000000c001100210000005cd011001c70000800b0200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000800000001001d0000000b01000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d0000000802000029000000a0022002100000000903000029000000010030008c0000000003000019000005d603006041000000000223019f0000000a06000029000000000262019f000000000101043b000000000021041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d80400004100000000050000190000000b0700002915e615d70000040f000000010020019000000bdd0000613d0000000b02000029000900090020002d0000000b070000290000000107700039000000090070006c00000b4e0000613d00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d80400004100000000050000190000000a06000029000b00000007001d15e615d70000040f0000000100200190000007900000c13d00000bdd0000013d0000000901000029000000000001041b0000000b0100002915e615650000040f0000000001000019000015e70001042e0000000b0000006b000008850000c13d0000063e01000041000000000010043f000005ca01000041000015e80001043000001b580010008c000008810000213d0000000001000411000005c501100197000900000001001d000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000005ef01100197000005f00010009c000009a10000c13d000005fb01000041000000000010043f000005da01000041000015e800010430000000000003004b000007cd0000613d0000000801000029000000000001041b0000000901000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000201041a0000061a0220009a000000000021041b000005cc01000041000000000010044300000000010004140000057b0010009c0000057b01008041000000c001100210000005cd011001c70000800b0200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000800000001001d0000000a01000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d0000000802000029000000a00220021000000009022001af0000061b022001c7000000000101043b000000000021041b0000000b01000029000005d600100198000008280000c13d0000000a010000290000000101100039000800000001001d000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000000000001004b000008280000c13d000005d101000041000000000101041a000000080010006b000008280000613d0000000801000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b0000000b02000029000000000021041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d804000041000000090500002900000000060000190000000a0700002915e615d70000040f000000010020019000000bdd0000613d0000061c01000041000000000201041a0000000102200039000000000021041b0000000001000019000015e70001042e0000000b01000029000000000010043f000005ea01000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b0000000002000411000005c502200197000000000020043f000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000000ff00100190000005580000c13d0000063a01000041000000000010043f000005da01000041000015e80001043000000649022001970000000000240435000000000001004b000000200200003900000000020060390000003f0220003900000647032001970000000002530019000000000032004b000000000300003900000001030040390000057e0020009c000001650000213d0000000100300190000001650000c13d000000400020043f0000000003050433000000000003004b000008b90000c13d000005e30020009c000001650000213d0000002001200039000000400010043f0000000000020435000000400300043d00000a6a0000013d000005d101000041000000000101041a000000010110008a000000070010002a000007430000413d000000070110002900001b580010008c000008e40000a13d000005fc01000041000000000010043f000005da01000041000015e8000104300000000b0100002900000060011002100000000a011001af000005e702000041000000000012041b0000000001000019000015e70001042e00000649011001970000000000130435000000000006004b000000200100003900000000010060390000003f01100039000000200200008a000000000421016f0000000001540019000000000041004b000000000400003900000001040040390000057e0010009c000001650000213d0000000100400190000001650000c13d000000400010043f000000200060008c0000000b040000290000001f04400039000008b00000413d00000005074002700000061d0770009a0000000b08000029000000200080008c000005e007004041000000000000043f0000001f0660003900000005066002700000061d0660009a000000000067004b000008b00000813d000000000007041b0000000107700039000000000067004b000008ac0000413d0000000b060000290000001f0060008c00000a080000a13d0000000b07200180000000000000043f000005e00600004100000a6f0000c13d000000000800001900000a7a0000013d000000a003200039000000400030043f000000800320003900000000000304350000000b090000290000000006030019000000090090008c0000000a3990011a000000f807300210000000010360008a0000000008030433000005e108800197000000000778019f000005e2077001c70000000000730435000008be0000213d00000000026200490000008102200039000000210660008a0000000000260435000000000505043300000647095001970000001f0850018f000000400200043d0000002007200039000000000074004b00000a160000813d000000000009004b000008e00000613d000000000b840019000000000a870019000000200aa0008a000000200bb0008a000000000c9a0019000000000d9b0019000000000d0d04330000000000dc0435000000200990008c000008da0000c13d000000000008004b00000a2c0000613d000000000a07001900000a220000013d000900000000001d0000000901000029000000050110021000000006011000290000000101100367000000000201043b000005c50020009c00000bdd0000213d000000000020043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000b00000002001d000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000005ef01100197000005f00010009c000007c50000613d0000000b01000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000a00000001001d0000000b01000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b0000000a02000029000005f102200197000005f0022001c7000000000021041b000005d101000041000000000101041a000a00000001001d0000000b01000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000201041a000005fa0220009a000000000021041b000005cc01000041000000000010044300000000010004140000057b0010009c0000057b01008041000000c001100210000005cd011001c70000800b0200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000800000001001d0000000a01000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f00000001002001900000000b0600002900000bdd0000613d0000000802000029000000a002200210000000000226019f000005d6022001c7000000000101043b000000000021041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d80400004100000000050000190000000b060000290000000a0700002915e615d70000040f0000000b01000029000000010020019000000bdd0000613d000000000001004b00000b500000613d0000000a010000290000000101100039000005d102000041000000000012041b00000009020000290000000102200039000900000002001d000000070020006c000008e50000413d000003f10000013d0000060c0100004100000000001004430000000001000410000000040010044300000000010004140000057b0010009c0000057b01008041000000c0011002100000060d011001c7000080020200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000000000001004b00000b640000c13d0000057c01000041000000000101041a000400000001001d0000057e01100197000000010010008c0000000001000019000009980000c13d0000060c0100004100000000001004430000000001000410000000040010044300000000010004140000057b0010009c0000057b01008041000000c0011002100000060d011001c7000080020200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000000000001004b000000000100003900000001010060390000000402000029000006250020019800000af20000613d000000000001004b00000af20000c13d0000063601000041000000000010043f000005da01000041000015e8000104300000000901000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000101041a000800000001001d0000000901000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b0000000802000029000005f102200197000005f0022001c7000000000021041b0000001402000039000000400100043d0000000002210436000000000300041100000060033002100000000000320435000005f20010009c000001650000213d0000004003100039000000400030043f0000057b0020009c0000057b02008041000000400220021000000000010104330000057b0010009c0000057b010080410000006001100210000000000121019f00000000020004140000057b0020009c0000057b02008041000000c002200210000000000112019f000005d7011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000200010043f000005f301000041000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005f4011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d0000000102000039000000000202041a000900000002001d000000000101043b000000400200043d000800000002001d000000000010043f0000000b01000029000000400010008c00000c000000613d0000000b01000029000000410010008c000000000200001900000c0e0000c13d0000000a0300002900000060013000390000000101100367000000000101043b000000f801100270000000200010043f000000200130003900000001011003670000004002000039000000001301043c0000000002320436000000800020008c00000a030000c13d00000c0d0000013d0000000b0000006b000000000600001900000a0e0000613d0000000a060000290000000106600367000000000606043b0000000b090000290000000307900210000006480770027f0000064807700167000000000676016f0000000107900210000000000676019f00000a890000013d000000000a970019000000000009004b00000a1f0000613d000000000b040019000000000c07001900000000bd0b0434000000000cdc04360000000000ac004b00000a1b0000c13d000000000008004b00000a2c0000613d0000000004940019000000030880021000000000090a043300000000098901cf000000000989022f00000000040404330000010008800089000000000484022f00000000048401cf000000000494019f00000000004a043500000000047500190000000000040435000000000506043300000647075001970000001f0650018f000000000043004b00000a430000813d000000000007004b00000a3f0000613d00000000096300190000000008640019000000200880008a000000200990008a000000000a780019000000000b790019000000000b0b04330000000000ba0435000000200770008c00000a390000c13d000000000006004b00000a590000613d000000000804001900000a4f0000013d0000000008740019000000000007004b00000a4c0000613d0000000009030019000000000a040019000000009b090434000000000aba043600000000008a004b00000a480000c13d000000000006004b00000a590000613d00000000037300190000000306600210000000000708043300000000076701cf000000000767022f00000000030304330000010006600089000000000363022f00000000036301cf000000000373019f0000000000380435000000000345001900000000000304350000000003230049000000200430008a00000000004204350000001f0330003900000647013001970000000004210019000000000014004b000000000100003900000001010040390000057e0040009c000001650000213d0000000100100190000001650000c13d0000000003040019000000400040043f0000000001030019000b00000003001d000006b80000013d000000800100003900000b650000013d000000010900036700000000080000190000000a0b000029000000000ab80019000000000aa9034f000000000a0a043b0000000000a6041b00000001066000390000002008800039000000000078004b00000a720000413d0000000b0070006c00000a860000813d0000000b070000290000000307700210000000f80770018f000006480770027f00000648077001670000000a088000290000000108800367000000000808043b000000000778016f000000000076041b0000000b06000029000000010660021000000001066001bf000000000060041b00000040060000390000000006610436000000400710003900000000050504330000000000570435000000000925016f0000001f0850018f0000006007100039000000000073004b00000aa40000813d000000000009004b00000aa00000613d000000000b830019000000000a870019000000200aa0008a000000200bb0008a000000000c9a0019000000000d9b0019000000000d0d04330000000000dc0435000000200990008c00000a9a0000c13d000000000008004b00000aba0000613d000000000a07001900000ab00000013d000000000a970019000000000009004b00000aad0000613d000000000b030019000000000c07001900000000bd0b0434000000000cdc04360000000000ac004b00000aa90000c13d000000000008004b00000aba0000613d0000000003930019000000030880021000000000090a043300000000098901cf000000000989022f00000000030304330000010008800089000000000383022f00000000038301cf000000000393019f00000000003a0435000000000375001900000000000304350000001f03500039000000000323016f0000000003730019000000000513004900000000005604350000000b05000029000000000353043600000000062501700000001f0750018f00000000056300190000000a08000029000000010880036700000acf0000613d000000000908034f000000000a030019000000009b09043c000000000aba043600000000005a004b00000acb0000c13d000000000007004b00000adc0000613d000000000668034f0000000307700210000000000805043300000000087801cf000000000878022f000000000606043b0000010007700089000000000676022f00000000067601cf000000000686019f0000000000650435000000000224016f0000000b043000290000000000040435000000000212004900000000023200190000057b0020009c0000057b0200804100000060022002100000057b0010009c0000057b010080410000004001100210000000000112019f00000000020004140000057b0020009c0000057b02008041000000c002200210000000000112019f000005d7011001c70000800d0200003900000001030000390000061e04000041000002a10000013d00000004010000290000057d031001970000057c01000041000000000201041a000006260220019700000001022001bf000000000021041b0000000a0000006b0000000004000039000000010400c0390000000b0000006b0000000005000039000000010500c039000000000445016f000000090000006b0000000005000039000000010500c039000000000454016f000000000003004b000000010340018f00000b780000c13d0000062f0220019700000630022001c7000000000021041b000000000003004b000004f60000613d000000400100043d000006320010009c000001650000813d0000004002100039000000400020043f0000001402000039000000000321043600000627020000410000000000230435000000400200043d000400000002001d000005f20020009c000001650000213d00000004040000290000004002400039000000400020043f000000050200003900000000042404360000062802000041000300000004001d00000000002404350000061f02000041000000000202041a0000ff000020019000000b930000613d00000000020104330000057e0020009c000001650000213d0000062904000041000000000504041a000000010050019000000001045002700000007f0440618f0000001f0040008c00000000060000390000000106002039000000000565013f0000000100500190000006890000c13d000000200040008c00000b450000413d0000062905000041000000000050043f0000001f0520003900000005055002700000062a0550009a000000200020008c0000062b050040410000001f0440003900000005044002700000062a0440009a000000000045004b00000b450000813d000000000005041b0000000105500039000000000045004b00000b410000413d0000001f0020008c00000cac0000a13d0000062903000041000000000030043f000006470520019800000ce90000c13d00000020040000390000062b0300004100000cf50000013d0000000a0000006b00000b9d0000c13d0000063401000041000000000010043f000005da01000041000015e800010430000000400200043d0000060a01000041000900000002001d000000000012043500000000010004140000000b02000029000000040020008c00000ba20000c13d00000000010004150000000d0110008a00000005011002100000000003000031000000200030008c0000002004000039000000000403401900000bd00000013d000000400100043d000000640210003900000620030000410000000000320435000000440210003900000621030000410000000000320435000000240210003900000037030000390000000000320435000006220200004100000000002104350000000402100039000000200300003900000000003204350000057b0010009c0000057b01008041000000400110021000000623011001c7000015e800010430000000000003004b000004f60000613d000000400100043d000005f20010009c000001650000213d0000004002100039000000400020043f0000001402000039000000000321043600000627020000410000000000230435000000400200043d000400000002001d000005f20020009c000001650000213d00000004040000290000004002400039000000400020043f000000050200003900000000042404360000062802000041000300000004001d00000000002404350000061f02000041000000000202041a0000ff000020019000000c440000c13d000000400100043d0000006402100039000006350300004100000000003204350000004402100039000006210300004100000000003204350000002402100039000000340300003900000b6d0000013d000005d1010000410000000902000029000000000021041b0000000001000019000015e70001042e00000009020000290000057b0020009c0000057b0200804100000040022002100000057b0010009c0000057b01008041000000c001100210000000000121019f000005da011001c70000000b0200002915e615dc0000040f00000060031002700000057b03300197000000200030008c000000200400003900000000040340190000001f0640018f0000002007400190000000090570002900000bbc0000613d000000000801034f0000000909000029000000008a08043c0000000009a90436000000000059004b00000bb80000c13d000000000006004b00000bc90000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000000003001f000200000001035500000000010004150000000c0110008a0000000501100210000000010020019000000bf50000613d0000001f02400039000000600420018f0000000902400029000000000042004b000000000400003900000001040040390000057e0020009c000001650000213d0000000100400190000001650000c13d000000400020043f000000200030008c00000bdf0000813d0000000001000019000015e800010430000000090200002900000000020204330000000501100270000000000102001f000006080020009c00000bfb0000c13d0000060c0100004100000000001004430000000b01000029000000040010044300000000010004140000057b0010009c0000057b01008041000000c0011002100000060d011001c7000080020200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000000000001004b00000c710000c13d0000061601000041000000000010043f0000000b01000029000000040010043f000005fe01000041000015e8000104300000060b01000041000000000010043f000000040020043f000005fe01000041000015e8000104300000000a0400002900000040014000390000000101100367000000000101043b000000ff031002700000001b03300039000000200030043f00000020034000390000000102300367000000000202043b000000400020043f000005f501100197000000600010043f000000010200003900000000010004140000057b0010009c0000057b01008041000000c001100210000005f6011001c715e615dc0000040f00000060031002700000057b03300197000000200030008c000000200400003900000000040340190000001f0540018f000000200640019000000001046001bf00000c230000613d0000000107000039000000000801034f000000008908043c0000000007970436000000000047004b00000c1f0000c13d000000000005004b00000c300000613d000000000661034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f00000000005404350002000000010355000000000003001f000000000003004b00000c380000c13d000005f801000041000000000010043f000005ca01000041000015e800010430000000010120018f0000000001010433000000600000043f0000000802000029000000400020043f000000090110014f000005c50010019800000c6d0000c13d000000000100041115e615130000040f0000000001000019000015e70001042e00000000020104330000057e0020009c000001650000213d0000062904000041000000000504041a000000010050019000000001045002700000007f0440618f0000001f0040008c00000000060000390000000106002039000000000565013f0000000100500190000006890000c13d000000200040008c00000c640000413d0000062905000041000000000050043f0000001f0520003900000005055002700000062a0550009a000000200020008c0000062b050040410000001f0440003900000005044002700000062a0440009a000000000045004b00000c640000813d000000000005041b0000000105500039000000000045004b00000c600000413d0000001f0020008c00000cb70000a13d0000062903000041000000000030043f000006470520019800000d470000c13d00000020040000390000062b0300004100000d530000013d000005f701000041000000000010043f000005da01000041000015e8000104300000060801000041000000000201041a00000602022001970000000b05000029000000000252019f000000000021041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d0200003900000002030000390000060e0400004115e615d70000040f000000010020019000000bdd0000613d000000800100043d000000000001004b00000c8c0000c13d0000000001000416000000000001004b000003f10000613d0000061501000041000000000010043f000005da01000041000015e80001043000000000020004140000000b03000029000000040030008c00000cc20000c13d000000000200003200000da50000c13d00000060010000390000000001010433000000000001004b000003f10000c13d0000060c0100004100000000001004430000000401000039000000040010044300000000010004140000057b0010009c0000057b01008041000000c0011002100000060d011001c7000080020200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000000000001004b000003f10000c13d0000061401000041000000000010043f0000000401000039000000040010043f000005fe01000041000015e800010430000000000002004b000000000100001900000d010000613d0000000301200210000006480110027f00000648011001670000000003030433000000000113016f0000000102200210000000000121019f00000d010000013d000000000002004b000000000100001900000d5f0000613d0000000301200210000006480110027f00000648011001670000000003030433000000000113016f0000000102200210000000000121019f00000d5f0000013d0000057b0020009c0000057b02008041000000c0022002100000057b0010009c0000057b010080410000006001100210000000000121019f0000060f011001c70000000b0200002915e615e10000040f000200000001035500000060031002700000057b0030019d0000057b0430019800000dce0000c13d00000060030000390000000001030433000000010020019000000df60000613d000000000001004b000003f10000c13d0000060c0100004100000000001004430000000b01000029000000040010044300000000010004140000057b0010009c0000057b01008041000000c0011002100000060d011001c7000080020200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000000000001004b000003f10000c13d000006140100004100000bf60000013d0000062b030000410000002004000039000000010650008a00000005066002700000062c0660009a00000000071400190000000007070433000000000073041b00000020044000390000000103300039000000000063004b00000cee0000c13d000000000025004b00000cff0000813d0000000305200210000000f80550018f000006480550027f000006480550016700000000011400190000000001010433000000000151016f000000000013041b000000010120021000000001011001bf0000062902000041000000000012041b00000004010000290000000001010433000200000001001d0000057e0010009c000001650000213d000005ed01000041000000000101041a000000010010019000000001021002700000007f0220618f000100000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006890000c13d0000000101000029000000200010008c00000d330000413d000005ed01000041000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005eb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d00000002030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000001010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b00000d330000813d000000000002041b0000000102200039000000000012004b00000d2f0000413d0000000201000029000000200010008c00000dfc0000413d000005ed01000041000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005eb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000200200008a0000000202200180000000000101043b00000e1f0000c13d000000200300003900000e2c0000013d0000062b030000410000002004000039000000010650008a00000005066002700000062c0660009a00000000071400190000000007070433000000000073041b00000020044000390000000103300039000000000063004b00000d4c0000c13d000000000025004b00000d5d0000813d0000000305200210000000f80550018f000006480550027f000006480550016700000000011400190000000001010433000000000151016f000000000013041b000000010120021000000001011001bf0000062902000041000000000012041b00000004010000290000000001010433000200000001001d0000057e0010009c000001650000213d000005ed01000041000000000101041a000000010010019000000001021002700000007f0220618f000100000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006890000c13d0000000101000029000000200010008c00000d910000413d000005ed01000041000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005eb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d00000002030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b00000001010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b00000d910000813d000000000002041b0000000102200039000000000012004b00000d8d0000413d0000000201000029000000200010008c00000e090000413d000005ed01000041000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005eb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000200200008a0000000202200180000000000101043b00000ead0000c13d000000200300003900000eba0000013d0000057e0020009c000001650000213d0000001f0120003900000647011001970000003f011000390000064703100197000000400100043d0000000003310019000000000013004b000000000400003900000001040040390000057e0030009c000001650000213d0000000100400190000001650000c13d000000400030043f000000000621043600000647032001980000001f0420018f0000000002360019000000020500036700000dc00000613d000000000705034f000000007807043c0000000006860436000000000026004b00000dbc0000c13d000000000004004b00000c930000613d000000000335034f0000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f000000000032043500000c930000013d0000001f0340003900000610033001970000003f033000390000061105300197000000400300043d0000000005530019000000000035004b000000000600003900000001060040390000057e0050009c000001650000213d0000000100600190000001650000c13d000000400050043f0000001f0540018f00000000074304360000061206400198000a00000007001d000000000467001900000de80000613d000000000701034f0000000a08000029000000007907043c0000000008980436000000000048004b00000de40000c13d000000000005004b00000cd20000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f000000000014043500000cd20000013d000000000001004b00000e160000c13d0000061301000041000000000010043f000005da01000041000015e800010430000000020000006b000000000100001900000e3a0000613d00000002030000290000000301300210000006480110027f000006480110016700000003020000290000000002020433000000000112016f0000000102300210000000000121019f00000e3a0000013d000000020000006b000000000100001900000ec80000613d00000002030000290000000301300210000006480110027f000006480110016700000003020000290000000002020433000000000112016f0000000102300210000000000121019f00000ec80000013d0000000a020000290000057b0020009c0000057b0200804100000040022002100000057b0010009c0000057b010080410000006001100210000000000121019f000015e800010430000000010320008a0000000503300270000000000431001900000020030000390000000104400039000000040600002900000000056300190000000005050433000000000051041b00000020033000390000000101100039000000000041004b00000e250000c13d000000020020006c00000e370000813d00000002020000290000000302200210000000f80220018f000006480220027f000006480220016700000004033000290000000003030433000000000223016f000000000021041b0000000201000029000000010110021000000001011001bf000005ed02000041000000000012041b0000000102000039000005d101000041000000000021041b000005c8010000410000000b06000029000000000061041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d0200003900000003030000390000060004000041000000000500001915e615d70000040f000000010020019000000bdd0000613d000005d0010000410000000c0010043f0000000a01000029000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000201041a00000001062001bf000000000061041b0000000c0100043d000000000200041400000060051002700000057b0020009c0000057b02008041000000c001200210000005d7011001c70000800d0200003900000003030000390000062d0400004115e615d70000040f000000010020019000000bdd0000613d0000000103000039000000000103041a000006020110019700000009011001af000000000013041b000000000100041a000000010010019000000001021002700000007f0220618f000b00000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006890000c13d0000000b01000029000000200010008c00000e9a0000413d000000000000043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005eb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d00000007030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b0000000b010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b00000e9a0000813d000000000002041b0000000102200039000000000012004b00000e960000413d0000000701000029000000200010008c00000f3b0000413d000000000000043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005eb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000200200008a0000000702200180000000000101043b00000f570000c13d000000000300001900000f610000013d000000010320008a0000000503300270000000000431001900000020030000390000000104400039000000040600002900000000056300190000000005050433000000000051041b00000020033000390000000101100039000000000041004b00000eb30000c13d000000020020006c00000ec50000813d00000002020000290000000302200210000000f80220018f000006480220027f000006480220016700000004033000290000000003030433000000000223016f000000000021041b0000000201000029000000010110021000000001011001bf000005ed02000041000000000012041b0000000102000039000005d101000041000000000021041b000005c8010000410000000b06000029000000000061041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d0200003900000003030000390000060004000041000000000500001915e615d70000040f000000010020019000000bdd0000613d000005d0010000410000000c0010043f0000000a01000029000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000201041a00000001062001bf000000000061041b0000000c0100043d000000000200041400000060051002700000057b0020009c0000057b02008041000000c001200210000005d7011001c70000800d0200003900000003030000390000062d0400004115e615d70000040f000000010020019000000bdd0000613d0000000103000039000000000103041a000006020110019700000009011001af000000000013041b000000000100041a000000010010019000000001021002700000007f0220618f000b00000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000006890000c13d0000000b01000029000000200010008c00000f280000413d000000000000043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005eb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d00000007030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b0000000b010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b00000f280000813d000000000002041b0000000102200039000000000012004b00000f240000413d0000000701000029000000200010008c00000f490000413d000000000000043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005eb011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000200200008a0000000702200180000000000101043b00000fea0000c13d000000000300001900000ff40000013d000000070000006b000000000100001900000f700000613d00000007030000290000000301300210000006480110027f000006480110016700000006020000290000000102200367000000000202043b000000000112016f0000000102300210000000000121019f00000f700000013d000000070000006b0000000001000019000010030000613d00000007030000290000000301300210000006480110027f000006480110016700000006020000290000000102200367000000000202043b000000000112016f0000000102300210000000000121019f000010030000013d000000010400036700000000030000190000000605300029000000000554034f000000000505043b000000000051041b00000001011000390000002003300039000000000023004b00000f590000413d000000070020006c00000f6d0000813d00000007020000290000000302200210000000f80220018f000006480220027f000006480220016700000006033000290000000103300367000000000303043b000000000223016f000000000021041b0000000701000029000000010110021000000001011001bf000000000010041b0000000801000029000a05c50010019b000005d101000041000000000101041a000b00000001001d000800000000001d0000000a01000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000201041a0000062e0220009a000000000021041b000005cc01000041000000000010044300000000010004140000057b0010009c0000057b01008041000000c001100210000005cd011001c70000800b0200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000900000001001d0000000b01000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d0000000902000029000000a0022002100000000a06000029000000000262019f000000000101043b000000000021041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d80400004100000000050000190000000b0700002915e615d70000040f000000010020019000000bdd0000613d0000000b01000029000900320010003d0000000b070000290000000107700039000000090070006c00000fca0000613d00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d80400004100000000050000190000000a06000029000b00000007001d15e615d70000040f000000010020019000000fb70000c13d00000bdd0000013d0000000a0000006b00000b500000613d000005d1010000410000000902000029000000000021041b00000008010000290000000a0010008c000800010010003d000b00000002001d00000f770000413d0000057c01000041000000000201041a0000063302200197000000000021041b000000400100043d000000010300003900000000003104350000057b0010009c0000057b01008041000000400110021000000000020004140000057b0020009c0000057b02008041000000c002200210000000000112019f000005eb011001c70000800d02000039000005800400004115e615d70000040f000000010020019000000bdd0000613d000010670000013d000000010400036700000000030000190000000605300029000000000554034f000000000505043b000000000051041b00000001011000390000002003300039000000000023004b00000fec0000413d000000070020006c000010000000813d00000007020000290000000302200210000000f80220018f000006480220027f000006480220016700000006033000290000000103300367000000000303043b000000000223016f000000000021041b0000000701000029000000010110021000000001011001bf000000000010041b0000000801000029000a05c50010019b000005d101000041000000000101041a000b00000001001d000800000000001d0000000a01000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d000000000101043b000000000201041a0000062e0220009a000000000021041b000005cc01000041000000000010044300000000010004140000057b0010009c0000057b01008041000000c001100210000005cd011001c70000800b0200003915e615dc0000040f00000001002001900000106f0000613d000000000101043b000900000001001d0000000b01000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f000000010020019000000bdd0000613d0000000902000029000000a0022002100000000a06000029000000000262019f000000000101043b000000000021041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d80400004100000000050000190000000b0700002915e615d70000040f000000010020019000000bdd0000613d0000000b01000029000900320010003d0000000b070000290000000107700039000000090070006c0000105d0000613d00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d80400004100000000050000190000000a06000029000b00000007001d15e615d70000040f00000001002001900000104a0000c13d00000bdd0000013d0000000a0000006b00000b500000613d000005d1010000410000000902000029000000000021041b00000008010000290000000a0010008c000800010010003d000b00000002001d0000100a0000413d000000050000006b000003f10000c13d0000061f01000041000000000201041a0000064a02200197000000000021041b0000000001000019000015e70001042e000000000001042f0000000043010434000000000132043600000647063001970000001f0530018f000000000014004b000010860000813d000000000006004b000010820000613d00000000085400190000000007510019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c0000107c0000c13d000000000005004b0000109c0000613d0000000007010019000010920000013d0000000007610019000000000006004b0000108f0000613d00000000080400190000000009010019000000008a0804340000000009a90436000000000079004b0000108b0000c13d000000000005004b0000109c0000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f0000000000470435000000000431001900000000000404350000001f0330003900000647023001970000000001210019000000000001042d000000200300003900000000033104360000000042020434000000000023043500000647062001970000001f0520018f0000004001100039000000000014004b000010bb0000813d000000000006004b000010b70000613d00000000085400190000000007510019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c000010b10000c13d000000000005004b000010d10000613d0000000007010019000010c70000013d0000000007610019000000000006004b000010c40000613d00000000080400190000000009010019000000008a0804340000000009a90436000000000079004b000010c00000c13d000000000005004b000010d10000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f0000000000470435000000000412001900000000000404350000001f0220003900000647022001970000000001120019000000000001042d000005f50010009c000010e70000213d000000630010008c000010e70000a13d00000001030003670000000401300370000000000101043b000005c50010009c000010e70000213d0000002402300370000000000202043b000005c50020009c000010e70000213d0000004403300370000000000303043b000000000001042d0000000001000019000015e8000104300000001f0220003900000647022001970000000001120019000000000021004b000000000200003900000001020040390000057e0010009c000010f50000213d0000000100200190000010f50000c13d000000400010043f000000000001042d000005fd01000041000000000010043f0000004101000039000000040010043f000005fe01000041000015e80001043000000000030100190000001f01100039000000000021004b00000000040000190000064b040040410000064b052001970000064b01100197000000000651013f000000000051004b00000000010000190000064b010020410000064b0060009c000000000104c019000000000001004b000011430000613d0000000106000367000000000136034f000000000401043b000006300040009c0000113d0000813d0000001f0140003900000647011001970000003f011000390000064705100197000000400100043d0000000005510019000000000015004b000000000800003900000001080040390000057e0050009c0000113d0000213d00000001008001900000113d0000c13d000000400050043f000000000541043600000020033000390000000008430019000000000028004b000011430000213d000000000336034f00000647064001980000001f0740018f00000000026500190000112d0000613d000000000803034f0000000009050019000000008a08043c0000000009a90436000000000029004b000011290000c13d000000000007004b0000113a0000613d000000000363034f0000000306700210000000000702043300000000076701cf000000000767022f000000000303043b0000010006600089000000000363022f00000000036301cf000000000373019f000000000032043500000000024500190000000000020435000000000001042d000005fd01000041000000000010043f0000004101000039000000040010043f000005fe01000041000015e8000104300000000001000019000015e800010430000000000400041a000000010540019000000001024002700000007f0220618f0000001f0020008c00000000010000390000000101002039000000000015004b000011720000c13d000000400100043d0000000003210436000000000005004b0000115f0000613d000000000000043f000000000002004b000011650000613d000005e00500004100000000040000190000000006430019000000000705041a000000000076043500000001055000390000002004400039000000000024004b000011570000413d000011660000013d00000649044001970000000000430435000000000002004b00000020040000390000000004006039000011660000013d00000000040000190000003f0240003900000647032001970000000002130019000000000032004b000000000300003900000001030040390000057e0020009c000011780000213d0000000100300190000011780000c13d000000400020043f000000000001042d000005fd01000041000000000010043f0000002201000039000000040010043f000005fe01000041000015e800010430000005fd01000041000000000010043f0000004101000039000000040010043f000005fe01000041000015e800010430000005c501100197000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f00000001002001900000118d0000613d000000000101043b000000000001042d0000000001000019000015e800010430000005c501100197000000000010043f000005ea01000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f00000001002001900000119e0000613d000000000101043b000000000001042d0000000001000019000015e800010430000005c502200197000000000020043f000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000011ae0000613d000000000101043b000000000001042d0000000001000019000015e8000104300007000000000002000300000002001d000500000001001d000600000003001d000000000003004b000012a30000613d0000000601000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000012a10000613d000000000101043b000000000101041a000005df00100198000012a30000c13d000000000001004b000011e10000c13d000005d101000041000000000101041a000000060010006c000012a30000a13d0000000602000029000000010220008a000700000002001d000000000020043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000012a10000613d000000000101043b000000000101041a000000000001004b0000000702000029000011ce0000613d0000000502000029000005c502200197000400000001001d000005c501100197000700000002001d000000000021004b000012a70000c13d0000000601000029000000000010043f0000061801000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000012a10000613d000000000201043b000000000302041a0000000001000411000005c504100197000000070040006c000012200000613d000000000034004b000012200000613d000500000004001d000100000003001d000200000002001d0000000701000029000000000010043f000005ea01000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000012a10000613d000000000101043b0000000502000029000000000020043f000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000012a10000613d000000000101043b000000000101041a000000ff0010019000000002020000290000000103000029000012b00000613d0000000301000029000505c50010019c000012ab0000613d000000000003004b000012260000613d000000000002041b0000000701000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000012a10000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000501000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000012a10000613d000000000101043b000000000201041a0000000102200039000000000021041b000005cc01000041000000000010044300000000010004140000057b0010009c0000057b01008041000000c001100210000005cd011001c70000800b0200003915e615dc0000040f0000000100200190000012af0000613d000000000101043b000300000001001d0000000601000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000012a10000613d0000000302000029000000a00220021000000005022001af000005d6022001c7000000000101043b000000000021041b0000000401000029000005d600100198000012920000c13d00000006010000290000000101100039000300000001001d000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000012a10000613d000000000101043b000000000101041a000000000001004b000012920000c13d000005d101000041000000000101041a000000030010006b000012920000613d0000000301000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000012a10000613d000000000101043b0000000402000029000000000021041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d80400004100000007050000290000000506000029000000060700002915e615d70000040f0000000100200190000012a10000613d000000000001042d0000000001000019000015e8000104300000063c01000041000000000010043f000005da01000041000015e8000104300000064c01000041000000000010043f000005da01000041000015e8000104300000064d01000041000000000010043f000005da01000041000015e800010430000000000001042f0000061901000041000000000010043f000005da01000041000015e800010430000005d0020000410000000c0020043f000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f0000000100200190000012c30000613d000000000101043b000000000101041a000000000001042d0000000001000019000015e800010430000a000000000002000100000004001d000500000002001d000600000001001d000700000003001d000000000003004b0000146a0000613d0000000701000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000014680000613d000000000101043b000000000101041a000005df001001980000146a0000c13d000000000001004b000012f70000c13d000005d101000041000000000101041a000000070010006c0000146a0000a13d0000000702000029000000010220008a000800000002001d000000000020043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000014680000613d000000000101043b000000000101041a000000000001004b0000000802000029000012e40000613d0000000602000029000005c502200197000300000001001d000005c501100197000800000002001d000000000021004b0000146f0000c13d0000000701000029000000000010043f0000061801000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000014680000613d000000000301043b000000000403041a0000000001000411000005c502100197000400000002001d000000080020006c000013360000613d000000040040006b000013360000613d000200000004001d000600000003001d0000000801000029000000000010043f000005ea01000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000014680000613d000000000101043b0000000402000029000000000020043f000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000014680000613d000000000101043b000000000101041a000000ff0010019000000006030000290000000204000029000014770000613d0000000501000029000005c501100198000014730000613d000600000001001d000000000004004b0000133d0000613d000000000003041b0000000801000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000014680000613d000000000101043b000000000201041a000000010220008a000000000021041b0000000601000029000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000014680000613d000000000101043b000000000201041a0000000102200039000000000021041b000005cc01000041000000000010044300000000010004140000057b0010009c0000057b01008041000000c001100210000005cd011001c70000800b0200003915e615dc0000040f00000001002001900000146e0000613d000000000101043b000200000001001d0000000701000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000014680000613d0000000202000029000000a0022002100000000606000029000000000262019f000005d6022001c7000000000101043b000000000021041b0000000301000029000005d600100198000013ac0000c13d00000007010000290000000101100039000200000001001d000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000014680000613d000000000101043b000000000101041a000000000001004b0000000606000029000013ac0000c13d000005d101000041000000000101041a000000020010006b000013ac0000613d0000000201000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f0000000100200190000014680000613d000000000101043b0000000302000029000000000021041b000000060600002900000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d8040000410000000805000029000000070700002915e615d70000040f0000000100200190000014680000613d0000060c0100004100000000001004430000000501000029000000040010044300000000010004140000057b0010009c0000057b01008041000000c0011002100000060d011001c7000080020200003915e615dc0000040f00000001002001900000146e0000613d000000000101043b000000000001004b000014670000613d000000000d000415000000400e00043d0000006401e00039000000800c0000390000000000c104350000004401e00039000000070200002900000000002104350000002401e00039000000080200002900000000002104350000064e0100004100000000001e04350000000401e00039000000040200002900000000002104350000008402e00039000000010100002900000000410104340000000000120435000000200b00008a0000000006b1016f0000001f0510018f000000a403e00039000000000034004b000013f30000813d000000000006004b000013ef0000613d00000000085400190000000007530019000000200770008a000000200880008a0000000009670019000000000a680019000000000a0a04330000000000a90435000000200660008c000013e90000c13d000000000005004b000014090000613d0000000007030019000013ff0000013d0000000007630019000000000006004b000013fc0000613d00000000080400190000000009030019000000008a0804340000000009a90436000000000079004b000013f80000c13d000000000005004b000014090000613d00000000046400190000000305500210000000000607043300000000065601cf000000000656022f00000000040404330000010005500089000000000454022f00000000045401cf000000000464019f00000000004704350000000003310019000000000003043500000000030004140000000602000029000000040020008c000014170000c13d00000000050004150000000a0550008a00000005055002100000000003000031000000200030008c000000200400003900000000040340190000144f0000013d00080000000d001d00050000000c001d0000001f011000390000000001b1016f000000a4011000390000057b0010009c0000057b0100804100000060011002100000057b00e0009c0000057b0400004100000000040e40190000004004400210000000000141019f0000057b0030009c0000057b03008041000000c003300210000000000131019f00070000000e001d15e615d70000040f000000070e00002900000060031002700000057b03300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057e00190000143a0000613d000000000801034f00000000090e0019000000008a08043c0000000009a90436000000000059004b000014360000c13d000000000006004b000014470000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000000003001f00020000000103550000000005000415000000090550008a00000005055002100000000100200190000000080d0000290000147b0000613d0000001f01400039000000600210018f0000000001e20019000000000021004b000000000200003900000001020040390000057e0010009c000014ad0000213d0000000100200190000014ad0000c13d000000400010043f000000200030008c000014680000413d00000000010e04330000064100100198000014680000c13d0000000502500270000000000201001f000000000200041500000000022d0049000000000200000200000642011001970000064e0010009c000014a90000c13d000000000001042d0000000001000019000015e8000104300000063c01000041000000000010043f000005da01000041000015e800010430000000000001042f0000064c01000041000000000010043f000005da01000041000015e8000104300000064d01000041000000000010043f000005da01000041000015e8000104300000061901000041000000000010043f000005da01000041000015e800010430000000000003004b0000147f0000c13d0000006002000039000014a60000013d0000001f0230003900000610022001970000003f022000390000061104200197000000400200043d0000000004420019000000000024004b000000000500003900000001050040390000057e0040009c000014ad0000213d0000000100500190000014ad0000c13d000000400040043f0000001f0430018f00000000063204360000061205300198000500000006001d0000000003560019000014990000613d000000000601034f0000000507000029000000006806043c0000000007870436000000000037004b000014950000c13d000000000004004b000014a60000613d000000000151034f0000000304400210000000000503043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f00000000001304350000000001020433000000000001004b000014b30000c13d0000064f01000041000000000010043f000005da01000041000015e800010430000005fd01000041000000000010043f0000004101000039000000040010043f000005fe01000041000015e80001043000000005020000290000057b0020009c0000057b0200804100000040022002100000057b0010009c0000057b010080410000006001100210000000000121019f000015e800010430000005d0010000410000000c0010043f0000000001000411000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f0000000100200190000014ce0000613d000000000101043b000000000101041a0000000100100190000014d00000613d000000000001042d0000000001000019000015e8000104300000064001000041000000000010043f000005ca01000041000015e800010430000005c801000041000000000101041a0000000002000411000000000012004b000014da0000c13d000000000001042d0000064001000041000000000010043f000005ca01000041000015e8000104300001000000000002000000000001004b0000150f0000613d000100000001001d000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f00000001002001900000150d0000613d000000000101043b000000000101041a000005df0010019800000001020000290000150f0000c13d000000000001004b0000150c0000c13d000005d101000041000000000101041a000000000021004b0000150f0000a13d000000010220008a000100000002001d000000000020043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f00000001002001900000150d0000613d000000000101043b000000000101041a000000000001004b0000000102000029000014f90000613d000000000001042d0000000001000019000015e8000104300000063c01000041000000000010043f000005da01000041000015e8000104300003000000000002000005d102000041000000000202041a000300000002001d000005c501100197000200000001001d000000000010043f000005d201000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f00000001002001900000155e0000613d000000000101043b000000000201041a000005fa0220009a000000000021041b000005cc01000041000000000010044300000000010004140000057b0010009c0000057b01008041000000c001100210000005cd011001c70000800b0200003915e615dc0000040f0000000100200190000015600000613d000000000101043b000100000001001d0000000301000029000000000010043f000005d501000041000000200010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005d3011001c7000080100200003915e615dc0000040f00000001002001900000155e0000613d0000000102000029000000a0022002100000000206000029000000000226019f000005d6022001c7000000000101043b000000000021041b00000000010004140000057b0010009c0000057b01008041000000c001100210000005d7011001c70000800d020000390000000403000039000005d8040000410000000005000019000000030700002915e615d70000040f00000001002001900000155e0000613d000000020000006b000015610000613d00000003010000290000000101100039000005d102000041000000000012041b000000000001042d0000000001000019000015e800010430000000000001042f0000063401000041000000000010043f000005da01000041000015e8000104300001000000000002000005c802000041000000000502041a0000000002000414000005c5061001970000057b0020009c0000057b02008041000000c001200210000005d7011001c70000800d0200003900000003030000390000060004000041000100000006001d15e615d70000040f0000000100200190000015790000613d000005c8010000410000000102000029000000000021041b000000000001042d0000000001000019000015e8000104300001000000000002000100000002001d000005d0020000410000000c0020043f000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f00000001002001900000159d0000613d000000010200008a000000010220014f000000000101043b000000000301041a000000000623016f000000000061041b0000000c0100043d000000000200041400000060051002700000057b0020009c0000057b02008041000000c001200210000005d7011001c70000800d0200003900000003030000390000062d0400004115e615d70000040f00000001002001900000159d0000613d000000000001042d0000000001000019000015e8000104300001000000000002000100000002001d000005d0020000410000000c0020043f000000000010043f00000000010004140000057b0010009c0000057b01008041000000c001100210000005cb011001c7000080100200003915e615dc0000040f0000000100200190000015bf0000613d000000000101043b000000000201041a00000001062001af000000000061041b0000000c0100043d000000000200041400000060051002700000057b0020009c0000057b02008041000000c001200210000005d7011001c70000800d0200003900000003030000390000062d0400004115e615d70000040f0000000100200190000015bf0000613d000000000001042d0000000001000019000015e800010430000000000001042f0000057b0010009c0000057b0100804100000040011002100000057b0020009c0000057b020080410000006002200210000000000112019f00000000020004140000057b0020009c0000057b02008041000000c002200210000000000112019f000005d7011001c7000080100200003915e615dc0000040f0000000100200190000015d50000613d000000000101043b000000000001042d0000000001000019000015e800010430000015da002104210000000102000039000000000001042d0000000002000019000000000001042d000015df002104230000000102000039000000000001042d0000000002000019000000000001042d000015e4002104250000000102000039000000000001042d0000000002000019000000000001042d000015e600000432000015e70001042e000015e80001043000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000fffffffff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a000000000000000000000000000000000000000000000000ff0000000000000000000000000000000000000000000000000000000000000000ffffffffffffffff0200000000000000000000000000000000000020000000a00000000000000000c7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d20000000200000000000000000000000000000080000001000000000000000000000000000000000000000000000000000000000000000000000000006352211d00000000000000000000000000000000000000000000000000000000aa1b103e00000000000000000000000000000000000000000000000000000000d547cfb600000000000000000000000000000000000000000000000000000000f04e283d00000000000000000000000000000000000000000000000000000000f47c84c400000000000000000000000000000000000000000000000000000000f47c84c500000000000000000000000000000000000000000000000000000000fee81cf400000000000000000000000000000000000000000000000000000000f04e283e00000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000d547cfb700000000000000000000000000000000000000000000000000000000e58306f900000000000000000000000000000000000000000000000000000000e985e9c500000000000000000000000000000000000000000000000000000000bf1ad7df00000000000000000000000000000000000000000000000000000000bf1ad7e000000000000000000000000000000000000000000000000000000000c87b56dd00000000000000000000000000000000000000000000000000000000d3dd5fe000000000000000000000000000000000000000000000000000000000aa1b103f00000000000000000000000000000000000000000000000000000000ad3cb1cc00000000000000000000000000000000000000000000000000000000b88d4fde000000000000000000000000000000000000000000000000000000007ba0e2e60000000000000000000000000000000000000000000000000000000095d89b400000000000000000000000000000000000000000000000000000000095d89b4100000000000000000000000000000000000000000000000000000000a22cb46500000000000000000000000000000000000000000000000000000000a5128317000000000000000000000000000000000000000000000000000000007ba0e2e7000000000000000000000000000000000000000000000000000000008a616bc0000000000000000000000000000000000000000000000000000000008da5cb5b00000000000000000000000000000000000000000000000000000000715018a500000000000000000000000000000000000000000000000000000000715018a600000000000000000000000000000000000000000000000000000000729ad39e0000000000000000000000000000000000000000000000000000000073b2e80e000000000000000000000000000000000000000000000000000000006352211e000000000000000000000000000000000000000000000000000000006c19e7830000000000000000000000000000000000000000000000000000000070a08231000000000000000000000000000000000000000000000000000000002a552059000000000000000000000000000000000000000000000000000000004a4ee7b000000000000000000000000000000000000000000000000000000000514e62fb0000000000000000000000000000000000000000000000000000000054d1f13c0000000000000000000000000000000000000000000000000000000054d1f13d000000000000000000000000000000000000000000000000000000005944c75300000000000000000000000000000000000000000000000000000000514e62fc0000000000000000000000000000000000000000000000000000000052d1902d000000000000000000000000000000000000000000000000000000004a4ee7b1000000000000000000000000000000000000000000000000000000004bf365df000000000000000000000000000000000000000000000000000000004f1ef2860000000000000000000000000000000000000000000000000000000030176e120000000000000000000000000000000000000000000000000000000030176e130000000000000000000000000000000000000000000000000000000042842e0e0000000000000000000000000000000000000000000000000000000042966c68000000000000000000000000000000000000000000000000000000002a55205a000000000000000000000000000000000000000000000000000000002de94807000000000000000000000000000000000000000000000000000000002fb3b36100000000000000000000000000000000000000000000000000000000183a4f6d00000000000000000000000000000000000000000000000000000000238ac93200000000000000000000000000000000000000000000000000000000238ac9330000000000000000000000000000000000000000000000000000000023b872dd000000000000000000000000000000000000000000000000000000002569296200000000000000000000000000000000000000000000000000000000183a4f6e000000000000000000000000000000000000000000000000000000001c10893f000000000000000000000000000000000000000000000000000000001cd64df400000000000000000000000000000000000000000000000000000000081812fb00000000000000000000000000000000000000000000000000000000081812fc00000000000000000000000000000000000000000000000000000000095ea7b30000000000000000000000000000000000000000000000000000000018160ddd0000000000000000000000000000000000000000000000000000000001ffc9a70000000000000000000000000000000000000000000000000000000004634d8d0000000000000000000000000000000000000000000000000000000006fdde03000000000000000000000000ffffffffffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000389a75e10000000000000000000000000000000000000020000000800000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff74873927000000000000000000000000000000000000000000000000000000007448fbae00000000000000000000000000000000000000040000001c000000000000000002000000000000000000000000000000000000200000000c0000000000000000796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d955391320200000200000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000006f5e88180000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000008b78c6d82569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c402569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c45020000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000100000000000000012569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c4400000002000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efb562e8dd000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000ffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffff0000000000000000000000ff000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000006bea012e4b0656aedab0e37d1b56784c44cff7efdf122586206946db88e9cbad0000000100000000000000000000000000000000000000000000000000000000290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e56300ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff3000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffdfa14c4b5000000000000000000000000000000000000000000000000000000000352e302e300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000aa4ec00224afccfdb702000000000000000000000000000000000000400000008000000000000000006bd5c950a8d8df17f772f5af37cb3655737899cbf903264b9795592da439661c2569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c47020000000000000000000000000000000000002000000000000000000000000017307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c312569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c43617167b76dcc8247761fd21f427ad8ec3be6b3be203aed34e3aac08b4d31817cffffffffffffffff00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffffbf0000000019457468657265756d205369676e6564204d6573736167653a0a3332020000000000000000000000000000000000003c0000000400000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000008000000000000000000000000010c74b0300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008baa579f343295c400000000000000000000000000000000000000000000000000000000fffffffffffffffffffffffffffffffffffffffffffffffeffffffffffffffff3686745b00000000000000000000000000000000000000000000000000000000b7b54e9b000000000000000000000000000000000000000000000000000000004e487b710000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000000f59b9ff000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08f4eb60400000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff00000000000000000000000000000000000000002d025324f0a785e8c12d0a0d91a9caa49df4ef20ff87e0df7213a1d4f3157beb0000000000000000000000000000000000000000fffffffffffffffffffffffffa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c92310ab089e4439a4c15d089f94afb7896ff553aecb10793d0ab882de59d99a32e0200000200000000000000000000000000000044000000000000000000000000360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc000000000000000000000000000000000000000000000000ffffffffffffff7f52d1902d00000000000000000000000000000000000000000000000000000000aa1d49a4000000000000000000000000000000000000000000000000000000001806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000bc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b0000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000003ffffffe000000000000000000000000000000000000000000000000000000000ffffffe01425ea42000000000000000000000000000000000000000000000000000000009996b31500000000000000000000000000000000000000000000000000000000b398979f000000000000000000000000000000000000000000000000000000004c9c8ce300000000000000000000000000000000000000000000000000000000e07c8dba000000000000000000000000000000000000000000000000000000002569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c4659c896be00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffff0000000000000000000000000000000100000003000000000000000000000000000000000000000000000000000000002569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c41d6f21326ab749d5729fcba5677c79037b459436ab7bff709c9d06ce9f10c1a9d19c1a81f34d9a8d208a44017474815e9089aff4b57e461c08509577eea2c3900ee151c8401928dc223602bb187aff91b9a56c7cae5476ef1b3287b085a16c85f20697320616c726561647920696e697469616c697a6564000000000000000000455243373231415f5f496e697469616c697a61626c653a20636f6e747261637408c379a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000416273747261637420416476656e7475726572730000000000000000000000004144564e540000000000000000000000000000000000000000000000000000002569078dfb4b0305704d3008e7403993ae9601b85f7ae5e742de3de8f8011c426cc130753487db497f572e90c00c24779bdd7267955b3d1454e114d8fc4b414d933ecf8acb7824b680a8d16f3ff3db8864228d986aa4c2ebab1eeb2703b4beb36cc130753487db497f572e90c00c24779bdd7267955b3d1454e114d8fc4b414c715ad5ce61fc9595c7b415289d59cf203f23a94fa06f04af7e489a0a76e1fe26ffffffffffffffffffffffffffffffffffffffffffffffcdffffffffffffffceffffffffffffffffffffffffffffffffffffffffffffff0000000000000000010000000000000000000000000000000000000000000000010000000000000000d92e233d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffc0ffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffff2e07630000000000000000000000000000000000000000000000000000000000206973206e6f7420696e697469616c697a696e67000000000000000000000000f92ee8a9000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffd5d00dbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1dcfb3b942000000000000000000000000000000000000000000000000000000008c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925df2d9b4200000000000000000000000000000000000000000000000000000000cf4700e40000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000b4457eaa00000000000000000000000000000000000000000000000000000000350a88b30000000000000000000000000000000000000000000000000000000082b4290000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000490649060000000000000000000000000000000000000000000000000000000001ffc9a70000000000000000000000000000000000000000000000000000000080ac58cd000000000000000000000000000000000000000000000000000000005b5e139f00000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff8000000000000000000000000000000000000000000000000000000000000000a114810000000000000000000000000000000000000000000000000000000000ea553b3400000000000000000000000000000000000000000000000000000000150b7a0200000000000000000000000000000000000000000000000000000000d1a57ed600000000000000000000000000000000000000000000000000000000ab11e94bbcaeae30d60b81a5c289e95b11b0d0ac77c53ff92d12c3cadaea3df7
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 31 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
[ 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.