Source Code
Overview
ETH Balance
0 ETH
More Info
ContractCreator
Multichain Info
N/A
| Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
|---|---|---|---|---|---|---|---|---|---|
Latest 10 internal transactions
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:
CreatorTokenTransferValidator
Compiler Version
v0.8.24+commit.e11b9ed9
ZkSolc Version
v1.5.7
Optimization Enabled:
Yes with Mode 3
Other Settings:
cancun EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
import "./Constants.sol";
import "./DataTypes.sol";
import "./ZkTstorish.sol";
import "@limitbreak/permit-c/PermitC.sol";
import "@limitbreak/tm-core-lib/src/utils/introspection/ERC165.sol";
import "@limitbreak/tm-core-lib/src/utils/structs/EnumerableSet.sol";
import "@limitbreak/tm-core-lib/src/utils/token/IEOARegistry.sol";
import "@limitbreak/tm-core-lib/src/utils/token/ITransferValidator.sol";
/**
* @title CreatorTokenTransferValidator
* @author Limit Break, Inc.
* @notice The CreatorTokenTransferValidator contract is designed to provide a customizable and secure transfer
* validation mechanism for NFT collections. This contract allows the owner of an NFT collection to configure
* the transfer security level, blacklisted accounts and codehashes, whitelisted accounts and codehashes, and
* authorized accounts and codehashes for each collection.
*
* @dev <h4>Features</h4>
* - Transfer security levels: Provides different levels of transfer security,
* from open transfers to completely restricted transfers.
* - Blacklist: Allows the owner of a collection to blacklist specific operator addresses or codehashes
* from executing transfers on behalf of others.
* - Whitelist: Allows the owner of a collection to whitelist specific operator addresses or codehashes
* permitted to execute transfers on behalf of others or send/receive tokens when otherwise disabled by
* security policy.
* - Authorizers: Allows the owner of a collection to enable authorizer contracts, that can perform
* authorization-based filtering of transfers.
*
* @dev <h4>Benefits</h4>
* - Enhanced security: Allows creators to have more control over their NFT collections, ensuring the safety
* and integrity of their assets.
* - Flexibility: Provides collection owners the ability to customize transfer rules as per their requirements.
* - Compliance: Facilitates compliance with regulations by enabling creators to restrict transfers based on
* specific criteria.
*
* @dev <h4>Intended Usage</h4>
* - The CreatorTokenTransferValidatorV3 contract is intended to be used by NFT collection owners to manage and
* enforce transfer policies. This contract is integrated with the following varations of creator token
* NFT contracts to validate transfers according to the defined security policies.
*
* - ERC721-C: Creator token implenting OpenZeppelin's ERC-721 standard.
* - ERC721-AC: Creator token implenting Azuki's ERC-721A standard.
* - ERC721-CW: Creator token implementing OpenZeppelin's ERC-721 standard with opt-in staking to
* wrap/upgrade a pre-existing ERC-721 collection.
* - ERC721-ACW: Creator token implementing Azuki's ERC721-A standard with opt-in staking to
* wrap/upgrade a pre-existing ERC-721 collection.
* - ERC1155-C: Creator token implenting OpenZeppelin's ERC-1155 standard.
* - ERC1155-CW: Creator token implementing OpenZeppelin's ERC-1155 standard with opt-in staking to
* wrap/upgrade a pre-existing ERC-1155 collection.
*
* <h4>Transfer Security Levels</h4>
* - Recommended: Recommended defaults are same as Level 3 (Whitelisting with OTC Enabled).
* - Caller Constraints: OperatorWhitelistEnableOTC
* - Receiver Constraints: None
* - Level 1: No transfer restrictions.
* - Caller Constraints: None
* - Receiver Constraints: None
* - Level 2: Only non-blacklisted operators can initiate transfers, over-the-counter (OTC) trading enabled.
* - Caller Constraints: OperatorBlacklistEnableOTC
* - Receiver Constraints: None
* - Level 3: Only whitelisted accounts can initiate transfers, over-the-counter (OTC) trading enabled.
* - Caller Constraints: OperatorWhitelistEnableOTC
* - Receiver Constraints: None
* - Level 4: Only whitelisted accounts can initiate transfers, over-the-counter (OTC) trading disabled.
* - Caller Constraints: OperatorWhitelistDisableOTC
* - Receiver Constraints: None
* - Level 5: Only whitelisted accounts can initiate transfers, over-the-counter (OTC) trading enabled.
* Transfers to contracts with code are not allowed, unless present on the whitelist.
* - Caller Constraints: OperatorWhitelistEnableOTC
* - Receiver Constraints: NoCode
* - Level 6: Only whitelisted accounts can initiate transfers, over-the-counter (OTC) trading enabled.
* Transfers are allowed only to Externally Owned Accounts (EOAs), unless present on the whitelist.
* - Caller Constraints: OperatorWhitelistEnableOTC
* - Receiver Constraints: EOA
* - Level 7: Only whitelisted accounts can initiate transfers, over-the-counter (OTC) trading disabled.
* Transfers to contracts with code are not allowed, unless present on the whitelist.
* - Caller Constraints: OperatorWhitelistDisableOTC
* - Receiver Constraints: NoCode
* - Level 8: Only whitelisted accounts can initiate transfers, over-the-counter (OTC) trading disabled.
* Transfers are allowed only to Externally Owned Accounts (EOAs), unless present on the whitelist.
* - Caller Constraints: OperatorWhitelistDisableOTC
* - Receiver Constraints: EOA
* - Level 9: Soulbound Token, No Transfers Allowed.
*/
contract CreatorTokenTransferValidator is IEOARegistry, ITransferValidator, ERC165, ZkTstorish, PermitC {
using EnumerableSet for EnumerableSet.AddressSet;
using EnumerableSet for EnumerableSet.Bytes32Set;
/*************************************************************************/
/* CUSTOM ERRORS */
/*************************************************************************/
/// @dev Thrown when attempting to set a list id that does not exist.
error CreatorTokenTransferValidator__ListDoesNotExist();
/// @dev Thrown when attempting to transfer the ownership of a list to the zero address.
error CreatorTokenTransferValidator__ListOwnershipCannotBeTransferredToZeroAddress();
/// @dev Thrown when attempting to call a function that requires the caller to be the list owner.
error CreatorTokenTransferValidator__CallerDoesNotOwnList();
/// @dev Thrown when validating a transfer for a collection using whitelists and the operator is not on the whitelist.
error CreatorTokenTransferValidator__CallerMustBeWhitelisted();
/// @dev Thrown when authorizing a transfer for a collection using authorizers and the msg.sender is not in the authorizer list.
error CreatorTokenTransferValidator__CallerMustBeAnAuthorizer();
/// @dev Thrown when attempting to call a function that requires owner or default admin role for a collection that the caller does not have.
error CreatorTokenTransferValidator__CallerMustHaveElevatedPermissionsForSpecifiedNFT();
/// @dev Thrown when attempting to renounce or transfer ownership of the default list id.
error CreatorTokenTransferValidator__CannotReassignOwnershipOfDefaultList();
/// @dev Thrown when constructor args are not valid
error CreatorTokenTransferValidator__InvalidConstructorArgs();
/// @dev Thrown when setting the transfer security level to an invalid value.
error CreatorTokenTransferValidator__InvalidTransferSecurityLevel();
/// @dev Thrown when validating a transfer for a collection using blacklists and the operator is on the blacklist.
error CreatorTokenTransferValidator__OperatorIsBlacklisted();
/// @dev Thrown when validating a transfer for a collection that does not allow receiver to have code and the receiver has code.
error CreatorTokenTransferValidator__ReceiverMustNotHaveDeployedCode();
/// @dev Thrown when validating a transfer for a collection that requires receivers be verified EOAs and the receiver is not verified.
error CreatorTokenTransferValidator__ReceiverProofOfEOASignatureUnverified();
/// @dev Thrown when a frozen account is the receiver of a transfer
error CreatorTokenTransferValidator__ReceiverAccountIsFrozen();
/// @dev Thrown when a frozen account is the sender of a transfer
error CreatorTokenTransferValidator__SenderAccountIsFrozen();
/// @dev Thrown when validating a transfer for a collection that is in soulbound token mode.
error CreatorTokenTransferValidator__TokenIsSoulbound();
/// @dev Thrown when an authorizer attempts to set a wildcard authorized operator on collections that don't allow wildcards
error CreatorTokenTransferValidator__WildcardOperatorsCannotBeAuthorizedForCollection();
/// @dev Thrown when attempting to set a authorized operator when authorization mode is disabled.
error CreatorTokenTransferValidator__AuthorizationDisabledForCollection();
/// @dev Thrown when attempting to validate a permitted transfer where the permit type does not match the collection-defined token type.
error CreatorTokenTransferValidator__TokenTypesDoNotMatch();
/*************************************************************************/
/* EVENTS */
/*************************************************************************/
/// @dev Emitted when a new list is created.
event CreatedList(uint256 indexed id, string name);
/// @dev Emitted when a list is applied to a collection.
event AppliedListToCollection(address indexed collection, uint120 indexed id);
/// @dev Emitted when the ownership of a list is transferred to a new owner.
event ReassignedListOwnership(uint256 indexed id, address indexed newOwner);
/// @dev Emitted when an account is added to the list of frozen accounts for a collection.
event AccountFrozenForCollection(address indexed collection, address indexed account);
/// @dev Emitted when an account is removed from the list of frozen accounts for a collection.
event AccountUnfrozenForCollection(address indexed collection, address indexed account);
/// @dev Emitted when an address is added to a list.
event AddedAccountToList(uint8 indexed kind, uint256 indexed id, address indexed account);
/// @dev Emitted when a codehash is added to a list.
event AddedCodeHashToList(uint8 indexed kind, uint256 indexed id, bytes32 indexed codehash);
/// @dev Emitted when an address is removed from a list.
event RemovedAccountFromList(uint8 indexed kind, uint256 indexed id, address indexed account);
/// @dev Emitted when a codehash is removed from a list.
event RemovedCodeHashFromList(uint8 indexed kind, uint256 indexed id, bytes32 indexed codehash);
/// @dev Emitted when the security level for a collection is updated.
event SetTransferSecurityLevel(address indexed collection, uint8 level);
/// @dev Emitted when a collection updates its authorization mode.
event SetAuthorizationModeEnabled(address indexed collection, bool disabled, bool authorizersCannotSetWildcardOperators);
/// @dev Emitted when a collection turns account freezing on or off.
event SetAccountFreezingModeEnabled(address indexed collection, bool enabled);
/// @dev Emitted when a collection's token type is updated.
event SetTokenType(address indexed collection, uint16 tokenType);
/*************************************************************************/
/* STRUCTS */
/*************************************************************************/
/**
* @dev This struct is internally for the storage of account and codehash lists.
*/
struct List {
EnumerableSet.AddressSet enumerableAccounts;
EnumerableSet.Bytes32Set enumerableCodehashes;
mapping (address => bool) nonEnumerableAccounts;
mapping (bytes32 => bool) nonEnumerableCodehashes;
}
/**
* @dev This struct is internally for the storage of account lists.
*/
struct AccountList {
EnumerableSet.AddressSet enumerableAccounts;
mapping (address => bool) nonEnumerableAccounts;
}
/*************************************************************************/
/* CONSTANTS */
/*************************************************************************/
/// @dev Immutable lookup table for constant gas determination of caller constraints by security level.
/// @dev Created during contract construction using defined constants.
uint256 private immutable _callerConstraintsLookup;
/// @dev Immutable lookup table for constant gas determination of receiver constraints by security level.
/// @dev Created during contract construction using defined constants.
uint256 private immutable _receiverConstraintsLookup;
/// @dev The address of the EOA Registry to use to validate an account is a verified EOA.
address private immutable _eoaRegistry;
/// @dev The legacy Creator Token Transfer Validator Interface
bytes4 private constant LEGACY_TRANSFER_VALIDATOR_INTERFACE_ID = 0x00000000;
/// @dev The default admin role value for contracts that implement access control.
bytes32 private constant DEFAULT_ACCESS_CONTROL_ADMIN_ROLE = 0x00;
/// @dev Value representing a zero value code hash.
bytes32 private constant BYTES32_ZERO = 0x0000000000000000000000000000000000000000000000000000000000000000;
address private constant WILDCARD_OPERATOR_ADDRESS = address(0x01);
uint16 private constant DEFAULT_TOKEN_TYPE = 0;
/*************************************************************************/
/* STORAGE */
/*************************************************************************/
/// @notice Keeps track of the most recently created list id.
uint120 public lastListId;
/// @dev Used as a collision guard.
uint256 private _transientOperatorSlotHolder;
/// @notice Mapping of list ids to list owners
mapping (uint120 => address) public listOwners;
/// @dev Mapping of collection addresses to their security policy settings
mapping (address => CollectionSecurityPolicyV3) internal collectionSecurityPolicies;
/// @dev Mapping of list ids to blacklist settings
mapping (uint120 => List) internal blacklists;
/// @dev Mapping of list ids to whitelist settings
mapping (uint120 => List) internal whitelists;
/// @dev Mapping of list ids to authorizers
mapping (uint120 => List) internal authorizers;
/// @dev Mapping of collections to accounts that are frozen for those collections
mapping (address => AccountList) internal frozenAccounts;
constructor(
address defaultOwner,
address eoaRegistry_,
string memory name,
string memory version
)
ZkTstorish()
PermitC(
name,
version,
defaultOwner,
block.chainid == 1 ? 0.33 ether : 0.01 ether
) {
if (defaultOwner == address(0) || eoaRegistry_ == address(0)) {
revert CreatorTokenTransferValidator__InvalidConstructorArgs();
}
_createDefaultList(defaultOwner);
_eoaRegistry = eoaRegistry_;
_callerConstraintsLookup = _constructCallerConstraintsTable();
_receiverConstraintsLookup = _constructReceiverConstraintsTable();
}
/**
* @dev This function is only called during contract construction to create the default list.
*/
function _createDefaultList(address defaultOwner) internal {
uint120 id = 0;
listOwners[id] = defaultOwner;
emit CreatedList(id, "DEFAULT LIST");
emit ReassignedListOwnership(id, defaultOwner);
}
/**
* @dev This function is only called during contract construction to create the caller constraints
* @dev lookup table.
*/
function _constructCallerConstraintsTable() internal pure returns (uint256) {
return
(CALLER_CONSTRAINTS_OPERATOR_WHITELIST_ENABLE_OTC << (TRANSFER_SECURITY_LEVEL_RECOMMENDED << 3))
| (CALLER_CONSTRAINTS_NONE << (TRANSFER_SECURITY_LEVEL_ONE << 3))
| (CALLER_CONSTRAINTS_OPERATOR_BLACKLIST_ENABLE_OTC << (TRANSFER_SECURITY_LEVEL_TWO << 3))
| (CALLER_CONSTRAINTS_OPERATOR_WHITELIST_ENABLE_OTC << (TRANSFER_SECURITY_LEVEL_THREE << 3))
| (CALLER_CONSTRAINTS_OPERATOR_WHITELIST_DISABLE_OTC << (TRANSFER_SECURITY_LEVEL_FOUR << 3))
| (CALLER_CONSTRAINTS_OPERATOR_WHITELIST_ENABLE_OTC << (TRANSFER_SECURITY_LEVEL_FIVE << 3))
| (CALLER_CONSTRAINTS_OPERATOR_WHITELIST_ENABLE_OTC << (TRANSFER_SECURITY_LEVEL_SIX << 3))
| (CALLER_CONSTRAINTS_OPERATOR_WHITELIST_DISABLE_OTC << (TRANSFER_SECURITY_LEVEL_SEVEN << 3))
| (CALLER_CONSTRAINTS_OPERATOR_WHITELIST_DISABLE_OTC << (TRANSFER_SECURITY_LEVEL_EIGHT << 3))
| (CALLER_CONSTRAINTS_SBT << (TRANSFER_SECURITY_LEVEL_NINE << 3));
}
/**
* @dev This function is only called during contract construction to create the receiver constraints
* @dev lookup table.
*/
function _constructReceiverConstraintsTable() internal pure returns (uint256) {
return
(RECEIVER_CONSTRAINTS_NONE << (TRANSFER_SECURITY_LEVEL_RECOMMENDED << 3))
| (RECEIVER_CONSTRAINTS_NONE << (TRANSFER_SECURITY_LEVEL_ONE << 3))
| (RECEIVER_CONSTRAINTS_NONE << (TRANSFER_SECURITY_LEVEL_TWO << 3))
| (RECEIVER_CONSTRAINTS_NONE << (TRANSFER_SECURITY_LEVEL_THREE << 3))
| (RECEIVER_CONSTRAINTS_NONE << (TRANSFER_SECURITY_LEVEL_FOUR << 3))
| (RECEIVER_CONSTRAINTS_NO_CODE << (TRANSFER_SECURITY_LEVEL_FIVE << 3))
| (RECEIVER_CONSTRAINTS_EOA << (TRANSFER_SECURITY_LEVEL_SIX << 3))
| (RECEIVER_CONSTRAINTS_NO_CODE << (TRANSFER_SECURITY_LEVEL_SEVEN << 3))
| (RECEIVER_CONSTRAINTS_EOA << (TRANSFER_SECURITY_LEVEL_EIGHT << 3))
| (RECEIVER_CONSTRAINTS_SBT << (TRANSFER_SECURITY_LEVEL_NINE << 3));
}
/*************************************************************************/
/* MODIFIERS */
/*************************************************************************/
/**
* @dev This modifier restricts a function call to the owner of the list `id`.
* @dev Throws when the caller is not the list owner.
*/
modifier onlyListOwner(uint120 id) {
_requireCallerOwnsList(id);
_;
}
/*************************************************************************/
/* APPLY TRANSFER POLICIES */
/*************************************************************************/
/**
* @notice Apply the collection transfer policy to a transfer operation of a creator token.
*
* @dev If the caller is self (Permit-C Processor) it means we have already applied operator validation in the
* _beforeTransferFrom callback. In this case, the security policy was already applied and the operator
* that used the Permit-C processor passed the security policy check and transfer can be safely allowed.
*
* @dev The order of checking whitelisted accounts, authorized operator check and whitelisted codehashes
* is very deliberate. The order of operations is determined by the most frequently used settings that are
* expected in the wild.
*
* @dev Throws when the collection has enabled account freezing mode and either the `from` or `to` addresses
* are on the list of frozen accounts for the collection.
* @dev Throws when the collection is set to Level 9 - Soulbound Token.
* @dev Throws when the receiver has deployed code and isn't whitelisted, if ReceiverConstraints.NoCode is set
* and the transfer is not approved by an authorizer for the collection.
* @dev Throws when the receiver has never verified a signature to prove they are an EOA and the receiver
* isn't whitelisted, if the ReceiverConstraints.EOA is set and the transfer is not approved by an
* authorizer for the collection..
* @dev Throws when `msg.sender` is blacklisted, if CallerConstraints.OperatorBlacklistEnableOTC is set, unless
* `msg.sender` is also the `from` address or the transfer is approved by an authorizer for the collection.
* @dev Throws when `msg.sender` isn't whitelisted, if CallerConstraints.OperatorWhitelistEnableOTC is set, unless
* `msg.sender` is also the `from` address or the transfer is approved by an authorizer for the collection.
* @dev Throws when neither `msg.sender` nor `from` are whitelisted, if
* CallerConstraints.OperatorWhitelistDisableOTC is set and the transfer
* is not approved by an authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. Transfer is allowed or denied based on the applied transfer policy.
*
* @param caller The address initiating the transfer.
* @param from The address of the token owner.
* @param to The address of the token receiver.
*/
function validateTransfer(address caller, address from, address to) public view {
(bytes4 errorSelector,) = _validateTransfer(_callerAuthorizedCheckCollection, msg.sender, caller, from, to, 0);
if (errorSelector != SELECTOR_NO_ERROR) {
_revertCustomErrorSelectorAsm(errorSelector);
}
}
/**
* @notice Apply the collection transfer policy to a transfer operation of a creator token.
*
* @dev If the caller is self (Permit-C Processor) it means we have already applied operator validation in the
* _beforeTransferFrom callback. In this case, the security policy was already applied and the operator
* that used the Permit-C processor passed the security policy check and transfer can be safely allowed.
*
* @dev The order of checking whitelisted accounts, authorized operator check and whitelisted codehashes
* is very deliberate. The order of operations is determined by the most frequently used settings that are
* expected in the wild.
*
* @dev Throws when the collection has enabled account freezing mode and either the `from` or `to` addresses
* are on the list of frozen accounts for the collection.
* @dev Throws when the collection is set to Level 9 - Soulbound Token.
* @dev Throws when the receiver has deployed code and isn't whitelisted, if ReceiverConstraints.NoCode is set
* and the transfer is not approved by an authorizer for the collection.
* @dev Throws when the receiver has never verified a signature to prove they are an EOA and the receiver
* isn't whitelisted, if the ReceiverConstraints.EOA is set and the transfer is not approved by an
* authorizer for the collection..
* @dev Throws when `msg.sender` is blacklisted, if CallerConstraints.OperatorBlacklistEnableOTC is set, unless
* `msg.sender` is also the `from` address or the transfer is approved by an authorizer for the collection.
* @dev Throws when `msg.sender` isn't whitelisted, if CallerConstraints.OperatorWhitelistEnableOTC is set, unless
* `msg.sender` is also the `from` address or the transfer is approved by an authorizer for the collection.
* @dev Throws when neither `msg.sender` nor `from` are whitelisted, if
* CallerConstraints.OperatorWhitelistDisableOTC is set and the transfer
* is not approved by an authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. Transfer is allowed or denied based on the applied transfer policy.
*
* @param caller The address initiating the transfer.
* @param from The address of the token owner.
* @param to The address of the token receiver.
* @param tokenId The token id being transferred.
*/
function validateTransfer(address caller, address from, address to, uint256 tokenId) public view {
(bytes4 errorSelector,) = _validateTransfer(_callerAuthorizedCheckToken, msg.sender, caller, from, to, tokenId);
if (errorSelector != SELECTOR_NO_ERROR) {
_revertCustomErrorSelectorAsm(errorSelector);
}
}
/**
* @notice Apply the collection transfer policy to a transfer operation of a creator token.
*
* @dev If the caller is self (Permit-C Processor) it means we have already applied operator validation in the
* _beforeTransferFrom callback. In this case, the security policy was already applied and the operator
* that used the Permit-C processor passed the security policy check and transfer can be safely allowed.
*
* @dev The order of checking whitelisted accounts, authorized operator check and whitelisted codehashes
* is very deliberate. The order of operations is determined by the most frequently used settings that are
* expected in the wild.
*
* @dev Throws when the collection has enabled account freezing mode and either the `from` or `to` addresses
* are on the list of frozen accounts for the collection.
* @dev Throws when the collection is set to Level 9 - Soulbound Token.
* @dev Throws when the receiver has deployed code and isn't whitelisted, if ReceiverConstraints.NoCode is set
* and the transfer is not approved by an authorizer for the collection.
* @dev Throws when the receiver has never verified a signature to prove they are an EOA and the receiver
* isn't whitelisted, if the ReceiverConstraints.EOA is set and the transfer is not approved by an
* authorizer for the collection..
* @dev Throws when `msg.sender` is blacklisted, if CallerConstraints.OperatorBlacklistEnableOTC is set, unless
* `msg.sender` is also the `from` address or the transfer is approved by an authorizer for the collection.
* @dev Throws when `msg.sender` isn't whitelisted, if CallerConstraints.OperatorWhitelistEnableOTC is set, unless
* `msg.sender` is also the `from` address or the transfer is approved by an authorizer for the collection.
* @dev Throws when neither `msg.sender` nor `from` are whitelisted, if
* CallerConstraints.OperatorWhitelistDisableOTC is set and the transfer
* is not approved by an authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. Transfer is allowed or denied based on the applied transfer policy.
*
* @param caller The address initiating the transfer.
* @param from The address of the token owner.
* @param to The address of the token receiver.
* @param tokenId The token id being transferred.
*/
function validateTransfer(address caller, address from, address to, uint256 tokenId, uint256 /*amount*/) external {
validateTransfer(caller, from, to, tokenId);
}
/**
* @notice Apply the collection transfer policy to a transfer operation of a creator token.
*
* @dev If the caller is self (Permit-C Processor) it means we have already applied operator validation in the
* _beforeTransferFrom callback. In this case, the security policy was already applied and the operator
* that used the Permit-C processor passed the security policy check and transfer can be safely allowed.
*
* @dev The order of checking whitelisted accounts, authorized operator check and whitelisted codehashes
* is very deliberate. The order of operations is determined by the most frequently used settings that are
* expected in the wild.
*
* @dev Throws when the collection has enabled account freezing mode and either the `from` or `to` addresses
* are on the list of frozen accounts for the collection.
* @dev Throws when the collection is set to Level 9 - Soulbound Token.
* @dev Throws when the receiver has deployed code and isn't whitelisted, if ReceiverConstraints.NoCode is set
* and the transfer is not approved by an authorizer for the collection.
* @dev Throws when the receiver has never verified a signature to prove they are an EOA and the receiver
* isn't whitelisted, if the ReceiverConstraints.EOA is set and the transfer is not approved by an
* authorizer for the collection..
* @dev Throws when `msg.sender` is blacklisted, if CallerConstraints.OperatorBlacklistEnableOTC is set, unless
* `msg.sender` is also the `from` address or the transfer is approved by an authorizer for the collection.
* @dev Throws when `msg.sender` isn't whitelisted, if CallerConstraints.OperatorWhitelistEnableOTC is set, unless
* `msg.sender` is also the `from` address or the transfer is approved by an authorizer for the collection.
* @dev Throws when neither `msg.sender` nor `from` are whitelisted, if
* CallerConstraints.OperatorWhitelistDisableOTC is set and the transfer
* is not approved by an authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. Transfer is allowed or denied based on the applied transfer policy.
*
* @param caller The address initiating the transfer.
* @param from The address of the token owner.
* @param to The address of the token receiver.
*/
function applyCollectionTransferPolicy(address caller, address from, address to) external view {
validateTransfer(caller, from, to);
}
/**
* @notice Returns the caller and receiver constraints for the specified transfer security level.
*
* @param level The transfer security level to return the caller and receiver constraints for.
*
* @return callerConstraints The `CallerConstraints` value for the level.
* @return receiverConstraints The `ReceiverConstraints` value for the level.
*/
function transferSecurityPolicies(
uint256 level
) public view returns (uint256 callerConstraints, uint256 receiverConstraints) {
callerConstraints = uint8((_callerConstraintsLookup >> (level << 3)));
receiverConstraints = uint8((_receiverConstraintsLookup >> (level << 3)));
}
/**
* @notice Sets an operator for an authorized transfer that skips transfer security level
* validation for caller and receiver constraints.
*
* @dev An authorizer *MUST* clear the authorization with a call to `afterAuthorizedTransfer`
* to prevent unauthorized transfers of the token.
*
* @dev Throws when authorization mode is disabled for the collection.
* @dev Throws when using the wildcard operator address and the collection does not allow
* for wildcard authorized operators.
* @dev Throws when the caller is not an allowed authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The `operator` is stored as an authorized operator for transfers.
*
* @param operator The address of the operator to set as authorized for transfers.
* @param token The address of the token to authorize.
* @param tokenId The token id to set the authorized operator for.
*/
function beforeAuthorizedTransfer(address operator, address token, uint256 tokenId) external {
_setOperatorInTransientStorage(operator, token, tokenId, false);
}
/**
* @notice Clears the authorized operator for a token to prevent additional transfers that
* do not conform to the transfer security level for the token.
*
* @dev Throws when authorization mode is disabled for the collection.
* @dev Throws when using the wildcard operator address and the collection does not allow
* for wildcard authorized operators.
* @dev Throws when the caller is not an allowed authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The authorized operator for the token is cleared from storage.
*
* @param token The address of the token to authorize.
* @param tokenId The token id to set the authorized operator for.
*/
function afterAuthorizedTransfer(address token, uint256 tokenId) public {
_setOperatorInTransientStorage(address(uint160(uint256(BYTES32_ZERO))), token, tokenId, false);
}
/**
* @notice Sets an operator for an authorized transfer that skips transfer security level
* validation for caller and receiver constraints.
* @notice This overload of `beforeAuthorizedTransfer` defaults to a tokenId of 0.
*
* @dev An authorizer *MUST* clear the authorization with a call to `afterAuthorizedTransfer`
* to prevent unauthorized transfers of the token.
*
* @dev Throws when authorization mode is disabled for the collection.
* @dev Throws when using the wildcard operator address and the collection does not allow
* for wildcard authorized operators.
* @dev Throws when the caller is not an allowed authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The `operator` is stored as an authorized operator for transfers.
*
* @param operator The address of the operator to set as authorized for transfers.
* @param token The address of the token to authorize.
*/
function beforeAuthorizedTransfer(address operator, address token) external {
_setOperatorInTransientStorage(operator, token, 0, true);
}
/**
* @notice Clears the authorized operator for a token to prevent additional transfers that
* do not conform to the transfer security level for the token.
* @notice This overload of `afterAuthorizedTransfer` defaults to a tokenId of 0.
*
* @dev Throws when authorization mode is disabled for the collection.
* @dev Throws when using the wildcard operator address and the collection does not allow
* for wildcard authorized operators.
* @dev Throws when the caller is not an allowed authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The authorized operator for the token is cleared from storage.
*
* @param token The address of the token to authorize.
*/
function afterAuthorizedTransfer(address token) external {
afterAuthorizedTransfer(token, 0);
}
/**
* @notice Sets the wildcard operator to authorize any operator to transfer a token while
* skipping transfer security level validation for caller and receiver constraints.
*
* @dev An authorizer *MUST* clear the authorization with a call to `afterAuthorizedTransfer`
* to prevent unauthorized transfers of the token.
*
* @dev Throws when authorization mode is disabled for the collection.
* @dev Throws when the collection does not allow for wildcard authorized operators.
* @dev Throws when the caller is not an allowed authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The wildcard operator is stored as an authorized operator for transfers.
*
* @param token The address of the token to authorize.
* @param tokenId The token id to set the authorized operator for.
*/
function beforeAuthorizedTransfer(address token, uint256 tokenId) external {
_setOperatorInTransientStorage(WILDCARD_OPERATOR_ADDRESS, token, tokenId, false);
}
/**
* @notice Sets the wildcard operator to authorize any operator to transfer a token while
* skipping transfer security level validation for caller and receiver constraints.
*
* @dev An authorizer *MUST* clear the authorization with a call to `afterAuthorizedTransfer`
* to prevent unauthorized transfers of the token.
*
* @dev Throws when authorization mode is disabled for the collection.
* @dev Throws when the collection does not allow for wildcard authorized operators.
* @dev Throws when the caller is not an allowed authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The wildcard operator is stored as an authorized operator for transfers.
*
* @param token The address of the token to authorize.
* @param tokenId The token id to set the authorized operator for.
*/
function beforeAuthorizedTransferWithAmount(address token, uint256 tokenId, uint256 /*amount*/) external {
_setOperatorInTransientStorage(WILDCARD_OPERATOR_ADDRESS, token, tokenId, false);
}
/**
* @notice Clears the authorized operator for a token to prevent additional transfers that
* do not conform to the transfer security level for the token.
*
* @dev Throws when authorization mode is disabled for the collection.
* @dev Throws when using the wildcard operator address and the collection does not allow
* for wildcard authorized operators.
* @dev Throws when the caller is not an allowed authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The authorized operator for the token is cleared from storage.
*
* @param token The address of the token to authorize.
* @param tokenId The token id to set the authorized operator for.
*/
function afterAuthorizedTransferWithAmount(address token, uint256 tokenId) external {
afterAuthorizedTransfer(token, tokenId);
}
/*************************************************************************/
/* LIST MANAGEMENT */
/*************************************************************************/
/**
* @notice Creates a new list id. The list id is a handle to allow editing of blacklisted and whitelisted accounts
* and codehashes.
*
* @dev <h4>Postconditions:</h4>
* 1. A new list with the specified name is created.
* 2. The caller is set as the owner of the new list.
* 3. A `CreatedList` event is emitted.
* 4. A `ReassignedListOwnership` event is emitted.
*
* @param name The name of the new list.
* @return id The id of the new list.
*/
function createList(string calldata name) public returns (uint120 id) {
unchecked {
id = ++lastListId;
}
listOwners[id] = msg.sender;
emit CreatedList(id, name);
emit ReassignedListOwnership(id, msg.sender);
}
/**
* @notice Creates a new list id, and copies all blacklisted and whitelisted accounts and codehashes from the
* specified source list.
*
* @dev <h4>Postconditions:</h4>
* 1. A new list with the specified name is created.
* 2. The caller is set as the owner of the new list.
* 3. A `CreatedList` event is emitted.
* 4. A `ReassignedListOwnership` event is emitted.
* 5. All blacklisted and whitelisted accounts and codehashes from the specified source list are copied
* to the new list.
* 6. An `AddedAccountToList` event is emitted for each blacklisted and whitelisted account copied.
* 7. An `AddedCodeHashToList` event is emitted for each blacklisted and whitelisted codehash copied.
*
* @param name The name of the new list.
* @param sourceListId The id of the source list to copy from.
* @return id The id of the new list.
*/
function createListCopy(string calldata name, uint120 sourceListId) external returns (uint120 id) {
unchecked {
id = ++lastListId;
}
unchecked {
if (sourceListId > id - 1) {
revert CreatorTokenTransferValidator__ListDoesNotExist();
}
}
listOwners[id] = msg.sender;
emit CreatedList(id, name);
emit ReassignedListOwnership(id, msg.sender);
List storage sourceBlacklist = blacklists[sourceListId];
List storage sourceWhitelist = whitelists[sourceListId];
List storage sourceAuthorizers = authorizers[sourceListId];
List storage targetBlacklist = blacklists[id];
List storage targetWhitelist = whitelists[id];
List storage targetAuthorizers = authorizers[id];
_copyAddressSet(LIST_TYPE_BLACKLIST, id, sourceBlacklist, targetBlacklist);
_copyBytes32Set(LIST_TYPE_BLACKLIST, id, sourceBlacklist, targetBlacklist);
_copyAddressSet(LIST_TYPE_WHITELIST, id, sourceWhitelist, targetWhitelist);
_copyBytes32Set(LIST_TYPE_WHITELIST, id, sourceWhitelist, targetWhitelist);
_copyAddressSet(LIST_TYPE_AUTHORIZERS, id, sourceAuthorizers, targetAuthorizers);
_copyBytes32Set(LIST_TYPE_AUTHORIZERS, id, sourceAuthorizers, targetAuthorizers);
}
/**
* @notice Transfer ownership of a list to a new owner.
*
* @dev Throws when the new owner is the zero address.
* @dev Throws when the caller does not own the specified list.
* @dev Throws when list id is zero (default list).
*
* @dev <h4>Postconditions:</h4>
* 1. The list ownership is transferred to the new owner.
* 2. A `ReassignedListOwnership` event is emitted.
*
* @param id The id of the list.
* @param newOwner The address of the new owner.
*/
function reassignOwnershipOfList(uint120 id, address newOwner) public {
if(newOwner == address(0)) {
revert CreatorTokenTransferValidator__ListOwnershipCannotBeTransferredToZeroAddress();
}
_reassignOwnershipOfList(id, newOwner);
}
/**
* @notice Renounce the ownership of a list, rendering the list immutable.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when list id is zero (default list).
*
* @dev <h4>Postconditions:</h4>
* 1. The ownership of the specified list is renounced.
* 2. A `ReassignedListOwnership` event is emitted.
*
* @param id The id of the list.
*/
function renounceOwnershipOfList(uint120 id) public {
_reassignOwnershipOfList(id, address(0));
}
/**
* @notice Set the transfer security level, authorization mode and account freezing mode settings of a collection.
*
* @dev Throws when the caller is neither collection contract, nor the owner or admin of the specified collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The transfer security level of the specified collection is set to the new value.
* 2. The authorization mode setting of the specified collection is set to the new value.
* 3. The authorization wildcard operator mode setting of the specified collection is set to the new value.
* 4. The account freezing mode setting of the specified collection is set to the new value.
* 5. A `SetTransferSecurityLevel` event is emitted.
* 6. A `SetAuthorizationModeEnabled` event is emitted.
* 7. A `SetAccountFreezingModeEnabled` event is emitted.
*
* @param collection The address of the collection.
* @param level The new transfer security level to apply.
* @param disableAuthorizationMode Flag if the collection allows for authorizer mode.
* @param disableWildcardOperators Flag if the authorizer can set wildcard operators.
* @param enableAccountFreezingMode Flag if the collection is using account freezing.
*/
function setTransferSecurityLevelOfCollection(
address collection,
uint8 level,
bool disableAuthorizationMode,
bool disableWildcardOperators,
bool enableAccountFreezingMode) external {
if (level > TRANSFER_SECURITY_LEVEL_NINE) {
revert CreatorTokenTransferValidator__InvalidTransferSecurityLevel();
}
_requireCallerIsNFTOrContractOwnerOrAdmin(collection);
collectionSecurityPolicies[collection].transferSecurityLevel = level;
collectionSecurityPolicies[collection].disableAuthorizationMode = disableAuthorizationMode;
collectionSecurityPolicies[collection].authorizersCannotSetWildcardOperators = disableWildcardOperators;
collectionSecurityPolicies[collection].enableAccountFreezingMode = enableAccountFreezingMode;
emit SetTransferSecurityLevel(collection, level);
emit SetAuthorizationModeEnabled(collection, disableAuthorizationMode, disableWildcardOperators);
emit SetAccountFreezingModeEnabled(collection, enableAccountFreezingMode);
}
/**
* @notice Set the token type setting of a collection.
*
* @dev Throws when the caller is neither collection contract, nor the owner or admin of the specified collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The token type of the specified collection is set to the new value.
* 2. A `SetTokenType` event is emitted.
*
* @param collection The address of the collection.
* @param tokenType The new transfer security level to apply.
*/
function setTokenTypeOfCollection(
address collection,
uint16 tokenType
) external {
_requireCallerIsNFTOrContractOwnerOrAdmin(collection);
collectionSecurityPolicies[collection].tokenType = tokenType;
emit SetTokenType(collection, tokenType);
}
/**
* @notice Applies the specified list to a collection.
*
* @dev Throws when the caller is neither collection contract, nor the owner or admin of the specified collection.
* @dev Throws when the specified list id does not exist.
*
* @dev <h4>Postconditions:</h4>
* 1. The list of the specified collection is set to the new value.
* 2. An `AppliedListToCollection` event is emitted.
*
* @param collection The address of the collection.
* @param id The id of the operator whitelist.
*/
function applyListToCollection(address collection, uint120 id) public {
_requireCallerIsNFTOrContractOwnerOrAdmin(collection);
if (id > lastListId) {
revert CreatorTokenTransferValidator__ListDoesNotExist();
}
collectionSecurityPolicies[collection].listId = id;
emit AppliedListToCollection(collection, id);
}
/**
* @notice Adds accounts to the frozen accounts list of a collection.
*
* @dev Throws when the caller is neither collection contract, nor the owner or admin of the specified collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The accounts are added to the list of frozen accounts for a collection.
* 2. A `AccountFrozenForCollection` event is emitted for each account added to the list.
*
* @param collection The address of the collection.
* @param accountsToFreeze The list of accounts to added to frozen accounts.
*/
function freezeAccountsForCollection(address collection, address[] calldata accountsToFreeze) external {
_requireCallerIsNFTOrContractOwnerOrAdmin(collection);
AccountList storage accounts = frozenAccounts[collection];
for (uint256 i = 0; i < accountsToFreeze.length;) {
address accountToFreeze = accountsToFreeze[i];
if (accounts.enumerableAccounts.add(accountToFreeze)) {
emit AccountFrozenForCollection(collection, accountToFreeze);
accounts.nonEnumerableAccounts[accountToFreeze] = true;
}
unchecked {
++i;
}
}
}
/**
* @notice Removes accounts to the frozen accounts list of a collection.
*
* @dev Throws when the caller is neither collection contract, nor the owner or admin of the specified collection.
*
* @dev <h4>Postconditions:</h4>
* 1. The accounts are removed from the list of frozen accounts for a collection.
* 2. A `AccountUnfrozenForCollection` event is emitted for each account removed from the list.
*
* @param collection The address of the collection.
* @param accountsToUnfreeze The list of accounts to remove from frozen accounts.
*/
function unfreezeAccountsForCollection(address collection, address[] calldata accountsToUnfreeze) external {
_requireCallerIsNFTOrContractOwnerOrAdmin(collection);
AccountList storage accounts = frozenAccounts[collection];
for (uint256 i = 0; i < accountsToUnfreeze.length;) {
address accountToUnfreeze = accountsToUnfreeze[i];
if (accounts.enumerableAccounts.remove(accountToUnfreeze)) {
emit AccountUnfrozenForCollection(collection, accountToUnfreeze);
accounts.nonEnumerableAccounts[accountToUnfreeze] = false;
}
unchecked {
++i;
}
}
}
/**
* @notice Get the security policy of the specified collection.
* @param collection The address of the collection.
* @return The security policy of the specified collection, which includes:
* Transfer security level, operator whitelist id, permitted contract receiver allowlist id,
* authorizer mode, if authorizer can set a wildcard operator, and if account freezing is
* enabled.
*/
function getCollectionSecurityPolicy(
address collection
) external view returns (CollectionSecurityPolicyV3 memory) {
return collectionSecurityPolicies[collection];
}
/**
* @notice Adds one or more accounts to a blacklist.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when the accounts array is empty.
*
* @dev <h4>Postconditions:</h4>
* 1. Accounts not previously in the list are added.
* 2. An `AddedAccountToList` event is emitted for each account that is newly added to the list.
*
* @param id The id of the list.
* @param accounts The addresses of the accounts to add.
*/
function addAccountsToBlacklist(
uint120 id,
address[] calldata accounts
) external {
_addAccountsToList(blacklists[id], LIST_TYPE_BLACKLIST, id, accounts);
}
/**
* @notice Adds one or more accounts to a whitelist.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when the accounts array is empty.
*
* @dev <h4>Postconditions:</h4>
* 1. Accounts not previously in the list are added.
* 2. An `AddedAccountToList` event is emitted for each account that is newly added to the list.
*
* @param id The id of the list.
* @param accounts The addresses of the accounts to add.
*/
function addAccountsToWhitelist(
uint120 id,
address[] calldata accounts
) external {
_addAccountsToList(whitelists[id], LIST_TYPE_WHITELIST, id, accounts);
}
/**
* @notice Adds one or more accounts to authorizers.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when the accounts array is empty.
*
* @dev <h4>Postconditions:</h4>
* 1. Accounts not previously in the list are added.
* 2. An `AddedAccountToList` event is emitted for each account that is newly added to the list.
*
* @param id The id of the list.
* @param accounts The addresses of the accounts to add.
*/
function addAccountsToAuthorizers(
uint120 id,
address[] calldata accounts
) external {
_addAccountsToList(authorizers[id], LIST_TYPE_AUTHORIZERS, id, accounts);
}
/**
* @notice Adds one or more codehashes to a blacklist.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when the codehashes array is empty.
* @dev Throws when a codehash is zero.
*
* @dev <h4>Postconditions:</h4>
* 1. Codehashes not previously in the list are added.
* 2. An `AddedCodeHashToList` event is emitted for each codehash that is newly added to the list.
*
* @param id The id of the list.
* @param codehashes The codehashes to add.
*/
function addCodeHashesToBlacklist(
uint120 id,
bytes32[] calldata codehashes
) external {
_addCodeHashesToList(blacklists[id], LIST_TYPE_BLACKLIST, id, codehashes);
}
/**
* @notice Adds one or more codehashes to a whitelist.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when the codehashes array is empty.
* @dev Throws when a codehash is zero.
*
* @dev <h4>Postconditions:</h4>
* 1. Codehashes not previously in the list are added.
* 2. An `AddedCodeHashToList` event is emitted for each codehash that is newly added to the list.
*
* @param id The id of the list.
* @param codehashes The codehashes to add.
*/
function addCodeHashesToWhitelist(
uint120 id,
bytes32[] calldata codehashes
) external {
_addCodeHashesToList(whitelists[id], LIST_TYPE_WHITELIST, id, codehashes);
}
/**
* @notice Removes one or more accounts from a blacklist.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when the accounts array is empty.
*
* @dev <h4>Postconditions:</h4>
* 1. Accounts previously in the list are removed.
* 2. A `RemovedAccountFromList` event is emitted for each account that is removed from the list.
*
* @param id The id of the list.
* @param accounts The addresses of the accounts to remove.
*/
function removeAccountsFromBlacklist(
uint120 id,
address[] calldata accounts
) external {
_removeAccountsFromList(blacklists[id], LIST_TYPE_BLACKLIST, id, accounts);
}
/**
* @notice Removes one or more accounts from a whitelist.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when the accounts array is empty.
*
* @dev <h4>Postconditions:</h4>
* 1. Accounts previously in the list are removed.
* 2. A `RemovedAccountFromList` event is emitted for each account that is removed from the list.
*
* @param id The id of the list.
* @param accounts The addresses of the accounts to remove.
*/
function removeAccountsFromWhitelist(
uint120 id,
address[] calldata accounts
) external {
_removeAccountsFromList(whitelists[id], LIST_TYPE_WHITELIST, id, accounts);
}
/**
* @notice Removes one or more accounts from authorizers.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when the accounts array is empty.
*
* @dev <h4>Postconditions:</h4>
* 1. Accounts previously in the list are removed.
* 2. A `RemovedAccountFromList` event is emitted for each account that is removed from the list.
*
* @param id The id of the list.
* @param accounts The addresses of the accounts to remove.
*/
function removeAccountsFromAuthorizers(
uint120 id,
address[] calldata accounts
) external {
_removeAccountsFromList(authorizers[id], LIST_TYPE_AUTHORIZERS, id, accounts);
}
/**
* @notice Removes one or more codehashes from a blacklist.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when the codehashes array is empty.
*
* @dev <h4>Postconditions:</h4>
* 1. Codehashes previously in the list are removed.
* 2. A `RemovedCodeHashFromList` event is emitted for each codehash that is removed from the list.
*
* @param id The id of the list.
* @param codehashes The codehashes to remove.
*/
function removeCodeHashesFromBlacklist(
uint120 id,
bytes32[] calldata codehashes
) external {
_removeCodeHashesFromList(blacklists[id], LIST_TYPE_BLACKLIST, id, codehashes);
}
/**
* @notice Removes one or more codehashes from a whitelist.
*
* @dev Throws when the caller does not own the specified list.
* @dev Throws when the codehashes array is empty.
*
* @dev <h4>Postconditions:</h4>
* 1. Codehashes previously in the list are removed.
* 2. A `RemovedCodeHashFromList` event is emitted for each codehash that is removed from the list.
*
* @param id The id of the list.
* @param codehashes The codehashes to remove.
*/
function removeCodeHashesFromWhitelist(
uint120 id,
bytes32[] calldata codehashes
) external {
_removeCodeHashesFromList(whitelists[id], LIST_TYPE_WHITELIST, id, codehashes);
}
/**
* @notice Get blacklisted accounts by list id.
* @param id The id of the list.
* @return An array of blacklisted accounts.
*/
function getBlacklistedAccounts(uint120 id) public view returns (address[] memory) {
return blacklists[id].enumerableAccounts.values();
}
/**
* @notice Get whitelisted accounts by list id.
* @param id The id of the list.
* @return An array of whitelisted accounts.
*/
function getWhitelistedAccounts(uint120 id) public view returns (address[] memory) {
return whitelists[id].enumerableAccounts.values();
}
/**
* @notice Get authorizor accounts by list id.
* @param id The id of the list.
* @return An array of authorizer accounts.
*/
function getAuthorizerAccounts(uint120 id) public view returns (address[] memory) {
return authorizers[id].enumerableAccounts.values();
}
/**
* @notice Get blacklisted codehashes by list id.
* @param id The id of the list.
* @return An array of blacklisted codehashes.
*/
function getBlacklistedCodeHashes(uint120 id) public view returns (bytes32[] memory) {
return blacklists[id].enumerableCodehashes.values();
}
/**
* @notice Get whitelisted codehashes by list id.
* @param id The id of the list.
* @return An array of whitelisted codehashes.
*/
function getWhitelistedCodeHashes(uint120 id) public view returns (bytes32[] memory) {
return whitelists[id].enumerableCodehashes.values();
}
/**
* @notice Check if an account is blacklisted in a specified list.
* @param id The id of the list.
* @param account The address of the account to check.
* @return True if the account is blacklisted in the specified list, false otherwise.
*/
function isAccountBlacklisted(uint120 id, address account) public view returns (bool) {
return blacklists[id].nonEnumerableAccounts[account];
}
/**
* @notice Check if an account is whitelisted in a specified list.
* @param id The id of the list.
* @param account The address of the account to check.
* @return True if the account is whitelisted in the specified list, false otherwise.
*/
function isAccountWhitelisted(uint120 id, address account) public view returns (bool) {
return whitelists[id].nonEnumerableAccounts[account];
}
/**
* @notice Check if an account is an authorizer in a specified list.
* @param id The id of the list.
* @param account The address of the account to check.
* @return True if the account is an authorizer in the specified list, false otherwise.
*/
function isAccountAuthorizer(uint120 id, address account) public view returns (bool) {
return authorizers[id].nonEnumerableAccounts[account];
}
/**
* @notice Check if a codehash is blacklisted in a specified list.
* @param id The id of the list.
* @param codehash The codehash to check.
* @return True if the codehash is blacklisted in the specified list, false otherwise.
*/
function isCodeHashBlacklisted(uint120 id, bytes32 codehash) public view returns (bool) {
return blacklists[id].nonEnumerableCodehashes[codehash];
}
/**
* @notice Check if a codehash is whitelisted in a specified list.
* @param id The id of the list.
* @param codehash The codehash to check.
* @return True if the codehash is whitelisted in the specified list, false otherwise.
*/
function isCodeHashWhitelisted(uint120 id, bytes32 codehash) public view returns (bool) {
return whitelists[id].nonEnumerableCodehashes[codehash];
}
/**
* @notice Get blacklisted accounts by collection.
* @param collection The address of the collection.
* @return An array of blacklisted accounts.
*/
function getBlacklistedAccountsByCollection(address collection) external view returns (address[] memory) {
return getBlacklistedAccounts(collectionSecurityPolicies[collection].listId);
}
/**
* @notice Get whitelisted accounts by collection.
* @param collection The address of the collection.
* @return An array of whitelisted accounts.
*/
function getWhitelistedAccountsByCollection(address collection) external view returns (address[] memory) {
return getWhitelistedAccounts(collectionSecurityPolicies[collection].listId);
}
/**
* @notice Get authorizer accounts by collection.
* @param collection The address of the collection.
* @return An array of authorizer accounts.
*/
function getAuthorizerAccountsByCollection(address collection) external view returns (address[] memory) {
return getAuthorizerAccounts(collectionSecurityPolicies[collection].listId);
}
/**
* @notice Get frozen accounts by collection.
* @param collection The address of the collection.
* @return An array of frozen accounts.
*/
function getFrozenAccountsByCollection(address collection) external view returns (address[] memory) {
return frozenAccounts[collection].enumerableAccounts.values();
}
/**
* @notice Get blacklisted codehashes by collection.
* @param collection The address of the collection.
* @return An array of blacklisted codehashes.
*/
function getBlacklistedCodeHashesByCollection(address collection) external view returns (bytes32[] memory) {
return getBlacklistedCodeHashes(collectionSecurityPolicies[collection].listId);
}
/**
* @notice Get whitelisted codehashes by collection.
* @param collection The address of the collection.
* @return An array of whitelisted codehashes.
*/
function getWhitelistedCodeHashesByCollection(address collection) external view returns (bytes32[] memory) {
return getWhitelistedCodeHashes(collectionSecurityPolicies[collection].listId);
}
/**
* @notice Check if an account is blacklisted by a specified collection.
* @param collection The address of the collection.
* @param account The address of the account to check.
* @return True if the account is blacklisted by the specified collection, false otherwise.
*/
function isAccountBlacklistedByCollection(address collection, address account) external view returns (bool) {
return isAccountBlacklisted(collectionSecurityPolicies[collection].listId, account);
}
/**
* @notice Check if an account is whitelisted by a specified collection.
* @param collection The address of the collection.
* @param account The address of the account to check.
* @return True if the account is whitelisted by the specified collection, false otherwise.
*/
function isAccountWhitelistedByCollection(address collection, address account) external view returns (bool) {
return isAccountWhitelisted(collectionSecurityPolicies[collection].listId, account);
}
/**
* @notice Check if an account is an authorizer of a specified collection.
* @param collection The address of the collection.
* @param account The address of the account to check.
* @return True if the account is an authorizer by the specified collection, false otherwise.
*/
function isAccountAuthorizerOfCollection(address collection, address account) external view returns (bool) {
return isAccountAuthorizer(collectionSecurityPolicies[collection].listId, account);
}
/**
* @notice Check if an account is frozen for a specified collection.
* @param collection The address of the collection.
* @param account The address of the account to check.
* @return True if the account is frozen by the specified collection, false otherwise.
*/
function isAccountFrozenForCollection(address collection, address account) external view returns (bool) {
return frozenAccounts[collection].nonEnumerableAccounts[account];
}
/**
* @notice Check if a codehash is blacklisted by a specified collection.
* @param collection The address of the collection.
* @param codehash The codehash to check.
* @return True if the codehash is blacklisted by the specified collection, false otherwise.
*/
function isCodeHashBlacklistedByCollection(address collection, bytes32 codehash) external view returns (bool) {
return isCodeHashBlacklisted(collectionSecurityPolicies[collection].listId, codehash);
}
/**
* @notice Check if a codehash is whitelisted by a specified collection.
* @param collection The address of the collection.
* @param codehash The codehash to check.
* @return True if the codehash is whitelisted by the specified collection, false otherwise.
*/
function isCodeHashWhitelistedByCollection(address collection, bytes32 codehash) external view returns (bool) {
return isCodeHashWhitelisted(collectionSecurityPolicies[collection].listId, codehash);
}
/// @notice Returns true if the specified account has verified a signature on the registry, false otherwise.
function isVerifiedEOA(address account) public view returns (bool) {
return IEOARegistry(_eoaRegistry).isVerifiedEOA(account);
}
/// @notice ERC-165 Interface Support
/// @dev Do not remove LEGACY from this contract or future contracts.
/// Doing so will break backwards compatibility with V1 and V2 creator tokens.
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
return
interfaceId == LEGACY_TRANSFER_VALIDATOR_INTERFACE_ID ||
interfaceId == type(ITransferValidator).interfaceId ||
interfaceId == type(IPermitC).interfaceId ||
interfaceId == type(IEOARegistry).interfaceId ||
super.supportsInterface(interfaceId);
}
/*************************************************************************/
/* HELPERS */
/*************************************************************************/
/**
* @notice Reverts the transaction if the caller is not the owner or assigned the default
* @notice admin role of the contract at `tokenAddress`.
*
* @dev Throws when the caller is neither owner nor assigned the default admin role.
*
* @param tokenAddress The contract address of the token to check permissions for.
*/
function _requireCallerIsNFTOrContractOwnerOrAdmin(address tokenAddress) internal view {
address caller = msg.sender;
if(caller == tokenAddress) {
return;
}
(address contractOwner,) = _safeOwner(tokenAddress);
if(caller == contractOwner) {
return;
}
(bool callerIsContractAdmin,) = _safeHasRole(tokenAddress, DEFAULT_ACCESS_CONTROL_ADMIN_ROLE, caller);
if(callerIsContractAdmin) {
return;
}
revert CreatorTokenTransferValidator__CallerMustHaveElevatedPermissionsForSpecifiedNFT();
}
/**
* @notice Copies all addresses in `ptrFromList` to `ptrToList`.
*
* @dev This function will copy all addresses from one list to another list.
* @dev Note: If used to copy adddresses to an existing list the current list contents will not be
* @dev deleted before copying. New addresses will be appeneded to the end of the list and the
* @dev non-enumerable mapping key value will be set to true.
*
* @dev <h4>Postconditions:</h4>
* 1. Addresses in from list that are not already present in to list are added to the to list.
* 2. Emits an `AddedAccountToList` event for each address copied to the list.
*
* @param listType The type of list addresses are being copied from and to.
* @param destinationListId The id of the list being copied to.
* @param ptrFromList The storage pointer for the list being copied from.
* @param ptrToList The storage pointer for the list being copied to.
*/
function _copyAddressSet(
uint8 listType,
uint120 destinationListId,
List storage ptrFromList,
List storage ptrToList
) private {
EnumerableSet.AddressSet storage ptrFromSet = ptrFromList.enumerableAccounts;
EnumerableSet.AddressSet storage ptrToSet = ptrToList.enumerableAccounts;
mapping (address => bool) storage ptrToNonEnumerableSet = ptrToList.nonEnumerableAccounts;
uint256 sourceLength = ptrFromSet.length();
address account;
for (uint256 i = 0; i < sourceLength;) {
account = ptrFromSet.at(i);
if (ptrToSet.add(account)) {
emit AddedAccountToList(listType, destinationListId, account);
ptrToNonEnumerableSet[account] = true;
}
unchecked {
++i;
}
}
}
/**
* @notice Copies all codehashes in `ptrFromList` to `ptrToList`.
*
* @dev This function will copy all codehashes from one list to another list.
* @dev Note: If used to copy codehashes to an existing list the current list contents will not be
* @dev deleted before copying. New codehashes will be appeneded to the end of the list and the
* @dev non-enumerable mapping key value will be set to true.
*
* @dev <h4>Postconditions:</h4>
* 1. Codehashes in from list that are not already present in to list are added to the to list.
* 2. Emits an `AddedCodeHashToList` event for each codehash copied to the list.
*
* @param listType The type of list codehashes are being copied from and to.
* @param destinationListId The id of the list being copied to.
* @param ptrFromList The storage pointer for the list being copied from.
* @param ptrToList The storage pointer for the list being copied to.
*/
function _copyBytes32Set(
uint8 listType,
uint120 destinationListId,
List storage ptrFromList,
List storage ptrToList
) private {
EnumerableSet.Bytes32Set storage ptrFromSet = ptrFromList.enumerableCodehashes;
EnumerableSet.Bytes32Set storage ptrToSet = ptrToList.enumerableCodehashes;
mapping (bytes32 => bool) storage ptrToNonEnumerableSet = ptrToList.nonEnumerableCodehashes;
uint256 sourceLength = ptrFromSet.length();
bytes32 codehash;
for (uint256 i = 0; i < sourceLength;) {
codehash = ptrFromSet.at(i);
if (ptrToSet.add(codehash)) {
emit AddedCodeHashToList(listType, destinationListId, codehash);
ptrToNonEnumerableSet[codehash] = true;
}
unchecked {
++i;
}
}
}
/**
* @notice Adds one or more accounts to a list.
*
* @dev <h4>Postconditions:</h4>
* 1. Accounts that were not previously in the list are added to the list.
* 2. An `AddedAccountToList` event is emitted for each account that was not
* previously on the list.
*
* @param list The storage pointer for the list to add accounts to.
* @param listType The type of list the accounts are being added to.
* @param id The id of the list the accounts are being added to.
* @param accounts An array of accounts to add to the list.
*/
function _addAccountsToList(
List storage list,
uint8 listType,
uint120 id,
address[] calldata accounts
) internal onlyListOwner(id) {
address account;
for (uint256 i = 0; i < accounts.length;) {
account = accounts[i];
if (list.enumerableAccounts.add(account)) {
emit AddedAccountToList(listType, id, account);
list.nonEnumerableAccounts[account] = true;
}
unchecked {
++i;
}
}
}
/**
* @notice Adds one or more codehashes to a list.
*
* @dev <h4>Postconditions:</h4>
* 1. Codehashes that were not previously in the list are added to the list.
* 2. An `AddedCodeHashToList` event is emitted for each codehash that was not
* previously on the list.
*
* @param list The storage pointer for the list to add codehashes to.
* @param listType The type of list the codehashes are being added to.
* @param id The id of the list the codehashes are being added to.
* @param codehashes An array of codehashes to add to the list.
*/
function _addCodeHashesToList(
List storage list,
uint8 listType,
uint120 id,
bytes32[] calldata codehashes
) internal onlyListOwner(id) {
bytes32 codehash;
for (uint256 i = 0; i < codehashes.length;) {
codehash = codehashes[i];
if (list.enumerableCodehashes.add(codehash)) {
emit AddedCodeHashToList(listType, id, codehash);
list.nonEnumerableCodehashes[codehash] = true;
}
unchecked {
++i;
}
}
}
/**
* @notice Removes one or more accounts from a list.
*
* @dev <h4>Postconditions:</h4>
* 1. Accounts that were previously in the list are removed from the list.
* 2. An `RemovedAccountFromList` event is emitted for each account that was
* previously on the list.
*
* @param list The storage pointer for the list to remove accounts from.
* @param listType The type of list the accounts are being removed from.
* @param id The id of the list the accounts are being removed from.
* @param accounts An array of accounts to remove from the list.
*/
function _removeAccountsFromList(
List storage list,
uint8 listType,
uint120 id,
address[] memory accounts
) internal onlyListOwner(id) {
address account;
for (uint256 i = 0; i < accounts.length;) {
account = accounts[i];
if (list.enumerableAccounts.remove(account)) {
emit RemovedAccountFromList(listType, id, account);
delete list.nonEnumerableAccounts[account];
}
unchecked {
++i;
}
}
}
/**
* @notice Removes one or more codehashes from a list.
*
* @dev <h4>Postconditions:</h4>
* 1. Codehashes that were previously in the list are removed from the list.
* 2. An `RemovedCodeHashFromList` event is emitted for each codehash that was
* previously on the list.
*
* @param list The storage pointer for the list to remove codehashes from.
* @param listType The type of list the codehashes are being removed from.
* @param id The id of the list the codehashes are being removed from.
* @param codehashes An array of codehashes to remove from the list.
*/
function _removeCodeHashesFromList(
List storage list,
uint8 listType,
uint120 id,
bytes32[] calldata codehashes
) internal onlyListOwner(id) {
bytes32 codehash;
for (uint256 i = 0; i < codehashes.length;) {
codehash = codehashes[i];
if (list.enumerableCodehashes.remove(codehash)) {
emit RemovedCodeHashFromList(listType, id, codehash);
delete list.nonEnumerableCodehashes[codehash];
}
unchecked {
++i;
}
}
}
/**
* @notice Sets the owner of list `id` to `newOwner`.
*
* @dev Throws when the caller is not the owner of the list.
*
* @dev <h4>Postconditions:</h4>
* 1. The owner of list `id` is set to `newOwner`.
* 2. Emits a `ReassignedListOwnership` event.
*
* @param id The id of the list to reassign ownership of.
* @param newOwner The account to assign ownership of the list to.
*/
function _reassignOwnershipOfList(uint120 id, address newOwner) private {
if (id == DEFAULT_LIST_ID && newOwner == address(0)) {
revert CreatorTokenTransferValidator__CannotReassignOwnershipOfDefaultList();
}
_requireCallerOwnsList(id);
listOwners[id] = newOwner;
emit ReassignedListOwnership(id, newOwner);
}
/**
* @notice Requires the caller to be the owner of list `id`.
*
* @dev Throws when the caller is not the owner of the list.
*
* @param id The id of the list to check ownership of.
*/
function _requireCallerOwnsList(uint120 id) private view {
if (msg.sender != listOwners[id]) {
revert CreatorTokenTransferValidator__CallerDoesNotOwnList();
}
}
/**
* @dev Internal function used to efficiently retrieve the code length of `account`.
*
* @param account The address to get the deployed code length for.
*
* @return length The length of deployed code at the address.
*/
function _getCodeLengthAsm(address account) internal view returns (uint256 length) {
assembly { length := extcodesize(account) }
}
/**
* @dev Internal function used to efficiently retrieve the codehash of `account`.
*
* @param account The address to get the deployed codehash for.
*
* @return codehash The codehash of the deployed code at the address.
*/
function _getCodeHashAsm(address account) internal view returns (bytes32 codehash) {
assembly { codehash := extcodehash(account) }
}
/**
* @dev Hook that is called before any permitted token transfer that goes through Permit-C.
* Applies the collection transfer policy, using the operator that called Permit-C as the caller.
* This allows creator token standard protections to extend to permitted transfers.
*
* @param token The collection address of the token being transferred.
* @param from The address of the token owner.
* @param to The address of the token receiver.
* @param id The token id being transferred.
*/
function _beforeTransferFrom(
uint256 tokenType,
address token,
address from,
address to,
uint256 id,
uint256 /*amount*/
) internal override returns (bool isError) {
(bytes4 selector, uint16 collectionTokenType) = _validateTransfer(_callerAuthorizedCheckToken, token, msg.sender, from, to, id);
if (collectionTokenType == DEFAULT_TOKEN_TYPE || collectionTokenType == tokenType) {
isError = SELECTOR_NO_ERROR != selector;
} else {
revert CreatorTokenTransferValidator__TokenTypesDoNotMatch();
}
}
/**
* @notice Apply the collection transfer policy to a transfer operation of a creator token.
*
* @dev If the caller is self (Permit-C Processor) it means we have already applied operator validation in the
* _beforeTransferFrom callback. In this case, the security policy was already applied and the operator
* that used the Permit-C processor passed the security policy check and transfer can be safely allowed.
*
* @dev The order of checking whitelisted accounts, authorized operator check and whitelisted codehashes
* is very deliberate. The order of operations is determined by the most frequently used settings that are
* expected in the wild.
*
* @dev Throws when the collection has enabled account freezing mode and either the `from` or `to` addresses
* are on the list of frozen accounts for the collection.
* @dev Throws when the collection is set to Level 9 - Soulbound Token.
* @dev Throws when the receiver has deployed code and isn't whitelisted, if ReceiverConstraints.NoCode is set
* and the transfer is not approved by an authorizer for the collection.
* @dev Throws when the receiver has never verified a signature to prove they are an EOA and the receiver
* isn't whitelisted, if the ReceiverConstraints.EOA is set and the transfer is not approved by an
* authorizer for the collection..
* @dev Throws when `msg.sender` is blacklisted, if CallerConstraints.OperatorBlacklistEnableOTC is set, unless
* `msg.sender` is also the `from` address or the transfer is approved by an authorizer for the collection.
* @dev Throws when `msg.sender` isn't whitelisted, if CallerConstraints.OperatorWhitelistEnableOTC is set, unless
* `msg.sender` is also the `from` address or the transfer is approved by an authorizer for the collection.
* @dev Throws when neither `msg.sender` nor `from` are whitelisted, if
* CallerConstraints.OperatorWhitelistDisableOTC is set and the transfer
* is not approved by an authorizer for the collection.
*
* @dev <h4>Postconditions:</h4>
* 1. Transfer is allowed or denied based on the applied transfer policy.
*
* @param collection The collection address of the token being transferred.
* @param caller The address initiating the transfer.
* @param from The address of the token owner.
* @param to The address of the token receiver.
* @param tokenId The token id being transferred.
*
* @return The selector value for an error if the transfer is not allowed, `SELECTOR_NO_ERROR` if the transfer is allowed.
*/
function _validateTransfer(
function(address,address,uint256) internal view returns(bool) _callerAuthorizedParam,
address collection,
address caller,
address from,
address to,
uint256 tokenId
) internal view returns (bytes4,uint16) {
if (caller == address(this)) {
// If the caller is self (Permit-C Processor) it means we have already applied operator validation in the
// _beforeTransferFrom callback. In this case, the security policy was already applied and the operator
// that used the Permit-C processor passed the security policy check and transfer can be safely allowed.
return (SELECTOR_NO_ERROR, DEFAULT_TOKEN_TYPE);
}
CollectionSecurityPolicyV3 storage collectionSecurityPolicy = collectionSecurityPolicies[collection];
uint120 listId = collectionSecurityPolicy.listId;
(uint256 callerConstraints, uint256 receiverConstraints) =
transferSecurityPolicies(collectionSecurityPolicy.transferSecurityLevel);
if (collectionSecurityPolicy.enableAccountFreezingMode) {
AccountList storage frozenAccountList = frozenAccounts[collection];
if (frozenAccountList.nonEnumerableAccounts[from]) {
return (CreatorTokenTransferValidator__SenderAccountIsFrozen.selector, DEFAULT_TOKEN_TYPE);
}
if (frozenAccountList.nonEnumerableAccounts[to]) {
return (CreatorTokenTransferValidator__ReceiverAccountIsFrozen.selector, DEFAULT_TOKEN_TYPE);
}
}
if (callerConstraints == CALLER_CONSTRAINTS_SBT) {
return (CreatorTokenTransferValidator__TokenIsSoulbound.selector, DEFAULT_TOKEN_TYPE);
}
List storage whitelist = whitelists[listId];
if (receiverConstraints == RECEIVER_CONSTRAINTS_NO_CODE) {
if (_getCodeLengthAsm(to) > 0) {
if (!whitelist.nonEnumerableAccounts[to]) {
// Cache _callerAuthorizedParam on stack to avoid stack too deep
function(address,address,uint256) internal view returns(bool) _callerAuthorized = _callerAuthorizedParam;
if(!_callerAuthorized(collection, caller, tokenId)) {
if (!whitelist.nonEnumerableCodehashes[_getCodeHashAsm(to)]) {
return (CreatorTokenTransferValidator__ReceiverMustNotHaveDeployedCode.selector, DEFAULT_TOKEN_TYPE);
}
}
}
}
} else if (receiverConstraints == RECEIVER_CONSTRAINTS_EOA) {
if (!isVerifiedEOA(to)) {
if (!whitelist.nonEnumerableAccounts[to]) {
// Cache _callerAuthorizedParam on stack to avoid stack too deep
function(address,address,uint256) internal view returns(bool) _callerAuthorized = _callerAuthorizedParam;
if(!_callerAuthorized(collection, caller, tokenId)) {
if (!whitelist.nonEnumerableCodehashes[_getCodeHashAsm(to)]) {
return (CreatorTokenTransferValidator__ReceiverProofOfEOASignatureUnverified.selector, DEFAULT_TOKEN_TYPE);
}
}
}
}
}
if (caller == from) {
if (callerConstraints != CALLER_CONSTRAINTS_OPERATOR_WHITELIST_DISABLE_OTC) {
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
}
if (callerConstraints == CALLER_CONSTRAINTS_OPERATOR_BLACKLIST_ENABLE_OTC) {
// Cache _callerAuthorizedParam on stack to avoid stack too deep
function(address,address,uint256) internal view returns(bool) _callerAuthorized = _callerAuthorizedParam;
if(_callerAuthorized(collection, caller, tokenId)) {
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
List storage blacklist = blacklists[listId];
if (blacklist.nonEnumerableAccounts[caller]) {
return (CreatorTokenTransferValidator__OperatorIsBlacklisted.selector, DEFAULT_TOKEN_TYPE);
}
if (blacklist.nonEnumerableCodehashes[_getCodeHashAsm(caller)]) {
return (CreatorTokenTransferValidator__OperatorIsBlacklisted.selector, DEFAULT_TOKEN_TYPE);
}
} else if (callerConstraints == CALLER_CONSTRAINTS_OPERATOR_WHITELIST_ENABLE_OTC) {
if (whitelist.nonEnumerableAccounts[caller]) {
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
// Cache _callerAuthorizedParam on stack to avoid stack too deep
function(address,address,uint256) internal view returns(bool) _callerAuthorized = _callerAuthorizedParam;
if( _callerAuthorized(collection, caller, tokenId)) {
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
if (whitelist.nonEnumerableCodehashes[_getCodeHashAsm(caller)]) {
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
return (CreatorTokenTransferValidator__CallerMustBeWhitelisted.selector, DEFAULT_TOKEN_TYPE);
} else if (callerConstraints == CALLER_CONSTRAINTS_OPERATOR_WHITELIST_DISABLE_OTC) {
mapping(address => bool) storage accountWhitelist = whitelist.nonEnumerableAccounts;
if (accountWhitelist[caller]) {
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
if (accountWhitelist[from]) {
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
// Cache _callerAuthorizedParam on stack to avoid stack too deep
function(address,address,uint256) internal view returns(bool) _callerAuthorized = _callerAuthorizedParam;
if(_callerAuthorized(collection, caller, tokenId)) {
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
mapping(bytes32 => bool) storage codehashWhitelist = whitelist.nonEnumerableCodehashes;
// Cache caller on stack to avoid stack too deep
address tmpAddress = caller;
if (codehashWhitelist[_getCodeHashAsm(tmpAddress)]) {
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
// Cache from on stack to avoid stack too deep
tmpAddress = from;
if (codehashWhitelist[_getCodeHashAsm(tmpAddress)]) {
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
return (CreatorTokenTransferValidator__CallerMustBeWhitelisted.selector, DEFAULT_TOKEN_TYPE);
}
return (SELECTOR_NO_ERROR, collectionSecurityPolicy.tokenType);
}
/**
* @dev Internal function used to efficiently revert with a custom error selector.
*
* @param errorSelector The error selector to revert with.
*/
function _revertCustomErrorSelectorAsm(bytes4 errorSelector) internal pure {
assembly {
mstore(0x00, errorSelector)
revert(0x00, 0x04)
}
}
/**
* @dev Internal function used to check if authorization mode can be activated for a transfer.
*
* @dev Throws when the collection has not enabled authorization mode.
* @dev Throws when the wildcard operator is being set for a collection that does not
* allow wildcard operators.
* @dev Throws when the authorizer is not in the list of approved authorizers for
* the collection.
*
* @param collection The collection address to activate authorization mode for a transfer.
* @param operator The operator specified by the authorizer to allow transfers.
* @param authorizer The address of the authorizer making the call.
*/
function _checkCollectionAllowsAuthorizerAndOperator(
address collection,
address operator,
address authorizer
) internal view {
CollectionSecurityPolicyV3 storage collectionSecurityPolicy = collectionSecurityPolicies[collection];
if (collectionSecurityPolicy.disableAuthorizationMode) {
revert CreatorTokenTransferValidator__AuthorizationDisabledForCollection();
}
if (collectionSecurityPolicy.authorizersCannotSetWildcardOperators) {
if (operator == WILDCARD_OPERATOR_ADDRESS) {
revert CreatorTokenTransferValidator__WildcardOperatorsCannotBeAuthorizedForCollection();
}
}
if (!authorizers[collectionSecurityPolicy.listId].nonEnumerableAccounts[authorizer]) {
revert CreatorTokenTransferValidator__CallerMustBeAnAuthorizer();
}
}
/**
* @dev Modifier to apply the allowed authorizer and operator for collection checks.
*
* @dev Throws when the collection has not enabled authorization mode.
* @dev Throws when the wildcard operator is being set for a collection that does not
* allow wildcard operators.
* @dev Throws when the authorizer is not in the list of approved authorizers for
* the collection.
*
* @param collection The collection address to activate authorization mode for a transfer.
* @param operator The operator specified by the authorizer to allow transfers.
* @param authorizer The address of the authorizer making the call.
*/
modifier whenAuthorizerAndOperatorEnabledForCollection(
address collection,
address operator,
address authorizer
) {
_checkCollectionAllowsAuthorizerAndOperator(collection, operator, authorizer);
_;
}
/**
* @dev Internal function for setting the authorized operator in storage for a token and collection.
*
* @param operator The allowed operator for an authorized transfer.
* @param collection The address of the collection that the operator is authorized for.
* @param tokenId The id of the token that is authorized.
* @param allowAnyTokenId Flag if the authorizer is enabling transfers for any token id
*/
function _setOperatorInTransientStorage(
address operator,
address collection,
uint256 tokenId,
bool allowAnyTokenId
) internal whenAuthorizerAndOperatorEnabledForCollection(collection, operator, msg.sender) {
_setTstorish(_getTransientOperatorSlot(collection), (allowAnyTokenId ? 1 << 255 : 0) | uint256(uint160(operator)));
_setTstorish(_getTransientOperatorSlot(collection, tokenId), uint256(uint160(operator)));
}
/**
* @dev Internal function to check if a caller is an authorized operator for the token being transferred.
*
* @param caller The caller of the token transfer.
* @param collection The collection address of the token being transferred.
* @param tokenId The id of the token being transferred.
*
* @return isAuthorized True if the caller is authorized to transfer the token, false otherwise.
*/
function _callerAuthorizedCheckToken(
address collection,
address caller,
uint256 tokenId
) internal view returns (bool isAuthorized) {
uint256 slotValue;
(isAuthorized, ) = _callerAuthorized(caller, _getTransientOperatorSlot(collection, tokenId));
if (isAuthorized) return true;
(isAuthorized, slotValue) = _callerAuthorized(caller, _getTransientOperatorSlot(collection));
isAuthorized = isAuthorized && slotValue >> 255 == 1;
}
/**
* @dev Internal function to check if a caller is an authorized operator for the collection being transferred.
*
* @param caller The caller of the token transfer.
* @param collection The collection address of the token being transferred.
*
* @return isAuthorized True if the caller is authorized to transfer the collection, false otherwise.
*/
function _callerAuthorizedCheckCollection(
address collection,
address caller,
uint256 /*tokenId*/
) internal view returns (bool isAuthorized) {
(isAuthorized, ) = _callerAuthorized(caller, _getTransientOperatorSlot(collection));
}
/**
* @dev Internal function to check if a caller is an authorized operator.
* @dev This overload of `_callerAuthorized` checks a specific storage slot for the caller address.
*
* @param caller The caller of the token transfer.
* @param slot The storage slot to check for the caller address.
*
* @return isAuthorized True if the caller is authorized to transfer the token, false otherwise.
* @return slotValue The transient storage value in `slot`, used to check for allow any token id flag if necessary.
*/
function _callerAuthorized(address caller, uint256 slot) internal view returns (bool isAuthorized, uint256 slotValue) {
slotValue = _getTstorish(slot);
address authorizedOperator = address(uint160(slotValue));
isAuthorized = authorizedOperator == WILDCARD_OPERATOR_ADDRESS || authorizedOperator == caller;
}
/**
* @dev Internal function used to compute the transient storage slot for the authorized
* operator of a token in a collection.
*
* @param collection The collection address of the token being transferred.
* @param tokenId The id of the token being transferred.
*
* @return operatorSlot The storage slot location for the authorized operator value.
*/
function _getTransientOperatorSlot(
address collection,
uint256 tokenId
) internal pure returns (uint256 operatorSlot) {
assembly {
mstore(0x00, collection)
mstore(0x20, tokenId)
operatorSlot := shr(4, keccak256(0x00, 0x40))
}
}
/**
* @dev Internal function used to compute the transient storage slot for the authorized operator of a collection.
*
* @param collection The collection address of the token being transferred.
*
* @return operatorSlot The storage slot location for the authorized operator value.
*/
function _getTransientOperatorSlot(address collection) internal pure returns (uint256 operatorSlot) {
assembly {
mstore(0x00, collection)
mstore(0x20, _transientOperatorSlotHolder.slot)
operatorSlot := keccak256(0x00, 0x40)
}
}
/**
* @dev A gas efficient, and fallback-safe way to call the owner function on a token contract.
* This will get the owner if it exists - and when the function is unimplemented, the
* presence of a fallback function will not result in halted execution.
*
* @param tokenAddress The address of the token collection to get the owner of.
*
* @return owner The owner of the token collection contract.
* @return isError True if there was an error in retrieving the owner, false if the call was successful.
*/
function _safeOwner(
address tokenAddress
) internal view returns(address owner, bool isError) {
assembly {
function _callOwner(_tokenAddress) -> _owner, _isError {
mstore(0x00, 0x8da5cb5b)
if and(iszero(lt(returndatasize(), 0x20)), staticcall(gas(), _tokenAddress, 0x1C, 0x04, 0x00, 0x20)) {
_owner := mload(0x00)
leave
}
_isError := true
}
owner, isError := _callOwner(tokenAddress)
}
}
/**
* @dev A gas efficient, and fallback-safe way to call the hasRole function on a token contract.
* This will check if the account `hasRole` if `hasRole` exists - and when the function is unimplemented, the
* presence of a fallback function will not result in halted execution.
*
* @param tokenAddress The address of the token collection to call hasRole on.
* @param role The role to check if the account has on the collection.
* @param account The address of the account to check if they have a specified role.
*
* @return hasRole The owner of the token collection contract.
* @return isError True if there was an error in retrieving the owner, false if the call was successful.
*/
function _safeHasRole(
address tokenAddress,
bytes32 role,
address account
) internal view returns(bool hasRole, bool isError) {
assembly {
function _callHasRole(_tokenAddress, _role, _account) -> _hasRole, _isError {
let ptr := mload(0x40)
mstore(0x40, add(ptr, 0x60))
mstore(ptr, 0x91d14854)
mstore(add(0x20, ptr), _role)
mstore(add(0x40, ptr), _account)
if and(iszero(lt(returndatasize(), 0x20)), staticcall(gas(), _tokenAddress, add(ptr, 0x1C), 0x44, 0x00, 0x20)) {
_hasRole := mload(0x00)
leave
}
_isError := true
}
hasRole, isError := _callHasRole(tokenAddress, role, account)
}
}
}// SPDX-License-Identifier: MIT pragma solidity 0.8.24; /** * @dev Constant definitions for receiver constraints used by the transfer validator. */ /// @dev No constraints on the receiver of a token. uint256 constant RECEIVER_CONSTRAINTS_NONE = 0; /// @dev Token receiver cannot have deployed code. uint256 constant RECEIVER_CONSTRAINTS_NO_CODE = 1; /// @dev Token receiver must be a verified EOA with the EOA Registry. uint256 constant RECEIVER_CONSTRAINTS_EOA = 2; /// @dev Token is a soulbound token and cannot be transferred. uint256 constant RECEIVER_CONSTRAINTS_SBT = 3; /** * @dev Constant definitions for caller constraints used by the transfer validator. */ /// @dev No constraints on the caller of a token transfer. uint256 constant CALLER_CONSTRAINTS_NONE = 0; /// @dev Caller of a token transfer must not be on the blacklist unless it is an OTC transfer. uint256 constant CALLER_CONSTRAINTS_OPERATOR_BLACKLIST_ENABLE_OTC = 1; /// @dev Caller of a token transfer must be on the whitelist unless it is an OTC transfer. uint256 constant CALLER_CONSTRAINTS_OPERATOR_WHITELIST_ENABLE_OTC = 2; /// @dev Caller of a token transfer must be on the whitelist. uint256 constant CALLER_CONSTRAINTS_OPERATOR_WHITELIST_DISABLE_OTC = 3; /// @dev Token is a soulbound token and cannot be transferred. uint256 constant CALLER_CONSTRAINTS_SBT = 4; /** * @dev Constant definitions for transfer security levels used by the transfer validator * to define what receiver and caller constraints are applied to a transfer. */ /// @dev Recommend Security Level - /// Caller Constraints: Operator Whitelist /// Receiver Constraints: None /// OTC: Allowed uint8 constant TRANSFER_SECURITY_LEVEL_RECOMMENDED = 0; /// @dev Security Level One - /// Caller Constraints: None /// Receiver Constraints: None /// OTC: Allowed uint8 constant TRANSFER_SECURITY_LEVEL_ONE = 1; /// @dev Security Level Two - /// Caller Constraints: Operator Blacklist /// Receiver Constraints: None /// OTC: Allowed uint8 constant TRANSFER_SECURITY_LEVEL_TWO = 2; /// @dev Security Level Three - /// Caller Constraints: Operator Whitelist /// Receiver Constraints: None /// OTC: Allowed uint8 constant TRANSFER_SECURITY_LEVEL_THREE = 3; /// @dev Security Level Four - /// Caller Constraints: Operator Whitelist /// Receiver Constraints: None /// OTC: Not Allowed uint8 constant TRANSFER_SECURITY_LEVEL_FOUR = 4; /// @dev Security Level Five - /// Caller Constraints: Operator Whitelist /// Receiver Constraints: No Code /// OTC: Allowed uint8 constant TRANSFER_SECURITY_LEVEL_FIVE = 5; /// @dev Security Level Six - /// Caller Constraints: Operator Whitelist /// Receiver Constraints: Verified EOA /// OTC: Allowed uint8 constant TRANSFER_SECURITY_LEVEL_SIX = 6; /// @dev Security Level Seven - /// Caller Constraints: Operator Whitelist /// Receiver Constraints: No Code /// OTC: Not Allowed uint8 constant TRANSFER_SECURITY_LEVEL_SEVEN = 7; /// @dev Security Level Eight - /// Caller Constraints: Operator Whitelist /// Receiver Constraints: Verified EOA /// OTC: Not Allowed uint8 constant TRANSFER_SECURITY_LEVEL_EIGHT = 8; /// @dev Security Level Nine - /// Soulbound Token, No Transfers Allowed uint8 constant TRANSFER_SECURITY_LEVEL_NINE = 9; /// @dev List type is a blacklist. uint8 constant LIST_TYPE_BLACKLIST = 0; /// @dev List type is a whitelist. uint8 constant LIST_TYPE_WHITELIST = 1; /// @dev List type is authorizers. uint8 constant LIST_TYPE_AUTHORIZERS = 2; /// @dev Constant value for the no error selector. bytes4 constant SELECTOR_NO_ERROR = bytes4(0x00000000); /// @dev Constant value for the default validator list ID. uint120 constant DEFAULT_LIST_ID = 0;
// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;
struct CollectionSecurityPolicyV3 {
bool disableAuthorizationMode;
bool authorizersCannotSetWildcardOperators;
uint8 transferSecurityLevel;
uint120 listId;
bool enableAccountFreezingMode;
uint16 tokenType;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
/**
* @title ZkTstorish
*/
abstract contract ZkTstorish {
function _setTstorish(uint256 storageSlot, uint256 value) internal {
assembly {
tstore(storageSlot, value)
}
}
function _getTstorish(
uint256 storageSlot
) internal view returns (uint256 value) {
assembly {
value := tload(storageSlot)
}
}
function _clearTstorish(uint256 storageSlot) internal {
assembly {
tstore(storageSlot, 0)
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import "./Errors.sol";
import {IERC20} from "@openzeppelin/contracts/interfaces/IERC20.sol";
import {IERC721} from "@openzeppelin/contracts/interfaces/IERC721.sol";
import {IERC1155} from "@openzeppelin/contracts/interfaces/IERC1155.sol";
import {IERC1271} from "@openzeppelin/contracts/interfaces/IERC1271.sol";
import {Ownable} from "./openzeppelin-optimized/Ownable.sol";
import {EIP712} from "./openzeppelin-optimized/EIP712.sol";
import {
ZERO_BYTES32,
ZERO,
ONE,
ORDER_STATE_OPEN,
ORDER_STATE_FILLED,
ORDER_STATE_CANCELLED,
SINGLE_USE_PERMIT_TRANSFER_ADVANCED_TYPEHASH_STUB,
PERMIT_ORDER_ADVANCED_TYPEHASH_STUB,
UPPER_BIT_MASK,
TOKEN_TYPE_ERC1155,
TOKEN_TYPE_ERC20,
TOKEN_TYPE_ERC721,
PAUSABLE_APPROVAL_TRANSFER_FROM_ERC721,
PAUSABLE_APPROVAL_TRANSFER_FROM_ERC1155,
PAUSABLE_APPROVAL_TRANSFER_FROM_ERC20,
PAUSABLE_PERMITTED_TRANSFER_FROM_ERC721,
PAUSABLE_PERMITTED_TRANSFER_FROM_ERC1155,
PAUSABLE_PERMITTED_TRANSFER_FROM_ERC20,
PAUSABLE_ORDER_TRANSFER_FROM_ERC1155,
PAUSABLE_ORDER_TRANSFER_FROM_ERC20
} from "./Constants.sol";
import {PackedApproval, OrderFillAmounts} from "./DataTypes.sol";
import {PermitHash} from './libraries/PermitHash.sol';
import {IPermitC} from './interfaces/IPermitC.sol';
import {CollateralizedPausableFlags} from './CollateralizedPausableFlags.sol';
/*
@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@(
@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@
#@@@@@@@@@@@@@@
@@@@@@@@@@@@
@@@@@@@@@@@@@@* @@@@@@@@@@@@
@@@@@@@@@@@@@@@ @ @@@@@@@@@@@@
@@@@@@@@@@@@@@@ @ @@@@@@@@@@@
@@@@@@@@@@@@@@@ @@ @@@@@@@@@@@@
@@@@@@@@@@@@@@@ #@@ @@@@@@@@@@@@/
@@@@@@@@@@@@@@. @@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@&%%%%%%%%&&@@@@@@@@@@@@@@
@@@@@@@@@@@@@@ @@@@@ @@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@ @@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@ @@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@ @@@@@@@@@@@&
@@@@@@@@@@@@@@ *@@@@@@@ (@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
.@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@% @@@@@@@@@@@@@@@@@@@@@@@@(
@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@&
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
* @title PermitC
* @custom:version 1.0.0
* @author Limit Break, Inc.
* @description Advanced approval management for ERC20, ERC721 and ERC1155 tokens
* allowing for single use permit transfers, time-bound approvals
* and order ID based transfers.
*/
contract PermitC is Ownable, CollateralizedPausableFlags, EIP712, IPermitC {
/**
* @notice Map of approval details for the provided bytes32 hash to allow for multiple accessors
*
* @dev keccak256(abi.encode(owner, tokenType, token, id, orderId, masterNonce)) =>
* @dev operator => (state, amount, expiration)
* @dev Utilized for stored approvals by an owner's direct call to `approve` and
* @dev approvals by signature in `updateApprovalBySignature`. Both methods use a
* @dev bytes32(0) value for the `orderId`.
*/
mapping(bytes32 => mapping(address => PackedApproval)) private _transferApprovals;
/**
* @notice Map of approval details for the provided bytes32 hash to allow for multiple accessors
*
* @dev keccak256(abi.encode(owner, tokenType, token, id, orderId, masterNonce)) =>
* @dev operator => (state, amount, expiration)
* @dev Utilized for order approvals by `fillPermittedOrderERC20` and `fillPermittedOrderERC1155`
* @dev with the `orderId` provided by the sender.
*/
mapping(bytes32 => mapping(address => PackedApproval)) private _orderApprovals;
/**
* @notice Map of registered additional data hashes for transfer permits.
*
* @dev This is used to prevent someone from providing an invalid EIP712 envelope label
* @dev and tricking a user into signing a different message than they expect.
*/
mapping(bytes32 => bool) private _registeredTransferHashes;
/**
* @notice Map of registered additional data hashes for order permits.
*
* @dev This is used to prevent someone from providing an invalid EIP712 envelope label
* @dev and tricking a user into signing a different message than they expect.
*/
mapping(bytes32 => bool) private _registeredOrderHashes;
/// @dev Map of an address to a bitmap (slot => status)
mapping(address => mapping(uint256 => uint256)) private _unorderedNonces;
/**
* @notice Master nonce used to invalidate all outstanding approvals for an owner
*
* @dev owner => masterNonce
* @dev This is incremented when the owner calls lockdown()
*/
mapping(address => uint256) private _masterNonces;
constructor(
string memory name,
string memory version,
address _defaultContractOwner,
uint256 _nativeValueToCheckPauseState
) CollateralizedPausableFlags(_nativeValueToCheckPauseState) EIP712(name, version) {
_transferOwnership(_defaultContractOwner);
}
/**
* =================================================
* ================= Modifiers =====================
* =================================================
*/
modifier onlyRegisteredTransferAdvancedTypeHash(bytes32 advancedPermitHash) {
_requireTransferAdvancedPermitHashIsRegistered(advancedPermitHash);
_;
}
modifier onlyRegisteredOrderAdvancedTypeHash(bytes32 advancedPermitHash) {
_requireOrderAdvancedPermitHashIsRegistered(advancedPermitHash);
_;
}
/**
* =================================================
* ============== Approval Transfers ===============
* =================================================
*/
/**
* @notice Approve an operator to spend a specific token / ID combination
* @notice This function is compatible with ERC20, ERC721 and ERC1155
* @notice To give unlimited approval for ERC20 and ERC1155, set amount to type(uint200).max
* @notice When approving an ERC721, you MUST set amount to `1`
* @notice When approving an ERC20, you MUST set id to `0`
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Updates the approval for an operator to use an amount of a specific token / ID combination
* @dev 2. If the expiration is 0, the approval is valid only in the context of the current block
* @dev 3. If the expiration is not 0, the approval is valid until the expiration timestamp
* @dev 4. If the provided amount is type(uint200).max, the approval is unlimited
*
* @param tokenType The type of token being approved - must be 20, 721 or 1155.
* @param token The address of the token contract
* @param id The token ID
* @param operator The address of the operator
* @param amount The amount of tokens to approve
* @param expiration The expiration timestamp of the approval
*/
function approve(
uint256 tokenType,
address token,
uint256 id,
address operator,
uint200 amount,
uint48 expiration
) external {
_requireValidTokenType(tokenType);
_storeApproval(tokenType, token, id, amount, expiration, msg.sender, operator);
}
/**
* @notice Use a signed permit to increase the allowance for a provided operator
* @notice This function is compatible with ERC20, ERC721 and ERC1155
* @notice To give unlimited approval for ERC20 and ERC1155, set amount to type(uint200).max
* @notice When approving an ERC721, you MUST set amount to `1`
* @notice When approving an ERC20, you MUST set id to `0`
* @notice An `approvalExpiration` of zero is considered an atomic permit which will use the
* @notice current block time as the expiration time when storing the permit data.
*
* @dev - Throws if the permit has expired
* @dev - Throws if the permit's nonce has already been used
* @dev - Throws if the permit signature is does not recover to the provided owner
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Updates the approval for an operator to use an amount of a specific token / ID combination
* @dev 3. Sets the expiration of the approval to the expiration timestamp of the permit
* @dev 4. If the provided amount is type(uint200).max, the approval is unlimited
*
* @param tokenType The type of token being approved - must be 20, 721 or 1155.
* @param token Address of the token to approve
* @param id The token ID
* @param nonce The nonce of the permit
* @param amount The amount of tokens to approve
* @param operator The address of the operator
* @param approvalExpiration The expiration timestamp of the approval
* @param sigDeadline The deadline timestamp for the permit signature
* @param owner The owner of the tokens
* @param signedPermit The permit signature, signed by the owner
*/
function updateApprovalBySignature(
uint256 tokenType,
address token,
uint256 id,
uint256 nonce,
uint200 amount,
address operator,
uint48 approvalExpiration,
uint48 sigDeadline,
address owner,
bytes calldata signedPermit
) external {
if (block.timestamp > sigDeadline) {
revert PermitC__ApprovalTransferPermitExpiredOrUnset();
}
_requireValidTokenType(tokenType);
_checkAndInvalidateNonce(owner, nonce);
_verifyPermitSignature(
_hashTypedDataV4(
PermitHash.hashOnChainApproval(
tokenType,
token,
id,
amount,
nonce,
operator,
approvalExpiration,
sigDeadline,
_masterNonces[owner]
)
),
signedPermit,
owner
);
// Expiration of zero is considered an atomic permit which is only valid in the
// current block.
approvalExpiration = approvalExpiration == 0 ? uint48(block.timestamp) : approvalExpiration;
_storeApproval(tokenType, token, id, amount, approvalExpiration, owner, operator);
}
/**
* @notice Returns the amount of allowance an operator has and it's expiration for a specific token and id
* @notice If the expiration on the allowance has expired, returns 0
* @notice To retrieve allowance for ERC20, set id to `0`
*
* @param owner The owner of the token
* @param operator The operator of the token
* @param tokenType The type of token the allowance is for
* @param token The address of the token contract
* @param id The token ID
*
* @return allowedAmount The amount of allowance the operator has
* @return expiration The expiration timestamp of the allowance
*/
function allowance(
address owner,
address operator,
uint256 tokenType,
address token,
uint256 id
) external view returns (uint256 allowedAmount, uint256 expiration) {
return _allowance(_transferApprovals, owner, operator, tokenType, token, id, ZERO_BYTES32);
}
/**
* =================================================
* ================ Signed Transfers ===============
* =================================================
*/
/**
* @notice Registers the combination of a provided string with the `SINGLE_USE_PERMIT_TRANSFER_ADVANCED_TYPEHASH_STUB`
* @notice and `PERMIT_ORDER_ADVANCED_TYPEHASH_STUB` to create valid additional data hashes
*
* @dev This function prevents malicious actors from changing the label of the EIP712 hash
* @dev to a value that would fool an external user into signing a different message.
*
* @dev <h4>Postconditions:</h4>
* @dev 1. The provided string is combined with the `SINGLE_USE_PERMIT_TRANSFER_ADVANCED_TYPEHASH_STUB` string
* @dev 2. The combined string is hashed using keccak256
* @dev 3. The resulting hash is added to the `_registeredTransferHashes` mapping
* @dev 4. The provided string is combined with the `PERMIT_ORDER_ADVANCED_TYPEHASH_STUB` string
* @dev 5. The combined string is hashed using keccak256
* @dev 6. The resulting hash is added to the `_registeredOrderHashes` mapping
*
* @param additionalDataTypeString The string to register as a valid additional data hash
*/
function registerAdditionalDataHash(string calldata additionalDataTypeString) external {
_registeredTransferHashes[
keccak256(
bytes(
string.concat(
SINGLE_USE_PERMIT_TRANSFER_ADVANCED_TYPEHASH_STUB,
additionalDataTypeString
)
)
)
] = true;
_registeredOrderHashes[
keccak256(
bytes(
string.concat(
PERMIT_ORDER_ADVANCED_TYPEHASH_STUB,
additionalDataTypeString
)
)
)
] = true;
}
/**
* @notice Transfer an ERC721 token from the owner to the recipient using a permit signature.
*
* @dev Be advised that the permitted amount for ERC721 is always inferred to be 1, so signed permitted amount
* @dev MUST always be set to 1.
*
* @dev - Throws if the permit is expired
* @dev - Throws if the nonce has already been used
* @dev - Throws if the permit is not signed by the owner
* @dev - Throws if the requested amount exceeds the permitted amount
* @dev - Throws if the provided token address does not implement ERC721 transferFrom function
* @dev - Returns `false` if the transfer fails
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token from the owner to the recipient
* @dev 2. The nonce of the permit is marked as used
* @dev 3. Performs any additional checks in the before and after hooks
*
* @param token The address of the token
* @param id The ID of the token
* @param nonce The nonce of the permit
* @param expiration The expiration timestamp of the permit
* @param owner The owner of the token
* @param to The address to transfer the tokens to
* @param signedPermit The permit signature, signed by the owner
*
* @return isError True if the transfer failed, false otherwise
*/
function permitTransferFromERC721(
address token,
uint256 id,
uint256 nonce,
uint256 expiration,
address owner,
address to,
bytes calldata signedPermit
) external returns (bool isError) {
_requireNotPaused(PAUSABLE_PERMITTED_TRANSFER_FROM_ERC721);
_checkPermitApproval(TOKEN_TYPE_ERC721, token, id, ONE, nonce, expiration, owner, ONE, signedPermit);
isError = _transferFromERC721(owner, to, token, id);
if (isError) {
_restoreNonce(owner, nonce);
}
}
/**
* @notice Transfers an ERC721 token from the owner to the recipient using a permit signature
* @notice This function includes additional data to verify on the signature, allowing
* @notice protocols to extend the validation in one function call. NOTE: before calling this
* @notice function you MUST register the stub end of the additional data typestring using
* @notice the `registerAdditionalDataHash` function.
*
* @dev Be advised that the permitted amount for ERC721 is always inferred to be 1, so signed permitted amount
* @dev MUST always be set to 1.
*
* @dev - Throws for any reason permitTransferFromERC721 would.
* @dev - Throws if the additional data does not match the signature
* @dev - Throws if the provided hash has not been registered as a valid additional data hash
* @dev - Throws if the provided hash does not match the provided additional data
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token from the owner to the recipient
* @dev 2. Performs any additional checks in the before and after hooks
* @dev 3. The nonce of the permit is marked as used
*
* @param token The address of the token
* @param id The ID of the token
* @param nonce The nonce of the permit
* @param expiration The expiration timestamp of the permit
* @param owner The owner of the token
* @param to The address to transfer the tokens to
* @param additionalData The additional data to verify on the signature
* @param advancedPermitHash The hash of the additional data
* @param signedPermit The permit signature, signed by the owner
*
* @return isError True if the transfer failed, false otherwise
*/
function permitTransferFromWithAdditionalDataERC721(
address token,
uint256 id,
uint256 nonce,
uint256 expiration,
address owner,
address to,
bytes32 additionalData,
bytes32 advancedPermitHash,
bytes calldata signedPermit
) external onlyRegisteredTransferAdvancedTypeHash(advancedPermitHash) returns (bool isError) {
_requireNotPaused(PAUSABLE_PERMITTED_TRANSFER_FROM_ERC721);
_checkPermitApprovalWithAdditionalDataERC721(
token,
id,
ONE,
nonce,
expiration,
owner,
ONE,
signedPermit,
additionalData,
advancedPermitHash
);
isError = _transferFromERC721(owner, to, token, id);
if (isError) {
_restoreNonce(owner, nonce);
}
}
/**
* @notice Transfer an ERC1155 token from the owner to the recipient using a permit signature
*
* @dev - Throws if the permit is expired
* @dev - Throws if the nonce has already been used
* @dev - Throws if the permit is not signed by the owner
* @dev - Throws if the requested amount exceeds the permitted amount
* @dev - Throws if the provided token address does not implement ERC1155 safeTransferFrom function
* @dev - Returns `false` if the transfer fails
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token (in the requested amount) from the owner to the recipient
* @dev 2. The nonce of the permit is marked as used
* @dev 3. Performs any additional checks in the before and after hooks
*
* @param token The address of the token
* @param id The ID of the token
* @param nonce The nonce of the permit
* @param permitAmount The amount of tokens permitted by the owner
* @param expiration The expiration timestamp of the permit
* @param owner The owner of the token
* @param to The address to transfer the tokens to
* @param transferAmount The amount of tokens to transfer
* @param signedPermit The permit signature, signed by the owner
*
* @return isError True if the transfer failed, false otherwise
*/
function permitTransferFromERC1155(
address token,
uint256 id,
uint256 nonce,
uint256 permitAmount,
uint256 expiration,
address owner,
address to,
uint256 transferAmount,
bytes calldata signedPermit
) external returns (bool isError) {
_requireNotPaused(PAUSABLE_PERMITTED_TRANSFER_FROM_ERC1155);
_checkPermitApproval(TOKEN_TYPE_ERC1155, token, id, permitAmount, nonce, expiration, owner, transferAmount, signedPermit);
isError = _transferFromERC1155(token, owner, to, id, transferAmount);
if (isError) {
_restoreNonce(owner, nonce);
}
}
/**
* @notice Transfers a token from the owner to the recipient using a permit signature
* @notice This function includes additional data to verify on the signature, allowing
* @notice protocols to extend the validation in one function call. NOTE: before calling this
* @notice function you MUST register the stub end of the additional data typestring using
* @notice the `registerAdditionalDataHash` function.
*
* @dev - Throws for any reason permitTransferFrom would.
* @dev - Throws if the additional data does not match the signature
* @dev - Throws if the provided hash has not been registered as a valid additional data hash
* @dev - Throws if the provided hash does not match the provided additional data
* @dev - Throws if the provided hash has not been registered as a valid additional data hash
* @dev - Returns `false` if the transfer fails
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token (in the requested amount) from the owner to the recipient
* @dev 2. Performs any additional checks in the before and after hooks
* @dev 3. The nonce of the permit is marked as used
*
* @param token The address of the token
* @param id The ID of the token
* @param nonce The nonce of the permit
* @param permitAmount The amount of tokens permitted by the owner
* @param expiration The expiration timestamp of the permit
* @param owner The owner of the token
* @param to The address to transfer the tokens to
* @param transferAmount The amount of tokens to transfer
* @param additionalData The additional data to verify on the signature
* @param advancedPermitHash The hash of the additional data
* @param signedPermit The permit signature, signed by the owner
*
* @return isError True if the transfer failed, false otherwise
*/
function permitTransferFromWithAdditionalDataERC1155(
address token,
uint256 id,
uint256 nonce,
uint256 permitAmount,
uint256 expiration,
address owner,
address to,
uint256 transferAmount,
bytes32 additionalData,
bytes32 advancedPermitHash,
bytes calldata signedPermit
) external onlyRegisteredTransferAdvancedTypeHash(advancedPermitHash) returns (bool isError) {
_requireNotPaused(PAUSABLE_PERMITTED_TRANSFER_FROM_ERC1155);
_checkPermitApprovalWithAdditionalDataERC1155(
token,
id,
permitAmount,
nonce,
expiration,
owner,
transferAmount,
signedPermit,
additionalData,
advancedPermitHash
);
// copy id to top of stack to avoid stack too deep
uint256 tmpId = id;
isError = _transferFromERC1155(token, owner, to, tmpId, transferAmount);
if (isError) {
_restoreNonce(owner, nonce);
}
}
/**
* @notice Transfer an ERC20 token from the owner to the recipient using a permit signature.
*
* @dev Be advised that the token ID for ERC20 is always inferred to be 0, so signed token ID
* @dev MUST always be set to 0.
*
* @dev - Throws if the permit is expired
* @dev - Throws if the nonce has already been used
* @dev - Throws if the permit is not signed by the owner
* @dev - Throws if the requested amount exceeds the permitted amount
* @dev - Throws if the provided token address does not implement ERC20 transferFrom function
* @dev - Returns `false` if the transfer fails
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token in the requested amount from the owner to the recipient
* @dev 2. The nonce of the permit is marked as used
* @dev 3. Performs any additional checks in the before and after hooks
*
* @param token The address of the token
* @param nonce The nonce of the permit
* @param permitAmount The amount of tokens permitted by the owner
* @param expiration The expiration timestamp of the permit
* @param owner The owner of the token
* @param to The address to transfer the tokens to
* @param signedPermit The permit signature, signed by the owner
*
* @return isError True if the transfer failed, false otherwise
*/
function permitTransferFromERC20(
address token,
uint256 nonce,
uint256 permitAmount,
uint256 expiration,
address owner,
address to,
uint256 transferAmount,
bytes calldata signedPermit
) external returns (bool isError) {
_requireNotPaused(PAUSABLE_PERMITTED_TRANSFER_FROM_ERC20);
_checkPermitApproval(TOKEN_TYPE_ERC20, token, ZERO, permitAmount, nonce, expiration, owner, transferAmount, signedPermit);
isError = _transferFromERC20(token, owner, to, ZERO, transferAmount);
if (isError) {
_restoreNonce(owner, nonce);
}
}
/**
* @notice Transfers an ERC20 token from the owner to the recipient using a permit signature
* @notice This function includes additional data to verify on the signature, allowing
* @notice protocols to extend the validation in one function call. NOTE: before calling this
* @notice function you MUST register the stub end of the additional data typestring using
* @notice the `registerAdditionalDataHash` function.
*
* @dev Be advised that the token ID for ERC20 is always inferred to be 0, so signed token ID
* @dev MUST always be set to 0.
*
* @dev - Throws for any reason permitTransferFromERC20 would.
* @dev - Throws if the additional data does not match the signature
* @dev - Throws if the provided hash has not been registered as a valid additional data hash
* @dev - Throws if the provided hash does not match the provided additional data
* @dev - Returns `false` if the transfer fails
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token (in the requested amount) from the owner to the recipient
* @dev 2. Performs any additional checks in the before and after hooks
* @dev 3. The nonce of the permit is marked as used
*
* @param token The address of the token
* @param nonce The nonce of the permit
* @param permitAmount The amount of tokens permitted by the owner
* @param expiration The expiration timestamp of the permit
* @param owner The owner of the token
* @param to The address to transfer the tokens to
* @param transferAmount The amount of tokens to transfer
* @param additionalData The additional data to verify on the signature
* @param advancedPermitHash The hash of the additional data
* @param signedPermit The permit signature, signed by the owner
*
* @return isError True if the transfer failed, false otherwise
*/
function permitTransferFromWithAdditionalDataERC20(
address token,
uint256 nonce,
uint256 permitAmount,
uint256 expiration,
address owner,
address to,
uint256 transferAmount,
bytes32 additionalData,
bytes32 advancedPermitHash,
bytes calldata signedPermit
) external onlyRegisteredTransferAdvancedTypeHash(advancedPermitHash) returns (bool isError) {
_requireNotPaused(PAUSABLE_PERMITTED_TRANSFER_FROM_ERC20);
_checkPermitApprovalWithAdditionalDataERC20(
token,
ZERO,
permitAmount,
nonce,
expiration,
owner,
transferAmount,
signedPermit,
additionalData,
advancedPermitHash
);
isError = _transferFromERC20(token, owner, to, ZERO, transferAmount);
if (isError) {
_restoreNonce(owner, nonce);
}
}
/**
* @notice Returns true if the provided hash has been registered as a valid additional data hash for transfers.
*
* @param hash The hash to check
*
* @return isRegistered true if the hash is valid, false otherwise
*/
function isRegisteredTransferAdditionalDataHash(bytes32 hash) external view returns (bool isRegistered) {
isRegistered = _registeredTransferHashes[hash];
}
/**
* @notice Returns true if the provided hash has been registered as a valid additional data hash for orders.
*
* @param hash The hash to check
*
* @return isRegistered true if the hash is valid, false otherwise
*/
function isRegisteredOrderAdditionalDataHash(bytes32 hash) external view returns (bool isRegistered) {
isRegistered = _registeredOrderHashes[hash];
}
/**
* =================================================
* =============== Order Transfers =================
* =================================================
*/
/**
* @notice Transfers an ERC1155 token from the owner to the recipient using a permit signature
* @notice Order transfers are used to transfer a specific amount of a token from a specific order
* @notice and allow for multiple uses of the same permit up to the allocated amount. NOTE: before calling this
* @notice function you MUST register the stub end of the additional data typestring using
* @notice the `registerAdditionalDataHash` function.
*
* @dev - Throws if the permit is expired
* @dev - Throws if the permit is not signed by the owner
* @dev - Throws if the requested amount + amount already filled exceeds the permitted amount
* @dev - Throws if the requested amount is less than the minimum fill amount
* @dev - Throws if the provided token address does not implement ERC1155 safeTransferFrom function
* @dev - Throws if the provided advanced permit hash has not been registered
* @dev - Returns `false` if the transfer fails
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token (in the requested amount) from the owner to the recipient
* @dev 2. Updates the amount filled for the order ID
* @dev 3. If completely filled, marks the order as filled
*
* @param signedPermit The permit signature, signed by the owner
* @param orderFillAmounts The amount of tokens to transfer
* @param token The address of the token
* @param id The ID of the token
* @param owner The owner of the token
* @param to The address to transfer the tokens to
* @param salt The salt of the permit
* @param expiration The expiration timestamp of the permit
* @param orderId The order ID
* @param advancedPermitHash The hash of the additional data
*
* @return quantityFilled The amount of tokens filled
* @return isError True if the transfer failed, false otherwise
*/
function fillPermittedOrderERC1155(
bytes calldata signedPermit,
OrderFillAmounts calldata orderFillAmounts,
address token,
uint256 id,
address owner,
address to,
uint256 salt,
uint48 expiration,
bytes32 orderId,
bytes32 advancedPermitHash
) external onlyRegisteredOrderAdvancedTypeHash(advancedPermitHash) returns (uint256 quantityFilled, bool isError) {
_requireNotPaused(PAUSABLE_ORDER_TRANSFER_FROM_ERC1155);
PackedApproval storage orderStatus = _checkOrderTransferERC1155(
signedPermit,
orderFillAmounts,
token,
id,
owner,
salt,
expiration,
orderId,
advancedPermitHash
);
(
quantityFilled,
isError
) = _orderTransfer(
orderStatus,
orderFillAmounts,
token,
id,
owner,
to,
orderId,
_transferFromERC1155
);
if (isError) {
_restoreFillableItems(orderStatus, owner, orderId, quantityFilled, true);
}
}
/**
* @notice Transfers an ERC20 token from the owner to the recipient using a permit signature
* @notice Order transfers are used to transfer a specific amount of a token from a specific order
* @notice and allow for multiple uses of the same permit up to the allocated amount. NOTE: before calling this
* @notice function you MUST register the stub end of the additional data typestring using
* @notice the `registerAdditionalDataHash` function.
*
* @dev - Throws if the permit is expired
* @dev - Throws if the permit is not signed by the owner
* @dev - Throws if the requested amount + amount already filled exceeds the permitted amount
* @dev - Throws if the requested amount is less than the minimum fill amount
* @dev - Throws if the provided token address does not implement ERC20 transferFrom function
* @dev - Throws if the provided advanced permit hash has not been registered
* @dev - Returns `false` if the transfer fails
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token (in the requested amount) from the owner to the recipient
* @dev 2. Updates the amount filled for the order ID
* @dev 3. If completely filled, marks the order as filled
*
* @param signedPermit The permit signature, signed by the owner
* @param orderFillAmounts The amount of tokens to transfer
* @param token The address of the token
* @param owner The owner of the token
* @param to The address to transfer the tokens to
* @param salt The salt of the permit
* @param expiration The expiration timestamp of the permit
* @param orderId The order ID
* @param advancedPermitHash The hash of the additional data
*
* @return quantityFilled The amount of tokens filled
* @return isError True if the transfer failed, false otherwise
*/
function fillPermittedOrderERC20(
bytes calldata signedPermit,
OrderFillAmounts calldata orderFillAmounts,
address token,
address owner,
address to,
uint256 salt,
uint48 expiration,
bytes32 orderId,
bytes32 advancedPermitHash
) external onlyRegisteredOrderAdvancedTypeHash(advancedPermitHash) returns (uint256 quantityFilled, bool isError) {
_requireNotPaused(PAUSABLE_ORDER_TRANSFER_FROM_ERC20);
PackedApproval storage orderStatus = _checkOrderTransferERC20(
signedPermit,
orderFillAmounts,
token,
ZERO,
owner,
salt,
expiration,
orderId,
advancedPermitHash
);
(
quantityFilled,
isError
) = _orderTransfer(
orderStatus,
orderFillAmounts,
token,
ZERO,
owner,
to,
orderId,
_transferFromERC20
);
if (isError) {
_restoreFillableItems(orderStatus, owner, orderId, quantityFilled, true);
}
}
/**
* @notice Closes an outstanding order to prevent further execution of transfers.
*
* @dev - Throws if the order is not in the open state
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Marks the order as cancelled
* @dev 2. Sets the order amount to 0
* @dev 3. Sets the order expiration to 0
* @dev 4. Emits a OrderClosed event
*
* @param owner The owner of the token
* @param operator The operator allowed to transfer the token
* @param tokenType The type of token the order is for - must be 20, 721 or 1155.
* @param token The address of the token contract
* @param id The token ID
* @param orderId The order ID
*/
function closePermittedOrder(
address owner,
address operator,
uint256 tokenType,
address token,
uint256 id,
bytes32 orderId
) external {
if(!(msg.sender == owner || msg.sender == operator)) {
revert PermitC__CallerMustBeOwnerOrOperator();
}
_requireValidTokenType(tokenType);
PackedApproval storage orderStatus = _getPackedApprovalPtr(_orderApprovals, owner, tokenType, token, id, orderId, operator);
if (orderStatus.state == ORDER_STATE_OPEN) {
orderStatus.state = ORDER_STATE_CANCELLED;
orderStatus.amount = 0;
orderStatus.expiration = 0;
emit OrderClosed(orderId, owner, operator, true);
} else {
revert PermitC__OrderIsEitherCancelledOrFilled();
}
}
/**
* @notice Returns the amount of allowance an operator has for a specific token and id
* @notice If the expiration on the allowance has expired, returns 0
*
* @dev Overload of the on chain allowance function for approvals with a specified order ID
*
* @param owner The owner of the token
* @param operator The operator of the token
* @param token The address of the token contract
* @param id The token ID
*
* @return allowedAmount The amount of allowance the operator has
*/
function allowance(
address owner,
address operator,
uint256 tokenType,
address token,
uint256 id,
bytes32 orderId
) external view returns (uint256 allowedAmount, uint256 expiration) {
return _allowance(_orderApprovals, owner, operator, tokenType, token, id, orderId);
}
/**
* =================================================
* ================ Nonce Management ===============
* =================================================
*/
/**
* @notice Invalidates the provided nonce
*
* @dev - Throws if the provided nonce has already been used
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Sets the provided nonce as used for the sender
*
* @param nonce Nonce to invalidate
*/
function invalidateUnorderedNonce(uint256 nonce) external {
_checkAndInvalidateNonce(msg.sender, nonce);
}
/**
* @notice Returns if the provided nonce has been used
*
* @param owner The owner of the token
* @param nonce The nonce to check
*
* @return isValid true if the nonce is valid, false otherwise
*/
function isValidUnorderedNonce(address owner, uint256 nonce) external view returns (bool isValid) {
isValid = ((_unorderedNonces[owner][uint248(nonce >> 8)] >> uint8(nonce)) & ONE) == ZERO;
}
/**
* @notice Revokes all outstanding approvals for the sender
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Increments the master nonce for the sender
* @dev 2. All outstanding approvals for the sender are invalidated
*/
function lockdown() external {
unchecked {
_masterNonces[msg.sender]++;
}
emit Lockdown(msg.sender);
}
/**
* @notice Returns the master nonce for the provided owner address
*
* @param owner The owner address
*
* @return The master nonce
*/
function masterNonce(address owner) external view returns (uint256) {
return _masterNonces[owner];
}
/**
* =================================================
* ============== Transfer Functions ===============
* =================================================
*/
/**
* @notice Transfer an ERC721 token from the owner to the recipient using on chain approvals
*
* @dev Public transfer function overload for approval transfers
* @dev - Throws if the provided token address does not implement ERC721 transferFrom function
* @dev - Throws if the requested amount exceeds the approved amount
* @dev - Throws if the approval is expired
* @dev - Returns `false` if the transfer fails
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token (in the requested amount) from the owner to the recipient
* @dev 2. Decrements the approval amount by the requested amount
* @dev 3. Performs any additional checks in the before and after hooks
*
* @param owner The owner of the token
* @param to The recipient of the token
* @param token The address of the token
* @param id The id of the token
*
* @return isError True if the transfer failed, false otherwise
*/
function transferFromERC721(
address owner,
address to,
address token,
uint256 id
) external returns (bool isError) {
_requireNotPaused(PAUSABLE_APPROVAL_TRANSFER_FROM_ERC721);
PackedApproval storage approval = _checkAndUpdateApproval(owner, TOKEN_TYPE_ERC721, token, id, ONE, true);
isError = _transferFromERC721(owner, to, token, id);
if (isError) {
_restoreFillableItems(approval, owner, ZERO_BYTES32, ONE, false);
}
}
/**
* @notice Transfer an ERC1155 token from the owner to the recipient using on chain approvals
*
* @dev Public transfer function overload for approval transfers
* @dev - Throws if the provided token address does not implement ERC1155 safeTransferFrom function
* @dev - Throws if the requested amount exceeds the approved amount
* @dev - Throws if the approval is expired
* @dev - Returns `false` if the transfer fails
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token (in the requested amount) from the owner to the recipient
* @dev 2. Decrements the approval amount by the requested amount
* @dev 3. Performs any additional checks in the before and after hooks
*
* @param owner The owner of the token
* @param to The recipient of the token
* @param amount The amount of the token to transfer
* @param token The address of the token
* @param id The id of the token
*
* @return isError True if the transfer failed, false otherwise
*/
function transferFromERC1155(
address owner,
address to,
address token,
uint256 id,
uint256 amount
) external returns (bool isError) {
_requireNotPaused(PAUSABLE_APPROVAL_TRANSFER_FROM_ERC1155);
PackedApproval storage approval = _checkAndUpdateApproval(owner, TOKEN_TYPE_ERC1155, token, id, amount, false);
isError = _transferFromERC1155(token, owner, to, id, amount);
if (isError) {
_restoreFillableItems(approval, owner, ZERO_BYTES32, amount, false);
}
}
/**
* @notice Transfer an ERC20 token from the owner to the recipient using on chain approvals
*
* @dev Public transfer function overload for approval transfers
* @dev - Throws if the provided token address does not implement ERC20 transferFrom function
* @dev - Throws if the requested amount exceeds the approved amount
* @dev - Throws if the approval is expired
* @dev - Returns `false` if the transfer fails
*
* @dev <h4>Postconditions:</h4>
* @dev 1. Transfers the token (in the requested amount) from the owner to the recipient
* @dev 2. Decrements the approval amount by the requested amount
* @dev 3. Performs any additional checks in the before and after hooks
*
* @param owner The owner of the token
* @param to The recipient of the token
* @param amount The amount of the token to transfer
* @param token The address of the token
*
* @return isError True if the transfer failed, false otherwise
*/
function transferFromERC20(
address owner,
address to,
address token,
uint256 amount
) external returns (bool isError) {
_requireNotPaused(PAUSABLE_APPROVAL_TRANSFER_FROM_ERC20);
PackedApproval storage approval = _checkAndUpdateApproval(owner, TOKEN_TYPE_ERC20, token, ZERO, amount, false);
isError = _transferFromERC20(token, owner, to, ZERO, amount);
if (isError) {
_restoreFillableItems(approval, owner, ZERO_BYTES32, amount, false);
}
}
/**
* @notice Performs a transfer of an ERC721 token.
*
* @dev Will **NOT** attempt transfer if `_beforeTransferFrom` hook returns false.
* @dev Will **NOT** revert if the transfer is unsucessful.
* @dev Invokers **MUST** check `isError` return value to determine success.
*
* @param owner The owner of the token being transferred
* @param to The address to transfer the token to
* @param token The token address of the token being transferred
* @param id The token id being transferred
*
* @return isError True if the token was not transferred, false if token was transferred
*/
function _transferFromERC721(
address owner,
address to,
address token,
uint256 id
) private returns (bool isError) {
isError = _beforeTransferFrom(TOKEN_TYPE_ERC721, token, owner, to, id, ONE);
if (!isError) {
try IERC721(token).transferFrom(owner, to, id) { }
catch {
isError = true;
}
}
}
/**
* @notice Performs a transfer of an ERC1155 token.
*
* @dev Will **NOT** attempt transfer if `_beforeTransferFrom` hook returns false.
* @dev Will **NOT** revert if the transfer is unsucessful.
* @dev Invokers **MUST** check `isError` return value to determine success.
*
* @param token The token address of the token being transferred
* @param owner The owner of the token being transferred
* @param to The address to transfer the token to
* @param id The token id being transferred
* @param amount The quantity of token id to transfer
*
* @return isError True if the token was not transferred, false if token was transferred
*/
function _transferFromERC1155(
address token,
address owner,
address to,
uint256 id,
uint256 amount
) private returns (bool isError) {
isError = _beforeTransferFrom(TOKEN_TYPE_ERC1155, token, owner, to, id, amount);
if (!isError) {
try IERC1155(token).safeTransferFrom(owner, to, id, amount, "") { } catch {
isError = true;
}
}
}
/**
* @notice Performs a transfer of an ERC20 token.
*
* @dev Will **NOT** attempt transfer if `_beforeTransferFrom` hook returns false.
* @dev Will **NOT** revert if the transfer is unsucessful.
* @dev Invokers **MUST** check `isError` return value to determine success.
*
* @param token The token address of the token being transferred
* @param owner The owner of the token being transferred
* @param to The address to transfer the token to
* @param amount The quantity of token id to transfer
*
* @return isError True if the token was not transferred, false if token was transferred
*/
function _transferFromERC20(
address token,
address owner,
address to,
uint256 /*id*/,
uint256 amount
) private returns (bool isError) {
isError = _beforeTransferFrom(TOKEN_TYPE_ERC20, token, owner, to, ZERO, amount);
if (!isError) {
(bool success, bytes memory data) = token.call(abi.encodeWithSelector(IERC20.transferFrom.selector, owner, to, amount));
if (!success) {
isError = true;
} else if (data.length > 0) {
isError = !abi.decode(data, (bool));
}
}
}
/**
* =================================================
* ============ Signature Verification =============
* =================================================
*/
/**
* @notice Returns the domain separator used in the permit signature
*
* @return domainSeparator The domain separator
*/
function domainSeparatorV4() external view returns (bytes32 domainSeparator) {
domainSeparator = _domainSeparatorV4();
}
/**
* @notice Verifies a permit signature based on the bytes length of the signature provided.
*
* @dev Throws when -
* @dev The bytes signature length is 64 or 65 bytes AND
* @dev The ECDSA recovered signer is not the owner AND
* @dev The owner's code length is zero OR the owner does not return a valid EIP-1271 response
* @dev
* @dev OR
* @dev
* @dev The bytes signature length is not 64 or 65 bytes AND
* @dev The owner's code length is zero OR the owner does not return a valid EIP-1271 response
*/
function _verifyPermitSignature(bytes32 digest, bytes calldata signature, address owner) private view {
if (signature.length == 65) {
bytes32 r;
bytes32 s;
uint8 v;
// Divide the signature in r, s and v variables
/// @solidity memory-safe-assembly
assembly {
r := calldataload(signature.offset)
s := calldataload(add(signature.offset, 32))
v := byte(0, calldataload(add(signature.offset, 64)))
}
(bool isError, address signer) = _ecdsaRecover(digest, v, r, s);
if (owner != signer || isError) {
_verifyEIP1271Signature(owner, digest, signature);
}
} else if (signature.length == 64) {
bytes32 r;
bytes32 vs;
// Divide the signature in r and vs variables
/// @solidity memory-safe-assembly
assembly {
r := calldataload(signature.offset)
vs := calldataload(add(signature.offset, 32))
}
(bool isError, address signer) = _ecdsaRecover(digest, r, vs);
if (owner != signer || isError) {
_verifyEIP1271Signature(owner, digest, signature);
}
} else {
_verifyEIP1271Signature(owner, digest, signature);
}
}
/**
* @notice Verifies an EIP-1271 signature.
*
* @dev Throws when `signer` code length is zero OR the EIP-1271 call does not
* @dev return the correct magic value.
*
* @param signer The signer address to verify a signature with
* @param hash The hash digest to verify with the signer
* @param signature The signature to verify
*/
function _verifyEIP1271Signature(address signer, bytes32 hash, bytes calldata signature) private view {
if(signer.code.length == 0) {
revert PermitC__SignatureTransferInvalidSignature();
}
if (!_safeIsValidSignature(signer, hash, signature)) {
revert PermitC__SignatureTransferInvalidSignature();
}
}
/**
* @notice Overload of the `_ecdsaRecover` function to unpack the `v` and `s` values
*
* @param digest The hash digest that was signed
* @param r The `r` value of the signature
* @param vs The packed `v` and `s` values of the signature
*
* @return isError True if the ECDSA function is provided invalid inputs
* @return signer The recovered address from ECDSA
*/
function _ecdsaRecover(bytes32 digest, bytes32 r, bytes32 vs) private pure returns (bool isError, address signer) {
unchecked {
bytes32 s = vs & UPPER_BIT_MASK;
uint8 v = uint8(uint256(vs >> 255)) + 27;
(isError, signer) = _ecdsaRecover(digest, v, r, s);
}
}
/**
* @notice Recovers the signer address using ECDSA
*
* @dev Does **NOT** revert if invalid input values are provided or `signer` is recovered as address(0)
* @dev Returns an `isError` value in those conditions that is handled upstream
*
* @param digest The hash digest that was signed
* @param v The `v` value of the signature
* @param r The `r` value of the signature
* @param s The `s` value of the signature
*
* @return isError True if the ECDSA function is provided invalid inputs
* @return signer The recovered address from ECDSA
*/
function _ecdsaRecover(bytes32 digest, uint8 v, bytes32 r, bytes32 s) private pure returns (bool isError, address signer) {
if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
// Invalid signature `s` value - return isError = true and signer = address(0) to check EIP-1271
return (true, address(0));
}
signer = ecrecover(digest, v, r, s);
isError = (signer == address(0));
}
/**
* @notice A gas efficient, and fallback-safe way to call the isValidSignature function for EIP-1271.
*
* @param signer The EIP-1271 signer to call to check for a valid signature.
* @param hash The hash digest to verify with the EIP-1271 signer.
* @param signature The supplied signature to verify.
*
* @return isValid True if the EIP-1271 signer returns the EIP-1271 magic value.
*/
function _safeIsValidSignature(
address signer,
bytes32 hash,
bytes calldata signature
) private view returns(bool isValid) {
assembly {
function _callIsValidSignature(_signer, _hash, _signatureOffset, _signatureLength) -> _isValid {
let ptr := mload(0x40)
// store isValidSignature(bytes32,bytes) selector
mstore(ptr, hex"1626ba7e")
// store bytes32 hash value in abi encoded location
mstore(add(ptr, 0x04), _hash)
// store abi encoded location of the bytes signature data
mstore(add(ptr, 0x24), 0x40)
// store bytes signature length
mstore(add(ptr, 0x44), _signatureLength)
// copy calldata bytes signature to memory
calldatacopy(add(ptr, 0x64), _signatureOffset, _signatureLength)
// calculate data length based on abi encoded data with rounded up signature length
let dataLength := add(0x64, and(add(_signatureLength, 0x1F), not(0x1F)))
// update free memory pointer
mstore(0x40, add(ptr, dataLength))
// static call _signer with abi encoded data
// skip return data check if call failed or return data size is not at least 32 bytes
if and(iszero(lt(returndatasize(), 0x20)), staticcall(gas(), _signer, ptr, dataLength, 0x00, 0x20)) {
// check if return data is equal to isValidSignature magic value
_isValid := eq(mload(0x00), hex"1626ba7e")
leave
}
}
isValid := _callIsValidSignature(signer, hash, signature.offset, signature.length)
}
}
/**
* =================================================
* ===================== Hooks =====================
* =================================================
*/
/**
* @dev This function is empty by default. Override it to add additional logic after the approval transfer.
* @dev The function returns a boolean value instead of reverting to indicate if there is an error for more granular control in inheriting protocols.
*/
function _beforeTransferFrom(uint256 tokenType, address token, address owner, address to, uint256 id, uint256 amount) internal virtual returns (bool isError) {}
/**
* =================================================
* ==================== Internal ===================
* =================================================
*/
/**
* @notice Checks if an advanced permit typehash has been registered with PermitC
*
* @dev Throws when the typehash has not been registered
*
* @param advancedPermitHash The permit typehash to check
*/
function _requireTransferAdvancedPermitHashIsRegistered(bytes32 advancedPermitHash) private view {
if (!_registeredTransferHashes[advancedPermitHash]) {
revert PermitC__SignatureTransferPermitHashNotRegistered();
}
}
/**
* @notice Checks if an advanced permit typehash has been registered with PermitC
*
* @dev Throws when the typehash has not been registered
*
* @param advancedPermitHash The permit typehash to check
*/
function _requireOrderAdvancedPermitHashIsRegistered(bytes32 advancedPermitHash) private view {
if (!_registeredOrderHashes[advancedPermitHash]) {
revert PermitC__SignatureTransferPermitHashNotRegistered();
}
}
/**
* @notice Invalidates an account nonce if it has not been previously used
*
* @dev Throws when the nonce was previously used
*
* @param account The account to invalidate the nonce of
* @param nonce The nonce to invalidate
*/
function _checkAndInvalidateNonce(address account, uint256 nonce) private {
unchecked {
if (uint256(_unorderedNonces[account][uint248(nonce >> 8)] ^= (ONE << uint8(nonce))) &
(ONE << uint8(nonce)) == ZERO) {
revert PermitC__NonceAlreadyUsedOrRevoked();
}
}
}
/**
* @notice Checks an approval to ensure it is sufficient for the `amount` to send
*
* @dev Throws when the approval is expired
* @dev Throws when the approved amount is insufficient
*
* @param owner The owner of the token
* @param tokenType The type of token
* @param token The address of the token
* @param id The id of the token
* @param amount The amount to deduct from the approval
* @param zeroOutApproval True if the approval should be set to zero
*
* @return approval Storage pointer for the approval data
*/
function _checkAndUpdateApproval(
address owner,
uint256 tokenType,
address token,
uint256 id,
uint256 amount,
bool zeroOutApproval
) private returns (PackedApproval storage approval) {
approval = _getPackedApprovalPtr(_transferApprovals, owner, tokenType, token, id, ZERO_BYTES32, msg.sender);
if (approval.expiration < block.timestamp) {
revert PermitC__ApprovalTransferPermitExpiredOrUnset();
}
if (approval.amount < amount) {
revert PermitC__ApprovalTransferExceededPermittedAmount();
}
if(zeroOutApproval) {
approval.amount = 0;
} else if (approval.amount < type(uint200).max) {
unchecked {
approval.amount -= uint200(amount);
}
}
}
/**
* @notice Gets the storage pointer for an approval
*
* @param _approvals The mapping to retrieve the approval from
* @param account The account the approval is from
* @param tokenType The type of token the approval is for
* @param token The address of the token
* @param id The id of the token
* @param orderId The order id for the approval
* @param operator The operator for the approval
*
* @return approval Storage pointer for the approval data
*/
function _getPackedApprovalPtr(
mapping(bytes32 => mapping(address => PackedApproval)) storage _approvals,
address account,
uint256 tokenType,
address token,
uint256 id,
bytes32 orderId,
address operator
) private view returns (PackedApproval storage approval) {
approval = _approvals[_getPackedApprovalKey(account, tokenType, token, id, orderId)][operator];
}
/**
* @notice Gets the storage key for the mapping for a specific approval
*
* @param owner The owner of the token
* @param tokenType The type of token
* @param token The address of the token
* @param id The id of the token
* @param orderId The order id of the approval
*
* @return key The key value to use to access the approval in the mapping
*/
function _getPackedApprovalKey(address owner, uint256 tokenType, address token, uint256 id, bytes32 orderId) private view returns (bytes32 key) {
key = keccak256(abi.encode(owner, tokenType, token, id, orderId, _masterNonces[owner]));
}
/**
* @notice Checks the permit approval for a single use permit without additional data
*
* @dev Throws when the `nonce` has already been consumed
* @dev Throws when the permit amount is less than the transfer amount
* @dev Throws when the permit is expired
* @dev Throws when the signature is invalid
*
* @param tokenType The type of token
* @param token The address of the token
* @param id The id of the token
* @param permitAmount The amount authorized by the owner signature
* @param nonce The nonce of the permit
* @param expiration The time the permit expires
* @param owner The owner of the token
* @param transferAmount The amount of tokens requested to transfer
* @param signedPermit The signature for the permit
*/
function _checkPermitApproval(
uint256 tokenType,
address token,
uint256 id,
uint256 permitAmount,
uint256 nonce,
uint256 expiration,
address owner,
uint256 transferAmount,
bytes calldata signedPermit
) private {
bytes32 digest = _hashTypedDataV4(
PermitHash.hashSingleUsePermit(
tokenType,
token,
id,
permitAmount,
nonce,
expiration,
_masterNonces[owner]
)
);
_checkPermitData(
nonce,
expiration,
transferAmount,
permitAmount,
owner,
digest,
signedPermit
);
}
/**
* @notice Overload of `_checkPermitApprovalWithAdditionalData` to supply TOKEN_TYPE_ERC1155
*
* @dev Prevents stack too deep in `permitTransferFromWithAdditionalDataERC1155`
* @dev Throws when the `nonce` has already been consumed
* @dev Throws when the permit amount is less than the transfer amount
* @dev Throws when the permit is expired
* @dev Throws when the signature is invalid
*
* @param token The address of the token
* @param id The id of the token
* @param permitAmount The amount authorized by the owner signature
* @param nonce The nonce of the permit
* @param expiration The time the permit expires
* @param owner The owner of the token
* @param transferAmount The amount of tokens requested to transfer
* @param signedPermit The signature for the permit
* @param additionalData The additional data to validate with the permit signature
* @param advancedPermitHash The typehash of the permit to use for validating the signature
*/
function _checkPermitApprovalWithAdditionalDataERC1155(
address token,
uint256 id,
uint256 permitAmount,
uint256 nonce,
uint256 expiration,
address owner,
uint256 transferAmount,
bytes calldata signedPermit,
bytes32 additionalData,
bytes32 advancedPermitHash
) private {
_checkPermitApprovalWithAdditionalData(
TOKEN_TYPE_ERC1155,
token,
id,
permitAmount,
nonce,
expiration,
owner,
transferAmount,
signedPermit,
additionalData,
advancedPermitHash
);
}
/**
* @notice Overload of `_checkPermitApprovalWithAdditionalData` to supply TOKEN_TYPE_ERC20
*
* @dev Prevents stack too deep in `permitTransferFromWithAdditionalDataERC220`
* @dev Throws when the `nonce` has already been consumed
* @dev Throws when the permit amount is less than the transfer amount
* @dev Throws when the permit is expired
* @dev Throws when the signature is invalid
*
* @param token The address of the token
* @param id The id of the token
* @param permitAmount The amount authorized by the owner signature
* @param nonce The nonce of the permit
* @param expiration The time the permit expires
* @param owner The owner of the token
* @param transferAmount The amount of tokens requested to transfer
* @param signedPermit The signature for the permit
* @param additionalData The additional data to validate with the permit signature
* @param advancedPermitHash The typehash of the permit to use for validating the signature
*/
function _checkPermitApprovalWithAdditionalDataERC20(
address token,
uint256 id,
uint256 permitAmount,
uint256 nonce,
uint256 expiration,
address owner,
uint256 transferAmount,
bytes calldata signedPermit,
bytes32 additionalData,
bytes32 advancedPermitHash
) private {
_checkPermitApprovalWithAdditionalData(
TOKEN_TYPE_ERC20,
token,
id,
permitAmount,
nonce,
expiration,
owner,
transferAmount,
signedPermit,
additionalData,
advancedPermitHash
);
}
/**
* @notice Overload of `_checkPermitApprovalWithAdditionalData` to supply TOKEN_TYPE_ERC721
*
* @dev Prevents stack too deep in `permitTransferFromWithAdditionalDataERC721`
* @dev Throws when the `nonce` has already been consumed
* @dev Throws when the permit amount is less than the transfer amount
* @dev Throws when the permit is expired
* @dev Throws when the signature is invalid
*
* @param token The address of the token
* @param id The id of the token
* @param permitAmount The amount authorized by the owner signature
* @param nonce The nonce of the permit
* @param expiration The time the permit expires
* @param owner The owner of the token
* @param transferAmount The amount of tokens requested to transfer
* @param signedPermit The signature for the permit
* @param additionalData The additional data to validate with the permit signature
* @param advancedPermitHash The typehash of the permit to use for validating the signature
*/
function _checkPermitApprovalWithAdditionalDataERC721(
address token,
uint256 id,
uint256 permitAmount,
uint256 nonce,
uint256 expiration,
address owner,
uint256 transferAmount,
bytes calldata signedPermit,
bytes32 additionalData,
bytes32 advancedPermitHash
) private {
_checkPermitApprovalWithAdditionalData(
TOKEN_TYPE_ERC721,
token,
id,
permitAmount,
nonce,
expiration,
owner,
transferAmount,
signedPermit,
additionalData,
advancedPermitHash
);
}
/**
* @notice Checks the permit approval for a single use permit with additional data
*
* @dev Throws when the `nonce` has already been consumed
* @dev Throws when the permit amount is less than the transfer amount
* @dev Throws when the permit is expired
* @dev Throws when the signature is invalid
*
* @param tokenType The type of token
* @param token The address of the token
* @param id The id of the token
* @param permitAmount The amount authorized by the owner signature
* @param nonce The nonce of the permit
* @param expiration The time the permit expires
* @param owner The owner of the token
* @param transferAmount The amount of tokens requested to transfer
* @param signedPermit The signature for the permit
* @param additionalData The additional data to validate with the permit signature
* @param advancedPermitHash The typehash of the permit to use for validating the signature
*/
function _checkPermitApprovalWithAdditionalData(
uint256 tokenType,
address token,
uint256 id,
uint256 permitAmount,
uint256 nonce,
uint256 expiration,
address owner,
uint256 transferAmount,
bytes calldata signedPermit,
bytes32 additionalData,
bytes32 advancedPermitHash
) private {
bytes32 digest = _getAdvancedTypedDataV4PermitHash(
tokenType,
token,
id,
permitAmount,
owner,
nonce,
expiration,
additionalData,
advancedPermitHash
);
_checkPermitData(
nonce,
expiration,
transferAmount,
permitAmount,
owner,
digest,
signedPermit
);
}
/**
* @notice Checks that a single use permit has not expired, was authorized for the amount
* @notice being transferred, has a valid nonce and has a valid signature.
*
* @dev Throws when the `nonce` has already been consumed
* @dev Throws when the permit amount is less than the transfer amount
* @dev Throws when the permit is expired
* @dev Throws when the signature is invalid
*
* @param nonce The nonce of the permit
* @param expiration The time the permit expires
* @param transferAmount The amount of tokens requested to transfer
* @param permitAmount The amount authorized by the owner signature
* @param owner The owner of the token
* @param digest The digest that was signed by the owner
* @param signedPermit The signature for the permit
*/
function _checkPermitData(
uint256 nonce,
uint256 expiration,
uint256 transferAmount,
uint256 permitAmount,
address owner,
bytes32 digest,
bytes calldata signedPermit
) private {
if (block.timestamp > expiration) {
revert PermitC__SignatureTransferExceededPermitExpired();
}
if (transferAmount > permitAmount) {
revert PermitC__SignatureTransferExceededPermittedAmount();
}
_checkAndInvalidateNonce(owner, nonce);
_verifyPermitSignature(digest, signedPermit, owner);
}
/**
* @notice Stores an approval for future use by `operator` to move tokens on behalf of `owner`
*
* @param tokenType The type of token
* @param token The address of the token
* @param id The id of the token
* @param amount The amount authorized by the owner
* @param expiration The time the permit expires
* @param owner The owner of the token
* @param operator The account allowed to transfer the tokens
*/
function _storeApproval(
uint256 tokenType,
address token,
uint256 id,
uint200 amount,
uint48 expiration,
address owner,
address operator
) private {
PackedApproval storage approval = _getPackedApprovalPtr(_transferApprovals, owner, tokenType, token, id, ZERO_BYTES32, operator);
approval.expiration = expiration;
approval.amount = amount;
emit Approval(owner, token, operator, id, amount, expiration);
}
/**
* @notice Overload of `_checkOrderTransfer` to supply TOKEN_TYPE_ERC1155
*
* @dev Prevents stack too deep in `fillPermittedOrderERC1155`
* @dev Throws when the order start amount is greater than type(uint200).max
* @dev Throws when the order status is not open
* @dev Throws when the signature is invalid
* @dev Throws when the permit is expired
*
* @param signedPermit The signature for the permit
* @param orderFillAmounts A struct containing the order start, requested fill and minimum fill amounts
* @param token The address of the token
* @param id The id of the token
* @param owner The owner of the token
* @param salt The salt value for the permit
* @param expiration The time the permit expires
* @param orderId The order id for the permit
* @param advancedPermitHash The typehash of the permit to use for validating the signature
*
* @return orderStatus Storage pointer for the approval data
*/
function _checkOrderTransferERC1155(
bytes calldata signedPermit,
OrderFillAmounts calldata orderFillAmounts,
address token,
uint256 id,
address owner,
uint256 salt,
uint48 expiration,
bytes32 orderId,
bytes32 advancedPermitHash
) private returns (PackedApproval storage orderStatus) {
orderStatus = _checkOrderTransfer(
signedPermit,
orderFillAmounts,
TOKEN_TYPE_ERC1155,
token,
id,
owner,
salt,
expiration,
orderId,
advancedPermitHash
);
}
/**
* @notice Overload of `_checkOrderTransfer` to supply TOKEN_TYPE_ERC20
*
* @dev Prevents stack too deep in `fillPermittedOrderERC20`
* @dev Throws when the order start amount is greater than type(uint200).max
* @dev Throws when the order status is not open
* @dev Throws when the signature is invalid
* @dev Throws when the permit is expired
*
* @param signedPermit The signature for the permit
* @param orderFillAmounts A struct containing the order start, requested fill and minimum fill amounts
* @param token The address of the token
* @param id The id of the token
* @param owner The owner of the token
* @param salt The salt value for the permit
* @param expiration The time the permit expires
* @param orderId The order id for the permit
* @param advancedPermitHash The typehash of the permit to use for validating the signature
*
* @return orderStatus Storage pointer for the approval data
*/
function _checkOrderTransferERC20(
bytes calldata signedPermit,
OrderFillAmounts calldata orderFillAmounts,
address token,
uint256 id,
address owner,
uint256 salt,
uint48 expiration,
bytes32 orderId,
bytes32 advancedPermitHash
) private returns (PackedApproval storage orderStatus) {
orderStatus = _checkOrderTransfer(
signedPermit,
orderFillAmounts,
TOKEN_TYPE_ERC20,
token,
id,
owner,
salt,
expiration,
orderId,
advancedPermitHash
);
}
/**
* @notice Validates an order transfer to check order start amount, status, signature if not previously
* @notice opened, and expiration.
*
* @dev Throws when the order start amount is greater than type(uint200).max
* @dev Throws when the order status is not open
* @dev Throws when the signature is invalid
* @dev Throws when the permit is expired
*
* @param signedPermit The signature for the permit
* @param orderFillAmounts A struct containing the order start, requested fill and minimum fill amounts
* @param tokenType The type of token
* @param token The address of the token
* @param id The id of the token
* @param owner The owner of the token
* @param salt The salt value for the permit
* @param expiration The time the permit expires
* @param orderId The order id for the permit
* @param advancedPermitHash The typehash of the permit to use for validating the signature
*
* @return orderStatus Storage pointer for the approval data
*/
function _checkOrderTransfer(
bytes calldata signedPermit,
OrderFillAmounts calldata orderFillAmounts,
uint256 tokenType,
address token,
uint256 id,
address owner,
uint256 salt,
uint48 expiration,
bytes32 orderId,
bytes32 advancedPermitHash
) private returns (PackedApproval storage orderStatus) {
if (orderFillAmounts.orderStartAmount > type(uint200).max) {
revert PermitC__AmountExceedsStorageMaximum();
}
orderStatus = _getPackedApprovalPtr(_orderApprovals, owner, tokenType, token, id, orderId, msg.sender);
if (orderStatus.state == ORDER_STATE_OPEN) {
if (orderStatus.amount == 0) {
_verifyPermitSignature(
_getAdvancedTypedDataV4PermitHash(
tokenType,
token,
id,
orderFillAmounts.orderStartAmount,
owner,
salt,
expiration,
orderId,
advancedPermitHash
),
signedPermit,
owner
);
orderStatus.amount = uint200(orderFillAmounts.orderStartAmount);
orderStatus.expiration = expiration;
emit OrderOpened(orderId, owner, msg.sender, orderFillAmounts.orderStartAmount);
}
if (block.timestamp > orderStatus.expiration) {
revert PermitC__SignatureTransferExceededPermitExpired();
}
} else {
revert PermitC__OrderIsEitherCancelledOrFilled();
}
}
/**
* @notice Checks the order fill amounts against approval data and transfers tokens, updates
* @notice approval if the fill results in the order being closed.
*
* @dev Throws when the amount to fill is less than the minimum fill amount
*
* @param orderStatus Storage pointer for the approval data
* @param orderFillAmounts A struct containing the order start, requested fill and minimum fill amounts
* @param token The address of the token
* @param id The id of the token
* @param owner The owner of the token
* @param to The address to send the tokens to
* @param orderId The order id for the permit
* @param _transferFrom Function pointer of the transfer function to send tokens with
*
* @return quantityFilled The number of tokens filled in the order
* @return isError True if there was an error transferring tokens, false otherwise
*/
function _orderTransfer(
PackedApproval storage orderStatus,
OrderFillAmounts calldata orderFillAmounts,
address token,
uint256 id,
address owner,
address to,
bytes32 orderId,
function (address, address, address, uint256, uint256) internal returns (bool) _transferFrom
) private returns (uint256 quantityFilled, bool isError) {
quantityFilled = orderFillAmounts.requestedFillAmount;
if (quantityFilled > orderStatus.amount) {
quantityFilled = orderStatus.amount;
}
if (quantityFilled < orderFillAmounts.minimumFillAmount) {
revert PermitC__UnableToFillMinimumRequestedQuantity();
}
unchecked {
orderStatus.amount -= uint200(quantityFilled);
emit OrderFilled(orderId, owner, msg.sender, quantityFilled);
}
if (orderStatus.amount == 0) {
orderStatus.state = ORDER_STATE_FILLED;
emit OrderClosed(orderId, owner, msg.sender, false);
}
isError = _transferFrom(token, owner, to, id, quantityFilled);
}
/**
* @notice Restores an account's nonce when a transfer was not successful
*
* @dev Throws when the nonce was not already consumed
*
* @param account The account to restore the nonce of
* @param nonce The nonce to restore
*/
function _restoreNonce(address account, uint256 nonce) private {
unchecked {
if (uint256(_unorderedNonces[account][uint248(nonce >> 8)] ^= (ONE << uint8(nonce))) &
(ONE << uint8(nonce)) != ZERO) {
revert PermitC__NonceNotUsedOrRevoked();
}
}
}
/**
* @notice Restores an approval amount when a transfer was not successful
*
* @param approval Storage pointer for the approval data
* @param owner The owner of the tokens
* @param orderId The order id to restore approval amount on
* @param unfilledAmount The amount that was not filled on the order
* @param isOrderPermit True if the fill restoration is for an permit order
*/
function _restoreFillableItems(
PackedApproval storage approval,
address owner,
bytes32 orderId,
uint256 unfilledAmount,
bool isOrderPermit
) private {
if (unfilledAmount > 0) {
if (isOrderPermit) {
// Order permits always deduct amount and must be restored
unchecked {
approval.amount += uint200(unfilledAmount);
}
approval.state = ORDER_STATE_OPEN;
emit OrderRestored(orderId, owner, unfilledAmount);
} else if (approval.amount < type(uint200).max) {
// Stored approvals only deduct amount
unchecked {
approval.amount += uint200(unfilledAmount);
}
}
}
}
function _requireValidTokenType(uint256 tokenType) private pure {
if(!(
tokenType == TOKEN_TYPE_ERC721 ||
tokenType == TOKEN_TYPE_ERC1155 ||
tokenType == TOKEN_TYPE_ERC20
)
) {
revert PermitC__InvalidTokenType();
}
}
/**
* @notice Generates an EIP-712 digest for a permit
*
* @param tokenType The type of token
* @param token The address of the token
* @param id The id of the token
* @param amount The amount authorized by the owner signature
* @param owner The owner of the token
* @param nonce The nonce for the permit
* @param expiration The time the permit expires
* @param additionalData The additional data to validate with the permit signature
* @param advancedPermitHash The typehash of the permit to use for validating the signature
*
* @return digest The EIP-712 digest of the permit data
*/
function _getAdvancedTypedDataV4PermitHash(
uint256 tokenType,
address token,
uint256 id,
uint256 amount,
address owner,
uint256 nonce,
uint256 expiration,
bytes32 additionalData,
bytes32 advancedPermitHash
) private view returns (bytes32 digest) {
// cache masterNonce on stack to avoid stack too deep
uint256 masterNonce_ = _masterNonces[owner];
digest =
_hashTypedDataV4(
PermitHash.hashSingleUsePermitWithAdditionalData(
tokenType,
token,
id,
amount,
nonce,
expiration,
additionalData,
advancedPermitHash,
masterNonce_
)
);
}
/**
* @notice Returns the current allowed amount and expiration for a stored permit
*
* @dev Returns zero allowed if the permit has expired
*
* @param _approvals The mapping to retrieve the approval from
* @param owner The account the approval is from
* @param operator The operator for the approval
* @param tokenType The type of token the approval is for
* @param token The address of the token
* @param id The id of the token
* @param orderId The order id for the approval
*
* @return allowedAmount The amount authorized by the approval, zero if the permit has expired
* @return expiration The expiration of the approval
*/
function _allowance(
mapping(bytes32 => mapping(address => PackedApproval)) storage _approvals,
address owner,
address operator,
uint256 tokenType,
address token,
uint256 id,
bytes32 orderId
) private view returns (uint256 allowedAmount, uint256 expiration) {
PackedApproval storage allowed = _getPackedApprovalPtr(_approvals, owner, tokenType, token, id, orderId, operator);
allowedAmount = allowed.expiration < block.timestamp ? 0 : allowed.amount;
expiration = allowed.expiration;
}
/**
* @notice Allows the owner of the PermitC contract to access pausable admin functions
*
* @dev May be overriden by an inheriting contract to provide alternative permission structure
*/
function _requireCallerHasPausePermissions() internal view virtual override {
_checkOwner();
}
}pragma solidity ^0.8.4;
import "./IERC165.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC-165 should inherit from this contract and override {supportsInterface} to check
* for the additional interface id that will be supported. For example:
*
* ```solidity
* function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
* return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
* }
* ```
*/
abstract contract ERC165 is IERC165 {
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
return interfaceId == type(IERC165).interfaceId;
}
}pragma solidity ^0.8.4;
/**
* @dev Library for managing
* https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
* types.
*
* Sets have the following properties:
*
* - Elements are added, removed, and checked for existence in constant time
* (O(1)).
* - Elements are enumerated in O(n). No guarantees are made on the ordering.
*
* ```solidity
* contract Example {
* // Add the library methods
* using EnumerableSet for EnumerableSet.AddressSet;
*
* // Declare a set state variable
* EnumerableSet.AddressSet private mySet;
* }
* ```
*
* As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
* and `uint256` (`UintSet`) are supported.
*
* [WARNING]
* ====
* Trying to delete such a structure from storage will likely result in data corruption, rendering the structure
* unusable.
* See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
*
* In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an
* array of EnumerableSet.
* ====
*/
library EnumerableSet {
// To implement this library for multiple types with as little code
// repetition as possible, we write it in terms of a generic Set type with
// bytes32 values.
// The Set implementation uses private functions, and user-facing
// implementations (such as AddressSet) are just wrappers around the
// underlying Set.
// This means that we can only create new EnumerableSets for types that fit
// in bytes32.
struct Set {
// Storage of set values
bytes32[] _values;
// Position is the index of the value in the `values` array plus 1.
// Position 0 is used to mean a value is not in the set.
mapping(bytes32 value => uint256) _positions;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function _add(Set storage set, bytes32 value) private returns (bool) {
if (!_contains(set, value)) {
set._values.push(value);
// The value is stored at length-1, but we add 1 to all indexes
// and use 0 as a sentinel value
set._positions[value] = set._values.length;
return true;
} else {
return false;
}
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function _remove(Set storage set, bytes32 value) private returns (bool) {
// We cache the value's position to prevent multiple reads from the same storage slot
uint256 position = set._positions[value];
if (position != 0) {
// Equivalent to contains(set, value)
// To delete an element from the _values array in O(1), we swap the element to delete with the last one in
// the array, and then remove the last element (sometimes called as 'swap and pop').
// This modifies the order of the array, as noted in {at}.
uint256 valueIndex = position - 1;
uint256 lastIndex = set._values.length - 1;
if (valueIndex != lastIndex) {
bytes32 lastValue = set._values[lastIndex];
// Move the lastValue to the index where the value to delete is
set._values[valueIndex] = lastValue;
// Update the tracked position of the lastValue (that was just moved)
set._positions[lastValue] = position;
}
// Delete the slot where the moved value was stored
set._values.pop();
// Delete the tracked position for the deleted slot
delete set._positions[value];
return true;
} else {
return false;
}
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function _contains(Set storage set, bytes32 value) private view returns (bool) {
return set._positions[value] != 0;
}
/**
* @dev Returns the number of values on the set. O(1).
*/
function _length(Set storage set) private view returns (uint256) {
return set._values.length;
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function _at(Set storage set, uint256 index) private view returns (bytes32) {
return set._values[index];
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function _values(Set storage set) private view returns (bytes32[] memory) {
return set._values;
}
// Bytes32Set
struct Bytes32Set {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _add(set._inner, value);
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _remove(set._inner, value);
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
return _contains(set._inner, value);
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(Bytes32Set storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
return _at(set._inner, index);
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
bytes32[] memory store = _values(set._inner);
bytes32[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
// AddressSet
struct AddressSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(AddressSet storage set, address value) internal returns (bool) {
return _add(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(AddressSet storage set, address value) internal returns (bool) {
return _remove(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(AddressSet storage set, address value) internal view returns (bool) {
return _contains(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(AddressSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(AddressSet storage set, uint256 index) internal view returns (address) {
return address(uint160(uint256(_at(set._inner, index))));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(AddressSet storage set) internal view returns (address[] memory) {
bytes32[] memory store = _values(set._inner);
address[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
// UintSet
struct UintSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(UintSet storage set, uint256 value) internal returns (bool) {
return _add(set._inner, bytes32(value));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(UintSet storage set, uint256 value) internal returns (bool) {
return _remove(set._inner, bytes32(value));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(UintSet storage set, uint256 value) internal view returns (bool) {
return _contains(set._inner, bytes32(value));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(UintSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(UintSet storage set, uint256 index) internal view returns (uint256) {
return uint256(_at(set._inner, index));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(UintSet storage set) internal view returns (uint256[] memory) {
bytes32[] memory store = _values(set._inner);
uint256[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
}pragma solidity ^0.8.4;
import "../introspection/IERC165.sol";
interface IEOARegistry is IERC165 {
function isVerifiedEOA(address account) external view returns (bool);
}pragma solidity ^0.8.4;
interface ITransferValidator {
function applyCollectionTransferPolicy(address caller, address from, address to) external view;
function validateTransfer(address caller, address from, address to) external view;
function validateTransfer(address caller, address from, address to, uint256 tokenId) external view;
function validateTransfer(address caller, address from, address to, uint256 tokenId, uint256 amount) external;
function beforeAuthorizedTransfer(address operator, address token, uint256 tokenId) external;
function afterAuthorizedTransfer(address token, uint256 tokenId) external;
function beforeAuthorizedTransfer(address operator, address token) external;
function afterAuthorizedTransfer(address token) external;
function beforeAuthorizedTransfer(address token, uint256 tokenId) external;
function beforeAuthorizedTransferWithAmount(address token, uint256 tokenId, uint256 amount) external;
function afterAuthorizedTransferWithAmount(address token, uint256 tokenId) external;
}// SPDX-License-Identifier: MIT pragma solidity ^0.8.4; /// @dev Thrown when a stored approval exceeds type(uint200).max error PermitC__AmountExceedsStorageMaximum(); /// @dev Thrown when a transfer amount requested exceeds the permitted amount error PermitC__ApprovalTransferExceededPermittedAmount(); /// @dev Thrown when a transfer is requested after the permit has expired error PermitC__ApprovalTransferPermitExpiredOrUnset(); /// @dev Thrown when attempting to close an order by an account that is not the owner or operator error PermitC__CallerMustBeOwnerOrOperator(); /// @dev Thrown when attempting to approve a token type that is not valid for PermitC error PermitC__InvalidTokenType(); /// @dev Thrown when attempting to invalidate a nonce that has already been used error PermitC__NonceAlreadyUsedOrRevoked(); /// @dev Thrown when attempting to restore a nonce that has not been used error PermitC__NonceNotUsedOrRevoked(); /// @dev Thrown when attempting to fill an order that has already been filled or cancelled error PermitC__OrderIsEitherCancelledOrFilled(); /// @dev Thrown when a transfer amount requested exceeds the permitted amount error PermitC__SignatureTransferExceededPermittedAmount(); /// @dev Thrown when a transfer is requested after the permit has expired error PermitC__SignatureTransferExceededPermitExpired(); /// @dev Thrown when attempting to use an advanced permit typehash that is not registered error PermitC__SignatureTransferPermitHashNotRegistered(); /// @dev Thrown when a permit signature is invalid error PermitC__SignatureTransferInvalidSignature(); /// @dev Thrown when the remaining fill amount is less than the requested minimum fill error PermitC__UnableToFillMinimumRequestedQuantity();
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (interfaces/IERC20.sol) pragma solidity ^0.8.0; import "../token/ERC20/IERC20.sol";
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (interfaces/IERC721.sol) pragma solidity ^0.8.0; import "../token/ERC721/IERC721.sol";
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (interfaces/IERC1155.sol) pragma solidity ^0.8.0; import "../token/ERC1155/IERC1155.sol";
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (interfaces/IERC1271.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC1271 standard signature validation method for
* contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].
*
* _Available since v4.1._
*/
interface IERC1271 {
/**
* @dev Should return whether the signature provided is valid for the provided data
* @param hash Hash of the data to be signed
* @param signature Signature byte array associated with _data
*/
function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)
pragma solidity ^0.8.0;
import {Context} from "@openzeppelin/contracts/utils/Context.sol";
/**
* @dev Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* By default, the owner account will be the one that deploys the contract. This
* can later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract Ownable is Context {
error Ownable__CallerIsNotOwner();
error Ownable__NewOwnerIsZeroAddress();
address private _owner;
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the deployer as the initial owner.
*/
constructor() {
_transferOwnership(_msgSender());
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
_checkOwner();
_;
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
return _owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
if(owner() != _msgSender()) revert Ownable__CallerIsNotOwner();
}
/**
* @dev Leaves the contract without owner. It will not be possible to call
* `onlyOwner` functions. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby disabling any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
if(newOwner == address(0)) revert Ownable__NewOwnerIsZeroAddress();
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual {
address oldOwner = _owner;
_owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/EIP712.sol)
pragma solidity ^0.8.8;
import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
/**
* @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.
*
* The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,
* thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding
* they need in their contracts using a combination of `abi.encode` and `keccak256`.
*
* This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding
* scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA
* ({_hashTypedDataV4}).
*
* The implementation of the domain separator was designed to be as efficient as possible while still properly updating
* the chain id to protect against replay attacks on an eventual fork of the chain.
*
* NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method
* https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].
*
* NOTE: In the upgradeable version of this contract, the cached values will correspond to the address, and the domain
* separator of the implementation contract. This will cause the `_domainSeparatorV4` function to always rebuild the
* separator from the immutable values, which is cheaper than accessing a cached version in cold storage.
*
* _Available since v3.4._
*
* @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment
*/
abstract contract EIP712 {
bytes32 private constant _TYPE_HASH =
keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");
// Cache the domain separator as an immutable value, but also store the chain id that it corresponds to, in order to
// invalidate the cached domain separator if the chain id changes.
bytes32 private immutable _cachedDomainSeparator;
uint256 private immutable _cachedChainId;
bytes32 private immutable _hashedName;
bytes32 private immutable _hashedVersion;
/**
* @dev Initializes the domain separator and parameter caches.
*
* The meaning of `name` and `version` is specified in
* https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:
*
* - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.
* - `version`: the current major version of the signing domain.
*
* NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart
* contract upgrade].
*/
constructor(string memory name, string memory version) {
_hashedName = keccak256(bytes(name));
_hashedVersion = keccak256(bytes(version));
_cachedChainId = block.chainid;
_cachedDomainSeparator = _buildDomainSeparator();
}
/**
* @dev Returns the domain separator for the current chain.
*/
function _domainSeparatorV4() internal view returns (bytes32) {
if (block.chainid == _cachedChainId) {
return _cachedDomainSeparator;
} else {
return _buildDomainSeparator();
}
}
function _buildDomainSeparator() private view returns (bytes32) {
return keccak256(abi.encode(_TYPE_HASH, _hashedName, _hashedVersion, block.chainid, address(this)));
}
/**
* @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
* function returns the hash of the fully encoded EIP712 message for this domain.
*
* This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
*
* ```solidity
* bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
* keccak256("Mail(address to,string contents)"),
* mailTo,
* keccak256(bytes(mailContents))
* )));
* address signer = ECDSA.recover(digest, signature);
* ```
*/
function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {
return ECDSA.toTypedDataHash(_domainSeparatorV4(), structHash);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
/// @dev Constant bytes32 value of 0x000...000
bytes32 constant ZERO_BYTES32 = bytes32(0);
/// @dev Constant value of 0
uint256 constant ZERO = 0;
/// @dev Constant value of 1
uint256 constant ONE = 1;
/// @dev Constant value representing an open order in storage
uint8 constant ORDER_STATE_OPEN = 0;
/// @dev Constant value representing a filled order in storage
uint8 constant ORDER_STATE_FILLED = 1;
/// @dev Constant value representing a cancelled order in storage
uint8 constant ORDER_STATE_CANCELLED = 2;
/// @dev Constant value representing the ERC721 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC721 = 721;
/// @dev Constant value representing the ERC1155 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC1155 = 1155;
/// @dev Constant value representing the ERC20 token type for signatures and transfer hooks
uint256 constant TOKEN_TYPE_ERC20 = 20;
/// @dev Constant value to mask the upper bits of a signature that uses a packed `vs` value to extract `s`
bytes32 constant UPPER_BIT_MASK = 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff;
/// @dev EIP-712 typehash used for validating signature based stored approvals
bytes32 constant UPDATE_APPROVAL_TYPEHASH =
keccak256("UpdateApprovalBySignature(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 approvalExpiration,uint256 sigDeadline,uint256 masterNonce)");
/// @dev EIP-712 typehash used for validating a single use permit without additional data
bytes32 constant SINGLE_USE_PERMIT_TYPEHASH =
keccak256("PermitTransferFrom(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 expiration,uint256 masterNonce)");
/// @dev EIP-712 typehash used for validating a single use permit with additional data
string constant SINGLE_USE_PERMIT_TRANSFER_ADVANCED_TYPEHASH_STUB =
"PermitTransferFromWithAdditionalData(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 nonce,address operator,uint256 expiration,uint256 masterNonce,";
/// @dev EIP-712 typehash used for validating an order permit that updates storage as it fills
string constant PERMIT_ORDER_ADVANCED_TYPEHASH_STUB =
"PermitOrderWithAdditionalData(uint256 tokenType,address token,uint256 id,uint256 amount,uint256 salt,address operator,uint256 expiration,uint256 masterNonce,";
/// @dev Pausable flag for stored approval transfers of ERC721 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC721 = 1 << 0;
/// @dev Pausable flag for stored approval transfers of ERC1155 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC1155 = 1 << 1;
/// @dev Pausable flag for stored approval transfers of ERC20 assets
uint256 constant PAUSABLE_APPROVAL_TRANSFER_FROM_ERC20 = 1 << 2;
/// @dev Pausable flag for single use permit transfers of ERC721 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC721 = 1 << 3;
/// @dev Pausable flag for single use permit transfers of ERC1155 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC1155 = 1 << 4;
/// @dev Pausable flag for single use permit transfers of ERC20 assets
uint256 constant PAUSABLE_PERMITTED_TRANSFER_FROM_ERC20 = 1 << 5;
/// @dev Pausable flag for order fill transfers of ERC1155 assets
uint256 constant PAUSABLE_ORDER_TRANSFER_FROM_ERC1155 = 1 << 6;
/// @dev Pausable flag for order fill transfers of ERC20 assets
uint256 constant PAUSABLE_ORDER_TRANSFER_FROM_ERC20 = 1 << 7;// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
/// @dev Storage data struct for stored approvals and order approvals
struct PackedApproval {
// Only used for partial fill position 1155 transfers
uint8 state;
// Amount allowed
uint200 amount;
// Permission expiry
uint48 expiration;
}
/// @dev Calldata data struct for order fill amounts
struct OrderFillAmounts {
uint256 orderStartAmount;
uint256 requestedFillAmount;
uint256 minimumFillAmount;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import {SINGLE_USE_PERMIT_TYPEHASH, UPDATE_APPROVAL_TYPEHASH} from "../Constants.sol";
library PermitHash {
/**
* @notice Hashes the permit data for a stored approval
*
* @param tokenType The type of token
* @param token The address of the token
* @param id The id of the token
* @param amount The amount authorized by the owner signature
* @param nonce The nonce for the permit
* @param operator The account that is allowed to use the permit
* @param approvalExpiration The time the permit approval expires
* @param sigDeadline The deadline for submitting the permit onchain
* @param masterNonce The signers master nonce
*
* @return hash The hash of the permit data
*/
function hashOnChainApproval(
uint256 tokenType,
address token,
uint256 id,
uint256 amount,
uint256 nonce,
address operator,
uint256 approvalExpiration,
uint256 sigDeadline,
uint256 masterNonce
) internal pure returns (bytes32 hash) {
hash = keccak256(
abi.encode(
UPDATE_APPROVAL_TYPEHASH,
tokenType,
token,
id,
amount,
nonce,
operator,
approvalExpiration,
sigDeadline,
masterNonce
)
);
}
/**
* @notice Hashes the permit data with the single user permit without additional data typehash
*
* @param tokenType The type of token
* @param token The address of the token
* @param id The id of the token
* @param amount The amount authorized by the owner signature
* @param nonce The nonce for the permit
* @param expiration The time the permit expires
* @param masterNonce The signers master nonce
*
* @return hash The hash of the permit data
*/
function hashSingleUsePermit(
uint256 tokenType,
address token,
uint256 id,
uint256 amount,
uint256 nonce,
uint256 expiration,
uint256 masterNonce
) internal view returns (bytes32 hash) {
hash = keccak256(
abi.encode(
SINGLE_USE_PERMIT_TYPEHASH,
tokenType,
token,
id,
amount,
nonce,
msg.sender,
expiration,
masterNonce
)
);
}
/**
* @notice Hashes the permit data with the supplied typehash
*
* @param tokenType The type of token
* @param token The address of the token
* @param id The id of the token
* @param amount The amount authorized by the owner signature
* @param nonce The nonce for the permit
* @param expiration The time the permit expires
* @param additionalData The additional data to validate with the permit signature
* @param additionalDataTypeHash The typehash of the permit to use for validating the signature
* @param masterNonce The signers master nonce
*
* @return hash The hash of the permit data with the supplied typehash
*/
function hashSingleUsePermitWithAdditionalData(
uint256 tokenType,
address token,
uint256 id,
uint256 amount,
uint256 nonce,
uint256 expiration,
bytes32 additionalData,
bytes32 additionalDataTypeHash,
uint256 masterNonce
) internal view returns (bytes32 hash) {
hash = keccak256(
abi.encode(
additionalDataTypeHash,
tokenType,
token,
id,
amount,
nonce,
msg.sender,
expiration,
masterNonce,
additionalData
)
);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import {OrderFillAmounts} from "../DataTypes.sol";
interface IPermitC {
/**
* =================================================
* ==================== Events =====================
* =================================================
*/
/// @dev Emitted when an approval is stored
event Approval(
address indexed owner,
address indexed token,
address indexed operator,
uint256 id,
uint200 amount,
uint48 expiration
);
/// @dev Emitted when a user increases their master nonce
event Lockdown(address indexed owner);
/// @dev Emitted when an order is opened
event OrderOpened(
bytes32 indexed orderId,
address indexed owner,
address indexed operator,
uint256 fillableQuantity
);
/// @dev Emitted when an order has a fill
event OrderFilled(
bytes32 indexed orderId,
address indexed owner,
address indexed operator,
uint256 amount
);
/// @dev Emitted when an order has been fully filled or cancelled
event OrderClosed(
bytes32 indexed orderId,
address indexed owner,
address indexed operator,
bool wasCancellation);
/// @dev Emitted when an order has an amount restored due to a failed transfer
event OrderRestored(
bytes32 indexed orderId,
address indexed owner,
uint256 amountRestoredToOrder
);
/**
* =================================================
* ============== Approval Transfers ===============
* =================================================
*/
function approve(uint256 tokenType, address token, uint256 id, address operator, uint200 amount, uint48 expiration) external;
function updateApprovalBySignature(
uint256 tokenType,
address token,
uint256 id,
uint256 nonce,
uint200 amount,
address operator,
uint48 approvalExpiration,
uint48 sigDeadline,
address owner,
bytes calldata signedPermit
) external;
function allowance(
address owner,
address operator,
uint256 tokenType,
address token,
uint256 id
) external view returns (uint256 amount, uint256 expiration);
/**
* =================================================
* ================ Signed Transfers ===============
* =================================================
*/
function registerAdditionalDataHash(string memory additionalDataTypeString) external;
function permitTransferFromERC721(
address token,
uint256 id,
uint256 nonce,
uint256 expiration,
address owner,
address to,
bytes calldata signedPermit
) external returns (bool isError);
function permitTransferFromWithAdditionalDataERC721(
address token,
uint256 id,
uint256 nonce,
uint256 expiration,
address owner,
address to,
bytes32 additionalData,
bytes32 advancedPermitHash,
bytes calldata signedPermit
) external returns (bool isError);
function permitTransferFromERC1155(
address token,
uint256 id,
uint256 nonce,
uint256 permitAmount,
uint256 expiration,
address owner,
address to,
uint256 transferAmount,
bytes calldata signedPermit
) external returns (bool isError);
function permitTransferFromWithAdditionalDataERC1155(
address token,
uint256 id,
uint256 nonce,
uint256 permitAmount,
uint256 expiration,
address owner,
address to,
uint256 transferAmount,
bytes32 additionalData,
bytes32 advancedPermitHash,
bytes calldata signedPermit
) external returns (bool isError);
function permitTransferFromERC20(
address token,
uint256 nonce,
uint256 permitAmount,
uint256 expiration,
address owner,
address to,
uint256 transferAmount,
bytes calldata signedPermit
) external returns (bool isError);
function permitTransferFromWithAdditionalDataERC20(
address token,
uint256 nonce,
uint256 permitAmount,
uint256 expiration,
address owner,
address to,
uint256 transferAmount,
bytes32 additionalData,
bytes32 advancedPermitHash,
bytes calldata signedPermit
) external returns (bool isError);
function isRegisteredTransferAdditionalDataHash(bytes32 hash) external view returns (bool isRegistered);
function isRegisteredOrderAdditionalDataHash(bytes32 hash) external view returns (bool isRegistered);
/**
* =================================================
* =============== Order Transfers =================
* =================================================
*/
function fillPermittedOrderERC1155(
bytes calldata signedPermit,
OrderFillAmounts calldata orderFillAmounts,
address token,
uint256 id,
address owner,
address to,
uint256 nonce,
uint48 expiration,
bytes32 orderId,
bytes32 advancedPermitHash
) external returns (uint256 quantityFilled, bool isError);
function fillPermittedOrderERC20(
bytes calldata signedPermit,
OrderFillAmounts calldata orderFillAmounts,
address token,
address owner,
address to,
uint256 nonce,
uint48 expiration,
bytes32 orderId,
bytes32 advancedPermitHash
) external returns (uint256 quantityFilled, bool isError);
function closePermittedOrder(
address owner,
address operator,
uint256 tokenType,
address token,
uint256 id,
bytes32 orderId
) external;
function allowance(
address owner,
address operator,
uint256 tokenType,
address token,
uint256 id,
bytes32 orderId
) external view returns (uint256 amount, uint256 expiration);
/**
* =================================================
* ================ Nonce Management ===============
* =================================================
*/
function invalidateUnorderedNonce(uint256 nonce) external;
function isValidUnorderedNonce(address owner, uint256 nonce) external view returns (bool isValid);
function lockdown() external;
function masterNonce(address owner) external view returns (uint256);
/**
* =================================================
* ============== Transfer Functions ===============
* =================================================
*/
function transferFromERC721(
address from,
address to,
address token,
uint256 id
) external returns (bool isError);
function transferFromERC1155(
address from,
address to,
address token,
uint256 id,
uint256 amount
) external returns (bool isError);
function transferFromERC20(
address from,
address to,
address token,
uint256 amount
) external returns (bool isError);
/**
* =================================================
* ============ Signature Verification =============
* =================================================
*/
function domainSeparatorV4() external view returns (bytes32);
}//SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
/*
@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@(
@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@
#@@@@@@@@@@@@@@
@@@@@@@@@@@@
@@@@@@@@@@@@@@* @@@@@@@@@@@@
@@@@@@@@@@@@@@@ @ @@@@@@@@@@@@
@@@@@@@@@@@@@@@ @ @@@@@@@@@@@
@@@@@@@@@@@@@@@ @@ @@@@@@@@@@@@
@@@@@@@@@@@@@@@ #@@ @@@@@@@@@@@@/
@@@@@@@@@@@@@@. @@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@&%%%%%%%%&&@@@@@@@@@@@@@@
@@@@@@@@@@@@@@ @@@@@ @@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@ @@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@ @@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@ @@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@ @@@@@@@@@@@&
@@@@@@@@@@@@@@ *@@@@@@@ (@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
.@@@@@@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@% @@@@@@@@@@@@@@@@@@@@@@@@(
@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@&
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
* @title CollateralizedPausableFlags
* @custom:version 1.0.0
* @author Limit Break, Inc.
* @description Collateralized Pausable Flags is an extension for contracts
* that require features to be pausable in the event of potential
* or actual threats without incurring a storage read overhead cost
* during normal operations by using contract starting balance as
* a signal for checking the paused state.
*
* Using contract balance to enable checking paused state creates an
* economic penalty for developers that deploy code that can be
* exploited as well as an economic incentive (recovery of collateral)
* for them to mitigate the threat.
*
* Developers implementing Collateralized Pausable Flags should consider
* their risk mitigation strategy and ensure funds are readily available
* for pausing if ever necessary by setting an appropriate threshold
* value and considering use of an escrow contract that can initiate the
* pause with funds.
*
* There is no restriction on the depositor as this can be easily
* circumvented through a `SELFDESTRUCT` opcode.
*
* Developers must be aware of potential outflows from the contract that
* could reduce collateral below the pausable check threshold and protect
* against those methods when pausing is required.
*/
abstract contract CollateralizedPausableFlags {
/// @dev Emitted when the pausable flags are updated
event PausableFlagsUpdated(uint256 previousFlags, uint256 newFlags);
/// @dev Thrown when an execution path requires a flag to not be paused but it is paused
error CollateralizedPausableFlags__Paused();
/// @dev Thrown when an executin path requires a flag to be paused but it is not paused
error CollateralizedPausableFlags__NotPaused();
/// @dev Thrown when a call to withdraw funds fails
error CollateralizedPausableFlags__WithdrawFailed();
/// @dev Immutable variable that defines the native funds threshold before flags are checked
uint256 private immutable nativeValueToCheckPauseState;
/// @dev Flags for current pausable state, each bit is considered a separate flag
uint256 private pausableFlags;
/// @dev Immutable pointer for the _requireNotPaused function to use based on value threshold
function(uint256) internal view immutable _requireNotPaused;
/// @dev Immutable pointer for the _requirePaused function to use based on value threshold
function(uint256) internal view immutable _requirePaused;
/// @dev Immutable pointer for the _getPausableFlags function to use based on value threshold
function() internal view returns (uint256) immutable _getPausableFlags;
constructor(uint256 _nativeValueToCheckPauseState) {
// Optimizes value check at runtime by reducing the stored immutable
// value by 1 so that greater than can be used instead of greater
// than or equal while allowing the deployment parameter to reflect
// the value at which the deployer wants to trigger pause checking.
// Example:
// Constructed with a value of 1000
// Immutable value stored is 999
// State checking enabled at 1000 units deposited because
// 1000 > 999 evaluates true
if (_nativeValueToCheckPauseState > 0) {
unchecked {
_nativeValueToCheckPauseState -= 1;
}
_requireNotPaused = _requireNotPausedWithCollateralCheck;
_requirePaused = _requirePausedWithCollateralCheck;
_getPausableFlags = _getPausableFlagsWithCollateralCheck;
} else {
_requireNotPaused = _requireNotPausedWithoutCollateralCheck;
_requirePaused = _requirePausedWithoutCollateralCheck;
_getPausableFlags = _getPausableFlagsWithoutCollateralCheck;
}
nativeValueToCheckPauseState = _nativeValueToCheckPauseState;
}
/**
* @dev Modifier to make a function callable only when the specified flags are not paused
* @dev Throws when any of the flags specified are paused
*
* @param _flags The flags to check for pause state
*/
modifier whenNotPaused(uint256 _flags) {
_requireNotPaused(_flags);
_;
}
/**
* @dev Modifier to make a function callable only when the specified flags are paused
* @dev Throws when any of the flags specified are not paused
*
* @param _flags The flags to check for pause state
*/
modifier whenPaused(uint256 _flags) {
_requirePaused(_flags);
_;
}
/**
* @dev Modifier to make a function callable only by a permissioned account
* @dev Throws when the caller does not have permission
*/
modifier onlyPausePermissionedCaller() {
_requireCallerHasPausePermissions();
_;
}
/**
* @notice Updates the pausable flags settings
*
* @dev Throws when the caller does not have permission
* @dev **NOTE:** Pausable flag settings will only take effect if contract balance exceeds
* @dev `nativeValueToPause`
*
* @dev <h4>Postconditions:</h4>
* @dev 1. address(this).balance increases by msg.value
* @dev 2. `pausableFlags` is set to the new value
* @dev 3. Emits a PausableFlagsUpdated event
*
* @param _pausableFlags The new pausable flags to set
*/
function pause(uint256 _pausableFlags) external payable onlyPausePermissionedCaller {
_setPausableFlags(_pausableFlags);
}
/**
* @notice Allows any account to supply funds for enabling the pausable checks
*
* @dev **NOTE:** The threshold check for pausable collateral does not pause
* @dev any functions unless the associated pausable flag is set.
*/
function pausableDepositCollateral() external payable {
// thank you for your contribution to safety
}
/**
* @notice Resets all pausable flags to unpaused and withdraws funds
*
* @dev Throws when the caller does not have permission
*
* @dev <h4>Postconditions:</h4>
* @dev 1. `pausableFlags` is set to zero
* @dev 2. Emits a PausableFlagsUpdated event
* @dev 3. Transfers `withdrawAmount` of native funds to `withdrawTo` if non-zero
*
* @param withdrawTo The address to withdraw the collateral to
* @param withdrawAmount The amount of collateral to withdraw
*/
function unpause(address withdrawTo, uint256 withdrawAmount) external onlyPausePermissionedCaller {
_setPausableFlags(0);
if (withdrawAmount > 0) {
(bool success, ) = withdrawTo.call{value: withdrawAmount}("");
if(!success) revert CollateralizedPausableFlags__WithdrawFailed();
}
}
/**
* @notice Returns collateralized pausable configuration information
*
* @return _nativeValueToCheckPauseState The collateral required to enable pause state checking
* @return _pausableFlags The current pausable flags set, only checked when collateral met
*/
function pausableConfigurationSettings() external view returns(
uint256 _nativeValueToCheckPauseState,
uint256 _pausableFlags
) {
unchecked {
_nativeValueToCheckPauseState = nativeValueToCheckPauseState + 1;
_pausableFlags = pausableFlags;
}
}
/**
* @notice Updates the `pausableFlags` variable and emits a PausableFlagsUpdated event
*
* @param _pausableFlags The new pausable flags to set
*/
function _setPausableFlags(uint256 _pausableFlags) internal {
uint256 previousFlags = pausableFlags;
pausableFlags = _pausableFlags;
emit PausableFlagsUpdated(previousFlags, _pausableFlags);
}
/**
* @notice Checks the current pause state of the supplied flags and reverts if any are paused
*
* @dev *Should* be called prior to any transfers of native funds out of the contract for efficiency
* @dev Throws when the native funds balance is greater than the value to enable pausing AND
* @dev one or more of the supplied `_flags` is paused.
*
* @param _flags The flags to check for pause state
*/
function _requireNotPausedWithCollateralCheck(uint256 _flags) private view {
if (_nativeBalanceSubMsgValue() > nativeValueToCheckPauseState) {
if (pausableFlags & _flags > 0) {
revert CollateralizedPausableFlags__Paused();
}
}
}
/**
* @notice Checks the current pause state of the supplied flags and reverts if any are paused
*
* @dev Throws when one or more of the supplied `_flags` is paused.
*
* @param _flags The flags to check for pause state
*/
function _requireNotPausedWithoutCollateralCheck(uint256 _flags) private view {
if (pausableFlags & _flags > 0) {
revert CollateralizedPausableFlags__Paused();
}
}
/**
* @notice Checks the current pause state of the supplied flags and reverts if none are paused
*
* @dev *Should* be called prior to any transfers of native funds out of the contract for efficiency
* @dev Throws when the native funds balance is not greater than the value to enable pausing OR
* @dev none of the supplied `_flags` are paused.
*
* @param _flags The flags to check for pause state
*/
function _requirePausedWithCollateralCheck(uint256 _flags) private view {
if (_nativeBalanceSubMsgValue() <= nativeValueToCheckPauseState) {
revert CollateralizedPausableFlags__NotPaused();
} else if (pausableFlags & _flags == 0) {
revert CollateralizedPausableFlags__NotPaused();
}
}
/**
* @notice Checks the current pause state of the supplied flags and reverts if none are paused
*
* @dev Throws when none of the supplied `_flags` are paused.
*
* @param _flags The flags to check for pause state
*/
function _requirePausedWithoutCollateralCheck(uint256 _flags) private view {
if (pausableFlags & _flags == 0) {
revert CollateralizedPausableFlags__NotPaused();
}
}
/**
* @notice Returns the current state of the pausable flags
*
* @dev Will return zero if the native funds balance is not greater than the value to enable pausing
*
* @return _pausableFlags The current state of the pausable flags
*/
function _getPausableFlagsWithCollateralCheck() private view returns(uint256 _pausableFlags) {
if (_nativeBalanceSubMsgValue() > nativeValueToCheckPauseState) {
_pausableFlags = pausableFlags;
}
}
/**
* @notice Returns the current state of the pausable flags
*
* @return _pausableFlags The current state of the pausable flags
*/
function _getPausableFlagsWithoutCollateralCheck() private view returns(uint256 _pausableFlags) {
_pausableFlags = pausableFlags;
}
/**
* @notice Returns the current contract balance minus the value sent with the call
*
* @dev This is expected to be the contract balance at the beginning of a function call
* @dev to efficiently determine whether a contract has the necessary collateral to enable
* @dev the pausable flags checking for contracts that hold native token funds.
* @dev This should **NOT** be used in any way to determine current balance for contract logic
* @dev other than its intended purpose for pause state checking activation.
*/
function _nativeBalanceSubMsgValue() private view returns (uint256 _value) {
unchecked {
_value = address(this).balance - msg.value;
}
}
/**
* @dev To be implemented by an inheriting contract for authorization to `pause` and `unpause`
* @dev functions as well as any functions in the inheriting contract that utilize the
* @dev `onlyPausePermissionedCaller` modifier.
*
* @dev Implementing contract function **MUST** throw when the caller is not permissioned
*/
function _requireCallerHasPausePermissions() internal view virtual;
}pragma solidity ^0.8.4;
/**
* @dev Interface of the ERC-165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[ERC].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[ERC section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20 {
/**
* @dev Emitted when `value` tokens are moved from one account (`from`) to
* another (`to`).
*
* Note that `value` may be zero.
*/
event Transfer(address indexed from, address indexed to, uint256 value);
/**
* @dev Emitted when the allowance of a `spender` for an `owner` is set by
* a call to {approve}. `value` is the new allowance.
*/
event Approval(address indexed owner, address indexed spender, uint256 value);
/**
* @dev Returns the amount of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the amount of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves `amount` tokens from the caller's account to `to`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address to, uint256 amount) external returns (bool);
/**
* @dev Returns the remaining number of tokens that `spender` will be
* allowed to spend on behalf of `owner` through {transferFrom}. This is
* zero by default.
*
* This value changes when {approve} or {transferFrom} are called.
*/
function allowance(address owner, address spender) external view returns (uint256);
/**
* @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* IMPORTANT: Beware that changing an allowance with this method brings the risk
* that someone may use both the old and the new allowance by unfortunate
* transaction ordering. One possible solution to mitigate this race
* condition is to first reduce the spender's allowance to 0 and set the
* desired value afterwards:
* https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
*
* Emits an {Approval} event.
*/
function approve(address spender, uint256 amount) external returns (bool);
/**
* @dev Moves `amount` tokens from `from` to `to` using the
* allowance mechanism. `amount` is then deducted from the caller's
* allowance.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transferFrom(address from, address to, uint256 amount) external returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC721/IERC721.sol)
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC721 compliant contract.
*/
interface IERC721 is IERC165 {
/**
* @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`.
*
* 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 calldata data) external;
/**
* @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 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) external;
/**
* @dev Transfers `tokenId` token from `from` to `to`.
*
* WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
* or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
* understand this adds an external call which potentially creates a reentrancy vulnerability.
*
* 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;
/**
* @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;
/**
* @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);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC1155/IERC1155.sol)
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC1155 compliant contract, as defined in the
* https://eips.ethereum.org/EIPS/eip-1155[EIP].
*
* _Available since v3.1._
*/
interface IERC1155 is IERC165 {
/**
* @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
*/
event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
/**
* @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
* transfers.
*/
event TransferBatch(
address indexed operator,
address indexed from,
address indexed to,
uint256[] ids,
uint256[] values
);
/**
* @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
* `approved`.
*/
event ApprovalForAll(address indexed account, address indexed operator, bool approved);
/**
* @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
*
* If an {URI} event was emitted for `id`, the standard
* https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
* returned by {IERC1155MetadataURI-uri}.
*/
event URI(string value, uint256 indexed id);
/**
* @dev Returns the amount of tokens of token type `id` owned by `account`.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function balanceOf(address account, uint256 id) external view returns (uint256);
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
*
* Requirements:
*
* - `accounts` and `ids` must have the same length.
*/
function balanceOfBatch(
address[] calldata accounts,
uint256[] calldata ids
) external view returns (uint256[] memory);
/**
* @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
*
* Emits an {ApprovalForAll} event.
*
* Requirements:
*
* - `operator` cannot be the caller.
*/
function setApprovalForAll(address operator, bool approved) external;
/**
* @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address account, address operator) external view returns (bool);
/**
* @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}.
* - `from` must have a balance of tokens of type `id` of at least `amount`.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
* acceptance magic value.
*/
function safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes calldata data) external;
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `amounts` must have the same length.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
function safeBatchTransferFrom(
address from,
address to,
uint256[] calldata ids,
uint256[] calldata amounts,
bytes calldata data
) external;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Context.sol)
pragma solidity ^0.8.0;
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)
pragma solidity ^0.8.0;
import "../Strings.sol";
/**
* @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
*
* These functions can be used to verify that a message was signed by the holder
* of the private keys of a given address.
*/
library ECDSA {
enum RecoverError {
NoError,
InvalidSignature,
InvalidSignatureLength,
InvalidSignatureS,
InvalidSignatureV // Deprecated in v4.8
}
function _throwError(RecoverError error) private pure {
if (error == RecoverError.NoError) {
return; // no error: do nothing
} else if (error == RecoverError.InvalidSignature) {
revert("ECDSA: invalid signature");
} else if (error == RecoverError.InvalidSignatureLength) {
revert("ECDSA: invalid signature length");
} else if (error == RecoverError.InvalidSignatureS) {
revert("ECDSA: invalid signature 's' value");
}
}
/**
* @dev Returns the address that signed a hashed message (`hash`) with
* `signature` or error string. This address can then be used for verification purposes.
*
* The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
* this function rejects them by requiring the `s` value to be in the lower
* half order, and the `v` value to be either 27 or 28.
*
* IMPORTANT: `hash` _must_ be the result of a hash operation for the
* verification to be secure: it is possible to craft signatures that
* recover to arbitrary addresses for non-hashed data. A safe way to ensure
* this is by receiving a hash of the original message (which may otherwise
* be too long), and then calling {toEthSignedMessageHash} on it.
*
* Documentation for signature generation:
* - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
* - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
*
* _Available since v4.3._
*/
function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
if (signature.length == 65) {
bytes32 r;
bytes32 s;
uint8 v;
// ecrecover takes the signature parameters, and the only way to get them
// currently is to use assembly.
/// @solidity memory-safe-assembly
assembly {
r := mload(add(signature, 0x20))
s := mload(add(signature, 0x40))
v := byte(0, mload(add(signature, 0x60)))
}
return tryRecover(hash, v, r, s);
} else {
return (address(0), RecoverError.InvalidSignatureLength);
}
}
/**
* @dev Returns the address that signed a hashed message (`hash`) with
* `signature`. This address can then be used for verification purposes.
*
* The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
* this function rejects them by requiring the `s` value to be in the lower
* half order, and the `v` value to be either 27 or 28.
*
* IMPORTANT: `hash` _must_ be the result of a hash operation for the
* verification to be secure: it is possible to craft signatures that
* recover to arbitrary addresses for non-hashed data. A safe way to ensure
* this is by receiving a hash of the original message (which may otherwise
* be too long), and then calling {toEthSignedMessageHash} on it.
*/
function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, signature);
_throwError(error);
return recovered;
}
/**
* @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
*
* See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
*
* _Available since v4.3._
*/
function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {
bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
uint8 v = uint8((uint256(vs) >> 255) + 27);
return tryRecover(hash, v, r, s);
}
/**
* @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
*
* _Available since v4.2._
*/
function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, r, vs);
_throwError(error);
return recovered;
}
/**
* @dev Overload of {ECDSA-tryRecover} that receives the `v`,
* `r` and `s` signature fields separately.
*
* _Available since v4.3._
*/
function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {
// EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
// unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
// the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
// signatures from current libraries generate a unique signature with an s-value in the lower half order.
//
// If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
// with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
// vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
// these malleable signatures as well.
if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
return (address(0), RecoverError.InvalidSignatureS);
}
// If the signature is valid (and not malleable), return the signer address
address signer = ecrecover(hash, v, r, s);
if (signer == address(0)) {
return (address(0), RecoverError.InvalidSignature);
}
return (signer, RecoverError.NoError);
}
/**
* @dev Overload of {ECDSA-recover} that receives the `v`,
* `r` and `s` signature fields separately.
*/
function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, v, r, s);
_throwError(error);
return recovered;
}
/**
* @dev Returns an Ethereum Signed Message, created from a `hash`. This
* produces hash corresponding to the one signed with the
* https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
* JSON-RPC method as part of EIP-191.
*
* See {recover}.
*/
function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {
// 32 is the length in bytes of hash,
// enforced by the type signature above
/// @solidity memory-safe-assembly
assembly {
mstore(0x00, "\x19Ethereum Signed Message:\n32")
mstore(0x1c, hash)
message := keccak256(0x00, 0x3c)
}
}
/**
* @dev Returns an Ethereum Signed Message, created from `s`. This
* produces hash corresponding to the one signed with the
* https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
* JSON-RPC method as part of EIP-191.
*
* See {recover}.
*/
function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", Strings.toString(s.length), s));
}
/**
* @dev Returns an Ethereum Signed Typed Data, created from a
* `domainSeparator` and a `structHash`. This produces hash corresponding
* to the one signed with the
* https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
* JSON-RPC method as part of EIP-712.
*
* See {recover}.
*/
function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {
/// @solidity memory-safe-assembly
assembly {
let ptr := mload(0x40)
mstore(ptr, "\x19\x01")
mstore(add(ptr, 0x02), domainSeparator)
mstore(add(ptr, 0x22), structHash)
data := keccak256(ptr, 0x42)
}
}
/**
* @dev Returns an Ethereum Signed Data with intended validator, created from a
* `validator` and `data` according to the version 0 of EIP-191.
*
* See {recover}.
*/
function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {
return keccak256(abi.encodePacked("\x19\x00", validator, data));
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)
pragma solidity ^0.8.0;
import "./math/Math.sol";
import "./math/SignedMath.sol";
/**
* @dev String operations.
*/
library Strings {
bytes16 private constant _SYMBOLS = "0123456789abcdef";
uint8 private constant _ADDRESS_LENGTH = 20;
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
unchecked {
uint256 length = Math.log10(value) + 1;
string memory buffer = new string(length);
uint256 ptr;
/// @solidity memory-safe-assembly
assembly {
ptr := add(buffer, add(32, length))
}
while (true) {
ptr--;
/// @solidity memory-safe-assembly
assembly {
mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
}
value /= 10;
if (value == 0) break;
}
return buffer;
}
}
/**
* @dev Converts a `int256` to its ASCII `string` decimal representation.
*/
function toString(int256 value) internal pure returns (string memory) {
return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMath.abs(value))));
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
unchecked {
return toHexString(value, Math.log256(value) + 1);
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
bytes memory buffer = new bytes(2 * length + 2);
buffer[0] = "0";
buffer[1] = "x";
for (uint256 i = 2 * length + 1; i > 1; --i) {
buffer[i] = _SYMBOLS[value & 0xf];
value >>= 4;
}
require(value == 0, "Strings: hex length insufficient");
return string(buffer);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
*/
function toHexString(address addr) internal pure returns (string memory) {
return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
}
/**
* @dev Returns true if the two strings are equal.
*/
function equal(string memory a, string memory b) internal pure returns (bool) {
return keccak256(bytes(a)) == keccak256(bytes(b));
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library Math {
enum Rounding {
Down, // Toward negative infinity
Up, // Toward infinity
Zero // Toward zero
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds up instead
* of rounding down.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b - 1) / b can overflow on addition, so we distribute.
return a == 0 ? 0 : (a - 1) / b + 1;
}
/**
* @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
* @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
* with further edits by Uniswap Labs also under MIT license.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
unchecked {
// 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
// use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = prod1 * 2^256 + prod0.
uint256 prod0; // Least significant 256 bits of the product
uint256 prod1; // Most significant 256 bits of the product
assembly {
let mm := mulmod(x, y, not(0))
prod0 := mul(x, y)
prod1 := sub(sub(mm, prod0), lt(mm, prod0))
}
// Handle non-overflow cases, 256 by 256 division.
if (prod1 == 0) {
// Solidity will revert if denominator == 0, unlike the div opcode on its own.
// The surrounding unchecked block does not change this fact.
// See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
return prod0 / denominator;
}
// Make sure the result is less than 2^256. Also prevents denominator == 0.
require(denominator > prod1, "Math: mulDiv overflow");
///////////////////////////////////////////////
// 512 by 256 division.
///////////////////////////////////////////////
// Make division exact by subtracting the remainder from [prod1 prod0].
uint256 remainder;
assembly {
// Compute remainder using mulmod.
remainder := mulmod(x, y, denominator)
// Subtract 256 bit number from 512 bit number.
prod1 := sub(prod1, gt(remainder, prod0))
prod0 := sub(prod0, remainder)
}
// Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
// See https://cs.stackexchange.com/q/138556/92363.
// Does not overflow because the denominator cannot be zero at this stage in the function.
uint256 twos = denominator & (~denominator + 1);
assembly {
// Divide denominator by twos.
denominator := div(denominator, twos)
// Divide [prod1 prod0] by twos.
prod0 := div(prod0, twos)
// Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
twos := add(div(sub(0, twos), twos), 1)
}
// Shift in bits from prod1 into prod0.
prod0 |= prod1 * twos;
// Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
// that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
// four bits. That is, denominator * inv = 1 mod 2^4.
uint256 inverse = (3 * denominator) ^ 2;
// Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
// in modular arithmetic, doubling the correct bits in each step.
inverse *= 2 - denominator * inverse; // inverse mod 2^8
inverse *= 2 - denominator * inverse; // inverse mod 2^16
inverse *= 2 - denominator * inverse; // inverse mod 2^32
inverse *= 2 - denominator * inverse; // inverse mod 2^64
inverse *= 2 - denominator * inverse; // inverse mod 2^128
inverse *= 2 - denominator * inverse; // inverse mod 2^256
// Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
// This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
// less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
// is no longer required.
result = prod0 * inverse;
return result;
}
}
/**
* @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {
uint256 result = mulDiv(x, y, denominator);
if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
result += 1;
}
return result;
}
/**
* @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
*
* Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
*/
function sqrt(uint256 a) internal pure returns (uint256) {
if (a == 0) {
return 0;
}
// For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
//
// We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
// `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
//
// This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
// → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
// → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
//
// Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
uint256 result = 1 << (log2(a) >> 1);
// At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
// since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
// every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
// into the expected uint128 result.
unchecked {
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
return min(result, a / result);
}
}
/**
* @notice Calculates sqrt(a), following the selected rounding direction.
*/
function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = sqrt(a);
return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
}
}
/**
* @dev Return the log in base 2, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 128;
}
if (value >> 64 > 0) {
value >>= 64;
result += 64;
}
if (value >> 32 > 0) {
value >>= 32;
result += 32;
}
if (value >> 16 > 0) {
value >>= 16;
result += 16;
}
if (value >> 8 > 0) {
value >>= 8;
result += 8;
}
if (value >> 4 > 0) {
value >>= 4;
result += 4;
}
if (value >> 2 > 0) {
value >>= 2;
result += 2;
}
if (value >> 1 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 2, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log2(value);
return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 10, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >= 10 ** 64) {
value /= 10 ** 64;
result += 64;
}
if (value >= 10 ** 32) {
value /= 10 ** 32;
result += 32;
}
if (value >= 10 ** 16) {
value /= 10 ** 16;
result += 16;
}
if (value >= 10 ** 8) {
value /= 10 ** 8;
result += 8;
}
if (value >= 10 ** 4) {
value /= 10 ** 4;
result += 4;
}
if (value >= 10 ** 2) {
value /= 10 ** 2;
result += 2;
}
if (value >= 10 ** 1) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log10(value);
return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 256, rounded down, of a positive value.
* Returns 0 if given 0.
*
* Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
*/
function log256(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 16;
}
if (value >> 64 > 0) {
value >>= 64;
result += 8;
}
if (value >> 32 > 0) {
value >>= 32;
result += 4;
}
if (value >> 16 > 0) {
value >>= 16;
result += 2;
}
if (value >> 8 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 256, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log256(value);
return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard signed math utilities missing in the Solidity language.
*/
library SignedMath {
/**
* @dev Returns the largest of two signed numbers.
*/
function max(int256 a, int256 b) internal pure returns (int256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two signed numbers.
*/
function min(int256 a, int256 b) internal pure returns (int256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two signed numbers without overflow.
* The result is rounded towards zero.
*/
function average(int256 a, int256 b) internal pure returns (int256) {
// Formula from the book "Hacker's Delight"
int256 x = (a & b) + ((a ^ b) >> 1);
return x + (int256(uint256(x) >> 255) & (a ^ b));
}
/**
* @dev Returns the absolute unsigned value of a signed value.
*/
function abs(int256 n) internal pure returns (uint256) {
unchecked {
// must be unchecked in order to support `n = type(int256).min`
return uint256(n >= 0 ? n : -n);
}
}
}{
"viaIR": false,
"codegen": "yul",
"remappings": [
"ds-test/=lib/forge-std/lib/ds-test/src/",
"forge-std/=lib/forge-std/src/",
"@limitbreak/tm-core-lib/=lib/tm-core-lib/",
"@limitbreak/permit-c/=lib/PermitC/src/",
"@openzeppelin/=lib/PermitC/lib/openzeppelin-contracts/",
"@rari-capital/solmate/=lib/PermitC/lib/solmate/",
"PermitC/=lib/PermitC/",
"erc4626-tests/=lib/PermitC/lib/openzeppelin-contracts/lib/erc4626-tests/",
"forge-gas-metering/=lib/PermitC/lib/forge-gas-metering/",
"openzeppelin-contracts/=lib/PermitC/lib/openzeppelin-contracts/",
"openzeppelin/=lib/PermitC/lib/openzeppelin-contracts/contracts/",
"solady/=lib/PermitC/lib/forge-gas-metering/lib/solady/",
"solmate/=lib/PermitC/lib/solmate/src/",
"tm-core-lib/=lib/tm-core-lib/src/"
],
"evmVersion": "cancun",
"outputSelection": {
"*": {
"*": [
"abi",
"metadata"
],
"": [
"ast"
]
}
},
"optimizer": {
"enabled": true,
"mode": "3",
"fallback_to_optimizing_for_size": false,
"disable_system_request_memoization": true
},
"metadata": {},
"libraries": {},
"enableEraVMExtensions": false,
"forceEVMLA": false
}[{"inputs":[{"internalType":"address","name":"defaultOwner","type":"address"},{"internalType":"address","name":"eoaRegistry_","type":"address"},{"internalType":"string","name":"name","type":"string"},{"internalType":"string","name":"version","type":"string"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"CollateralizedPausableFlags__NotPaused","type":"error"},{"inputs":[],"name":"CollateralizedPausableFlags__Paused","type":"error"},{"inputs":[],"name":"CollateralizedPausableFlags__WithdrawFailed","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__AuthorizationDisabledForCollection","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__CallerDoesNotOwnList","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__CallerMustBeAnAuthorizer","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__CallerMustBeWhitelisted","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__CallerMustHaveElevatedPermissionsForSpecifiedNFT","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__CannotReassignOwnershipOfDefaultList","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__InvalidConstructorArgs","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__InvalidTransferSecurityLevel","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__ListDoesNotExist","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__ListOwnershipCannotBeTransferredToZeroAddress","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__OperatorIsBlacklisted","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__ReceiverAccountIsFrozen","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__ReceiverMustNotHaveDeployedCode","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__ReceiverProofOfEOASignatureUnverified","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__SenderAccountIsFrozen","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__TokenIsSoulbound","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__TokenTypesDoNotMatch","type":"error"},{"inputs":[],"name":"CreatorTokenTransferValidator__WildcardOperatorsCannotBeAuthorizedForCollection","type":"error"},{"inputs":[],"name":"Ownable__CallerIsNotOwner","type":"error"},{"inputs":[],"name":"Ownable__NewOwnerIsZeroAddress","type":"error"},{"inputs":[],"name":"PermitC__AmountExceedsStorageMaximum","type":"error"},{"inputs":[],"name":"PermitC__ApprovalTransferExceededPermittedAmount","type":"error"},{"inputs":[],"name":"PermitC__ApprovalTransferPermitExpiredOrUnset","type":"error"},{"inputs":[],"name":"PermitC__CallerMustBeOwnerOrOperator","type":"error"},{"inputs":[],"name":"PermitC__InvalidTokenType","type":"error"},{"inputs":[],"name":"PermitC__NonceAlreadyUsedOrRevoked","type":"error"},{"inputs":[],"name":"PermitC__NonceNotUsedOrRevoked","type":"error"},{"inputs":[],"name":"PermitC__OrderIsEitherCancelledOrFilled","type":"error"},{"inputs":[],"name":"PermitC__SignatureTransferExceededPermitExpired","type":"error"},{"inputs":[],"name":"PermitC__SignatureTransferExceededPermittedAmount","type":"error"},{"inputs":[],"name":"PermitC__SignatureTransferInvalidSignature","type":"error"},{"inputs":[],"name":"PermitC__SignatureTransferPermitHashNotRegistered","type":"error"},{"inputs":[],"name":"PermitC__UnableToFillMinimumRequestedQuantity","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"collection","type":"address"},{"indexed":true,"internalType":"address","name":"account","type":"address"}],"name":"AccountFrozenForCollection","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"collection","type":"address"},{"indexed":true,"internalType":"address","name":"account","type":"address"}],"name":"AccountUnfrozenForCollection","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint8","name":"kind","type":"uint8"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"account","type":"address"}],"name":"AddedAccountToList","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint8","name":"kind","type":"uint8"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"bytes32","name":"codehash","type":"bytes32"}],"name":"AddedCodeHashToList","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"collection","type":"address"},{"indexed":true,"internalType":"uint120","name":"id","type":"uint120"}],"name":"AppliedListToCollection","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"token","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"uint200","name":"amount","type":"uint200"},{"indexed":false,"internalType":"uint48","name":"expiration","type":"uint48"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"string","name":"name","type":"string"}],"name":"CreatedList","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"}],"name":"Lockdown","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"orderId","type":"bytes32"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"wasCancellation","type":"bool"}],"name":"OrderClosed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"orderId","type":"bytes32"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"OrderFilled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"orderId","type":"bytes32"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"uint256","name":"fillableQuantity","type":"uint256"}],"name":"OrderOpened","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"orderId","type":"bytes32"},{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"amountRestoredToOrder","type":"uint256"}],"name":"OrderRestored","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"previousFlags","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"newFlags","type":"uint256"}],"name":"PausableFlagsUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"ReassignedListOwnership","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint8","name":"kind","type":"uint8"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"address","name":"account","type":"address"}],"name":"RemovedAccountFromList","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint8","name":"kind","type":"uint8"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":true,"internalType":"bytes32","name":"codehash","type":"bytes32"}],"name":"RemovedCodeHashFromList","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"collection","type":"address"},{"indexed":false,"internalType":"bool","name":"enabled","type":"bool"}],"name":"SetAccountFreezingModeEnabled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"collection","type":"address"},{"indexed":false,"internalType":"bool","name":"disabled","type":"bool"},{"indexed":false,"internalType":"bool","name":"authorizersCannotSetWildcardOperators","type":"bool"}],"name":"SetAuthorizationModeEnabled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"collection","type":"address"},{"indexed":false,"internalType":"uint16","name":"tokenType","type":"uint16"}],"name":"SetTokenType","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"collection","type":"address"},{"indexed":false,"internalType":"uint8","name":"level","type":"uint8"}],"name":"SetTransferSecurityLevel","type":"event"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"address[]","name":"accounts","type":"address[]"}],"name":"addAccountsToAuthorizers","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"address[]","name":"accounts","type":"address[]"}],"name":"addAccountsToBlacklist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"address[]","name":"accounts","type":"address[]"}],"name":"addAccountsToWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"bytes32[]","name":"codehashes","type":"bytes32[]"}],"name":"addCodeHashesToBlacklist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"bytes32[]","name":"codehashes","type":"bytes32[]"}],"name":"addCodeHashesToWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"afterAuthorizedTransfer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"afterAuthorizedTransfer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"afterAuthorizedTransferWithAmount","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint256","name":"tokenType","type":"uint256"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"allowedAmount","type":"uint256"},{"internalType":"uint256","name":"expiration","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint256","name":"tokenType","type":"uint256"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"bytes32","name":"orderId","type":"bytes32"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"allowedAmount","type":"uint256"},{"internalType":"uint256","name":"expiration","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"caller","type":"address"},{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"}],"name":"applyCollectionTransferPolicy","outputs":[],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"uint120","name":"id","type":"uint120"}],"name":"applyListToCollection","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenType","type":"uint256"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint200","name":"amount","type":"uint200"},{"internalType":"uint48","name":"expiration","type":"uint48"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"beforeAuthorizedTransfer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"address","name":"token","type":"address"}],"name":"beforeAuthorizedTransfer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"beforeAuthorizedTransfer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"}],"name":"beforeAuthorizedTransferWithAmount","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint256","name":"tokenType","type":"uint256"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"bytes32","name":"orderId","type":"bytes32"}],"name":"closePermittedOrder","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"name","type":"string"}],"name":"createList","outputs":[{"internalType":"uint120","name":"id","type":"uint120"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"name","type":"string"},{"internalType":"uint120","name":"sourceListId","type":"uint120"}],"name":"createListCopy","outputs":[{"internalType":"uint120","name":"id","type":"uint120"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"domainSeparatorV4","outputs":[{"internalType":"bytes32","name":"domainSeparator","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes","name":"signedPermit","type":"bytes"},{"components":[{"internalType":"uint256","name":"orderStartAmount","type":"uint256"},{"internalType":"uint256","name":"requestedFillAmount","type":"uint256"},{"internalType":"uint256","name":"minimumFillAmount","type":"uint256"}],"internalType":"struct OrderFillAmounts","name":"orderFillAmounts","type":"tuple"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"salt","type":"uint256"},{"internalType":"uint48","name":"expiration","type":"uint48"},{"internalType":"bytes32","name":"orderId","type":"bytes32"},{"internalType":"bytes32","name":"advancedPermitHash","type":"bytes32"}],"name":"fillPermittedOrderERC1155","outputs":[{"internalType":"uint256","name":"quantityFilled","type":"uint256"},{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes","name":"signedPermit","type":"bytes"},{"components":[{"internalType":"uint256","name":"orderStartAmount","type":"uint256"},{"internalType":"uint256","name":"requestedFillAmount","type":"uint256"},{"internalType":"uint256","name":"minimumFillAmount","type":"uint256"}],"internalType":"struct OrderFillAmounts","name":"orderFillAmounts","type":"tuple"},{"internalType":"address","name":"token","type":"address"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"salt","type":"uint256"},{"internalType":"uint48","name":"expiration","type":"uint48"},{"internalType":"bytes32","name":"orderId","type":"bytes32"},{"internalType":"bytes32","name":"advancedPermitHash","type":"bytes32"}],"name":"fillPermittedOrderERC20","outputs":[{"internalType":"uint256","name":"quantityFilled","type":"uint256"},{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"address[]","name":"accountsToFreeze","type":"address[]"}],"name":"freezeAccountsForCollection","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"}],"name":"getAuthorizerAccounts","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"}],"name":"getAuthorizerAccountsByCollection","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"}],"name":"getBlacklistedAccounts","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"}],"name":"getBlacklistedAccountsByCollection","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"}],"name":"getBlacklistedCodeHashes","outputs":[{"internalType":"bytes32[]","name":"","type":"bytes32[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"}],"name":"getBlacklistedCodeHashesByCollection","outputs":[{"internalType":"bytes32[]","name":"","type":"bytes32[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"}],"name":"getCollectionSecurityPolicy","outputs":[{"components":[{"internalType":"bool","name":"disableAuthorizationMode","type":"bool"},{"internalType":"bool","name":"authorizersCannotSetWildcardOperators","type":"bool"},{"internalType":"uint8","name":"transferSecurityLevel","type":"uint8"},{"internalType":"uint120","name":"listId","type":"uint120"},{"internalType":"bool","name":"enableAccountFreezingMode","type":"bool"},{"internalType":"uint16","name":"tokenType","type":"uint16"}],"internalType":"struct CollectionSecurityPolicyV3","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"}],"name":"getFrozenAccountsByCollection","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"}],"name":"getWhitelistedAccounts","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"}],"name":"getWhitelistedAccountsByCollection","outputs":[{"internalType":"address[]","name":"","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"}],"name":"getWhitelistedCodeHashes","outputs":[{"internalType":"bytes32[]","name":"","type":"bytes32[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"}],"name":"getWhitelistedCodeHashesByCollection","outputs":[{"internalType":"bytes32[]","name":"","type":"bytes32[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"nonce","type":"uint256"}],"name":"invalidateUnorderedNonce","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"address","name":"account","type":"address"}],"name":"isAccountAuthorizer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"address","name":"account","type":"address"}],"name":"isAccountAuthorizerOfCollection","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"address","name":"account","type":"address"}],"name":"isAccountBlacklisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"address","name":"account","type":"address"}],"name":"isAccountBlacklistedByCollection","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"address","name":"account","type":"address"}],"name":"isAccountFrozenForCollection","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"address","name":"account","type":"address"}],"name":"isAccountWhitelisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"address","name":"account","type":"address"}],"name":"isAccountWhitelistedByCollection","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"bytes32","name":"codehash","type":"bytes32"}],"name":"isCodeHashBlacklisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"bytes32","name":"codehash","type":"bytes32"}],"name":"isCodeHashBlacklistedByCollection","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"bytes32","name":"codehash","type":"bytes32"}],"name":"isCodeHashWhitelisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"bytes32","name":"codehash","type":"bytes32"}],"name":"isCodeHashWhitelistedByCollection","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"hash","type":"bytes32"}],"name":"isRegisteredOrderAdditionalDataHash","outputs":[{"internalType":"bool","name":"isRegistered","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"hash","type":"bytes32"}],"name":"isRegisteredTransferAdditionalDataHash","outputs":[{"internalType":"bool","name":"isRegistered","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"nonce","type":"uint256"}],"name":"isValidUnorderedNonce","outputs":[{"internalType":"bool","name":"isValid","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"isVerifiedEOA","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lastListId","outputs":[{"internalType":"uint120","name":"","type":"uint120"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint120","name":"","type":"uint120"}],"name":"listOwners","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lockdown","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"masterNonce","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pausableConfigurationSettings","outputs":[{"internalType":"uint256","name":"_nativeValueToCheckPauseState","type":"uint256"},{"internalType":"uint256","name":"_pausableFlags","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pausableDepositCollateral","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_pausableFlags","type":"uint256"}],"name":"pause","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"permitAmount","type":"uint256"},{"internalType":"uint256","name":"expiration","type":"uint256"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"transferAmount","type":"uint256"},{"internalType":"bytes","name":"signedPermit","type":"bytes"}],"name":"permitTransferFromERC1155","outputs":[{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"permitAmount","type":"uint256"},{"internalType":"uint256","name":"expiration","type":"uint256"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"transferAmount","type":"uint256"},{"internalType":"bytes","name":"signedPermit","type":"bytes"}],"name":"permitTransferFromERC20","outputs":[{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"expiration","type":"uint256"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"bytes","name":"signedPermit","type":"bytes"}],"name":"permitTransferFromERC721","outputs":[{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"permitAmount","type":"uint256"},{"internalType":"uint256","name":"expiration","type":"uint256"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"transferAmount","type":"uint256"},{"internalType":"bytes32","name":"additionalData","type":"bytes32"},{"internalType":"bytes32","name":"advancedPermitHash","type":"bytes32"},{"internalType":"bytes","name":"signedPermit","type":"bytes"}],"name":"permitTransferFromWithAdditionalDataERC1155","outputs":[{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"permitAmount","type":"uint256"},{"internalType":"uint256","name":"expiration","type":"uint256"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"transferAmount","type":"uint256"},{"internalType":"bytes32","name":"additionalData","type":"bytes32"},{"internalType":"bytes32","name":"advancedPermitHash","type":"bytes32"},{"internalType":"bytes","name":"signedPermit","type":"bytes"}],"name":"permitTransferFromWithAdditionalDataERC20","outputs":[{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint256","name":"expiration","type":"uint256"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"bytes32","name":"additionalData","type":"bytes32"},{"internalType":"bytes32","name":"advancedPermitHash","type":"bytes32"},{"internalType":"bytes","name":"signedPermit","type":"bytes"}],"name":"permitTransferFromWithAdditionalDataERC721","outputs":[{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"address","name":"newOwner","type":"address"}],"name":"reassignOwnershipOfList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"additionalDataTypeString","type":"string"}],"name":"registerAdditionalDataHash","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"address[]","name":"accounts","type":"address[]"}],"name":"removeAccountsFromAuthorizers","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"address[]","name":"accounts","type":"address[]"}],"name":"removeAccountsFromBlacklist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"address[]","name":"accounts","type":"address[]"}],"name":"removeAccountsFromWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"bytes32[]","name":"codehashes","type":"bytes32[]"}],"name":"removeCodeHashesFromBlacklist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"},{"internalType":"bytes32[]","name":"codehashes","type":"bytes32[]"}],"name":"removeCodeHashesFromWhitelist","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint120","name":"id","type":"uint120"}],"name":"renounceOwnershipOfList","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"uint16","name":"tokenType","type":"uint16"}],"name":"setTokenTypeOfCollection","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"uint8","name":"level","type":"uint8"},{"internalType":"bool","name":"disableAuthorizationMode","type":"bool"},{"internalType":"bool","name":"disableWildcardOperators","type":"bool"},{"internalType":"bool","name":"enableAccountFreezingMode","type":"bool"}],"name":"setTransferSecurityLevelOfCollection","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFromERC1155","outputs":[{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFromERC20","outputs":[{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"transferFromERC721","outputs":[{"internalType":"bool","name":"isError","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"level","type":"uint256"}],"name":"transferSecurityPolicies","outputs":[{"internalType":"uint256","name":"callerConstraints","type":"uint256"},{"internalType":"uint256","name":"receiverConstraints","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"collection","type":"address"},{"internalType":"address[]","name":"accountsToUnfreeze","type":"address[]"}],"name":"unfreezeAccountsForCollection","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"withdrawTo","type":"address"},{"internalType":"uint256","name":"withdrawAmount","type":"uint256"}],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenType","type":"uint256"},{"internalType":"address","name":"token","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"nonce","type":"uint256"},{"internalType":"uint200","name":"amount","type":"uint200"},{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint48","name":"approvalExpiration","type":"uint48"},{"internalType":"uint48","name":"sigDeadline","type":"uint48"},{"internalType":"address","name":"owner","type":"address"},{"internalType":"bytes","name":"signedPermit","type":"bytes"}],"name":"updateApprovalBySignature","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"caller","type":"address"},{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"}],"name":"validateTransfer","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"caller","type":"address"},{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"}],"name":"validateTransfer","outputs":[],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"caller","type":"address"},{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"validateTransfer","outputs":[],"stateMutability":"view","type":"function"}]Contract Creation Code
9c4d535b0000000000000000000000000000000000000000000000000000000000000000010016f5a2d0e11d2bdc3c31e3b90b4d1a68b1b20374d8232c7920f90a27f182000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000001000000000000000000000000001a38eb41b74622cbfa733210ec3c85bea1658d9d0000000000000000000000001a589d072a1529c4d3d9e8262f84e57d6febc027000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000001d43726561746f72546f6b656e5472616e7366657256616c696461746f7200000000000000000000000000000000000000000000000000000000000000000000013400000000000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x00040000000000020011000000000002000000000801034f0000006003100270000015d80130019700030000001803550002000000080355000015d80030019d0000000100200190000001020000c13d0000008002000039000000400020043f000000040010008c0000012a0000413d000000000208043b000000e002200270000015f10020009c0000012c0000a13d000015f20020009c0000018d0000a13d000015f30020009c000002cf0000a13d000015f40020009c000004050000213d000015fc0020009c000007850000213d000016000020009c000013ba0000613d000016010020009c00000f8a0000613d000016020020009c0000012a0000c13d000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000016750020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000a00000003001d000015dc0030009c0000012a0000213d000900240020003d0000000a0200002900000005022002100000000902200029000000000012004b0000012a0000213d0000000801000029000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000f00000001001d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000a0000006b000015900000613d0000000f02000029000b00020020003d000700050020003d000c00030020003d000f00000000001d0000006c0000013d0000000f020000290000000102200039000f00000002001d0000000a0020006c000015900000813d0000000f01000029000000050110021000000009011000290000000201100367000000000101043b000e00000001001d000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000000002004b000000670000613d0000000b01000029000000000301041a000000000003004b00001fcd0000613d000000000032004b000d00000002001d000000c20000613d000600000003001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d020000290005000100200092000000000101043b0000000b03000029000000000203041a000000050020006c000030790000a13d0000000602000029000000010220008a0000000001120019000000000101041a000600000001001d000000000030043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000005011000290000000602000029000000000021041b000000000020043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000d02000029000000000021041b0000000b01000029000000000201041a000d00000002001d000000000002004b0000241e0000613d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d02000029000000010220008a000000000101043b0000000001210019000000000001041b0000000b01000029000000000021041b0000000e01000029000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000001041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167904000041000000000500001900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000016e202200197000000000021041b000000670000013d000001e003000039000000400030043f0000000002000416000000000002004b0000012a0000c13d0000001f02100039000015d902200197000001e002200039000000400020043f0000001f0410018f000015da05100198000001e002500039000001140000613d000000000608034f000000006706043c0000000003730436000000000023004b000001100000c13d000000000004004b000001210000613d000000000358034f0000000304400210000000000502043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000320435000000800010008c0000012a0000413d000001e00600043d000015db0060009c0000012a0000213d000002000200043d000f00000002001d000015db0020009c0000029a0000a13d0000000001000019000056ae000104300000162e0020009c000001ac0000213d0000164c0020009c000003bc0000213d0000165b0020009c0000054c0000a13d0000165c0020009c000007c60000213d000016600020009c0000148e0000613d000016610020009c0000118f0000613d000016620020009c0000012a0000c13d000000a40010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000015db0010009c0000012a0000213d0000004401800370000000000101043b000d00000001001d000015db0010009c0000012a0000213d0000008401800370000000000101043b000b00000001001d0000006401800370000000000101043b000c00000001001d0000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015cc0001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000a00000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000a0010006b00001cca0000a13d0000000101000039000000000101041a000000020010019000000f870000c13d00001cca0000013d000016110020009c000002b40000213d000016200020009c000004210000a13d000016210020009c0000066f0000213d000016250020009c00000cda0000613d000016260020009c00000c340000613d000016270020009c0000012a0000c13d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d000000000010043f0000000b01000039000000200010043f0000004002000039000000000100001956ac566f0000040f000000000101041a000000180110027000001675011001970000151e0000013d0000162f0020009c000003f60000213d0000163e0020009c000005c50000a13d0000163f0020009c000007e00000213d000016430020009c000015150000613d000016440020009c0000119a0000613d000016450020009c0000012a0000c13d000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000016750020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000a00000003001d000015dc0030009c0000012a0000213d000900240020003d0000000a0200002900000005022002100000000902200029000000000012004b0000012a0000213d0000000801000029000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000f00000001001d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000a0000006b000015900000613d0000000f02000029000b00020020003d000700050020003d000c00030020003d000f00000000001d000002040000013d0000000f020000290000000102200039000f00000002001d0000000a0020006c000015900000813d0000000f01000029000000050110021000000009011000290000000201100367000000000101043b000e00000001001d000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000000002004b000001ff0000613d0000000b01000029000000000301041a000000000003004b00001fcd0000613d000000000032004b000d00000002001d0000025a0000613d000600000003001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d020000290005000100200092000000000101043b0000000b03000029000000000203041a000000050020006c000030790000a13d0000000602000029000000010220008a0000000001120019000000000101041a000600000001001d000000000030043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000005011000290000000602000029000000000021041b000000000020043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000d02000029000000000021041b0000000b01000029000000000201041a000d00000002001d000000000002004b0000241e0000613d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d02000029000000010220008a000000000101043b0000000001210019000000000001041b0000000b01000029000000000021041b0000000e01000029000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000001041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167904000041000000010500003900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000016e202200197000000000021041b000001ff0000013d000002200500043d000015dc0050009c0000012a0000213d0000001f02500039000000000012004b0000000003000019000015dd03008041000015dd02200197000000000002004b0000000004000019000015dd04004041000015dd0020009c000000000403c019000000000004004b0000012a0000c13d000e00000006001d000001e0025000390000000004020433000015dc0040009c000008bf0000a13d000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae00010430000016120020009c0000043a0000a13d000016130020009c000007200000213d000016170020009c00000ce20000613d000016180020009c00000be70000613d000016190020009c0000012a0000c13d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d0000002402800370000000000202043b000f00000002001d000015db0020009c0000012a0000213d000000000010043f0000000e010000390000133a0000013d000016030020009c000004c30000a13d000016040020009c000007750000213d000016080020009c000013580000613d000016090020009c00000eca0000613d0000160a0020009c0000012a0000c13d000000240010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000302043b000015dc0030009c0000012a0000213d0000002302300039000000000012004b0000012a0000813d0000000402300039000000000428034f000000000404043b000f00000004001d000015dc0040009c0000012a0000213d0000000f033000290000002403300039000000000013004b0000012a0000213d0000016001000039000000400010043f000000a501000039000000800010043f0000168901000041000000a00010043f0000168a03000041000000c00030043f0000168b04000041000000e00040043f0000168c05000041000001000050043f0000168d06000041000001200060043f0000168e07000041000001400070043f000001800010043f000001a00030043f000001c00040043f000001e00050043f000002000060043f000002200070043f0000000f01000029000016e3071001980000001f0910018f000c00200020003d0000000c028003600000022501700039000002250000043f000003130000613d0000022503000039000000000402034f000000004504043c0000000003530436000000000013004b0000030f0000c13d000000000009004b000003200000613d000000000272034f0000000303900210000000000401043300000000043401cf000000000434022f000000000202043b0000010003300089000000000232022f00000000023201cf000000000242019f0000000000210435000d00000009001d000e00000007001d0000000f0300002900000225013000390000000000010435000000e401300039000016e302100197000000a501300039000001600010043f0000168f0020009c000002ae0000213d0000016002200039000000400020043f000015d80010009c000015d80100804100000060011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f00001690011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000401000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b000000400100043d000015e60010009c000002ae0000213d000000c002100039000000400020043f000000a002100039000016910300004100000000003204350000008002100039000016920300004100000000003204350000006002100039000016930300004100000000003204350000004002100039000016940300004100000000003204350000009d02000039000000000321043600001695010000410000000000130435000000400100043d0000002002100039000000000400001900000000052400190000000006340019000000000606043300000000006504350000007d0040008c0000002004400039000003640000413d000000bd0310003900000000000304350000000e043000290000000c0500002900000002055003670000000e0000006b000003780000613d000000000605034f0000000007030019000000006806043c0000000007870436000000000047004b000003740000c13d0000000d0000006b000003860000613d0000000e055003600000000d060000290000000306600210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f00000000005404350000000f04000029000000000343001900000000000304350000009d034000390000000000310435000000dc03400039000016e3033001970000000003310019000000000013004b00000000040000390000000104004039000015dc0030009c000002ae0000213d0000000100400190000002ae0000c13d000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000501000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000001000019000056ad0001042e0000164d0020009c000006510000a13d0000164e0020009c000008510000213d000016520020009c000015240000613d000016530020009c000011f60000613d000016540020009c0000012a0000c13d000000a40010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000000ff0010008c0000012a0000213d0000004401800370000000000201043b000000000002004b0000000001000039000000010100c039000d00000002001d000000000012004b0000012a0000c13d0000006401800370000000000201043b000000000002004b0000000001000039000000010100c039000c00000002001d000000000012004b0000012a0000c13d0000008401800370000000000201043b000000000002004b0000000001000039000000010100c039000b00000002001d000000000012004b0000012a0000c13d0000000e01000029000000ff0110018f000a00000001001d0000000a0010008c00001b940000413d000016cc01000041000000800010043f0000167401000041000056ae00010430000016300020009c0000065c0000a13d000016310020009c000008690000213d000016350020009c0000154d0000613d000016360020009c000012ff0000613d000016370020009c0000012a0000c13d0000000001000416000000000001004b0000012a0000c13d56ac52500000040f0000167c0000013d000015f50020009c000007b60000213d000015f90020009c000015900000613d000015fa0020009c00000fb30000613d000015fb0020009c0000012a0000c13d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000601043b000015db0060009c0000012a0000213d000000000100041a000015db021001970000000005000411000000000052004b000017e00000c13d000000000006004b0000184d0000c13d0000167301000041000000800010043f0000167401000041000056ae00010430000016280020009c00000a1e0000a13d000016290020009c00000c060000613d0000162a0020009c00000be90000613d0000162b0020009c0000012a0000c13d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000016750010009c0000012a0000213d0000000f01000029000000000001004b000017e40000c13d000016b501000041000000800010043f0000167401000041000056ae000104300000161a0020009c00000a4c0000a13d0000161b0020009c00000c110000613d0000161c0020009c00000bf50000613d0000161d0020009c0000012a0000c13d000001240010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000f00000002001d000015db0020009c0000012a0000213d0000008402800370000000000202043b000e00000002001d000015db0020009c0000012a0000213d000000a402800370000000000202043b000c00000002001d000015db0020009c0000012a0000213d0000010402800370000000000202043b000d00000002001d000015dc0020009c0000012a0000213d0000000d020000290000002302200039000000000012004b0000012a0000813d0000000d02000029000a00040020003d0000000a02800360000000000202043b000b00000002001d000015dc0020009c0000012a0000213d0000000d030000290000000b023000290000002402200039000000000012004b0000012a0000213d0000002401800370000000000101043b000700000001001d0000004401800370000000000101043b000800000001001d0000006401800370000000000101043b000900000001001d000000c401800370000000000101043b000500000001001d000000e401800370000000000101043b000600000001001d000000000010043f0000000401000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff001001900000165d0000613d0000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015b80001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000040010006b000024480000a13d0000000101000039000000000101041a000000080010019000000f870000c13d000024480000013d0000160b0020009c00000a5e0000a13d0000160c0020009c00000ebf0000613d0000160d0020009c00000cd30000613d0000160e0020009c0000012a0000c13d000001640010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000f00000002001d000015dc0020009c0000012a0000213d0000000f020000290000002302200039000000000012004b0000012a0000813d0000000f020000290000000402200039000000000228034f000000000202043b000e00000002001d000015dc0020009c0000012a0000213d0000000f020000290000002403200039000d00000003001d0000000e02300029000000000012004b0000012a0000213d0000008401800370000000000101043b000c00000001001d000015db0010009c0000012a0000213d000000a401800370000000000101043b000b00000001001d000015db0010009c0000012a0000213d000000c401800370000000000101043b000a00000001001d000015db0010009c0000012a0000213d0000010401800370000000000101043b000900000001001d000016a30010009c0000012a0000213d000000e401800370000000000101043b000600000001001d0000012401800370000000000101043b000800000001001d0000014401800370000000000101043b000700000001001d000000000010043f0000000501000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff001001900000165d0000613d0000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015b40001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000500000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000050010006b000028160000a13d0000000101000039000000000101041a000000800010019000000f870000c13d000028160000013d000016630020009c00000a7f0000a13d000016640020009c000010ed0000613d000016650020009c00000cf80000613d000016660020009c0000012a0000c13d000001240010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000f00000002001d000015db0020009c0000012a0000213d000000a402800370000000000202043b000e00000002001d000015db0020009c0000012a0000213d000000c402800370000000000202043b000c00000002001d000015db0020009c0000012a0000213d0000010402800370000000000202043b000d00000002001d000015dc0020009c0000012a0000213d0000000d020000290000002302200039000000000012004b0000012a0000813d0000000d02000029000a00040020003d0000000a02800360000000000202043b000b00000002001d000015dc0020009c0000012a0000213d0000000d030000290000000b023000290000002402200039000000000012004b0000012a0000213d0000002401800370000000000101043b000600000001001d0000004401800370000000000101043b000700000001001d0000006401800370000000000101043b000800000001001d0000008401800370000000000101043b000900000001001d000000e401800370000000000101043b000500000001001d0000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015d40001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000040010006b000021020000a13d0000000101000039000000000101041a000000100010019000000f870000c13d000021020000013d000016460020009c00000a980000a13d000016470020009c000010fe0000613d000016480020009c00000d370000613d000016490020009c0000012a0000c13d000001440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000f00000002001d000015db0020009c0000012a0000213d0000008402800370000000000202043b000e00000002001d000015db0020009c0000012a0000213d000000a402800370000000000202043b000c00000002001d000015db0020009c0000012a0000213d0000012402800370000000000202043b000d00000002001d000015dc0020009c0000012a0000213d0000000d020000290000002302200039000000000012004b0000012a0000813d0000000d02000029000a00040020003d0000000a02800360000000000202043b000b00000002001d000015dc0020009c0000012a0000213d0000000d030000290000000b023000290000002402200039000000000012004b0000012a0000213d0000002401800370000000000101043b000700000001001d0000004401800370000000000101043b000800000001001d0000006401800370000000000101043b000900000001001d000000c401800370000000000101043b000400000001001d000000e401800370000000000101043b000500000001001d0000010401800370000000000101043b000600000001001d000000000010043f0000000401000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff001001900000165d0000613d0000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015c40001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000300000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000030010006b000025890000a13d0000000101000039000000000101041a000000200010019000000f870000c13d000025890000013d000016550020009c00000aba0000a13d000016560020009c000011710000613d000016570020009c00000be80000613d000016580020009c0000012a0000c13d000000640010008c0000134c0000813d0000012a0000013d000016380020009c00000ada0000a13d000016390020009c0000117a0000613d0000163a0020009c00000de10000613d0000163b0020009c0000012a0000c13d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d56ac47ef0000040f0000151f0000013d000016220020009c00000df50000613d000016230020009c00000c460000613d000016240020009c0000012a0000c13d000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000016750020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000c00000003001d000015dc0030009c0000012a0000213d000b00240020003d0000000c0200002900000005022002100000000b02200029000000000012004b0000012a0000213d0000000801000029000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000a00000001001d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000c0000006b000015900000613d0000000a01000029000700040010003d000d00010010003d000f00000000001d000006c00000013d0000000f020000290000000102200039000f00000002001d0000000c0020006c000015900000813d0000000f0100002900000005011002100000000b011000290000000201100367000000000301043b000015db0030009c0000012a0000213d000000000030043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c70000801002000039000e00000003001d56ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b000006bb0000c13d0000000a02000029000000000102041a000015dc0010009c000002ae0000213d000900000001001d0000000101100039000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000000e020000290000012a0000613d000000000101043b0000000901100029000000000021041b0000000a01000029000000000101041a000900000001001d000000000020043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000902000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167d04000041000000010500003900000008060000290000000e0700002956ac56a20000040f0000000e0100002900000001002001900000012a0000613d000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b000006bb0000013d000016140020009c00000be70000613d000016150020009c00000c570000613d000016160020009c0000012a0000c13d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d0000014002000039000000400020043f000000800000043f000000a00000043f000000c00000043f000000e00000043f000001000000043f000001200000043f000000000010043f0000000b01000039000000200010043f0000004002000039000000000100001956ac566f0000040f000f00000001001d000001400100003956ac478e0000040f0000000f01000029000000000101041a000000ff001001900000000002000039000000010200c039000001400020043f0000ff00001001900000000003000039000000010300c039000001600030043f0000001003100270000000ff0330018f000001800030043f00000018031002700000167503300197000001a00030043f000016ad001001980000000003000039000000010300c039000001c00030043f00000098011002700000ffff0110018f000001e00010043f000000400100043d0000000002210436000001600300043d000000000003004b0000000003000039000000010300c0390000000000320435000001800200043d000000ff0220018f00000040031000390000000000230435000001a00200043d000016750220019700000060031000390000000000230435000001c00200043d000000000002004b0000000002000039000000010200c03900000080031000390000000000230435000001e00200043d0000ffff0220018f000000a0031000390000000000230435000015d80010009c000015d8010080410000004001100210000016ae011001c7000056ad0001042e000016050020009c000013680000613d000016060020009c00000f380000613d000016070020009c0000012a0000c13d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d000017400000013d000015fd0020009c000014650000613d000015fe0020009c00000fc70000613d000015ff0020009c0000012a0000c13d000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000015db0020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000a00000003001d000015dc0030009c0000012a0000213d000900240020003d0000000a0200002900000005022002100000000902200029000000000012004b0000012a0000213d0000000002000411000000080020006c00001df10000613d0000162501000041000000000010043f00000000010004140000000802000029000000040020008c00001ba20000c13d0000001c0100043d000000000010043f0000000102000039000000010300003100001bc50000013d000015f60020009c000014780000613d000015f70020009c000010d00000613d000015f80020009c0000012a0000c13d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000000000010043f000000050100003900000e110000013d0000165d0020009c000015780000613d0000165e0020009c0000132a0000613d0000165f0020009c0000012a0000c13d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d000000000010043f0000000b01000039000000200010043f0000004002000039000000000100001956ac566f0000040f000000000101041a0000001801100270000016750110019756ac47ef0000040f0000151f0000013d000016400020009c000015920000613d000016410020009c0000133e0000613d000016420020009c0000012a0000c13d000000e40010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000f00000002001d000015db0020009c0000012a0000213d0000006402800370000000000202043b000d00000002001d0000004402800370000000000202043b000c00000002001d0000002402800370000000000202043b000b00000002001d0000008402800370000000000202043b000e00000002001d000015db0020009c0000012a0000213d000000a402800370000000000202043b000900000002001d000015db0020009c0000012a0000213d000000c402800370000000000202043b000a00000002001d000015dc0020009c0000012a0000213d0000000a020000290000002302200039000000000012004b0000012a0000813d0000000a02000029000700040020003d0000000702800360000000000202043b000800000002001d000015dc0020009c0000012a0000213d0000000a0300002900000008023000290000002402200039000000000012004b0000012a0000213d0000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015c00001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000600000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000060010006b000022420000a13d0000000101000039000000000101041a000000080010019000000f870000c13d000022420000013d0000164f0020009c000016120000613d000016500020009c0000134a0000613d000016510020009c0000012a0000c13d0000000002000416000000000002004b0000012a0000c13d56ac46430000040f000f00000002001d000015db01100197000000000010043f0000000b01000039000000200010043f0000004002000039000000000100001956ac566f0000040f000000000101041a00000018011002700000167501100197000000000010043f0000000e01000039000016710000013d000016320020009c000016600000613d000016330020009c00000be80000613d000016340020009c0000012a0000c13d000000840010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000015db0010009c0000012a0000213d0000004401800370000000000101043b000d00000001001d000015db0010009c0000012a0000213d0000006401800370000000000101043b000c00000001001d0000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015bc0001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000b00000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000b0010006b00001d830000a13d0000000101000039000000000101041a000000010010019000000f870000c13d00001d830000013d0000001f02400039000016e3022001970000003f02200039000016e302200197000000400700043d0000000006270019000d00000007001d000000000076004b00000000020000390000000102004039000015dc0060009c000002ae0000213d0000000100200190000002ae0000c13d000001e002100039000000400060043f0000000d060000290000000006460436000c00000006001d00000200055000390000000006540019000000000026004b0000012a0000213d000000000004004b0000000c09000029000008e10000613d000000000600001900000000076900190000000008560019000000000808043300000000008704350000002006600039000000000046004b000008da0000413d0000000d0440002900000020044000390000000000040435000002400400043d000015dc0040009c0000012a0000213d0000001f05400039000000000015004b0000000001000019000015dd01008041000015dd05500197000000000005004b0000000006000019000015dd06004041000015dd0050009c000000000601c019000000000006004b0000012a0000c13d000001e0014000390000000001010433000015dc0010009c000002ae0000213d0000001f05100039000016e3055001970000003f05500039000016e303500197000000400500043d0000000003350019000b00000005001d000000000053004b00000000050000390000000105004039000015dc0030009c000002ae0000213d0000000100500190000002ae0000c13d000000400030043f0000000b030000290000000003130436000a00000003001d00000200034000390000000004310019000000000024004b0000012a0000213d000000000001004b0000000a06000029000009180000613d000000000200001900000000042600190000000005320019000000000505043300000000005404350000002002200039000000000012004b000009110000413d0000000b0110002900000020011000390000000000010435000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d0000000002000411000015db06200197000000000200041a000015e003200197000000000363019f000000000101043b000900000001001d000000000030041b0000000001000414000015db05200197000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000015e20400004156ac56a20000040f00000001002001900000012a0000613d0000000101000039000000a00010043f0000000301000039000000c00010043f0000000501000039000000e00010043f0000000901000029000000010010008c000015e401000041000015e301006041000000800010043f0000000c01000029000015d80010009c000015d80100804100000040011002100000000d020000290000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000d00000001001d000001400010043f0000000a01000029000015d80010009c000015d80100804100000040011002100000000b020000290000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000201043b000001600020043f0000000905000029000001200050043f000000400100043d000000a00310003900000000040004100000000000430435000000800310003900000000005304350000006003100039000000000023043500000040021000390000000d030000290000000000320435000000a0020000390000000002210436000015e5030000410000000000320435000015e60010009c000002ae0000213d000000c003100039000d00000003001d000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000000e020000290000012a0000613d000000000101043b000001000010043f000015db06200197000000000100041a000015e002100197000000000262019f000000000020041b0000000002000414000015db05100197000015d80020009c000015d802008041000000c001200210000015e1011001c70000800d020000390000000303000039000015e204000041000e00000006001d56ac56a20000040f00000001002001900000012a0000613d0000000e0000006b000027ea0000613d0000000f01000029000015db00100198000027ea0000613d000000000000043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000015e0022001970000000e022001af000000000021041b000015e801000041000000400200043d000000400320003900000000001304350000000c010000390000002003200039000000000013043500000020010000390000000000120435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e9011001c70000800d020000390000000203000039000015ea04000041000000000500001956ac56a20000040f00000001002001900000012a0000613d0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000015eb0400004100000000050000190000000e0600002956ac56a20000040f00000001002001900000012a0000613d0000000f05000029000001c00050043f000015ec02000041000001800020043f000015ed01000041000001a00010043f000000800300043d00000140000004430000016000300443000000a00300043d00000020060000390000018000600443000001a0003004430000004003000039000000c00400043d000001c000300443000001e0004004430000006003000039000000e00400043d000002000030044300000220004004430000008003000039000001000400043d00000240003004430000026000400443000001200300043d000000a0040000390000028000400443000002a000300443000000c003000039000001400400043d000002c000300443000002e000400443000000e003000039000001600400043d0000030000300443000003200040044300000100030000390000034000300443000003600020044300000120020000390000038000200443000003a0001004430000014001000039000003c000100443000003e00050044300000100006004430000000b010000390000012000100443000015ee01000041000056ad0001042e0000162c0020009c00000e080000613d0000162d0020009c0000012a0000c13d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000301043b000000000100041a000015db011001970000000002000411000000000021004b000017e00000c13d000e00000003001d0000000103000039000000000103041a000000000003041b000000800010043f000000a00000043f0000000001000414000015d80010009c000015d801008041000000c001100210000016b6011001c70000800d02000039000d00000003001d000016b70400004156ac56a20000040f00000001002001900000012a0000613d0000000e0000006b000015900000613d00000000010004140000000f04000029000000040040008c0000193a0000c13d0000000101000031000019470000013d0000161e0020009c00000e150000613d0000161f0020009c0000012a0000c13d0000000002000416000000000002004b0000012a0000c13d56ac46430000040f000f00000002001d000015db01100197000000000010043f0000000f01000039000000200010043f0000004002000039000000000100001956ac566f0000040f0000000201100039000016760000013d0000160f0020009c000013900000613d000016100020009c0000012a0000c13d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000016750010009c0000012a0000213d00000000050004110000000f04000029000000000045004b00001b080000613d0000162501000041000000000010043f0000000001000414000000040040008c0000190d0000c13d0000001c0100043d000000000010043f00000001020000390000000103000031000019320000013d000016670020009c000016830000613d000016680020009c0000012a0000c13d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000201043b000016af002001980000012a0000c13d0000000101000039000016dc0020009c000018140000a13d000016dd0020009c0000154a0000613d000016de0020009c0000154a0000613d000016df0020009c0000154a0000613d000000800000043f0000166901000041000056ad0001042e0000164a0020009c0000172e0000613d0000164b0020009c0000012a0000c13d0000000001000416000000000001004b0000012a0000c13d0000000001000411000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a0000000102200039000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000203000039000016be0400004100000000050004110000158d0000013d000016590020009c0000174f0000613d0000165a0020009c0000012a0000c13d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d0000002402800370000000000202043b000f00000002001d000000000010043f0000000601000039000000200010043f0000004002000039000000000100001956ac566f0000040f0000000f02000029000000080220027056ac47150000040f000000000101041a000016e4011001670000000f02000029000000ff0220018f000000000121022f000000010110018f0000167c0000013d0000163c0020009c000017560000613d0000163d0020009c0000012a0000c13d000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000016750020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000f00000003001d000015dc0030009c0000012a0000213d00000024032000390000000f02000029000e0005002002180000000e04300029000000000014004b0000012a0000213d0000000801000029000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c70000801002000039000d00000003001d000c00000004001d56ac56a70000040f00000001002001900000012a0000613d000000000101043b000b00000001001d0000000e010000290000003f011000390000167701100197000000400200043d0000000001120019000a00000002001d000000000021004b00000000020000390000000102004039000015dc0010009c000002ae0000213d0000000100200190000002ae0000c13d000000400010043f0000000a010000290000000f030000290000000001310436000900000001001d0000000c05000029000000000050007c0000000d040000290000012a0000213d0000000f0000006b00000b2f0000613d00000002010003670000000a02000029000000000341034f000000000303043b000015db0030009c0000012a0000213d000000200220003900000000003204350000002004400039000000000054004b00000b260000413d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000a010000290000000001010433000000000001004b000015900000613d0000000b01000029000700040010003d000c00010010003d000f00000000001d00000b550000013d000000000101043b000000000201041a000016e202200197000000000021041b0000000f02000029000f00010020003d0000000a0100002900000000010104330000000f0010006b000015900000813d0000000f01000029000000050110021000000009011000290000000001010433000015db01100197000e00000001001d000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000000002004b00000b4f0000613d0000000b01000029000000000301041a000000000003004b00001fcd0000613d000000000032004b000d00000002001d00000bab0000613d000600000003001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d020000290005000100200092000000000101043b0000000b03000029000000000203041a000000050020006c000030790000a13d0000000602000029000000010220008a0000000001120019000000000101041a000600000001001d000000000030043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000005011000290000000602000029000000000021041b000000000020043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000d02000029000000000021041b0000000b01000029000000000201041a000d00000002001d000000000002004b0000241e0000613d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d02000029000000010220008a000000000101043b0000000001210019000000000001041b0000000b01000029000000000021041b0000000e01000029000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000001041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167804000041000000000500001900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000000b4b0000c13d0000012a0000013d56ac46690000040f56ac433e0000040f000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d56ac48760000040f000000000001004b0000167a0000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d000000000010043f0000000a01000039000000200010043f0000004002000039000000000100001956ac566f0000040f000000000101041a00000cde0000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d56ac48330000040f000017410000013d000000c40010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000015db0010009c0000012a0000213d0000006401800370000000000101043b000d00000001001d000015db0010009c0000012a0000213d000000a401800370000000000301043b0000008401800370000000000501043b0000004401800370000000000401043b00000000010004110000000f0010006c000018590000613d0000000e0010006c000018590000613d000016b301000041000000800010043f0000167401000041000056ae000104300000000002000416000000000002004b0000012a0000c13d56ac46430000040f000f00000002001d000015db01100197000000000010043f0000000b01000039000000200010043f0000004002000039000000000100001956ac566f0000040f000000000101041a00000018011002700000167501100197000000000010043f0000000d01000039000016710000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b56ac48fe0000040f000000400300043d000000200430003900000000002404350000000000130435000015d80030009c000015d8030080410000004001300210000016a9011001c7000056ad0001042e000000240010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d000e00040020003d0000000e03800360000000000303043b000f00000003001d000015dc0030009c0000012a0000213d0000000f022000290000002402200039000000000012004b0000012a0000213d0000000801000039000000000201041a0000167a0320019700000001022000390000167504200197000000000234019f000000000021041b000d00000004001d000000000040043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000002000411000015db02200197000000000101043b000000000301041a000015e003300197000000000223019f000000000021041b0000002002000039000000400100043d00000000022104360000000f030000290000000000320435000016e3053001980000001f0630018f000000400310003900000000045300190000000e070000290000002007700039000000020770036700000c9b0000613d000000000807034f0000000009030019000000008a08043c0000000009a90436000000000049004b00000c970000c13d000000000006004b00000ca80000613d000000000557034f0000000306600210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f00000000005404350000000f04000029000000000343001900000000000304350000001f03400039000016e3023001970000167b0020009c0000167b020080410000006002200210000015d80010009c000015d8010080410000004001100210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f0000167c0110009a0000800d020000390000000203000039000015ea040000410000000d0500002956ac56a20000040f00000001002001900000012a0000613d000000400100043d000f00000001001d0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000015eb040000410000000d05000029000000000600041156ac56a20000040f00000001002001900000012a0000613d0000000d010000290000000f020000290000167d0000013d0000000002000416000000000002004b0000012a0000c13d56ac46530000040f56ac492d0000040f0000000001000019000056ad0001042e0000000001000416000000000001004b0000012a0000c13d000000000100041a000015db01100197000000800010043f0000166901000041000056ad0001042e000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d000000000010043f0000000b01000039000000200010043f00000040020000390000000001000019000f00000008035356ac566f0000040f000000000101041a00000018011002700000167501100197000000000010043f0000000d01000039000015390000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000000f01000029000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff00100190000018110000c13d00000018011002700000167501100197000000000010043f0000000e01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000002000411000015db02200197000000000020043f0000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff0010019000001b740000c13d000000400100043d000016db0200004100001d7d0000013d000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000016750020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000c00000003001d000015dc0030009c0000012a0000213d000b00240020003d0000000c0200002900000005022002100000000b02200029000000000012004b0000012a0000213d0000000801000029000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000f00000001001d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000c0000006b000015900000613d0000000f02000029000a00020020003d000700050020003d000d00030020003d000f00000000001d00000d880000013d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000f020000290000000102200039000f00000002001d0000000c0020006c000015900000813d0000000f0100002900000005011002100000000b011000290000000201100367000000000101043b000e00000001001d000000000010043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b00000d830000c13d0000000a02000029000000000102041a000015dc0010009c000002ae0000213d000900000001001d0000000101100039000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000000e030000290000012a0000613d000000000101043b0000000901100029000000000031041b0000000a01000029000000000101041a000900000001001d000000000030043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000902000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167e04000041000000010500003900000008060000290000000e0700002956ac56a20000040f0000000e0100002900000001002001900000012a0000613d000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000000d7e0000c13d0000012a0000013d0000000001000416000000000001004b0000012a0000c13d000000000100041a000015db021001970000000005000411000000000052004b000017e00000c13d000015e001100197000000000010041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000015e20400004100000000060000190000158d0000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d000000000010043f0000000b01000039000000200010043f0000004002000039000000000100001956ac566f0000040f000000000101041a00000018011002700000167501100197000011980000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000000000010043f0000000401000039000000200010043f00000040020000390000000001000019000015450000013d000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000016750020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000c00000003001d000015dc0030009c0000012a0000213d000b00240020003d0000000c0200002900000005022002100000000b02200029000000000012004b0000012a0000213d0000000801000029000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000f00000001001d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000c0000006b000015900000613d0000000f02000029000a00020020003d000700050020003d000d00030020003d000f00000000001d00000e660000013d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000f020000290000000102200039000f00000002001d0000000c0020006c000015900000813d0000000f0100002900000005011002100000000b011000290000000201100367000000000101043b000e00000001001d000000000010043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b00000e610000c13d0000000a02000029000000000102041a000015dc0010009c000002ae0000213d000900000001001d0000000101100039000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000000e030000290000012a0000613d000000000101043b0000000901100029000000000031041b0000000a01000029000000000101041a000900000001001d000000000030043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000902000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167e04000041000000000500001900000008060000290000000e0700002956ac56a20000040f0000000e0100002900000001002001900000012a0000613d000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000000e5c0000c13d0000012a0000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000201043b000000000100041156ac51330000040f0000000001000019000056ad0001042e000001040010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000f00000002001d000015db0020009c0000012a0000213d0000006402800370000000000202043b000d00000002001d0000004402800370000000000202043b000c00000002001d0000002402800370000000000202043b000b00000002001d0000008402800370000000000202043b000e00000002001d000015db0020009c0000012a0000213d000000a402800370000000000202043b000900000002001d000015db0020009c0000012a0000213d000000c402800370000000000202043b000800000002001d000000e402800370000000000202043b000a00000002001d000015dc0020009c0000012a0000213d0000000a020000290000002302200039000000000012004b0000012a0000813d0000000a02000029000600040020003d0000000602800360000000000202043b000700000002001d000015dc0020009c0000012a0000213d0000000a0300002900000007023000290000002402200039000000000012004b0000012a0000213d0000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015b00001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000500000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000050010006b000023800000a13d0000000101000039000000000101041a000000200010019000000f870000c13d000023800000013d000000840010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000015db0010009c0000012a0000213d0000004401800370000000000101043b000d00000001001d000015db0010009c0000012a0000213d0000006401800370000000000101043b000c00000001001d0000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015ac0001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000b00000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000b0010006b00001c1c0000a13d0000000101000039000000000101041a000000040010019000001c1c0000613d000000400100043d000016d40200004100001d7d0000013d000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d000e00040020003d0000000e03800360000000000303043b000f00000003001d000015dc0030009c0000012a0000213d0000000f022000290000002402200039000000000012004b0000012a0000213d0000002401800370000000000101043b000d00000001001d000016750010009c0000012a0000213d0000000801000039000000000201041a000000010320003900001675043001970000167a03200197000000000334019f000000000031041b00001675012001970000000d0010006b000019dd0000a13d0000168001000041000000800010043f0000167401000041000056ae00010430000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d000000000010043f0000000b01000039000000200010043f0000004002000039000000000100001956ac566f0000040f000000000101041a0000001801100270000016750110019756ac48330000040f000017410000013d000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000016750020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000f00000003001d000015dc0030009c0000012a0000213d00000024032000390000000f02000029000e0005002002180000000e04300029000000000014004b0000012a0000213d0000000801000029000000000010043f0000000e01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c70000801002000039000d00000003001d000c00000004001d56ac56a70000040f00000001002001900000012a0000613d000000000101043b000b00000001001d0000000e010000290000003f011000390000167701100197000000400200043d0000000001120019000a00000002001d000000000021004b00000000020000390000000102004039000015dc0010009c000002ae0000213d0000000100200190000002ae0000c13d000000400010043f0000000a010000290000000f030000290000000001310436000900000001001d0000000c05000029000000000050007c0000000d040000290000012a0000213d0000000f0000006b000010180000613d00000002010003670000000a02000029000000000341034f000000000303043b000015db0030009c0000012a0000213d000000200220003900000000003204350000002004400039000000000054004b0000100f0000413d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000a010000290000000001010433000000000001004b000015900000613d0000000b01000029000700040010003d000c00010010003d000f00000000001d0000103e0000013d000000000101043b000000000201041a000016e202200197000000000021041b0000000f02000029000f00010020003d0000000a0100002900000000010104330000000f0010006b000015900000813d0000000f01000029000000050110021000000009011000290000000001010433000015db01100197000e00000001001d000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000000002004b000010380000613d0000000b01000029000000000301041a000000000003004b00001fcd0000613d000000000032004b000d00000002001d000010940000613d000600000003001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d020000290005000100200092000000000101043b0000000b03000029000000000203041a000000050020006c000030790000a13d0000000602000029000000010220008a0000000001120019000000000101041a000600000001001d000000000030043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000005011000290000000602000029000000000021041b000000000020043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000d02000029000000000021041b0000000b01000029000000000201041a000d00000002001d000000000002004b0000241e0000613d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d02000029000000010220008a000000000101043b0000000001210019000000000001041b0000000b01000029000000000021041b0000000e01000029000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000001041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167804000041000000020500003900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000010340000c13d0000012a0000013d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d0000ffff0010008c0000012a0000213d00000000050004110000000f04000029000000000045004b000019510000613d0000162501000041000000000010043f0000000001000414000000040040008c000018ce0000c13d0000001c0100043d000000000010043f00000001020000390000000103000031000018f30000013d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d0000002402800370000000000202043b000f00000002001d000015db0020009c0000012a0000213d000000000010043f0000000d010000390000133a0000013d000000a40010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000015db0010009c0000012a0000213d0000006401800370000000000101043b000d00000001001d000015db0010009c0000012a0000213d0000004401800370000000000101043b000c00000001001d0000008401800370000000000101043b000b00000001001d0000000f01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d000000c003100039000000000023043500000080021000390000000b03000029000000000032043500000060021000390000000d03000029000000000032043500000040021000390000000c03000029000000000032043500000020021000390000000f030000290000000000320435000000c0030000390000000000310435000000a0031000390000000000030435000016840010009c000002ae0000213d000000e003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000201000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000e02000029000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000f00000001001d000016850100004100000000001004430000000001000414000017cc0000013d0000000001000416000000000001004b0000012a0000c13d0000000801000039000000000101041a0000167501100197000000800010043f0000166901000041000056ad0001042e000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000016750010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000015db0010009c0000012a0000213d0000000e0000006b0000181b0000c13d000016ba01000041000000800010043f0000167401000041000056ae00010430000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d56ac46d20000040f000017410000013d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000015db0010009c0000012a0000213d0000000e01000029000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff00100190000018110000c13d0000000f02000029000000010020008c000011bf0000c13d0000ff00001001900000138d0000c13d00000018011002700000167501100197000000000010043f0000000e01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000002000411000015db02200197000000000020043f0000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff0010019000000d340000613d0000000e01000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000f02000029000015dd022001c700000000002104470000000e01000029000000000010043f000000200000043f000000000100041400001af70000013d000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000016750020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000f00000003001d000015dc0030009c0000012a0000213d00000024032000390000000f02000029000e0005002002180000000e04300029000000000014004b0000012a0000213d0000000801000029000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c70000801002000039000d00000003001d000c00000004001d56ac56a70000040f00000001002001900000012a0000613d000000000101043b000b00000001001d0000000e010000290000003f011000390000167701100197000000400200043d0000000001120019000a00000002001d000000000021004b00000000020000390000000102004039000015dc0010009c000002ae0000213d0000000100200190000002ae0000c13d000000400010043f0000000a010000290000000f030000290000000001310436000900000001001d0000000c05000029000000000050007c0000000d040000290000012a0000213d0000000f0000006b000012470000613d00000002010003670000000a02000029000000000341034f000000000303043b000015db0030009c0000012a0000213d000000200220003900000000003204350000002004400039000000000054004b0000123e0000413d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000a010000290000000001010433000000000001004b000015900000613d0000000b01000029000700040010003d000c00010010003d000f00000000001d000012690000013d0000000f02000029000f00010020003d0000000a0100002900000000010104330000000f0010006b000015900000813d0000000f01000029000000050110021000000009011000290000000001010433000015db01100197000e00000001001d000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000000002004b000012630000613d0000000b01000029000000000301041a000000000003004b00001fcd0000613d000000000032004b000d00000002001d000012bf0000613d000600000003001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d020000290005000100200092000000000101043b0000000b03000029000000000203041a000000050020006c000030790000a13d0000000602000029000000010220008a0000000001120019000000000101041a000600000001001d000000000030043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000005011000290000000602000029000000000021041b000000000020043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000d02000029000000000021041b0000000b01000029000000000201041a000d00000002001d000000000002004b0000241e0000613d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d02000029000000010220008a000000000101043b0000000001210019000000000001041b0000000b01000029000000000021041b0000000e01000029000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000001041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167804000041000000010500003900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000016e202200197000000000021041b000012630000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d000000000010043f0000000f01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000301041a000000400200043d000f00000002001d000d00000003001d0000000002320436000e00000002001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d05000029000000000005004b000018fb0000c13d0000000e04000029000019040000013d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d0000002402800370000000000202043b000f00000002001d000015db0020009c0000012a0000213d000000000010043f0000000c01000039000000200010043f00000040020000390000000001000019000016740000013d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d000000000010043f0000000d01000039000013630000013d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d0000002402800370000000000202043b56ac47250000040f0000000001000019000056ad0001042e000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d000000000010043f0000000c01000039000000200010043f00000040020000390000000001000019000f0000000803530000153c0000013d000000640010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000015db0010009c0000012a0000213d0000000e01000029000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff00100190000018110000c13d0000000f02000029000000010020008c00001abd0000c13d0000ff000010019000001abd0000613d000000400100043d000016bd0200004100001d7d0000013d000000c40010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000201043b0000002401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000006401800370000000000101043b000e00000001001d000015db0010009c0000012a0000213d0000008401800370000000000101043b000d00000001001d000016860010009c0000012a0000213d000000a401800370000000000101043b000c00000001001d000016a30010009c0000012a0000213d0000000001020019000b00000002001d56ac51240000040f00000044010000390000000201100367000000000301043b00000000060004110000000b010000290000000f020000290000000d040000290000000c050000290000000e0700002956ac51640000040f0000000001000019000056ad0001042e000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000016750020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000c00000003001d000015dc0030009c0000012a0000213d000b00240020003d0000000c0200002900000005022002100000000b02200029000000000012004b0000012a0000213d0000000801000029000000000010043f0000000e01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000a00000001001d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000c0000006b000015900000613d0000000a01000029000700040010003d000d00010010003d000f00000000001d0000140a0000013d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000f020000290000000102200039000f00000002001d0000000c0020006c000015900000813d0000000f0100002900000005011002100000000b011000290000000201100367000000000301043b000015db0030009c0000012a0000213d000000000030043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c70000801002000039000e00000003001d56ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b000014050000c13d0000000a02000029000000000102041a000015dc0010009c000002ae0000213d000900000001001d0000000101100039000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000000e020000290000012a0000613d000000000101043b0000000901100029000000000021041b0000000a01000029000000000101041a000900000001001d000000000020043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000902000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167d04000041000000020500003900000008060000290000000e0700002956ac56a20000040f0000000e0100002900000001002001900000012a0000613d000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000014000000c13d0000012a0000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d000000000010043f0000000701000039000000200010043f0000004002000039000000000100001956ac566f0000040f000000000101041a000000800010043f0000166901000041000056ad0001042e0000000001000416000000000001004b0000012a0000c13d0000000101000039000000000101041a000f00000001001d0000000001000412001100000001001d001000000000003d000080050100003900000044030000390000000004000415000000110440008a0000000504400210000016710200004156ac56840000040f0000000101100039000000800010043f0000000f01000029000000a00010043f0000167201000041000056ad0001042e000001640010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000f00000002001d000015db0020009c0000012a0000213d000000a402800370000000000202043b000e00000002001d000015db0020009c0000012a0000213d000000c402800370000000000202043b000c00000002001d000015db0020009c0000012a0000213d0000014402800370000000000202043b000d00000002001d000015dc0020009c0000012a0000213d0000000d020000290000002302200039000000000012004b0000012a0000813d0000000d02000029000a00040020003d0000000a02800360000000000202043b000b00000002001d000015dc0020009c0000012a0000213d0000000d030000290000000b023000290000002402200039000000000012004b0000012a0000213d0000002401800370000000000101043b000600000001001d0000004401800370000000000101043b000700000001001d0000006401800370000000000101043b000800000001001d0000008401800370000000000101043b000900000001001d000000e401800370000000000101043b000300000001001d0000010401800370000000000101043b000400000001001d0000012401800370000000000101043b000500000001001d000000000010043f0000000401000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff001001900000165d0000613d0000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015d00001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000200000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000020010006b000026cb0000a13d0000000101000039000000000101041a000000100010019000000f870000c13d000026cb0000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000016750010009c0000012a0000213d56ac47ab0000040f0000000002010019000000400100043d000f00000001001d56ac432f0000040f000017450000013d000000440010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d000000000010043f0000000b01000039000000200010043f00000040020000390000000001000019000f00000008035356ac566f0000040f000000000101041a00000018011002700000167501100197000000000010043f0000000c01000039000000200010043f0000000001000019000000400200003956ac566f0000040f0000000f0200035f0000002402200370000000000202043b000000000020043f0000000501100039000000200010043f0000000001000019000000400200003956ac566f0000040f000000000101041a000000ff001001900000000001000039000000010100c039000000800010043f0000166901000041000056ad0001042e000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000015db0020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000c00000003001d000015dc0030009c0000012a0000213d000b00240020003d0000000c0200002900000005022002100000000b02200029000000000012004b0000012a0000213d0000000002000411000000080020006c00001eb90000613d0000162501000041000000000010043f00000000010004140000000802000029000000040020008c00001bcd0000c13d0000001c0100043d000000000010043f0000000102000039000000010300003100001bf00000013d000000240010008c0000012a0000413d000000000100041a000015db011001970000000002000411000000000021004b000017e00000c13d0000000401800370000000000101043b0000000103000039000000000203041a000000000013041b000000800020043f000000a00010043f0000000001000414000015d80010009c000015d801008041000000c001100210000016b6011001c70000800d02000039000016b70400004156ac56a20000040f00000001002001900000012a0000613d0000000001000019000056ad0001042e000001440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000002402800370000000000202043b000f00000002001d000015db0020009c0000012a0000213d0000008402800370000000000202043b000e00000002001d000016860020009c0000012a0000213d000000a402800370000000000202043b000d00000002001d000015db0020009c0000012a0000213d000000c402800370000000000202043b000c00000002001d000016a30020009c0000012a0000213d000000e402800370000000000202043b000b00000002001d000016a30020009c0000012a0000213d0000010402800370000000000202043b000900000002001d000015db0020009c0000012a0000213d0000012402800370000000000202043b000a00000002001d000015dc0020009c0000012a0000213d0000000a020000290000002302200039000000000012004b0000012a0000813d0000000a02000029000700040020003d0000000702800360000000000202043b000800000002001d000015dc0020009c0000012a0000213d0000000a0300002900000008023000290000002402200039000000000012004b0000012a0000213d0000000401800370000000000101043b000600000001001d0000004401800370000000000101043b000400000001001d0000006401800370000000000101043b000500000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000300000001001d0000000b0010006c00001dea0000213d0000000601000029000000140010008c000015eb0000613d0000000601000029000002d10010008c000015eb0000613d0000000601000029000004830010008c0000298d0000c13d0000000901000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000005020000290000000802200270000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000502000029000000ff0220018f000000010220020f000000000101043b000000000301041a000000000323013f000000000031041b000000000023017000002af60000c13d000000400100043d000016d70200004100001d7d0000013d000001840010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000f00000002001d000015dc0020009c0000012a0000213d0000000f020000290000002302200039000000000012004b0000012a0000813d0000000f020000290000000402200039000000000228034f000000000202043b000e00000002001d000015dc0020009c0000012a0000213d0000000f020000290000002403200039000d00000003001d0000000e02300029000000000012004b0000012a0000213d0000008401800370000000000101043b000c00000001001d000015db0010009c0000012a0000213d000000c401800370000000000101043b000b00000001001d000015db0010009c0000012a0000213d000000e401800370000000000101043b000a00000001001d000015db0010009c0000012a0000213d0000012401800370000000000101043b000900000001001d000016a30010009c0000012a0000213d000000a401800370000000000101043b000700000001001d0000010401800370000000000101043b000500000001001d0000014401800370000000000101043b000800000001001d0000016401800370000000000101043b000600000001001d000000000010043f0000000501000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff0010019000001fd30000c13d000000400100043d000016d20200004100001d7d0000013d0000000002000416000000000002004b0000012a0000c13d56ac46430000040f000f00000002001d000015db01100197000000000010043f0000000b01000039000000200010043f0000004002000039000000000100001956ac566f0000040f000000000101041a00000018011002700000167501100197000000000010043f0000000c01000039000000200010043f0000000001000019000000400200003956ac566f0000040f00000004011000390000000f0200002956ac46c20000040f000000000101041a000000ff001001900000000001000039000000010100c039000000400200043d0000000000120435000015d80020009c000015d80200804100000040012002100000167f011001c7000056ad0001042e000000440010008c0000012a0000413d0000000002000416000000000002004b0000012a0000c13d0000000402800370000000000202043b000800000002001d000016750020009c0000012a0000213d0000002402800370000000000202043b000015dc0020009c0000012a0000213d0000002303200039000000000013004b0000012a0000813d0000000403200039000000000338034f000000000303043b000c00000003001d000015dc0030009c0000012a0000213d000b00240020003d0000000c0200002900000005022002100000000b02200029000000000012004b0000012a0000213d0000000801000029000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000a00000001001d0000000801000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000c0000006b000015900000613d0000000a01000029000700040010003d000d00010010003d000f00000000001d000016d30000013d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000f020000290000000102200039000f00000002001d0000000c0020006c000015900000813d0000000f0100002900000005011002100000000b011000290000000201100367000000000301043b000015db0030009c0000012a0000213d000000000030043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c70000801002000039000e00000003001d56ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b000016ce0000c13d0000000a02000029000000000102041a000015dc0010009c000002ae0000213d000900000001001d0000000101100039000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000000e020000290000012a0000613d000000000101043b0000000901100029000000000021041b0000000a01000029000000000101041a000900000001001d000000000020043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000902000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167d04000041000000000500001900000008060000290000000e0700002956ac56a20000040f0000000e0100002900000001002001900000012a0000613d000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000016c90000c13d0000012a0000013d000000240010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000015db0010009c0000012a0000213d000000000010043f0000000b01000039000000200010043f0000004002000039000000000100001956ac566f0000040f000000000101041a0000001801100270000016750110019756ac4c930000040f0000000002010019000000400100043d000f00000001001d56ac43090000040f0000000f020000290000000001210049000015d80010009c000015d8010080410000006001100210000015d80020009c000015d8020080410000004002200210000000000121019f000056ad0001042e0000000002000416000000000002004b0000012a0000c13d56ac43190000040f56ac492d0000040f0000000001000019000056ad0001042e000000c40010008c0000012a0000413d0000000001000416000000000001004b0000012a0000c13d0000000401800370000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000002401800370000000000101043b000e00000001001d000015db0010009c0000012a0000213d0000006401800370000000000101043b000d00000001001d000015db0010009c0000012a0000213d000000a401800370000000000101043b000a00000001001d0000008401800370000000000101043b000b00000001001d0000004401800370000000000101043b000c00000001001d0000000f01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d000000c0031000390000000000230435000000a0021000390000000a03000029000000000032043500000080021000390000000b03000029000000000032043500000060021000390000000d03000029000000000032043500000040021000390000000c03000029000000000032043500000020021000390000000f030000290000000000320435000000c0030000390000000000310435000016840010009c000002ae0000213d000000e003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000301000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000e02000029000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000f00000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000f05000029000000d002500270000000400300043d0000002004300039000000000024043500000008045002700000168604400197000000000012004b0000000004004019000000000043043500000c520000013d000016cf01000041000000800010043f0000167401000041000056ae00010430000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000f01000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000015e002200197000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000015eb040000410000000f0500002900000df30000013d000000400100043d000016da0200004100001d7d0000013d000000000002004b0000154a0000613d000016e00020009c000000000100c019000000800010043f0000166901000041000056ad0001042e0000000f01000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000015db011001970000000002000411000000000012004b0000184a0000c13d0000000f01000029000000000010043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000015e0022001970000000e06000029000000000262019f000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000015eb0400004100001b2c0000013d000000400100043d000016e10200004100001d7d0000013d000015e001100197000000000161019f000000000010041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000015e2040000410000158d0000013d000b00000005001d000c00000003001d000000140040008c000018610000613d000002d10040008c000018610000613d000004830040008c00001b700000c13d000a00000004001d0000000f01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d000000c0031000390000000000230435000000a0021000390000000c03000029000000000032043500000080021000390000000b03000029000000000032043500000060021000390000000d03000029000000000032043500000040021000390000000a03000029000000000032043500000020021000390000000f030000290000000000320435000000c0030000390000000000310435000016840010009c000002ae0000213d000000e003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000301000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000e02000029000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000ff0020019000002adc0000c13d0000000202000039000000000021041b0000000101000039000000400200043d0000000000120435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000403000039000016a6040000410000000c050000290000000f060000290000000e070000290000158d0000013d000015d80010009c000015d801008041000000c0011002100000166a011001c7000000000204001956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000018e20000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000018de0000c13d000000000005004b000018ef0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000f04000029000000000500041100000001002001900000194e0000613d000000200030008c00000000010000190000194f0000413d000000000100043d000015db011001970000194f0000013d000000000101043b00000000020000190000000e04000029000000000301041a000000000434043600000001011000390000000102200039000000000052004b000018fe0000413d0000000f01000029000000000214004956ac47990000040f000000400100043d000e00000001001d0000000f0200002956ac43090000040f0000000e02000029000017460000013d000015d80010009c000015d801008041000000c0011002100000166a011001c7000000000204001956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000019210000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000191d0000c13d000000000005004b0000192e0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000f040000290000000005000411000000010020019000001b050000613d000000200030008c000000000100001900001b060000413d000000000100043d000015db0110019700001b060000013d000015d80010009c000015d801008041000000c001100210000015e1011001c700008009020000390000000e03000029000000000500001956ac56a20000040f000d00010020019300030000000103550000006001100270000115d80010019d000015d801100197000000000001004b000019860000c13d0000000d0000006b000015900000c13d000000400100043d000016b80200004100001d7d0000013d0000000001000019000000000015004b000019760000c13d000000000040043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000e030000290000ffff0230018f00000098033002100000166d03300197000000000101043b000000000401041a0000166e04400197000000000334019f000000000031041b000000400100043d0000000000210435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d02000039000000020300003900001670040000410000000f050000290000158d0000013d000000400100043d0000006002100039000000400020043f000000400210003900000000005204350000166b02000041000000000221043600000000000204350000001c021000390000000001000414000000040040008c000019ad0000c13d0000000001020433000000000010043f0000000102000039000019d50000013d0000001f03100039000016e3033001970000003f03300039000016e304300197000000400300043d0000000004430019000000000034004b00000000050000390000000105004039000015dc0040009c000002ae0000213d0000000100500190000002ae0000c13d000000400040043f0000000005130436000016e3021001980000001f0310018f000000000125001900000003040003670000199f0000613d000000000604034f000000006706043c0000000005750436000000000015004b0000199b0000c13d000000000003004b000019490000613d000000000224034f0000000303300210000000000401043300000000043401cf000000000434022f000000000202043b0000010003300089000000000232022f00000000023201cf000000000242019f0000000000210435000019490000013d000015d80020009c000015d8020080410000004002200210000015d80010009c000015d801008041000000c001100210000000000121019f0000166c011001c7000000000204001956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000019c50000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000019c10000c13d000000000005004b000019d20000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000f04000029000000010020019000001b6d0000613d000000200030008c00001b6d0000413d000000000100043d000000000001004b000019510000c13d00001b6d0000013d000800000004001d000000000040043f0000000a01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000002000411000015db02200197000000000101043b000000000301041a000015e003300197000000000223019f000000000021041b0000002002000039000000400100043d00000000022104360000000f030000290000000000320435000016e3053001980000001f0630018f000000400310003900000000045300190000000e070000290000002007700039000000020770036700001a040000613d000000000807034f0000000009030019000000008a08043c0000000009a90436000000000049004b00001a000000c13d000000000006004b00001a110000613d000000000557034f0000000306600210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f00000000005404350000000f04000029000000000343001900000000000304350000001f03400039000016e3023001970000167b0020009c0000167b020080410000006002200210000015d80010009c000015d8010080410000004001100210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f0000167c0110009a0000800d020000390000000203000039000015ea04000041000000080500002956ac56a20000040f00000001002001900000012a0000613d0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000015eb040000410000000805000029000000000600041156ac56a20000040f00000001002001900000012a0000613d0000000d01000029000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000a00000001001d0000000d01000029000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000700000001001d0000000d01000029000000000010043f0000000e01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000400000001001d0000000801000029000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000c00000001001d0000000801000029000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000600000001001d0000000801000029000000000010043f0000000e01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000300000001001d0000000a01000029000000000101041a000900000001001d000000000001004b00002bdf0000c13d0000000a010000290000000201100039000a00000001001d000000000101041a000900000001001d000000000001004b00002d3d0000c13d0000000701000029000000000101041a000b00000001001d000000000001004b00002db40000c13d00000007010000290000000201100039000a00000001001d000000000101041a000900000001001d000000000001004b00002f130000c13d0000000401000029000000000101041a000b00000001001d000000000001004b00002f8a0000c13d00000004010000290000000201100039000a00000001001d000000000101041a000900000001001d000000000001004b000030020000c13d000000400100043d00000008020000290000000000210435000015d80010009c000015d80100804100000040011002100000167f011001c7000056ad0001042e00000018011002700000167501100197000000000010043f0000000e01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000002000411000015db02200197000000000020043f0000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000ff0010019000000d340000613d00000044010000390000000201100367000000000101043b000d00000001001d0000000e01000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000f0200002900000000002104470000000e01000029000000000010043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000004011002700000000f0200002900000000002104470000000001000019000056ad0001042e0000000001000019000000000015004b00001b2e0000c13d0000000801000039000000000101041a00001675011001970000000e0010006b00001b100000a13d000000400100043d000016800200004100001d7d0000013d000000000040043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000e060000290000001802600210000016aa02200197000000000101043b000000000301041a000016ab03300197000000000223019f000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000016ac040000410000000f050000290000158d0000013d000000400100043d0000006002100039000000400020043f000000400210003900000000005204350000166b02000041000000000221043600000000000204350000001c021000390000000001000414000000040040008c00001b3e0000c13d0000000001020433000000000010043f000000010200003900001b660000013d000015d80020009c000015d8020080410000004002200210000015d80010009c000015d801008041000000c001100210000000000121019f0000166c011001c7000000000204001956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001b560000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001b520000c13d000000000005004b00001b630000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000f04000029000000010020019000001b6d0000613d000000200030008c00001b6d0000413d000000000100043d000000000001004b00001b080000c13d000000400100043d000016c40200004100001d7d0000013d000016b401000041000000800010043f0000167401000041000056ae000104300000000f01000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000000000104470000000f01000029000000000010043f000000200000043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000040110027000000000000104470000000001000019000056ad0001042e00000000020004110000000f0020006c000020560000613d0000162501000041000000000010043f00000000010004140000000f02000029000000040020008c00001fa20000c13d0000001c0100043d000000000010043f0000000102000039000000010300003100001fc50000013d000015d80010009c000015d801008041000000c0011002100000166a011001c7000000080200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001bb60000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001bb20000c13d000000000005004b00001bc30000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000001ded0000613d000000200030008c000000000100001900001dee0000413d000000000100043d000015db0110019700001dee0000013d000015d80010009c000015d801008041000000c0011002100000166a011001c7000000080200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001be10000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001bdd0000c13d000000000005004b00001bee0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000001eb50000613d000000200030008c000000000100001900001eb60000413d000000000100043d000015db0110019700001eb60000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000b00000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000b0010006b00001d7b0000a13d0000000101000039000000000101041a000000040010019000001d7b0000613d0000000f01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d000000c003100039000000000023043500000060021000390000000d03000029000000000032043500000040021000390000001403000039000000000032043500000020021000390000000f030000290000000000320435000000c0030000390000000000310435000000a003100039000000000003043500000080031000390000000000030435000016840010009c000002ae0000213d000000e003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000201000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000002000411000000000101043b000015db02200197000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000a00000001001d000000000101041a000b00000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000b02000029000000d002200270000000000012004b00001dea0000413d0000000b01000029000000080110027000001686021001970000000c0020006c000029930000413d000016860020009c00001c910000613d0000000c0110006a000000080110021000001687011001970000000a03000029000000000203041a0000168802200197000000000112019f000000000013041b0000000d010000290000000f020000290000000e030000290000000c0400002956ac4d3d0000040f000000000001004b00000bf30000613d0000000c0000006b00000bf30000613d0000000a02000029000000000202041a0000168703200197000016870030009c00000bf30000613d0000000c030000290000000803300210000000000332001900001687033001970000168802200197000000000223019f00002af30000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000a00000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000a0010006b00001d7b0000a13d0000000101000039000000000101041a000000020010019000001d7b0000613d0000000f01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d000000c003100039000000000023043500000080021000390000000c03000029000000000032043500000060021000390000000d03000029000000000032043500000040021000390000048303000039000000000032043500000020021000390000000f030000290000000000320435000000c0030000390000000000310435000000a0031000390000000000030435000016840010009c000002ae0000213d000000e003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000201000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000002000411000000000101043b000015db02200197000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000900000001001d000000000101041a000a00000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000a02000029000000d002200270000000000012004b00001dea0000413d0000000a01000029000000080110027000001686021001970000000b0020006c000029930000413d000016860020009c00001d400000613d0000000b0110006a000000080110021000001687011001970000000903000029000000000203041a0000168802200197000000000112019f000000000013041b0000000d010000290000000f020000290000000e030000290000000c040000290000000b0500002956ac4cd60000040f000000000001004b00000bf30000613d0000000b0000006b00000bf30000613d0000000902000029000000000202041a0000168703200197000016870030009c00000bf30000613d0000000b030000290000000803300210000000000332001900001687033001970000168802200197000000000223019f000000090300002900002af40000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000b00000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000b0010006b00001d7b0000a13d0000000101000039000000000101041a000000010010019000001d830000c13d000000400100043d000016d3020000410000000000210435000015d80010009c000015d8010080410000004001100210000015f0011001c7000056ae000104300000000f01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d000000c003100039000000000023043500000080021000390000000c03000029000000000032043500000060021000390000000d0300002900000000003204350000004002100039000002d103000039000000000032043500000020021000390000000f030000290000000000320435000000c0030000390000000000310435000000a0031000390000000000030435000016840010009c000002ae0000213d000000e003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000201000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000002000411000000000101043b000015db02200197000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000a00000001001d000000000101041a000b00000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000b02000029000000d002200270000000000012004b000029900000813d000000400100043d000016d10200004100001d7d0000013d00000000010000190000000004000411000000000014004b00001ea40000c13d0000000801000029000000000010043f0000000f01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000b00000001001d0000000a0000006b000015900000613d0000000b01000029000700020010003d000c00010010003d000e00000000001d00001e100000013d000000000101043b000000000201041a000016e202200197000000000021041b0000000e020000290000000102200039000e00000002001d0000000a0020006c000015900000813d0000000e01000029000000050110021000000009011000290000000201100367000000000101043b000f00000001001d000015db0010009c0000012a0000213d0000000f01000029000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000000002004b00001e0b0000613d0000000b01000029000000000301041a000000000003004b00001fcd0000613d000000000032004b000d00000002001d00001e690000613d000600000003001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d020000290005000100200092000000000101043b0000000b03000029000000000203041a000000050020006c000030790000a13d0000000602000029000000010220008a0000000001120019000000000101041a000600000001001d000000000030043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000005011000290000000602000029000000000021041b000000000020043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000d02000029000000000021041b0000000b01000029000000000201041a000d00000002001d000000000002004b0000241e0000613d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000d02000029000000010220008a000000000101043b0000000001210019000000000001041b0000000b01000029000000000021041b0000000f01000029000000000010043f0000000c01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000001041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000016760400004100000008050000290000000f0600002956ac56a20000040f00000001002001900000012a0000613d0000000f01000029000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000001e070000c13d0000012a0000013d000000400100043d0000006002100039000000400020043f000000400210003900000000004204350000166b02000041000000000221043600000000000204350000001c0210003900000000010004140000000804000029000000040040008c00001f440000c13d0000000001020433000000000010043f000000010200003900001f6b0000013d00000000010000190000000004000411000000000014004b00001f330000c13d0000000801000029000000000010043f0000000f01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000a00000001001d0000000c0000006b000015900000613d0000000a01000029000700020010003d000d00010010003d000f00000000001d00001ed90000013d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000f020000290000000102200039000f00000002001d0000000c0020006c000015900000813d0000000f0100002900000005011002100000000b011000290000000201100367000000000301043b000015db0030009c0000012a0000213d000000000030043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c70000801002000039000e00000003001d56ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b00001ed40000c13d0000000a02000029000000000102041a000015dc0010009c000002ae0000213d000900000001001d0000000101100039000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000000e020000290000012a0000613d000000000101043b0000000901100029000000000021041b0000000a01000029000000000101041a000900000001001d000000000020043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000902000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d020000390000000303000039000016b90400004100000008050000290000000e0600002956ac56a20000040f0000000e0100002900000001002001900000012a0000613d000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000001ecf0000c13d0000012a0000013d000000400100043d0000006002100039000000400020043f000000400210003900000000004204350000166b02000041000000000221043600000000000204350000001c0210003900000000010004140000000804000029000000040040008c00001f730000c13d0000000001020433000000000010043f000000010200003900001f9a0000013d000015d80020009c000015d8020080410000004002200210000015d80010009c000015d801008041000000c001100210000000000121019f0000166c011001c7000000080200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001f5c0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001f580000c13d000000000005004b00001f690000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000001b6d0000613d000000200030008c00001b6d0000413d000000000100043d000000000001004b00001b6d0000613d00001df10000013d000015d80020009c000015d8020080410000004002200210000015d80010009c000015d801008041000000c001100210000000000121019f0000166c011001c7000000080200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001f8b0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001f870000c13d000000000005004b00001f980000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000001b6d0000613d000000200030008c00001b6d0000413d000000000100043d000000000001004b00001b6d0000613d00001eb90000013d000015d80010009c000015d801008041000000c0011002100000166a011001c70000000f0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000001fb60000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00001fb20000c13d000000000005004b00001fc30000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000100200190000020120000613d000000200030008c0000000001000019000020130000413d000000000100043d000015db01100197000020130000013d000016cd01000041000000000010043f0000001101000039000000040010043f000016ce01000041000056ae000104300000167101000041000000000010044300000000010004120000000400100443000000200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000010110008a000000030010008c000015c80001a13e0000200c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000040010006b000029840000a13d0000000101000039000000000101041a000000400010019000000f870000c13d000029840000013d000016cd01000041000000000010043f0000005101000039000000040010043f000016ce01000041000056ae0001043000000000010000190000000002000411000000000012004b000020560000613d000000400100043d0000006002100039000000400020043f0000004002100039000000000400041100000000004204350000166b02000041000000000221043600000000000204350000001c0210003900000000010004140000000f04000029000000040040008c000020280000c13d0000000001020433000000000010043f00000001020000390000204f0000013d000015d80020009c000015d8020080410000004002200210000015d80010009c000015d801008041000000c001100210000000000121019f0000166c011001c70000000f0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000020400000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000203c0000c13d000000000005004b0000204d0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000001b6d0000613d000000200030008c00001b6d0000413d000000000100043d000000000001004b00001b6d0000613d0000000f01000029000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000e020000290000001002200210000016c502200197000000000101043b000000000301041a000016c603300197000000000223019f000000000021041b0000000f01000029000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000016e2022001970000000d022001af000000000021041b0000000f01000029000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000016e5022001970000000c0000006b000001000220c1bf000000000021041b0000000f01000029000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000b0000006b000016c7020000410000000002006019000000000101043b000000000301041a000016c803300197000000000223019f000000000021041b000000400100043d0000000a020000290000000000210435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000203000039000016c9040000410000000f0500002956ac56a20000040f00000001002001900000012a0000613d000000400100043d00000020021000390000000c0300002900000000003204350000000d020000290000000000210435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e7011001c70000800d020000390000000203000039000016ca040000410000000f0500002956ac56a20000040f00000001002001900000012a0000613d000000400100043d0000000b020000290000000000210435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000203000039000016cb0400004100001b2c0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000040010006b00001d7b0000a13d0000000101000039000000000101041a000000100010019000001d7b0000613d0000000e01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d00000120031000390000000000230435000001000210003900000009030000290000000000320435000000c00210003900000007030000290000000000320435000000a0021000390000000803000029000000000032043500000080021000390000000603000029000000000032043500000060021000390000000f030000290000000000320435000000400210003900000483030000390000000000320435000000e0021000390000000003000411000000000032043500000020021000390000169603000041000000000032043500000120030000390000000000310435000016970010009c000002ae0000213d0000014003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000400000001001d0000167101000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000300000001001d000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000200000001001d000000030010006c00002c560000c13d0000167101000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000400200043d0000002203200039000000040400002900000000004304350000169803000041000000000032043500000002032000390000000000130435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f00001699011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000400000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000090010006c0000423b0000213d0000000802000029000000050020006b0000241b0000213d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000007020000290000000802200270000900000002001d000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000702000029000000ff0220018f0008000100200217000000000101043b000000000201041a000000080220014f000000000021041b00000008002001800000160f0000613d0000000b01000029000000400010008c000032410000613d0000000b01000029000000410010008c000032770000c13d0000000d01000029000d00440010003d00000002020003670000000d01200360000000000101043b0000169b0010009c0000343f0000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000004402100039000000410300003900000000003204350000002402100039000000400300003900000000003204350000169e020000410000000000210435000000040210003900000004030000290000000000320435000000a40410003900000064031000390000000d02000029000000200220008a0000000202200367000000000502034f0000000006030019000000005705043c0000000006760436000000000046004b000021f30000c13d00000040033000390000000004030433000016a0044001970000004002200370000000000202043b000016a102200197000000000242019f0000000000230435000000c402100039000000400020043f00000000020004140000000e03000029000000040030008c000032720000613d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f000016a2011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003b6b0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000022190000c13d00003b6b0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000600000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000060010006b00001d7b0000a13d0000000101000039000000000101041a000000080010019000001d7b0000613d0000000e01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d0000012003100039000000000023043500000100021000390000000d030000290000000000320435000000c0021000390000000c030000290000000000320435000000a0021000390000000103000039000600000003001d000000000032043500000080021000390000000b03000029000000000032043500000060021000390000000f0300002900000000003204350000004002100039000002d1030000390000000000320435000000e0021000390000000003000411000000000032043500000020021000390000169603000041000000000032043500000120030000390000000000310435000016970010009c000002ae0000213d0000014003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000500000001001d0000167101000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000300000001001d000000040010006c00002ca30000c13d0000167101000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000400200043d0000002203200039000000050400002900000000004304350000169803000041000000000032043500000002032000390000000000130435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f00001699011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000500000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000d0010006c0000423b0000213d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000c020000290000000802200270000d00000002001d000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000c02000029000000ff0220018f000c000100200217000000000101043b000000000201041a0000000c0220014f000000000021041b0000000c002001800000160f0000613d0000000801000029000000400010008c0000314c0000613d0000000801000029000000410010008c000031820000c13d0000000a01000029000a00440010003d00000002020003670000000a01200360000000000101043b0000169b0010009c000032bc0000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000004402100039000000410300003900000000003204350000002402100039000000400300003900000000003204350000169e020000410000000000210435000000040210003900000005030000290000000000320435000000a40410003900000064031000390000000a02000029000000200220008a0000000202200367000000000502034f0000000006030019000000005705043c0000000006760436000000000046004b000023310000c13d00000040033000390000000004030433000016a0044001970000004002200370000000000202043b000016a102200197000000000242019f0000000000230435000000c402100039000000400020043f00000000020004140000000e03000029000000040030008c0000317d0000613d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f000016a2011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000038ad0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000023570000c13d000038ad0000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000500000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000050010006b00001d7b0000a13d0000000101000039000000000101041a000000200010019000001d7b0000613d0000000e01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d0000012003100039000000000023043500000100021000390000000d030000290000000000320435000000e00210003900000000030004110000000000320435000000c0021000390000000b030000290000000000320435000000a0021000390000000c03000029000000000032043500000060021000390000000f0300002900000000003204350000004002100039000000140300003900000000003204350000002002100039000016960300004100000000003204350000012003000039000000000031043500000080031000390000000000030435000016970010009c000002ae0000213d0000014003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000500000001001d0000167101000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000300000001001d000000040010006c00002cf00000c13d0000167101000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000400200043d0000002203200039000000050400002900000000004304350000169803000041000000000032043500000002032000390000000000130435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f00001699011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000500000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000d0010006c0000423b0000213d0000000c02000029000000080020006b0000307f0000a13d000000400100043d000016d80200004100001d7d0000013d000016cd01000041000000000010043f0000003101000039000000040010043f000016ce01000041000056ae0001043000001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000040010006b00001d7b0000a13d0000000101000039000000000101041a000000080010019000001d7b0000613d0000000e01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d00000140031000390000000504000029000000000043043500000120031000390000000000230435000001000210003900000009030000290000000000320435000000c00210003900000008030000290000000000320435000000a0021000390000000103000039000500000003001d000000000032043500000080021000390000000703000029000000000032043500000060021000390000000f0300002900000000003204350000004002100039000002d1030000390000000000320435000000e00210003900000000030004110000000000320435000000200210003900000006030000290000000000320435000001400300003900000000003104350000168f0010009c000002ae0000213d0000016003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000600000001001d0000167101000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000300000001001d000000040010006c00002e2c0000c13d0000167101000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000400200043d0000002203200039000000060400002900000000004304350000169803000041000000000032043500000002032000390000000000130435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f00001699011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000600000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000090010006c0000423b0000213d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000008020000290000000802200270000900000002001d000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000802000029000000ff0220018f0008000100200217000000000101043b000000000201041a000000080220014f000000000021041b00000008002001800000160f0000613d0000000b01000029000000400010008c000034820000613d0000000b01000029000000410010008c000034b80000c13d0000000d01000029000d00440010003d00000002020003670000000d01200360000000000101043b0000169b0010009c0000368b0000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000004402100039000000410300003900000000003204350000002402100039000000400300003900000000003204350000169e020000410000000000210435000000040210003900000006030000290000000000320435000000a40410003900000064031000390000000d02000029000000200220008a0000000202200367000000000502034f0000000006030019000000005705043c0000000006760436000000000046004b0000253a0000c13d00000040033000390000000004030433000016a0044001970000004002200370000000000202043b000016a102200197000000000242019f0000000000230435000000c402100039000000400020043f00000000020004140000000e03000029000000040030008c000034b30000613d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f000016a2011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003cc00000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000025600000c13d00003cc00000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000300000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000030010006b00001d7b0000a13d0000000101000039000000000101041a000000200010019000001d7b0000613d0000000e01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d00000140031000390000000504000029000000000043043500000120031000390000000000230435000001000210003900000009030000290000000000320435000000e00210003900000000030004110000000000320435000000c00210003900000007030000290000000000320435000000a0021000390000000803000029000000000032043500000060021000390000000f03000029000000000032043500000040021000390000001403000039000000000032043500000020021000390000000603000029000000000032043500000140030000390000000000310435000000800310003900000000000304350000168f0010009c000002ae0000213d0000016003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000600000001001d0000167101000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000500000001001d000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000300000001001d000000050010006c00002e790000c13d0000167101000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000400200043d0000002203200039000000060400002900000000004304350000169803000041000000000032043500000002032000390000000000130435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f00001699011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000600000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000090010006c0000423b0000213d0000000802000029000000040020006b0000241b0000213d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000007020000290000000802200270000900000002001d000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000702000029000000ff0220018f0008000100200217000000000101043b000000000201041a000000080220014f000000000021041b00000008002001800000160f0000613d0000000b01000029000000400010008c000036ce0000613d0000000b01000029000000410010008c000037040000c13d0000000d01000029000d00440010003d00000002020003670000000d01200360000000000101043b0000169b0010009c0000392e0000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000004402100039000000410300003900000000003204350000002402100039000000400300003900000000003204350000169e020000410000000000210435000000040210003900000006030000290000000000320435000000a40410003900000064031000390000000d02000029000000200220008a0000000202200367000000000502034f0000000006030019000000005705043c0000000006760436000000000046004b0000267c0000c13d00000040033000390000000004030433000016a0044001970000004002200370000000000202043b000016a102200197000000000242019f0000000000230435000000c402100039000000400020043f00000000020004140000000e03000029000000040030008c000036ff0000613d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f000016a2011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003e940000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000026a20000c13d00003e940000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000200000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000020010006b00001d7b0000a13d0000000101000039000000000101041a000000100010019000001d7b0000613d0000000e01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d00000140031000390000000404000029000000000043043500000120031000390000000000230435000001000210003900000009030000290000000000320435000000c00210003900000007030000290000000000320435000000a0021000390000000803000029000000000032043500000080021000390000000603000029000000000032043500000060021000390000000f030000290000000000320435000000400210003900000483030000390000000000320435000000e00210003900000000030004110000000000320435000000200210003900000005030000290000000000320435000001400300003900000000003104350000168f0010009c000002ae0000213d0000016003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000500000001001d0000167101000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000200000001001d000000040010006c00002ec60000c13d0000167101000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000400200043d0000002203200039000000050400002900000000004304350000169803000041000000000032043500000002032000390000000000130435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f00001699011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000500000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000090010006c0000423b0000213d0000000802000029000000030020006b0000241b0000213d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b00000007020000290000000802200270000900000002001d000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000702000029000000ff0220018f0008000100200217000000000101043b000000000201041a000000080220014f000000000021041b00000008002001800000160f0000613d0000000b01000029000000400010008c000037490000613d0000000b01000029000000410010008c0000377f0000c13d0000000d01000029000d00440010003d00000002020003670000000d01200360000000000101043b0000169b0010009c000039710000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000004402100039000000410300003900000000003204350000002402100039000000400300003900000000003204350000169e020000410000000000210435000000040210003900000005030000290000000000320435000000a40410003900000064031000390000000d02000029000000200220008a0000000202200367000000000502034f0000000006030019000000005705043c0000000006760436000000000046004b000027bf0000c13d00000040033000390000000004030433000016a0044001970000004002200370000000000202043b000016a102200197000000000242019f0000000000230435000000c402100039000000400020043f00000000020004140000000e03000029000000040030008c0000377a0000613d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f000016a2011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003ee80000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000027e50000c13d00003ee80000013d000015ef010000410000000d020000290000000000120435000015d80020009c000015d8020080410000004001200210000015f0011001c7000056ae0001043000001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000500000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000050010006b00001d7b0000a13d0000000101000039000000000101041a000000800010019000001d7b0000613d00000024010000390000000201100367000000000101043b000500000001001d000016860010009c0000298a0000213d0000000b01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d000000c0031000390000000000230435000000a0021000390000000803000029000000000032043500000060021000390000000c03000029000000000032043500000040021000390000001403000039000000000032043500000020021000390000000b030000290000000000320435000000c003000039000000000031043500000080031000390000000000030435000016840010009c000002ae0000213d000000e003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000301000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000002000411000000000101043b000015db02200197000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000300000001001d000000000101041a000400000001001d000000ff0010019000002adc0000c13d00000004010000290000168700100198000041580000c13d0000000b01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d00000140031000390000000804000029000000000043043500000120031000390000000000230435000001000210003900000009030000290000000000320435000000e00210003900000000030004110000000000320435000000c00210003900000006030000290000000000320435000000a0021000390000000503000029000000000032043500000060021000390000000c03000029000000000032043500000040021000390000001403000039000000000032043500000020021000390000000703000029000000000032043500000140030000390000000000310435000000800310003900000000000304350000168f0010009c000002ae0000213d0000016003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000700000001001d0000167101000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000600000001001d000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000000060010006c000035f10000c13d0000167101000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000400200043d0000002203200039000000070400002900000000004304350000169803000041000000000032043500000002032000390000000000130435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f00001699011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000700000001001d0000000e01000029000000400010008c00003d2a0000613d0000000e01000029000000410010008c00003d600000c13d0000000f01000029000f00440010003d00000002020003670000000f01200360000000000101043b0000169b0010009c00003f720000a13d0000169d0100004100000000001004430000000b0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000004402100039000000410300003900000000003204350000002402100039000000400300003900000000003204350000169e020000410000000000210435000000040210003900000007030000290000000000320435000000a40410003900000064031000390000000f02000029000000200220008a0000000202200367000000000502034f0000000006030019000000005705043c0000000006760436000000000046004b000029350000c13d00000040033000390000000004030433000016a0044001970000004002200370000000000202043b000016a102200197000000000242019f0000000000230435000000c402100039000000400020043f00000000020004140000000b03000029000000040030008c00003d5b0000613d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f000016a2011001c70000000b0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000041200000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000295b0000c13d000041200000013d00001682010000410000000000100443000000000100041000000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c70000800a0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000400000001001d000016710100004100000000001004430000000001000412000000040010044300000024000004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000040010006b00001d7b0000a13d0000000101000039000000000101041a000000400010019000001d7b0000613d00000024010000390000000201100367000000000101043b000400000001001d000016bf0010009c000029960000413d000000400100043d000016c30200004100001d7d0000013d000000400100043d000016b40200004100001d7d0000013d0000000b01000029000016870010019800002adf0000c13d000000400100043d000016d00200004100001d7d0000013d0000000b01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d000000c0031000390000000000230435000000a0021000390000000803000029000000000032043500000080021000390000000703000029000000000032043500000060021000390000000c03000029000000000032043500000040021000390000048303000039000000000032043500000020021000390000000b030000290000000000320435000000c0030000390000000000310435000016840010009c000002ae0000213d000000e003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000301000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000002000411000000000101043b000015db02200197000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000200000001001d000000000101041a000300000001001d000000ff0010019000002adc0000c13d000000030100002900001687001001980000422b0000c13d0000000b01000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d00000140031000390000000804000029000000000043043500000120031000390000000000230435000001000210003900000009030000290000000000320435000000e00210003900000000030004110000000000320435000000c00210003900000005030000290000000000320435000000a0021000390000000403000029000000000032043500000080021000390000000703000029000000000032043500000060021000390000000c030000290000000000320435000000400210003900000483030000390000000000320435000000200210003900000006030000290000000000320435000001400300003900000000003104350000168f0010009c000002ae0000213d0000016003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000600000001001d0000167101000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000500000001001d000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000300000001001d000000050010006c0000363e0000c13d0000167101000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000400200043d0000002203200039000000060400002900000000004304350000169803000041000000000032043500000002032000390000000000130435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f00001699011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000600000001001d0000000e01000029000000400010008c00003da40000613d0000000e01000029000000410010008c00003dda0000c13d0000000f01000029000f00440010003d00000002020003670000000f01200360000000000101043b0000169b0010009c00003fb50000a13d0000169d0100004100000000001004430000000b0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000004402100039000000410300003900000000003204350000002402100039000000400300003900000000003204350000169e020000410000000000210435000000040210003900000006030000290000000000320435000000a40410003900000064031000390000000f02000029000000200220008a0000000202200367000000000502034f0000000006030019000000005705043c0000000006760436000000000046004b00002ab10000c13d00000040033000390000000004030433000016a0044001970000004002200370000000000202043b000016a102200197000000000242019f0000000000230435000000c402100039000000400020043f00000000020004140000000b03000029000000040030008c00003dd50000613d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f000016a2011001c70000000b0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000041f30000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00002ad70000c13d000041f30000013d000000400100043d000016c00200004100001d7d0000013d0000000b0100002900001688011001970000000a02000029000000000012041b0000000f010000290000000e020000290000000d030000290000000c0400002956ac51f10000040f000000000001004b00000bf30000613d0000000a02000029000000000202041a0000168703200197000016870030009c00000bf30000613d000016880320019700000100022000390000168702200197000000000232019f0000000a03000029000000000023041b00000bf30000013d0000000901000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d0000014003100039000000000023043500000120021000390000000b03000029000000000032043500000100021000390000000c030000290000000000320435000000e0021000390000000d030000290000000000320435000000c00210003900000005030000290000000000320435000000a0021000390000000e03000029000000000032043500000080021000390000000403000029000000000032043500000060021000390000000f0300002900000000003204350000004002100039000000060300002900000000003204350000002002100039000016bb030000410000000000320435000001400300003900000000003104350000168f0010009c000002ae0000213d0000016003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000b00000001001d0000167101000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000500000001001d000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000200000001001d000000050010006c000030ff0000c13d0000167101000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000400200043d00000022032000390000000b0400002900000000004304350000169803000041000000000032043500000002032000390000000000130435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000121019f00001699011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000b00000001001d0000000801000029000000400010008c000031c60000613d0000000801000029000000410010008c000031fc0000c13d0000000a01000029000a00440010003d00000002020003670000000a01200360000000000101043b0000169b0010009c000033bb0000a13d0000169d010000410000000000100443000000090100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000004402100039000000410300003900000000003204350000002402100039000000400300003900000000003204350000169e02000041000000000021043500000004021000390000000b030000290000000000320435000000a40410003900000064031000390000000a02000029000000200220008a0000000202200367000000000502034f0000000006030019000000005705043c0000000006760436000000000046004b00002bb40000c13d00000040033000390000000004030433000016a0044001970000004002200370000000000202043b000016a102200197000000000242019f0000000000230435000000c402100039000000400020043f00000000020004140000000903000029000000040030008c000031f70000613d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f000016a2011001c7000000090200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003ac40000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00002bda0000c13d00003ac40000013d0000000c01000029000500040010003d000d00010010003d000000000300001900002bed0000013d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000f030000290000000103300039000000090030006c00001a960000813d0000000a02000029000000000102041a000f00000003001d000000000031004b000030790000a13d000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000f01100029000000000101041a000015db01100197000e00000001001d000000000010043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b00002be90000c13d0000000c01000029000000000101041a000b00000001001d000015dc0010009c000002ae0000213d0000000b0100002900000001011000390000000c02000029000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000b011000290000000e02000029000000000021041b0000000c01000029000000000101041a000b00000001001d000000000020043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000b02000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167d04000041000000000500001900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000501000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000002be40000c13d0000012a0000013d000000400100043d000300000001001d0000002002100039000015e501000041000100000002001d00000000001204350000167101000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000302000029000000400220003900000000001204350000167101000041000000000010044300000000010004120000000400100443000000e00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000304000029000000a0024000390000000003000410000000000032043500000080024000390000000203000029000000000032043500000060024000390000000000120435000000a0010000390000000000140435000015e60040009c000002ae0000213d0000000302000029000000c001200039000000400010043f0000000101000029000015d80010009c000015d80100804100000040011002100000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000021750000013d000000400100043d000400000001001d0000002002100039000015e501000041000200000002001d00000000001204350000167101000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000402000029000000400220003900000000001204350000167101000041000000000010044300000000010004120000000400100443000000e00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000404000029000000a0024000390000000003000410000000000032043500000080024000390000000303000029000000000032043500000060024000390000000000120435000000a0010000390000000000140435000015e60040009c000002ae0000213d0000000402000029000000c001200039000000400010043f0000000201000029000015d80010009c000015d80100804100000040011002100000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000022b60000013d000000400100043d000400000001001d0000002002100039000015e501000041000200000002001d00000000001204350000167101000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000402000029000000400220003900000000001204350000167101000041000000000010044300000000010004120000000400100443000000e00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000404000029000000a0024000390000000003000410000000000032043500000080024000390000000303000029000000000032043500000060024000390000000000120435000000a0010000390000000000140435000015e60040009c000002ae0000213d0000000402000029000000c001200039000000400010043f0000000201000029000015d80010009c000015d80100804100000040011002100000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f0000000100200190000023f20000c13d0000012a0000013d0000000c01000029000500050010003d000b00020010003d000d00030010003d000000000300001900002d470000013d0000000f030000290000000103300039000000090030006c00001a9d0000813d0000000a02000029000000000102041a000f00000003001d000000000031004b000030790000a13d000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000f01100029000000000101041a000e00000001001d000000000010043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b00002d430000c13d0000000b01000029000000000101041a000c00000001001d000015dc0010009c000002ae0000213d0000000c0100002900000001011000390000000b02000029000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000c011000290000000e02000029000000000021041b0000000b01000029000000000101041a000c00000001001d000000000020043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000c02000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167e04000041000000000500001900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000501000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b00002d430000013d0000000601000029000a00040010003d000d00010010003d000000000200001900002dc20000013d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000f0200002900000001022000390000000b0020006c00001aa20000813d0000000701000029000000000101041a000f00000002001d000000000021004b000030790000a13d0000000701000029000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000f01100029000000000101041a000015db01100197000e00000001001d000000000010043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b00002dbe0000c13d0000000601000029000000000101041a000c00000001001d000015dc0010009c000002ae0000213d0000000c0100002900000001011000390000000602000029000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000c011000290000000e02000029000000000021041b0000000601000029000000000101041a000c00000001001d000000000020043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000c02000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167d04000041000000010500003900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000a01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000002db90000c13d0000012a0000013d000000400100043d000400000001001d0000002002100039000015e501000041000200000002001d00000000001204350000167101000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000402000029000000400220003900000000001204350000167101000041000000000010044300000000010004120000000400100443000000e00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000404000029000000a0024000390000000003000410000000000032043500000080024000390000000303000029000000000032043500000060024000390000000000120435000000a0010000390000000000140435000015e60040009c000002ae0000213d0000000402000029000000c001200039000000400010043f0000000201000029000015d80010009c000015d80100804100000040011002100000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f0000000100200190000024bf0000c13d0000012a0000013d000000400100043d000500000001001d0000002002100039000015e501000041000200000002001d00000000001204350000167101000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000502000029000000400220003900000000001204350000167101000041000000000010044300000000010004120000000400100443000000e00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000504000029000000a0024000390000000003000410000000000032043500000080024000390000000303000029000000000032043500000060024000390000000000120435000000a0010000390000000000140435000015e60040009c000002ae0000213d0000000502000029000000c001200039000000400010043f0000000201000029000015d80010009c000015d80100804100000040011002100000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000025fe0000013d000000400100043d000400000001001d0000002002100039000015e501000041000100000002001d00000000001204350000167101000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000402000029000000400220003900000000001204350000167101000041000000000010044300000000010004120000000400100443000000e00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000404000029000000a0024000390000000003000410000000000032043500000080024000390000000203000029000000000032043500000060024000390000000000120435000000a0010000390000000000140435000015e60040009c000002ae0000213d0000000402000029000000c001200039000000400010043f0000000101000029000015d80010009c000015d80100804100000040011002100000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000027410000013d0000000601000029000700050010003d000c00020010003d000d00030010003d000000000300001900002f220000013d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000f030000290000000103300039000000090030006c00001aa90000813d0000000a02000029000000000102041a000f00000003001d000000000031004b000030790000a13d000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000f01100029000000000101041a000e00000001001d000000000010043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b00002f1e0000c13d0000000c01000029000000000101041a000b00000001001d000015dc0010009c000002ae0000213d0000000b0100002900000001011000390000000c02000029000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000b011000290000000e02000029000000000021041b0000000c01000029000000000101041a000b00000001001d000000000020043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000b02000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167e04000041000000010500003900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000002f190000c13d0000012a0000013d0000000301000029000a00040010003d000d00010010003d000000000200001900002f980000013d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000f0200002900000001022000390000000b0020006c00001aae0000813d0000000401000029000000000101041a000f00000002001d000000000021004b000030790000a13d0000000401000029000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000f01100029000000000101041a000015db01100197000e00000001001d000000000010043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b00002f940000c13d0000000301000029000000000101041a000c00000001001d000015dc0010009c000002ae0000213d0000000c0100002900000001011000390000000302000029000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000c011000290000000e02000029000000000021041b0000000301000029000000000101041a000c00000001001d000000000020043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000c02000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167d04000041000000020500003900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000a01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000002f8f0000c13d0000012a0000013d0000000301000029000700050010003d000c00020010003d000d00030010003d0000000003000019000030110000013d000000000101043b000000000201041a000016e20220019700000001022001bf000000000021041b0000000f030000290000000103300039000000090030006c00001ab50000813d0000000a02000029000000000102041a000f00000003001d000000000031004b000030790000a13d000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000f01100029000000000101041a000e00000001001d000000000010043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000101041a000000000001004b0000300d0000c13d0000000c01000029000000000101041a000b00000001001d000015dc0010009c000002ae0000213d0000000b0100002900000001011000390000000c02000029000000000012041b000000000020043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000b011000290000000e02000029000000000021041b0000000c01000029000000000101041a000b00000001001d000000000020043f0000000d01000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000b02000029000000000021041b0000000001000414000015d80010009c000015d801008041000000c001100210000015e1011001c70000800d0200003900000004030000390000167e04000041000000020500003900000008060000290000000e0700002956ac56a20000040f00000001002001900000012a0000613d0000000e01000029000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000030080000c13d0000012a0000013d000016cd01000041000000000010043f0000003201000039000000040010043f000016ce01000041000056ae000104300000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000b020000290000000802200270000d00000002001d000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d0000000b02000029000000ff0220018f000c000100200217000000000101043b000000000201041a0000000c0220014f000000000021041b0000000c002001800000160f0000613d0000000701000029000000400010008c000032ff0000613d0000000701000029000000410010008c000033350000c13d0000000a01000029000b00440010003d00000002020003670000000b01200360000000000101043b0000169b0010009c000034fc0000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000004402100039000000410300003900000000003204350000002402100039000000400300003900000000003204350000169e020000410000000000210435000000040210003900000005030000290000000000320435000000a40410003900000064031000390000000b02000029000000200220008a0000000202200367000000000502034f0000000006030019000000005705043c0000000006760436000000000046004b000030d40000c13d00000040033000390000000004030433000016a0044001970000004002200370000000000202043b000016a102200197000000000242019f0000000000230435000000c402100039000000400020043f00000000020004140000000e03000029000000040030008c000033300000613d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f000016a2011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003bf10000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000030fa0000c13d00003bf10000013d000000400100043d000500000001001d0000002002100039000015e501000041000100000002001d00000000001204350000167101000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000502000029000000400220003900000000001204350000167101000041000000000010044300000000010004120000000400100443000000e00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000504000029000000a0024000390000000003000410000000000032043500000080024000390000000203000029000000000032043500000060024000390000000000120435000000a0010000390000000000140435000015e60040009c000002ae0000213d0000000502000029000000c001200039000000400010043f0000000101000029000015d80010009c000015d80100804100000040011002100000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d00002b6c0000013d0000000a01000029000a00440010003d00000002030003670000000a01300360000000000101043b0000169a021001970000169b0020009c0000337a0000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d000000440210003900000040030000390000000000320435000000240210003900000000003204350000169e020000410000000000210435000000040210003900000005030000290000000000320435000000a40210003900000064031000390000000a04000029000000200440008a0000000204400367000000004504043c0000000003530436000000000023004b000031740000c13d000000400020043f00000000020004140000000e03000029000000040030008c000038950000c13d0000000001010433000000000010043f00000001020000390000000103000031000038bc0000013d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000002402100039000000400300003900000000003204350000169e020000410000000000210435000000040210003900000005030000290000000000320435000000440210003900000008030000290000000000320435000016e3043001980000001f0530018f00000064071000390000000003470019000000070600002900000020066000390000000206600367000031ab0000613d000000000806034f000000008908043c0000000007970436000000000037004b000031a70000c13d000000000005004b000031b80000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f000000000043043500000008030000290000001f03300039000016e30230019700000064032000390000000002310019000000400020043f00000000020004140000000e04000029000000040040008c000037c40000c13d0000000001010433000000000010043f0000000102000031000037ef0000013d0000000a01000029000a00440010003d00000002030003670000000a01300360000000000101043b0000169a021001970000169b0020009c000033fe0000a13d0000169d010000410000000000100443000000090100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d000000440210003900000040030000390000000000320435000000240210003900000000003204350000169e02000041000000000021043500000004021000390000000b030000290000000000320435000000a40210003900000064031000390000000a04000029000000200440008a0000000204400367000000004504043c0000000003530436000000000023004b000031ee0000c13d000000400020043f00000000020004140000000903000029000000040030008c00003aac0000c13d0000000001010433000000000010043f0000000102000039000000010300003100003ad30000013d0000169d010000410000000000100443000000090100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000002402100039000000400300003900000000003204350000169e02000041000000000021043500000004021000390000000b030000290000000000320435000000440210003900000008030000290000000000320435000016e3043001980000001f0530018f00000064071000390000000003470019000000070600002900000020066000390000000206600367000032250000613d000000000806034f000000008908043c0000000007970436000000000037004b000032210000c13d000000000005004b000032320000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f000000000043043500000008030000290000001f03300039000016e30230019700000064032000390000000002310019000000400020043f00000000020004140000000904000029000000040040008c000038660000c13d0000000001010433000000000010043f00000001020000390000000103000031000038900000013d0000000d01000029000d00440010003d00000002030003670000000d01300360000000000101043b0000169a021001970000169b0020009c0000353f0000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d000000440210003900000040030000390000000000320435000000240210003900000000003204350000169e020000410000000000210435000000040210003900000004030000290000000000320435000000a40210003900000064031000390000000d04000029000000200440008a0000000204400367000000004504043c0000000003530436000000000023004b000032690000c13d000000400020043f00000000020004140000000e03000029000000040030008c00003b530000c13d0000000001010433000000000010043f0000000102000039000000010300003100003b7a0000013d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000002402100039000000400300003900000000003204350000169e02000041000000000021043500000004021000390000000403000029000000000032043500000044021000390000000b030000290000000000320435000016e3043001980000001f0530018f000000640710003900000000034700190000000a0600002900000020066000390000000206600367000032a00000613d000000000806034f000000008908043c0000000007970436000000000037004b0000329c0000c13d000000000005004b000032ad0000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000b030000290000001f03300039000016e30230019700000064032000390000000002310019000000400020043f00000000020004140000000e04000029000000040040008c000039b40000c13d0000000001010433000000000010043f00000001020000390000000103000031000039de0000013d0000000a04000029000000200340008a000000000332034f0000002004400039000000000242034f000000000202043b000000000303043b000000400400043d0000006005400039000000000015043500000040014000390000000000310435000000f8012002700000002002400039000000000012043500000005010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000032e70000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000032e30000c13d000000000005004b000032f40000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000100200190000035800000613d000000000100043d000015db001001980000230e0000613d0000000e0110014f000015db00100198000038c30000613d0000230e0000013d0000000a01000029000b00440010003d00000002030003670000000b01300360000000000101043b0000169a021001970000169b0020009c0000358c0000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d000000440210003900000040030000390000000000320435000000240210003900000000003204350000169e020000410000000000210435000000040210003900000005030000290000000000320435000000a40210003900000064031000390000000b04000029000000200440008a0000000204400367000000004504043c0000000003530436000000000023004b000033270000c13d000000400020043f00000000020004140000000e03000029000000040030008c00003bd90000c13d0000000001010433000000000010043f0000000102000039000000010300003100003c000000013d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000002402100039000000400300003900000000003204350000169e020000410000000000210435000000040210003900000005030000290000000000320435000000440210003900000007030000290000000000320435000016e3043001980000001f0530018f000000640710003900000000034700190000000606000029000000200660003900000002066003670000335e0000613d000000000806034f000000008908043c0000000007970436000000000037004b0000335a0000c13d000000000005004b0000336b0000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f000000000043043500000007030000290000001f03300039000016e30230019700000064032000390000000002310019000000400020043f00000000020004140000000e04000029000000040040008c000039e30000c13d0000000001010433000000000010043f0000000102000039000000010300003100003a0d0000013d0000000a04000029000000200440008a000000000343034f000000000303043b000000400400043d0000006005400039000000000025043500000040024000390000000000320435000000ff011002700000001b011000390000002002400039000000000012043500000005010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000033a30000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000339f0000c13d000000000005004b000033b00000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000100200190000035cd0000613d000000000100043d000015db00100198000031540000613d0000000e0110014f000015db00100198000038c30000613d000031540000013d0000000a04000029000000200340008a000000000332034f0000002004400039000000000242034f000000000202043b000000000303043b000000400400043d0000006005400039000000000015043500000040014000390000000000310435000000f801200270000000200240003900000000001204350000000b010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000033e60000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000033e20000c13d000000000005004b000033f30000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000100200190000035d90000613d000000000100043d000015db0010019800002b910000613d000000090110014f000015db0010019800003ada0000613d00002b910000013d0000000a04000029000000200440008a000000000343034f000000000303043b000000400400043d0000006005400039000000000025043500000040024000390000000000320435000000ff011002700000001b01100039000000200240003900000000001204350000000b010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000034270000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000034230000c13d000000000005004b000034340000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000100200190000035e50000613d000000000100043d000015db00100198000031ce0000613d000000090110014f000015db0010019800003ada0000613d000031ce0000013d0000000d04000029000000200340008a000000000332034f0000002004400039000000000242034f000000000202043b000000000303043b000000400400043d0000006005400039000000000015043500000040014000390000000000310435000000f8012002700000002002400039000000000012043500000004010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f00000020044001900000346a0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000034660000c13d000000000005004b000034770000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000100200190000037f50000613d000000000100043d000015db00100198000021d00000613d0000000e0110014f000015db0010019800003b810000613d000021d00000013d0000000d01000029000d00440010003d00000002030003670000000d01300360000000000101043b0000169a021001970000169b0020009c000038010000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d000000440210003900000040030000390000000000320435000000240210003900000000003204350000169e020000410000000000210435000000040210003900000006030000290000000000320435000000a40210003900000064031000390000000d04000029000000200440008a0000000204400367000000004504043c0000000003530436000000000023004b000034aa0000c13d000000400020043f00000000020004140000000e03000029000000040030008c00003ca80000c13d0000000001010433000000000010043f0000000102000039000000010300003100003ccf0000013d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000002402100039000000400300003900000000003204350000169e02000041000000000021043500000004021000390000000603000029000000000032043500000044021000390000000b030000290000000000320435000016e3043001980000001f0530018f000000640710003900000000034700190000000a0600002900000020066000390000000206600367000034e10000613d000000000806034f000000008908043c0000000007970436000000000037004b000034dd0000c13d000000000005004b000034ee0000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000b030000290000001f03300039000016e30230019700000064032000390000000002310019000000400020043f00000000020004140000000e04000029000000040040008c00003c350000c13d0000000001010433000000000010043f000000010200003100003c600000013d0000000b04000029000000200340008a000000000332034f0000002004400039000000000242034f000000000202043b000000000303043b000000400400043d0000006005400039000000000015043500000040014000390000000000310435000000f8012002700000002002400039000000000012043500000005010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000035270000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000035230000c13d000000000005004b000035340000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000100200190000038420000613d000000000100043d000015db00100198000030b10000613d0000000e0110014f000015db0010019800003c070000613d000030b10000013d0000000d04000029000000200440008a000000000343034f000000000303043b000000400400043d0000006005400039000000000025043500000040024000390000000000320435000000ff011002700000001b011000390000002002400039000000000012043500000004010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000035680000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000035640000c13d000000000005004b000035750000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000384e0000613d000000000100043d000015db00100198000032490000613d0000000e0110014f000015db0010019800003b810000613d000032490000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000035870000c13d00003c950000013d0000000b04000029000000200440008a000000000343034f000000000303043b000000400400043d0000006005400039000000000025043500000040024000390000000000320435000000ff011002700000001b011000390000002002400039000000000012043500000005010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000035b50000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000035b10000c13d000000000005004b000035c20000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000385a0000613d000000000100043d000015db00100198000033070000613d0000000e0110014f000015db0010019800003c070000613d000033070000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000035d40000c13d00003c950000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000035e00000c13d00003c950000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000035ec0000c13d00003c950000013d000000400100043d000600000001001d0000002002100039000015e501000041000200000002001d00000000001204350000167101000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000602000029000000400220003900000000001204350000167101000041000000000010044300000000010004120000000400100443000000e00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000604000029000000a0024000390000000003000410000000000032043500000080024000390000000403000029000000000032043500000060024000390000000000120435000000a0010000390000000000140435000015e60040009c000002ae0000213d0000000602000029000000c001200039000000400010043f0000000201000029000015d80010009c000015d80100804100000040011002100000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f0000000100200190000028ed0000c13d0000012a0000013d000000400100043d000500000001001d0000002002100039000015e501000041000100000002001d00000000001204350000167101000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000502000029000000400220003900000000001204350000167101000041000000000010044300000000010004120000000400100443000000e00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b0000000504000029000000a0024000390000000003000410000000000032043500000080024000390000000303000029000000000032043500000060024000390000000000120435000000a0010000390000000000140435000015e60040009c000002ae0000213d0000000502000029000000c001200039000000400010043f0000000101000029000015d80010009c000015d80100804100000040011002100000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d00002a690000013d0000000d04000029000000200340008a000000000332034f0000002004400039000000000242034f000000000202043b000000000303043b000000400400043d0000006005400039000000000015043500000040014000390000000000310435000000f8012002700000002002400039000000000012043500000006010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000036b60000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000036b20000c13d000000000005004b000036c30000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000003a120000613d000000000100043d000015db00100198000025170000613d0000000e0110014f000015db0010019800003cd60000613d000025170000013d0000000d01000029000d00440010003d00000002030003670000000d01300360000000000101043b0000169a021001970000169b0020009c00003a1e0000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d000000440210003900000040030000390000000000320435000000240210003900000000003204350000169e020000410000000000210435000000040210003900000006030000290000000000320435000000a40210003900000064031000390000000d04000029000000200440008a0000000204400367000000004504043c0000000003530436000000000023004b000036f60000c13d000000400020043f00000000020004140000000e03000029000000040030008c00003e7c0000c13d0000000001010433000000000010043f0000000102000039000000010300003100003ea30000013d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000002402100039000000400300003900000000003204350000169e02000041000000000021043500000004021000390000000603000029000000000032043500000044021000390000000b030000290000000000320435000016e3043001980000001f0530018f000000640710003900000000034700190000000a06000029000000200660003900000002066003670000372d0000613d000000000806034f000000008908043c0000000007970436000000000037004b000037290000c13d000000000005004b0000373a0000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000b030000290000001f03300039000016e30230019700000064032000390000000002310019000000400020043f00000000020004140000000e04000029000000040040008c00003e1e0000c13d0000000001010433000000000010043f0000000102000039000000010300003100003e480000013d0000000d01000029000d00440010003d00000002030003670000000d01300360000000000101043b0000169a021001970000169b0020009c00003a5f0000a13d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d000000440210003900000040030000390000000000320435000000240210003900000000003204350000169e020000410000000000210435000000040210003900000005030000290000000000320435000000a40210003900000064031000390000000d04000029000000200440008a0000000204400367000000004504043c0000000003530436000000000023004b000037710000c13d000000400020043f00000000020004140000000e03000029000000040030008c00003ed00000c13d0000000001010433000000000010043f0000000102000039000000010300003100003ef70000013d0000169d0100004100000000001004430000000e0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000002402100039000000400300003900000000003204350000169e02000041000000000021043500000004021000390000000503000029000000000032043500000044021000390000000b030000290000000000320435000016e3043001980000001f0530018f000000640710003900000000034700190000000a0600002900000020066000390000000206600367000037a80000613d000000000806034f000000008908043c0000000007970436000000000037004b000037a40000c13d000000000005004b000037b50000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000b030000290000001f03300039000016e30230019700000064032000390000000002310019000000400020043f00000000020004140000000e04000029000000040040008c00003e4d0000c13d0000000001010433000000000010043f0000000102000039000000010300003100003e770000013d000015d80030009c000015d8030080410000006003300210000015d80010009c000015d8010080410000004001100210000000000131019f000015d80020009c000015d802008041000000c002200210000000000112019f0000000e0200002956ac56a70000040f000600000002001d0000006002100270000015d802200197000000200020008c000000200300003900000000030240190000001f0430018f0000002003300190000037e00000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000036004b000037dc0000c13d000000000004004b000037ed0000613d000000000531034f0000000304400210000000000603043300000000064601cf000000000646022f000000000505043b0000010004400089000000000545022f00000000044501cf000000000464019f0000000000430435000100000002001f0003000000010355000000060100002900000001001001900000423e0000613d000000200020008c000038c00000813d0000423e0000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000037fc0000c13d00003c950000013d0000000d04000029000000200440008a000000000343034f000000000303043b000000400400043d0000006005400039000000000025043500000040024000390000000000320435000000ff011002700000001b011000390000002002400039000000000012043500000006010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f00000020044001900000382a0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000038260000c13d000000000005004b000038370000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000003aa00000613d000000000100043d000015db001001980000348a0000613d0000000e0110014f000015db0010019800003cd60000613d0000348a0000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000038490000c13d00003c950000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000038550000c13d00003c950000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000038610000c13d00003c950000013d000015d80030009c000015d8030080410000006003300210000015d80010009c000015d8010080410000004001100210000000000131019f000015d80020009c000015d802008041000000c002200210000000000112019f000000090200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000038810000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000387d0000c13d000000000005004b0000388e0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d000000200030008c00003ad70000813d0000423e0000013d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f0000169f011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000038ad0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000038a90000c13d000000000005004b000038ba0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d0000001f0030008c0000423e0000a13d000000000100043d0000169e0010009c0000423e0000c13d0000000f0100002900000000020004110000000e0300002900000009040000290000000b0500002956ac52d80000040f0000ffff0220018f000002d10020008c000038ce0000613d000000000002004b000042d80000c13d000016af0010009c000039090000213d0000169d0100004100000000001004430000000f0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000012a0000613d000000400300043d00000044013000390000000b020000290000000000210435000000240130003900000009020000290000000000210435000016b0010000410000000000130435000b00000003001d00000004013000390000000e02000029000000000021043500000000010004140000000f02000029000000040020008c000039010000613d0000000b02000029000015d80020009c000015d8020080410000004002200210000015d80010009c000015d801008041000000c001100210000000000121019f000016b1011001c70000000f0200002956ac56a20000040f0000006003100270000115d80030019d00030000000103550000000100200190000039090000613d0000000b01000029000015dc0010009c000002ae0000213d0000000b01000029000000400010043f00000000010000190000000b020000290000167d0000013d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000d02000029000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a0000000c0220014f000000000021041b0000000c00200180000000400100043d000b00000001001d00003d270000c13d00000001010000390000000b020000290000167d0000013d0000000d04000029000000200340008a000000000332034f0000002004400039000000000242034f000000000202043b000000000303043b000000400400043d0000006005400039000000000015043500000040014000390000000000310435000000f8012002700000002002400039000000000012043500000006010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000039590000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000039550000c13d000000000005004b000039660000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000003c660000613d000000000100043d000015db00100198000026590000613d0000000e0110014f000015db0010019800003eaa0000613d000026590000013d0000000d04000029000000200340008a000000000332034f0000002004400039000000000242034f000000000202043b000000000303043b000000400400043d0000006005400039000000000015043500000040014000390000000000310435000000f8012002700000002002400039000000000012043500000005010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f00000020044001900000399c0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000039980000c13d000000000005004b000039a90000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000003c720000613d000000000100043d000015db001001980000279c0000613d0000000e0110014f000015db0010019800003efe0000613d0000279c0000013d000015d80030009c000015d8030080410000006003300210000015d80010009c000015d8010080410000004001100210000000000131019f000015d80020009c000015d802008041000000c002200210000000000112019f0000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000039cf0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000039cb0000c13d000000000005004b000039dc0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d000000200030008c00003b7e0000813d0000423e0000013d000015d80030009c000015d8030080410000006003300210000015d80010009c000015d8010080410000004001100210000000000131019f000015d80020009c000015d802008041000000c002200210000000000112019f0000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000039fe0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000039fa0000c13d000000000005004b00003a0b0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d000000200030008c00003c040000813d0000423e0000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00003a190000c13d00003c950000013d0000000d04000029000000200440008a000000000343034f000000000303043b000000400400043d0000006005400039000000000025043500000040024000390000000000320435000000ff011002700000001b011000390000002002400039000000000012043500000006010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003a470000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003a430000c13d000000000005004b00003a540000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000003c7e0000613d000000000100043d000015db00100198000036d60000613d0000000e0110014f000015db0010019800003eaa0000613d000036d60000013d0000000d04000029000000200440008a000000000343034f000000000303043b000000400400043d0000006005400039000000000025043500000040024000390000000000320435000000ff011002700000001b011000390000002002400039000000000012043500000005010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003a880000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003a840000c13d000000000005004b00003a950000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f0003000000010355000000010020019000003c8a0000613d000000000100043d000015db00100198000037510000613d0000000e0110014f000015db0010019800003efe0000613d000037510000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00003aa70000c13d00003c950000013d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f0000169f011001c7000000090200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003ac40000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003ac00000c13d000000000005004b00003ad10000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d0000001f0030008c0000423e0000a13d000000000100043d0000169e0010009c0000423e0000c13d0000000901000029000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000303000029000016a3043001970000000c0000006b0000000c0400c029000c00000004001d00000001002001900000012a0000613d000000000101043b000000000201041a000000400100043d000000c003100039000000000023043500000080021000390000000403000029000000000032043500000060021000390000000f030000290000000000320435000000400210003900000006030000290000000000320435000000200210003900000009030000290000000000320435000000c0030000390000000000310435000000a0031000390000000000030435000016840010009c000002ae0000213d000000e003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000010043f0000000201000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000d02000029000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000ff0220018f0000000c05000029000000d003500210000000000232019f0000000e0400002900000008034002100000168703300197000000000232019f000000000021041b000000400100043d000000400210003900000000005204350000002002100039000000000042043500000004020000290000000000210435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e9011001c70000800d020000390000000403000039000016bc0400004100000009050000290000000f060000290000000d070000290000158d0000013d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f0000169f011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003b6b0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003b670000c13d000000000005004b00003b780000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d0000001f0030008c0000423e0000a13d000000000100043d0000169e0010009c0000423e0000c13d0000000f0100002900000000020004110000000e030000290000000c04000029000000060500002956ac52d80000040f0000ffff0220019000003b8b0000613d000004830020008c000042d80000c13d000016af0010009c00003bc60000213d0000169d0100004100000000001004430000000f0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000012a0000613d000000400300043d0000008401300039000000a002000039000000000021043500000064013000390000000502000029000000000021043500000044013000390000000602000029000000000021043500000024013000390000000c020000290000000000210435000016c101000041000000000013043500000004013000390000000e020000290000000000210435000d00000003001d000000a401300039000000000001043500000000010004140000000f02000029000000040020008c00003f440000613d0000000d02000029000015d80020009c000015d8020080410000004002200210000015d80010009c000015d801008041000000c001100210000000000121019f000016a2011001c70000000f0200002956ac56a20000040f0000006003100270000115d80030019d0003000000010355000000010020019000003f440000c13d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000902000029000000000020043f000000200010043f000000000100041400003f5d0000013d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f0000169f011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003bf10000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003bed0000c13d000000000005004b00003bfe0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d0000001f0030008c0000423e0000a13d000000000100043d0000169e0010009c0000423e0000c13d0000000f010000290000000e020000290000000903000029000000080400002956ac4d3d0000040f000f00000001001d000000000001004b00003c110000c13d0000000f0100002900000bf30000013d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000d02000029000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a0000000c03000029000000000232013f000000000021041b000000000032017000003c0f0000613d000000400100043d000016b20200004100001d7d0000013d000015d80030009c000015d8030080410000006003300210000015d80010009c000015d8010080410000004001100210000000000131019f000015d80020009c000015d802008041000000c002200210000000000112019f0000000e0200002956ac56a70000040f000500000002001d0000006002100270000015d802200197000000200020008c000000200300003900000000030240190000001f0430018f000000200330019000003c510000613d000000000501034f0000000006000019000000005705043c0000000006760436000000000036004b00003c4d0000c13d000000000004004b00003c5e0000613d000000000531034f0000000304400210000000000603043300000000064601cf000000000646022f000000000505043b0000010004400089000000000545022f00000000044501cf000000000464019f0000000000430435000100000002001f0003000000010355000000050100002900000001001001900000423e0000613d000000200020008c00003cd30000813d0000423e0000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00003c6d0000c13d00003c950000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00003c790000c13d00003c950000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00003c850000c13d00003c950000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00003c910000c13d000000000005004b00003ca20000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000015d80020009c000015d8020080410000004002200210000000000112019f000056ae00010430000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f0000169f011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003cc00000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003cbc0000c13d000000000005004b00003ccd0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d0000001f0030008c0000423e0000a13d000000000100043d0000169e0010009c0000423e0000c13d0000000f0100002900000000020004110000000e030000290000000c04000029000000070500002956ac52d80000040f0000ffff0220018f000002d10020008c00003ce10000613d000000000002004b000042d80000c13d000016af0010009c00003d140000213d0000169d0100004100000000001004430000000f0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000012a0000613d000000400300043d00000044013000390000000702000029000000000021043500000024013000390000000c020000290000000000210435000016b0010000410000000000130435000d00000003001d00000004013000390000000e02000029000000000021043500000000010004140000000f02000029000000040020008c00003f440000613d0000000d02000029000015d80020009c000015d8020080410000004002200210000015d80010009c000015d801008041000000c001100210000000000121019f000016b1011001c70000000f0200002956ac56a20000040f0000006003100270000115d80030019d0003000000010355000000010020019000003f440000c13d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000902000029000000000020043f000000200010043f000000000100041400003f5d0000013d000016b2010000410000000b02000029000027ec0000013d0000000f01000029000f00440010003d00000002030003670000000f01300360000000000101043b0000169a021001970000169b0020009c00003ff80000a13d0000169d0100004100000000001004430000000b0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d000000440210003900000040030000390000000000320435000000240210003900000000003204350000169e020000410000000000210435000000040210003900000007030000290000000000320435000000a40210003900000064031000390000000f04000029000000200440008a0000000204400367000000004504043c0000000003530436000000000023004b00003d520000c13d000000400020043f00000000020004140000000b03000029000000040030008c000041080000c13d0000000001010433000000000010043f000000010200003900000001030000310000412f0000013d0000169d0100004100000000001004430000000b0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000002402100039000000400300003900000000003204350000169e02000041000000000021043500000004021000390000000703000029000000000032043500000044021000390000000e030000290000000000320435000016e3043001980000001f0530018f000000640710003900000000034700190000000d06000029000000020660036700003d880000613d000000000806034f000000008908043c0000000007970436000000000037004b00003d840000c13d000000000005004b00003d950000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000e030000290000001f03300039000016e30230019700000064032000390000000002310019000000400020043f00000000020004140000000b04000029000000040040008c000040aa0000c13d0000000001010433000000000010043f00000001020000390000000103000031000040d40000013d0000000f01000029000f00440010003d00000002030003670000000f01300360000000000101043b0000169a021001970000169b0020009c000040390000a13d0000169d0100004100000000001004430000000b0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d000000440210003900000040030000390000000000320435000000240210003900000000003204350000169e020000410000000000210435000000040210003900000006030000290000000000320435000000a40210003900000064031000390000000f04000029000000200440008a0000000204400367000000004504043c0000000003530436000000000023004b00003dcc0000c13d000000400020043f00000000020004140000000b03000029000000040030008c000041db0000c13d0000000001010433000000000010043f00000001020000390000000103000031000042020000013d0000169d0100004100000000001004430000000b0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000423e0000613d000000400100043d0000002402100039000000400300003900000000003204350000169e02000041000000000021043500000004021000390000000603000029000000000032043500000044021000390000000e030000290000000000320435000016e3043001980000001f0530018f000000640710003900000000034700190000000d06000029000000020660036700003e020000613d000000000806034f000000008908043c0000000007970436000000000037004b00003dfe0000c13d000000000005004b00003e0f0000613d000000000446034f0000000305500210000000000603043300000000065601cf000000000656022f000000000404043b0000010005500089000000000454022f00000000045401cf000000000464019f00000000004304350000000e030000290000001f03300039000016e30230019700000064032000390000000002310019000000400020043f00000000020004140000000b04000029000000040040008c000040d90000c13d0000000001010433000000000010043f00000001020000390000000103000031000041030000013d000015d80030009c000015d8030080410000006003300210000015d80010009c000015d8010080410000004001100210000000000131019f000015d80020009c000015d802008041000000c002200210000000000112019f0000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003e390000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003e350000c13d000000000005004b00003e460000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d000000200030008c00003ea70000813d0000423e0000013d000015d80030009c000015d8030080410000006003300210000015d80010009c000015d8010080410000004001100210000000000131019f000015d80020009c000015d802008041000000c002200210000000000112019f0000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003e680000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003e640000c13d000000000005004b00003e750000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d000000200030008c00003efb0000813d0000423e0000013d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f0000169f011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003e940000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003e900000c13d000000000005004b00003ea10000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d0000001f0030008c0000423e0000a13d000000000100043d0000169e0010009c0000423e0000c13d0000000f010000290000000e020000290000000c03000029000000040400002956ac4d3d0000040f000f00000001001d000000000001004b00003c0f0000613d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000902000029000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000080300002900003c2e0000013d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f0000169f011001c70000000e0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003ee80000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003ee40000c13d000000000005004b00003ef50000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d0000001f0030008c0000423e0000a13d000000000100043d0000169e0010009c0000423e0000c13d0000000f0100002900000000020004110000000e030000290000000c04000029000000060500002956ac52d80000040f0000ffff0220018f000004830020008c00003f090000613d000000000002004b000042d80000c13d000016af0010009c00003f4b0000213d0000169d0100004100000000001004430000000f0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000012a0000613d000000400300043d0000008401300039000000a002000039000000000021043500000064013000390000000302000029000000000021043500000044013000390000000602000029000000000021043500000024013000390000000c020000290000000000210435000016c101000041000000000013043500000004013000390000000e020000290000000000210435000d00000003001d000000a401300039000000000001043500000000010004140000000f02000029000000040020008c00003f440000613d0000000d02000029000015d80020009c000015d8020080410000004002200210000015d80010009c000015d801008041000000c001100210000000000121019f000016a2011001c70000000f0200002956ac56a20000040f0000006003100270000115d80030019d0003000000010355000000010020019000003f4b0000613d0000000d01000029000015dc0010009c000002ae0000213d0000000d01000029000000400010043f000000000100001900003f6e0000013d0000000e01000029000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b0000000902000029000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000012a0000613d000000000101043b000000000201041a000000080220014f000000000021041b0000000800200180000000400100043d000d00000001001d00003f700000c13d00000001010000390000000d020000290000167d0000013d000016b201000041000027eb0000013d0000000f04000029000000200340008a000000000332034f0000002004400039000000000242034f000000000202043b000000000303043b000000400400043d0000006005400039000000000015043500000040014000390000000000310435000000f8012002700000002002400039000000000012043500000007010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003f9d0000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003f990000c13d000000000005004b00003faa0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000407a0000613d000000000100043d000015db00100198000029120000613d0000000b0110014f000015db00100198000041360000613d000029120000013d0000000f04000029000000200340008a000000000332034f0000002004400039000000000242034f000000000202043b000000000303043b000000400400043d0000006005400039000000000015043500000040014000390000000000310435000000f8012002700000002002400039000000000012043500000006010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f000000200440019000003fe00000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b00003fdc0000c13d000000000005004b00003fed0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000100200190000040860000613d000000000100043d000015db0010019800002a8e0000613d0000000b0110014f000015db00100198000042090000613d00002a8e0000013d0000000f04000029000000200440008a000000000343034f000000000303043b000000400400043d0000006005400039000000000025043500000040024000390000000000320435000000ff011002700000001b011000390000002002400039000000000012043500000007010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000040210000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000401d0000c13d000000000005004b0000402e0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f00030000000103550000000100200190000040920000613d000000000100043d000015db0010019800003d320000613d0000000b0110014f000015db00100198000041360000613d00003d320000013d0000000f04000029000000200440008a000000000343034f000000000303043b000000400400043d0000006005400039000000000025043500000040024000390000000000320435000000ff011002700000001b011000390000002002400039000000000012043500000006010000290000000000140435000000000000043f000015d80040009c000015d80400804100000040014002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000169c011001c7000000010200003956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000040620000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000405e0000c13d000000000005004b0000406f0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000409e0000613d000000000100043d000015db0010019800003dac0000613d0000000b0110014f000015db00100198000042090000613d00003dac0000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000040810000c13d00003c950000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000408d0000c13d00003c950000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000040990000c13d00003c950000013d0000001f0530018f000015da06300198000000400200043d000000000462001900003c950000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000040a50000c13d00003c950000013d000015d80030009c000015d8030080410000006003300210000015d80010009c000015d8010080410000004001100210000000000131019f000015d80020009c000015d802008041000000c002200210000000000112019f0000000b0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000040c50000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000040c10000c13d000000000005004b000040d20000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d000000200030008c000041330000813d0000423e0000013d000015d80030009c000015d8030080410000006003300210000015d80010009c000015d8010080410000004001100210000000000131019f000015d80020009c000015d802008041000000c002200210000000000112019f0000000b0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000040f40000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000040f00000c13d000000000005004b000041010000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d000000200030008c000042060000813d0000423e0000013d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f0000169f011001c70000000b0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000041200000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b0000411c0000c13d000000000005004b0000412d0000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d0000001f0030008c0000423e0000a13d000000000100043d0000169e0010009c0000423e0000c13d0000000303000029000000000103041a000000ff0110018f000000050400002900000008024002100000168702200197000000000112019f0000000902000029000000d002200210000000000121019f000000000013041b000000400100043d0000000000410435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000403000039000016a40400004100000008050000290000000b06000029000000000700041156ac56a20000040f00000001002001900000012a0000613d0000000301000029000000000101041a000400000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d0000000402000029000000d002200270000000000101043b000000000021004b0000423b0000213d00000002030003670000004401300370000000000501043b0000000301000029000000000101041a00000008021002700000168604200197000000000045004b00000000050480190000006403300370000000000303043b000f00000005001d000000000035004b0000424f0000413d0000000f030000290000000002320049000000080220021000001687022001970000168801100197000000000112019f0000000302000029000000000012041b000000400100043d0000000000310435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000403000039000016a50400004100000008050000290000000b06000029000000000700041156ac56a20000040f00000001002001900000012a0000613d0000000301000029000000000101041a0000168700100198000041ae0000c13d000016e20110019700000001011001bf0000000302000029000000000012041b000000400100043d0000000000010435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000403000039000016a60400004100000008050000290000000b06000029000000000700041156ac56a20000040f00000001002001900000012a0000613d0000000c010000290000000b020000290000000a030000290000000f0400002956ac4d3d0000040f000e00000001001d0000000f0000006b000041d40000613d0000000e0000006b000041d40000613d0000000f0400002900000008014002100000000303000029000000000203041a00000000011200190000168701100197000016a702200197000000000121019f000000000013041b000000400100043d0000000000410435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000303000039000016a80400004100000008050000290000000b0600002956ac56a20000040f00000001002001900000012a0000613d0000000e0000006b0000000001000039000000010100c039000000400200043d00000020032000390000000000130435000043020000013d000015d80020009c000015d802008041000000c002200210000015d80010009c000015d8010080410000004001100210000000000121019f0000169f011001c70000000b0200002956ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0540018f0000002004400190000041f30000613d000000000601034f0000000007000019000000006806043c0000000007870436000000000047004b000041ef0000c13d000000000005004b000042000000613d000000000641034f0000000305500210000000000704043300000000075701cf000000000757022f000000000606043b0000010005500089000000000656022f00000000055601cf000000000575019f0000000000540435000100000003001f000300000001035500000001002001900000423e0000613d0000001f0030008c0000423e0000a13d000000000100043d0000169e0010009c0000423e0000c13d0000000203000029000000000103041a000000ff0110018f000000040400002900000008024002100000168702200197000000000112019f0000000902000029000000d002200210000000000121019f000000000013041b000000400100043d0000000000410435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000403000039000016a40400004100000008050000290000000b06000029000000000700041156ac56a20000040f00000001002001900000012a0000613d0000000201000029000000000101041a000300000001001d000016850100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000042d70000613d0000000302000029000000d002200270000000000101043b000000000021004b000042410000a13d000000400100043d000016d90200004100001d7d0000013d000000400100043d000016d60200004100001d7d0000013d00000002030003670000004401300370000000000501043b0000000201000029000000000101041a00000008021002700000168604200197000000000045004b00000000050480190000006403300370000000000303043b000f00000005001d000000000035004b000042520000813d000000400100043d000016c20200004100001d7d0000013d0000000f030000290000000002320049000000080220021000001687022001970000168801100197000000000112019f0000000202000029000000000012041b000000400100043d0000000000310435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000403000039000016a50400004100000008050000290000000b06000029000000000700041156ac56a20000040f00000001002001900000012a0000613d0000000201000029000000000101041a00001687001001980000428a0000c13d000016e20110019700000001011001bf0000000202000029000000000012041b000000400100043d0000000000010435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000403000039000016a60400004100000008050000290000000b06000029000000000700041156ac56a20000040f00000001002001900000012a0000613d0000000c0100002900000000020004110000000b030000290000000a04000029000000070500002956ac52d80000040f0000ffff0220018f000004830020008c000042950000613d000000000002004b000042d80000c13d000016af0010009c000042db0000213d0000169d0100004100000000001004430000000c0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000042d70000613d000000000101043b000000000001004b0000012a0000613d000000400300043d0000008401300039000000a002000039000000000021043500000064013000390000000f02000029000000000021043500000044013000390000000702000029000000000021043500000024013000390000000a020000290000000000210435000016c101000041000000000013043500000004013000390000000b020000290000000000210435000e00000003001d000000a401300039000000000001043500000000010004140000000c02000029000000040020008c000042d00000613d0000000e02000029000015d80020009c000015d8020080410000004002200210000015d80010009c000015d801008041000000c001100210000000000121019f000016a2011001c70000000c0200002956ac56a20000040f0000006003100270000115d80030019d00030000000103550000000100200190000042db0000613d0000000e01000029000015dc0010009c000002ae0000213d0000000e01000029000000400010043f000d00000000001d000042fe0000013d000000000001042f000000400100043d000016d50200004100001d7d0000013d000d00010000003d000000400100043d000e00000001001d0000000f0000006b000042fe0000613d0000000f0400002900000008014002100000000203000029000000000203041a00000000011200190000168701100197000016a702200197000000000121019f000000000013041b0000000e010000290000000000410435000015d80010009c000015d80100804100000040011002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f0000166f011001c70000800d020000390000000303000039000016a80400004100000008050000290000000b0600002956ac56a20000040f00000001002001900000012a0000613d000000400100043d000e00000001001d0000000e0200002900000020012000390000000d0300002900000000003104350000000f010000290000000000120435000015d80020009c000015d8020080410000004001200210000016a9011001c7000056ad0001042e00000020030000390000000004310436000000000302043300000000003404350000004001100039000000000003004b000043180000613d000000000400001900000020022000390000000005020433000015db0550019700000000015104360000000104400039000000000034004b000043110000413d000000000001042d0000169a0010009c0000432d0000213d000000a30010008c0000432d0000a13d00000002040003670000000401400370000000000101043b000015db0010009c0000432d0000213d0000002402400370000000000202043b000015db0020009c0000432d0000213d0000004403400370000000000303043b000015db0030009c0000432d0000213d0000006404400370000000000404043b000000000001042d0000000001000019000056ae0001043000000020030000390000000004310436000000000302043300000000003404350000004001100039000000000003004b0000433d0000613d00000000040000190000002002200039000000000502043300000000015104360000000104400039000000000034004b000043370000413d000000000001042d00080000000000020000000001000416000000000001004b000043540000c13d00000000010000310000169a0010009c000043540000213d000000630010008c000043540000a13d00000002010003670000000402100370000000000302043b000015db0030009c000043540000213d0000002402100370000000000402043b000015db0040009c000043540000213d0000004401100370000000000501043b000015db0050009c000043560000a13d0000000001000019000056ae000104300000000001000410000000000013004b0000435b0000c13d0000000001000019000056ad0001042e0000000001000411000015db01100197000600000001001d000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c70000801002000039000500000003001d000800000004001d000700000005001d56ac56a70000040f0000000100200190000043540000613d000000000101043b000000000101041a000400000001001d0000167101000041000000000010044300000000010004120000000400100443000001000100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000046200000613d000000000101043b000300000001001d0000167101000041000000000010044300000000010004120000000400100443000001200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000046200000613d000000000101043b000200000001001d00000004020000290000000d01200270000007f80310018f000000030130024f000000ff0110018f000300000003001d000000ff0030008c0000000001002019000016ad00200198000043a20000c13d000016e805000041000000040010008c000043d80000c13d000000000050043f000015f001000041000056ae00010430000100000001001d0000000601000029000000000010043f0000000f01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000008030000290000000100200190000043540000613d000000000101043b000000000030043f0000000201100039000600000001001d000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000007030000290000000100200190000043540000613d000016e605000041000000000101043b000000000101041a000000ff001001900000439f0000c13d000000000030043f0000000601000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000043540000613d000016e705000041000000000101043b000000000101041a000000ff0010019000000001010000290000439c0000613d0000439f0000013d000100000001001d000000040100002900000018011002700000167501100197000600000001001d000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000705000029000000080400002900000005030000290000000100200190000043540000613d0000000306000029000000020260024f000000ff0060008c0000000002002019000000000101043b000400000001001d000000ff0120018f000000010010008c000044170000613d000000020010008c0000000102000029000045070000c13d000000400200043d000016de010000410000000000120435000300000002001d000000040120003900000000005104350000167101000041000000000010044300000000010004120000000400100443000001400100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000046200000613d000000000201043b0000000001000414000015db02200197000000040020008c000044790000c13d0000000103000031000000200030008c00000020040000390000000004034019000044a30000013d0000169d01000041000000000010044300000004005004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000046200000613d000000000101043b000000000001004b0000000503000029000000080400002900000001020000290000000701000029000045070000613d000000000010043f00000004010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000080400002900000005030000290000000100200190000043540000613d000000000101043b000000000101041a000000ff001001900000000102000029000045070000c13d0000000001000411000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000705000029000000080400002900000005030000290000000100200190000043540000613d000000000101043b0000000001010446000015db01100197000000010010008c0000000102000029000045070000613d000000000031004b000045070000613d000016e901000041000000000010044300000004005004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000046200000613d000000000101043b000000000010043f00000004010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000000005030000290000000804000029000043540000613d000016eb05000041000000000101043b000000000101041a000000ff0010019000000001020000290000439f0000613d000045070000013d0000000303000029000015d80030009c000015d8030080410000004003300210000015d80010009c000015d801008041000000c001100210000000000131019f000016ce011001c756ac56a70000040f0000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0640018f00000020074001900000000305700029000044920000613d000000000801034f0000000309000029000000008a08043c0000000009a90436000000000059004b0000448e0000c13d000000000006004b0000449f0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000046210000613d0000001f01400039000000600210018f0000000301200029000000000021004b00000000020000390000000102004039000015dc0010009c0000457d0000213d00000001002001900000457d0000c13d000000400010043f000000200030008c000000050300002900000008040000290000000705000029000043540000413d00000003010000290000000001010433000000000001004b0000000002000039000000010200c039000000000021004b000043540000c13d000000000001004b0000000102000029000045070000c13d000000000050043f00000004010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000080400002900000005030000290000000100200190000043540000613d000000000101043b000000000101041a000000ff001001900000000102000029000045070000c13d0000000001000411000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000705000029000000080400002900000005030000290000000100200190000043540000613d000000000101043b0000000001010446000015db01100197000000010010008c0000000102000029000045070000613d000000000031004b000045070000613d000016e901000041000000000010044300000004005004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000046200000613d000000000101043b000000000010043f00000004010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000000005030000290000000804000029000043540000613d000016ea05000041000044730000013d000000000043004b0000450b0000c13d000000030020008c000043590000c13d000000ff0120018f000000010010008c000045830000613d000000020010008c000045d90000613d000000030010008c0000000501000029000043590000c13d000000000010043f00000004010000290000000401100039000700000001001d000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000008030000290000000100200190000043540000613d000000000101043b000000000101041a000000ff00100190000043590000c13d000000000030043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000043540000613d000000000101043b000000000101041a000000ff00100190000043590000c13d0000000001000411000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000005030000290000000100200190000043540000613d000000000101043b0000000001010446000015db01100197000000010010008c000043590000613d000000000031004b000043590000613d000016e901000041000000000010044300000004003004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000046200000613d00000004020000290000000502200039000000000101043b000000000010043f000700000002001d000000200020043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000000802000029000043540000613d000000000101043b000000000101041a000000ff00100190000043590000c13d000016e901000041000000000010044300000004002004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000046200000613d000000000101043b000000000010043f0000000701000029000000200010043f0000000001000414000046120000013d000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae000104300000000001000411000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000000502000029000043540000613d000000000101043b0000000001010446000015db01100197000000010010008c000043590000613d000000000021004b000043590000613d0000000601000029000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000005030000290000000100200190000043540000613d000000000101043b000000000030043f000800000001001d0000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000043540000613d000000000101043b000000000101041a000000ff001001900000463f0000c13d000016e9010000410000000000100443000000050100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000046200000613d000000000101043b000000000010043f00000008010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000043540000613d000000000101043b000000000101041a000000ff00100190000016ed05000041000043590000613d0000439f0000013d0000000501000029000000000010043f00000004010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000043540000613d000000000101043b000000000101041a000000ff00100190000043590000c13d0000000001000411000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000005030000290000000100200190000043540000613d000000000101043b0000000001010446000015db01100197000000010010008c000043590000613d000000000031004b000043590000613d000016e901000041000000000010044300000004003004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000046200000613d000000000101043b000000000010043f00000004010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000043540000613d000016ec05000041000000000101043b000000000101041a000000ff00100190000043590000c13d0000439f0000013d000000000001042f0000001f0530018f000015da06300198000000400200043d00000000046200190000462c0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000046280000c13d000000000005004b000046390000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000015d80020009c000015d8020080410000004002200210000000000112019f000056ae00010430000016ed05000041000000000050043f000015f001000041000056ae000104300000169a0010009c000046510000213d000000430010008c000046510000a13d00000002020003670000000401200370000000000101043b000015db0010009c000046510000213d0000002402200370000000000202043b000015db0020009c000046510000213d000000000001042d0000000001000019000056ae000104300000169a0010009c000046670000213d000000830010008c000046670000a13d00000002040003670000000401400370000000000101043b000015db0010009c000046670000213d0000002402400370000000000202043b000015db0020009c000046670000213d0000004403400370000000000303043b000015db0030009c000046670000213d0000006404400370000000000404043b000000000001042d0000000001000019000056ae0001043000010000000000020000000001000416000000000001004b000046ad0000c13d00000000010000310000169a0010009c000046ad0000213d000000430010008c000046ad0000a13d00000004010000390000000201100367000000000201043b000015db0020009c000046ad0000213d000000000020043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000100000002001d000080100200003956ac56a70000040f0000000100200190000046ad0000613d000000000101043b000000000101041a000000ff00100190000046af0000c13d00000018011002700000167501100197000000000010043f0000000e01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000046ad0000613d000000000101043b0000000002000411000015db02200197000000000020043f0000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000000102000029000046ad0000613d000000000101043b000000000101041a000000ff00100190000046b70000c13d000000400100043d000016db02000041000046b10000013d0000000001000019000056ae00010430000000400100043d000016da020000410000000000210435000015d80010009c000015d8010080410000004001100210000015f0011001c7000056ae00010430000000000102001956ac564e0000040f000000000001044700000024010000390000000201100367000000000201043b000000010100002956ac565e0000040f00000000000104470000000001000019000056ad0001042e000015db02200197000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000046d00000613d000000000101043b000000000001042d0000000001000019000056ae0001043000030000000000020000167501100197000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000470d0000613d000000000101043b000000000301041a000000400200043d000300000002001d000200000003001d0000000002320436000100000002001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000470d0000613d0000000205000029000000000005004b000046fe0000613d000000000101043b00000000020000190000000104000029000000000301041a000000000434043600000001011000390000000102200039000000000052004b000046f70000413d000046ff0000013d0000000104000029000000030100002900000000021400490000001f03200039000016e3023001970000000003120019000000000023004b00000000020000390000000102004039000015dc0030009c0000470f0000213d00000001002001900000470f0000c13d000000400030043f000000000001042d0000000001000019000056ae00010430000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae00010430000016a002200197000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000047230000613d000000000101043b000000000001042d0000000001000019000056ae000104300002000000000002000100000002001d000200000001001d000015db01100197000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000477e0000613d000000000101043b000000000101041a000000ff00100190000047800000c13d0000ff0000100190000047830000c13d00000018011002700000167501100197000000000010043f0000000e01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000477e0000613d000000000101043b0000000002000411000015db02200197000000000020043f0000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000477e0000613d000000000101043b000000000101041a000000ff00100190000047860000613d0000000201000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000477e0000613d000000000101043b000000010200003900000000002104470000000201000029000000000010043f0000000101000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000477e0000613d000000000101043b000000040110027000000001020000390000000000210447000000000001042d0000000001000019000056ae00010430000000400100043d000016da02000041000047880000013d000000400100043d000016bd02000041000047880000013d000000400100043d000016db020000410000000000210435000015d80010009c000015d8010080410000004001100210000015f0011001c7000056ae00010430000016ee0010009c000047930000813d000000c001100039000000400010043f000000000001042d000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae000104300000001f02200039000016e3022001970000000001120019000000000021004b00000000020000390000000102004039000015dc0010009c000047a50000213d0000000100200190000047a50000c13d000000400010043f000000000001042d000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae0001043000030000000000020000167501100197000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000047e70000613d000000000101043b0000000201100039000000000301041a000000400200043d000300000002001d000200000003001d0000000002320436000100000002001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f0000000100200190000047e70000613d0000000205000029000000000005004b000047d80000613d000000000101043b00000000020000190000000104000029000000000301041a000000000434043600000001011000390000000102200039000000000052004b000047d10000413d000047d90000013d0000000104000029000000030100002900000000021400490000001f03200039000016e3023001970000000003120019000000000023004b00000000020000390000000102004039000015dc0030009c000047e90000213d0000000100200190000047e90000c13d000000400030043f000000000001042d0000000001000019000056ae00010430000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae0001043000030000000000020000167501100197000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000482b0000613d000000000101043b0000000201100039000000000301041a000000400200043d000300000002001d000200000003001d0000000002320436000100000002001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000482b0000613d0000000205000029000000000005004b0000481c0000613d000000000101043b00000000020000190000000104000029000000000301041a000000000434043600000001011000390000000102200039000000000052004b000048150000413d0000481d0000013d0000000104000029000000030100002900000000021400490000001f03200039000016e3023001970000000003120019000000000023004b00000000020000390000000102004039000015dc0030009c0000482d0000213d00000001002001900000482d0000c13d000000400030043f000000000001042d0000000001000019000056ae00010430000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae0001043000030000000000020000167501100197000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000486e0000613d000000000101043b000000000301041a000000400200043d000300000002001d000200000003001d0000000002320436000100000002001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f00000001002001900000486e0000613d0000000205000029000000000005004b0000485f0000613d000000000101043b00000000020000190000000104000029000000000301041a000000000434043600000001011000390000000102200039000000000052004b000048580000413d000048600000013d0000000104000029000000030100002900000000021400490000001f03200039000016e3023001970000000003120019000000000023004b00000000020000390000000102004039000015dc0030009c000048700000213d0000000100200190000048700000c13d000000400030043f000000000001042d0000000001000019000056ae00010430000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae000104300001000000000002000000400300043d000016de020000410000000000230435000015db01100197000100000003001d000000040230003900000000001204350000167101000041000000000010044300000000010004120000000400100443000001400100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000048d90000613d000000000201043b0000000001000414000015db02200197000000040020008c000048980000c13d0000000103000031000000200030008c00000020040000390000000004034019000000010b000029000048c30000013d0000000103000029000015d80030009c000015d8030080410000004003300210000015d80010009c000015d801008041000000c001100210000000000131019f000016ce011001c756ac56a70000040f000000010b0000290000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b0019000048b20000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b000048ae0000c13d000000000006004b000048bf0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000048e00000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000015dc0010009c000048da0000213d0000000100200190000048da0000c13d000000400010043f0000001f0030008c000048d70000a13d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b000048d70000c13d000000000001042d0000000001000019000056ae00010430000000000001042f000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae000104300000001f0530018f000015da06300198000000400200043d0000000004620019000048eb0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000048e70000c13d000000000005004b000048f80000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000015d80020009c000015d8020080410000004002200210000000000112019f000056ae000104300002000000000002000200000001001d0000167101000041000000000010044300000000010004120000000400100443000001000100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f00000001002001900000492c0000613d000000000101043b000100000001001d0000167101000041000000000010044300000000010004120000000400100443000001200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f00000001002001900000492c0000613d00000002020000290000000302200210000000010320024f000000ff0330018f000000ff0020008c0000000003002019000000000101043b000000000121022f000000ff0210018f00000000020020190000000001030019000000000001042d000000000001042f000a000000000002000500000004001d000900000003001d000a00000002001d000400000001001d000015db021001970000000001000410000000000012004b00004c0e0000613d000600000002001d0000000001000411000015db01100197000100000001001d000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000800000001001d0000167101000041000000000010044300000000010004120000000400100443000001000100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f000000010020019000004c620000613d000000000101043b000700000001001d0000167101000041000000000010044300000000010004120000000400100443000001200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f000000010020019000004c620000613d000000000101043b000200000001001d00000008020000290000000d01200270000007f80310018f000000070130024f000000ff0110018f000300000003001d000000ff0030008c0000000001002019000016ad00200198000700000001001d000049aa0000613d0000000101000029000000000010043f0000000f01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b0000000a02000029000015db02200197000000000020043f0000000201100039000100000001001d000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff0010019000004c650000c13d0000000901000029000015db01100197000000000010043f0000000101000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff00100190000000070100002900004c670000c13d000000040010008c00004c630000613d000000080100002900000018011002700000167501100197000100000001001d000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d0000000303000029000000020230024f000000ff0030008c0000000002002019000000000101043b000800000001001d000000ff0120018f000000010010008c000049ea0000613d000000020010008c00004ab00000c13d000000400300043d000016de0100004100000000001304350000000901000029000015db02100197000300000003001d0000000401300039000200000002001d00000000002104350000167101000041000000000010044300000000010004120000000400100443000001400100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f000000010020019000004c620000613d000000000201043b0000000001000414000015db02200197000000040020008c00004a5e0000c13d0000000103000031000000200030008c00000020040000390000000004034019000000030b00002900004a890000013d0000169d010000410000000000100443000000090100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f000000010020019000004c620000613d000000000101043b000000000001004b00004ab00000613d0000000901000029000015db01100197000000000010043f00000008010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff0010019000004ab00000c13d0000000001000411000000000010043f0000000501000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c00004ab00000613d000000060010006c00004ab00000613d0000000001000411000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b0000000003010446000015db02300197000000060020006c0000000001000039000000010100c039000000010020008c0000000002000039000000010200c039000015dd0030009c00004a3d0000413d000000000112016f000000010010019000004ab00000613d000016e9010000410000000000100443000000090100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f000000010020019000004c620000613d000000000101043b000000000010043f00000008010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff0010019000004ab00000c13d000016eb0100004100004c680000013d0000000303000029000015d80030009c000015d8030080410000004003300210000015d80010009c000015d801008041000000c001100210000000000131019f000016ce011001c756ac56a70000040f000000030b0000290000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900004a780000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00004a740000c13d000000000006004b00004a850000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f0003000000010355000000010020019000004c730000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000015dc0010009c00004c6d0000213d000000010020019000004c6d0000c13d000000400010043f000000200030008c00004c600000413d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b00004c600000c13d000000000001004b00004ab00000c13d0000000201000029000000000010043f00000008010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff0010019000004c0f0000613d0000000a01000029000015db031001970000000602000029000000000032004b000000070100002900004ab80000c13d000000030010008c00004c0e0000c13d000000ff0110018f000000010010008c00004b430000613d000000020010008c00004bb10000613d000000030010008c00004c0e0000c13d000900000003001d000000000020043f00000008010000290000000401100039000700000001001d000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff00100190000000090100002900004c0e0000c13d000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff0010019000004c0e0000c13d0000000001000411000000000010043f0000000501000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c000000060200002900004c0e0000613d000000000021004b00004c0e0000613d0000000001000411000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b0000000001010446000015db02100197000000010020008c000000060300002900004b0e0000613d000000000032004b00004b100000c13d0000169a0010009c00004c0e0000213d000016e9010000410000000000100443000000040100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f000000010020019000004c620000613d00000008020000290000000502200039000000000101043b000000000010043f000900000002001d000000200020043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff0010019000004c0e0000c13d000016e90100004100000000001004430000000a0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f000000010020019000004c620000613d000000000101043b000000000010043f0000000901000029000000200010043f000000000100041400004c020000013d0000000001000411000000000010043f0000000501000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c000000060200002900004c0e0000613d000000000021004b00004c0e0000613d0000000001000411000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b0000000001010446000015db02100197000000010020008c000000060300002900004b6e0000613d000000000032004b00004b700000c13d0000169a0010009c00004c0e0000213d0000000101000029000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000201043b0000000601000029000000000010043f000a00000002001d0000000401200039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000916ed00000045000000000101043b000000000101041a000000ff0010019000004c690000c13d000016e9010000410000000000100443000000040100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f000000010020019000004c620000613d000000000101043b000000000010043f0000000a010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff0010019000004c0e0000613d00004c690000013d000000000020043f00000008010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff0010019000004c0e0000c13d0000000001000411000000000010043f0000000501000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c000000060200002900004c0e0000613d000000000021004b00004c0e0000613d0000000001000411000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b0000000001010446000015db02100197000000010020008c000000060300002900004bed0000613d000000000032004b00004bef0000c13d0000169a0010009c00004c0e0000213d000016e9010000410000000000100443000000040100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f000000010020019000004c620000613d000000000101043b000000000010043f00000008010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff0010019000004c910000613d000000000001042d0000000001000411000000000010043f0000000501000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c00004ab00000613d000000060010006c00004ab00000613d0000000001000411000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b0000000003010446000015db02300197000000060020006c0000000001000039000000010100c039000000010020008c0000000002000039000000010200c039000015dd0030009c00004c3f0000413d000000000112016f000000010010019000004ab00000613d000016e9010000410000000000100443000000090100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f000000010020019000004c620000613d000000000101043b000000000010043f00000008010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004c600000613d000000000101043b000000000101041a000000ff0010019000004ab00000c13d000016ea0100004100004c680000013d0000000001000019000056ae00010430000000000001042f000016e80100004100004c680000013d000016e60100004100004c680000013d000016e701000041000900000001001d0000000901000029000000000010043f000015f001000041000056ae00010430000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae000104300000001f0530018f000015da06300198000000400200043d000000000462001900004c7e0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b00004c7a0000c13d000000000005004b00004c8b0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000015d80020009c000015d8020080410000004002200210000000000112019f000056ae00010430000016ec0100004100004c680000013d00030000000000020000167501100197000000000010043f0000000e01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f000000010020019000004cce0000613d000000000101043b000000000301041a000000400200043d000300000002001d000200000003001d0000000002320436000100000002001d000000000010043f0000000001000414000015d80010009c000015d801008041000000c0011002100000166f011001c7000080100200003956ac56a70000040f000000010020019000004cce0000613d0000000205000029000000000005004b00004cbf0000613d000000000101043b00000000020000190000000104000029000000000301041a000000000434043600000001011000390000000102200039000000000052004b00004cb80000413d00004cc00000013d0000000104000029000000030100002900000000021400490000001f03200039000016e3023001970000000003120019000000000023004b00000000020000390000000102004039000015dc0030009c00004cd00000213d000000010020019000004cd00000c13d000000400030043f000000000001042d0000000001000019000056ae00010430000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae000104300005000000000002000100000005001d0000000005040019000000000403001900000000030200190000000002000411000500000001001d000400000003001d000300000004001d000200000005001d56ac52d80000040f0000ffff0220019000004ce50000613d000004830020008c00004d2c0000c13d0000000102000039000016af0010009c00004d2a0000213d0000169d0100004100000000001004430000000501000029000015db01100197000500000001001d00000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f000000010020019000004d340000613d000000000101043b000000000001004b00004d350000613d000000400300043d0000008401300039000000a00200003900000000002104350000006401300039000000010200002900000000002104350000004401300039000000020200002900000000002104350000000301000029000015db0110019700000024023000390000000000120435000016c10100004100000000001304350000000401000029000015db0110019700000004023000390000000000120435000000a401300039000000000001043500000000010004140000000502000029000000040020008c00004d260000613d000015d80030009c000400000003001d000015d80300004100000004030040290000004003300210000015d80010009c000015d801008041000000c001100210000000000131019f000016a2011001c756ac56a20000040f0000006003100270000115d80030019d000000040300002900030000000103550000000100200190000000010200003900004d2a0000613d000016ef0030009c00004d370000813d000000400030043f00000000020000190000000001020019000000000001042d000000400100043d000016d5020000410000000000210435000015d80010009c000015d8010080410000004001100210000015f0011001c7000056ae00010430000000000001042f0000000001000019000056ae00010430000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae00010430000b00000000000200000000050100190000000001000411000015db061001970000000001000410000000000016004b00004d880000c13d000000400600043d00000064016000390000000000410435000015db01300197000000440360003900000000001304350000002001600039000016b0030000410000000000310435000015db032001970000002404600039000000000034043500000064030000390000000000360435000016f00060009c000051000000213d000000a003600039000000400030043f00000000030604330000000002000414000000040050008c00004def0000c13d00000001020000390000000104000031000000000004004b00004e020000613d0000001f01400039000016e3011001970000003f01100039000016e303100197000000400100043d0000000003310019000000000013004b00000000060000390000000106004039000015dc0030009c000051000000213d0000000100600190000051000000c13d000000400030043f0000000003410436000016e3054001980000001f0640018f0000000004530019000000030700036700004d780000613d000000000807034f0000000009030019000000008a08043c0000000009a90436000000000049004b00004d740000c13d000000000006004b00004d850000613d000000000557034f0000000306600210000000000704043300000000076701cf000000000767022f000000000505043b0000010006600089000000000565022f00000000056501cf000000000575019f00000000005404350000000100200190000050fb0000613d00004e060000013d000600000006001d000200000004001d000800000003001d000a00000002001d000500000005001d000015db01500197000700000001001d000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000b00000001001d0000167101000041000000000010044300000000010004120000000400100443000001000100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000050ff0000613d000000000101043b000900000001001d0000167101000041000000000010044300000000010004120000000400100443000001200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000050ff0000613d000000000101043b000300000001001d0000000b020000290000000d01200270000007f80310018f000000090130024f000000ff0110018f000400000003001d000000ff0030008c0000000001002019000016ad00200198000900000001001d00004e170000613d0000000701000029000000000010043f0000000f01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b0000000a02000029000015db02200197000000000020043f0000000201100039000700000001001d000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d0000000102000039000000000101043b000000000101041a000000ff0010019000004e1d0000613d0000000001020019000000000001042d000015d80010009c000015d8010080410000004001100210000015d80030009c000015d8030080410000006003300210000000000113019f000015d80020009c000015d802008041000000c002200210000000000121019f000000000205001956ac56a20000040f00030000000103550000006001100270000115d80010019d000015d804100197000000000004004b00004d5e0000c13d000000600100003900000080030000390000000100200190000050fb0000613d0000000001010433000000000001004b00004e1b0000613d0000169a0010009c000050fd0000213d000000200010008c000050fd0000413d0000000001030433000000000001004b0000000002000039000000010200c039000000000021004b000050fd0000c13d000000000001004b00000000010000390000000101006039000000000001042d000000040010008c00004e330000c13d0000000101000039000000000001042d0000000001000019000000000001042d0000000801000029000015db01100197000000000010043f0000000701000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff00100190000050fb0000c13d0000000901000029000000040010008c000000010200003900004ded0000613d0000000b0100002900000018011002700000167501100197000100000001001d000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d0000000403000029000000030230024f000000ff0030008c0000000002002019000000000101043b000700000001001d000000ff0120018f000000010010008c00004e710000613d000000020010008c00004f350000c13d000000400300043d000016de0100004100000000001304350000000801000029000015db02100197000400000003001d0000000401300039000300000002001d00000000002104350000167101000041000000000010044300000000010004120000000400100443000001400100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000050ff0000613d000000000201043b0000000001000414000015db02200197000000040020008c00004ee30000c13d0000000103000031000000200030008c00000020040000390000000004034019000000040b00002900004f0e0000013d0000169d010000410000000000100443000000080100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000050ff0000613d000000000101043b000000000001004b00004f350000613d0000000801000029000015db01100197000000000010043f00000007010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff0010019000004f350000c13d0000000501000029000000000010043f000000200000043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c00004f350000613d000000060010006c00004f350000613d0000000501000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b0000000003010446000015db02300197000000060020006c0000000001000039000000010100c039000000010020008c0000000002000039000000010200c039000015dd0030009c00004ec30000413d000000000112016f000000010010019000004f350000613d000016e9010000410000000000100443000000080100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000050ff0000613d000000000101043b000000000010043f00000007010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff0010019000004f350000c13d000050fb0000013d0000000403000029000015d80030009c000015d8030080410000004003300210000015d80010009c000015d801008041000000c001100210000000000131019f000016ce011001c756ac56a70000040f000000040b0000290000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900004efd0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00004ef90000c13d000000000006004b00004f0a0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000051060000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000015dc0010009c000051000000213d0000000100200190000051000000c13d000000400010043f000000200030008c000050fd0000413d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b000050fd0000c13d000000000001004b00004f350000c13d0000000301000029000000000010043f00000007010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff00100190000050620000613d0000000a01000029000015db02100197000000060020006b000000090100002900004f3c0000c13d000000030010008c000050500000c13d000000ff0110018f000000010010008c00004fd20000613d000000020010008c0000503e0000613d000000030010008c000050500000c13d000900000002001d0000000601000029000000000010043f00000007010000290000000401100039000400000001001d000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff001001900000000901000029000050500000c13d000000000010043f0000000401000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff00100190000050500000c13d0000000501000029000000000010043f000000200000043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c000050500000613d000000060010006c000050500000613d0000000501000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b0000000001010446000015db02100197000000010020008c00004f900000613d000000060020006c00004f920000c13d0000169a0010009c000050500000213d000016e9010000410000000000100443000000000100041100000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000050ff0000613d00000007020000290000000502200039000000000101043b000000000010043f000900000002001d000000200020043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff00100190000050500000c13d000016e90100004100000000001004430000000a0100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000050ff0000613d000000000101043b000000000010043f0000000901000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff00100190000050500000c13d0000000101000039000000000001042d0000000501000029000000000010043f000000200000043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c000050500000613d000000060010006c000050500000613d0000000501000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b0000000001010446000015db02100197000000010020008c00004ffa0000613d000000060020006c00004ffc0000c13d0000169a0010009c000050500000213d0000000101000029000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000201043b0000000601000029000000000010043f000900000002001d0000000401200039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d0000000102000039000000000101043b000000000101041a000000ff0010019000004ded0000c13d000016e9010000410000000000100443000000000100041100000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000050ff0000613d000000000101043b000000000010043f00000009010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff00100190000000010200003900004ded0000c13d000050500000013d0000000601000029000000000010043f00000007010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff00100190000050b20000613d0000000b0100002900000098011002700000ffff0110019000000005050000290000000a020000290000000803000029000000020400002900004d440000613d000000140010008c00004d440000613d000000400100043d000016d5020000410000000000210435000015d80010009c000015d8010080410000004001100210000015f0011001c7000056ae000104300000000501000029000000000010043f000000200000043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c00004f350000613d000000060010006c00004f350000613d0000000501000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b0000000003010446000015db02300197000000060020006c0000000001000039000000010100c039000000010020008c0000000002000039000000010200c039000015dd0030009c000050910000413d000000000112016f000000010010019000004f350000613d000016e9010000410000000000100443000000080100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000050ff0000613d000000000101043b000000000010043f00000007010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff0010019000004f350000c13d0000000101000039000000000001042d0000000501000029000000000010043f000000200000043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c000050500000613d000000060010006c000050500000613d0000000501000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b0000000001010446000015db02100197000000010020008c000050da0000613d000000060020006c000050dc0000c13d0000169a0010009c000050500000213d000016e9010000410000000000100443000000000100041100000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000050ff0000613d000000000101043b000000000010043f00000007010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000050fd0000613d000000000101043b000000000101041a000000ff00100190000050500000c13d0000000101000039000000000001042d0000000001000019000056ae00010430000000000001042f000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae000104300000001f0530018f000015da06300198000000400200043d0000000004620019000051110000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b0000510d0000c13d000000000005004b0000511e0000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000015d80020009c000015d8020080410000004002200210000000000112019f000056ae00010430000000140010008c0000512a0000613d000002d10010008c0000512a0000613d000004830010008c0000512b0000c13d000000000001042d000000400100043d000016b4020000410000000000210435000015d80010009c000015d8010080410000004001100210000015f0011001c7000056ae000104300001000000000002000100000002001d000015db01100197000000000010043f0000000601000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000515a0000613d000000000101043b00000001020000290000000802200270000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000515a0000613d0000000102000029000000ff0220018f000000010220020f000000000101043b000000000301041a000000000323013f000000000031041b00000000002301700000515c0000613d000000000001042d0000000001000019000056ae00010430000000400100043d000016d7020000410000000000210435000015d80010009c000015d8010080410000004001100210000015f0011001c7000056ae000104300007000000000002000300000007001d000100000005001d000200000004001d000600000003001d000500000002001d000400000001001d000015db01600197000700000001001d000000000010043f0000000701000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000051e90000613d000000000101043b000000000201041a000000400100043d000000c00310003900000000002304350000008002100039000000060300002900000000003204350000004002100039000000040300002900000000003204350000000502000029000015db032001970000006002100039000500000003001d0000000000320435000000200210003900000007030000290000000000320435000000c0030000390000000000310435000000a0031000390000000000030435000016f10010009c000051eb0000813d000000e003100039000000400030043f000015d80020009c000015d80200804100000040022002100000000001010433000015d80010009c000015d8010080410000006001100210000000000121019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f0000000100200190000051e90000613d000000000101043b000000000010043f0000000201000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000051e90000613d000000000101043b0000000302000029000015db02200197000400000002001d000000000020043f000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000051e90000613d000000000101043b000000000201041a000000ff0220018f0000000105000029000000d003500210000000000232019f000000020400002900000008034002100000168703300197000000000232019f000000000021041b000016a301500197000000400200043d0000004003200039000000000013043500001686014001970000002003200039000000000013043500000006010000290000000000120435000015d80020009c000015d80200804100000040012002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e9011001c70000800d020000390000000403000039000016bc0400004100000007050000290000000506000029000000040700002956ac56a20000040f0000000100200190000051e90000613d000000000001042d0000000001000019000056ae00010430000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae0001043000040000000000020000000005040019000400000003001d0000000004020019000000000301001900000000020004110000000401000029000300000003001d000100000004001d000200000005001d56ac52d80000040f0000ffff02200190000052000000613d000002d10020008c0000523f0000c13d0000000102000039000016af0010009c0000523d0000213d0000169d0100004100000000001004430000000401000029000015db01100197000400000001001d00000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000052470000613d000000000101043b000000000001004b000052480000613d000000400300043d0000004401300039000000020200002900000000002104350000000101000029000015db0110019700000024023000390000000000120435000016b00100004100000000001304350000000301000029000015db011001970000000402300039000000000012043500000000010004140000000402000029000000040020008c000052390000613d000015d80030009c000300000003001d000015d80300004100000003030040290000004003300210000015d80010009c000015d801008041000000c001100210000000000131019f000016b1011001c756ac56a20000040f0000006003100270000115d80030019d00000003030000290003000000010355000000010020019000000001020000390000523d0000613d000016ef0030009c0000524a0000813d000000400030043f00000000020000190000000001020019000000000001042d000000400100043d000016d5020000410000000000210435000015d80010009c000015d8010080410000004001100210000015f0011001c7000056ae00010430000000000001042f0000000001000019000056ae00010430000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae0001043000030000000000020000167101000041000000000010044300000000010004120000000400100443000000a00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000052cf0000613d000000000101043b000300000001001d000015de0100004100000000001004430000000001000414000015d80010009c000015d801008041000000c001100210000015df011001c70000800b0200003956ac56a70000040f0000000100200190000052cf0000613d000000000101043b000000030010006c000052800000c13d0000167101000041000000000010044300000000010004120000000400100443000000800100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000052cd0000c13d000052cf0000013d000200000001001d000000400100043d000300000001001d0000002002100039000015e501000041000100000002001d00000000001204350000167101000041000000000010044300000000010004120000000400100443000000c00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000052cf0000613d000000000101043b0000000302000029000000400220003900000000001204350000167101000041000000000010044300000000010004120000000400100443000000e00100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000052cf0000613d000000000101043b0000000304000029000000a0024000390000000003000410000000000032043500000080024000390000000203000029000000000032043500000060024000390000000000120435000000a0010000390000000000140435000016ee0040009c000052d00000813d0000000302000029000000c001200039000000400010043f0000000101000029000015d80010009c000015d80100804100000040011002100000000002020433000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f0000000100200190000052d60000613d000000000101043b000000000001042d000000000001042f000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae000104300000000001000019000056ae00010430000c0000000000020000000006020019000015db072001970000000002000410000000000027004b00000000080000190000000002000019000052e20000c13d0000000001080019000000000001042d000800000004001d000500000005001d000a00000003001d000600000007001d000200000006001d000700000001001d000015db01100197000900000001001d000000000010043f0000000b01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000c00000001001d0000167101000041000000000010044300000000010004120000000400100443000001000100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000056290000613d000000000101043b000b00000001001d0000167101000041000000000010044300000000010004120000000400100443000001200100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000056290000613d000000000101043b000300000001001d0000000c020000290000000d01200270000007f80310018f0000000b0130024f000000ff0110018f000400000003001d000000ff0030008c0000000001002019000016ad00200198000053600000613d000b00000001001d0000000901000029000000000010043f0000000f01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b0000000a02000029000015db02200197000000000020043f0000000201100039000900000001001d000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff001001900000534a0000613d000016e6010000410000000002000019000000000001042d0000000801000029000015db01100197000000000010043f0000000901000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff001001900000000b01000029000053600000613d000016e7010000410000000002000019000000000001042d000000040010008c000053650000c13d000016e8010000410000000002000019000000000001042d000b00000001001d0000000c0100002900000018011002700000167501100197000100000001001d000000000010043f0000000d01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d0000000403000029000000030230024f000000ff0030008c0000000002002019000000000101043b000900000001001d000000ff0120018f000000010010008c000053a40000613d000000020010008c0000546b0000c13d000000400300043d000016de0100004100000000001304350000000801000029000015db02100197000400000003001d0000000401300039000300000002001d00000000002104350000167101000041000000000010044300000000010004120000000400100443000001400100003900000024001004430000000001000414000015d80010009c000015d801008041000000c00110021000001681011001c7000080050200003956ac56a70000040f0000000100200190000056290000613d000000000201043b0000000001000414000015db02200197000000040020008c000054190000c13d0000000103000031000000200030008c00000020040000390000000004034019000000040b000029000054440000013d0000169d010000410000000000100443000000080100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000056290000613d000000000101043b000000000001004b0000546b0000613d0000000801000029000015db01100197000000000010043f00000009010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff001001900000546b0000c13d0000000701000029000000000010043f0000000501000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c0000546b0000613d000000060010006c0000546b0000613d0000000701000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b0000000003010446000015db02300197000000060020006c0000000001000039000000010100c039000000010020008c0000000002000039000000010200c039000015dd0030009c000053f70000413d000000000112016f00000001001001900000546b0000613d000016e9010000410000000000100443000000080100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000056290000613d000000000101043b000000000010043f00000009010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff001001900000546b0000c13d000016eb010000410000000002000019000000000001042d0000000403000029000015d80030009c000015d8030080410000004003300210000015d80010009c000015d801008041000000c001100210000000000131019f000016ce011001c756ac56a70000040f000000040b0000290000006003100270000015d803300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b0019000054330000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b0000542f0000c13d000000000006004b000054400000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000100000003001f00030000000103550000000100200190000056300000613d0000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000015dc0010009c0000562a0000213d00000001002001900000562a0000c13d000000400010043f000000200030008c000056270000413d00000000010b0433000000000001004b0000000002000039000000010200c039000000000021004b000056270000c13d000000000001004b0000546b0000c13d0000000301000029000000000010043f00000009010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff00100190000055660000613d0000000a01000029000015db051001970000000602000029000000000052004b000000070300002900000005040000290000000b01000029000054750000c13d000000030010008c000055610000c13d000000ff0110018f000000010010008c000055000000613d000000020010008c0000554e0000613d000000030010008c000055610000c13d000b00000005001d000000000020043f00000009010000290000000401100039000800000001001d000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff001001900000000b01000029000055610000c13d000000000010043f0000000801000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff0010019000000007010000290000000502000029000055610000c13d000000000010043f000000200020043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c00000006020000290000000703000029000055610000613d000000000021004b000055610000613d000000000030043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b0000000001010446000015db02100197000000010020008c00000002030000290000000604000029000054cc0000613d000000000042004b000054ce0000c13d0000169a0010009c000055610000213d000016e901000041000000000010044300000004003004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000056290000613d00000009020000290000000502200039000000000101043b000000000010043f000b00000002001d000000200020043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff001001900000000a02000029000055610000c13d000016e901000041000000000010044300000004002004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000056290000613d000000000101043b000000000010043f0000000b01000029000000200010043f0000000001000414000055f60000013d000000000030043f000000200040043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c00000006020000290000000703000029000055610000613d000000000021004b000055610000613d000000000030043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b0000000001010446000015db02100197000000010020008c0000000603000029000055290000613d000000000032004b0000552b0000c13d0000169a0010009c000055610000213d0000000101000029000000000010043f0000000c01000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000201043b0000000601000029000000000010043f000b00000002001d0000000401200039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff00100190000056050000613d0000000002000019000016ed01000041000000000001042d000000000020043f00000009010000290000000401100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff0010019000000007010000290000000502000029000055b80000613d0000000c0100002900000098011002700000ffff0210018f0000000001000019000000000001042d0000000701000029000000000010043f0000000501000029000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c0000546b0000613d000000060010006c0000546b0000613d0000000701000029000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b0000000003010446000015db02300197000000060020006c0000000001000039000000010100c039000000010020008c0000000002000039000000010200c039000015dd0030009c000055960000413d000000000112016f00000001001001900000546b0000613d000016e9010000410000000000100443000000080100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000056290000613d000000000101043b000000000010043f00000009010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff001001900000546b0000c13d000016ea010000410000000002000019000000000001042d000000000010043f000000200020043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b00000004011002700000000001010446000015db01100197000000010010008c00000006020000290000000703000029000055610000613d000000000021004b000055610000613d000000000030043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b0000000001010446000015db02100197000000010020008c00000002030000290000000604000029000055e20000613d000000000042004b000055e40000c13d0000169a0010009c000055610000213d000016e901000041000000000010044300000004003004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000056290000613d000000000101043b000000000010043f00000009010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff00100190000055610000c13d000016ec010000410000000002000019000000000001042d000016e9010000410000000000100443000000020100002900000004001004430000000001000414000015d80010009c000015d801008041000000c00110021000001683011001c7000080020200003956ac56a70000040f0000000100200190000056290000613d000000000101043b000000000010043f0000000b010000290000000501100039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f0000000100200190000056270000613d000000000101043b000000000101041a000000ff001001900000000002000019000016ed08000041000052e00000c13d000055610000013d0000000001000019000056ae00010430000000000001042f000016cd01000041000000000010043f0000004101000039000000040010043f000016ce01000041000056ae000104300000001f0530018f000015da06300198000000400200043d00000000046200190000563b0000613d000000000701034f0000000008020019000000007907043c0000000008980436000000000048004b000056370000c13d000000000005004b000056480000613d000000000161034f0000000305500210000000000604043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001404350000006001300210000015d80020009c000015d8020080410000004002200210000000000112019f000056ae00010430000000000010043f0000000901000039000000200010043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000565c0000613d000000000101043b000000000001042d0000000001000019000056ae00010430000000000010043f000000200020043f0000000001000414000015d80010009c000015d801008041000000c001100210000015e7011001c7000080100200003956ac56a70000040f00000001002001900000566c0000613d000000000101043b0000000401100270000000000001042d0000000001000019000056ae00010430000000000001042f000015d80010009c000015d8010080410000004001100210000015d80020009c000015d8020080410000006002200210000000000112019f0000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000015e1011001c7000080100200003956ac56a70000040f0000000100200190000056820000613d000000000101043b000000000001042d0000000001000019000056ae0001043000000000050100190000000000200443000000050030008c000056920000413d000000040100003900000000020000190000000506200210000000000664001900000005066002700000000006060031000000000161043a0000000102200039000000000031004b0000568a0000413d000015d80030009c000015d80300804100000060013002100000000002000414000015d80020009c000015d802008041000000c002200210000000000112019f000016f2011001c7000000000205001956ac56a70000040f0000000100200190000056a10000613d000000000101043b000000000001042d000000000001042f000056a5002104210000000102000039000000000001042d0000000002000019000000000001042d000056aa002104230000000102000039000000000001042d0000000002000019000000000001042d000056ac00000432000056ad0001042e000056ae0001043000000000000000000000000000000000000000000000000000000000000000000000000000000f630000000000000000000000000000000000000000000000000000000000000f830000000000000000000000000000000000000000000000000000000000001bf80000000000000000000000000000000000000000000000000000000000001c180000000000000000000000000000000000000000000000000000000000000f130000000000000000000000000000000000000000000000000000000000000f33000000000000000000000000000000000000000000000000000000000000235c000000000000000000000000000000000000000000000000000000000000237c0000000000000000000000000000000000000000000000000000000000000527000000000000000000000000000000000000000000000000000000000000054700000000000000000000000000000000000000000000000000000000000027f20000000000000000000000000000000000000000000000000000000000002812000000000000000000000000000000000000000000000000000000000000049e00000000000000000000000000000000000000000000000000000000000004be00000000000000000000000000000000000000000000000000000000000024240000000000000000000000000000000000000000000000000000000000002444000000000000000000000000000000000000000000000000000000000000089a00000000000000000000000000000000000000000000000000000000000008ba0000000000000000000000000000000000000000000000000000000000001d570000000000000000000000000000000000000000000000000000000000001d77000000000000000000000000000000000000000000000000000000000000082c000000000000000000000000000000000000000000000000000000000000084c000000000000000000000000000000000000000000000000000000000000221e000000000000000000000000000000000000000000000000000000000000223e000000000000000000000000000000000000000000000000000000000000062c000000000000000000000000000000000000000000000000000000000000064c000000000000000000000000000000000000000000000000000000000000256500000000000000000000000000000000000000000000000000000000000025850000000000000000000000000000000000000000000000000000000000001fe7000000000000000000000000000000000000000000000000000000000000200700000000000000000000000000000000000000000000000000000000000029600000000000000000000000000000000000000000000000000000000000002980000000000000000000000000000000000000000000000000000000000000016800000000000000000000000000000000000000000000000000000000000001880000000000000000000000000000000000000000000000000000000000001ca60000000000000000000000000000000000000000000000000000000000001cc600000000000000000000000000000000000000000000000000000000000014f0000000000000000000000000000000000000000000000000000000000000151000000000000000000000000000000000000000000000000000000000000026a700000000000000000000000000000000000000000000000000000000000026c700000000000000000000000000000000000000000000000000000000000005a000000000000000000000000000000000000000000000000000000000000005c000000000000000000000000000000000000000000000000000000000000020de00000000000000000000000000000000000000000000000000000000000020fe00000000000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000000ffffffe0000000000000000000000000ffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffffff80000000000000000000000000000000000000000000000000000000000000009a8a0592ac89c5ad3bc6df8224c17b485976f597df104ee20d0df415241f670b0200000200000000000000000000000000000004000000000000000000000000ffffffffffffffffffffffff000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e00000000000000000000000000000000000000000000000000494654067e0ffff000000000000000000000000000000000000000000000000002386f26fc0ffff8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f000000000000000000000000000000000000000000000000ffffffffffffff3f020000000000000000000000000000000000004000000000000000000000000044454641554c54204c495354000000000000000000000000000000000000000002000000000000000000000000000000000000600000000000000000000000005cc365f89543268cb9f25c255f7f610e9147e733c589bc2732279575f125be149b0894203394c3cbb23140db7a23b224d3e18e0366e9f65bd9c8402650e27367000000000000000000000000000000000000000000000403030202030201000200000000000000000000000000000000000000000000030201020100000000000000000200000000000000000000000000000300000001000000000000000000c56e5d73000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000008254fcb600000000000000000000000000000000000000000000000000000000b97f6f8a00000000000000000000000000000000000000000000000000000000ddae38f100000000000000000000000000000000000000000000000000000000e34fda8400000000000000000000000000000000000000000000000000000000f7a2000900000000000000000000000000000000000000000000000000000000f7a2000a00000000000000000000000000000000000000000000000000000000fb2de5d700000000000000000000000000000000000000000000000000000000ffbcb4aa00000000000000000000000000000000000000000000000000000000e34fda8500000000000000000000000000000000000000000000000000000000e991dc3000000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000df21dc1c00000000000000000000000000000000000000000000000000000000df21dc1d00000000000000000000000000000000000000000000000000000000df5fd29a00000000000000000000000000000000000000000000000000000000e07cb24000000000000000000000000000000000000000000000000000000000ddae38f200000000000000000000000000000000000000000000000000000000de02cbb100000000000000000000000000000000000000000000000000000000def0125b00000000000000000000000000000000000000000000000000000000d415f62e00000000000000000000000000000000000000000000000000000000db5f30a700000000000000000000000000000000000000000000000000000000db5f30a800000000000000000000000000000000000000000000000000000000dd71105d00000000000000000000000000000000000000000000000000000000dda964e300000000000000000000000000000000000000000000000000000000d415f62f00000000000000000000000000000000000000000000000000000000d5dc239a00000000000000000000000000000000000000000000000000000000db188e6300000000000000000000000000000000000000000000000000000000c435f43400000000000000000000000000000000000000000000000000000000c435f43500000000000000000000000000000000000000000000000000000000caee23ea00000000000000000000000000000000000000000000000000000000cfea7ecf00000000000000000000000000000000000000000000000000000000b97f6f8b00000000000000000000000000000000000000000000000000000000bf7bfd7e00000000000000000000000000000000000000000000000000000000a5d56b4500000000000000000000000000000000000000000000000000000000b67d8f9800000000000000000000000000000000000000000000000000000000b89c4b0c00000000000000000000000000000000000000000000000000000000b89c4b0d00000000000000000000000000000000000000000000000000000000b8dcc68f00000000000000000000000000000000000000000000000000000000b955455200000000000000000000000000000000000000000000000000000000b67d8f9900000000000000000000000000000000000000000000000000000000b6e39ba100000000000000000000000000000000000000000000000000000000b70510f500000000000000000000000000000000000000000000000000000000ad1ff68400000000000000000000000000000000000000000000000000000000ad1ff68500000000000000000000000000000000000000000000000000000000ae602f4400000000000000000000000000000000000000000000000000000000b3992ab100000000000000000000000000000000000000000000000000000000a5d56b4600000000000000000000000000000000000000000000000000000000a87b03b6000000000000000000000000000000000000000000000000000000008da5cb5a00000000000000000000000000000000000000000000000000000000982d03bf00000000000000000000000000000000000000000000000000000000982d03c0000000000000000000000000000000000000000000000000000000009c2a9c6f00000000000000000000000000000000000000000000000000000000a1cc5cc1000000000000000000000000000000000000000000000000000000008da5cb5b000000000000000000000000000000000000000000000000000000008e28800f000000000000000000000000000000000000000000000000000000009340a7cc000000000000000000000000000000000000000000000000000000008963162500000000000000000000000000000000000000000000000000000000896316260000000000000000000000000000000000000000000000000000000089a9c855000000000000000000000000000000000000000000000000000000008b6ee865000000000000000000000000000000000000000000000000000000008254fcb70000000000000000000000000000000000000000000000000000000086e11774000000000000000000000000000000000000000000000000000000003e5c139c000000000000000000000000000000000000000000000000000000006498c0440000000000000000000000000000000000000000000000000000000071be859c000000000000000000000000000000000000000000000000000000007bac97dd000000000000000000000000000000000000000000000000000000007bac97de000000000000000000000000000000000000000000000000000000007c1e14b4000000000000000000000000000000000000000000000000000000007df81b900000000000000000000000000000000000000000000000000000000071be859d00000000000000000000000000000000000000000000000000000000725d07c50000000000000000000000000000000000000000000000000000000078e890ba000000000000000000000000000000000000000000000000000000006bfab91c000000000000000000000000000000000000000000000000000000006bfab91d00000000000000000000000000000000000000000000000000000000715018a6000000000000000000000000000000000000000000000000000000007161ac8d000000000000000000000000000000000000000000000000000000006498c0450000000000000000000000000000000000000000000000000000000069710828000000000000000000000000000000000000000000000000000000004c9d0b4400000000000000000000000000000000000000000000000000000000539d260100000000000000000000000000000000000000000000000000000000539d2602000000000000000000000000000000000000000000000000000000005e17263d000000000000000000000000000000000000000000000000000000005ed5917f000000000000000000000000000000000000000000000000000000004c9d0b45000000000000000000000000000000000000000000000000000000005079331500000000000000000000000000000000000000000000000000000000515f7b28000000000000000000000000000000000000000000000000000000003f6560ed000000000000000000000000000000000000000000000000000000003f6560ee00000000000000000000000000000000000000000000000000000000409dc573000000000000000000000000000000000000000000000000000000004be52a89000000000000000000000000000000000000000000000000000000003e5c139d000000000000000000000000000000000000000000000000000000003e8a0bc9000000000000000000000000000000000000000000000000000000001854b240000000000000000000000000000000000000000000000000000000002c7fe709000000000000000000000000000000000000000000000000000000003779e6fc000000000000000000000000000000000000000000000000000000003779e6fd000000000000000000000000000000000000000000000000000000003a0e3160000000000000000000000000000000000000000000000000000000003cda743a000000000000000000000000000000000000000000000000000000002c7fe70a000000000000000000000000000000000000000000000000000000002eb0b98a00000000000000000000000000000000000000000000000000000000317e3e8d0000000000000000000000000000000000000000000000000000000023c992610000000000000000000000000000000000000000000000000000000023c9926200000000000000000000000000000000000000000000000000000000285fb8c80000000000000000000000000000000000000000000000000000000028cc1131000000000000000000000000000000000000000000000000000000001854b241000000000000000000000000000000000000000000000000000000001f2fdc79000000000000000000000000000000000000000000000000000000000f59197c00000000000000000000000000000000000000000000000000000000136439dc00000000000000000000000000000000000000000000000000000000136439dd0000000000000000000000000000000000000000000000000000000016a17ce00000000000000000000000000000000000000000000000000000000016f18d74000000000000000000000000000000000000000000000000000000000f59197d0000000000000000000000000000000000000000000000000000000010b5c6a00000000000000000000000000000000000000000000000000000000012d3848a00000000000000000000000000000000000000000000000000000000057497ca00000000000000000000000000000000000000000000000000000000057497cb000000000000000000000000000000000000000000000000000000000ad38899000000000000000000000000000000000000000000000000000000000e14021a00000000000000000000000000000000000000000000000000000000015499300000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000002000000080000000000000000000000000000000000000000000000000000000040000001c00000000000000000000000000000000000000000000000000000000000000000000000091d1485400000000000000000000000000000000000000440000000000000000000000000000000000000000000000ffff00000000000000000000000000000000000000ffffffffffffffffffffff0000ffffffffffffffffffffffffffffffffffffff0200000000000000000000000000000000000020000000000000000000000000a5c37ab91519073edd58e608f19f7ce383fd171f4f22c3612a1d0a7c1047794a310ab089e4439a4c15d089f94afb7896ff553aecb10793d0ab882de59d99a32e00000000000000000000000000000000000000400000008000000000000000003e58254b0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000008000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffff208795fcac393398e42038456348398d8cac9067232f671ab240444cb51b1d207fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0503012490a650739416858609e898957b874d17415a062945179c57357978840061d78094976b1d9ae7bb858f141c915b46152756409caadb07482983c2ca301ffffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffbffdffffffffffffffffffffffffffffffffffffc0000000000000000000000000da8f3bd170446760f0f965a9b52bf271cb9679b5e0a70059eff2d49425229d17c8615322788d404dfe307db9eef031bc148d1cec5e270a1fd6528a02b445d4450000000000000000000000000000000000000020000000000000000000000000f71687260000000000000000000000000000000000000000000000000000000002000002000000000000000000000000000000440000000000000000000000009cc7f708afc65944829bd487b90b72536b1951864fbfc14e125fc972a6507f390200000200000000000000000000000000000024000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff1f796b89b91644bc98cd93958e4c9038275d622183e25ac5af08cc6b5d9553913200000000000000ffffffffffffffffffffffffffffffffffffffffffffffffff000000000000ffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffff00000000000000000000000000000000000000000000000000ff5065726d69745472616e7366657246726f6d576974684164646974696f6e616c446174612875696e7432353620746f6b656e547970652c6164647265737320746f6b656e2c75696e743235362069642c75696e7432353620616d6f756e742c75696e74323536206e6f6e63652c61646472657373206f70657261746f722c75696e743235362065787069726174696f6e2c75696e74323536206d61737465724e6f6e63652c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000fffffffffffffe9f02000000000000000000000000000000000000000000018000000000000000007069726174696f6e2c75696e74323536206d61737465724e6f6e63652c00000073616c742c61646472657373206f70657261746f722c75696e743235362065786e743235362069642c75696e7432353620616d6f756e742c75696e74323536206e7432353620746f6b656e547970652c6164647265737320746f6b656e2c75695065726d69744f72646572576974684164646974696f6e616c44617461287569932b8553b8e35bbee682d275cbe1cf115e14a777e2ca3266b4797369fb6317d3000000000000000000000000000000000000000000000000fffffffffffffebf190100000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000420000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a000000000000000000000000000000000000000800000000000000000000000001806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b831626ba7e0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a400000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c40000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffff257001e1f7fbfc5bbde5da225c876ab67293f37bda3afb8b35d9a55dfad6f65d2203cb053e6b01ec07e87d67d288d360ae164171185684936663b7d8fa9c534c705db7ac401a8091bb37a7838ad73d1fa8e1c663cb345f347fefe71280e3f03bffffffffffff000000000000000000000000000000000000000000000000000083e0ca2c1392f14286fa1e41c797789d48c5827572e8bcc352d8943c1961eaf000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffff000000ffffffffffffffffffffffffffff000000000000000000000000000000ffffffa66ff5557b7dc1562bb5e83306e15b513a25aa7537369bce38fc29c20847a79100000000000000000000000000ff00000000000000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffff23b872dd000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000064000000000000000000000000e4adc0bf00000000000000000000000000000000000000000000000000000000eda71103000000000000000000000000000000000000000000000000000000009d36a97900000000000000000000000000000000000000000000000000000000519973e7000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000040000000800000000000000000e0d8d9ad73c586e8cf60ffd390b6f3654200a2d8857eb6abba4f6842a1210aae3f1df144000000000000000000000000000000000000000000000000000000001138edbff75f319641eb242dbcacee294ebc2a473eb6aa1454a7706da5bf96b01f4ee59800000000000000000000000000000000000000000000000000000000f9c04f8b028fcfa3315ea5accaee4589194a685f07cda0392e6ba955070611190ec867d4f1b037422566cd0248bae620e6c142dcf5631948271916e8ca8dd263bf729bb1000000000000000000000000000000000000000000000000000000008e8cebe67607ce50a14a2e3261437f641a7b33ecc053e3d9c90b25ae5e66c65600000000000001000000000000000000000000000000000000000000000000008cbf875200000000000000000000000000000000000000000000000000000000f242432a00000000000000000000000000000000000000000000000000000000b9ff9815000000000000000000000000000000000000000000000000000000003b0a3343000000000000000000000000000000000000000000000000000000007f954ba1000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ff0000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffff0000000000000000000000000001000000000000000000000000000000000000ffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffb39d8f1e6f05413a407e46fc950eb92e9f5b3d65a47c3f0bdc7a2741a6ec0f7d9c615afab54584e53810beb24cced6ca36919dfc62bff2d4a0d244906c41c2ac9c6e8620d0004b9dd8b49560e2de8ced6f409f529cc23d0bb9e5a106d5c4324217c57023000000000000000000000000000000000000000000000000000000004e487b71000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000024000000000000000000000000021943c000000000000000000000000000000000000000000000000000000000fee142c500000000000000000000000000000000000000000000000000000000827aed80000000000000000000000000000000000000000000000000000000004722506e00000000000000000000000000000000000000000000000000000000fd2c901300000000000000000000000000000000000000000000000000000000cc47725a000000000000000000000000000000000000000000000000000000007a535da60000000000000000000000000000000000000000000000000000000073c919b500000000000000000000000000000000000000000000000000000000d979627300000000000000000000000000000000000000000000000000000000de7fafeb00000000000000000000000000000000000000000000000000000000e3fd7ac300000000000000000000000000000000000000000000000000000000b1ae736700000000000000000000000000000000000000000000000000000000bc8ea062000000000000000000000000000000000000000000000000000000001bb3460dffffffffffffffffffffffffffffffffffffffffffffffffffffffff1bb3460e0000000000000000000000000000000000000000000000000000000089a9c85500000000000000000000000000000000000000000000000000000000c05808340000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000004e680cb000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ff2b635c88000000000000000000000000000000000000000000000000000000002a5cb1c300000000000000000000000000000000000000000000000000000000d73e63af00000000000000000000000000000000000000000000000000000000e03fe177bb050a40ea1b3ecd64121a3fa063a94b6d404b2f45c64697555efe0ece32f2aa00000000000000000000000000000000000000000000000000000000aca58aa000000000000000000000000000000000000000000000000000000000ef28f90100000000000000000000000000000000000000000000000000000000409e6e1e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff400000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000ffffffffffffff5f000000000000000000000000000000000000000000000000ffffffffffffff200200000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000082d22b2d62c8a17f1393719d10c48f24cab86bfeb4ff1b7970d7ee8c2f273634
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
0000000000000000000000001a38eb41b74622cbfa733210ec3c85bea1658d9d0000000000000000000000001a589d072a1529c4d3d9e8262f84e57d6febc027000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000001d43726561746f72546f6b656e5472616e7366657256616c696461746f7200000000000000000000000000000000000000000000000000000000000000000000013400000000000000000000000000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : defaultOwner (address): 0x1a38EB41b74622CBfA733210ec3c85Bea1658d9D
Arg [1] : eoaRegistry_ (address): 0x1A589d072a1529c4d3d9E8262f84E57d6febC027
Arg [2] : name (string): CreatorTokenTransferValidator
Arg [3] : version (string): 4
-----Encoded View---------------
8 Constructor Arguments found :
Arg [0] : 0000000000000000000000001a38eb41b74622cbfa733210ec3c85bea1658d9d
Arg [1] : 0000000000000000000000001a589d072a1529c4d3d9e8262f84e57d6febc027
Arg [2] : 0000000000000000000000000000000000000000000000000000000000000080
Arg [3] : 00000000000000000000000000000000000000000000000000000000000000c0
Arg [4] : 000000000000000000000000000000000000000000000000000000000000001d
Arg [5] : 43726561746f72546f6b656e5472616e7366657256616c696461746f72000000
Arg [6] : 0000000000000000000000000000000000000000000000000000000000000001
Arg [7] : 3400000000000000000000000000000000000000000000000000000000000000
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.